云
16 小时以前 d9b169a7b3b35137eb098127fc5ddaab24bd9b39
docs(ai): 添加 AI 总开关配置说明

- 在 mermaid 流程图中增加 AI 总开关节点及隐藏逻辑
- 新增 AI 总开关章节详细说明开关配置和功能
- 更新 business.json 中 AI 参与说明加入总开关控制描述
已修改3个文件
16 ■■■■■ 文件已修改
docs/agent_material_import_integration.md 7 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/data/business.json 2 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/project-business/mermaid/11-ai-business-flow.mmd 7 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史
docs/agent_material_import_integration.md
@@ -144,3 +144,10 @@
- 任务按租户 + 用户隔离,换账号或跨租户访问返回 404。
- 本阶段不提供进度推送;提交为同步请求,前端需设置足够长的超时(建议 120 秒),超时后查询回执。
- 不支持更新已有物料;如业务需要修改物料,仍走既有物料编辑流程。
## AI 总开关
- 开关项:`VITE_APP_AI_ENABLE`(默认 `true`,设为 `false` 即关闭)。
- 关闭后:不注册 `/ai` 模块路由;物料列表「智能体导入」、发票/报价「识别录入」、工单 AI 预测、质检 AI 判定与质检助手全部隐藏;已打开的页面刷新后生效。
- 开关只影响前端入口,不改变后端接口与权限;后端仍按各自业务/写开关独立控制。
- 前端通过 `@vben/hooks` 的 `isAiEnable()` 读取,业务页面自定义按钮需同样用该方法包裹显示条件。
docs/project-business/data/business.json
@@ -63,7 +63,7 @@
    ],
    [
      "AI 在哪里参与",
      "发票/报价 OCR 预填、质检结果建议、缺料/时长/风险/交付四类预测;均为『业务组装 Prompt→模型→JSON→人工确认』模式。智能体物料导入另走规则+Java 预检链路,人工确认后幂等提交,只新建不同步 MES"
      "发票/报价 OCR 预填、质检结果建议、缺料/时长/风险/交付四类预测;均为『业务组装 Prompt→模型→JSON→人工确认』模式。智能体物料导入另走规则+Java 预检链路,人工确认后幂等提交,只新建不同步 MES。AI 入口统一受总开关 VITE_APP_AI_ENABLE 控制,关闭即隐藏模块路由与各业务 AI 按钮"
    ],
    [
      "模块间数据关系",
docs/project-business/mermaid/11-ai-business-flow.mmd
@@ -47,3 +47,10 @@
  A6 --> A7[逐行回执·SUCCESS/SKIPPED/FAILED+目标物料ID]
  A6 --> A8[超时或中断→查询命令回执对账·不盲目重试]
  A9[只新建不更新·syncMes=false·不触发MES同步] --- A6
  AIENV[AI 总开关 VITE_APP_AI_ENABLE=false] --> AHIDE[隐藏 /ai 模块路由与全部业务 AI 入口:发票/报价识别录入·四类预测·质检判定·质检助手·智能体导入]
  AHIDE -.-> O6
  AHIDE -.-> Q4
  AHIDE -.-> J5
  AHIDE -.-> W11
  AHIDE -.-> A1
  AHIDE -.-> R2