广寒基地拓扑页面修复与验收报告

日期：2026-07-09
验收地址：http://localhost:8080/guanghan_topology_demo.html?mission=GHC-05

修复结论

页面现已由 PostgreSQL 中的任务、事件、组件、连接关系和布局数据共同驱动，不再依赖写死的当前拓扑。任务选择、明确时间查询、浏览器前进/后退、模块详情弹窗、历史快照和错误提示均已修复并通过自动化与截图验收。

已修复项目

Flask 在 8080 端口同时提供页面与同源 API，移除前端写死的 5000 端口。
数据库密码不再包含于源码默认值；配置从 .env 读取。
增加数据库任务列表接口，任务选择器不再写死。
明确时间格式或时区无效时返回 JSON 400，页面保留当前拓扑并显示中文错误。
同时传入 mission 与 at 时按明确时间查询，同时保留任务上下文。
任务快照锚点与 Timeline 最后一条记录对齐。
SVG 节点、结构连接、加压走道、燃料/供电线和散热器均由数据库快照及布局生成。
GHC-05 空间骨架按确认结构实现：
- 核心舱为四向安装节点；
- 北、东、南、西分别为居住舱#2、实验舱、居住舱#1、温室模块；
- 居住舱#1经绿色加压走道连接电力模块北部模块；
- 温室模块经绿色加压走道连接吴刚二号；
- 电力模块四向模块及四块大型折叠散热面板完整显示；
- 冰轮一号、二号、三号分别位于电力模块西、南、东。
未来北、东、西扩展点只保留源码注释，不在当前画面显示。
修复长文本越界，节点标签按可用宽度适配。
模块弹窗改用安全文本节点填充，显示安装位置、状态、参数、尺寸、连接与任务节点。
弹窗关闭后恢复触发节点焦点，浏览器前进/后退可恢复对应快照。
补录现有资料可核验的载具尺寸与质量：
- 冰轮 Block 1：高 30.2 m，干重 25 t；
- 冰轮 Block 2：高 36.7 m，干重 28.194 t；
- 吴刚 Block 2：展开直径 11.2 m，干重 9.64 t，燃料罐直径 4.25 m。其余缺乏可靠资料的尺寸继续显示“资料未记录”，未补造数据。

历史任务快照验收

任务	可视节点	连接线	加压走道	散热器
BL-01	1	0	0	0
GHC-01	2	0	0	0
JC-01	2	0	0	0
BL-02	3	0	0	0
GHC-02	3	1	0	0
GHC-03	7	5	0	3
BL-03	8	5	0	3
GHC-04	9	8	0	4
GHC-05	14	13	2	4

GHC-03 与之后的“可视节点”可包含多个数据库组件的组合显示节点，因此组件数量可能大于表中的可视节点数量。

自动化验证

执行：

.venv\Scripts\python.exe -m unittest tests.test_topology_api tests.test_guanghan_topology_demo tests.test_guanghan_topology_e2e -v

结果：19 项测试全部通过。

覆盖内容包括：

同源页面/API 与安全配置；
任务列表、任务时间锚点、明确时间优先级及错误处理；
组件引入任务、尺寸、布局成员、散热器和冰轮接口方向；
GHC-05 两条加压走道终点；
历史快照与 GHC-05 动态渲染；
任务选择、时间查询、浏览器历史、弹窗语义与焦点恢复。

截图证据

demo/topology_repair/final_ghc05_top.png
demo/topology_repair/final_ghc05_mid.png
demo/topology_repair/final_ghc05_bottom.png
demo/topology_repair/final_mobile_top.png
demo/topology_repair/final_mobile_modal.png
demo/topology_repair/final_explicit_time.png
demo/topology_repair/final_invalid_time.png
demo/topology_repair/mission_*.png（九个任务快照）

运行说明

服务启动命令：

.venv\Scripts\python.exe -m topology_api.app

健康检查：http://localhost:8080/health

3.9 KiB Raw Permalink Blame History Unescape Escape