120 lines
6.1 KiB
Markdown
120 lines
6.1 KiB
Markdown
# 集团股权架构梳理与可视化项目方案
|
||
|
||
> 创建：2026-08-06 | 负责人：小五（协调+开发），小强（数据采集/维护），小马（风险分析/报告）
|
||
> 目标：梳理集团几百家公司的股权架构（投资公司、股权比例、诉讼/法人限高风险），网页仪表盘可视化
|
||
|
||
---
|
||
|
||
## 〇、轻量方案（立即可用）：Excel → drawio 自动生成架构图 ✅ 已实现
|
||
|
||
> 爸爸提的需求：手里有一张 Excel（母/子公司名单），想同步用 drawio 生成股权架构图。
|
||
|
||
**现状：已完成并验证（2026-08-06）**
|
||
- 脚本：`股权架构/excel2drawio.py`（纯 Python + openpyxl）
|
||
- 示例：`股权架构/股权架构示例.xlsx` → `股权架构/股权架构示例.drawio`（8 公司/7 关系验证通过）
|
||
|
||
**Excel 格式（表头固定）**：
|
||
| 母公司名称 | 子公司名称 | 股权比例(%) | 备注 |
|
||
|---|---|---|---|
|
||
| 集团总公司 | 全资子公司A | 100 | 全资 |
|
||
| 集团总公司 | 控股子公司B | 60 | 控股 |
|
||
| 全资子公司A | 孙公司A1 | 100 | 全资 |
|
||
|
||
- 每行 = 一条股权关系；无父公司的公司自动识别为根节点（集团）
|
||
- 支持任意层级，自动布局（根在上、逐层下排）
|
||
- 连线自动标注股权比例 + 备注
|
||
- 样式区分：根=深蓝、中间公司=浅蓝、叶子=灰（后续可加风险标色）
|
||
|
||
**用法**：
|
||
```bash
|
||
python3 excel2drawio.py 股权架构.xlsx 股权架构.drawio
|
||
# 改 Excel → 重跑一遍 → drawio 自动刷新（F5）
|
||
```
|
||
|
||
**后续增强（待定）**：
|
||
- [ ] 风险标色：Excel 加“风险”列（诉讼/限高/失信）→ 节点变黄/红
|
||
- [ ] 自动监视 Excel 文件变化，保存即重新生成（watchdog）
|
||
- [ ] 与主仪表盘集成：drawio 嵌入网页，或统一用 ECharts
|
||
|
||
---
|
||
|
||
## 一、整体架构
|
||
|
||
```
|
||
[数据源] [采集层] [存储层] [服务层] [展示层]
|
||
企查查/天眼查API ──→ Python采集脚本 ──→ PostgreSQL ──→ FastAPI后端 ──→ ECharts网页
|
||
工商公示系统 (小强负责) (群晖) (小五) (仪表盘)
|
||
内部投资台账 数据清洗/去重
|
||
执行信息公开网(限高) 定时更新
|
||
裁判文书网(诉讼)
|
||
```
|
||
|
||
## 二、分步实施计划
|
||
|
||
### 阶段 0：需求确认与数据源调研（1周）
|
||
- [ ] 确认集团主体公司清单来源（内部台账 or 外部查询）
|
||
- [ ] 确定数据源方案：
|
||
- 方案A：企查查/天眼查开放平台 API（付费，数据全、稳定，几百家≈几千元级）
|
||
- 方案B：国家企业信用信息公示系统（免费，但无API、抓取受限、无反查诉讼）
|
||
- 方案C：内部资料为主 + 免费源补充（最省钱，但股权比例可能不全）
|
||
- [ ] 确认穿透深度（一级子公司 / 二级 / 三级？参股比例阈值？）
|
||
- [ ] 确认风险指标口径：诉讼（被告/原告、金额、状态）、法人限高、失信被执行人
|
||
- [ ] 是否有境外主体（BVI/开曼/香港），境外数据源另议
|
||
|
||
### 阶段 1：数据模型与存储设计（0.5周）
|
||
- [ ] 建库：PostgreSQL（群晖已有）
|
||
- [ ] 核心表：
|
||
- `companies`（公司：统一社会信用代码、名称、法人、注册资本、状态）
|
||
- `shareholdings`（股权关系：股东公司→被投公司、比例、金额）
|
||
- `risk_events`（风险事件：类型[诉讼/限高/失信]、时间、金额、状态）
|
||
- [ ] 统一社会信用代码为主键，公司名归一化（去重核心）
|
||
|
||
### 阶段 2：数据采集（2-3周，小强主力）
|
||
- [ ] 一级子公司清单：从集团内部台账导入（最准确）
|
||
- [ ] 股东穿透：逐家查股东结构 → 股权比例 → 二级/三级公司
|
||
- [ ] 循环采集：新发现的公司继续穿透，直到达到设定深度
|
||
- [ ] 风险数据采集：诉讼记录、法人限高、失信信息
|
||
- [ ] 采集脚本断点续传 + 限速防封（企查查API按次数计费需控量）
|
||
|
||
### 阶段 3：数据清洗与验证（1周）
|
||
- [ ] 公司名归一化、去重（同一公司多种写法合并）
|
||
- [ ] 股权比例校验（同层加总≤100%、控股关系判定）
|
||
- [ ] 数据质量报告（小强产出，发Gitea issue）
|
||
- [ ] 人工抽验 10-20 家关键公司
|
||
|
||
### 阶段 4：可视化仪表盘开发（2周，小五主力）
|
||
- [ ] 前端：ECharts 组织树图/力导向图，节点=公司，连线=股权比例
|
||
- [ ] 交互：点击节点展开下级、搜索公司、点击公司看详情（股权链路+风险列表）
|
||
- [ ] 风险标识：节点颜色（绿=无风险/黄=有诉讼/红=限高或失信），角标显示风险数
|
||
- [ ] 总览卡片：公司总数、层级数、风险公司占比、限高/诉讼统计
|
||
- [ ] 后端：FastAPI 提供公司查询/关系图/风险数据接口
|
||
- [ ] 部署：群晖 Nginx 静态页 + API 服务（Docker）
|
||
|
||
### 阶段 5：持续更新与运维（长期）
|
||
- [ ] 定时任务：风险数据每日/每周更新，股权结构季度核对
|
||
- [ ] 小马：定期输出《股权风险周报》（新增诉讼/限高/股权变更摘要）
|
||
- [ ] 告警：重点公司出现限高/失信 → 主动通知爸爸
|
||
- [ ] 文档与交接（Gitea 项目仓库托管代码+文档）
|
||
|
||
## 三、角色分工
|
||
|
||
| 角色 | 职责 |
|
||
|---|---|
|
||
| 小五 | 项目架构、数据模型、后端API、可视化开发、整体协调 |
|
||
| 小强 | 采集脚本、数据清洗、数据库维护、定时更新 |
|
||
| 小马 | 风险分析、周报、图表解读、数据质量复核 |
|
||
|
||
## 四、风险与注意
|
||
|
||
- 数据源合规：公开工商数据可爬，但需控制频率；付费API最稳
|
||
- 数据时效：工商数据本身有滞后（变更公示期），需标注数据日期
|
||
- 免费源诉讼数据不全（裁判文书网公开率下降），建议付费源
|
||
- 境外主体数据获取成本高，建议一期先做境内
|
||
|
||
## 五、待爸爸确认的关键决策
|
||
|
||
1. **数据源预算**：是否接受企查查/天眼查 API 付费？（决定采集效率和数据完整度）
|
||
2. **穿透深度**：梳理到几级？参股<5%的要不要？
|
||
3. **公司清单**：集团内部有没有现成的投资台账/子公司清单？
|
||
4. **更新频率**：一次性梳理 or 长期持续监控？
|