AiDOPWarehouse/doc/_tmp_bp_text.txt

################################################################################
### S9/S9运营指标与智慧看板模块蓝图设计方案.docx
################################################################################
S9 运营指标与智慧看板模块
业务蓝图设计方案
Ai-DOP智慧运营管理系统
--- TABLE 5x2 ---
   | 文档编号 | S9-BBP-001
   | 版本 | V0.2
   | 密级 | 内部
   | 编制单位 | 智造易项目组
   | 编制日期 | 2026-07-30
版本记录
--- TABLE 3x4 ---
   | 日期 | 版本 | 修订人 | 变更说明
   | 2026-07-30 | V0.1 | 智造易项目组 | 初版建立
   | 2026-07-30 | V0.2 | 智造易项目组 | 对齐《技术规范书_20260728修订》需求与功能要求；统一 REQ/FUNC 编号与版式
目录
（请在 Word 中右键目录区域 → 更新域；下文按 Heading 生成目录条目）
[Heading 1] 1 总体业务方案
[Heading 2] 1.1 目标和宗旨
落实报价范围「九宫格智慧运营看板及 S9 运营指标看板（报价：九宫格智慧运营看板）」，并将《技术规范书_20260728修订》中对应功能要求转化为可配置、可验收的功能方案。
引用《技术规范书_20260728修订》第 2.6 节「运营绩效指标测量（S9）」、第 2.6.1 节「九宫格智慧运营看板（S9）」。
核心目标（规范 2.6.1）：建立全流程关键绩效指标（KPI）定义、数据测量、偏差分析及可视化，覆盖客户订单交付、订单协同、供应协同、采购、物料、生产、成品仓储等核心指标，支撑运营决策优化；通过 BI 工具实现全流程数据可视化，支持管理层决策和业务人员自助分析。
KPI 示例口径（规范）：产销协同—OTD 交付率=按时交付订单数/总订单数×100%；生产执行—OEE=可用率×表现率×质量率×100%；采购供应—供应商交付率；质量—成品合格率；库存周转—库存周转天数。
[Heading 2] 1.2 总体业务流程图
总体路径：系统集成采存治用 → KPI日批计算 → 九宫格/部门看板可视化 → 偏差分析与智慧诊断 → 改善建档派单跟踪与效果复盘闭环。
[Heading 2] 1.3 方案设计
前端：Vue3 + Element Plus；动态看板与智慧诊断闭环页。后端：Admin.NET + 数据中台分层（STG/STD/DWD/KPI）+ Outbox 出站；对接方式含数据库直连与 HTTP API。
[Heading 1] 2 九宫格智慧运营看板（FUNC-S9-005）
[Heading 2] 2.1 目标/宗旨
落实规范 2.6.1：为管理层提供全流程 KPI 一屏总览与异常预警入口。
规范追溯：技术规范 2.6.1「可视化看板设计—管理层大屏」及九宫格智慧运营看板总要求
实现现状：部分完成（主体可用）
• 已实现：九宫格首页、L1 KPI 卡片、红黄绿、基础筛选、点击进入模块详情看板（DynamicModuleDashboard）。
• 证据：Web/src/views/dashboard/home.vue；GET /api/AidopKanban/home-grid/{moduleCode}。
• 缺口：S8 顶栏报警/状态灯仍为演示硬编码；规范「部门看板」无独立主题页，下钻为模块看板而非生产/采购/质量部门专页。
[Heading 2] 2.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 进入大屏 | 管理层 | 打开九宫格 | 权限/租户 | 九宫格页面
   | 20 | 查看KPI | 管理层 | 浏览核心KPI与预警 | 日批KPI | 态势判断
   | 30 | 筛选 | 运营专员 | 调整日期/组织 | 筛选条件 | 刷新卡片
   | 40 | 下钻 | 运营专员 | 点击模块格子 | 模块路由 | 部门/详情看板或诊断
