# AIAudit · 本地私有化大模型电信运营商 AI 全域内审平台

> 数据不出域，审计全穿透。一套建在本地机房、数据零出域、覆盖全业务域、越用越聪明的 AI 内审能力体系。

## 文档
- 需求：[`0-req-AIAudit.md`](./0-req-AIAudit.md)
- 产品需求（PRD）：[`1-prd-AIAudit.md`](./1-prd-AIAudit.md)
- 开发任务：[`2-task-AIAudit.md`](./2-task-AIAudit.md)
- 技术选型：[`docs/adr/ADR-0001-tech-stack.md`](./docs/adr/ADR-0001-tech-stack.md)
- 方案蓝图：[`docs/数据不出域，审计全穿透.md`](./docs/数据不出域，审计全穿透.md)

## 技术栈
后端 Python(FastAPI) · 前端 React+TS(Vite) · PostgreSQL(AGE 图谱 / TimescaleDB 时序 / pgvector 向量) · Celery+Redis · MinIO · LLM(开发期公网千问 / 生产本地 vLLM)。

## 目录结构
```
.
├── backend/            # FastAPI 后端（引擎、数据中台、API）
├── frontend/           # React 前端（线索看板、自然语言查询）
├── infra/              # Docker Compose、自定义镜像、初始化脚本
├── docs/               # 蓝图、ADR
├── 0-req-AIAudit.md
├── 1-prd-AIAudit.md
└── 2-task-AIAudit.md
```

## 数据零出域红线
- 生产环境禁用任何公网 LLM/外网依赖；公网千问仅用于开发测试且只喂脱敏/样例假数据。
- 详见 ADR-0001。

## 本地开发快速开始
```bash
# 1. 初始化本地 PostgreSQL 16（已 Homebrew 安装 postgresql@16 + timescaledb + pgvector）
bash infra/postgres/setup_local.sh

# 2. 后端
cd backend && python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
alembic upgrade head        # 建表
uvicorn app.main:app --reload

# 3. 前端
cd frontend && npm install && npm run dev
```

> 说明：本项目不使用 Docker，开发期直接使用本机 PostgreSQL 16。