From c436bc1ca3323b574160e2090b385c57b49883d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A4=A7=E5=B8=88?= Date: Tue, 9 Jun 2026 01:26:58 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0README=20-=20?= =?UTF-8?q?=E7=9C=8B=E6=9D=BF=E6=8C=87=E6=A0=87=E8=AF=B4=E6=98=8E+?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=B7=A5=E4=BD=9C=E7=B0=BF=E7=BB=93=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 88 +++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 70 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index f0a3465..a023406 100644 --- a/README.md +++ b/README.md @@ -1,49 +1,101 @@ -# 专项施工方案数据看板 +# 危大方案编审进度看板 -中国港湾中东区域公司 · 技术部 +中国港湾中东区域公司 · 技术部 · 2026年6月 + +## 输出物 + +| 文件 | 说明 | 更新频率 | +|:------|:------|:------| +| `certified_schemes_dashboard.html` | 危大方案独立看板（双页PPT宽屏） | 每月 | +| `危大方案看板数据工作簿.xlsx` | 清洗数据 + 6数据透视表 | 每月 | +| `dashboard.html` | 三合一综合看板 | 每月 | ## 项目结构 ``` ├── README.md ├── .gitignore -├── run_all.py ← 一键管线 (B1→B2→B3→B4) +├── run_all.py ← 一键管线 ├── src/ -│ ├── b1_methods.py ← 技术方案统计表清洗 -│ ├── b2_tracking.py ← 项目启动动态跟踪 -│ ├── b3_revenue.py ← 营业额产值统计 -│ └── b4_dashboard_html.py ← 看板HTML生成 -├── raw/ ← OA原始数据 +│ ├── b1_methods.py ← 技术方案统计表清洗 +│ ├── b2_tracking.py ← 项目启动动态跟踪 +│ ├── b3_revenue.py ← 营业额产值统计 +│ ├── b4_dashboard_html.py ← 综合看板HTML生成 +│ ├── b4b_certified_dashboard_2026.py ← 危大方案独立看板 +│ ├── gen_workbook.py ← 数据透视工作簿 +│ ├── clean_certified.py ← 年度认定表清洗 +│ ├── clean_methods.py ← 方案统计表清洗(旧版) +│ └── run_methods_2026-06-08.py ← 06-08适配器 +├── raw/ ← OA原始台账 │ └── YYYY-MM-DD/ │ ├── 技术方案统计表.xlsx │ ├── 动态跟踪表_REPORT3.xlsx │ └── 2026年XX月项目营业额、产值统计表.xls -└── data/ ← 清洗后输出 +└── data/ ← 清洗后输出 └── YYYY-MM-DD/ └── cleaned/ ├── methods_cleaned.parquet - ├── tracking_tasks.parquet - ├── revenue_active.csv - ├── certified_schemes_dashboard.html ← 危大方案独立看板 - ├── dashboard.html ← 综合看板 + ├── methods_cleaned.csv + ├── certified_schemes_dashboard.html + ├── 危大方案看板数据工作簿.xlsx └── *_validation.json ``` +## 看板指标说明 + +### 页面1：关键指标 + +``` +┌─ 1.年度认定 ────┬─ 2.OA有效登记 ────┐ +│ 43 一般27 │ 52 一般30 │ +│ 总数 超规16 │ 总数 超规22 │ +│ 覆盖7项目 │ 登记率121% │ +├─ 3.按国别 ──────┼─ 4.审批进度&预警 ──┤ +│ 阿联酋45 ▓▓▓▓ │ 5 🔴0 🟠1 🟡4 │ +│ 沙特 6 ▓ │ 23 未完成审批 │ +│ 卡塔尔 1 ▏ │ 56% 审批完成率 │ +└─────────────────┴──────────────────┘ +``` + +- **年度认定**：依据中港科技便〔2026〕6号，统计口径 ≥2026年开工 +- **OA登记**：OA技术方案统计表，排除已作废 +- **预警**：🟠≤30天未审批 · 🟡≤45天 · 🔴在实施未审批 + +### 页面2：预警明细 + +5项预警方案清单，含项目全称、方案名称、距开工天数。 + ## 使用方式 -每月从OA下载三个台账文件放入 `raw/YYYY-MM-DD/`，运行： - ```bash +# 1. 放入OA原始文件 +cp *.xlsx raw/YYYY-MM-DD/ + +# 2. 运行清洗管线 python3 run_all.py YYYY-MM-DD + +# 3. 生成工作簿（含数据透视表） +python3 src/gen_workbook.py ``` +## 数据工作簿 (Sheet清单) + +| Sheet | 内容 | +|:------|:------| +| 清洗后数据 | 52条有效方案全字段 | +| 年度认定透视 | 按一般/超规 + 项目明细 | +| OA登记透视 | 按分类 + 国别×分类交叉 | +| 国别分布 | 阿联酋·沙特·卡塔尔 | +| 审批进度 | 完成率+OA状态细分 | +| 预警明细 | 6项预警+汇总 | + ## 数据来源 - 技术方案统计表 → 危大方案编审进度 - 动态跟踪表_REPORT3 → 项目启动阶段跟踪 - 项目营业额、产值统计表 → 营收财务数据 +- 年度认定 → 中港科技便〔2026〕6号 -## 输出 +## Gitea -- `certified_schemes_dashboard.html` — 危大方案独立看板 -- `dashboard.html` — 三合一综合看板 +[http://gitea.arabiancloud.online/taolm/scheme-certification-dashboard](http://gitea.arabiancloud.online/taolm/scheme-certification-dashboard)