[Heading 2] 2.3 业务流程说明
管理层登录后进入九宫格首页，查看 OTD、质量合格率等核心 KPI 及异常预警摘要。
按组织/日期筛选后，各模块 L1 指标同步刷新；未达标项以红/黄状态标识。
需要深入分析时，点击对应模块格子进入部门看板或 S9/模块详情看板；对异常指标可进入运营诊断。
无数据时显示空态，不阻断页面访问；外部数据未就绪时按条件验收。
[Heading 2] 2.4 业务流程规则
• KPI 口径以运营指标主数据及规范示例公式为准，页面不得硬编码冲突口径。
• 日批 KPI 按规范在数据中台侧自动计算；看板只读展示。
• 未达标须可进入偏差分析/诊断链路。
• 租户与权限隔离；无权限模块不展示明细。
[Heading 2] 2.5 权限管理需求
管理层（大屏只读）；运营专员（筛选下钻）；指标配置在 S0 运营建模。
[Heading 2] 2.6 系统接口集成
读取 KPI 日结果与布局配置；不直接写外部系统。
[Heading 2] 2.7 报表需求
管理层大屏即时视图；可联动异常预警摘要。
对应需求：REQ-S9-005；路由：/aidop/smart-ops/grid；/dashboard/home。
[Heading 1] 3 S9运营指标看板（FUNC-S9-004）
[Heading 2] 3.1 目标/宗旨
落实规范 2.6.1：完成 KPI 测量展示、偏差分析、部门看板与自助下钻。
规范追溯：技术规范 2.6.1「KPI计算与分析」「部门看板」「自助分析支持」
实现现状：部分完成（主体可用）
• 已实现：S9 动态看板、L1/L2（及更深）卡片级联、趋势图、时间/产品等筛选、偏差标签与诊断跳转。
• 证据：Web/src/views/aidop/kanban/s9.vue → DynamicModuleDashboard；dashboard-page API。
• 缺口：无独立「偏差分析」原因库模块；无规范所述生产/采购/质量「部门看板」独立视图（仅有指标部门字段）。
[Heading 2] 3.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 打开看板 | 运营/部门人员 | 进入S9看板 | 权限 | 指标页
   | 20 | 查看KPI | 运营人员 | 浏览L1/L2/趋势 | 日批KPI | 达标判断
   | 30 | 偏差分析 | 运营人员 | 点击未达标指标 | 阈值/明细 | 原因线索或诊断
   | 40 | 自助下钻 | 业务人员 | 按时间/产品筛选并下钻 | 筛选条件 | 明细数据
[Heading 2] 3.3 业务流程说明
运营或部门人员打开 S9 运营指标看板，查看 L1/L2 指标、趋势与达标状态。
对未达标 KPI 查看偏差信息，必要时进入诊断分析原因。
按时间、产品等条件筛选，观察质量波动或交付波动。
从汇总指标下钻至工序/单据级明细，完成自助分析。
生产/采购/质量相关主题区展示规范要求的部门关注指标。
[Heading 2] 3.4 业务流程规则
• 自动计算在中台日批完成；看板展示不得与主数据口径冲突。
• 偏差分析须可追溯到指标编码与筛选上下文。
• 下钻受数据权限约束；空结果须友好提示。
[Heading 2] 3.5 权限管理需求
管理层、部门业务人员、运营专员；配置类在运营指标建模。
[Heading 2] 3.6 系统接口集成
看板 API、下钻 API、诊断入口；KPI 来源 DWS/指标层。
[Heading 2] 3.7 报表需求
部门看板视图、趋势与下钻明细；可扩展导出。
对应需求：REQ-S9-004；路由：/aidop/smart-ops/s9；/aidop/kanban/s9。

################################################################################
### 运营诊断/运营诊断模块蓝图设计方案.docx
################################################################################
运营诊断模块
业务蓝图设计方案
Ai-DOP智慧运营管理系统
--- TABLE 5x2 ---
   | 文档编号 | OD-BBP-001
   | 版本 | V0.2
   | 密级 | 内部
   | 编制单位 | 智造易项目组
   | 编制日期 | 2026-07-30
版本记录
--- TABLE 3x4 ---
   | 日期 | 版本 | 修订人 | 变更说明
   | 2026-07-30 | V0.1 | 智造易项目组 | 初版建立
   | 2026-07-30 | V0.2 | 智造易项目组 | 对齐《技术规范书_20260728修订》需求与功能要求；统一 REQ/FUNC 编号与版式
