# Fund Tracer - 电信诈骗资金追踪智能体

通过网页上传受害人手机 APP 账单截图，利用大模型多模态能力提取交易数据，自动汇总并可视化跨 APP 资金流向，支持案件管理、时间线分析、报告导出。

## 技术栈

- **后端**: Python 3.11+ / FastAPI / SQLAlchemy / Pydantic
- **前端**: React 18 + TypeScript / Ant Design / React Flow / Recharts
- **数据库**: SQLite（可切换 PostgreSQL）
- **LLM**: 支持 OpenAI、Anthropic、DeepSeek 多模型切换
- **部署**: Docker Compose

## 本地开发

### 后端

```bash
cd backend
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
# 配置 .env：OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY 等
uvicorn app.main:app --reload --port 8000
```

### 前端

```bash
cd frontend
npm install
npm run dev
```

浏览器访问 http://localhost:5173，API 代理到 http://localhost:8000。

### 环境变量示例（.env）

```env
DATABASE_URL=sqlite+aiosqlite:///./fund_tracer.db
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=...
DEEPSEEK_API_KEY=...
```

## Docker 部署

```bash
cp .env.example .env   # 编辑填入 API Key
docker compose up -d
```

- 前端: http://localhost:3000  
- 后端 API: http://localhost:8000  

## 功能概览

- **案件管理**: 创建/编辑/删除案件，记录受害人信息
- **截图上传**: 多图上传，自动调用 LLM Vision 提取交易
- **资金流向图**: 以有向图展示账户间资金流动
- **时间线**: 按时间顺序展示每笔交易
- **汇总表格**: 交易明细筛选、排序
- **报告导出**: Excel 明细、PDF 报告（含流向图与文字概述）

## License

MIT