102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
# 项目记忆（人 + Agent 共用）
|
||
|
||
> 各阶段的**简化快照**（门闸索引）。只留基础信息，不写源文件正文。
|
||
> 详细需求见 `docs/需求拆解/`；表设计与技术选型见 `docs/项目框架设计/`。
|
||
|
||
------
|
||
|
||
## 1. 项目简介
|
||
|
||
- **名称：** JinRong 金融四 Agent 智能管家
|
||
- **当前阶段：** MVP（需求与底座设计已定，后端脚手架已 init）
|
||
- **当前优先级：** 交付速度（先 Wave 0 共用底座 + Wave 1 内部 Agent 闭环）
|
||
|
||
------
|
||
|
||
## 2. 阶段快照
|
||
|
||
| 阶段 | 当前一句话 | 源文件 |
|
||
| --- | --- | --- |
|
||
| 服务对象大环境 | 公募场景下四类角色各自痛点明确，数据以 Core 为准、Agent 只读事实 | `ENVIRONMENT.md` |
|
||
| 需求目的 | 四个 Agent 服务四类人群，统一数据层交换画像与预警，合规可审计 | `REQUIREMENTS.md` |
|
||
| 项目框架 | FastAPI 分层 app + MySQL/Redis/Milvus Lite/Neo4j + React；Windows 原生 | `FRAMEWORK.md` |
|
||
| 实现流程 | Gateway JWT/RBAC → Agent 编排 → Tool/画像库 → 审计落库 | `FLOW.md` |
|
||
|
||
------
|
||
|
||
## 3. 约束
|
||
|
||
**硬阀门：技术选型**
|
||
|
||
`docs/项目框架设计/技术选型和版本/01-技术栈与版本.md` 中已标「已定」视为用户确认；新增依赖须再确认。
|
||
|
||
**禁止触碰：**
|
||
|
||
```text
|
||
Core 正式 C1~C5、持仓/交易真账（Agent 只读）
|
||
audit_log 等审计表（只 INSERT）
|
||
代理人草稿自动外发客户
|
||
风控自动冻户 / 改正式风险等级
|
||
各 Agent 自建第二套 JWT/RBAC
|
||
```
|
||
|
||
**高风险（改前需确认）：** 数据库表结构、JWT/RBAC、部署密钥、删生产数据。
|
||
|
||
**开发开关：**
|
||
|
||
| 项 | YES / NO |
|
||
| --- | --- |
|
||
| 允许新增依赖 | YES（对齐技术选型文档） |
|
||
| 允许重构 | YES（最小范围） |
|
||
| 允许改表 / schema | 需确认 |
|
||
| 允许改接口协议 | 需确认 |
|
||
|
||
**特殊规则：**
|
||
|
||
```text
|
||
四 Agent 不互调 LLM；跨 Agent 走 L1/L2/L3 画像与预警表
|
||
客户 Agent：无投资建议/收益承诺/自动下单
|
||
代理人：不对 C 端直发
|
||
数据分析：仅 SELECT，不处置预警
|
||
画像不得覆盖 L0 正式测评
|
||
```
|
||
|
||
------
|
||
|
||
## 4. 入口与运行
|
||
|
||
```text
|
||
关键文件：app/main.py · app/config/settings.py · docs/项目框架设计/表设计/*.sql
|
||
如何启动：MySQL/Redis/Neo4j/Ollama 就绪后 → uvicorn app.main:app --reload
|
||
配置位置：.env（见 .env.example）
|
||
```
|
||
|
||
------
|
||
|
||
## 5. 文档资产约定
|
||
|
||
| 文件 | 何时更新 |
|
||
| --- | --- |
|
||
| `docs/memory/*.md` | 见 project-memory-kit 约定 |
|
||
| `docs/需求拆解/` | 业务场景与合规（参考） |
|
||
| `docs/项目框架设计/` | 表结构、鉴权、技术版本 |
|
||
|
||
日常改代码只读本文件；验收对照 `REQUIREMENTS.md`。
|
||
|
||
------
|
||
|
||
## 6. 协作口令
|
||
|
||
【大环境】→ ENVIRONMENT · 【需求讨论】→ REQUIREMENTS · 【框架讨论】→ FRAMEWORK · 【实现流程】→ FLOW · 【Plan】→ TODO
|
||
|
||
------
|
||
|
||
## 7. 阅读完成门闸（Agent）
|
||
|
||
1. 四个 Agent 服务谁、禁止什么？
|
||
2. 改动属于 api / service / tool 哪一层？
|
||
3. 是否需 customer_id 归属与 JWT RBAC？
|
||
4. 如何验证？
|
||
|
||
大任务：FRAMEWORK/FLOW 为空时先补再编码（用户确认跳过除外）。
|