序号

二级模块

模块作用

下属三级功能

1

智能工作台

AI助手日常入口，聚合驾驶舱、异常待办、智能问数、日报、预警、收藏问题与订阅推送。业务用户每天进入该模块即可看到“经营怎么样、哪里异常、今天要处理什么”。

AI经营驾驶舱；今日异常待办；AI智能问数；AI经营日报；AI预警概览；常用问题收藏；我的订阅推送

2

经营分析

承接升鲜宝采购、销售、库存、配送、财务、供应商、质检溯源等真实业务数据，输出经营分析结果，为指标、预警、报表、预测决策提供业务场景化视图。

采购分析；销售订单分析；库存周转分析；缺货与滞销分析；配送履约分析；财务毛利分析；供应商履约分析；质检溯源分析

3

指标中心

AI助手的数据标准层，负责指标分类、定义、口径、取数SQL、指标快照、看板配置、权限配置。预警、报表、问数和预测都应优先复用指标中心口径。

指标分类；指标定义；指标口径维护；指标取数SQL；指标快照；指标看板配置；指标权限配置

4

预警中心

异常发现与闭环处理中心，基于指标结果、阈值规则和主题规则触发预警事件，并通过推送策略通知责任人，最终形成处理结果。

预警规则；预警事件；缺货预警；临期预警；采购价异常；毛利异常；损耗异常；推送策略

5

报表中心

AI报表生产中心，负责报表模板、日报、周报、月报、专项报告、报表任务、生成记录和导出下载。报表内容来自指标结果、预警事件、经营分析结果和大模型解读。

报表模板；AI日报；AI周报；AI月报；专项分析报告；报表任务；报表生成记录；报表导出下载

6

预测决策

经营建议与决策辅助中心，基于历史数据、当前指标、库存状态、供应商表现和模型结果，生成销量预测、补货、库存优化、采购、调拨、供应商评分及建议闭环。

销量预测；补货建议；库存优化；采购建议；调拨建议；供应商评分；经营建议闭环；采纳效果评估

7

知识库与语义

AI理解升鲜宝业务语言和数据结构的基础设施，包含知识库、文档、向量检索、术语库、字段语义、业务表映射、问数样例、RAG检索测试。

知识库管理；文档管理；分段向量检索；业务术语库；表字段语义；业务表映射；问数样例库；RAG检索测试

8

模型配置

AI能力底座，管理API密钥、大模型、参数方案、助手角色、提示词模板、工具函数、额度、敏感词与脱敏策略。所有模型调用均依赖此模块。

API密钥配置；大模型配置；模型参数方案；助手角色配置；提示词模板；工具函数配置；调用额度配置；敏感词与脱敏

9

审计与权限

治理与追溯中心，记录模型调用、问数、工具调用、SQL生成、成本Token、异常调用，并维护菜单授权、多语言菜单。保障安全、可控、可追责。

模型调用日志；问数日志；工具调用日志；生成SQL审计；成本与Token统计；异常调用监控；菜单授权；多语言菜单维护

源对象

关系

目标对象

业务含义

真实业务源表

登记为

ai_scm_data_asset

OMS/PUR/WMS/TMS/FIN/TRACE 等源表登记为AI可理解的数据资产。

ai_scm_data_asset

1:N

ai_scm_field_semantic

一个数据资产下有多个字段语义定义。

ai_scm_data_asset

1:N

ai_scm_metric

指标可指定来源数据资产。

ai_scm_metric_category

1:N

ai_scm_metric

分类下维护多个指标。

ai_scm_metric

1:N

ai_scm_metric_sql

一个指标可有多个取数SQL版本。

ai_scm_metric

1:N

ai_scm_metric_result

指标计算后产生多期快照结果。

ai_scm_metric

1:N

ai_scm_warning_rule

指标可被多个预警规则引用。

ai_scm_warning_rule

1:N

ai_scm_warning_event

规则扫描命中后生成事件。

ai_scm_push_strategy

1:N

ai_scm_warning_rule

预警规则绑定推送策略。

ai_scm_warning_event

1:N

ai_scm_recommendation

事件可生成处理建议和经营建议。

ai_scm_report_template

1:N

ai_scm_report_task

模板生成多个报表任务。

ai_prompt_template

1:N

