freedakgmail
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
# 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。
|