目录
（请在 Word 中右键目录区域 → 更新域；下文按 Heading 生成目录条目）
[Heading 1] 1 总体业务方案
[Heading 2] 1.1 目标和宗旨
落实报价范围「运营问题诊断（九宫格下钻、诊断报表）」，并将《技术规范书_20260728修订》中对应功能要求转化为可配置、可验收的功能方案。
引用《技术规范书_20260728修订》第 2.6.2 节「运营问题诊断」。
基于统一数据抽取能力，打通产销、运作、供应、采购执行、物料仓储内物流、生产执行、成品仓储外物流全环节数据，构建订单至成品出库端到端数据链路，开展智能化诊断。
以销售订单为主线串联需求预测、采购计划、来料入库、车间生产、半成品流转、成品入库、发货配送等节点，自动识别断点、滞后、损耗、供需失衡、库存积压、交付延期、产能浪费、物流低效等异常。
[Heading 2] 1.2 总体业务流程图
总体路径：系统集成采存治用 → KPI日批计算 → 九宫格/部门看板可视化 → 偏差分析与智慧诊断 → 改善建档派单跟踪与效果复盘闭环。
[Heading 2] 1.3 方案设计
前端：Vue3 + Element Plus；动态看板与智慧诊断闭环页。后端：Admin.NET + 数据中台分层（STG/STD/DWD/KPI）+ Outbox 出站；对接方式含数据库直连与 HTTP API。
[Heading 1] 2 智慧诊断（FUNC-S9-006）
[Heading 2] 2.1 目标/宗旨
落实规范 2.6.2：自动识别全链路运营异常并完成根因溯源与诊断报告输出。
规范追溯：技术规范 2.6.2 全文
实现现状：部分完成（主体可用）
• 已实现：智慧诊断页、环节诊断矩阵、L3/L4 下钻、目标&现状/主要问题、转改善入口。
• 证据：Web/src/views/aidop/diagnosis/index.vue；GET /api/AidopKanban/smart-diagnosis/{moduleCode}。
• 缺口：正式「运营诊断报告」落库/导出实体与 API 未实现（页面结论≠规范报告产物）；7 维溯源依赖主数据与明细接通程度，未全量保证。
• 时效：实时≤3 分钟依赖源数据刷新，需条件验收。
[Heading 2] 2.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 6x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 进入诊断 | 运营专员 | 从看板/菜单进入 | 指标上下文 | 诊断页
   | 20 | 异常识别 | 系统/专员 | 浏览环节诊断结论 | 全链路数据 | 异常清单
   | 30 | 根因下钻 | 运营专员 | 按7类维度下钻 | 明细证据 | 根因线索
   | 40 | 输出报告 | 运营专员 | 确认诊断报告/主要问题 | 诊断结果 | 报告/建议
   | 50 | 转改善 | 运营专员 | 生成改善任务入口 | 诊断结论 | 改善闭环
[Heading 2] 2.3 业务流程说明
运营人员从九宫格或指标看板进入智慧诊断，系统带入指标与筛选上下文。
按业务环节查看诊断要点与红黄绿状态，识别交付延期、缺料、停滞等异常。
点击下钻，按订单/物料/供应商/产线等维度查看证据明细。
在目标&现状、主要问题区确认诊断结论，导出或查看诊断报告摘要。
需要整改时转入改善计划（同一 FUNC-S9-006）。
[Heading 2] 2.4 业务流程规则
• 诊断须可追溯到订单主线或指标编码。
• 至少支持规范所列 7 类根因维度中的已实现维度下钻（未接通数据源可条件验收）。
• 实时/周期识别时效以对接数据就绪为前提；第三方延迟不计入本系统缺陷。
• 改善任务生成并入 FUNC-S9-006，不另起功能号。
[Heading 2] 2.5 权限管理需求
运营专员执行诊断；管理层只读；责任部门配合举证。
[Heading 2] 2.6 系统接口集成
统一数据抽取/KPI/明细下钻 API；改善任务接口。
[Heading 2] 2.7 报表需求
运营诊断报告（结论、根因、建议摘要）。
对应需求：REQ-S9-006；路由：/aidop/smart-diagnosis。

