docs: 更新README - 看板指标说明+数据工作簿结构

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)