freedakgmail
2.2 KiB
2.2 KiB
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. 前端（端口 5173，经 Vite 代理转发后端）
cd frontend && npm install && npm run dev
# 4. 生成演示数据（可选，让看板有线索可看）
cd backend && python -m scripts.seed_demo
说明：本项目不使用 Docker，开发期直接使用本机 PostgreSQL 16。 演示：启动后端+前端后打开 http://localhost:5173 。前端 npm 源建议用国内镜像 （
npm config set registry https://registry.npmmirror.com）；后端 pip 用清华镜像加速。