################################################################################
### 运营改善/运营改善模块蓝图设计方案.docx
################################################################################
运营改善模块
业务蓝图设计方案
Ai-DOP智慧运营管理系统
--- TABLE 5x2 ---
   | 文档编号 | OI-BBP-001
   | 版本 | V0.2
   | 密级 | 内部
   | 编制单位 | 智造易项目组
   | 编制日期 | 2026-07-30
版本记录
--- TABLE 3x4 ---
   | 日期 | 版本 | 修订人 | 变更说明
   | 2026-07-30 | V0.1 | 智造易项目组 | 初版建立
   | 2026-07-30 | V0.2 | 智造易项目组 | 对齐《技术规范书_20260728修订》需求与功能要求；统一 REQ/FUNC 编号与版式
目录
（请在 Word 中右键目录区域 → 更新域；下文按 Heading 生成目录条目）
[Heading 1] 1 总体业务方案
[Heading 2] 1.1 目标和宗旨
落实报价范围「运营问题改善闭环（改善建议、效果验证；FUNC 并入 S9-006）」，并将《技术规范书_20260728修订》中对应功能要求转化为可配置、可验收的功能方案。
引用《技术规范书_20260728修订》第 2.6.3 节「运营问题改善闭环」。
承接诊断输出的全流程运营异常，搭建问题建档、整改派单、过程跟踪、效果量化复盘、优化经验固化一体化闭环。
生成改善任务并追踪闭环；自动对比改善前后各环节经营指标，评估优化成效，沉淀标准化管控规则。
[Heading 2] 1.2 总体业务流程图
总体路径：系统集成采存治用 → KPI日批计算 → 九宫格/部门看板可视化 → 偏差分析与智慧诊断 → 改善建档派单跟踪与效果复盘闭环。
[Heading 2] 1.3 方案设计
前端：Vue3 + Element Plus；动态看板与智慧诊断闭环页。后端：Admin.NET + 数据中台分层（STG/STD/DWD/KPI）+ Outbox 出站；对接方式含数据库直连与 HTTP API。
[Heading 1] 2 改善计划与效果验证（FUNC-S9-006）
[Heading 2] 2.1 目标/宗旨
落实规范 2.6.3：诊断异常可派单、可跟踪、可量化复盘并闭环。
规范追溯：技术规范 2.6.3 全文（衔接 2.6.2 改善任务）
实现现状：部分完成（主体可用）
• 已实现：由诊断生成改善计划、审批流提交、行动项状态更新、有效性验证仪表与提交验证。
• 证据：AdoSmartOpsImprovementPlan API；SmartOpsImprovementBizHandler；诊断页闭环区。
• 缺口：「派单」主要为状态流转，无独立工单/OA 派单通道；经验固化/标准规则沉淀能力较弱。
[Heading 2] 2.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 问题建档 | 运营专员 | 由诊断生成改善计划 | 诊断结论 | 改善单
   | 20 | 整改派单 | 运营专员/审批人 | 提交审批并指派责任人 | 计划表单 | 待办任务
   | 30 | 过程跟踪 | 责任人 | 更新行动项状态 | 执行记录 | 进度可视
   | 40 | 效果复盘 | 运营专员 | 对比改善前后指标并关闭 | 基线/当前KPI | 闭环结论
[Heading 2] 2.3 业务流程说明
运营人员在诊断确认问题后建立改善计划（问题建档）。
指定责任人与行动项并提交，形成整改派单（审批中心待办）。
责任人更新执行进度，运营人员过程跟踪。
在有效性验证中对比基线与当前 KPI，量化复盘后闭环或继续改善。
[Heading 2] 2.4 业务流程规则
• 改善单必须关联诊断问题或指标，保证端到端追溯。
• 派单复用平台审批流，不另建孤立任务系统。
• 效果验证须保留基线值、目标值、验证结论。
• FUNC 固定为 FUNC-S9-006。
[Heading 2] 2.5 权限管理需求
运营专员建档与复盘；责任人执行；审批人派单审批；管理层只读。
[Heading 2] 2.6 系统接口集成
改善计划 API、审批流、KPI 对比查询。
[Heading 2] 2.7 报表需求
改善任务清单、成效对比、闭环统计。
对应需求：REQ-S9-007；路由：/aidop/smart-diagnosis（改善计划/有效性验证）。

