升鲜宝AI助手功能新增/修改、列表菜单与数据来源调用关系分析(六）---升鲜宝生鲜配送供应链管理系统源代码服务

升鲜宝AI助手功能新增/修改、列表菜单与数据来源调用关系分析

基于《升鲜宝AI助手_彻底验收功能清单_含影响数据表_A4竖版打印版.docx》整理

整理时间：2026-01-09 01:19:00

一、分析结论

AI助手菜单已经形成"数据资产 → 语义理解 → 指标计算 → 经营分析 → 预警事件 → 报表生成 → 预测建议 → 推送消息 → 审计追踪"的完整业务框架。当前最重要的不是继续增加页面，而是明确哪些功能需要新增、哪些功能需要改造、每个列表页面从哪里取数、数据产出后供哪些模块调用。

验收时不能以"菜单能打开、页面有静态数据"为通过标准，必须以真实数据链路为标准：页面查询、统计、下拉、详情、导出、AI结论、预警、报表、预测、日志都必须落库并可追溯。

二、必须新增/恢复的关键功能

|----------|----------|--------|----------------------------------|----------------------------------------------------------------|-------------------------|----------------------------------------------------|
| 二级模块 | 新增功能 | 类型 | 为什么要新增/恢复 | 主要数据来源/影响表 | 供哪些模块调用 | 列表与操作要点 |
| 智能工作台 | 消息中心 | 新增 | 统一接收预警、报表、建议、任务、系统通知，解决推送去向不清问题。 | ai_scm_message、ai_scm_push_log、ai_scm_subscription | 今日异常待办、我的订阅推送、所有推送来源模块 | 消息类型/优先级/已读/时间；展示标题、来源、内容、接收人、阅读状态；操作：标记已读、跳转处理、删除 |
| 指标中心 | 指标计算任务 | 新增 | 管理指标定时计算、手工重算、失败重试。 | ai_scm_metric_calc_task、ai_scm_metric_sql、ai_scm_metric_result | 指标快照、经营分析、预警中心 | 任务名称/周期/状态；展示指标、Cron、最近执行、耗时；操作：运行、重试、停止、查看日志 |
| 预警中心 | 推送记录 | 新增 | 记录每次消息推送结果，解决推送是否成功不可追踪问题。 | ai_scm_push_log、ai_scm_message、ai_scm_push_strategy | 消息中心、我的订阅推送、异常调用监控 | 来源/渠道/接收人/状态；展示发送时间、失败原因、已读状态；操作：重试、标记已读、导出 |
| 知识库与语义 | 数据资产管理 | 新增 | 登记真实业务表，定义哪些表允许被AI分析和问数。 | ai_scm_data_asset、sys_data_source | 表字段语义、业务表映射、AI智能问数、指标定义 | 业务域/源系统/状态/敏感级别；展示表名、负责人、字段数；操作：新增、同步字段、发布 |
| 模型配置 | 模型场景路由 | 新增 | 按场景配置主模型、备用模型、提示词和降级。 | ai_model_scene_route、ai_model、ai_prompt_template | 所有AI调用、模型调用日志、异常调用监控 | 场景/主模型/备用模型/状态；操作：新增、测试、启停 |
| 审计与权限 | 操作日志 | 新增 | 记录AI助手配置新增、修改、删除、启停、发布、导出。 | ai_scm_operation_log、ops_audit_log、ops_audit_log_field | 字段级审计、配置变更对比 | 模块/操作人/类型/时间；展示前后值、IP、状态；操作：查看、导出 |
| 审计与权限 | 菜单授权 | 恢复/新增 | 配置AI助手菜单、按钮、敏感页面权限。 | sys_menu、sys_role_menu、sys_user_role、ai_data_permission_policy | 所有前端页面和后端接口 | 角色/菜单/按钮/数据范围；操作：授权、取消、同步 |

三、现有功能需要修改/改造的清单

|----------|-------------|---------- | 二级模块 | 智能工作台 | AI经营驾驶舱 | 智能工作台 | 今日异常待办 | 智能工作台 | AI智能问数 | 智能工作台 | AI经营日报 | 智能工作台 | AI预警概览 | 智能工作台 | 常用问题收藏 | 智能工作台 | 我的订阅推送 | 经营分析 | 采购分析 | 经营分析 | 销售订单分析 | 经营分析 | 库存周转分析 | 经营分析 | 缺货与滞销分析 | 经营分析 | 配送履约分析 | 经营分析 | 财务毛利分析 | 经营分析 | 供应商履约分析 | 经营分析 | 质检溯源分析 | 指标中心 | 指标分类 | 指标中心 | 指标定义 | 指标中心 | 指标口径维护 | 指标中心 | 指标取数SQL | 指标中心 | 指标快照 | 指标中心 | 指标看板配置 | 指标中心 | 指标权限配置 | 预警中心 | 预警规则 | 预警中心 | 预警事件 | 预警中心 | 缺货预警 | 预警中心 | 临期预警 | 预警中心 | 采购价异常 | 预警中心 | 毛利异常 | 预警中心 | 损耗异常 | 预警中心 | 推送策略 | 报表中心 | 报表模板 | 报表中心 | AI日报 | 报表中心 | AI周报 | 报表中心 | AI月报 | 报表中心 | 专项分析报告 | 报表中心 | 报表任务 | 报表中心 | 报表生成记录 | 报表中心 | 报表导出下载 | 预测决策 | 销量预测 | 预测决策 | 补货建议 | 预测决策 | 库存优化 | 预测决策 | 采购建议 | 预测决策 | 调拨建议 | 预测决策 | 供应商评分 | 预测决策 | 经营建议闭环 | 预测决策 | 采纳效果评估 | 知识库与语义 | 知识库管理 | 知识库与语义 | 文档管理 | 知识库与语义 | 分段向量检索 | 知识库与语义 | 业务术语库 | 知识库与语义 | 表字段语义 | 知识库与语义 | 业务表映射 | 知识库与语义 | 问数样例库 | 知识库与语义 | RAG检索测试 | 模型配置 | API密钥配置 | 模型配置 | 大模型配置 | 模型配置 | 模型参数方案 | 模型配置 | 助手角色配置 | 模型配置 | 提示词模板 | 模型配置 | 工具函数配置 | 模型配置 | 调用额度配置 | 模型配置 | 敏感词与脱敏 | 审计与权限 | 模型调用日志 | 审计与权限 | 问数日志 | 审计与权限 | 工具调用日志 | 审计与权限 | 生成SQL审计 | 审计与权限 | 成本与Token统计 | 审计与权限 | 异常调用监控 | 审计与权限 | 多语言菜单维护 ----------|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|---------------------------|------------------------------------------------------|
| 需要修改的功能 | 修改方向 | 功能说明 | 数据从哪里来/影响表 | 输出后供谁调用 | 列表查询与按钮操作 |
| 从Demo/静态页改为数据库驱动功能 | 看经营总览、核心指标、异常摘要、AI建议；由静态卡片改为实时聚合。 | ai_scm_metric_result、ai_scm_warning_event、ai_scm_report_task、ai_scm_forecast_result、ai_scm_message | 经营分析、预警中心、报表中心、预测决策 | 日期/组织/业务域；指标卡、趋势图、异常排行、AI建议；操作：钻取、刷新、导出、订阅 |
| 从Demo/静态页改为数据库驱动功能 | 统一承接预警事件、报表任务失败、模型异常、指标计算失败等待办。 | ai_scm_warning_event、ai_scm_report_task、ai_scm_metric_calc_task、ai_scm_model_call_log、ai_scm_push_log | 预警事件、消息中心、操作日志 | 异常类型/等级/状态/负责人；事件编号、来源、等级、超时、处理人；操作：认领、处理、关闭、转派 |
| 从Demo/静态页改为数据库驱动功能 | 自然语言问数，必须走数据资产、字段语义、白名单、SQL审计和模型日志。 | ai_scm_data_asset、ai_scm_field_semantic、ai_scm_business_mapping、ai_scm_nlq_template、ai_scm_nlq_log、ai_scm_model_call_log、ai_scm_sql_audit_log | 经营分析、报表中心、问数日志、生成SQL审计 | 问题关键字/业务域/时间；展示问题、生成SQL、结果表、AI解释、引用依据；操作：执行、收藏、纠错、导出 |
| 从Demo/静态页改为数据库驱动功能 | 自动生成经营日报摘要，读取指标、预警、报表模板与模型配置。 | ai_scm_report_template、ai_scm_report_task、ai_scm_metric_result、ai_scm_warning_event、ai_prompt_template、ai_scm_model_call_log | 报表生成记录、我的订阅推送、消息中心 | 日期/组织/报表模板；销售、采购、库存、毛利、异常摘要；操作：生成、预览、导出、推送 |
| 从Demo/静态页改为数据库驱动功能 | 展示预警数量、等级、状态、处理时效和趋势。 | ai_scm_warning_rule、ai_scm_warning_event、ai_scm_push_strategy、ai_scm_push_log | 今日异常待办、消息中心、经营建议闭环 | 等级/模块/状态/时间；展示事件统计、趋势、排行、处理状态；操作：查看、处理、导出 |
| 从Demo/静态页改为数据库驱动功能 | 沉淀高频问数模板和个人收藏问题，供AI智能问数一键复用。 | ai_scm_nlq_template、ai_scm_nlq_log、ai_scm_subscription | AI智能问数、问数样例库、问数满意度分析 | 业务域/使用次数/收藏状态；展示问题标题、参数、最近使用；操作：提问、收藏、取消、排序 |
| 从Demo/静态页改为数据库驱动功能 | 展示用户订阅的报表、预警、指标、消息推送。 | ai_scm_subscription、ai_scm_message、ai_scm_push_log、ai_scm_report_task | 消息中心、报表中心、预警中心 | 订阅类型/渠道/频率/状态；展示订阅对象、最近推送、已读；操作：启停、编辑、退订 |
| 从Demo/静态页改为数据库驱动功能 | 读取采购指标和采购业务数据，分析采购金额、单价、供应商、到货等。 | pur_bill、pur_bill_info、sup_supplier、ai_scm_metric_result、ai_scm_metric | 采购价异常、采购建议、供应商评分 | 日期/供应商/品类/状态；展示采购金额、数量、价格波动、供应商排行；操作：钻取、生成建议、导出 |
| 从Demo/静态页改为数据库驱动功能 | 分析销售额、订单数、客单价、客户和渠道变化。 | oms_order_bill、oms_order_bill_info、cus_customer、pms_goods、ai_scm_metric_result | 销量预测、AI经营日报、经营异常根因分析 | 日期/客户/渠道/商品；展示销售额、订单量、同比环比、排行；操作：查看订单、钻取客户、导出 |
| 从Demo/静态页改为数据库驱动功能 | 分析库存金额、库龄、周转、缺货、滞销。 | wms_goods_inventory、wms_goods_inventory_info、hwms_goods_inventory、ai_scm_metric_result | 缺货预警、库存优化、调拨建议 | 仓库/门店/品类/库龄；展示库存金额、周转天数、缺货SKU、滞销SKU；操作：生成优化建议、导出 |
| 从Demo/静态页改为数据库驱动功能 | 识别缺货和滞销商品，输出补货、促销、调拨建议。 | wms_goods_inventory、oms_order_bill_info、pms_goods、ai_scm_warning_event、ai_scm_recommendation | 缺货预警、补货建议、库存优化 | 仓库/门店/品类/状态；展示当前库存、安全库存、滞销天数、建议；操作：补货、促销、调拨 |
| 从Demo/静态页改为数据库驱动功能 | 分析线路、司机、签收、延迟、拒收等履约情况。 | tms_waybill、tms_orderbill_map_circle、oms_order_bill、ai_scm_metric_result | 今日异常待办、经营建议闭环、报表中心 | 日期/线路/司机/状态；展示准时率、签收率、异常线路；操作：查看轨迹、生成建议、导出 |
| 从Demo/静态页改为数据库驱动功能 | 分析毛利、成本、应收应付、费用和客户/商品毛利异常。 | fin_customer_bill、fin_supplier_bill、oms_order_bill、wms_goods_inventory、ai_scm_metric_result | 毛利异常、AI日报、成本与Token之外的经营报表 | 日期/客户/商品/部门；展示收入、成本、毛利率、低毛利商品；操作：钻取、导出、生成异常 |
| 从Demo/静态页改为数据库驱动功能 | 分析供应商到货率、准时率、质量、价格和综合评分。 | sup_supplier、pur_bill、pur_bill_info、quality_check、ai_scm_metric_result | 供应商评分、采购建议、采购分析 | 供应商/品类/周期/等级；展示履约评分、到货率、质量异常；操作：评分、对标、导出 |
| 从Demo/静态页改为数据库驱动功能 | 分析质检批次、溯源码、供应商、商品与异常批次。 | trace_code、trace_code_batch、quality_check、pur_bill_info、oms_order_bill_info | 质检溯源报告、供应商评分、预警中心 | 批次/供应商/商品/结果；展示合格率、异常批次、流向；操作：追溯、生成报告、导出 |
| 从Demo/静态页改为数据库驱动功能 | 维护指标目录，支撑指标定义、权限和看板分组。 | ai_scm_metric_category | 指标定义、指标看板配置、经营分析 | 分类名称/业务域/状态；展示编码、名称、层级、指标数；操作：新增、编辑、启停、排序 |
| 从Demo/静态页改为数据库驱动功能 | 维护指标编码、名称、单位、周期、来源资产、维度。 | ai_scm_metric、ai_scm_metric_category、ai_scm_data_asset | 指标取数SQL、预警规则、报表模板 | 指标名称/分类/业务域/状态；展示编码、口径、来源、预警标记；操作：新增、编辑、发布 |
| 从Demo/静态页改为数据库驱动功能 | 维护指标公式、统计范围、过滤条件、口径版本。 | ai_scm_metric、ai_scm_metric_sql、ai_scm_operation_log | 指标取数SQL、指标口径审批、报表中心 | 指标/版本/状态；展示公式、口径说明、版本、变更人；操作：编辑、对比、提交审批 |
| 从Demo/静态页改为数据库驱动功能 | 维护指标SQL、参数、测试、发布状态。 | ai_scm_metric_sql、ai_scm_data_asset、ai_scm_field_semantic、ai_scm_sql_audit_log | 指标计算任务、指标快照、生成SQL审计 | 指标/数据源/测试状态；展示SQL版本、参数、测试结果；操作：测试SQL、发布、回滚 |
| 从Demo/静态页改为数据库驱动功能 | 展示指标计算结果，作为分析、预警、报表、预测的数据来源。 | ai_scm_metric_result、ai_scm_metric、ai_scm_metric_calc_task | 经营分析、预警规则、报表模板、预测决策 | 指标/日期/维度/状态；展示结果值、同比、环比、计算时间；操作：重算、导出、查看血缘 |
| 从Demo/静态页改为数据库驱动功能 | 配置驾驶舱和看板组件引用哪些指标。 | ai_scm_dashboard、ai_scm_metric、ai_scm_metric_result | AI经营驾驶舱、场景效果看板 | 看板名称/类型/状态；展示布局、组件、指标绑定；操作：新增组件、预览、发布 |
| 从Demo/静态页改为数据库驱动功能 | 配置角色、用户、组织可查看的指标范围。 | ai_scm_metric、sys_role、sys_role_menu、ai_data_permission_policy | 经营分析、智能问数、报表中心 | 角色/指标/数据范围；展示授权对象、指标范围、状态；操作：授权、取消、同步 |
| 从Demo/静态页改为数据库驱动功能 | 配置指标阈值、触发条件、作用范围和等级。 | ai_scm_warning_rule、ai_scm_metric、ai_scm_push_strategy | 预警事件、预警规则模拟测试 | 规则名称/等级/状态；展示指标、条件、范围、推送策略；操作：新增、测试、发布、启停 |
| 从Demo/静态页改为数据库驱动功能 | 展示规则触发的事件并完成处理闭环。 | ai_scm_warning_event、ai_scm_warning_rule、ai_scm_message | 今日异常待办、经营建议闭环、推送记录 | 等级/状态/处理人/时间；展示触发值、阈值、业务对象；操作：认领、处理、关闭、转派 |
| 从Demo/静态页改为数据库驱动功能 | 专题展示缺货类事件和补货建议。 | ai_scm_warning_event、wms_goods_inventory、ai_scm_recommendation | 补货建议、消息中心 | 仓库/商品/等级/状态；展示库存、安全库存、缺口、建议量；操作：生成补货建议、处理 |
| 从Demo/静态页改为数据库驱动功能 | 专题展示临期商品和处置建议。 | ai_scm_warning_event、wms_goods_inventory、pms_goods、ai_scm_push_log | 今日异常待办、消息中心 | 门店/仓库/临期天数/状态；展示商品、到期日、数量、风险等级；操作：促销、调拨、处理 |
| 从Demo/静态页改为数据库驱动功能 | 监控采购价波动异常。 | ai_scm_warning_event、pur_bill_info、ai_scm_metric_result | 采购分析、采购建议、供应商评分 | 供应商/商品/涨幅/状态；展示当前价、历史均价、异常率；操作：复核、关闭、生成建议 |
| 从Demo/静态页改为数据库驱动功能 | 监控毛利率低于阈值或异常波动。 | ai_scm_warning_event、fin_customer_bill、oms_order_bill、ai_scm_metric_result | 财务毛利分析、经营异常根因分析 | 商品/客户/毛利率/状态；展示标准毛利、当前毛利、原因；操作：分析、处理、推送 |
| 从Demo/静态页改为数据库驱动功能 | 监控报损率、损耗金额异常。 | ai_scm_warning_event、wms_loss_overflow、wms_goods_inventory | 库存优化、经营异常根因分析 | 仓库/商品/损耗类型/等级；展示金额、数量、原因；操作：处理、复盘、导出 |
| 从Demo/静态页改为数据库驱动功能 | 配置消息渠道、接收人、频率、静默期。 | ai_scm_push_strategy、ai_scm_subscription | 推送记录、消息中心、预警规则 | 策略/渠道/接收范围/状态；展示触发方式、Cron、静默期；操作：新增、测试、启停 |
| 从Demo/静态页改为数据库驱动功能 | 定义报表结构、章节、指标、图表和AI提示词。 | ai_scm_report_template、ai_scm_metric、ai_prompt_template | 报表任务、AI日报/周报/月报、专项报告 | 模板名称/类型/状态；展示章节、指标、格式；操作：新增、预览、发布、复制 |
| 从Demo/静态页改为数据库驱动功能 | 按日自动生成经营分析报告。 | ai_scm_report_task、ai_scm_report_template、ai_scm_metric_result、ai_scm_warning_event | 报表生成记录、消息中心 | 日期/组织/状态；展示销售、采购、库存、毛利摘要；操作：生成、预览、导出、推送 |
| 从Demo/静态页改为数据库驱动功能 | 按周生成经营趋势与异常复盘。 | ai_scm_report_task、ai_scm_metric_result、ai_scm_warning_event | 报表生成记录、我的订阅推送 | 周期/组织/状态；展示周指标、异常、建议；操作：生成、导出、订阅 |
| 从Demo/静态页改为数据库驱动功能 | 按月生成经营复盘与下月建议。 | ai_scm_report_task、ai_scm_metric_result、ai_scm_forecast_result | 报表生成记录、预测决策 | 月份/组织/状态；展示月度趋势、风险、建议；操作：生成、导出、发布 |
| 从Demo/静态页改为数据库驱动功能 | 针对采购、库存、毛利、供应商等专题生成深度报告。 | ai_scm_report_task、ai_scm_report_template、ai_scm_metric_result、ai_prompt_template | 经营分析、经营建议闭环 | 专题/业务域/状态；展示报告名称、数据范围、生成状态；操作：生成、预览、下载 |
| 从Demo/静态页改为数据库驱动功能 | 管理报表生成任务、失败重试、定时任务。 | ai_scm_report_task、ai_scm_report_template | 报表生成记录、AI运维日报 | 任务名称/类型/状态；展示模板、时间、错误信息；操作：执行、重试、停止 |
| 从Demo/静态页改为数据库驱动功能 | 保存历史生成结果和状态。 | ai_scm_report_task、ai_scm_report_file、ai_scm_operation_log | 报表导出下载、消息中心 | 报表名称/类型/状态；展示生成时间、文件地址、耗时；操作：查看、重试、删除 |
| 从Demo/静态页改为数据库驱动功能 | 下载PDF、Word、Excel等报表文件。 | ai_scm_report_task、ai_scm_report_file、ai_scm_operation_log | 我的订阅推送、报表阅读分析 | 文件类型/日期/状态；展示文件名、大小、下载次数；操作：下载、批量下载、清理 |
| 从Demo/静态页改为数据库驱动功能 | 基于历史销量、季节、促销、库存预测未来销量。 | ai_scm_forecast_result、oms_order_bill_info、ai_scm_metric_result | 补货建议、采购建议、AI日报 | 商品/组织/周期/模型；展示预测值、置信度、趋势；操作：刷新预测、导出、解释 |
| 从Demo/静态页改为数据库驱动功能 | 根据销量预测、库存、安全库存、在途量生成补货建议。 | ai_scm_recommendation、ai_scm_forecast_result、wms_goods_inventory、pur_bill_info | 采购建议、经营建议闭环 | 商品/仓库/优先级/状态；展示建议量、金额、到货日；操作：采纳、生成采购、拒绝 |
| 从Demo/静态页改为数据库驱动功能 | 分析高库存、低周转、库龄，输出调拨/促销/采购优化。 | ai_scm_recommendation、wms_goods_inventory、ai_scm_metric_result | 调拨建议、缺货与滞销分析 | 仓库/品类/库龄/状态；展示周转天数、优化建议、预计资金；操作：采纳、跟踪 |
| 从Demo/静态页改为数据库驱动功能 | 根据销量、库存、供应商履约生成采购建议。 | ai_scm_recommendation、ai_scm_forecast_result、sup_supplier、pur_bill | 采购分析、供应商评分 | 供应商/品类/状态；展示建议采购量、金额、风险；操作：生成采购单、采纳、拒绝 |
| 从Demo/静态页改为数据库驱动功能 | 根据门店/仓库库存差异生成调拨建议。 | ai_scm_recommendation、wms_goods_inventory、tms_waybill | 库存优化、配送履约分析 | 调出/调入组织/商品/状态；展示缺口、可调库存、线路；操作：生成调拨单、采纳 |
| 从Demo/静态页改为数据库驱动功能 | 综合价格、履约、质量、交付、协同效率生成评分。 | ai_scm_recommendation、sup_supplier、pur_bill、quality_check、ai_scm_metric_result | 采购建议、供应商履约分析 | 供应商/分类/评分等级；展示价格、质量、交付分；操作：对标、导出、生成建议 |
| 从Demo/静态页改为数据库驱动功能 | 汇总AI建议并记录认领、采纳、拒绝、关闭。 | ai_scm_recommendation、ai_scm_recommendation_action | 采纳效果评估、消息中心、操作日志 | 建议类型/状态/责任人；展示建议内容、来源、执行动作；操作：采纳、拒绝、关闭、转派 |
| 从Demo/静态页改为数据库驱动功能 | 跟踪建议采纳前后指标变化。 | ai_scm_recommendation_effect、ai_scm_recommendation_action、ai_scm_metric_result | AI助手价值看板、模型效果评测 | 建议类型/评估结果/时间；展示采纳前后指标、改善率、ROI；操作：复盘、导出 |
| 从Demo/静态页改为数据库驱动功能 | 管理知识库、业务域、向量模型和索引状态。 | ai_knowledge、ai_knowledge_document、ai_knowledge_segment | 文档管理、RAG检索测试、AI智能问数 | 知识库/业务域/状态；展示文档数、分段数、索引状态；操作：新增、同步、启停 |
| 从Demo/静态页改为数据库驱动功能 | 上传、解析、分段、向量化、发布文档。 | ai_knowledge_document、ai_knowledge_segment | 分段向量检索、RAG检索测试 | 文档名称/知识库/状态；展示类型、大小、解析状态；操作：上传、解析、向量化、发布 |
| 从Demo/静态页改为数据库驱动功能 | 测试分段、向量相似度、召回、重排效果。 | ai_knowledge_segment、ai_knowledge_document、ai_knowledge | RAG检索测试、知识库质量评分 | 查询文本/知识库/模型；展示片段、相似度、命中类型；操作：检索、导出、标注 |
| 从Demo/静态页改为数据库驱动功能 | 维护业务术语、别名、同义词、解释。 | ai_scm_term_library、ai_scm_field_semantic | AI智能问数、RAG检索、报表解释 | 术语/业务域/状态；展示别名、解释、使用次数；操作：新增、校验、发布 |
| 从Demo/静态页改为数据库驱动功能 | 维护表字段中文名、语义、维度/指标/筛选/敏感标记。 | ai_scm_field_semantic、ai_scm_data_asset | AI智能问数、指标取数SQL、SQL安全规则 | 表名/字段/语义类型/敏感级别；展示中文名、含义、标签；操作：编辑、批量导入、发布 |
| 从Demo/静态页改为数据库驱动功能 | 维护业务对象与底层表字段的关系。 | ai_scm_business_mapping、ai_scm_data_asset、ai_scm_field_semantic | AI智能问数、供应链知识图谱、指标血缘 | 来源对象/目标对象/关系类型；展示映射规则、状态；操作：新增映射、批量导入、发布 |
| 从Demo/静态页改为数据库驱动功能 | 维护自然语言问题样例、推荐问法、期望SQL。 | ai_scm_nlq_template、ai_scm_nlq_log | AI智能问数、问数命中分析、AI测试用例 | 业务域/样例类型/角色/状态；展示问题、推荐SQL、使用次数；操作：新增、测试、发布 |
| 从Demo/静态页改为数据库驱动功能 | 测试RAG召回、引用、生成答案质量。 | ai_knowledge_segment、ai_knowledge_document、ai_scm_model_call_log | 模型效果评测、知识库质量评分 | 问题/知识库/TopK/模型；展示答案、引用片段、质量评分；操作：测试、保存样例、导出 |
| 从Demo/静态页改为数据库驱动功能 | 维护供应商API Key、额度、到期、测试连接。 | ai_api_key、ai_scm_operation_log | 大模型配置、模型供应商健康、模型调用 | 供应商/环境/状态；展示key掩码、额度、到期；操作：新增、测试、轮换、禁用 |
| 从Demo/静态页改为数据库驱动功能 | 维护模型清单、供应商、成本、上下文、默认标记。 | ai_model、ai_api_key | 模型场景路由、模型调用日志 | 模型名/供应商/类型/状态；展示参数、成本、默认标记；操作：新增、测试、启停、设默认 |
| 从Demo/静态页改为数据库驱动功能 | 配置温度、TopP、输出长度、重试和超时参数。 | ai_model_param_scheme、ai_model | 模型场景路由、提示词调试台 | 方案/模型/场景/状态；操作：新增、测试、发布 |
| 从Demo/静态页改为数据库驱动功能 | 配置不同场景助手角色和回答边界。 | ai_assistant_role、ai_prompt_template、ai_tool_function | AI智能问数、AI报表、经营建议 | 角色/场景/模型/工具；操作：新增、复制、启停 |
| 从Demo/静态页改为数据库驱动功能 | 管理系统提示词、用户提示词、输出结构和版本。 | ai_prompt_template | 报表模板、AI智能问数、提示词版本管理 | 模板/场景/语言/状态；操作：新增、测试、发布、回滚 |
| 从Demo/静态页改为数据库驱动功能 | 配置AI可调用的后端工具函数和权限。 | ai_tool_function、ai_scm_tool_call_log | AI工具函数测试台、智能体工作流 | 工具名/模块/权限/状态；操作：新增、测试、启停 |
| 从Demo/静态页改为数据库驱动功能 | 配置用户、角色、模型、场景的调用额度和成本上限。 | ai_quota_policy、ai_scm_model_call_log | 成本与Token统计、模型成本预警 | 策略/模型/范围/额度；操作：新增、启停、重置额度 |
| 从Demo/静态页改为数据库驱动功能 | 配置敏感词、敏感字段、输出脱敏与拦截。 | ai_sensitive_rule、ai_scm_field_semantic | AI智能问数、SQL沙箱执行、报表导出 | 规则/级别/模块/状态；操作：新增、测试、发布 |
| 从Demo/静态页改为数据库驱动功能 | 记录每次模型调用、Token、成本、耗时、错误。 | ai_scm_model_call_log | 成本与Token统计、异常调用监控 | 模型/场景/状态/时间；展示输入摘要、输出摘要、Token；操作：详情、重试、追踪 |
| 从Demo/静态页改为数据库驱动功能 | 记录用户问数、生成SQL、执行状态和结果摘要。 | ai_scm_nlq_log、ai_scm_sql_audit_log | 生成SQL审计、问数命中分析 | 用户/业务域/状态/时间；展示问题、SQL、耗时；操作：查看、收藏、纠错 |
| 从Demo/静态页改为数据库驱动功能 | 记录工具函数调用入参、出参、耗时和异常。 | ai_scm_tool_call_log、ai_tool_function | 异常调用监控、操作日志 | 工具/模块/状态/时间；展示输入输出、traceId；操作：详情、追踪 |
| 从Demo/静态页改为数据库驱动功能 | 审计AI生成SQL是否只读、是否白名单、是否含敏感字段。 | ai_scm_sql_audit_log、ai_scm_data_asset、ai_scm_field_semantic | AI智能问数、SQL沙箱执行 | 风险等级/状态/用户；展示SQL、规则命中、审核意见；操作：通过、拒绝、复制SQL |
| 从Demo/静态页改为数据库驱动功能 | 统计模型、场景、用户、部门成本。 | ai_scm_model_call_log、ai_api_key、ai_model | 模型成本预警、AI成本分摊 | 模型/场景/时间；展示Token、成本、排行；操作：导出、分摊 |
| 从Demo/静态页改为数据库驱动功能 | 监控模型超时、限流、失败、内容安全异常。 | ai_scm_model_call_log、ai_scm_tool_call_log、ai_scm_push_log | AI安全风险看板、AI运维日报 | 异常类型/模型/状态；展示错误码、影响范围；操作：处理、关联日志 |
| 从Demo/静态页改为数据库驱动功能 | 维护菜单、按钮、提示语多语言。 | sys_static_translation、sys_dynamic_translation、sys_menu | 前端所有页面、报表导出 | 语言/资源类型/状态；展示中文、英文、繁体；操作：编辑、发布、导入 |

四、按模块详细说明：数据来源、产出与调用关系

智能工作台

|----------|----------|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|------------------------|------------------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| AI经营驾驶舱 | 修改 | 看经营总览、核心指标、异常摘要、AI建议；由静态卡片改为实时聚合。 | ai_scm_metric_result、ai_scm_warning_event、ai_scm_report_task、ai_scm_forecast_result、ai_scm_message | 经营分析、预警中心、报表中心、预测决策 | 日期/组织/业务域；指标卡、趋势图、异常排行、AI建议；操作：钻取、刷新、导出、订阅 |
| 今日异常待办 | 修改 | 统一承接预警事件、报表任务失败、模型异常、指标计算失败等待办。 | ai_scm_warning_event、ai_scm_report_task、ai_scm_metric_calc_task、ai_scm_model_call_log、ai_scm_push_log | 预警事件、消息中心、操作日志 | 异常类型/等级/状态/负责人；事件编号、来源、等级、超时、处理人；操作：认领、处理、关闭、转派 |
| AI智能问数 | 修改 | 自然语言问数，必须走数据资产、字段语义、白名单、SQL审计和模型日志。 | ai_scm_data_asset、ai_scm_field_semantic、ai_scm_business_mapping、ai_scm_nlq_template、ai_scm_nlq_log、ai_scm_model_call_log、ai_scm_sql_audit_log | 经营分析、报表中心、问数日志、生成SQL审计 | 问题关键字/业务域/时间；展示问题、生成SQL、结果表、AI解释、引用依据；操作：执行、收藏、纠错、导出 |
| AI经营日报 | 修改 | 自动生成经营日报摘要，读取指标、预警、报表模板与模型配置。 | ai_scm_report_template、ai_scm_report_task、ai_scm_metric_result、ai_scm_warning_event、ai_prompt_template、ai_scm_model_call_log | 报表生成记录、我的订阅推送、消息中心 | 日期/组织/报表模板；销售、采购、库存、毛利、异常摘要；操作：生成、预览、导出、推送 |
| AI预警概览 | 修改 | 展示预警数量、等级、状态、处理时效和趋势。 | ai_scm_warning_rule、ai_scm_warning_event、ai_scm_push_strategy、ai_scm_push_log | 今日异常待办、消息中心、经营建议闭环 | 等级/模块/状态/时间；展示事件统计、趋势、排行、处理状态；操作：查看、处理、导出 |
| 常用问题收藏 | 修改 | 沉淀高频问数模板和个人收藏问题，供AI智能问数一键复用。 | ai_scm_nlq_template、ai_scm_nlq_log、ai_scm_subscription | AI智能问数、问数样例库、问数满意度分析 | 业务域/使用次数/收藏状态；展示问题标题、参数、最近使用；操作：提问、收藏、取消、排序 |
| 我的订阅推送 | 修改 | 展示用户订阅的报表、预警、指标、消息推送。 | ai_scm_subscription、ai_scm_message、ai_scm_push_log、ai_scm_report_task | 消息中心、报表中心、预警中心 | 订阅类型/渠道/频率/状态；展示订阅对象、最近推送、已读；操作：启停、编辑、退订 |
| 消息中心 | 新增 | 统一接收预警、报表、建议、任务、系统通知，解决推送去向不清问题。 | ai_scm_message、ai_scm_push_log、ai_scm_subscription | 今日异常待办、我的订阅推送、所有推送来源模块 | 消息类型/优先级/已读/时间；展示标题、来源、内容、接收人、阅读状态；操作：标记已读、跳转处理、删除 |

经营分析

|----------|----------|----------------------------------|----------------------------------------------------------------------------------------------|---------------------------|--------------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 采购分析 | 修改 | 读取采购指标和采购业务数据，分析采购金额、单价、供应商、到货等。 | pur_bill、pur_bill_info、sup_supplier、ai_scm_metric_result、ai_scm_metric | 采购价异常、采购建议、供应商评分 | 日期/供应商/品类/状态；展示采购金额、数量、价格波动、供应商排行；操作：钻取、生成建议、导出 |
| 销售订单分析 | 修改 | 分析销售额、订单数、客单价、客户和渠道变化。 | oms_order_bill、oms_order_bill_info、cus_customer、pms_goods、ai_scm_metric_result | 销量预测、AI经营日报、经营异常根因分析 | 日期/客户/渠道/商品；展示销售额、订单量、同比环比、排行；操作：查看订单、钻取客户、导出 |
| 库存周转分析 | 修改 | 分析库存金额、库龄、周转、缺货、滞销。 | wms_goods_inventory、wms_goods_inventory_info、hwms_goods_inventory、ai_scm_metric_result | 缺货预警、库存优化、调拨建议 | 仓库/门店/品类/库龄；展示库存金额、周转天数、缺货SKU、滞销SKU；操作：生成优化建议、导出 |
| 缺货与滞销分析 | 修改 | 识别缺货和滞销商品，输出补货、促销、调拨建议。 | wms_goods_inventory、oms_order_bill_info、pms_goods、ai_scm_warning_event、ai_scm_recommendation | 缺货预警、补货建议、库存优化 | 仓库/门店/品类/状态；展示当前库存、安全库存、滞销天数、建议；操作：补货、促销、调拨 |
| 配送履约分析 | 修改 | 分析线路、司机、签收、延迟、拒收等履约情况。 | tms_waybill、tms_orderbill_map_circle、oms_order_bill、ai_scm_metric_result | 今日异常待办、经营建议闭环、报表中心 | 日期/线路/司机/状态；展示准时率、签收率、异常线路；操作：查看轨迹、生成建议、导出 |
| 财务毛利分析 | 修改 | 分析毛利、成本、应收应付、费用和客户/商品毛利异常。 | fin_customer_bill、fin_supplier_bill、oms_order_bill、wms_goods_inventory、ai_scm_metric_result | 毛利异常、AI日报、成本与Token之外的经营报表 | 日期/客户/商品/部门；展示收入、成本、毛利率、低毛利商品；操作：钻取、导出、生成异常 |
| 供应商履约分析 | 修改 | 分析供应商到货率、准时率、质量、价格和综合评分。 | sup_supplier、pur_bill、pur_bill_info、quality_check、ai_scm_metric_result | 供应商评分、采购建议、采购分析 | 供应商/品类/周期/等级；展示履约评分、到货率、质量异常；操作：评分、对标、导出 |
| 质检溯源分析 | 修改 | 分析质检批次、溯源码、供应商、商品与异常批次。 | trace_code、trace_code_batch、quality_check、pur_bill_info、oms_order_bill_info | 质检溯源报告、供应商评分、预警中心 | 批次/供应商/商品/结果；展示合格率、异常批次、流向；操作：追溯、生成报告、导出 |

指标中心

|----------|----------|------------------------------|--------------------------------------------------------------------------------|---------------------|-----------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 指标分类 | 修改 | 维护指标目录，支撑指标定义、权限和看板分组。 | ai_scm_metric_category | 指标定义、指标看板配置、经营分析 | 分类名称/业务域/状态；展示编码、名称、层级、指标数；操作：新增、编辑、启停、排序 |
| 指标定义 | 修改 | 维护指标编码、名称、单位、周期、来源资产、维度。 | ai_scm_metric、ai_scm_metric_category、ai_scm_data_asset | 指标取数SQL、预警规则、报表模板 | 指标名称/分类/业务域/状态；展示编码、口径、来源、预警标记；操作：新增、编辑、发布 |
| 指标口径维护 | 修改 | 维护指标公式、统计范围、过滤条件、口径版本。 | ai_scm_metric、ai_scm_metric_sql、ai_scm_operation_log | 指标取数SQL、指标口径审批、报表中心 | 指标/版本/状态；展示公式、口径说明、版本、变更人；操作：编辑、对比、提交审批 |
| 指标取数SQL | 修改 | 维护指标SQL、参数、测试、发布状态。 | ai_scm_metric_sql、ai_scm_data_asset、ai_scm_field_semantic、ai_scm_sql_audit_log | 指标计算任务、指标快照、生成SQL审计 | 指标/数据源/测试状态；展示SQL版本、参数、测试结果；操作：测试SQL、发布、回滚 |
| 指标计算任务 | 新增 | 管理指标定时计算、手工重算、失败重试。 | ai_scm_metric_calc_task、ai_scm_metric_sql、ai_scm_metric_result | 指标快照、经营分析、预警中心 | 任务名称/周期/状态；展示指标、Cron、最近执行、耗时；操作：运行、重试、停止、查看日志 |
| 指标快照 | 修改 | 展示指标计算结果，作为分析、预警、报表、预测的数据来源。 | ai_scm_metric_result、ai_scm_metric、ai_scm_metric_calc_task | 经营分析、预警规则、报表模板、预测决策 | 指标/日期/维度/状态；展示结果值、同比、环比、计算时间；操作：重算、导出、查看血缘 |
| 指标看板配置 | 修改 | 配置驾驶舱和看板组件引用哪些指标。 | ai_scm_dashboard、ai_scm_metric、ai_scm_metric_result | AI经营驾驶舱、场景效果看板 | 看板名称/类型/状态；展示布局、组件、指标绑定；操作：新增组件、预览、发布 |
| 指标权限配置 | 修改 | 配置角色、用户、组织可查看的指标范围。 | ai_scm_metric、sys_role、sys_role_menu、ai_data_permission_policy | 经营分析、智能问数、报表中心 | 角色/指标/数据范围；展示授权对象、指标范围、状态；操作：授权、取消、同步 |

预警中心

|----------|----------|----------------------------|----------------------------------------------------------------------------|--------------------|---------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 预警规则 | 修改 | 配置指标阈值、触发条件、作用范围和等级。 | ai_scm_warning_rule、ai_scm_metric、ai_scm_push_strategy | 预警事件、预警规则模拟测试 | 规则名称/等级/状态；展示指标、条件、范围、推送策略；操作：新增、测试、发布、启停 |
| 预警事件 | 修改 | 展示规则触发的事件并完成处理闭环。 | ai_scm_warning_event、ai_scm_warning_rule、ai_scm_message | 今日异常待办、经营建议闭环、推送记录 | 等级/状态/处理人/时间；展示触发值、阈值、业务对象；操作：认领、处理、关闭、转派 |
| 缺货预警 | 修改 | 专题展示缺货类事件和补货建议。 | ai_scm_warning_event、wms_goods_inventory、ai_scm_recommendation | 补货建议、消息中心 | 仓库/商品/等级/状态；展示库存、安全库存、缺口、建议量；操作：生成补货建议、处理 |
| 临期预警 | 修改 | 专题展示临期商品和处置建议。 | ai_scm_warning_event、wms_goods_inventory、pms_goods、ai_scm_push_log | 今日异常待办、消息中心 | 门店/仓库/临期天数/状态；展示商品、到期日、数量、风险等级；操作：促销、调拨、处理 |
| 采购价异常 | 修改 | 监控采购价波动异常。 | ai_scm_warning_event、pur_bill_info、ai_scm_metric_result | 采购分析、采购建议、供应商评分 | 供应商/商品/涨幅/状态；展示当前价、历史均价、异常率；操作：复核、关闭、生成建议 |
| 毛利异常 | 修改 | 监控毛利率低于阈值或异常波动。 | ai_scm_warning_event、fin_customer_bill、oms_order_bill、ai_scm_metric_result | 财务毛利分析、经营异常根因分析 | 商品/客户/毛利率/状态；展示标准毛利、当前毛利、原因；操作：分析、处理、推送 |
| 损耗异常 | 修改 | 监控报损率、损耗金额异常。 | ai_scm_warning_event、wms_loss_overflow、wms_goods_inventory | 库存优化、经营异常根因分析 | 仓库/商品/损耗类型/等级；展示金额、数量、原因；操作：处理、复盘、导出 |
| 推送策略 | 修改 | 配置消息渠道、接收人、频率、静默期。 | ai_scm_push_strategy、ai_scm_subscription | 推送记录、消息中心、预警规则 | 策略/渠道/接收范围/状态；展示触发方式、Cron、静默期；操作：新增、测试、启停 |
| 推送记录 | 新增 | 记录每次消息推送结果，解决推送是否成功不可追踪问题。 | ai_scm_push_log、ai_scm_message、ai_scm_push_strategy | 消息中心、我的订阅推送、异常调用监控 | 来源/渠道/接收人/状态；展示发送时间、失败原因、已读状态；操作：重试、标记已读、导出 |

报表中心

|----------|----------|--------------------------|-------------------------------------------------------------------------------------|----------------------|-----------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 报表模板 | 修改 | 定义报表结构、章节、指标、图表和AI提示词。 | ai_scm_report_template、ai_scm_metric、ai_prompt_template | 报表任务、AI日报/周报/月报、专项报告 | 模板名称/类型/状态；展示章节、指标、格式；操作：新增、预览、发布、复制 |
| AI日报 | 修改 | 按日自动生成经营分析报告。 | ai_scm_report_task、ai_scm_report_template、ai_scm_metric_result、ai_scm_warning_event | 报表生成记录、消息中心 | 日期/组织/状态；展示销售、采购、库存、毛利摘要；操作：生成、预览、导出、推送 |
| AI周报 | 修改 | 按周生成经营趋势与异常复盘。 | ai_scm_report_task、ai_scm_metric_result、ai_scm_warning_event | 报表生成记录、我的订阅推送 | 周期/组织/状态；展示周指标、异常、建议；操作：生成、导出、订阅 |
| AI月报 | 修改 | 按月生成经营复盘与下月建议。 | ai_scm_report_task、ai_scm_metric_result、ai_scm_forecast_result | 报表生成记录、预测决策 | 月份/组织/状态；展示月度趋势、风险、建议；操作：生成、导出、发布 |
| 专项分析报告 | 修改 | 针对采购、库存、毛利、供应商等专题生成深度报告。 | ai_scm_report_task、ai_scm_report_template、ai_scm_metric_result、ai_prompt_template | 经营分析、经营建议闭环 | 专题/业务域/状态；展示报告名称、数据范围、生成状态；操作：生成、预览、下载 |
| 报表任务 | 修改 | 管理报表生成任务、失败重试、定时任务。 | ai_scm_report_task、ai_scm_report_template | 报表生成记录、AI运维日报 | 任务名称/类型/状态；展示模板、时间、错误信息；操作：执行、重试、停止 |
| 报表生成记录 | 修改 | 保存历史生成结果和状态。 | ai_scm_report_task、ai_scm_report_file、ai_scm_operation_log | 报表导出下载、消息中心 | 报表名称/类型/状态；展示生成时间、文件地址、耗时；操作：查看、重试、删除 |
| 报表导出下载 | 修改 | 下载PDF、Word、Excel等报表文件。 | ai_scm_report_task、ai_scm_report_file、ai_scm_operation_log | 我的订阅推送、报表阅读分析 | 文件类型/日期/状态；展示文件名、大小、下载次数；操作：下载、批量下载、清理 |

预测决策

|----------|----------|----------------------------|--------------------------------------------------------------------------------|------------------|-------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 销量预测 | 修改 | 基于历史销量、季节、促销、库存预测未来销量。 | ai_scm_forecast_result、oms_order_bill_info、ai_scm_metric_result | 补货建议、采购建议、AI日报 | 商品/组织/周期/模型；展示预测值、置信度、趋势；操作：刷新预测、导出、解释 |
| 补货建议 | 修改 | 根据销量预测、库存、安全库存、在途量生成补货建议。 | ai_scm_recommendation、ai_scm_forecast_result、wms_goods_inventory、pur_bill_info | 采购建议、经营建议闭环 | 商品/仓库/优先级/状态；展示建议量、金额、到货日；操作：采纳、生成采购、拒绝 |
| 库存优化 | 修改 | 分析高库存、低周转、库龄，输出调拨/促销/采购优化。 | ai_scm_recommendation、wms_goods_inventory、ai_scm_metric_result | 调拨建议、缺货与滞销分析 | 仓库/品类/库龄/状态；展示周转天数、优化建议、预计资金；操作：采纳、跟踪 |
| 采购建议 | 修改 | 根据销量、库存、供应商履约生成采购建议。 | ai_scm_recommendation、ai_scm_forecast_result、sup_supplier、pur_bill | 采购分析、供应商评分 | 供应商/品类/状态；展示建议采购量、金额、风险；操作：生成采购单、采纳、拒绝 |
| 调拨建议 | 修改 | 根据门店/仓库库存差异生成调拨建议。 | ai_scm_recommendation、wms_goods_inventory、tms_waybill | 库存优化、配送履约分析 | 调出/调入组织/商品/状态；展示缺口、可调库存、线路；操作：生成调拨单、采纳 |
| 供应商评分 | 修改 | 综合价格、履约、质量、交付、协同效率生成评分。 | ai_scm_recommendation、sup_supplier、pur_bill、quality_check、ai_scm_metric_result | 采购建议、供应商履约分析 | 供应商/分类/评分等级；展示价格、质量、交付分；操作：对标、导出、生成建议 |
| 经营建议闭环 | 修改 | 汇总AI建议并记录认领、采纳、拒绝、关闭。 | ai_scm_recommendation、ai_scm_recommendation_action | 采纳效果评估、消息中心、操作日志 | 建议类型/状态/责任人；展示建议内容、来源、执行动作；操作：采纳、拒绝、关闭、转派 |
| 采纳效果评估 | 修改 | 跟踪建议采纳前后指标变化。 | ai_scm_recommendation_effect、ai_scm_recommendation_action、ai_scm_metric_result | AI助手价值看板、模型效果评测 | 建议类型/评估结果/时间；展示采纳前后指标、改善率、ROI；操作：复盘、导出 |

知识库与语义

|----------|----------|----------------------------|------------------------------------------------------------------|-------------------------|---------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 数据资产管理 | 新增 | 登记真实业务表，定义哪些表允许被AI分析和问数。 | ai_scm_data_asset、sys_data_source | 表字段语义、业务表映射、AI智能问数、指标定义 | 业务域/源系统/状态/敏感级别；展示表名、负责人、字段数；操作：新增、同步字段、发布 |
| 知识库管理 | 修改 | 管理知识库、业务域、向量模型和索引状态。 | ai_knowledge、ai_knowledge_document、ai_knowledge_segment | 文档管理、RAG检索测试、AI智能问数 | 知识库/业务域/状态；展示文档数、分段数、索引状态；操作：新增、同步、启停 |
| 文档管理 | 修改 | 上传、解析、分段、向量化、发布文档。 | ai_knowledge_document、ai_knowledge_segment | 分段向量检索、RAG检索测试 | 文档名称/知识库/状态；展示类型、大小、解析状态；操作：上传、解析、向量化、发布 |
| 分段向量检索 | 修改 | 测试分段、向量相似度、召回、重排效果。 | ai_knowledge_segment、ai_knowledge_document、ai_knowledge | RAG检索测试、知识库质量评分 | 查询文本/知识库/模型；展示片段、相似度、命中类型；操作：检索、导出、标注 |
| 业务术语库 | 修改 | 维护业务术语、别名、同义词、解释。 | ai_scm_term_library、ai_scm_field_semantic | AI智能问数、RAG检索、报表解释 | 术语/业务域/状态；展示别名、解释、使用次数；操作：新增、校验、发布 |
| 表字段语义 | 修改 | 维护表字段中文名、语义、维度/指标/筛选/敏感标记。 | ai_scm_field_semantic、ai_scm_data_asset | AI智能问数、指标取数SQL、SQL安全规则 | 表名/字段/语义类型/敏感级别；展示中文名、含义、标签；操作：编辑、批量导入、发布 |
| 业务表映射 | 修改 | 维护业务对象与底层表字段的关系。 | ai_scm_business_mapping、ai_scm_data_asset、ai_scm_field_semantic | AI智能问数、供应链知识图谱、指标血缘 | 来源对象/目标对象/关系类型；展示映射规则、状态；操作：新增映射、批量导入、发布 |
| 问数样例库 | 修改 | 维护自然语言问题样例、推荐问法、期望SQL。 | ai_scm_nlq_template、ai_scm_nlq_log | AI智能问数、问数命中分析、AI测试用例 | 业务域/样例类型/角色/状态；展示问题、推荐SQL、使用次数；操作：新增、测试、发布 |
| RAG检索测试 | 修改 | 测试RAG召回、引用、生成答案质量。 | ai_knowledge_segment、ai_knowledge_document、ai_scm_model_call_log | 模型效果评测、知识库质量评分 | 问题/知识库/TopK/模型；展示答案、引用片段、质量评分；操作：测试、保存样例、导出 |

模型配置

|----------|----------|--------------------------|-------------------------------------------------------|----------------------|--------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| API密钥配置 | 修改 | 维护供应商API Key、额度、到期、测试连接。 | ai_api_key、ai_scm_operation_log | 大模型配置、模型供应商健康、模型调用 | 供应商/环境/状态；展示key掩码、额度、到期；操作：新增、测试、轮换、禁用 |
| 大模型配置 | 修改 | 维护模型清单、供应商、成本、上下文、默认标记。 | ai_model、ai_api_key | 模型场景路由、模型调用日志 | 模型名/供应商/类型/状态；展示参数、成本、默认标记；操作：新增、测试、启停、设默认 |
| 模型场景路由 | 新增 | 按场景配置主模型、备用模型、提示词和降级。 | ai_model_scene_route、ai_model、ai_prompt_template | 所有AI调用、模型调用日志、异常调用监控 | 场景/主模型/备用模型/状态；操作：新增、测试、启停 |
| 模型参数方案 | 修改 | 配置温度、TopP、输出长度、重试和超时参数。 | ai_model_param_scheme、ai_model | 模型场景路由、提示词调试台 | 方案/模型/场景/状态；操作：新增、测试、发布 |
| 助手角色配置 | 修改 | 配置不同场景助手角色和回答边界。 | ai_assistant_role、ai_prompt_template、ai_tool_function | AI智能问数、AI报表、经营建议 | 角色/场景/模型/工具；操作：新增、复制、启停 |
| 提示词模板 | 修改 | 管理系统提示词、用户提示词、输出结构和版本。 | ai_prompt_template | 报表模板、AI智能问数、提示词版本管理 | 模板/场景/语言/状态；操作：新增、测试、发布、回滚 |
| 工具函数配置 | 修改 | 配置AI可调用的后端工具函数和权限。 | ai_tool_function、ai_scm_tool_call_log | AI工具函数测试台、智能体工作流 | 工具名/模块/权限/状态；操作：新增、测试、启停 |
| 调用额度配置 | 修改 | 配置用户、角色、模型、场景的调用额度和成本上限。 | ai_quota_policy、ai_scm_model_call_log | 成本与Token统计、模型成本预警 | 策略/模型/范围/额度；操作：新增、启停、重置额度 |
| 敏感词与脱敏 | 修改 | 配置敏感词、敏感字段、输出脱敏与拦截。 | ai_sensitive_rule、ai_scm_field_semantic | AI智能问数、SQL沙箱执行、报表导出 | 规则/级别/模块/状态；操作：新增、测试、发布 |

审计与权限

|------------|----------|------------------------------|----------------------------------------------------------------|-------------------|-------------------------------------------|
| 功能菜单 | 建设类型 | 功能定位 | 数据来源/影响数据表 | 数据产出供哪个模块调用 | 列表功能与交互要求 |
| 模型调用日志 | 修改 | 记录每次模型调用、Token、成本、耗时、错误。 | ai_scm_model_call_log | 成本与Token统计、异常调用监控 | 模型/场景/状态/时间；展示输入摘要、输出摘要、Token；操作：详情、重试、追踪 |
| 问数日志 | 修改 | 记录用户问数、生成SQL、执行状态和结果摘要。 | ai_scm_nlq_log、ai_scm_sql_audit_log | 生成SQL审计、问数命中分析 | 用户/业务域/状态/时间；展示问题、SQL、耗时；操作：查看、收藏、纠错 |
| 工具调用日志 | 修改 | 记录工具函数调用入参、出参、耗时和异常。 | ai_scm_tool_call_log、ai_tool_function | 异常调用监控、操作日志 | 工具/模块/状态/时间；展示输入输出、traceId；操作：详情、追踪 |
| 生成SQL审计 | 修改 | 审计AI生成SQL是否只读、是否白名单、是否含敏感字段。 | ai_scm_sql_audit_log、ai_scm_data_asset、ai_scm_field_semantic | AI智能问数、SQL沙箱执行 | 风险等级/状态/用户；展示SQL、规则命中、审核意见；操作：通过、拒绝、复制SQL |
| 成本与Token统计 | 修改 | 统计模型、场景、用户、部门成本。 | ai_scm_model_call_log、ai_api_key、ai_model | 模型成本预警、AI成本分摊 | 模型/场景/时间；展示Token、成本、排行；操作：导出、分摊 |
| 异常调用监控 | 修改 | 监控模型超时、限流、失败、内容安全异常。 | ai_scm_model_call_log、ai_scm_tool_call_log、ai_scm_push_log | AI安全风险看板、AI运维日报 | 异常类型/模型/状态；展示错误码、影响范围；操作：处理、关联日志 |
| 操作日志 | 新增 | 记录AI助手配置新增、修改、删除、启停、发布、导出。 | ai_scm_operation_log、ops_audit_log、ops_audit_log_field | 字段级审计、配置变更对比 | 模块/操作人/类型/时间；展示前后值、IP、状态；操作：查看、导出 |
| 菜单授权 | 恢复/新增 | 配置AI助手菜单、按钮、敏感页面权限。 | sys_menu、sys_role_menu、sys_user_role、ai_data_permission_policy | 所有前端页面和后端接口 | 角色/菜单/按钮/数据范围；操作：授权、取消、同步 |
| 多语言菜单维护 | 修改 | 维护菜单、按钮、提示语多语言。 | sys_static_translation、sys_dynamic_translation、sys_menu | 前端所有页面、报表导出 | 语言/资源类型/状态；展示中文、英文、繁体；操作：编辑、发布、导入 |

五、扩展功能 77-200 的建设方式建议

77-200 原型属于AI助手增强功能，建议不要全部一阶段上线。可以按照链路补齐、模型治理、质量优化、运维安全分批建设。

|----------|----------|--------------------------------------------------------|-------------------|-----------------------------------------------------------------------------------------------------|--------------------|
| 扩展类型 | 功能范围 | 代表功能 | 建设建议 | 主要影响表 | 主要调用模块 |
| 链路补齐类 | 77-90 | 建议采纳动作、效果评估明细、数据资产字段同步、AI任务调度监控、数据质量检查、数据血缘追踪、SQL安全规则等 | 新增为二期增强菜单或Tab | ai_scm_recommendation_action/effect、ai_scm_metric_calc_task、ai_scm_data_asset、ai_scm_sql_audit_log | 预测决策、知识库、审计权限、指标中心 |
| 模型治理类 | 91-130 | 数据源连接、数据权限、模型效果评测、提示词版本、密钥轮换、灰度发布、熔断降级、缓存队列、模型A/B测试等 | 多数为新增运维/治理页面 | ai_model_scene_route、ai_model_param_scheme、ai_prompt_template、ai_scm_model_call_log、ai_quota_policy | 模型配置、审计与权限 |
| 质量优化类 | 131-160 | AI业务场景、智能体工作流、规则命中、异常根因、质量评分、成本分摊、问数命中、持续优化等 | 作为AI运营与治理增强功能新增 | ai_agent_workflow、ai_scm_operation_log、ai_scm_feedback、ai_scm_model_call_log | 智能工作台、审计权限、经营分析 |
| 运维安全类 | 161-200 | SLA、工单、备份恢复、知识清理、偏差分析、风险看板、准入、配置巡检、限流、结算、完整性总览等 | 作为AI运维与总体验收增强功能新增 | ai_scm_operation_log、ai_scm_push_log、ai_scm_model_call_log、ai_scm_data_access_log、ai_config_backup | 审计权限、模型配置、知识库与语义 |

六、核心数据链路与表关系

|----------|--------------------------------------------|-------------------------------------------------------------------------------------------------------------------|------------------------------|
| 链路名称 | 正确业务流 | 核心影响表 | 下游调用模块 |
| 数据理解链路 | 数据资产管理 → 表字段语义 → 业务表映射 → 业务术语库 → 问数样例库 | ai_scm_data_asset、ai_scm_field_semantic、ai_scm_business_mapping、ai_scm_term_library、ai_scm_nlq_template | AI智能问数、指标定义、指标SQL、RAG检索、报表解释 |
| 智能问数链路 | AI智能问数 → 生成SQL审计 → SQL沙箱 → 问数日志 → 模型调用日志 | ai_scm_nlq_log、ai_scm_sql_audit_log、ai_scm_model_call_log、ai_scm_field_semantic | 问数日志、生成SQL审计、成本统计、问数命中分析 |
| 指标分析链路 | 指标分类 → 指标定义 → 指标口径 → 指标SQL → 指标计算任务 → 指标快照 | ai_scm_metric_category、ai_scm_metric、ai_scm_metric_sql、ai_scm_metric_calc_task、ai_scm_metric_result | 经营分析、预警规则、报表模板、预测决策 |
| 预警闭环链路 | 指标快照 → 预警规则 → 预警事件 → 推送策略 → 推送记录 → 消息中心 | ai_scm_metric_result、ai_scm_warning_rule、ai_scm_warning_event、ai_scm_push_strategy、ai_scm_push_log、ai_scm_message | 今日异常待办、消息中心、经营建议闭环 |
| 报表生成链路 | 报表模板 → 报表任务 → 生成记录 → 导出下载 → 订阅推送 | ai_scm_report_template、ai_scm_report_task、ai_scm_report_file、ai_scm_subscription、ai_scm_push_log | 消息中心、报表阅读分析、AI经营日报 |
| 预测决策链路 | 销量预测 → 补货/库存/采购/调拨建议 → 建议闭环 → 效果评估 | ai_scm_forecast_result、ai_scm_recommendation、ai_scm_recommendation_action、ai_scm_recommendation_effect | AI助手价值看板、经营分析、采购/库存/配送业务 |
| 模型治理链路 | API密钥 → 模型配置 → 场景路由 → 参数方案 → 提示词模板 → 调用日志 | ai_api_key、ai_model、ai_model_scene_route、ai_model_param_scheme、ai_prompt_template、ai_scm_model_call_log | 所有AI调用页面、成本统计、异常调用监控 |
| 审计权限链路 | 菜单授权 → 数据权限 → 操作日志 → 模型/问数/SQL/工具日志 | sys_menu、sys_role_menu、sys_user_role、ai_data_permission_policy、ai_scm_operation_log | 全系统安全控制和验收审计 |

七、列表页面统一验收规则

|---------|------------------------------------------------|
| 验收项 | 详细要求 |
| 查询条件 | 所有列表必须支持组织/时间/状态/业务域等基础筛选；业务对象必须使用选择器，不允许手输ID。 |
| 列表显示 | 列表不显示纯ID字段，显示名称、编码、状态、时间、责任人、业务摘要等可读字段。 |
| 详情弹窗 | 点击查看必须能展示主信息、关联数据、日志、来源、下游影响。 |
| 新增/修改 | 保存ID，反显名称；保存后刷新列表数据；禁用/删除后不参与计算。 |
| 导出 | 导出结果必须与当前查询条件一致，并写入操作日志。 |
| 权限 | 按钮权限、后端权限、sys_menu权限码必须一致；无权限接口返回403或等效错误。 |
| 多语言 | 菜单、按钮、表头、提示语必须走翻译Key，支持简体、繁体、英文。 |
| 日志 | 涉及AI调用、SQL生成、工具调用、配置发布、导出的操作必须写日志。 |

八、优先开发与验收建议

|---------|---------------------------------|-----------------------------|
| 优先级 | 功能范围 | 原因 |
| P0 | 数据资产管理、表字段语义、业务表映射、问数样例库、AI智能问数 | 先打通真实数据问数链路，防止AI无法理解升鲜宝业务表。 |
| P0 | 指标定义、指标SQL、指标计算任务、指标快照、经营分析 | 先让分析页面消费指标快照，不允许继续使用Demo数据。 |
| P0 | 预警规则、预警事件、推送策略、推送记录、消息中心 | 先闭合预警触发、处理、推送、阅读链路。 |
| P1 | 报表模板、报表任务、生成记录、导出下载、订阅推送 | 报表必须能读取指标与预警数据，生成真实文件。 |
| P1 | 模型场景路由、模型调用日志、成本与Token统计、异常调用监控 | 所有AI调用必须可追踪、可计费、可降级。 |
| P2 | 预测决策、建议闭环、采纳效果评估、AI价值看板 | 在基础链路稳定后上线决策增强功能。 |
| P2 | 扩展运维与治理页面 77-200 | 按运行情况逐步建设，不建议一次性全部上线。 |

九、最终落地判断标准

最终验收时，必须逐条检查：页面列表是否来自数据库、统计是否来自指标快照、AI结论是否能追溯到数据和模型调用、预警是否能进入待办和推送、报表是否能生成和下载、预测建议是否能采纳并评估效果、权限是否控制到菜单/按钮/数据范围、日志是否能追踪到输入、输出、SQL、模型、工具和操作人。

如果某个页面只能打开但不能形成数据来源、业务结果和下游调用关系，则该页面只能算原型完成，不能算功能验收通过。