docs: complete Chinese project documentation
This commit is contained in:
@@ -1,48 +1,67 @@
|
||||
# AI 工单平台能力状态
|
||||
|
||||
更新日期:2026-07-16
|
||||
更新日期:2026-07-27
|
||||
|
||||
状态定义:
|
||||
|
||||
| 状态 | 含义 |
|
||||
|---|---|
|
||||
| 真实 | 已接真实数据库或服务,具备自动化测试 |
|
||||
| 演示 | 使用 Mock、确定性桩或独立概念页面 |
|
||||
| 缺失 | 尚无可用实现 |
|
||||
| 债务 | 已有实现与目标架构存在明确差距 |
|
||||
| 工程完成 | 代码、迁移、自动化测试和本地可重复验证已经完成 |
|
||||
| 真实验收通过 | 已在目标服务或脱敏真实案例上取得可追溯证据 |
|
||||
| 待真实验收 | 工程完成,但仍缺企业外部服务或真实案例证据 |
|
||||
| 未实现 | 蓝图要求尚无可用工程实现 |
|
||||
|
||||
## 当前能力
|
||||
|
||||
| 领域 | 能力 | 状态 | 说明 |
|
||||
|---|---|---|---|
|
||||
| 企业治理 | 登录、用户、用户组、角色、菜单权限 | 真实 | Django 权限与菜单 API 已实现 |
|
||||
| 企业治理 | 操作审计 | 真实 | 已覆盖治理、工单以及 AI 渠道、版本和运行操作;敏感运行正文不进入普通审计 |
|
||||
| 工单 | 创建、查询、编辑、分类状态流转、评论、导出 | 真实 | 后端与前端均使用真实 API |
|
||||
| 工单 | AI 建单草稿 | 真实 | 自然语言起草、批量补齐、最多 5 轮逐问、人工修改、修订冲突、明确确认、幂等建单和整单决定已实现;真实文本闭环验收通过 |
|
||||
| 工单 | 草稿图片与工单附件 | 真实 | JPEG/PNG/WebP 经签名解码、去 EXIF 后由 Django 代理写入 MinIO,确认时转为真实附件;未确认图片随草稿过期清理 |
|
||||
| 工单 | 真实视觉模型建单 | 缺失 | 多模态协议、视觉模型能力和图片出境授权校验已实现并由模拟适配器覆盖;尚未完成真实视觉渠道验收 |
|
||||
| 工单 | AI 建议 | 债务 | `Ticket.ai_solution` 位于业务主表,后续停止新增依赖 |
|
||||
| 解决方案 | 维护、关联、采纳并关闭工单 | 真实 | 已有 API、事件和使用次数统计 |
|
||||
| 知识 | 知识库、条目、文档文本、切片和检索 | 真实 | 基础 CRUD 与检索 API 可运行 |
|
||||
| 知识 | 向量检索 | 演示 | 使用 JSON 哈希向量和应用内排序,不是 pgvector/真实 Embedding |
|
||||
| AI 平台 | 模型渠道和真实模型测试 | 真实 | OpenAI-compatible 适配器、凭证加密/脱敏、文本/视觉能力标识、图片出境授权、异步测试和一次瞬时重试已实现;本地真实文本渠道验收通过 |
|
||||
| AI 平台 | Skill 草稿、发布、Schema 和回滚 | 真实 | 受限模板、JSON Schema、不可变发布版本、克隆草稿和按版本回滚已实现 |
|
||||
| AI 平台 | Agent 版本、有序执行和运行轨迹 | 真实 | 草稿沙箱、发布校验、Celery 有序执行、失败终止、结构修复、取消、快照和运行详情已实现 |
|
||||
| AI 平台 | MCP | 缺失 | 不在本次演示范围 |
|
||||
| 前端 | 研发管理工作台、两级导航、页面标签、个人中心 | 真实 | 使用真实治理与业务 API;桌面端人工验收已通过 |
|
||||
| 前端 | 全局 Agent 助手面板 | 演示 | 仅做本地交互演示,页面持续显示演示标识,不写业务数据 |
|
||||
| 部署 | PostgreSQL、Redis、MinIO 本地基础设施 | 真实 | `infra/docker-compose.local.yml` |
|
||||
| 部署 | Celery worker 与 Beat | 真实 | 模型测试、Agent 运行与每日留存清理使用 Celery;本地完整编排包含 Redis worker 和 Beat |
|
||||
| 企业治理 | 用户、用户组、角色、菜单和细粒度权限 | 工程完成 | API、前端与权限拒绝测试已覆盖 |
|
||||
| 企业治理 | OIDC、目录同步和企业组映射 | 待真实验收 | 本地契约和治理界面完成,待企业 IdP/LDAP |
|
||||
| 审计 | 工单、Agent、模型、知识、Tool、渠道和身份审计 | 工程完成 | 普通审计不保存凭据和敏感运行正文 |
|
||||
| 工单 | 创建、编辑、状态机、评论、协作、归档和导出 | 工程完成 | 所有写入通过统一领域服务 |
|
||||
| 工单 | 人工字段保护和字段证据 | 工程完成 | Agent 值保留证据,人工修改阻止静默覆盖 |
|
||||
| 智能受理 | 文本、图片和六类文档自动建单 | 待真实验收 | 工程闭环完成,待脱敏真实案例指标 |
|
||||
| 智能受理 | 材料校验、ClamAV、MinIO 和失败恢复 | 待真实验收 | 测试覆盖完成,待真实服务与不同文件类型 |
|
||||
| 支持分析 | 混合检索、引用冻结和结构化建议 | 待真实验收 | 待真实 PostgreSQL、Embedding、重排和案例 |
|
||||
| 自动化 | 方案复用、受控自动解决、客户回复和 SLA | 待真实验收 | 默认关闭自动解决,待真实错误复用率验证 |
|
||||
| 知识 | 知识、排查方案和解决方案统一治理 | 工程完成 | 独立审核、发布、下线、回滚和不可变版本 |
|
||||
| 知识 | 已解决工单知识蒸馏 | 待真实验收 | 待真实文本模型、独立审核和发布回检 |
|
||||
| 知识 | 文档安全导入和向量索引 | 待真实验收 | 待真实 MinIO、ClamAV、PostgreSQL 和 Embedding |
|
||||
| AI 平台 | 模型渠道、部署、凭据和调用记录 | 工程完成 | OpenAI-compatible,支持文本、视觉、向量和重排 |
|
||||
| AI 平台 | Skill 与 Agent 版本和运行轨迹 | 工程完成 | 冻结配置、有序步骤、修复、取消和 SSE 事件 |
|
||||
| Tool/MCP | HTTP MCP、统一目录、授权交集和风险确认 | 工程完成 | 内部只读 MCP 已通过真实 HTTP 端到端调用 |
|
||||
| 渠道 | 签名入站、出站、回执和幂等 | 待真实验收 | 待企业服务群机器人联调 |
|
||||
| 运维 | 健康、指标、告警、生产 Compose | 工程完成 | 待配置真实告警接收方 |
|
||||
| 运维 | 一致性备份、校验和恢复 | 真实验收通过 | 隔离恢复已验证数据库、附件和 MinIO 一致性 |
|
||||
| 运维 | 定时与异地加密备份 | 待真实验收 | 待目标生产主机和异地存储 |
|
||||
|
||||
## 当前质量基线
|
||||
## 质量基线
|
||||
|
||||
- 后端测试:88 项通过;Ruff、迁移检查、Django system check 和数据库迁移通过。
|
||||
- 前端测试:40 项通过;ESLint、TypeScript 类型检查和生产构建通过。
|
||||
- 前端已按路由懒加载拆包,生产主入口约 479.90 KB,无 Vite 体积告警。
|
||||
- `/concept` 设计实验室及其 Mock 数据已按产品决策删除;正式路由测试禁止重新引入概念页面。
|
||||
- 本地桌面端界面人工验收已通过。
|
||||
- 真实模型三步端到端脚本已通过:草稿沙箱与发布版本均成功,版本快照、结构修复、权限拒绝和审计脱敏符合约定。
|
||||
- AI 平台配置 Demo Milestone 已完成;Phase 1 可信建单真实文本闭环已实现并验收。
|
||||
- 真实视觉渠道验收仍待完成,因此不能宣称视觉建单正式可用。
|
||||
- 后端:217 项测试通过。
|
||||
- 前端:73 项测试通过。
|
||||
- Ruff、Django system check 和迁移漂移检查通过。
|
||||
- TypeScript、ESLint 和 Vite 生产构建通过。
|
||||
- 生产 Compose 基础及 monitoring profile 配置通过。
|
||||
- Linux 脚本语法和 `git diff --check` 通过。
|
||||
- 隔离恢复演练验证工单、附件记录和 MinIO 对象一致恢复。
|
||||
|
||||
能力状态只依据已验证代码更新。页面存在、类型定义存在或 Mock 可交互,不视为真实能力。
|
||||
## 蓝图退出状态
|
||||
|
||||
统一蓝图报告当前为 **1/9 个门槛通过**。已通过:
|
||||
|
||||
- 阶段 6 隔离一致性恢复。
|
||||
|
||||
仍待:
|
||||
|
||||
1. 阶段 2 脱敏真实受理案例。
|
||||
2. 阶段 3 脱敏真实支持案例。
|
||||
3. 真实 PostgreSQL、Embedding 和重排检索。
|
||||
4. 真实模型知识蒸馏、审核、发布和回检。
|
||||
5. 六类文档真实服务闭环。
|
||||
6. 企业服务群机器人。
|
||||
7. 企业 OIDC、LDAP 或目录服务。
|
||||
8. 生产告警、定时备份和异地加密存储。
|
||||
|
||||
权威结果见[统一蓝图验收](acceptance/blueprint-readiness.md)和
|
||||
[当前机器报告](acceptance/blueprint-readiness.current.json)。页面存在、类型定义存在、
|
||||
Mock 可交互或合成案例通过,均不能替代真实环境验收。
|
||||
|
||||
Reference in New Issue
Block a user