################################################################################
### 系统集成/系统集成模块蓝图设计方案.docx
################################################################################
系统集成模块
业务蓝图设计方案
Ai-DOP智慧运营管理系统
--- TABLE 5x2 ---
   | 文档编号 | INT-BBP-001
   | 版本 | V0.2
   | 密级 | 内部
   | 编制单位 | 智造易项目组
   | 编制日期 | 2026-07-30
版本记录
--- TABLE 3x4 ---
   | 日期 | 版本 | 修订人 | 变更说明
   | 2026-07-30 | V0.1 | 智造易项目组 | 初版建立
   | 2026-07-30 | V0.2 | 智造易项目组 | 对齐《技术规范书_20260728修订》需求与功能要求；统一 REQ/FUNC 编号与版式
目录
（请在 Word 中右键目录区域 → 更新域；下文按 Heading 生成目录条目）
[Heading 1] 1 总体业务方案
[Heading 2] 1.1 目标和宗旨
落实报价范围「系统集成（架构适用、各模块集成、各接口集成）+ 规范 2.6 所述 SSO」，并将《技术规范书_20260728修订》中对应功能要求转化为可配置、可验收的功能方案。
引用《技术规范书_20260728修订》第 2.7 节「系统集成模块」、2.7.1「对接适配指标」、2.7.2「数据传输性能指标」；并引用 2.6 中系统对接与 SSO（OAuth2.0）要求。
支持 ERP、MES、CRM、WMS、SRM、TMS 等多类系统多模式对接采集，完成异构数据清洗与标准化融合，搭建订单至出库统一数据底座。
具备集成通道可视化配置、数据同步监控、异常告警、传输安全管控；向上支撑诊断与分析模块。
[Heading 2] 1.2 总体业务流程图
总体路径：系统集成采存治用 → KPI日批计算 → 九宫格/部门看板可视化 → 偏差分析与智慧诊断 → 改善建档派单跟踪与效果复盘闭环。
[Heading 2] 1.3 方案设计
前端：Vue3 + Element Plus；动态看板与智慧诊断闭环页。后端：Admin.NET + 数据中台分层（STG/STD/DWD/KPI）+ Outbox 出站；对接方式含数据库直连与 HTTP API。
[Heading 1] 2 ERP同步（FUNC-S9-001）
[Heading 2] 2.1 目标/宗旨
落实规范 2.7.1：提供可配置的多系统入站同步能力。
规范追溯：技术规范 2.7 / 2.7.1（接入方式、定时/实时、可视化配置）
实现现状：仅占位（未完成）
• 菜单 /aidop/s9/001 指向规划占位页 AidopDemoShell（planning/index），非真实 ERP 同步业务页。
• 真实入站同步/可视化配置在数据中台 FUNC-S9-010～013（另册），未挂接到本入口。
• 结论：规范 2.7 能力部分存在于数据中台，本 FUNC 菜单级未完成。
[Heading 2] 2.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 配置接入 | 实施工程师 | 登记源与映射 | 连接/API | 数据源就绪
   | 20 | 配置同步 | 实施工程师 | 定时或实时任务 | 实体映射 | 任务启用
   | 30 | 执行 | 系统/运维 | 拉取并清洗 | 源数据 | 标准层数据
   | 40 | 消费 | 业务用户 | 业务与看板使用 | STD/DWD/KPI | 业务可见
