group_xinghuo_jinrong/docs/项目框架设计/Core模拟底座/01-表结构与种子说明.md

# Core 模拟底座 · 表结构与种子说明



> 状态：**已落地** · 库名 `jinrong_core` · **2026-09-07 对齐客户资料手册**  

> 方案：[00-方案总览.md](./00-方案总览.md)  

> 客户规则来源：`docs/来自客户的项目资料/金融/`



---



## 1. 已确认决策



| 项 | 决定 |

| --- | --- |

| 库名 | `jinrong_core` |

| 访问方式 | `CoreReadOnlyRepository` 只读 SQL，无 HTTP API |

| 种子规模 | **33 客户**（28 通用 + 5 手册示范 `CUST-DEMO-*`）、13 员工、**14 产品** |

| 适当性 | `core_suitability_rule` C×R 矩阵（《适当性管理指南》第十二条） |

| Neo4j | **P0 必做** · `scripts/sync/sync_neo4j.py` |

| 行情 | 静态 `core_product_nav`：**06 最新日 + 07 近 364 日历史**（平台 `nav/history` · 前端行情详情） |



---



## 2. 表清单（对齐客户手册）



见 [scripts/core/01-ddl.sql](../../../scripts/core/01-ddl.sql)



| 表 | 说明 | 对齐文档 |

| --- | --- | --- |

| `core_risk_grade` | C1~C5 / R1~R5 字典 | 适当性指南 §6、§11 |

| `core_suitability_rule` | C×R 匹配矩阵 | 适当性指南 §12 |

| `core_staff` | 内部员工 + roles JSON | JWT/RBAC 联调 |

| `core_customer` | L0 KYC：性别/学历/收入/资产/高净值/PEP/AML 等 | 用户信息数据示例 §1 |

| `core_customer_risk` | L0 风评：问卷得分/目标/期限/过期/专业投资者 | 适当性指南 §8–10、FM-03 |

| `core_customer_advisor` | 归属 → sync agent 库 | F-01 |

| `core_product` | 产品 + **起购金额/期限/风险揭示书** | C-11、适当性指南 §11 |

| `core_holding` / `core_trade` / `core_cash_flow` | 持仓/流水 + **AML 渠道/对手方/代付** | 反洗钱规则 RW-001~020 |

| `core_product_nav` | 净值 C-05 | — |

| `core_industry` | 行业（Neo4j BELONGS_TO） | — |



---



## 3. 手册示范客户（联调推荐）



| customer_id | 原型 | C 等级 | 用途 |

| --- | --- | --- | --- |

| `CUST-DEMO-A` | 张晓明·年轻白领 | C2 | 定投/购房/C-07 |

| `CUST-DEMO-B` | 王建国·高净值企业主 | C4 | 私募/专业投资者认定 |

| `CUST-DEMO-C` | 陈秀兰·退休保守 | C1 | 适老化/银行理财/大额存单 |

| `CUST-DEMO-D` | 李伟·医生均衡 | C3 | 子女教育/养老规划 |

| `CUST-DEMO-E` | 赵鹏·科技激进 | C5 | 集中度/AML 代付样例 |



特殊联调客户（原有种子）：



| customer_id | 用途 |

| --- | --- |

| `CUST-4001` | 70 岁 + C5 + 买 R5（FM-01 年龄限制） |

| `CUST-4002` | C1 持有 R4 产品（适当性冲突） |

| `CUST-3001` | 大额交易 R-01 |

| `CUST-1003` | 风评已过期（FM-03） |



---



## 4. Repository 能力



`app/repository/core_ro.py`：



| 方法 | 说明 |

| --- | --- |

| `get_customer_l0` | 完整 KYC + 风评 |

| `check_suitability` | R-02：矩阵 + 风评过期 + 专业投资者豁免 + FM-01 年龄 |

| `list_products_for_customer` | C-11 匹配列表 |

| `list_holdings` / `list_trades` | 事实查询 |



---



## 5. 脚本与代码



| 路径 | 作用 |

| --- | --- |

| `scripts/core/00~07-*.sql` | 建库 + 种子（**07** = 净值历史） |
| `scripts/core/seed_nav_history.py` | 再生 **07** 或 MySQL upsert 修复 |

| `scripts/core/reset.ps1` | 一键重置 |

| `scripts/sync/sync_advisor_rel.py` | → `customer_advisor_rel` |

| `scripts/sync/sync_neo4j.py` | → Neo4j 图 |



---



## 6. 环境变量



```env

MYSQL_CORE_DATABASE=jinrong_core

NEO4J_URI=bolt://localhost:7687

NEO4J_PASSWORD=...

```



---



## 7. 关联文档



- [RBAC 手册](../技术选型和版本/02-JWT-RBAC鉴权手册.md)
- [Neo4j 模型](../表设计/04-neo4j-model.md)
- [画像 L1/L2/L3](../表设计/06-用户画像L1-L3设计.md)
- [适当性 log 契约](../表设计/07-risk_suitability_log说明.md)
- [C-05 行情数据源选型对比](../C-05-行情数据源选型对比.md)（Phase B 外部 sync 拍板）
- [接口契约 v0.2 行情扩展草案](../接口契约-代销平台API-v0.2-行情扩展草案.md)（`nav-snapshot` · `sync_market_nav`）
- 客户资料：`docs/来自客户的项目资料/金融/`