docs: 固化项目整改基线（规格书 V2.2、现状分析、实施计划）
This commit is contained in:
weijuesen
@@ -661,3 +661,85 @@ MVP 沿用 IoTDB（现状）；TDengine 作为生产规模化候选（先基准
|
||||
- 环境监测 + LAMP：#12 天气接入、#14 LAMP 检测管理、#15 交叉验证、#16 耗材管理、#17 技术员后台；
|
||||
- 专家诊断 + 溯源：#18 专家会诊、#19 qPCR/SERS/高光谱、#21 疫病溯源、#22 区域热力图、#23 摄像头流巡检；
|
||||
- 数据分析与运维：#24 健康画像、#25 时序存储决策、#26 GPU 监控、#27 测试基建。
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-13 项目现状与规格说明书优化分析
|
||||
|
||||
### 做了什么
|
||||
|
||||
- 对照 `.cc-connect/attachments/蚕病智能防控平台规格说明书.md` V2.1，抽查 Go 后端、Web、小程序、APP、ai-service、测试和运维文档；
|
||||
- 新增 `项目现状与规格说明书优化分析.md`，包含执行摘要、功能现状矩阵、规格书 V2.2 修订建议、P0/P1/P2 问题清单、分阶段优化路线图和新增功能建议；
|
||||
- 识别到风险评分语义、公开视频流/密钥返回、默认凭据、迁移容错、qPCR 空 Ct 判读和小程序类型错误等高优先级问题；本次只分析和记录，未修改业务代码或部署环境。
|
||||
|
||||
### 设计思路与决策依据
|
||||
|
||||
- 采用“规格—实现—路线图”综合评审结构，把已实现、骨架/mock、手工录入、接口预留和真实联调分开，避免用单一完成勾选误导验收；
|
||||
- 先以代码和本地命令为事实依据，再给出建议；codebase-memory 图谱接口在当前会话不可用，已在报告中披露并回退到目标源码核查；
|
||||
- 优先级以数据/隐私暴露、业务错误传播范围、生产恢复难度和核心闭环阻断程度确定，新增功能排在安全与正确性基线之后。
|
||||
|
||||
### 验证结果
|
||||
|
||||
- `server-go`: `go test ./...`、`go vet ./...` 通过；
|
||||
- `web`: `npm test` 3/3 通过，`npm run lint` 通过但有 5 个 warning；
|
||||
- `ai-service`: 本机缺 fastapi/Pillow，pytest 收集失败；
|
||||
- `app`: 本机目录缺 tsc/eslint 可执行依赖，类型与 lint 未运行成功；
|
||||
- `miniapp`: `npx tsc --noEmit` 发现 dashboard 两处 TS1382；
|
||||
- 未连接开发服务器或外部依赖，未做生产联调、渗透、负载、恢复或真实模型验收。
|
||||
|
||||
### 回滚点
|
||||
|
||||
- 本交付仅新增 `项目现状与规格说明书优化分析.md` 并追加本节；回滚时删除新增文档并移除本节即可，无数据库、配置、构建产物或服务器变更。
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-13 规格说明书 V2.2 与整改实施计划
|
||||
|
||||
### 做了什么
|
||||
|
||||
- 新增 `蚕病智能防控平台规格说明书_V2.2.md`：对齐当前 Go + Python 混合架构，增加能力七态、稳定需求 ID、业务异常流程、数据/API/AI/安全/非功能规范、阶段退出条件和开放决策；
|
||||
- 新增 `项目整改实施计划_V1.0.md`：把阶段 A～C 拆为 15 个可独立评审任务，列出负责人、涉及文件、接口、TDD 步骤、验证命令、依赖顺序和回滚方法；
|
||||
- 近期整改聚焦安全、业务正确性、迁移/CI/可靠消息、检测与发病主链、消毒/种源、离线同步和运维验收；真实多病种模型、摄像头群体 AI、SERS/高光谱等研究项明确延后。
|
||||
|
||||
### 设计思路与决策依据
|
||||
|
||||
- 规格书区分“目标能力、当前状态、验收证据”，不再以存在页面/接口等同于功能完成；
|
||||
- 风险评分、检测判读、视频/密钥安全和 schema 一致性列为 Wave 1，业务扩展必须在 P0 关闭后进入；
|
||||
- 对未获确认的迁移工具、CI 平台、云服务、数据保留期、APP 范围和 qPCR 专业规则只设置决策门，不擅自选型；
|
||||
- 整改任务按 TDD、小步迁移、功能开关、幂等、可观测和可回滚设计，便于多同事分工执行。
|
||||
|
||||
### 验证结果
|
||||
|
||||
- 两份文档已执行标题结构、需求 ID、任务编号、占位符、路径引用和 Markdown diff 检查；
|
||||
- 本次仅创建文档并追加交接记录，没有修改业务代码、依赖、数据库、生成产物或服务器；
|
||||
- 文档中的命令属于后续整改验收步骤，本次未宣称相应功能已经修复或测试通过。
|
||||
|
||||
### 回滚点
|
||||
|
||||
- 删除 `蚕病智能防控平台规格说明书_V2.2.md`、`项目整改实施计划_V1.0.md` 并移除本节即可；原 V2.1 附件、业务代码、数据库和部署环境均未改动。
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-13 codebase-memory 索引生成
|
||||
|
||||
### 做了什么
|
||||
|
||||
- 使用本机已安装的 codebase-memory-mcp v0.10.2（`C:\Users\Administrator\AppData\Local\Programs\codebase-memory-mcp\codebase-memory-mcp.exe`）对仓库 `D:\silk-master-84e4ddc` 执行 `index_repository`，生成知识图谱索引：3409 节点、10351 边，状态 ready；
|
||||
- 当前 Codex `config.toml` 原先缺少 `codebase-memory-mcp` 的 MCP 服务配置，已补上 `[mcp_servers.codebase-memory-mcp]` 条目并验证 `codex mcp list` 显示 enabled；原配置备份为 `C:\Users\Administrator\.codex\config.toml.cbm-bak-20260813-213259`。
|
||||
|
||||
### 设计思路与决策依据
|
||||
|
||||
- 索引存放在 codebase-memory-mcp 本地缓存（`C:\Users\Administrator\.cache\codebase-memory-mcp`），仓库内 `.codegraph` 仅为忽略规则占位，不提交业务产物；
|
||||
- 通过官方 CLI 直接索引，不依赖当前会话是否已加载 MCP 工具，便于后续用 `search_graph`/`trace_path` 等图谱接口查询。
|
||||
|
||||
### 验证结果
|
||||
|
||||
- `list_projects`：项目 `D-silk-master-84e4ddc` 已登记（branch `dev_wjs`，3409 节点、10351 边）；
|
||||
- `index_status`：status ready；24 个文件存在局部解析缺口（多为 SCSS/少量 TSX 行），84 个文件按设计排除（gitignore/构建产物/二进制资源），非索引失败；
|
||||
- `search_graph`：按 `.*Handler.*` 查询返回 5 条结果，图谱查询可用；
|
||||
- `codex mcp list`：`codebase-memory-mcp` 与 `node_repl` 均 enabled。
|
||||
|
||||
### 回滚点
|
||||
|
||||
- 删除索引：`codebase-memory-mcp cli delete_project '{"project":"D-silk-master-84e4ddc"}'`；
|
||||
- 恢复 Codex 配置：用备份 `config.toml.cbm-bak-20260813-213259` 覆盖 `config.toml` 即可；本次未改业务代码、数据库或服务器。
|
||||
|
||||
Reference in New Issue
Block a user