[Heading 2] 2.3 业务流程说明
实施人员在同步入口或数据中台配置数据源与映射（直连或 API）。
配置定时/实时任务并启用，执行首次同步验证。
业务数据进入贴源/标准层后，业务页与看板可消费。
无真实外部系统时，以契约/Mock 条件验收。
[Heading 2] 2.4 业务流程规则
• 接入方式限于规范所述直连与 HTTP API（及项目已实现的等价方式）。
• 凭据安全管控，前端不明文展示密钥。
• 清洗含字段标准化、空值过滤、异常标记、编码统一。
• 外部系统不可用导致的延迟不计入本系统性能不达标。
[Heading 2] 2.5 权限管理需求
实施工程师、系统管理员；业务用户消费结果。
[Heading 2] 2.6 系统接口集成
MDP DB/API Pull 执行器；各模块源对象见双模式对接方案。
[Heading 2] 2.7 报表需求
同步结果见日志查询。
对应需求：REQ-S9-001；路由：/aidop/s9/001。
[Heading 1] 3 日志查询（FUNC-S9-002）
[Heading 2] 3.1 目标/宗旨
落实规范 2.7：集成运行可监控、异常可告警可追溯。
规范追溯：技术规范 2.7「数据同步监控、异常告警」
实现现状：仅占位（未完成）
• /aidop/s9/002 为占位页；同步/动作日志真实页为数据中台 FUNC-S9-014/015。
• 结论：集成监控能力分散在数据中台，本入口未完成。
[Heading 2] 3.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 4x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 打开日志 | 运维 | 进入日志查询 | 权限 | 日志列表
   | 20 | 筛选监控 | 运维 | 按时间/状态筛选 | 条件 | 过滤结果
   | 30 | 异常处理 | 运维 | 查看失败并处置 | 错误详情 | 重试或转人工
[Heading 2] 3.3 业务流程说明
运维打开日志查询，按时间与状态筛选。
查看失败记录的错误信息并处理。
空结果提示暂无数据。
[Heading 2] 3.4 业务流程规则
• 租户隔离；敏感凭据不落前端明文。
• 告警与失败日志须可关联到任务与批次。
[Heading 2] 3.5 权限管理需求
运维、系统管理员。
[Heading 2] 3.6 系统接口集成
同步日志、动作运行日志表/API。
[Heading 2] 3.7 报表需求
同步监控列表。
对应需求：REQ-S9-002；路由：/aidop/s9/002。
[Heading 1] 4 ERP事务（FUNC-S9-003）
[Heading 2] 4.1 目标/宗旨
落实规范 2.7.2：出站传输可控、可容错、状态可查。
规范追溯：技术规范 2.7 / 2.7.2（双向流转、传输容错、实时/批量时延目标）
实现现状：仅占位（未完成）
• /aidop/s9/003 为占位页；Outbox/回写执行器在中台链路，本入口无事务列表业务页。
• 结论：出站事务可视菜单未完成。
[Heading 2] 4.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 业务触发 | 业务用户 | 完成需回写操作 | 业务单据 | Outbox
   | 20 | 推送 | 系统 | API推送 | Outbox | 外部回执
   | 30 | 监控 | 运维 | 查事务状态 | 事务列表 | 成功/失败
   | 40 | 容错 | 运维 | 重试/续传 | 失败事务 | 状态更新
[Heading 2] 4.3 业务流程说明
业务操作触发回写后，运维在事务页核对待发送/成功/失败。
对失败事务查看错误并按策略重试。
无真实外部系统时以 Outbox+Mock 条件验收。
[Heading 2] 4.4 业务流程规则
• 回写统一走 Outbox，禁止无日志直连外写。
• 断点续传/重试避免重复入库或丢失（入站侧同等要求）。
• 第三方超时不计入本系统性能缺陷。
[Heading 2] 4.5 权限管理需求
运维处理失败；业务触发；管理员配置端点。
[Heading 2] 4.6 系统接口集成
mdp_outbox、API Push 执行器。
[Heading 2] 4.7 报表需求
事务成功率与失败清单。
对应需求：REQ-S9-003；路由：/aidop/s9/003。
[Heading 1] 5 单点登录SSO（FUNC-S9-001）
[Heading 2] 5.1 目标/宗旨
落实规范 SSO 要求，减少重复登录。
规范追溯：技术规范 2.6「支持单点登录（SSO），OAuth2.0」
实现现状：未实现
• 企业工业互联网平台 OAuth2.0 SSO 未落地；现有仅为微信/Gitee 社交登录脚手架（ClientId 占位），登录页 SSO 入口未启用。
• 验收 TV-INT-004 仍为条件/待验。
[Heading 2] 5.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 4x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 平台登录 | 员工 | 登录工业互联网平台 | 账号 | 已认证会话
   | 20 | 跳转DOP | 员工 | 打开Ai-DOP | OAuth请求 | 授权
   | 30 | 建会话 | 系统 | 映射用户并建会话 | 令牌 | 进入系统
