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

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

文档

• 需求：0-req-AIAudit.md
• 产品需求（PRD）：1-prd-AIAudit.md
• 开发任务：2-task-AIAudit.md
• 技术选型：docs/adr/ADR-0001-tech-stack.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。

本地开发快速开始

# 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。