ai_scm_report_template

报表模板引用提示词模板。

ai_model

1:N

ai_scm_model_call_log

所有模型调用记录模型ID。

ai_api_key

1:N

ai_model

一个密钥可绑定多个模型。

ai_knowledge

1:N

ai_knowledge_document

知识库包含多个文档。

ai_knowledge_document

1:N

ai_knowledge_segment

文档解析切分为多个片段。

ai_scm_business_mapping

辅助

ai_scm_nlq_log

问数生成SQL时通过业务表映射定位表字段。

ai_scm_nlq_template

辅助

ai_scm_nlq_log

样例问题提升问数准确率。

ai_scm_subscription

订阅

ai_scm_message

订阅规则触发后产生个人消息。

功能模块

核心数据库表

说明

模型配置

ai_api_key, ai_model, ai_prompt_template

模型供应商、密钥、参数、提示词、角色等配置。

智能工作台

ai_scm_dashboard, ai_scm_metric_result, ai_scm_warning_event, ai_scm_message, ai_scm_subscription

驾驶舱、异常待办、订阅推送、智能问数入口。

经营分析

ai_scm_metric_result, ai_scm_warning_event, ai_scm_recommendation, 业务源表

采购、销售、库存、配送、财务、供应商、质检溯源分析。

指标中心

ai_scm_metric_category, ai_scm_metric, ai_scm_metric_sql, ai_scm_metric_result, ai_scm_dashboard

指标分类、定义、SQL、快照、看板配置和指标权限。

预警中心

ai_scm_warning_rule, ai_scm_warning_event, ai_scm_push_strategy, ai_scm_message

预警规则、预警事件、主题预警、消息推送。

报表中心

ai_scm_report_template, ai_scm_report_task, ai_prompt_template, ai_scm_subscription

报表模板、报表任务、AI报告生成与订阅。

预测决策

ai_scm_forecast_result, ai_scm_recommendation, ai_scm_metric_result, ai_model

销量预测、补货、采购、调拨、库存优化、供应商评分、建议闭环。

知识库与语义

ai_knowledge, ai_knowledge_document, ai_knowledge_segment, ai_scm_data_asset, ai_scm_field_semantic, ai_scm_business_mapping, ai_scm_nlq_template

文档、向量、术语、字段语义、表映射和问数样例。

审计与权限

ai_scm_model_call_log, ai_scm_nlq_log, ai_scm_operation_log, sys_menu, 多语言表

模型调用、问数、工具调用、SQL审计、成本Token、异常监控、菜单授权。

序号

功能页面

功能作用

主要操作流程

关联数据表

1

AI经营驾驶舱

查看销售、订单、毛利、库存、预警、建议等核心指标总览。

选择组织/门店/日期范围 -> 查看指标卡、趋势图、异常提醒 -> 点击指标进入明细。

ai_scm_dashboard、ai_scm_metric_result、ai_scm_warning_event、ai_scm_recommendation

2

今日异常待办

集中处理今日缺货、临期、采购价、毛利、损耗、模型异常等待办。

查看待办列表 -> 按等级筛选 -> 进入事件详情 -> 处理/转派/忽略。

ai_scm_warning_event、ai_scm_message、ai_scm_recommendation

3

AI智能问数

用自然语言提问，自动查询升鲜宝业务数据并解释结果。

输入问题 -> 系统匹配样例/语义 -> 生成SQL -> 安全审计 -> 执行查询 -> 返回结果和解释。

ai_scm_nlq_template、ai_scm_nlq_log、ai_scm_data_asset、ai_scm_field_semantic、ai_scm_business_mapping

4

AI经营日报

查看系统每日自动生成的经营日报。

选择日期 -> 查看日报摘要、指标、异常、建议 -> 下载或订阅。

ai_scm_report_template、ai_scm_report_task、ai_scm_metric_result

5

AI预警概览

总览所有预警数量、等级、处理状态和趋势。

选择时间/模块 -> 查看预警统计 -> 点击进入主题预警或事件处理。

ai_scm_warning_rule、ai_scm_warning_event、ai_scm_push_strategy

6

常用问题收藏

收藏高频问数问题，方便快速复用。

从问数结果收藏 -> 分类维护 -> 一键发起问数。

ai_scm_nlq_template、ai_scm_nlq_log