[Heading 2] 5.3 业务流程说明
用户从工业互联网平台入口进入 Ai-DOP。
经 OAuth2.0 授权后免二次账号密码登录（或按平台约定静默登录）。
权限按 Ai-DOP 租户角色生效。
[Heading 2] 5.4 业务流程规则
• 仅信任配置的身份源；令牌校验失败拒绝进入。
• 用户须能映射到有效租户账号，否则提示开通。
[Heading 2] 5.5 权限管理需求
全体员工（已开通）；管理员配置 OAuth 客户端。
[Heading 2] 5.6 系统接口集成
OAuth2.0 授权服务器；Ai-DOP 认证中间件。
[Heading 2] 5.7 报表需求
登录审计日志（平台安全要求）。
对应需求：REQ-S9-008；路由：OAuth2.0 登录回调（平台级）。

################################################################################
### ChatBI/ChatBI智能报表模块蓝图设计方案.docx
################################################################################
ChatBI智能报表模块
业务蓝图设计方案
Ai-DOP智慧运营管理系统
--- TABLE 5x2 ---
   | 文档编号 | CBI-BBP-001
   | 版本 | V0.2
   | 密级 | 内部
   | 编制单位 | 智造易项目组
   | 编制日期 | 2026-07-30
版本记录
--- TABLE 3x4 ---
   | 日期 | 版本 | 修订人 | 变更说明
   | 2026-07-30 | V0.1 | 智造易项目组 | 初版建立
   | 2026-07-30 | V0.2 | 智造易项目组 | 对齐《技术规范书_20260728修订》需求与功能要求；统一 REQ/FUNC 编号与版式
