XingHuo/README.md

# JinRong · 金融四 Agent 智能管家

四个 Agent（客户财富 / 代理人助手 / 数据分析 / 风控监测）共用统一数据层与合规底座。

## 文档

| 目录 | 内容 |
| --- | --- |
| [docs/memory/MEMORY.md](docs/memory/MEMORY.md) | 项目记忆入口（**新 Agent 读 §0 交接清单**） |
| [docs/需求拆解/](docs/需求拆解/) | 业务场景、数据矩阵、合规 |
| [docs/项目框架设计/](docs/项目框架设计/) | 表设计、技术选型、JWT 手册 |

## 后端结构

```text
app/
├── api/          # 路由：chat、knowledge、admin
├── service/      # Agent、RAG、记忆
├── tool/         # 解析、Embedding、Milvus
├── model/        # Pydantic + ORM
├── repository/   # Core 只读 core_ro（已实现）
├── config/       # settings、database
├── utils/
└── main.py
```

## 环境要求

- Python 3.13+、MySQL 8.0、Redis 8、Neo4j Desktop、Ollama（bge-m3）
- Windows 原生部署（见技术选型文档）

## 快速启动

```bash
cp .env.example .env
pip install -r requirements.txt
# 首次：灌 Core 模拟库与同步 — 见 docs/memory/FLOW.md §0
uvicorn app.main:app --reload
```

健康检查：`GET http://127.0.0.1:8000/health`

## 前端

React 19 + Vite 7 + Ant Design 5（待 init `web/` 目录）。