Initial commit: InternalAuditInterprise

README.md

@@ -0,0 +1,46 @@
+# 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。