升鲜宝AI助手功能操作示意与模块关联开发梳理文档---升鲜宝生鲜配送供应链管理系统源代码服务

升鲜宝真实业务表（采购/销售/库存/配送/财务/供应商/质检/溯源）
  ↓
知识库与语义：数据资产管理 → 表字段语义 → 业务表映射 → 业务术语库 → 问数样例库
  ↓
指标中心：指标分类 → 指标定义 → 指标口径维护 → 指标取数SQL → 指标计算任务 → 指标快照
  ↓
业务消费：智能工作台 / 经营分析 / 预警中心 / 报表中心 / 预测决策
  ↓
模型配置：API密钥 → 大模型配置 → 场景路由 → 参数方案 → 提示词模板 → 工具函数
  ↓
审计与权限：模型调用日志 / 问数日志 / 工具调用日志 / SQL审计 / 成本统计 / 操作日志

顺序

模块

解决什么问题

输出给谁调用

1

知识库与语义

让AI知道能查哪些表、字段是什么意思、业务对象之间怎么关联。

AI智能问数、指标SQL、RAG、报表解释

2

指标中心

把销售额、毛利率、缺货率、周转天数等口径标准化。

经营分析、预警中心、报表中心、预测决策

3

模型配置

配置模型、密钥、提示词、工具函数、额度、敏感词与脱敏。

所有AI调用场景

4

智能工作台

作为用户入口，展示驾驶舱、待办、问数、日报、预警、消息。

汇总所有模块结果

5

经营分析

把指标和业务数据变成采购、销售、库存、配送、财务等分析页面。

报表、预警、预测

6

预警中心

基于指标快照和规则产生预警事件，推送到待办和消息。

今日异常待办、报表、经营建议

7

报表中心

基于指标、预警、经营分析和模型生成日报、周报、月报、专项报告。

订阅推送、管理层查看

8

预测决策

基于历史销售、库存、采购、供应商等数据输出预测与建议。

采购、库存、调拨、经营闭环

9

审计与权限

记录AI调用、问数、SQL、工具、成本、异常、操作、菜单授权、多语言。

全模块安全治理

步骤

要做什么

具体动作

产出结果

第0步

确认基础口径