7

我的订阅推送

查看个人订阅的报表、预警、快报推送。

订阅报表/预警 -> 选择渠道和频率 -> 查看推送记录。

ai_scm_subscription、ai_scm_message、ai_scm_push_strategy

序号

功能页面

功能作用

主要操作流程

关联数据表

8

采购分析

分析采购金额、采购量、价格波动、到货履约、供应商采购集中度。

筛选日期/供应商/品类 -> 查看采购趋势、排行、异常 -> 下钻单据。

ai_scm_metric_result、采购业务表、ai_scm_warning_event

9

销售订单分析

分析销售额、订单数、客单价、客户结构、取消率、商品销量。

筛选渠道/客户/商品 -> 查看趋势和排行 -> 下钻订单。

ai_scm_metric_result、销售订单业务表

10

库存周转分析

分析库存金额、库龄、周转天数、安全库存、缺货率。

筛选仓库/门店/商品 -> 查看库存结构和周转 -> 进入补货/调拨建议。

ai_scm_metric_result、库存业务表、ai_scm_recommendation

11

缺货与滞销分析

识别缺货SKU和滞销SKU，输出补货或清理建议。

查看缺货/滞销列表 -> 查看原因 -> 生成补货/促销/调拨建议。

ai_scm_warning_event、ai_scm_forecast_result、ai_scm_recommendation

12

配送履约分析

分析配送准时率、签收时效、线路异常、司机履约。

筛选线路/司机/日期 -> 查看履约率和异常线路 -> 下钻配送单。

ai_scm_metric_result、配送业务表

13

财务毛利分析

分析毛利率、成本、收入、费用、低毛利商品和客户。

选择周期/组织/客户/商品 -> 查看毛利趋势和低毛利明细。

ai_scm_metric_result、财务/订单业务表

14

供应商履约分析

分析供应商到货准时率、质量、价格、退货、评分。

筛选供应商/品类 -> 查看履约评分 -> 进入供应商评分或采购建议。

ai_scm_metric_result、ai_scm_recommendation

15

质检溯源分析

分析质检结果、异常批次、溯源码、供应商质量风险。

选择批次/供应商/商品 -> 查看质检异常 -> 下钻溯源链路。

ai_scm_metric_result、质检/溯源业务表

序号

功能页面

功能作用

主要操作流程

关联数据表

16

指标分类

维护采购、销售、库存、财务等指标分类树。

新增分类 -> 设置业务域和层级 -> 启用。

ai_scm_metric_category

17

指标定义

定义指标编码、名称、周期、单位、维度、来源资产。

新增指标 -> 选择分类/业务域/资产 -> 保存。

ai_scm_metric、ai_scm_metric_category、ai_scm_data_asset

18

指标口径维护

维护指标公式、过滤条件、统计说明和口径版本。

选择指标 -> 编辑口径 -> 提交审核/发布。

ai_scm_metric

19

指标取数SQL

维护指标SQL版本、参数、测试状态和发布状态。

编辑SQL -> 安全校验 -> 测试执行 -> 发布。

ai_scm_metric_sql、ai_scm_metric

20

指标快照

查看指标定时计算结果。

选择指标和日期 -> 查看结果 -> 供预警/报表/看板调用。

ai_scm_metric_result

21

指标看板配置

配置驾驶舱和分析页面的看板布局。

选择指标组件 -> 配置布局和可见范围 -> 发布。

ai_scm_dashboard、ai_scm_metric_result

22

指标权限配置

控制角色可查看和操作的指标。

选择角色 -> 勾选指标权限 -> 保存。

ai_scm_metric、系统权限表

序号

功能页面

功能作用

主要操作流程

关联数据表

23

预警规则

定义触发预警的指标、阈值、范围和推送策略。

新增规则 -> 选择指标/条件/等级/范围 -> 绑定推送策略 -> 启用。

ai_scm_warning_rule、ai_scm_metric、ai_scm_push_strategy

24

预警事件

查看并处理规则触发的事件。

查看事件 -> 分派/处理/关闭 -> 记录处理结果。

ai_scm_warning_event、ai_scm_warning_rule

25

缺货预警

专门查看缺货相关事件和补货建议。

筛选仓库/商品 -> 查看缺货原因 -> 生成补货建议。

