Files
XingHuo/docs/memory/ENVIRONMENT.md
T
zhanghongyu_0626 2c5440b8b0 Update ENVIRONMENT and ITERATION documentation; add industry background and role research
- Enhanced `ENVIRONMENT.md` with a new section on platform positioning and industry context, detailing the project's role as a comprehensive wealth management institution.
- Updated the service roles table to include insights from the four-role industry research.
- Added new files for "平台与行业背景" and "四角色行业调研" to provide detailed context and operational insights for the project's agents.
- Revised `ITERATION.md` to reflect the addition of these new documents and their relevance to user requirements.
2026-09-07 11:53:38 +08:00

79 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 服务对象大环境(现状 / As-Is)
> 来源:`docs/需求拆解/业务场景优先级清单.md`、`docs/需求拆解/用户故事/`
> **平台与行业背景:** [用户故事/平台与行业背景.md](../需求拆解/用户故事/平台与行业背景.md) · **四角色调研:** [用户故事/四角色行业调研.md](../需求拆解/用户故事/四角色行业调研.md)
> **Core 说明:** 生产环境应以真实 Core 为 L0 权威;**本项目无真实 Core**,开发用 `jinrong_core` 模拟库(见 `docs/项目框架设计/Core模拟底座/`)。
------
## 0. 平台定位(一句话)
本项目服务对象是一家**以公募基金代销为基本盘的持牌综合财富管理机构**(卖方代理),兼营银行理财、保险经纪、私募(高净值)、QDII 全球配置。五块核心牌照:基金销售、保险经纪、证券投资咨询、私募管理人登记、QDII。详见 `公司信息/企业信息.md` 与 `公司业务/个人理财产品手册.md`。
------
## 1. 服务对象与角色(现在)
| 角色 | 谁 | 在环境里干什么 | 行业调研 |
| --- | --- | --- | --- |
| C 端客户 | 公募投资者 | 看持仓、查产品、交易;正式 C1~C5 在测评系统 | 四角色调研 §四 |
| 理财代理人 | 一线理财经理 | 服务名下客户、多系统查持仓、讲解规则、跟进 | 四角色调研 §一 |
| 内部员工 | 分析、运营、合规 | 问数、报表、抽检会话、协同风控 | 四角色调研 §三 |
| 风控 / 合规官 | 风控专员 | 监测大额/适当性/AML;人工审核,不自动冻户 | 四角色调研 §二 |
**L0 权威来源(本项目):** MySQL `jinrong_core` 模拟库 — KYC、正式 C1~C5、C×R 适当性矩阵、持仓、流水、产品(起购/期限)、代理人-客户归属。Agent 经 `CoreReadOnlyRepository` **只读 SELECT**;R-02 计算在 `check_suitability()`,落库契约见表设计/07。
------
## 2. 对方现在怎么办事
- **客户**:App/柜台看持仓;亏损无 Agent 式阈值提醒。
- **代理人**:多后台手工汇总;话术自写,合规靠事后检查。
- **内部分析**:SQL 或 IT 导表。
- **风控**:事后/T+1 发现异常;适当性靠交易前规则;AML 批处理或人工。
Agent **尚未上线**;后端为脚手架 + 模拟数据,无生产接入。
------
## 3. 主路径(现状 → 模拟后)
1. 开户/测评 → Core(模拟:`core_customer` + `core_customer_risk`)写 L0
2. 交易 → Core 流水(模拟:`core_trade`);交易前适当性:`check_suitability` 已实现,风控 service 落 log 待做(R-02)
3. 同步 → `sync_advisor_rel.py` 写入 agent 库 `customer_advisor_rel`;`sync_neo4j.py` 灌关系图
4. 代理人服务 → 查 Core RO + 口头沟通(L2 画像表待业务实现)
5. 风控 → 规则/人工台账;合规事后抽检
------
## 4. 环境里的关键对象
| 名称 | 含义 | 本项目存储 |
| --- | --- | --- |
| L0 正式档案 | customer_id、KYC、C1~C5、风评过期、advisor | `jinrong_core.core_customer` / `core_customer_risk` |
| 持仓/流水 | 产品、份额、盈亏 | `core_holding` / `core_trade` |
| 代理人-客户归属 | 服务关系 | Core 种子 → 同步 `jinrong_agent.customer_advisor_rel` |
| Agent 会话/画像/审计 | 平台业务数据 | `jinrong_agent`(11 共用表 + agent 专用表) |
------
## 5. 痛点与约束
```text
痛点:客户看不清持仓与规则;代理人多系统慢、话术易违规;问数靠 SQL;风控感知滞后
不能动:正式 C1~C5 仅测评/人工变更;事实账以 Core 为准(模拟库亦只读);监管要求审计与适当性
模拟边界:不模拟 TA/清算/报盘;种子数据静态净值可接受;Neo4j 由同步脚本维护
```
### 5.1 行业规则硬约束(合规底线来源,详见四角色调研 §六)
| 规则 | 本项目体现 |
|------|-----------|
| C×R 匹配,不匹配须书面警示;C1 最低类别禁止 | `core_suitability_rule` + R-02 唯一阻断 |
| 风评单日≤2 次 / 12 个月≤8 次 | 待加约束 |
| 大额交易 5 工作日内上报;客户风险等级 10 工作日内划分 | R-03;`aml_risk_level` |
| 话术须人工审核后外发 | `advisor_draft.review_status` |
| 数据分析只读不处置 | `analytics_query_log` |
| 不自动冻户、人工复核 | `risk_alert.status = pending_review` |
| 孰高原则(评级不一致取高) | 待加 |