city-life-line/task_plan.md

项目探索与记忆库计划

Goal

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

Phases

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

Next Step

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

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

Phase 10: 文档、接口与现状勘察

Status: completed

• 解析 PDF 5.3.2 章节并提取页面能力
• 盘点后端供水 Controller、参数和响应结构
• 盘点现有供水页面、API、动态菜单与可复用组件

Phase 11: 行为规格与测试先行

Status: completed

• 定义页面模块配置、接口适配和展示模型
• 为新增可测试逻辑编写失败测试并确认 RED

Phase 12: 页面与接口实现

Status: completed

• 对齐四级菜单命名与页面入口
• 完成供水设施管理、监测设备管理、运行监测和监测报警页面
• 接入已开发后端接口并提供降级空状态

Phase 13: 构建与浏览器验证

Status: completed

• 运行自动化测试和生产构建
• 启动前端并检查登录页资源和桌面布局；后端未启动，动态菜单内页联调待服务可用后继续

Phase 14: 记忆库与交付

Status: completed

• 更新本次会话记录、项目索引和稳定事实
• 汇总接口覆盖、已知限制和后续联调项

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

• 解析《供水-监测报警》并提取页面字段、流程和视觉要求
• 对比燃气首页、供水首页、监测页面和动态菜单现状
• 核对后台供水菜单 SQL、组件路径和角色可见性

Phase 16: 首页与页面能力实现

Status: in_progress

• 以燃气首页布局为基线完成供水 GIS 总览首页
• 补齐管网数据统计分析和供水设施 GIS 一张图入口
• 完善监测设备管理与监测报警页面交互
• 将流量、压力、漏失页面限定为对应子设备数据

Phase 17: 菜单启用与联调验证

Status: pending

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

Next Step

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