ai_scm_warning_event、ai_scm_recommendation

26

临期预警

专门查看临期商品风险。

筛选商品/批次 -> 查看临期天数 -> 生成促销/调拨建议。

ai_scm_warning_event、ai_scm_recommendation

27

采购价异常

监控采购价与历史价/市场价差异。

查看异常商品 -> 对比历史价 -> 通知采购复核。

ai_scm_warning_event、ai_scm_metric_result

28

毛利异常

监控毛利过低、负毛利、毛利波动。

查看异常明细 -> 分析原因 -> 形成处理建议。

ai_scm_warning_event、ai_scm_metric_result

29

损耗异常

监控报损、损耗率和损耗金额异常。

查看损耗异常 -> 下钻损耗单/商品 -> 处理。

ai_scm_warning_event、损耗业务表

30

推送策略

配置预警、报表、快报的接收对象、渠道和频率。

新建策略 -> 选择渠道/接收人/静默期 -> 启用。

ai_scm_push_strategy、ai_scm_message、ai_scm_subscription

序号

功能页面

功能作用

主要操作流程

关联数据表

31

报表模板

定义报表结构、章节、指标、Prompt和输出格式。

新增模板 -> 选择指标和章节 -> 绑定提示词 -> 发布。

ai_scm_report_template、ai_prompt_template

32

AI日报

查看每日自动生成的报表。

选择日期 -> 查看 -> 下载/订阅。

ai_scm_report_task、ai_scm_report_template

33

AI周报

查看每周汇总报告。

选择周 -> 查看经营趋势和建议 -> 下载。

ai_scm_report_task

34

AI月报

查看月度经营复盘。

选择月份 -> 查看经营成果、风险、建议。

ai_scm_report_task

35

专项分析报告

针对毛利、采购、供应商、库存等专题生成深度分析。

选择模板/主题 -> 生成 -> 查看。

ai_scm_report_task、ai_scm_report_template

36

报表任务

管理报表生成任务。

新建任务 -> 执行 -> 查看状态/失败原因。

ai_scm_report_task

37

报表生成记录

查看历史生成记录。

筛选任务 -> 查看生成结果。

ai_scm_report_task

38

报表导出下载

下载报表文件。

选择报表 -> 下载Word/PDF/Excel。

ai_scm_report_task

序号

功能页面

功能作用

主要操作流程

关联数据表

39

销量预测

预测未来商品销量、销售额和毛利。

选择时间/商品/模型 -> 生成预测 -> 查看趋势和预警。

ai_scm_forecast_result、ai_model

40

补货建议

根据销量预测、库存和在途数量生成补货建议。

查看建议SKU -> 查看建议量和供应商 -> 生成采购单。

ai_scm_recommendation、ai_scm_forecast_result

41

库存优化

识别高库存、低周转和库龄风险。

查看库存结构 -> 采纳促销/调拨/降采建议。

ai_scm_recommendation、ai_scm_metric_result

42

采购建议

生成采购计划和供应商选择建议。

查看建议商品 -> 对比供应商履约 -> 生成采购单。

ai_scm_recommendation、ai_scm_forecast_result

43

调拨建议

识别门店/仓库库存不平衡并给出调拨路线。

查看调出/调入方 -> 生成调拨单。

ai_scm_recommendation、库存业务表

44

供应商评分

综合价格、到货、质量、稳定性、协同效率评分。

查看评分 -> 对比趋势 -> 影响采购建议。

ai_scm_metric_result、ai_scm_recommendation

45

经营建议闭环

汇总所有AI建议，跟踪处理状态和责任人。

查看建议 -> 分派/采纳/关闭 -> 记录结果。

ai_scm_recommendation

46

采纳效果评估

评估AI建议执行前后效果。

选择建议 -> 查看改善率、成本节省、毛利提升。

ai_scm_recommendation、ai_scm_metric_result

序号

功能页面

功能作用

主要操作流程

关联数据表

47

知识库管理

管理知识库主数据和业务域。

新建知识库 -> 绑定模型 -> 同步向量。

ai_knowledge、ai_model

48

文档管理

上传、解析、分段、向量化文档。

上传文档 -> 解析 -> 分段 -> 向量化 -> 发布。

ai_knowledge_document、ai_knowledge_segment

