# 项目探索与记忆库计划

## Goal

理解城市生命线前端项目，并建立仓库内可持续维护的对话记忆库。

## Phases

- [x] 核对实际目录、依赖和文档
- [x] 梳理启动、路由、权限、状态和请求链路
- [x] 统计业务模块与地图/图表/实时刷新实现
- [x] 汇总与项目描述文档的差异及后续建议
- [x] 形成记忆库设计并通过用户审阅
- [x] 创建记忆库实施计划
- [x] 创建 `AGENTS.md` 与 `memory/` 目录
- [x] 写入本次会话记录并更新长期记忆索引

## Next Step

启动 8300 后端后，联调 `/getRouters`、角色菜单权限和 19 个页面的真实数据响应。

## 新任务：供水管网安全运行监测系统前端

### Phase 10: 文档、接口与现状勘察
**Status:** completed
- [x] 解析 PDF 5.3.2 章节并提取页面能力
- [x] 盘点后端供水 Controller、参数和响应结构
- [x] 盘点现有供水页面、API、动态菜单与可复用组件

### Phase 11: 行为规格与测试先行
**Status:** completed
- [x] 定义页面模块配置、接口适配和展示模型
- [x] 为新增可测试逻辑编写失败测试并确认 RED

### Phase 12: 页面与接口实现
**Status:** completed
- [x] 对齐四级菜单命名与页面入口
- [x] 完成供水设施管理、监测设备管理、运行监测和监测报警页面
- [x] 接入已开发后端接口并提供降级空状态

### Phase 13: 构建与浏览器验证
**Status:** completed
- [x] 运行自动化测试和生产构建
- [x] 启动前端并检查登录页资源和桌面布局；后端未启动，动态菜单内页联调待服务可用后继续

### Phase 14: 记忆库与交付
**Status:** completed
- [x] 更新本次会话记录、项目索引和稳定事实
- [x] 汇总接口覆盖、已知限制和后续联调项

## Errors Encountered

| Error | Attempt | Resolution |
|---|---:|---|
| PowerShell 字符串插值中的冒号解析错误 | 1 | 改用 `${name}` 插值并重新执行 |
| 并行只读命令中单个 rg/脚本返回非零导致整体失败 | 1 | 拆分或显式 `exit 0`，不重复原命令 |
| Firecrawl CLI 未安装，且 PDF 约 51.2 MB 接近服务上传上限 | 1 | 改用工作区内置 Python 的 `pypdf/pdfplumber` 在本地解析，输出仍放入 `.firecrawl/` |
| 系统 PATH 中无 Python，规划会话恢复脚本首次无法运行 | 1 | 使用 Codex 工作区依赖提供的 Python 成功运行 session-catchup |
| PDF 完整提取的一行 Python 命令受 PowerShell 引号和执行时长影响，未生成输出 | 2 | 改用 `.firecrawl/extract_pdf.py` 逐页流式写入 Markdown |
| Firecrawl CLI 未安装，`npx firecrawl` 也没有可执行入口 | 2 | 改用工作区内置 DOCX 解析库，产物仍保存到忽略目录 `.firecrawl/` |

## 新任务：供水前端联调完善

### Phase 15: 文档与现状复核
**Status:** in_progress
- [x] 解析《供水-监测报警》并提取页面字段、流程和视觉要求
- [x] 对比燃气首页、供水首页、监测页面和动态菜单现状
- [ ] 核对后台供水菜单 SQL、组件路径和角色可见性

### Phase 16: 首页与页面能力实现
**Status:** in_progress
- [x] 以燃气首页布局为基线完成供水 GIS 总览首页
- [x] 补齐管网数据统计分析和供水设施 GIS 一张图入口
- [x] 完善监测设备管理与监测报警页面交互
- [x] 将流量、压力、漏失页面限定为对应子设备数据

### Phase 17: 菜单启用与联调验证
**Status:** pending
- [x] 提供前端静态菜单入口并对齐供水 GIS/统计/工单组件路径（后端菜单 SQL 仍待同步）
- [x] 运行模型测试、SFC 解析和生产构建
- [ ] 使用已登录浏览器验证首页、菜单和关键页面
- [x] 更新前端记忆库与本轮交付记录

## Next Step

解析《供水-监测报警》并完成燃气/供水页面与后台菜单映射。