更新项目说明

README.md

@@ -1,2 +1,55 @@
-# gemdalepi
+# gemdalepi — 集团（金地商置）股权架构梳理与可视化
 
+> 目标：梳理集团几百家公司的股权架构（投资公司、股权比例、诉讼/法人限高风险），可视化展示，方便随时关注公司情况。
+
+## 目录结构
+
+```
+gemdalepi/
+├── README.md              # 项目说明
+├── data/                  # 原始数据表（公司主数据 + 股东信息）
+├── tools/                 # 转换/生成脚本
+├── diagrams/              # 生成的架构图（drawio 源文件 + PNG 预览）
+└── docs/                  # 方案与文档
+```
+
+## 数据说明
+
+- 数据来源：《金地商置法人主数据信息-境内-2024.xlsx》
+  - `01法人公司信息`：公司主数据（673 家，含名称/信用代码/法人/注册信息）
+  - `02公司股东信息`：股东关系（1171 条，含股权比例/出资额）
+- 境内公司 665 家，BVI/境外 2 家；体系内股东 216 家
+
+## 生成图说明
+
+| 文件 | 内容 | 规模 |
+|---|---|---|
+| `diagrams/金地商置_体系内.drawio` | 仅我司体系内股东关系 | 578 节点 / 634 关系 / 最深 7 层 |
+| `diagrams/金地商置_全量.drawio` | 含外部股东全量 | 1031 节点 / 1172 关系 / 最深 6 层 |
+
+## 更新维护流程
+
+1. 爸爸更新 Excel（公司信息/股东信息）→ 发给小五
+2. 小五更新 `data/` 并重新生成架构图
+3. 重新渲染 PNG 预览 → 推送仓库
+4. 架构图可用 draw.io（https://app.diagrams.net）打开
+
+## 工具用法
+
+```bash
+# 方式一：通用模板（母公司|子公司|比例 格式）
+python3 tools/excel2drawio.py 表格.xlsx 输出.drawio
+
+# 方式二：直接读主数据表（01法人公司信息 + 02公司股东信息）
+python3 tools/generate_from_master.py 主数据.xlsx 输出.drawio [--internal-only]
+```
+
+## 待办/规划
+
+- [ ] 风险标色：诉讼/限高/失信 → 节点变黄/红
+- [ ] 网页版查看器（浏览器直接打开看可缩放架构图）
+- [ ] 境外（香港/BVI）数据补充
+- [ ] 与 Gitea issue 联动：风险变更告警
+
+---
+创建：2026-08-06 | 维护：小五（数据/图），小强（数据质量），小马（风险分析）