确认AI助手是一级菜单；前端目录为src/views/ai；接口为/ai/**；权限前缀为ai。

开发规范、菜单结构、权限命名

第1步

先做模型配置底座

配置API密钥、大模型、模型场景路由、参数方案、提示词模板、工具函数、额度与脱敏。

AI调用能力可用

第2步

建立数据资产

登记真实业务表，维护表字段语义、业务表映射、业务术语、问数样例。

AI知道该查哪些表和字段

第3步

建立指标体系

维护指标分类、指标定义、口径、取数SQL、计算任务、指标快照和权限。

形成统一指标快照

第4步

打通AI智能问数

用户提问→识别意图→生成SQL→SQL审计→查询真实数据→AI解释→写日志。

问数能力可用

第5步

建设经营分析

采购、销售、库存、配送、财务、供应商、质检溯源按指标与业务数据展示。

经营分析页面可用

第6步

建设预警闭环

指标快照→预警规则→预警事件→推送策略→推送记录→待办/消息。

异常可发现、可处理

第7步

建设报表闭环

报表模板→报表任务→指标/预警/分析数据→模型生成内容→生成记录→导出下载。

日报周报月报可生成

第8步

建设预测决策闭环

历史销量+库存+采购+供应商交期→预测→补货/采购/调拨建议→采纳→效果评估。

建议可落地、可复盘

第9步

补审计与权限

模型调用、问数、工具、SQL、操作、成本、异常、菜单授权、多语言全部可追踪。

安全合规可验收

第10步

全链路验收

用样例数据跑通问数、指标、预警、报表、建议、审计五条闭环。

交付验收通过

数据资产管理：登记订单表、采购表、库存表、商品表等真实业务表
  ↓
表字段语义：维护字段中文名、含义、是否敏感、是否维度/指标
  ↓
业务表映射：维护订单主表与订单明细、商品、客户等关联关系
  ↓
问数样例库：沉淀“本月销售额是多少”等标准问法和参考SQL
  ↓
AI智能问数：生成SQL前先读取数据资产、字段语义和业务映射

指标定义：定义销售额、毛利率、缺货率、周转天数等指标
  ↓
指标取数SQL：配置指标计算SQL并通过测试发布
  ↓
指标计算任务：按日/周/月或手工执行计算
  ↓
指标快照：保存某时间、某维度下的指标值
  ↓
经营分析、预警规则、报表任务、预测决策统一读取指标快照

指标快照：库存低于安全库存、毛利率低于阈值、采购价上涨
  ↓
预警规则：按业务域、指标、阈值、等级、接收人配置规则
  ↓
预警事件：系统生成待处理事件
  ↓
推送策略：按站内信、企业微信、短信、邮件等方式推送
  ↓
今日异常待办 / 消息中心：负责人认领、处理、关闭

报表模板：配置日报、周报、月报、专项报告结构
  ↓
报表任务：选择周期、范围、接收人并执行生成
  ↓
读取数据：指标快照、预警事件、经营分析、预测建议
  ↓
模型生成：调用提示词模板生成经营解读和建议
  ↓
生成记录与文件：保存报表内容和文件地址，可下载和推送

模型调用：写模型调用日志、Token、成本、耗时、状态
问数动作：写问数日志、SQL审计日志、结果摘要
工具调用：写工具调用日志、参数、结果、错误
配置变更：写操作日志或字段级变更日志
异常失败：写异常调用监控，支持处理、关闭、忽略

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

AI经营驾驶舱

进入页面查看今日销售、采购、库存、毛利、预警、建议。

指标快照、预警事件、报表记录、经营建议。

作为用户首页，跳转预警、报表、预测、分析。

今日异常待办

查看未处理预警，认领、填写处理说明、关闭。

预警事件、消息中心、推送记录。

同步预警中心事件状态，形成处理闭环。

AI智能问数

输入自然语言问题，系统生成SQL并审计后查询。

数据资产、字段语义、业务映射、问数样例、模型配置。

输出表格/图表/AI解释，写问数日志和SQL审计。

AI经营日报

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

报表任务、指标快照、预警事件、模型调用日志。

供管理层查看，也可推送订阅用户。

AI预警概览

按等级、类型、状态查看预警概况。

预警事件、推送记录。

下钻到预警中心和待办处理。

常用问题收藏

收藏高频问数问题，维护个人常用查询。

问数模板、问数日志、用户收藏。

供AI智能问数快速复用。

我的订阅推送

查看自己订阅的报表、指标、预警推送。

订阅配置、消息中心、推送记录。

供消息中心和工作台展示。

消息中心

查看预警、报表、任务、系统通知，可标记已读。

消息表、推送记录。

跳转业务来源页面。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

采购分析

选择日期、供应商、品类查看采购金额、数量、价格波动。

采购单、采购明细、采购价格、指标快照。

供采购建议、采购价异常、报表调用。

销售订单分析

查看销售额、订单数、客户排行、商品排行、趋势。

订单主表、订单明细、客户、商品、指标快照。

供销量预测、日报、驾驶舱调用。

库存周转分析

查看库存金额、周转天数、库存结构、慢动销。

库存表、库存流水、出入库表、指标快照。

供缺货预警、补货建议调用。

缺货与滞销分析

查看低库存、缺货风险、滞销商品。

库存、安全库存、销售历史、预警事件。

供补货建议、促销建议调用。

配送履约分析

查看准时率、线路、司机、签收异常。

配送单、线路、司机、签收记录。

供履约预警、运营报表调用。

财务毛利分析

查看收入、成本、毛利率、低毛利商品。

订单金额、采购成本、财务收付款、指标快照。

供毛利异常、财务报表调用。

供应商履约分析

查看交付准时率、质量、价格稳定性。

采购、入库、质检、供应商档案。

供供应商评分和采购建议调用。

质检溯源分析

查看批次、质检报告、溯源码、供应商来源。

质检报告、溯源批次、溯源码、入库/销售绑定。

供质检预警、溯源报告调用。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

指标分类

新增/修改采购、销售、库存、财务等分类。

指标分类表。

供指标定义选择分类。

指标定义

定义销售额、毛利率、缺货率等指标。

指标定义表、数据资产。

供SQL、任务、分析、预警、报表调用。

指标口径维护

维护公式、统计周期、过滤条件、口径说明。

指标定义、口径版本。

确保各模块口径统一。

指标取数SQL

编写和测试指标SQL，发布生效。

指标SQL表、数据资产、字段语义。

供指标计算任务执行。

指标计算任务

手动或定时执行指标计算，失败可重试。

指标任务、指标SQL。

产出指标快照。

指标快照

查看每个周期、维度的指标结果。

指标结果表。

供驾驶舱、分析、预警、报表、预测调用。

指标看板配置

配置指标卡片、图表、布局、可见范围。

看板配置、指标定义。

供驾驶舱和分析页面展示。

指标权限配置

按角色、机构、业务域配置可见指标。

指标权限、角色、用户。

控制问数、报表、看板可见范围。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

预警规则

新增/修改规则，配置指标、阈值、等级、范围、启停。

预警规则、指标快照。

生成预警事件。

预警事件

查看、认领、处理、关闭、忽略、升级事件。

预警事件、处理日志。

同步待办、消息、报表。

缺货预警

查看库存低于安全库存的商品。

库存指标、预警事件。

供补货建议调用。

临期预警

查看临近保质期商品。

批次、库存、预警事件。

供促销、调拨、报表调用。

采购价异常

查看采购价上涨、异常波动商品。

采购价格、指标快照、预警事件。

供采购分析和采购建议。

毛利异常

查看低毛利、负毛利、毛利波动。

销售、成本、毛利指标、预警事件。

供财务毛利分析。

损耗异常

查看报损、损耗率异常商品。

库存损耗、报损单、指标快照。

供库存分析和报表。

推送策略

配置预警接收人、渠道、频率、静默时间。

推送策略、用户、角色。

供预警事件推送。

推送记录

查看推送成功失败，失败可重试。

推送记录、消息表。

供消息中心追踪。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

报表模板

新增/修改日报、周报、月报、专项报告模板。

报表模板、指标定义、提示词模板。

供报表任务调用。

AI日报

生成/查看每日经营日报。

指标快照、预警事件、报表任务、模型调用。

供工作台和订阅推送。

AI周报

生成/查看每周汇总报告。

指标快照、预警事件、经营分析。

供管理层复盘。

AI月报

生成/查看月度经营分析。

指标快照、预警、预测建议。

供管理层决策。

专项分析报告

按主题生成采购、库存、毛利等专项报告。

经营分析、指标、预警、模型配置。

供业务负责人。

报表任务

创建、执行、停止、重试报表生成任务。

报表任务、模板。

产出生成记录。

报表生成记录

查看生成状态、失败原因、内容摘要。

报表生成记录、模型日志。

供导出下载和审计。

报表导出下载

下载Word/PDF/Excel等文件。

报表文件、权限、水印配置。

供用户下载和归档。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

销量预测

按商品、客户、门店、周期预测销量。

销售历史、库存、节假日/周期、预测结果。

供补货、采购建议。

补货建议

查看建议补货商品、数量、原因。

销量预测、当前库存、安全库存、在途采购。

供采购模块或采购申请。

库存优化

查看高库存、低库存、周转异常和优化建议。

库存、销售、周转指标。

供调拨和促销。

采购建议

根据预测、库存、供应商交期生成采购建议。

预测结果、库存、供应商、采购价格。

供采购申请。

调拨建议

根据不同仓/门店库存生成调拨建议。

仓库库存、门店库存、销量预测。

供调拨单。

供应商评分

按价格、质量、交付、履约评分。

采购、入库、质检、履约数据。

供采购选择供应商。

经营建议闭环

采纳/拒绝AI建议，关联业务动作。

经营建议、预警、预测、报表。

供效果评估。

采纳效果评估

查看建议采纳后的改善效果和ROI。

建议动作、后续业务结果、指标快照。

供管理复盘。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

数据资产管理

登记真实业务表，配置业务域、可用范围。

真实业务表、数据资产表。

供问数、指标SQL、RAG。

知识库管理

维护业务知识库分类、状态、权限。

知识库主表、文档表。

供文档和RAG。

文档管理

上传、解析、发布操作手册、SOP、规则文档。

知识库文档。

供分段向量检索。

分段向量检索

查看文档分段、向量索引和召回结果。

知识库分段向量。

供RAG测试和AI回答。

业务术语库

维护术语、别名、同义词、解释。

业务术语表。

供问数意图识别。

表字段语义

维护字段含义、中文名、敏感级别、指标/维度属性。

字段语义表。

供问数SQL和指标SQL。

业务表映射

维护主表、明细表、客户、商品等表关系。

业务映射表。

供问数和指标取数。

问数样例库

维护标准问法、参考SQL、推荐图表。

问数模板表。

供AI智能问数。

RAG检索测试

输入问题测试知识召回、重排和答案。

知识分段、模型配置、测试日志。

供知识库调优。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

API密钥配置

维护供应商API Key，测试连接，轮换密钥。

API密钥表。

供所有模型调用。

大模型配置

维护模型编码、供应商、上下文长度、价格、状态。

模型配置表。

供场景路由。

模型场景路由

配置问数、报表、RAG、预测等场景使用哪个模型。

场景路由、模型配置。

供所有AI调用。

模型参数方案

配置temperature、topP、maxTokens、超时、重试。

参数方案表。

供模型调用。

助手角色配置

定义助手角色、系统提示词、工具权限、场景。

助手角色表、提示词模板。

供问数/报表/建议。

提示词模板

维护模板内容、变量、版本、调试、发布、回滚。

提示词模板和版本。

供模型调用。

工具函数配置

维护AI可调用的后端工具、参数Schema、权限码。

工具函数表、工具调用日志。

供AI工具调用。

调用额度配置

配置用户/角色/机构/场景日限额、月限额、成本上限。

额度配置、模型调用日志。

供成本控制。

敏感词与脱敏

配置输入过滤、输出脱敏、敏感字段规则。

敏感规则。

供问数、报表、模型输出安全。

菜单

用户/系统怎么操作

数据从哪里来

输出给谁调用

模型调用日志

查询每次模型调用的场景、模型、Token、成本、耗时、状态。

模型调用日志。

供成本统计、异常监控。

问数日志

查询用户问题、意图、SQL、结果摘要、反馈。

问数日志、SQL审计。

供问数追溯。

工具调用日志

查询AI工具调用参数、结果、耗时、异常。

工具调用日志。

供异常定位。

生成SQL审计

审核AI生成SQL，拦截危险SQL。

SQL审计日志、数据资产、字段权限。

供AI智能问数。

成本与Token统计

按模型、用户、场景、日期统计成本。

模型调用日志、成本汇总。

供管理层和运维。

异常调用监控

查看模型超时、额度不足、SQL拒绝、工具失败。

异常日志。

供运维处理。

操作日志

查看配置变更、预警处理、报表生成等操作。

操作日志、字段级日志。

供审计追责。

菜单授权

按角色配置AI助手菜单和按钮权限。

sys_menu、sys_role_menu。

供权限控制。

多语言菜单维护

维护菜单、按钮、表头、提示语的多语言资源。

i18n_resource、i18n_resource_lang。

供多语言显示。

页面类型

开发要求

典型菜单

CRUD配置类

需要新增、修改、删除/作废、启停、详情、导出。

指标分类、指标定义、预警规则、推送策略、报表模板、数据资产、知识库、字段语义、模型配置、提示词模板、菜单授权、多语言菜单维护。

查询统计类

主要查询、图表、导出、下钻，不做新增修改删除。

AI经营驾驶舱、经营分析、指标快照、AI预警概览、AI日报、销量预测、供应商评分、成本与Token统计。

任务类

任务列表、手动执行、停止、失败重试、执行日志。

指标计算任务、报表任务、文档解析任务。

审计日志类

只查、详情、导出、链路追踪，不允许删除原始日志。

模型调用日志、问数日志、工具调用日志、操作日志、生成SQL审计。

特殊动作类

必须按业务流程开发，不能只做表单。

AI智能问数、预警事件处理、RAG检索测试、补货建议、采购建议、调拨建议、经营建议闭环。

验收闭环

必须跑通的流程

通过标准

闭环1：数据资产到问数

数据资产→字段语义→业务映射→问数样例→AI智能问数→SQL审计→问数日志。

能用自然语言查真实数据，非法SQL被拦截。

闭环2：指标计算到快照

指标定义→口径→SQL→任务→快照。

指标快照落库，经营分析、预警、报表能复用。

闭环3：预警处理

指标快照→预警规则→预警事件→推送→待办→关闭。

预警能触发、推送、处理、留痕。

闭环4：报表生成

模板→任务→指标/预警/分析→模型生成→记录→文件→推送。

日报/周报/月报能生成和下载。

闭环5：预测建议

销量预测→补货/采购/调拨建议→采纳→业务动作→效果评估。

建议有依据，可采纳，可评估。

闭环6：模型治理

密钥→模型→场景路由→提示词→调用日志→成本统计→异常监控。

模型调用可控、可追踪、可统计。

闭环7：权限与多语言

菜单授权→按钮权限→接口权限→多语言资源。

无权限不可操作，多语言显示正确。