AiDOPWarehouse/doc/_gen_s9_modules_data.py

# -*- coding: utf-8 -*-
"""交付文档内容数据：对齐技术规范书，并标注实际系统实现现状。"""

MODULES = {'S9': {'folder': 'S9',
        'module_title': '九宫格智慧运营看板模块',
        'brd_name': '九宫格智慧运营看板业务需求描述.docx',
        'bbp_name': '九宫格智慧运营看板模块蓝图设计方案.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': ['引用项目合同里的技术规范第 2.6.1 节「九宫格智慧运营看板」。九宫格是总览入口，S9 全场关键指标看板是其中的全场关键指标页，不是九宫格的上级。',
                      '核心目标（规范 '
                      '2.6.1）：建立全流程关键绩效指标（KPI）定义、数据测量、偏差分析及可视化，覆盖客户订单交付、协同、供应、采购、物料、生产、成品仓储等核心指标，支撑运营决策优化。',
                      'KPI 示例口径（规范）：产销协同—OTD '
                      '交付率=按时交付订单数/总订单数×100%；生产执行—OEE=可用率×表现率×质量率×100%；采购供应—供应商交付率；质量—成品合格率；库存周转—库存周转天数。',
                      'KPI 计算与分析（规范）：基于数据对接服务指标层每日自动计算 KPI；未达标时开展偏差分析（如 OTD＜95% '
                      '时分析物料短缺导致订单延期等原因）。',
                      '可视化（规范）：管理层大屏展示核心 KPI '
                      '与异常预警；部门关注指标覆盖生产（工单进度/OEE/瓶颈）、采购（供应商交付/齐套/逾期）、质量（不合格率/不良率）等。',
                      '自助分析（规范）：支持按时间、按产品等自主查询；支持数据下钻（如从成品合格率下钻至工序不合格明细）。',
                      '本模块交付覆盖 FUNC-S9-005（九宫格）与 FUNC-S9-004（S9 全场关键指标看板）；系统对接见「系统集成」；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': '作为九宫格内的全场关键指标页，完成 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': ['引用项目合同里的技术规范第 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：面向全流程运营开展智能化诊断，承接九宫格/看板未达标指标下钻。',
                                      '以订单主线串联各业务节点，识别断点、滞后、损耗、供需失衡、库存积压、交付延期、产能浪费、物流低效等异常。',
                                      '依托多维关联输出根因线索与运营诊断报告（页面/报表），并给出改善策略建议入口。',
                                      '支持按订单、物料、供应商、产线、仓库、时间段、人员等维度下钻溯源。'],
                        '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': ['引用项目合同里的技术规范第 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': '系统集成（架构适用、各模块集成、各接口集成）',
          'intro': '本模块对接的第三方系统涉及 ERP、MES、WMS。后文统称第三方系统。',
                        'tech_spec': ['引用项目合同里的技术规范第 2.7 节「系统集成模块」、2.7.1「对接适配指标」。',
                        '本模块对接的第三方系统涉及 ERP、MES、WMS。后文统称第三方系统。',
                        '支持对第三方系统多模式对接采集，完成异构数据清洗与标准化融合，搭建订单至出库统一数据底座。',
                        '具备集成通道可视化配置、数据同步监控、异常告警、传输安全管控；向上支撑诊断与分析模块。',
                        '接入方式：数据库直连、HTTP API；支持定时与实时同步。',
                        '传输支持断点续传，并自动完成字段标准化、空值过滤、异常值标记与编码统一。',
                        '数据对接服务页面（FUNC-S9-010～016：工作台、数据地图、数据源、同步配置、任务日志、动作日志、出站回写队列）归本模块。'],
          'features': [{'req': 'REQ-S9-001',
                        'func': 'FUNC-S9-001',
                        'ac': 'AC-S9-001',
                        'name': '第三方系统同步',
                        'path': 'Ai-DOP → 数据对接服务 → 数据源管理 / 同步配置中心',
                        'route': '/aidop/data-platform/sources；/aidop/data-platform/sync-tasks',
                        'scope': '纳入技术规范验收',
                        'tech_clause': '技术规范 2.7 / 2.7.1（接入方式、定时/实时、可视化配置）',
                        'func_desc': ['第三方系统同步入口落实规范 2.7：多模式对接采集的配置与触发能力（数据库直连 / HTTP API）。',
                                      '支持定时同步与实时同步策略；与数据对接服务数据源、同步任务配置联动，完成清洗与标准化融合。',
                                      '面向已接入的第三方系统取数，为订单至出库链路与指标、诊断提供数据底座。',
                                      '可视化配置用于新增或调整第三方系统接入。'],
                        'biz_desc': ['实施人员在同步入口或数据对接服务配置数据源与映射（直连或 API）。',
                                     '配置定时/实时任务并启用，执行首次同步验证。',
                                     '业务数据进入贴源/标准层后，业务页与看板可消费。',
                                     '同步完成后，业务页与看板使用标准层数据。'],
                        '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. 打开第三方系统同步入口\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': []},
                       {'req': 'REQ-S9-002',
                        'func': 'FUNC-S9-002',
                        'ac': 'AC-S9-002',
                        'name': '日志查询',
                        'path': 'Ai-DOP → 数据对接服务 → 任务日志 / 动作日志',
                        'route': '/aidop/data-platform/task-logs；/aidop/data-platform/action-logs',
                        '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': []},
                       {'req': 'REQ-S9-003',
                        'func': 'FUNC-S9-003',
                        'ac': 'AC-S9-003',
                        'name': '第三方系统事务',
                        'path': 'Ai-DOP → 数据对接服务 → 出站回写队列',
                        'route': '/aidop/data-platform/outbox',
                        'scope': '纳入技术规范验收',
                        'tech_clause': '技术规范 2.7（双向流转、传输容错）',
                        'func_desc': ['第三方系统事务落实出站集成与业务联动：监控回写第三方系统的事务状态，支撑规范「业务数据双向流转」。',
                                      '覆盖待发送/成功/失败/重试；支持断点续传与失败重试策略（传输容错）。'],
                        'biz_desc': ['业务操作触发回写后，运维在事务页核对待发送/成功/失败。',
                                     '对失败事务查看错误并按策略重试。',
                                     '对失败事务查看原因并按策略重试。'],
                        '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. 打开第三方系统事务入口\n2. 查看列表或等价Outbox监控',
                                 '可查看出站事务状态'),
                                ('INT.3-2',
                                 'TC-S9-021',
                                 '正常',
                                 '回写成功路径',
                                 '1. 具备条件触发回写\n2. 核对成功状态',
                                 '成功状态可查（无环境条件通过）'),
                                ('INT.3-E1',
                                 'TC-S9-021E1',
                                 '异常',
                                 '失败可重试追溯',
                                 '1. 模拟目标不可达\n2. 查看失败并尝试重试策略',
                                 '失败可查；具备重试或人工处理入口')],
                        'impl_status': '已完成',
                        'impl_notes': []},
                       {'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': ['引用项目合同里的技术规范第 2.6.4 节「ChatBI智能报表」。',
                          '系统在九宫格与模块看板中提供自然语言问答：理解意图、匹配已发布运营指标、给出结论与解释。',
                          '问答受当前租户与数据权限约束；智能服务不可用时回退本地模板答案。'],
            'features': [{'req': 'REQ-S9-009',
                          'func': 'FUNC-S9-007',
                          'ac': 'TV-CBI-001',
                          'name': 'ChatBI智能问答',
                          'path': '九宫格 / 模块看板内问答窗口',
                          'route': '九宫格与模块看板',
                          'scope': '纳入技术规范验收',
                          'tech_clause': '技术规范 2.6.4；报价 ChatBI智能报表',
                          'impl_status': '已完成',
                          'impl_notes': [],
                          'func_desc': ['ChatBI 为运营人员提供自然语言问数入口，降低看报表门槛。',
                                        '系统基于当前页或模块的运营指标进行聚合回答，并给出结论与解释。',
                                        '可从回答跳转智慧运营看板或智慧诊断，形成「问答→看数→诊断」链路。'],
                          'biz_desc': ['用户在九宫格或模块看板打开问答窗口，输入自然语言问题或点选建议问题。',
                                       '系统返回结论、证据摘要、可能原因与下一步建议，并展示相关指标。',
                                       '用户可按建议继续提问，或跳转看板、诊断继续分析。'],
                          'goal': '落实规范 2.6.4：以自然语言获取运营指标解释。',
                          'flow_steps': [('10', '打开ChatBI', '业务用户', '点击浮窗', '当前模块上下文', '问答面板'),
                                         ('20',
                                          '提问',
                                          '业务用户',
                                          '输入问题或建议问法',
                                          'question/filters',
                                          '请求'),
                                         ('30',
                                          '解析作答',
                                          '系统',
                                          '意图+KPI聚合(+LLM润色)',
                                          'KPI日表',
                                          '答案/指标卡'),
                                         ('40', '联动', '业务用户', '跳转看板或诊断', 'actions', '详情页')],
                          'rules': ['问答只解释已计算的运营指标，不改写业务单据。',
                                    '提问与结果受当前租户与数据权限约束。',
                                    '问答任务可异步处理；服务不可用时返回本地模板答案。'],
                          'roles': '管理层、运营专员提问。',
                          'interfaces': '问答服务读取指标日结果。',
                          '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. 用自然语言请求生成报表',
                                   '当前预期：未上线；上线后应生成查询并展示可视化')]}]}}