49

分段向量检索

测试分段召回、相似度、重排效果。

输入查询文本 -> 设置TopK -> 检索。

ai_knowledge_segment、ai_knowledge

50

业务术语库

维护术语、同义词、缩写和解释。

新增术语 -> 维护别名 -> 启用。

ai_scm_field_semantic、ai_scm_nlq_template

51

表字段语义

维护表字段中文名、语义、敏感等级。

选择数据资产 -> 维护字段语义 -> 发布。

ai_scm_field_semantic、ai_scm_data_asset

52

业务表映射

维护业务对象与表/字段映射。

新增映射 -> 选择源表和目标对象 -> 校验。

ai_scm_business_mapping

53

问数样例库

维护高质量问法和参数模板。

新增问题样例 -> 绑定权限/业务域 -> 发布。

ai_scm_nlq_template

54

RAG检索测试

测试知识库检索与生成答案质量。

输入问题 -> 检索片段 -> 生成答案 -> 评分。

ai_knowledge_segment、ai_scm_model_call_log

序号

功能页面

功能作用

主要操作流程

关联数据表

55

API密钥配置

维护模型供应商密钥。

新增密钥 -> 测试连接 -> 设置额度。

ai_api_key

56

大模型配置

维护模型名称、供应商、类型、上下文、成本。

新增模型 -> 绑定密钥 -> 设置默认参数。

ai_model、ai_api_key

57

模型参数方案

按场景维护模型参数。

配置温度、TopP、上下文长度。

ai_model

58

助手角色配置

维护不同场景的AI助手角色。

新增角色 -> 绑定Prompt和工具。

ai_prompt_template

59

提示词模板

维护系统提示词和用户提示词模板。

编辑模板 -> 测试 -> 发布。

ai_prompt_template

60

工具函数配置

维护模型可调用的工具函数。

新增工具 -> 定义入参出参 -> 授权场景。

ai_scm_operation_log

61

调用额度配置

控制不同模型、用户、场景额度。

设置额度 -> 监控用量。

ai_api_key、ai_scm_model_call_log

62

敏感词与脱敏

维护内容安全与脱敏规则。

新增规则 -> 测试输出 -> 启用。

ai_prompt_template、ai_scm_operation_log

序号

功能页面

功能作用

主要操作流程

关联数据表

63

模型调用日志

查看所有模型调用情况。

按模型/场景/用户筛选 -> 查看成本与trace。

ai_scm_model_call_log

64

问数日志

查看智能问数历史。

查看问题、SQL、结果、耗时。

ai_scm_nlq_log

65

工具调用日志

查看工具函数调用历史。

查看入参、出参、异常和耗时。

ai_scm_operation_log、ai_scm_model_call_log

66

生成SQL审计

审核AI生成SQL安全性。

查看SQL -> 风险识别 -> 通过/拒绝。

ai_scm_nlq_log

67

成本与Token统计

统计Token用量和成本。

按模型/场景/用户统计。

ai_scm_model_call_log

68

异常调用监控

监控超时、失败、限流、异常成本。

查看异常列表 -> 处理/重试/限流。

ai_scm_model_call_log

69

菜单授权

授权AI助手菜单和按钮。

选择角色 -> 勾选菜单/按钮 -> 保存。

sys_menu、系统权限表

70

多语言菜单维护

维护AI助手菜单多语言。

选择菜单 -> 编辑语言文本 -> 发布。

多语言翻译表

调用关系

说明

模型配置 → 全部AI功能

所有智能问数、RAG、报表生成、预测建议、摘要生成，均从ai_model、ai_api_key、ai_prompt_template读取模型、密钥、提示词和参数。

知识库与语义 → AI智能问数

问数时读取业务术语库、表字段语义、业务表映射、问数样例库，辅助大模型理解用户问题并生成SQL。

知识库与语义 → RAG检索测试

上传文档后形成文档分段和向量，RAG检索使用ai_knowledge_segment召回片段并生成答案。

指标中心 → 经营分析

采购、销售、库存、配送、财务等分析页面优先展示指标快照和业务明细，减少重复口径。

指标中心 → 预警中心

预警规则选择指标，规则扫描指标快照，命中后生成预警事件。

指标中心 → 报表中心

