docs: refocus README on project overview
This commit is contained in:
107
README.md
107
README.md
@@ -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。
|
||||
|
||||
Reference in New Issue
Block a user