# 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 | 维护：小五（数据/图），小强（数据质量），小马（风险分析）