# ai-deepAudit

**Repository Path**: yimu51/ai-deep-audit

## Basic Information

- **Project Name**: ai-deepAudit
- **Description**: ai智能审计智能体，分析历史文档，分析项目执行风险
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-06
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-deep-audit

AI 智能审计平台：通过 OCR 与 LLM 智能体分析合同、技术文档等历史资料，识别项目执行风险。

## 当前阶段

**M0：仓库骨架与本地开发环境**

- 见设计稿：[`docs/superpowers/specs/2026-05-06-m0-skeleton-design.md`](docs/superpowers/specs/2026-05-06-m0-skeleton-design.md)
- 见实施计划：[`docs/superpowers/plans/2026-05-06-m0-skeleton.md`](docs/superpowers/plans/2026-05-06-m0-skeleton.md)

## 路线图

| 阶段 | 内容 |
|---|---|
| M0 | 仓库骨架 + 本地依赖 + 完整 JWT 登录端到端 |
| M1 | 主数据：型号 / 合同 / 阶段 / 文档 CRUD |
| M2 | OCR 流水线：PDF / 图片 → 结构化抽取 |
| M3 | 风险规则引擎 |
| M4 | 知识图谱（Neo4j 同步） |
| M5 | AI Chat（问数 / 问风险 / 流式响应） |
| M6 | 前端整合 + G6 图谱可视化 + 风险报告 |

## 前置条件

- Docker Desktop（用于 PostgreSQL / Neo4j / MinIO）
- Python 3.12（推荐用 [uv](https://docs.astral.sh/uv/) 管理）
- Node 20 LTS（推荐用 [pnpm](https://pnpm.io/) 管理）

## 一键起步

```bash
# 1. 复制环境变量
cp .env.example .env
cp .env.example web/.env  # 前端只读 VITE_* 部分

# 2. 装依赖
make install

# 3. 起本地服务（PG + Neo4j + MinIO）
make up

# 4. 数据库迁移 + 种子用户
make migrate
make seed

# 5. 起后端（终端 1）
make api

# 6. 起前端（终端 2）
make web

# 7. 浏览器访问 http://localhost:5173
#    用 admin / admin123 登录，首次登录强制改密
```

## 目录速览

```
api/        FastAPI 后端
web/        React 前端
infra/      docker-compose 配置 + 初始化脚本
docs/       设计稿与实施计划
doc/        样例文档（合同 / 技术文档原件）
```