# D2 实施与验收记录 日期:2026-10-27(北京时间)。范围对应《四天开发计划》4.1–4.3。 **D2 前后端代码与本地联调已完成,真实 MySQL / 知了接口验收尚未通过。** 当前执行环境未配置数据库、admin 初始密码、知了及 DeepSeek 凭证,本轮未向真实供应商发送请求,未产生外部查询费用。 ## 交付范围 - 发现商机提供普通检索、获客报告、区域市场三个模式。默认全国、近 90 天;今天、三天、一周、一个月、半年、一年与自定义日期均可使用。日期在创建时固定,使用北京时间。 - 关键词使用逗号分隔,最多十个。OR 对接 `search_bids`;AND 对接 `query_bids_advanced` 的组间 AND。金额在本系统使用万元,适配接口时转换为元,并区分 `min_amount` 与 `min_money`。 - 普通检索的省份/金额是显式硬条件,按发布时间降序展示。获客省份/金额仅用于偏好排序,不排除其他省份或未知预算候选。可用同批临时偏好视图调整顺序,不请求新页、不改变原快照。 - 每页读取均记录真实请求开始、状态、耗时及实际费用;同一批次按公告 ID 去重,记录平台命中、已取数、去重数、展示数、页数和停止原因。预算等待后从下一页继续,不重新读取成功页。 - 同名标题不合并项目。有明确 `project_code`、采购方、地区和标段时建立阶段关联链,保留各阶段公告及证据;字段不足则保持独立公告。当前计数明确按公告,避免将无法核实的项目数冒充真实归并结果。 - 列表摘要逐页执行原文规则摘录,保留建设内容、地区、节奏、资质业绩片段、信息缺口及证据定位。未取得正文时不补造资质或工期,不自动逐项获取详情、调用企业情报或投标决策。 - 四维匹配由后端计算并冻结档案版本、权重、维度依据与完整性。档案未完善时不提供综合分;已完善时未知维度用中性 50 分并标待核验。按权重归一化,最终一次四舍五入取整;匹配分不是资格认证或中标概率。 - 方案支持保存、编辑、删除和手动执行。方案执行与版本登记同一事务提交后才派发任务。执行保存固定日期、条件、档案和公告事实/分析;编辑或删除方案不改变旧结果。历史 Tab 只回读,不触发收费请求。 - 关注八状态可人工自由跳转、从暂不考虑恢复、单独修改备注。状态/备注/历史一次事务提交,版本检查防覆盖,命令幂等防重复留痕;未变化的同值保存不新增历史。 - 标签支持创建、全局删除解绑、项目多选与筛选,账号隔离。标签绑定和删除会更新关注版本。取消关注沿用确认弹窗,只清理个人关注、历史与标签绑定,不删除公告或独立报告。 - 前端“了解采购方”“深入研判”保留显式入口,目前明确提示由 D3 接入,没有伪造深查调用。 ## 区域市场的两种统计口径 区域市场明确指定的省份是硬条件,留空为全国;未填业务词时实际使用并公开展示:`智慧水务、供水、污水处理、水质监测、管网漏损`。 工作流先调用 `get_top_purchasers`、`get_top_suppliers`、`aggregate_bids_advanced(group_by=month)`,再读预算允许的公告页。三个聚合步骤共享任务预算、调用账本及哈希证据;预算暂停恢复时跳过成功步骤。 平台 Top 与趋势按其工具实际口径展示,公告勾选的阶段只约束公告样本。采购方工具统计采购、供应商工具统计中标、月度工具使用支持的公告口径,不能把这些数字与样本公告数混算成市场份额。只有样本统计时明确标“已读去重公告样本”;聚合失败或预算不足不以样本冒充平台统计。 由于 Top 工具的锁定契约未提供 AND 分组,区域市场当前只接受 OR;需要 AND 时使用普通检索/获客,不能悄悄改成 OR。公告初始保护值最多 5 页 × 50 条;市场的三次聚合也占请求预算,所以默认 5 次上限下通常只剩两页公告额度。达到部署保护值不能无限继续。 ## 新增及扩展接口 所有接口在 `/api` 下,需要服务端会话;写请求必须带 CSRF。 | 方法与路径 | 行为 | | --- | --- | | `POST /searches` | `{conditions,maxCalls,maxCostUnits}`,必须带 `Idempotency-Key`;返回统一任务 | | `GET /searches` | 最近 50 次执行,含方案名称/版本及时间;不产生外部调用 | | `GET /searches/{id}` | 任务状态、已验证报告、实际调用与证据 | | `GET /searches/{id}/items?page=1&size=20` | 从固定批次分页,每页 1–50;不读取上游新页 | | `POST /searches/{id}/continue` | 原条件加新累计预算,独立幂等键;仅等待状态可继续 | | `POST /searches/{id}/view` | `{preference,regions,minWan,maxWan}`;临时重排原候选集,无外部请求 | | `GET /projects/{id}` | 当前账号已取得或关注的公告快照 | | `GET/POST /search-schemes` | 列举/保存方案;保存不执行检索 | | `PUT/DELETE /search-schemes/{id}` | 编辑需当前 version,删除保留独立执行记录 | | `GET/POST /search-schemes/{id}/runs` | 历史任务 ID / 手动执行;POST 需幂等键,预算用部署上限;发现商机传 `strictFilters=true`,将旧 LEADS 方案的地区与金额转为新任务硬条件,原方案和历史任务不变 | | `GET /watch?group=跟进中&tag=重点` | 可选按三个分组和标签筛选,含版本、公告、标签与历史 | | `POST /watch/{id}/changes` | `{status?,note?,version}`,必须带幂等键;status 留空可单改备注 | | `GET /watch/{id}/history` | 按关注版本排序的个人状态/备注历史 | | `GET/POST /tags`、`DELETE /tags/{id}` | 标签列举、创建、全局解绑删除 | | `PUT /watch/{id}/tags` | `{tags:[标签名称],version}`,必须带幂等键,标签必须属于本人 | `conditions` 字段:`keywords`、`keywordMode: ANY/ALL`、`mode: SEARCH/LEADS/MARKET`、`beginDate/endDate`、`stages`;偏好 `preference: COMPREHENSIVE/REGION/BUSINESS/AMOUNT`、`preferredRegions`、`budgetMinWan/budgetMaxWan`;显式硬条件 `hardRegions`、`hardMinWan/hardMaxWan`。后端拒绝向 LEADS 偷渡硬筛选。所有金额非负、上下限有序、日期不晚于今天且跨度不超过一年。 数据库新增 **V5**:任务档案快照、列表分析快照与哈希、方案执行版本登记、关注幂等命令、历史版本、市场聚合证据关联。保留 V1–V4,不改写已发布迁移。生产仍必须使用 MySQL,H2 仅在测试作用域。 ## 验证结果 | 验证 | 结果与证明范围 | | --- | --- | | Java 21 `mvn -o test` | **39 项通过,0 失败、0 错误、0 跳过**;H2 MySQL 模式+本机 HTTP 模拟供应商 | | 前端 `npm run build` | TypeScript 与 Vite 构建通过,保留 >500 kB 包体提醒 | | 本次新增/替换页面及契约、事件 Hook、App 定向 ESLint | 通过;未把旧 UI 组件全库 lint 作为已通过 | | 本机浏览器获客/关注 | 登录、档案保存、方案保存、读取两页返回 4 条/去重 3 条、未知金额保留、完整测试样本 100 分、偏好视图、关注、状态备注事务、标签、历史、刷新回读均验证 | | 本机浏览器区域市场 | 3 次平台聚合+2 页公告,共 5 次本机请求;聚合 800 与样本 3 分开展示;空档案综合分显示 `—` | | 真实 MySQL / 供应商 | **未验证**,缺环境配置;不以模拟测试代替真实验收 | 自动测试还覆盖:OR/AND 参数和万元转换、原检索发布时间排序、评分精确权重及高分上限、缺正文/缺预算、证据篡改拒绝、同标题不同阶段保留、可靠编号关联、方案编辑/删除不改快照、旧档案不重算、关注重复命令与旧版本拒绝、标签权限/解绑、市场聚合预算恢复不重跑,以及原 D1 会话/CSRF/供应商失败边界。 下图为明确标注“测试”的本机夹具,不是真实采购项目: ![关注状态、备注、标签与历史测试](./d2-watch-fixture.png) ![平台聚合与公告样本范围测试](./d2-market-fixture.png) ## 开源架构参考与本次采纳 本次查阅六个仓库说明,并补读可访问的监控脚本、Fire Enrich 编排器、中文 DOCX 解析器和 DeepResearch 控制器。没有复制第三方源码或引入其运行依赖;历史调研中的提交与许可记录仍在 [GitHub 相似项目调研](./GitHub相似项目调研.md)。 | 项目与本次访问来源 | 可借鉴之处 | 本轮处理 | | --- | --- | --- | | [BidMaster-Pro](https://github.com/guangshu100/BidMaster-Pro) | 招标解读、Skill 与商机入口的功能组织 | 作为功能对照;本轮原始 fetchers 路径未成功访问,不追加未经核实的实现断言 | | [全国机会监控脚本](https://raw.githubusercontent.com/FightingThrones/guiyang-tender-monitor-skill/main/guiyang-tender-monitor/scripts/tender_monitor.py) | 结构化来源、评分理由与日报字段 | 不复制分数阈值筛掉候选的做法,偏好变化保留原集合 | | [中文 DOCX 解析器](https://raw.githubusercontent.com/sanwudazhiyuan/-bid-analysis/main/src/parser/docx_parser.py) | 段落/表格保留顺序、格式与证据定位 | 原文摘录保留定位;完整文件链路属于 D3,未提前声称完成 | | [TenderGraph](https://github.com/Amawta-labs/tendergraph) | 后端在模型之外校验证据与来源版本,明确合成数据范围 | 公告证据、列表分析哈希、范围校验及冻结报告;不采用其合成商机作生产数据 | | [Fire Enrich 编排器](https://raw.githubusercontent.com/firecrawl/fire-enrich/main/lib/agent-architecture/orchestrator.ts) | 按所需字段选择阶段、共享已取得上下文 | 列表摘要复用本批原始事实,不附带触发企业深查 | | [DeepResearch 控制器](https://raw.githubusercontent.com/spring-ai-alibaba/deepresearch/main/src/main/java/com/alibaba/cloud/ai/example/deepresearch/controller/ChatController.java) | 有限执行、SSE、停止及人工继续入口 | 复用现有持久化任务/有序事件和预算等待;不整体迁入 Graph/RAG 平台 | 这些是针对本项目的工程判断,不是第三方部署、抽取准确率或供应商覆盖率的实测结论。 ## 真实环境后续验收 按根目录环境示例配置 MySQL、admin 密码、知了 Key 后启动。先小样本确认 OR/AND、金额单位、公告正文及项目编号字段,再运行全国近 90 天获客。核对调用 ID、平台总数、分页、积分、来源;选浙江偏好检查安徽等候选及未知预算仍保留。独立验证市场三个工具的字段与口径,再验证服务重启后方案、报告与关注仍可读取。 D3 企业情报/项目深挖、文件解析及 D4 全范围恢复/历史会话等继续按原计划实施。当前摘要是可追溯规则摘录,不是模型完成的深度招标解读;不得以列表分数承诺资格通过或中标。