docs: refocus README on project overview

This commit is contained in:
hailin
2026-07-27 19:17:48 +08:00
parent 78a70ee7c2
commit 7ba9ddf54d

107
README.md
View File

@@ -1,24 +1,53 @@
# AI 工单平台
面向单一企业私有化部署的 AI 原生技术支持工单平台。系统以工单和业务知识为中心,
提供多模态智能受理、技术支持分析、知识治理、Agent/Skill/模型配置、Tool/MCP 扩展、
企业身份、渠道接入、审计和生产运维能力。
> 面向企业私有化部署的 AI 原生技术支持与知识运营平台。
## 当前状态
AI 工单平台把问题受理、技术排查、方案复用、知识沉淀和企业协作连接成一个可审计的
服务闭环。员工可以直接提交文字、截图或文档,系统自动识别问题、创建工单并组织证据;
技术支持人员可借助 Agent 检索可信知识和历史方案,完成排查、回复与知识发布。
阶段 1~6 的工程基线已经实现,完整自动化基线为后端 **217 项**、前端 **73 项**。
工程完成不等于真实生产环境验收完成:统一蓝图退出报告当前为 **1/9 个门槛通过**,
已通过隔离一致性恢复;其余 8 项需要脱敏真实案例或企业外部服务。
平台并不把 AI 作为绕过流程的自动化脚本。所有模型输出、字段来源、工具调用和状态变化
都受到权限、策略、版本与审计约束,适合部署在对数据边界和操作风险有明确要求的企业环境。
| 领域 | 已实现能力 | 仍待真实环境验收 |
|---|---|---|
| 工单 | 权限、状态机、字段保护、证据、协作、附件、审计 | 真实业务量下的权限和流程策略 |
| 智能受理 | 文本、图片、PDF、TXT、LOG、DOCX、XLSX、PPTX,自动建单和人工降级 | 脱敏真实案例自动建单率与字段准确率 |
| 智能支持 | 混合检索、引用冻结、方案复用、自动解决策略、客户回复和 SLA | 真实案例、Embedding、重排和文本模型 |
| 知识治理 | 统一版本、独立审核、蒸馏、发布、下线、回滚和安全文档导入 | 真实 MinIO、ClamAV、PostgreSQL 和模型服务 |
| Agent/Tool | 步骤级模型、运行快照、HTTP MCP、授权交集、高风险双人确认 | 生产 MCP 网络与凭据边界 |
| 企业能力 | OIDC、目录同步、企业组映射、渠道幂等收发和回执 | 企业 IdP/LDAP 与服务群机器人 |
| 生产运维 | Compose、健康探针、指标、告警、备份、校验和隔离恢复 | 告警接收方、定时任务和异地加密备份 |
[快速启动](#快速启动) · [产品蓝图](docs/product/blueprint.md) ·
[开发指南](docs/development/development-guide.md) ·
[生产部署](docs/operations/production-runbook.md)
## 核心价值
- **从材料到工单**:提交文字、图片、日志、PDF 或 Office 文档,自动解析问题并创建工单。
- **从工单到解决**:结合知识、历史工单和解决方案生成有引用、可追溯的技术支持建议。
- **从解决到知识**:将已解决工单蒸馏为候选知识,经独立审核后发布并重新进入检索。
- **从 Agent 到受控执行**:通过 Tool/MCP 调用企业系统,高风险操作必须经过独立确认。
- **从单点功能到企业闭环**:支持 OIDC、目录同步、服务渠道、SLA、审计和生产运维。
## 核心能力
| 能力域 | 主要能力 |
|---|---|
| 工单管理 | 权限、状态机、字段保护、协作、附件、证据、评论、事件与操作审计 |
| 智能受理 | 文本与多文件解析、结构化提取、自动建单、追问补全、人工接管和 SSE 进度 |
| 智能支持 | 混合检索、引用冻结、方案复用、受控自动解决、客户回复任务和 SLA |
| 知识治理 | 文档导入、版本审核、发布、下线、回滚、知识蒸馏和发布后索引 |
| Agent 平台 | 版本化编排、步骤级模型绑定、运行快照、时间预算、重试和结构化输出 |
| Tool/MCP | HTTP MCP、工具目录同步、授权交集、SSRF 防护、高风险双人确认和调用审计 |
| 企业集成 | OIDC、目录与用户组同步、渠道入站、出站回复、回执和消息幂等 |
| 生产运维 | 健康探针、Prometheus 指标、告警、备份校验、恢复和隔离演练 |
## 工作闭环
```mermaid
flowchart LR
MATERIAL["文字 / 图片 / 文档"] --> INTAKE["AI 智能受理"]
INTAKE --> TICKET["正式工单"]
TICKET --> SUPPORT["Agent 技术支持"]
SUPPORT --> REPLY["解决方案与客户回复"]
REPLY --> RESOLVED["工单解决"]
RESOLVED --> DISTILL["知识蒸馏"]
DISTILL --> REVIEW["人工审核"]
REVIEW --> KNOWLEDGE["发布知识"]
KNOWLEDGE --> SUPPORT
```
## 系统架构
@@ -45,6 +74,17 @@ flowchart LR
- 自动解决同时受 Agent 版本授权、全局策略、置信度和操作人权限约束。
- 原始材料、字段来源、模型运行、工具调用和状态变化均可追溯。
## 技术栈
| 层级 | 技术 |
|---|---|
| 后端 | Python 3.12、Django、Django Ninja、Celery |
| 前端 | React 19、TypeScript、Vite、Tailwind CSS、shadcn/ui |
| 数据 | PostgreSQL、pgvector、Redis、MinIO |
| AI | OpenAI-compatible 模型接口、Embedding、Rerank、Agent Runtime |
| 安全解析 | ClamAV、文件签名与 MIME 校验、受控文档解析 |
| 运维 | Docker Compose、Nginx、Prometheus、Alertmanager |
## 快速启动
前置环境:Python 3.12、Node.js 22 或更高版本、pnpm 11.9.0、Docker Desktop 或
@@ -90,30 +130,12 @@ pnpm build
代码结构、领域约束、迁移和提交规范见[开发指南](docs/development/development-guide.md)。
## 蓝图退出验收
## 项目状态
统一报告把阶段 2~6 的真实案例、真实服务和恢复证据收敛为 9 个门槛:
```powershell
cd backend
python manage.py report_blueprint_readiness `
--evidence ../docs/product/acceptance/blueprint-external-evidence.template.json `
--format text `
--output ../docs/product/acceptance/blueprint-readiness.current.json
```
当前尚待:
1. 阶段 2 脱敏真实受理案例。
2. 阶段 3 脱敏真实支持案例。
3. 真实 PostgreSQL、Embedding 和重排检索验收。
4. 真实模型知识蒸馏、审核、发布和回检。
5. 六类文档在真实 MinIO、ClamAV、PostgreSQL 和 Embedding 环境的闭环。
6. 企业服务群机器人。
7. 企业 OIDC、LDAP 或目录服务。
8. 生产告警、定时备份和异地加密存储。
证据文件不得包含密码、密钥、令牌或凭据字段。
阶段 1~6 的工程基线已经实现,当前自动化基线为后端 **217 项**、前端 **73 项**。
真实案例、企业外部服务和生产环境验证采用独立证据管理,不占用项目主页的产品说明;
需要评估上线准备度时,请查看[能力状态](docs/product/capability-status.md)和
[验收说明](docs/product/acceptance/blueprint-readiness.md)。
## 文档导航
@@ -137,5 +159,12 @@ infra/ Compose、Nginx、监控、备份与恢复脚本
docs/ 产品、开发、前端、运维和验收文档
```
## 安全提示
- `.env`、模型凭据、OIDC 密钥、渠道密钥和 MCP Token 不得提交到 Git。
- 生产环境必须替换示例账号、数据库密码和 MinIO 凭据,并启用 HTTPS。
- 自动解决和高风险工具能力默认应保持关闭,完成权限与审计配置后再逐项启用。
- 外部证据只保存脱敏结果和引用,不保存密码、密钥、令牌或完整敏感输出。
生产部署前请阅读[生产部署与恢复手册](docs/operations/production-runbook.md),不要把
`.env`、真实凭据、运行数据或备份提交到 Git。