# AIPortPilot — AI+ Portfolio Operating System

> AI 投后管理与组合协同平台：投资人和创始人的共同操作系统。
> 对投资收益负责，主动创造增长，持续进化管理知识。

## 技术栈

| 层 | 技术 | 版本 |
|---|---|---|
| 前端 | Next.js + React + TypeScript | 15.x / 19.x / 5.x |
| UI | TailwindCSS + shadcn/ui + lucide + recharts | 4.x |
| 后端 | Python + FastAPI | 3.12 / 0.115.x |
| 数据库 | PostgreSQL + Redis | 16 / 7.x |
| 向量库 | PgVector (PostgreSQL 扩展) | — |
| AI | Ollama (本地推理) + LangChain | — |
| 部署 | Docker Compose → K8s | — |

## 快速启动

```bash
# [Docker] 一键启动全部基础设施
docker compose up -d

# [Native] 后端
cd backend && uv sync && uv run uvicorn app.main:app --reload --port 8000

# [Native] 前端
cd frontend && pnpm install && pnpm dev
```

详见 [run.md](./run.md)。

## 项目结构

```
AIPortPilot/
├── frontend/          # Next.js 前端（投资人端 + 创始人端 + Admin）
├── backend/           # FastAPI 后端
├── docs/              # 文档（需求 / PRD / 任务 / 日报）
├── docker-compose.yml # 开发环境编排
├── BUILD-METHODOLOGY.md  # 构建方法论 v3.0
└── AI+投后管理方案v2.0.md # 原始方案文档
```

## MVP 范围（Phase 1）

- 企业档案管理
- 月报在线提交 + AI 解析
- 通用健康度评分（财务 + 经营）
- AI+ 专项健康度（商业化 + 成本）
- 投资机构驾驶舱
- 风险预警（指标越界）
- 投后报告自动生成
- 移动端：风险预警推送 + AI Copilot 基础问答

## 文档

- [构建方法论](./BUILD-METHODOLOGY.md)
- [运维手册](./run.md)
- [Agent 协作规则](./AGENTS.md)
- [需求文档](./docs/0-req.md)
- [PRD + 技术设计](./docs/1-prd.md)
- [任务清单](./docs/2-task.md)