目录
（请在 Word 中右键目录区域 → 更新域；下文按 Heading 生成目录条目）
[Heading 1] 1 总体业务方案
[Heading 2] 1.1 目标和宗旨
落实报价范围「ChatBI智能报表：自然语言模型配置、ChatBI报表呈现（报价）；规范 2.6.4」，并将《技术规范书_20260728修订》中对应功能要求转化为可配置、可验收的功能方案。
引用《技术规范书_20260728修订》第 2.6.4 节「ChatBI智能报表」。
规范目标：以自然语言描述自动生成多维可视化报表；流程为：自然语言提问 → 理解意图 → 匹配业务规则 → 生成 SQL → 查询数据 → 生成解释 → 返回答案。
报价要求：前端智能问答页/报表结果展示/查询历史；后端 NL 问数解析、语义匹配、权限、结果解释与追问、查询留痕。
[Heading 2] 1.2 总体业务流程图
总体路径：系统集成采存治用 → KPI日批计算 → 九宫格/部门看板可视化 → 偏差分析与智慧诊断 → 改善建档派单跟踪与效果复盘闭环。
[Heading 2] 1.3 方案设计
前端：Vue3 + Element Plus；动态看板与智慧诊断闭环页。后端：Admin.NET + 数据中台分层（STG/STD/DWD/KPI）+ Outbox 出站；对接方式含数据库直连与 HTTP API。
[Heading 1] 2 ChatBI智能问答（FUNC-S9-007）
[Heading 2] 2.1 目标/宗旨
落实规范 2.6.4：以自然语言获取运营指标解释；MVP 先通问答，再演进 NL2SQL/报表。
规范追溯：技术规范 2.6.4；报价 ChatBI智能报表
实现现状：部分完成（MVP 可用）
• 已实现：ChatBIFloat/Panel 浮窗问答；意图分类；读 KPI 日表聚合；确定性结论段落；DeepSeek 润色；建议问题；跳转看板/诊断。
• 证据：Web/src/views/aidop/chatbi/*；Plugins/.../ChatBI/ChatBIController.cs。
• 缺口（相对规范/报价）：无 NL2SQL、无可视化报表自动生成、无持久查询历史、无语义/模型配置页、无独立菜单路由、Controller 当前 AllowAnonymous。
• 验收建议：MVP 按「自然语言问 KPI + 解释」典型场景验收；NL2SQL/历史/配置列为后续或条件项并在三联表备注。
[Heading 2] 2.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 打开ChatBI | 业务用户 | 点击浮窗 | 当前模块上下文 | 问答面板
   | 20 | 提问 | 业务用户 | 输入问题或建议问法 | question/filters | 请求
   | 30 | 解析作答 | 系统 | 意图+KPI聚合(+LLM润色) | KPI日表 | 答案/指标卡
   | 40 | 联动 | 业务用户 | 跳转看板或诊断 | actions | 详情页
[Heading 2] 2.3 业务流程说明
用户在九宫格或模块看板打开 ChatBI 浮窗，输入自然语言问题或点选建议问题。
系统返回结论、证据摘要、可能原因与下一步建议，并展示相关 KPI 卡。
用户可按建议追问（当前会话内存），或跳转看板/诊断继续分析。
目标态应支持查询历史回看与语义模型配置（尚未上线）。
[Heading 2] 2.4 业务流程规则
• MVP 不得伪称已执行 NL2SQL；界面保留 Demo/能力说明。
• 目标态生成 SQL 须受权限与租户隔离约束。
• AI 任务可异步；失败回退本地模板答案。
[Heading 2] 2.5 权限管理需求
管理层/运营专员提问；管理员配置模型（目标态）。
[Heading 2] 2.6 系统接口集成
POST /api/AidopChatBI/ask；DeepSeek HTTP；读 ado_s9_kpi_value_l*_day。
[Heading 2] 2.7 报表需求
目标态多维可视化报表；当前为文本+指标卡。
对应需求：REQ-S9-009；路由：组件 ChatBIFloat；API POST /api/AidopChatBI/ask。
[Heading 1] 3 ChatBI报表与历史（目标态）（FUNC-S9-007）
[Heading 2] 3.1 目标/宗旨
补齐规范 2.6.4 与报价中尚未落地的报表/历史/配置能力。
规范追溯：技术规范 2.6.4「生成SQL→查询→可视化报表」；报价查询历史/模型配置
实现现状：未实现
• 无独立问答页、无查询历史 API/表接入、无 NL2SQL、无报表可视化生成、无语义模型配置 UI。
• DDL 壳表 ado_s9_chatbi_* 未接入运行链路。
• 本条用于规范/报价追溯，测试用例标为目标态，不作为当前已完成验收。
[Heading 2] 3.2 业务流程图
流程步骤见下表（文字流程图）。
--- TABLE 5x6 ---
   | 步骤 | 活动 | 角色 | 操作 | 输入 | 输出
   | 10 | 配置 | 管理员 | 维护语义/模型 | 词典 | 可用配置
   | 20 | 提问 | 用户 | 自然语言 | 问题 | SQL/查询
   | 30 | 呈现 | 系统 | 可视化报表 | 结果集 | 图表
   | 40 | 留痕 | 系统 | 写入查询历史 | 问答日志 | 可回看
[Heading 2] 3.3 业务流程说明
用户在独立页提问并生成图表报表。
可回看历史提问与结果。
管理员维护语义词典与模型参数。
[Heading 2] 3.4 业务流程规则
• 未实现前不得在验收中勾选为已完成。
• 实现后须补 FUNC 菜单登记与权限。
[Heading 2] 3.5 权限管理需求
管理员配置；业务用户问数。
[Heading 2] 3.6 系统接口集成
规划 NL2SQL 引擎、历史表、报表组件。
[Heading 2] 3.7 报表需求
多维可视化报表。
对应需求：REQ-S9-010；路由：未实现。