# -*- coding: utf-8 -*- """交付文档内容数据：对齐技术规范书，并标注实际系统实现现状。""" MODULES = {'S9': {'folder': 'S9', 'module_title': 'S9 运营指标与智慧看板模块', 'brd_name': 'S9运营指标与智慧看板业务需求描述.docx', 'bbp_name': 'S9运营指标与智慧看板模块蓝图设计方案.docx', 'tc_name': 'S9-测试用例.xlsx', 'triple_name': 'S9-三联对照表.xlsx', 'doc_no_brd': 'S9-BRD-001', 'doc_no_bbp': 'S9-BBP-001', 'quote_scope': '九宫格智慧运营看板及 S9 运营指标看板（报价：九宫格智慧运营看板）', 'tech_spec': ['引用《技术规范书_20260728修订》第 2.6 节「运营绩效指标测量（S9）」、第 2.6.1 节「九宫格智慧运营看板（S9）」。', '核心目标（规范 ' '2.6.1）：建立全流程关键绩效指标（KPI）定义、数据测量、偏差分析及可视化，覆盖客户订单交付、订单协同、供应协同、采购、物料、生产、成品仓储等核心指标，支撑运营决策优化；通过 ' 'BI 工具实现全流程数据可视化，支持管理层决策和业务人员自助分析。', 'KPI 示例口径（规范）：产销协同—OTD ' '交付率=按时交付订单数/总订单数×100%；生产执行—OEE=可用率×表现率×质量率×100%；采购供应—供应商交付率；质量—成品合格率；库存周转—库存周转天数。', 'KPI 计算与分析（规范）：基于数据中台 DWS/指标层数据每日自动计算 KPI；未达标时开展偏差分析（如 OTD＜95% ' '时分析物料短缺导致订单延期等原因）。', '可视化（规范）：管理层大屏展示核心 KPI ' '与异常预警；部门看板覆盖生产部（工单进度/OEE/瓶颈）、采购部（供应商交付/齐套/逾期）、质量部（不合格率/不良率）等。', '自助分析（规范）：支持按时间、按产品等自主查询；支持数据下钻（如从成品合格率下钻至工序不合格明细）。', '本模块交付仅覆盖 FUNC-S9-004 / FUNC-S9-005；系统对接与 SSO 见「系统集成」文档；ChatBI 另册。'], 'features': [{'req': 'REQ-S9-005', 'func': 'FUNC-S9-005', 'ac': 'AC-S9-005', 'name': '九宫格智慧运营看板', 'path': 'Ai-DOP → 智慧运营看板 → 九宫格', 'route': '/aidop/smart-ops/grid；/dashboard/home', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.6.1「可视化看板设计—管理层大屏」及九宫格智慧运营看板总要求', 'func_desc': ['九宫格智慧运营看板对应技术规范「管理层大屏/九宫格」要求：一屏展示全流程核心 KPI ' '与异常预警，覆盖订单交付、协同、供应、采购、物料、生产、成品仓储等模块格子。', '建立 KPI 可视化入口：卡片展示当前值、目标值、偏差及红黄绿状态；未达标格子突出预警（如订单延期类异常提示）。', '指标定义来源于运营指标主数据，测量结果来源于数据中台指标层（日批计算），保证与部门看板、详情看板口径一致。', '支持基础筛选刷新；点击格子进入对应模块部门/详情看板或下钻至智慧诊断，支撑运营决策优化。'], 'biz_desc': ['管理层登录后进入九宫格首页，查看 OTD、质量合格率等核心 KPI 及异常预警摘要。', '按组织/日期筛选后，各模块 L1 指标同步刷新；未达标项以红/黄状态标识。', '需要深入分析时，点击对应模块格子进入部门看板或 S9/模块详情看板；对异常指标可进入运营诊断。', '无数据时显示空态，不阻断页面访问；外部数据未就绪时按条件验收。'], 'goal': '落实规范 2.6.1：为管理层提供全流程 KPI 一屏总览与异常预警入口。', 'flow_steps': [('10', '进入大屏', '管理层', '打开九宫格', '权限/租户', '九宫格页面'), ('20', '查看KPI', '管理层', '浏览核心KPI与预警', '日批KPI', '态势判断'), ('30', '筛选', '运营专员', '调整日期/组织', '筛选条件', '刷新卡片'), ('40', '下钻', '运营专员', '点击模块格子', '模块路由', '部门/详情看板或诊断')], 'rules': ['KPI 口径以运营指标主数据及规范示例公式为准，页面不得硬编码冲突口径。', '日批 KPI 按规范在数据中台侧自动计算；看板只读展示。', '未达标须可进入偏差分析/诊断链路。', '租户与权限隔离；无权限模块不展示明细。'], 'roles': '管理层（大屏只读）；运营专员（筛选下钻）；指标配置在 S0 运营建模。', 'interfaces': '读取 KPI 日结果与布局配置；不直接写外部系统。', 'reports': '管理层大屏即时视图；可联动异常预警摘要。', 'tcs': [('9.1-1', 'TC-S9-050', '正常', '九宫格核心KPI与预警展示', '1. 打开九宫格\n2. 核对核心KPI卡片（含OTD等）\n3. 观察未达标预警表现', '展示多模块L1 KPI；含当前/目标/偏差/红黄绿；未达标有预警或醒目状态'), ('9.1-2', 'TC-S9-051', '正常', '筛选刷新与口径一致', '1. 修改日期/组织筛选\n2. 刷新后对比同口径详情看板', '卡片刷新；与详情看板同一指标编码口径一致'), ('9.1-3', 'TC-S9-052', '正常', '点击格子进入部门/详情看板', '1. 点击生产/采购/质量等相关格子\n2. 确认进入对应看板', '路由正确进入模块详情或部门看板页'), ('9.1-E1', 'TC-S9-052E1', '异常', '无KPI数据空态', '1. 选择无数据时间段打开九宫格', '空态占位，页面不报错')], 'impl_status': '部分完成（主体可用）', 'impl_notes': ['已实现：九宫格首页、L1 KPI ' '卡片、红黄绿、基础筛选、点击进入模块详情看板（DynamicModuleDashboard）。', '证据：Web/src/views/dashboard/home.vue；GET ' '/api/AidopKanban/home-grid/{moduleCode}。', '缺口：S8 ' '顶栏报警/状态灯仍为演示硬编码；规范「部门看板」无独立主题页，下钻为模块看板而非生产/采购/质量部门专页。']}, {'req': 'REQ-S9-004', 'func': 'FUNC-S9-004', 'ac': 'AC-S9-004', 'name': 'S9运营指标看板', 'path': 'Ai-DOP → 智慧运营看板 → S9运营指标看板', 'route': '/aidop/smart-ops/s9；/aidop/kanban/s9', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.6.1「KPI计算与分析」「部门看板」「自助分析支持」', 'func_desc': ['S9 运营指标看板落实规范中的 KPI 计算展示、偏差分析、部门看板与自助下钻要求，以动态看板呈现跨模块/本模块汇总指标。', 'KPI 计算：消费数据中台指标层每日自动计算结果；展示 ' 'OTD、OEE、供应商交付率、成品合格率、库存周转天数等规范所列及配置扩展指标。', '偏差分析：当 KPI 未达标时，提供偏差说明与原因线索入口（可联动智慧诊断输出如“物料短缺导致订单延期”类结论）。', '部门看板视角：支持按生产、采购、质量等主题查看工单进度/OEE/瓶颈、供应商交付与齐套、不合格与不良率等。', '自助分析：支持按时间、产品等条件查询；支持从汇总指标下钻至明细（如下钻至不合格明细/单据）。'], 'biz_desc': ['运营或部门人员打开 S9 运营指标看板，查看 L1/L2 指标、趋势与达标状态。', '对未达标 KPI 查看偏差信息，必要时进入诊断分析原因。', '按时间、产品等条件筛选，观察质量波动或交付波动。', '从汇总指标下钻至工序/单据级明细，完成自助分析。', '生产/采购/质量相关主题区展示规范要求的部门关注指标。'], 'goal': '落实规范 2.6.1：完成 KPI 测量展示、偏差分析、部门看板与自助下钻。', 'flow_steps': [('10', '打开看板', '运营/部门人员', '进入S9看板', '权限', '指标页'), ('20', '查看KPI', '运营人员', '浏览L1/L2/趋势', '日批KPI', '达标判断'), ('30', '偏差分析', '运营人员', '点击未达标指标', '阈值/明细', '原因线索或诊断'), ('40', '自助下钻', '业务人员', '按时间/产品筛选并下钻', '筛选条件', '明细数据')], 'rules': ['自动计算在中台日批完成；看板展示不得与主数据口径冲突。', '偏差分析须可追溯到指标编码与筛选上下文。', '下钻受数据权限约束；空结果须友好提示。'], 'roles': '管理层、部门业务人员、运营专员；配置类在运营指标建模。', 'interfaces': '看板 API、下钻 API、诊断入口；KPI 来源 DWS/指标层。', 'reports': '部门看板视图、趋势与下钻明细；可扩展导出。', 'tcs': [('9.2-1', 'TC-S9-040', '正常', 'KPI展示含规范示例指标', '1. 打开S9运营指标看板\n2. 核对已配置的OTD/OEE/交付率/合格率/周转等指标可见性', '页面可访问；已发布指标可展示当前值/目标/状态（无数据则空态）'), ('9.2-2', 'TC-S9-041', '正常', '未达标偏差分析入口', '1. 选择存在未达标KPI的期间\n2. 点击未达标项查看偏差/诊断入口', '可查看偏差信息或进入诊断，原因线索可追溯'), ('9.2-3', 'TC-S9-042', '正常', '按时间产品筛选与下钻', '1. 按时间/产品筛选\n2. 从汇总指标下钻明细', '筛选生效；下钻到明细或空态提示'), ('9.2-4', 'TC-S9-043', '正常', '部门关注指标主题', '1. 查看生产/采购/质量相关指标区或模块入口\n2. 核对主题指标可访问', '可进入或展示部门关注类指标（进度/OEE/交付/不合格等）'), ('9.2-E1', 'TC-S9-043E1', '异常', '筛选无匹配', '1. 输入无匹配条件查询', '空结果提示，可重置')], 'impl_status': '部分完成（主体可用）', 'impl_notes': ['已实现：S9 动态看板、L1/L2（及更深）卡片级联、趋势图、时间/产品等筛选、偏差标签与诊断跳转。', '证据：Web/src/views/aidop/kanban/s9.vue → ' 'DynamicModuleDashboard；dashboard-page API。', '缺口：无独立「偏差分析」原因库模块；无规范所述生产/采购/质量「部门看板」独立视图（仅有指标部门字段）。']}]}, '运营诊断': {'folder': '运营诊断', 'module_title': '运营诊断模块', 'brd_name': '运营诊断业务需求描述.docx', 'bbp_name': '运营诊断模块蓝图设计方案.docx', 'tc_name': '运营诊断-测试用例.xlsx', 'triple_name': '运营诊断-三联对照表.xlsx', 'doc_no_brd': 'OD-BRD-001', 'doc_no_bbp': 'OD-BBP-001', 'quote_scope': '运营问题诊断（九宫格下钻、诊断报表）', 'tech_spec': ['引用《技术规范书_20260728修订》第 2.6.2 节「运营问题诊断」。', '基于统一数据抽取能力，打通产销、运作、供应、采购执行、物料仓储内物流、生产执行、成品仓储外物流全环节数据，构建订单至成品出库端到端数据链路，开展智能化诊断。', '以销售订单为主线串联需求预测、采购计划、来料入库、车间生产、半成品流转、成品入库、发货配送等节点，自动识别断点、滞后、损耗、供需失衡、库存积压、交付延期、产能浪费、物流低效等异常。', '多维度关联完成根因溯源，输出运营诊断报告；针对痛点输出可落地改善策略建议，并生成改善任务追踪闭环（改善详见运营改善文档，FUNC 并入 ' 'S9-006）。', '数据处理指标：实时类问题识别延迟≤3 分钟；周期类问题每日定时分析；根因分析至少支持订单、物料、供应商、产线、仓库、时间段、人员 7 ' '个维度下钻溯源。'], 'features': [{'req': 'REQ-S9-006', 'func': 'FUNC-S9-006', 'ac': 'AC-S9-006', 'name': '智慧诊断', 'path': 'Ai-DOP → 智慧诊断', 'route': '/aidop/smart-diagnosis', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.6.2 全文', 'func_desc': ['智慧诊断落实规范 2.6.2：面向全流程运营开展智能化诊断，承接九宫格/看板未达标指标下钻。', '以订单主线串联各业务节点，识别断点、滞后、损耗、供需失衡、库存积压、交付延期、产能浪费、物流低效等异常。', '依托多维关联输出根因线索与运营诊断报告（页面/报表），并给出改善策略建议入口。', '支持按订单、物料、供应商、产线、仓库、时间段、人员等维度下钻溯源；实时类与周期类问题按规范时效要求识别（实时≤3 ' '分钟目标、周期类日批）。'], 'biz_desc': ['运营人员从九宫格或指标看板进入智慧诊断，系统带入指标与筛选上下文。', '按业务环节查看诊断要点与红黄绿状态，识别交付延期、缺料、停滞等异常。', '点击下钻，按订单/物料/供应商/产线等维度查看证据明细。', '在目标&现状、主要问题区确认诊断结论，导出或查看诊断报告摘要。', '需要整改时转入改善计划（同一 FUNC-S9-006）。'], 'goal': '落实规范 2.6.2：自动识别全链路运营异常并完成根因溯源与诊断报告输出。', 'flow_steps': [('10', '进入诊断', '运营专员', '从看板/菜单进入', '指标上下文', '诊断页'), ('20', '异常识别', '系统/专员', '浏览环节诊断结论', '全链路数据', '异常清单'), ('30', '根因下钻', '运营专员', '按7类维度下钻', '明细证据', '根因线索'), ('40', '输出报告', '运营专员', '确认诊断报告/主要问题', '诊断结果', '报告/建议'), ('50', '转改善', '运营专员', '生成改善任务入口', '诊断结论', '改善闭环')], 'rules': ['诊断须可追溯到订单主线或指标编码。', '至少支持规范所列 7 类根因维度中的已实现维度下钻（未接通数据源可条件验收）。', '实时/周期识别时效以对接数据就绪为前提；第三方延迟不计入本系统缺陷。', '改善任务生成并入 FUNC-S9-006，不另起功能号。'], 'roles': '运营专员执行诊断；管理层只读；责任部门配合举证。', 'interfaces': '统一数据抽取/KPI/明细下钻 API；改善任务接口。', 'reports': '运营诊断报告（结论、根因、建议摘要）。', 'tcs': [('D.1-1', 'TC-S9-060', '正常', '诊断页与环节异常展示', '1. 打开智慧诊断\n2. 查看各环节诊断要点', '可展示环节状态与诊断要点，支持全流程视角'), ('D.1-2', 'TC-S9-061', '正常', '看板下钻进入诊断', '1. 从九宫格/看板未达标项进入诊断\n2. 确认上下文保留', '进入诊断且保留指标/筛选上下文'), ('D.1-3', 'TC-S9-062', '正常', '多维度下钻溯源', '1. 对异常项按订单/物料/供应商等维度下钻\n2. 查看证据', '至少一类维度可下钻到明细；具备条件时覆盖更多维度'), ('D.1-4', 'TC-S9-063', '正常', '诊断报告与改善建议入口', '1. 查看目标现状与主要问题\n2. 确认可转改善', '输出诊断结论摘要；可进入改善建议/计划'), ('D.1-5', 'TC-S9-064', '正常', '异常类型识别覆盖', '1. 在含延期/缺料等样例数据下查看诊断\n2. 核对异常类型可见', '能识别或展示规范所列异常类型中的已实现项（如交付延期、缺料等）'), ('D.1-E1', 'TC-S9-064E1', '异常', '无异常时展示', '1. 选择无异常区间打开诊断', '良好态或空问题列表，不报错')], 'impl_status': '部分完成（主体可用）', 'impl_notes': ['已实现：智慧诊断页、环节诊断矩阵、L3/L4 下钻、目标&现状/主要问题、转改善入口。', '证据：Web/src/views/aidop/diagnosis/index.vue；GET ' '/api/AidopKanban/smart-diagnosis/{moduleCode}。', '缺口：正式「运营诊断报告」落库/导出实体与 API 未实现（页面结论≠规范报告产物）；7 ' '维溯源依赖主数据与明细接通程度，未全量保证。', '时效：实时≤3 分钟依赖源数据刷新，需条件验收。']}]}, '运营改善': {'folder': '运营改善', 'module_title': '运营改善模块', 'brd_name': '运营改善业务需求描述.docx', 'bbp_name': '运营改善模块蓝图设计方案.docx', 'tc_name': '运营改善-测试用例.xlsx', 'triple_name': '运营改善-三联对照表.xlsx', 'doc_no_brd': 'OI-BRD-001', 'doc_no_bbp': 'OI-BBP-001', 'quote_scope': '运营问题改善闭环（改善建议、效果验证；FUNC 并入 S9-006）', 'tech_spec': ['引用《技术规范书_20260728修订》第 2.6.3 节「运营问题改善闭环」。', '承接诊断输出的全流程运营异常，搭建问题建档、整改派单、过程跟踪、效果量化复盘、优化经验固化一体化闭环。', '生成改善任务并追踪闭环；自动对比改善前后各环节经营指标，评估优化成效，沉淀标准化管控规则。', '与 2.6.2 衔接：诊断输出改善策略建议并生成改善任务；功能编号并入 FUNC-S9-006。'], 'features': [{'req': 'REQ-S9-007', 'func': 'FUNC-S9-006', 'ac': 'AC-S9-006', 'name': '改善计划与效果验证', 'path': 'Ai-DOP → 智慧诊断（改善闭环）', 'route': '/aidop/smart-diagnosis（改善计划/有效性验证）', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.6.3 全文（衔接 2.6.2 改善任务）', 'func_desc': ['运营改善落实规范 2.6.3：在诊断页闭环完成问题建档、整改派单、过程跟踪、效果量化复盘。', '基于诊断主要问题生成改善计划/任务（根因、行动项、责任人、计划完成日），保存后可走审批派单与待办。', '执行过程可跟踪行动项状态；到期或阶段节点进行有效性验证。', '自动或半自动对比改善前后相关经营指标，评估成效并关闭或继续跟踪，支撑经验固化。'], 'biz_desc': ['运营人员在诊断确认问题后建立改善计划（问题建档）。', '指定责任人与行动项并提交，形成整改派单（审批中心待办）。', '责任人更新执行进度，运营人员过程跟踪。', '在有效性验证中对比基线与当前 KPI，量化复盘后闭环或继续改善。'], 'goal': '落实规范 2.6.3：诊断异常可派单、可跟踪、可量化复盘并闭环。', 'flow_steps': [('10', '问题建档', '运营专员', '由诊断生成改善计划', '诊断结论', '改善单'), ('20', '整改派单', '运营专员/审批人', '提交审批并指派责任人', '计划表单', '待办任务'), ('30', '过程跟踪', '责任人', '更新行动项状态', '执行记录', '进度可视'), ('40', '效果复盘', '运营专员', '对比改善前后指标并关闭', '基线/当前KPI', '闭环结论')], 'rules': ['改善单必须关联诊断问题或指标，保证端到端追溯。', '派单复用平台审批流，不另建孤立任务系统。', '效果验证须保留基线值、目标值、验证结论。', 'FUNC 固定为 FUNC-S9-006。'], 'roles': '运营专员建档与复盘；责任人执行；审批人派单审批；管理层只读。', 'interfaces': '改善计划 API、审批流、KPI 对比查询。', 'reports': '改善任务清单、成效对比、闭环统计。', 'tcs': [('I.1-1', 'TC-S9-070', '正常', '问题建档生成改善计划', '1. 由诊断主要问题生成改善计划\n2. 填写行动项/责任人/完成日并保存', '生成改善记录并关联诊断上下文'), ('I.1-2', 'TC-S9-071', '正常', '整改派单与审批', '1. 提交改善计划审批\n2. 审批人处理待办', '产生待办；状态正确回写'), ('I.1-3', 'TC-S9-072', '正常', '过程跟踪', '1. 更新行动项状态\n2. 查看进度', '进度可跟踪，状态可见'), ('I.1-4', 'TC-S9-073', '正常', '效果量化复盘闭环', '1. 打开有效性验证\n2. 对比改善前后指标\n3. 确认闭环', '记录对比结论；可关闭或继续跟踪'), ('I.1-E1', 'TC-S9-073E1', '异常', '必填缺失', '1. 缺责任人或完成日保存', '校验失败，不生成无效单'), ('I.1-E2', 'TC-S9-073E2', '异常', '无诊断上下文', '1. 无问题上下文保存改善单', '提示需关联诊断/指标')], 'impl_status': '部分完成（主体可用）', 'impl_notes': ['已实现：由诊断生成改善计划、审批流提交、行动项状态更新、有效性验证仪表与提交验证。', '证据：AdoSmartOpsImprovementPlan ' 'API；SmartOpsImprovementBizHandler；诊断页闭环区。', '缺口：「派单」主要为状态流转，无独立工单/OA 派单通道；经验固化/标准规则沉淀能力较弱。']}]}, '系统集成': {'folder': '系统集成', 'module_title': '系统集成模块', 'brd_name': '系统集成业务需求描述.docx', 'bbp_name': '系统集成模块蓝图设计方案.docx', 'tc_name': '系统集成-测试用例.xlsx', 'triple_name': '系统集成-三联对照表.xlsx', 'doc_no_brd': 'INT-BRD-001', 'doc_no_bbp': 'INT-BBP-001', 'quote_scope': '系统集成（架构适用、各模块集成、各接口集成）+ 规范 2.6 所述 SSO', 'tech_spec': ['引用《技术规范书_20260728修订》第 2.7 节「系统集成模块」、2.7.1「对接适配指标」、2.7.2「数据传输性能指标」；并引用 2.6 ' '中系统对接与 SSO（OAuth2.0）要求。', '支持 ERP、MES、CRM、WMS、SRM、TMS 等多类系统多模式对接采集，完成异构数据清洗与标准化融合，搭建订单至出库统一数据底座。', '具备集成通道可视化配置、数据同步监控、异常告警、传输安全管控；向上支撑诊断与分析模块。', '接入方式：数据库直连、HTTP API；支持定时与实时同步；可视化配置新增一套第三方系统目标≤4 小时（实施效率指标）。', '传输：实时推送时延≤30 秒（对接方正常前提下）；夜间批量 1000 万条传输+清洗≤120 ' '分钟；断点续传；自动字段标准化/空值过滤/异常值标记/编码统一。', 'SSO：工业互联网平台一次登录访问 Ai-DOP（OAuth2.0）。数据中台页面（FUNC-S9-010～015）另册，本模块菜单入口为 ' 'FUNC-S9-001/002/003。'], 'features': [{'req': 'REQ-S9-001', 'func': 'FUNC-S9-001', 'ac': 'AC-S9-001', 'name': 'ERP同步', 'path': 'Ai-DOP → 集成入口 → ERP同步', 'route': '/aidop/s9/001', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.7 / 2.7.1（接入方式、定时/实时、可视化配置）', 'func_desc': ['ERP 同步入口落实规范 2.7：多系统多模式对接采集的配置与触发能力（数据库直连 / HTTP API）。', '支持定时同步与实时同步策略；与数据中台数据源、同步任务配置联动，完成清洗与标准化融合。', '面向 ERP/MES/CRM/WMS/SRM/TMS 等对象接入，为订单至出库链路与 KPI/诊断提供数据底座。', '可视化配置降低新增第三方系统接入成本（规范目标：配置完成≤4 小时，作为实施效率指标）。'], 'biz_desc': ['实施人员在同步入口或数据中台配置数据源与映射（直连或 API）。', '配置定时/实时任务并启用，执行首次同步验证。', '业务数据进入贴源/标准层后，业务页与看板可消费。', '无真实外部系统时，以契约/Mock 条件验收。'], 'goal': '落实规范 2.7.1：提供可配置的多系统入站同步能力。', 'flow_steps': [('10', '配置接入', '实施工程师', '登记源与映射', '连接/API', '数据源就绪'), ('20', '配置同步', '实施工程师', '定时或实时任务', '实体映射', '任务启用'), ('30', '执行', '系统/运维', '拉取并清洗', '源数据', '标准层数据'), ('40', '消费', '业务用户', '业务与看板使用', 'STD/DWD/KPI', '业务可见')], 'rules': ['接入方式限于规范所述直连与 HTTP API（及项目已实现的等价方式）。', '凭据安全管控，前端不明文展示密钥。', '清洗含字段标准化、空值过滤、异常标记、编码统一。', '外部系统不可用导致的延迟不计入本系统性能不达标。'], 'roles': '实施工程师、系统管理员；业务用户消费结果。', 'interfaces': 'MDP DB/API Pull 执行器；各模块源对象见双模式对接方案。', 'reports': '同步结果见日志查询。', 'tcs': [('INT.1-1', 'TC-S9-001', '正常', '同步入口与可视化配置可达', '1. 打开ERP同步入口\n2. 进入或跳转数据源/同步任务配置', '入口可访问；可进行可视化配置或查看任务'), ('INT.1-2', 'TC-S9-002', '正常', '直连或API任务执行', '1. 配置或选择已有任务\n2. 具备条件时执行同步', '支持直连或API类任务；执行结果可查（无环境条件通过）'), ('INT.1-3', 'TC-S9-003', '正常', '定时或实时策略可见', '1. 查看任务调度配置', '可区分定时/实时（或等价调度）策略'), ('INT.1-E1', 'TC-S9-003E1', '异常', '源不可达', '1. 错误连接执行同步', '失败可感知并记日志')], 'impl_status': '仅占位（未完成）', 'impl_notes': ['菜单 /aidop/s9/001 指向规划占位页 ' 'AidopDemoShell（planning/index），非真实 ERP 同步业务页。', '真实入站同步/可视化配置在数据中台 FUNC-S9-010～013（另册），未挂接到本入口。', '结论：规范 2.7 能力部分存在于数据中台，本 FUNC 菜单级未完成。']}, {'req': 'REQ-S9-002', 'func': 'FUNC-S9-002', 'ac': 'AC-S9-002', 'name': '日志查询', 'path': 'Ai-DOP → 集成入口 → 日志查询', 'route': '/aidop/s9/002', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.7「数据同步监控、异常告警」', 'func_desc': ['日志查询落实规范中的数据同步监控与异常告警追溯：同步批次、接口调用、清洗转换结果可查。', '支持按时间、任务、状态筛选，查看失败原因，支撑运维排障与验收举证。'], 'biz_desc': ['运维打开日志查询，按时间与状态筛选。', '查看失败记录的错误信息并处理。', '空结果提示暂无数据。'], 'goal': '落实规范 2.7：集成运行可监控、异常可告警可追溯。', 'flow_steps': [('10', '打开日志', '运维', '进入日志查询', '权限', '日志列表'), ('20', '筛选监控', '运维', '按时间/状态筛选', '条件', '过滤结果'), ('30', '异常处理', '运维', '查看失败并处置', '错误详情', '重试或转人工')], 'rules': ['租户隔离；敏感凭据不落前端明文。', '告警与失败日志须可关联到任务与批次。'], 'roles': '运维、系统管理员。', 'interfaces': '同步日志、动作运行日志表/API。', 'reports': '同步监控列表。', 'tcs': [('INT.2-1', 'TC-S9-010', '正常', '同步日志监控查询', '1. 打开日志查询\n2. 按时间筛选', '列出同步/任务日志，含时间与状态'), ('INT.2-2', 'TC-S9-011', '正常', '异常日志详情', '1. 打开失败记录', '可见失败原因摘要'), ('INT.2-E1', 'TC-S9-011E1', '异常', '无日志空态', '1. 无数据时间段查询', '空态提示')], 'impl_status': '仅占位（未完成）', 'impl_notes': ['/aidop/s9/002 为占位页；同步/动作日志真实页为数据中台 FUNC-S9-014/015。', '结论：集成监控能力分散在数据中台，本入口未完成。']}, {'req': 'REQ-S9-003', 'func': 'FUNC-S9-003', 'ac': 'AC-S9-003', 'name': 'ERP事务', 'path': 'Ai-DOP → 集成入口 → ERP事务', 'route': '/aidop/s9/003', 'scope': '纳入技术规范验收', 'tech_clause': '技术规范 2.7 / 2.7.2（双向流转、传输容错、实时/批量时延目标）', 'func_desc': ['ERP 事务落实出站集成与业务联动：监控回写 ERP/MES 等外部系统的事务状态，支撑规范「业务数据双向流转」。', '覆盖待发送/成功/失败/重试；支持断点续传与失败重试策略（传输容错）。', '性能目标（对接方正常为前提）：实时推送时延≤30 ' '秒；大批量夜间任务按规范批量指标评估；超时由第三方导致的不计入本系统不达标。'], 'biz_desc': ['业务操作触发回写后，运维在事务页核对待发送/成功/失败。', '对失败事务查看错误并按策略重试。', '无真实外部系统时以 Outbox+Mock 条件验收。'], 'goal': '落实规范 2.7.2：出站传输可控、可容错、状态可查。', 'flow_steps': [('10', '业务触发', '业务用户', '完成需回写操作', '业务单据', 'Outbox'), ('20', '推送', '系统', 'API推送', 'Outbox', '外部回执'), ('30', '监控', '运维', '查事务状态', '事务列表', '成功/失败'), ('40', '容错', '运维', '重试/续传', '失败事务', '状态更新')], 'rules': ['回写统一走 Outbox，禁止无日志直连外写。', '断点续传/重试避免重复入库或丢失（入站侧同等要求）。', '第三方超时不计入本系统性能缺陷。'], 'roles': '运维处理失败；业务触发；管理员配置端点。', 'interfaces': 'mdp_outbox、API Push 执行器。', 'reports': '事务成功率与失败清单。', 'tcs': [('INT.3-1', 'TC-S9-020', '正常', '事务列表可查', '1. 打开ERP事务入口\n2. 查看列表或等价Outbox监控', '可查看出站事务状态'), ('INT.3-2', 'TC-S9-021', '正常', '回写成功路径', '1. 具备条件触发回写\n2. 核对成功状态', '成功状态可查（无环境条件通过）'), ('INT.3-E1', 'TC-S9-021E1', '异常', '失败可重试追溯', '1. 模拟目标不可达\n2. 查看失败并尝试重试策略', '失败可查；具备重试或人工处理入口')], 'impl_status': '仅占位（未完成）', 'impl_notes': ['/aidop/s9/003 为占位页；Outbox/回写执行器在中台链路，本入口无事务列表业务页。', '结论：出站事务可视菜单未完成。']}, {'req': 'REQ-S9-008', 'func': 'FUNC-S9-001', 'ac': 'TV-INT-004', 'name': '单点登录SSO', 'path': '工业互联网平台 → Ai-DOP（OAuth2.0）', 'route': 'OAuth2.0 登录回调（平台级）', 'scope': '纳入技术规范验收（条件：身份源具备）', 'tech_clause': '技术规范 2.6「支持单点登录（SSO），OAuth2.0」', 'func_desc': ['落实规范：针对工业互联网平台，员工一次登录即可访问 Ai-DOP（OAuth2.0）。', '完成授权码/令牌校验、用户映射与会话建立；身份源不可用时按条件验收。'], 'biz_desc': ['用户从工业互联网平台入口进入 Ai-DOP。', '经 OAuth2.0 授权后免二次账号密码登录（或按平台约定静默登录）。', '权限按 Ai-DOP 租户角色生效。'], 'goal': '落实规范 SSO 要求，减少重复登录。', 'flow_steps': [('10', '平台登录', '员工', '登录工业互联网平台', '账号', '已认证会话'), ('20', '跳转DOP', '员工', '打开Ai-DOP', 'OAuth请求', '授权'), ('30', '建会话', '系统', '映射用户并建会话', '令牌', '进入系统')], 'rules': ['仅信任配置的身份源；令牌校验失败拒绝进入。', '用户须能映射到有效租户账号，否则提示开通。'], 'roles': '全体员工（已开通）；管理员配置 OAuth 客户端。', 'interfaces': 'OAuth2.0 授权服务器；Ai-DOP 认证中间件。', 'reports': '登录审计日志（平台安全要求）。', 'tcs': [('INT.4-1', 'TC-S9-030', '正常', 'OAuth2.0单点登录', '1. 从工业互联网平台入口进入Ai-DOP\n2. 完成授权', '身份源具备时可进入系统并建立会话（条件验收）'), ('INT.4-E1', 'TC-S9-030E1', '异常', '未映射用户拒绝', '1. 使用未开通映射的账号尝试SSO', '拒绝进入并提示联系管理员')], 'impl_status': '未实现', 'impl_notes': ['企业工业互联网平台 OAuth2.0 SSO 未落地；现有仅为微信/Gitee 社交登录脚手架（ClientId ' '占位），登录页 SSO 入口未启用。', '验收 TV-INT-004 仍为条件/待验。']}]}, 'ChatBI': {'folder': 'ChatBI', 'module_title': 'ChatBI智能报表模块', 'brd_name': 'ChatBI智能报表业务需求描述.docx', 'bbp_name': 'ChatBI智能报表模块蓝图设计方案.docx', 'tc_name': 'ChatBI-测试用例.xlsx', 'triple_name': 'ChatBI-三联对照表.xlsx', 'doc_no_brd': 'CBI-BRD-001', 'doc_no_bbp': 'CBI-BBP-001', 'quote_scope': 'ChatBI智能报表：自然语言模型配置、ChatBI报表呈现（报价）；规范 2.6.4', 'tech_spec': ['引用《技术规范书_20260728修订》第 2.6.4 节「ChatBI智能报表」。', '规范目标：以自然语言描述自动生成多维可视化报表；流程为：自然语言提问 → 理解意图 → 匹配业务规则 → 生成 SQL → 查询数据 → ' '生成解释 → 返回答案。', '报价要求：前端智能问答页/报表结果展示/查询历史；后端 NL 问数解析、语义匹配、权限、结果解释与追问、查询留痕。', '性能：AI/ChatBI 可按异步/离线任务验收，不按页面秒级响应强制。', '实际系统当前为嵌入九宫格与模块看板的 KPI 聚合问答 MVP（DeepSeek 润色，非 NL2SQL）；文档区分「已实现 ' 'MVP」与「规范目标态」。'], 'features': [{'req': 'REQ-S9-009', 'func': 'FUNC-S9-007', 'ac': 'TV-CBI-001', 'name': 'ChatBI智能问答', 'path': '九宫格/模块看板内 ChatBI 浮窗（暂无独立菜单；规划 /aidop/chatbi）', 'route': '组件 ChatBIFloat；API POST /api/AidopChatBI/ask', 'scope': '纳入技术规范验收（MVP 已具备；NL2SQL/历史按目标态条件验收）', 'tech_clause': '技术规范 2.6.4；报价 ChatBI智能报表', 'impl_status': '部分完成（MVP 可用）', 'impl_notes': ['已实现：ChatBIFloat/Panel 浮窗问答；意图分类；读 KPI ' '日表聚合；确定性结论段落；DeepSeek 润色；建议问题；跳转看板/诊断。', '证据：Web/src/views/aidop/chatbi/*；Plugins/.../ChatBI/ChatBIController.cs。', '缺口（相对规范/报价）：无 ' 'NL2SQL、无可视化报表自动生成、无持久查询历史、无语义/模型配置页、无独立菜单路由、Controller ' '当前 AllowAnonymous。', '验收建议：MVP 按「自然语言问 KPI + ' '解释」典型场景验收；NL2SQL/历史/配置列为后续或条件项并在三联表备注。'], 'func_desc': ['ChatBI 为运营人员提供自然语言问数入口，降低看报表门槛。', '目标态（规范）：理解意图后生成 SQL 查询并解释，输出多维可视化报表。', '当前态（系统）：基于当前页/模块 KPI 聚合回答，DeepSeek 仅润色文案，不生成 SQL、不接触明细。', '可从回答跳转智慧运营看板或智慧诊断，形成「问答→看数→诊断」链路。'], 'biz_desc': ['用户在九宫格或模块看板打开 ChatBI 浮窗，输入自然语言问题或点选建议问题。', '系统返回结论、证据摘要、可能原因与下一步建议，并展示相关 KPI 卡。', '用户可按建议追问（当前会话内存），或跳转看板/诊断继续分析。', '目标态应支持查询历史回看与语义模型配置（尚未上线）。'], 'goal': '落实规范 2.6.4：以自然语言获取运营指标解释；MVP 先通问答，再演进 NL2SQL/报表。', 'flow_steps': [('10', '打开ChatBI', '业务用户', '点击浮窗', '当前模块上下文', '问答面板'), ('20', '提问', '业务用户', '输入问题或建议问法', 'question/filters', '请求'), ('30', '解析作答', '系统', '意图+KPI聚合(+LLM润色)', 'KPI日表', '答案/指标卡'), ('40', '联动', '业务用户', '跳转看板或诊断', 'actions', '详情页')], 'rules': ['MVP 不得伪称已执行 NL2SQL；界面保留 Demo/能力说明。', '目标态生成 SQL 须受权限与租户隔离约束。', 'AI 任务可异步；失败回退本地模板答案。'], 'roles': '管理层/运营专员提问；管理员配置模型（目标态）。', 'interfaces': 'POST /api/AidopChatBI/ask；DeepSeek HTTP；读 ' 'ado_s9_kpi_value_l*_day。', 'reports': '目标态多维可视化报表；当前为文本+指标卡。', 'tcs': [('CBI.1-1', 'TC-S9-080', '正常', '浮窗打开与建议问题', '1. 打开九宫格或模块看板\n2. 打开ChatBI浮窗\n3. 点击建议问题', '面板可打开；建议问题可发送并返回回答'), ('CBI.1-2', 'TC-S9-081', '正常', '自然语言问KPI', '1. 输入与当前模块相关的指标问题\n2. 提交', '返回结论/证据类分段或指标卡；标明来源local/deepseek可接受'), ('CBI.1-3', 'TC-S9-082', '正常', '跳转看板或诊断', '1. 在回答动作中点击跳转', '可进入对应看板或智慧诊断'), ('CBI.1-E1', 'TC-S9-082E1', '异常', '无匹配指标时降级', '1. 输入无关或无数据问题', '返回降级/提示类回答，不导致页面崩溃'), ('CBI.1-E2', 'TC-S9-082E2', '异常', 'LLM不可用回退', '1. 在DeepSeek不可用环境下提问（或模拟失败）', '回退本地模板答案，isFallback或等价提示可接受')]}, {'req': 'REQ-S9-010', 'func': 'FUNC-S9-007', 'ac': 'TV-CBI-002', 'name': 'ChatBI报表与历史（目标态）', 'path': '规划：独立问答页/查询历史（未上线）', 'route': '未实现', 'scope': '系统扩展/后续（规范目标态；当前不纳入已完成）', 'tech_clause': '技术规范 2.6.4「生成SQL→查询→可视化报表」；报价查询历史/模型配置', 'impl_status': '未实现', 'impl_notes': ['无独立问答页、无查询历史 API/表接入、无 NL2SQL、无报表可视化生成、无语义模型配置 UI。', 'DDL 壳表 ado_s9_chatbi_* 未接入运行链路。', '本条用于规范/报价追溯，测试用例标为目标态，不作为当前已完成验收。'], 'func_desc': ['目标态：持久化查询历史、自然语言生成 SQL 与多维可视化报表、语义/模型配置。', '支撑业务人员自助分析与培训下钻场景（与规范 2.6.1 自助分析衔接）。'], 'biz_desc': ['用户在独立页提问并生成图表报表。', '可回看历史提问与结果。', '管理员维护语义词典与模型参数。'], 'goal': '补齐规范 2.6.4 与报价中尚未落地的报表/历史/配置能力。', 'flow_steps': [('10', '配置', '管理员', '维护语义/模型', '词典', '可用配置'), ('20', '提问', '用户', '自然语言', '问题', 'SQL/查询'), ('30', '呈现', '系统', '可视化报表', '结果集', '图表'), ('40', '留痕', '系统', '写入查询历史', '问答日志', '可回看')], 'rules': ['未实现前不得在验收中勾选为已完成。', '实现后须补 FUNC 菜单登记与权限。'], 'roles': '管理员配置；业务用户问数。', 'interfaces': '规划 NL2SQL 引擎、历史表、报表组件。', 'reports': '多维可视化报表。', 'tcs': [('CBI.2-1', 'TC-S9-090', '正常', '目标态-查询历史（未上线）', '1. 打开查询历史（若已上线）', '当前预期：功能未上线，记录为阻塞/后续；上线后应可回看历史问答'), ('CBI.2-2', 'TC-S9-091', '正常', '目标态-NL2SQL报表（未上线）', '1. 用自然语言请求生成报表', '当前预期：未上线；上线后应生成查询并展示可视化')]}]}}