日报、周报、月报、专项报告读取指标快照并调用提示词模板生成文字解释。

预警中心 → 智能工作台

今日异常待办、AI预警概览读取预警事件和处理状态。

预警中心 → 预测决策

缺货、临期、采购价、毛利、损耗异常可生成补货、采购、调拨、经营优化建议。

预测决策 → 经营建议闭环

销量预测、补货、采购、调拨、库存优化、供应商评分产生建议，统一进入ai_scm_recommendation跟踪采纳和效果。

报表中心 → 我的订阅推送

报表生成后通过订阅表和推送策略表产生消息。

审计与权限 → 全部模块

所有模型调用、问数、工具调用、SQL审计和操作行为均写日志，菜单授权控制用户可见范围。

服务

职责

被调用场景

AiModelService

模型、API Key、参数、提示词、额度、脱敏策略。

被问数、报表、RAG、预测、建议生成调用。

AiKnowledgeService

知识库、文档、分段、向量检索、RAG测试。

被AI智能问数、RAG检索测试、业务解释调用。

AiSemanticService

数据资产、字段语义、业务表映射、术语、问数样例。

被NLQ SQL生成、指标取数SQL、字段解释调用。

AiMetricService

指标分类、定义、口径、SQL、快照、看板配置。

被经营分析、预警、报表、预测调用。

AiWarningService

预警规则、事件、主题预警、处理闭环。

被工作台、消息中心、预测建议调用。

AiReportService

报表模板、任务、生成记录、导出下载。

调用指标、预警、模型、推送服务。

AiForecastService

销量预测、补货建议、库存优化、采购建议、调拨建议。

调用指标、库存、销售、供应商评分和模型服务。

AiAuditService

模型调用、问数、工具调用、SQL审计、成本、异常监控。

被所有服务统一调用。

AiPermissionService

菜单授权、按钮权限、多语言菜单维护。

控制AI助手各页面、按钮和数据范围。

验收项

检查说明

菜单与权限

AI助手一级菜单、9个二级模块、70个三级页面完整；按钮权限可控。

模型配置

API Key可测试；默认模型可用；调用日志可记录Token和成本。

知识语义

文档可上传解析分段；字段语义、业务表映射和问数样例可维护。

指标中心

指标SQL可测试发布；指标快照可生成；看板可读取指标。

预警中心

规则可触发事件；事件可处理闭环；推送策略可生效。

报表中心

模板可配置；任务可生成；报告可导出；记录可查询。

预测决策

销量预测、补货、采购、调拨、库存优化、供应商评分可输出建议。

审计治理

模型调用、问数、工具调用、SQL审计、成本Token、异常调用均可查询。

安全要求

SQL白名单、只读查询、脱敏、数据权限、日志追溯均通过。

表名

所属能力

用途

ai_api_key

API密钥配置

供应商API Key、额度、到期、环境、权限范围。

ai_model

大模型配置

模型名称、供应商、参数、上下文、成本、默认模型。

ai_prompt_template

提示词模板

场景提示词、系统提示词、输出结构和版本。

ai_chat_conversation / ai_chat_message

智能问答会话

对话主表和消息明细。

ai_knowledge / ai_knowledge_document / ai_knowledge_segment

知识库

知识库、文档、分段、向量索引。

ai_scm_data_asset / ai_scm_field_semantic / ai_scm_business_mapping

语义资产

业务表登记、字段语义、对象映射。

ai_scm_metric_category / ai_scm_metric / ai_scm_metric_sql / ai_scm_metric_result

指标中心

分类、定义、SQL、快照结果。

ai_scm_dashboard

看板配置

驾驶舱、指标看板组件布局。

ai_scm_warning_rule / ai_scm_warning_event / ai_scm_push_strategy

预警中心

规则、事件、推送策略。

ai_scm_message / ai_scm_subscription

消息订阅

站内消息和用户订阅配置。

ai_scm_report_template / ai_scm_report_task

报表中心

模板和报表任务。

ai_scm_forecast_result / ai_scm_recommendation

预测决策

预测结果和经营建议闭环。

ai_scm_nlq_template / ai_scm_nlq_log

智能问数

问数样例和问数日志。

ai_scm_model_call_log / ai_scm_operation_log

审计日志

模型调用日志和操作日志。