RWS P1 Tracking — v3(三框架结构)
基于你最新版本(index.html 1.1MB)做的最小范围拆分:所有基础文件内容原样保留,
只把写进 HTML 的数据抽出来。页面行为经浏览器逐项对比与原版完全一致
(渲染状态、内嵌报表、分区对照、楼层切换、选区面板全部相同)。
打开方式不变:双击 index.html;放到 GitHub 上也可直接运行(启用 GitHub Pages 即可,
纯静态、全部相对路径;仓库里附带 Actions 工作流,网页上改完 CSV 推送后自动校验并重新生成)。
三大框架
P1-Tracking-v3/
│
├── index.html 页面骨架(10KB, 原 1.1MB)
│
├── presentation/ 【展示框架】
│ ├── styles.css 全部样式(改完刷新生效)
│ ├── report-embed.html 内嵌报表页(原 rpB64, 489KB)
│ ├── report-linked-template.html 联动报表模板(原 rpLinkedTpl)
│ └── zone-lookup.html 分区速查页(原 zlookupB64)
│
├── app/ 【功能框架】
│ ├── component.js 应用逻辑(311KB 完整类, 改完跑 tools/build.py)
│ ├── cloud-sync.js Supabase 云同步(改完刷新生效)
│ └── favicon.js
│
├── data-csv/ 【数据存储框架 — 用 CSV 调数】
│ ├── fixed/zone-xref.csv 87 组分区对照(大区↔楼层↔图上分区↔别名), 改完跑 build
│ ├── fixed/level-summary.csv ★网页右上楼层汇总卡的数值(柱/钢主梁/梯井/面积/挖土/拆除):
│ │ "覆盖值"列填数字即生效, 清空恢复自动计算; 改完跑 build
│ ├── fixed/zone-activity.csv ★基准数据: 每分区每活动的 月份+计划量+活动起止日期(改完跑 build)
│ ├── fixed/zone-plan-dates.csv ★基准数据: 每分区的区域计划开始/结束(改完跑 build)
│ ├── fixed/col-month.csv ★基准数据: 逐根柱构件的目标月份(改完跑 build)
│ ├── fixed/conflicts.csv 推不上去的基准条目(页面无 L3/L4/L5/Deck 楼层图等), 人工核对
│ ├── source/RWS_P1_CJ_full_import_aligned_final.json 最终基准数据原件
│ └── work/<楼层>.csv ★数据库连接的数据: 每层一个文件(B2/B1/B1M/L1…L5),
│ 文件内按 EB→NB→MA 分组到小区, 含工作项/月份/计划量/实际量/
│ 完成率/计划开始/计划结束/实际完成日期, 改完跑 work_csv import
│
├── generated/ 自动生成的注入文件(勿手改)
│ ├── app.bundle.js ← app/component.js
│ └── embeds.bundle.js ← presentation 三个页面 + zone-xref.csv
│
├── tools/
│ ├── build.py 重新生成 generated/(改 component.js、内嵌页、fixed/*.csv 后跑)
│ ├── work_csv.py export=导出工作CSV底稿 / import=校验并写回 zp-data.global.js
│ ├── push_final.py 把最终基准 JSON 重新推入(基准更新时重跑, 之后 build + export)
│ ├── push_excel.py 把《区域划分 EB_NB_MA》Excel 排程时间推入月度表
│ └── mark_l1.py 重新生成 L1 违规元素标记清单
│
├── .github/workflows/build.yml GitHub Actions: 推送后自动 import→build→提交生成结果
└── 根目录仅保留页面实际加载的文件: support.js, zone-data.global.js,
zp-data.global.js, floor-templates.global.js(内容未改)
★ 冲突旧文件已移除: zone-data.js(与生效数据不一致的旧版)、zp-data.js、
floor-templates.js(未被页面引用的重复副本)、zp-data_global.js(旧备份)、全部 .bat
最终基准数据(RWS_P1_CJ_full_import_aligned_final.json)
基准 JSON 已全部推入(工作/区域/数量/时间):
- 区域面板(点开每个分区看到的活动数据):活动计划量 394 条、活动起止日期 412 条、
区域计划起止 110 条、柱构件目标月 102 条,已生成三个 CSV 并编入页面
(
zone-activity.csv / zone-plan-dates.csv / col-month.csv,改完跑 build 即生效;
网页上管理员手改的数值仍然优先);
- 月度工作安排:活动起止时间以基准为准对账,改写 159 处
计划开始/计划结束,
247 处原本已一致;无逐项日期的条目按区域时间补 92 处;
计划量/实际量/完成率一律未动,月度显示与后续实际量更新不受影响;
- 推不上去的 70 条已标记在
data-csv/fixed/conflicts.csv(59 条活动计划量在 L3 等
页面没有的楼层图、11 条区域起止在 L4/L5/Deck 且月度表无对应条目),需人工确认归属。
改什么 → 动哪里
| 想改 | 文件 | 之后 |
|---|
| 固定数值(分区对照/别名) | data-csv/fixed/zone-xref.csv | python tools/build.py(GitHub 上推送即自动跑) |
| 分区活动 计划量/起止时间 | data-csv/fixed/zone-activity.csv | python tools/build.py |
| 分区区域 计划开始/结束 | data-csv/fixed/zone-plan-dates.csv | python tools/build.py |
| 柱构件目标月份 | data-csv/fixed/col-month.csv | python tools/build.py |
| 工作安排/数量/时间(校准) | data-csv/work/<楼层>.csv | python tools/work_csv.py import(GitHub 推送自动跑) |
| 右上楼层汇总卡数值 | data-csv/fixed/level-summary.csv 的"覆盖值"列 | python tools/build.py(GitHub 推送自动跑) |
| 样式 | presentation/styles.css | 刷新 |
| 内嵌报表/速查页 | presentation/*.html | python tools/build.py |
| 应用逻辑 | app/component.js | python tools/build.py |
| 云同步 | app/cloud-sync.js | 刷新 |
work CSV 说明(第二部分)
每个文件 = 一个楼层,文件内按 EB → NB → MA 分组到小区,行 = 一条工作安排:
大区, 小区, 工作项, 月份, 序号, 计划量, 实际量, 完成率%, 单位, 计划开始, 计划结束, 实际完成日期, 标记。
计划开始/结束默认为该月首末日,可改为真实计划日期;实际完成日期自行填写——三个日期
都会存入数据文件并往返保留,后续在 CSV 里直接调整和更新。
楼层按工作项名称归类("NB L1-L2 Steel Beam"→L2;梁类单层名按实际楼层上移一层)。
序号决定网页月度表里的行顺序,并与管理员在网页上手改的数值挂钩——改数可以,
不要改动已有行的序号;新增行用新序号。导入时自动校验:小区名必须在楼栋分组里、
月份必须合法、数字格式检查,问题行逐条列出并跳过。
右上楼层汇总卡(level-summary.csv)
网页右上每层的汇总数值(COLUMNS / STEEL MAIN BEAMS / LIFT-STAIR / AREA / EXCAVATION / DEMOLITION)
已分离为 data-csv/fixed/level-summary.csv:"当前自动值"列是按图上台账算出的参考(改它无效),
"覆盖值"列填数字即以 CSV 为准显示,清空恢复自动。已按你页面当前显示预填了
B1 钢主梁=14、B1 挖土=103,713 两项覆盖。此功能是对 app/component.js 的三处小改
(metricTotals/buildKPIs 读取 window.__LEVELSUM),已注释标明。
L1 无梁规则(标记待人工删除)
按既定规则一楼没有主梁/钢梁。当前生效数据里图上台账 L1 已干净;仍存在的疑似违规项
已全部标记在 data-csv/fixed/L1-remove-list.csv(登记表中仅 L1 的分区却登记的梁、
工作项名标注 L1 的梁类 37 条),work CSV 里对应行的"标记"列也打了 ⚠。
工具只标记不删改 —— 请核对后手动删除;删完跑 python tools/mark_l1.py 可刷新清单。
GitHub 使用
- 仓库根目录即本文件夹;Settings → Pages → 从 main 分支根目录发布,即可在线访问;
- 在 GitHub 网页上直接编辑
data-csv/ 下的 CSV → 提交 → Actions 自动校验并重新生成
(校验不通过工作流会红叉失败并列出问题行,不会写入坏数据);
- 本地使用只需 Python 3:
python tools/work_csv.py import / python tools/build.py,
不依赖任何 .bat。
注意
- 网页上管理员手改的数值(云同步)优先级仍高于文件,与原设计一致;
generated/ 里两个文件是生成品,请勿手改;- 页面运行仍需联网加载 React / Supabase CDN(与原版相同)。
