升鲜宝AI助手开发功能详尽说明书
包含：功能模块说明、模块关联、业务流程、前后端开发约束、E-R图、数据库表结构字段说明
文档版本：V1.0 适用系统：升鲜宝供应链系统 模块定位：AI助手为升鲜宝系统一级菜单，不是独立系统。
一、文档目标与建设原则
本说明书用于指导升鲜宝AI助手模块的产品设计、前后端开发、数据库建设、接口联调、测试验收与后续扩展。AI助手围绕供应链业务中的采购、销售、库存、配送、财务、供应商、质检溯源等数据，构建可配置、可追踪、可审计的智能分析体系。
• AI助手只作为升鲜宝供应链系统的一级功能菜单，不单独做系统、用户、角色、组织。
• 前端目录使用 views/ai，接口目录建议使用 src/api/ai，不再创建 views/aiassistant。
• 后端接口建议统一以 /ai/** 或 /aiassistant/** 作为根路径，项目如已使用 /ai，则继续保持。
• 所有AI分析能力必须依赖数据资产、字段语义、指标口径、权限和审计，不允许大模型直接访问数据库。
• 自然语言问数生成SQL必须只允许SELECT，并通过表白名单、字段权限、行数限制、安全审计。
二、AI助手完整功能菜单
|--------|----------|--------------|
| 序号 | 二级模块 | 三级功能页面 |
| 1 | 智能工作台 | AI经营驾驶舱 |
| 2 | 智能工作台 | 今日异常待办 |
| 3 | 智能工作台 | AI智能问数 |
| 4 | 智能工作台 | AI经营日报 |
| 5 | 智能工作台 | AI预警概览 |
| 6 | 智能工作台 | 常用问题收藏 |
| 7 | 智能工作台 | 我的订阅推送 |
| 8 | 智能工作台 | 消息中心（建议补齐） |
| 9 | 经营分析 | 采购分析 |
| 10 | 经营分析 | 销售订单分析 |
| 11 | 经营分析 | 库存周转分析 |
| 12 | 经营分析 | 缺货与滞销分析 |
| 13 | 经营分析 | 配送履约分析 |
| 14 | 经营分析 | 财务毛利分析 |
| 15 | 经营分析 | 供应商履约分析 |
| 16 | 经营分析 | 质检溯源分析 |
| 17 | 指标中心 | 指标分类 |
| 18 | 指标中心 | 指标定义 |
| 19 | 指标中心 | 指标口径维护 |
| 20 | 指标中心 | 指标取数SQL |
| 21 | 指标中心 | 指标计算任务（建议补齐） |
| 22 | 指标中心 | 指标快照 |
| 23 | 指标中心 | 指标看板配置 |
| 24 | 指标中心 | 指标权限配置 |
| 25 | 预警中心 | 预警规则 |
| 26 | 预警中心 | 预警事件 |
| 27 | 预警中心 | 缺货预警 |
| 28 | 预警中心 | 临期预警 |
| 29 | 预警中心 | 采购价异常 |
| 30 | 预警中心 | 毛利异常 |
| 31 | 预警中心 | 损耗异常 |
| 32 | 预警中心 | 推送策略 |
| 33 | 预警中心 | 推送记录（建议补齐） |
| 34 | 报表中心 | 报表模板 |
| 35 | 报表中心 | AI日报 |
| 36 | 报表中心 | AI周报 |
| 37 | 报表中心 | AI月报 |
| 38 | 报表中心 | 专项分析报告 |
| 39 | 报表中心 | 报表任务 |
| 40 | 报表中心 | 报表生成记录 |
| 41 | 报表中心 | 报表导出下载 |
| 42 | 预测决策 | 销量预测 |
| 43 | 预测决策 | 补货建议 |
| 44 | 预测决策 | 库存优化 |
| 45 | 预测决策 | 采购建议 |
| 46 | 预测决策 | 调拨建议 |
| 47 | 预测决策 | 供应商评分 |
| 48 | 预测决策 | 经营建议闭环 |
| 49 | 预测决策 | 采纳效果评估 |
| 50 | 知识库与语义 | 数据资产管理（建议补齐） |
| 51 | 知识库与语义 | 知识库管理 |
| 52 | 知识库与语义 | 文档管理 |
| 53 | 知识库与语义 | 分段向量检索 |
| 54 | 知识库与语义 | 业务术语库 |
| 55 | 知识库与语义 | 表字段语义 |
| 56 | 知识库与语义 | 业务表映射 |
| 57 | 知识库与语义 | 问数样例库 |
| 58 | 知识库与语义 | RAG检索测试 |
| 59 | 模型配置 | API密钥配置 |
| 60 | 模型配置 | 大模型配置 |
| 61 | 模型配置 | 模型场景路由（建议补齐） |
| 62 | 模型配置 | 模型参数方案 |
| 63 | 模型配置 | 助手角色配置 |
| 64 | 模型配置 | 提示词模板 |
| 65 | 模型配置 | 工具函数配置 |
| 66 | 模型配置 | 调用额度配置 |
| 67 | 模型配置 | 敏感词与脱敏 |
| 68 | 审计与权限 | 模型调用日志 |
| 69 | 审计与权限 | 问数日志 |
| 70 | 审计与权限 | 工具调用日志 |
| 71 | 审计与权限 | 生成SQL审计 |
| 72 | 审计与权限 | 成本与Token统计 |
| 73 | 审计与权限 | 异常调用监控 |
| 74 | 审计与权限 | 操作日志（建议补齐） |
| 75 | 审计与权限 | 菜单授权（建议恢复） |
| 76 | 审计与权限 | 多语言菜单维护 |
三、各模块职责与上下游关系
|--------|----------------------------------------------|-----------------------------|---------------------------|
| 模块 | 模块作用 | 上游输入 | 下游输出 |
| 智能工作台 | 统一入口和经营总览，展示驾驶舱、待办、问数、日报、预警、订阅、消息。 | 消费指标快照、预警事件、报表记录、预测建议、消息推送。 | 用户日常工作台、待办处理、问数入口。 |
| 经营分析 | 围绕采购、销售、库存、配送、财务、供应商、质检溯源进行多维分析。 | 消费指标结果、业务源数据、数据资产语义。 | 输出异常线索、分析结论，供预警和报表使用。 |
| 指标中心 | 统一指标分类、定义、口径、SQL、计算任务、快照、看板与权限。 | 上游为数据资产与字段语义。 | 下游支撑经营分析、预警、报表、预测。 |
| 预警中心 | 配置预警规则、生成预警事件、处理缺货/临期/价格/毛利/损耗异常并推送。 | 上游为指标快照、业务明细和规则配置。 | 下游为消息中心、今日异常待办、经营建议。 |
| 报表中心 | 按模板和任务生成AI日报、周报、月报、专项分析报告，并提供导出下载。 | 上游为指标、预警事件、提示词模板和模型。 | 下游为订阅推送、消息中心、经营复盘。 |
| 预测决策 | 基于历史指标、业务数据、模型算法输出销量预测、补货、采购、调拨、供应商评分和建议闭环。 | 上游为指标快照、业务数据、模型路由。 | 下游为经营建议闭环和采纳效果评估。 |
| 知识库与语义 | 维护知识库、文档、分段向量、术语、字段语义、业务映射和问数样例。 | 上游为业务文档、真实表结构、术语和样例。 | 下游支撑AI问数、RAG、报表解释和指标口径解释。 |
| 模型配置 | 配置API密钥、大模型、场景路由、参数方案、角色、提示词、工具、额度、脱敏规则。 | 上游为模型供应商、密钥和业务场景。 | 下游为所有AI调用场景。 |
| 审计与权限 | 记录模型调用、问数、工具调用、生成SQL、成本Token、异常调用、操作日志和菜单授权。 | 上游为所有功能操作和模型调用。 | 下游为风控、审计、权限治理和成本优化。 |
四、功能与数据库的核心调用关系
• 数据资产管理 → 表字段语义 → 业务表映射 → 问数样例库 → AI智能问数 → 生成SQL审计 → 问数日志 → 模型调用日志。
• 数据资产管理 → 指标分类 → 指标定义 → 指标口径维护 → 指标取数SQL → 指标计算任务 → 指标快照 → 经营分析页面。
• 指标快照 → 预警规则 → 预警事件 → 推送策略 → 推送记录 → 消息中心 → 今日异常待办。
• 指标快照 → 报表模板 → 报表任务 → 报表生成记录 → 报表导出下载 → 我的订阅推送 → 消息中心。
• 指标快照 → 销量预测 → 补货建议/库存优化/采购建议/调拨建议 → 供应商评分 → 经营建议闭环 → 采纳效果评估。
• API密钥配置 → 大模型配置 → 模型场景路由 → 模型参数方案 → 助手角色配置 → 提示词模板 → 工具函数配置 → 业务功能调用 → 模型调用日志 → 成本与Token统计 → 异常调用监控。
五、E-R 图与核心流程图
01_模块关联总览图
02_数据库ER总览图
03_核心业务闭环流程图
04_智能问数RAG模型流程图
六、前后端开发落地结构
6.1 前端目录
根据现有上传源码，AI前端目录为 views/ai，后续不得新建 views/aiassistant。
|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 模块 | 前端页面路径/组件 |
| 智能工作台 | views/ai/aiworkbenchdashboard.vue、aiworkbenchtodo.vue、aichatnlq.vue、aireportdaily.vue、aiwarningoverview.vue、aiquestionfavorites.vue、aisubscriptionpush.vue |
| 经营分析 | views/ai/aianalysispurchase.vue、aianalysissales.vue、aianalysisinventory.vue、aianalysisstockrisk.vue、aianalysisdelivery.vue、aianalysisgrossprofit.vue、aianalysissupplier.vue、aianalysisqualitytrace.vue |
| 指标中心 | views/ai/aimetriccategory.vue、aimetricdefinition.vue、aimetriccaliber.vue、aimetricsql.vue、aimetricsnapshot.vue、aimetricdashboard.vue、aimetricpermission.vue |
| 预警中心 | views/ai/aiwarningrulemanage.vue、aiwarningeventmanage.vue、aiwarningstockout.vue、aiwarningexpiry.vue、aiwarningpurchaseprice.vue、aiwarninggrossprofit.vue、aiwarningloss.vue、aiwarningpushstrategy.vue |
| 报表中心 | views/ai/aireporttemplate.vue、aireportdaily.vue、aireportweekly.vue、aireportmonthly.vue、aireportspecial.vue、aireporttaskmanage.vue、aireportrecord.vue、aireportexport.vue |
| 预测决策 | views/ai/aiforecastsales.vue、aiforecastreplenishment.vue、aiforecastinventory.vue、aiforecastpurchase.vue、aiforecasttransfer.vue、aidecisionsupplierscore.vue、aidecisionclosedloop.vue、aidecisioneffect.vue |
| 知识库与语义 | views/ai/aiknowledgebase.vue、aiknowledgedocumentmanage.vue、aiknowledgesegmentmanage.vue、aisemanticterm.vue、aisemanticfield.vue、aibusinesstablemap.vue、aiquestionsample.vue、airagtest.vue |
| 模型配置 | views/ai/aiconfigapikey.vue、aiconfigmodel.vue、aiconfigmodelparam.vue、aiconfigrole.vue、aiconfigprompt.vue、aiconfigtool.vue、aiconfigquota.vue、aiconfigsecurity.vue |
| 审计与权限 | views/ai/aiauditmodelcall.vue、aiauditnlq.vue、aiaudittoolcall.vue、aiauditsql.vue、aiaudittokencost.vue、aiauditerror.vue、aii18nmenu.vue、建议补 operation-log 和 menu-auth |
6.2 后端服务建议
|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 业务域 | 后端服务建议 |
| 模型配置 | AiModelService、AiApiKeyService、AiPromptTemplateService、AiModelSceneRouteService、AiModelCallService |
| 知识库与语义 | AiKnowledgeService、AiKnowledgeDocumentService、AiKnowledgeSegmentService、AiScmDataAssetService、AiScmFieldSemanticService、AiScmBusinessMappingService、AiRagSearchService |
| 指标中心 | AiScmMetricCategoryService、AiScmMetricService、AiScmMetricSqlService、AiScmMetricCalcTaskService、AiScmMetricResultService、AiScmDashboardService |
| 预警中心 | AiScmWarningRuleService、AiScmWarningEventService、AiScmPushStrategyService、AiScmPushLogService、AiScmMessageService |
| 报表中心 | AiScmReportTemplateService、AiScmReportTaskService、AiScmReportGenerateService、AiScmReportExportService |
| 预测决策 | AiScmForecastService、AiScmRecommendationService、AiScmRecommendationActionService、AiScmRecommendationEffectService |
| 智能问数 | AiScmNlqService、AiSqlGenerateService、AiSqlAuditService、AiDataQueryService |
| 审计与权限 | AiScmModelCallLogService、AiScmNlqLogService、AiScmOperationLogService、AiCostStatService、AiPermissionService |
七、AI助手数据库表分域说明
|--------|--------------------------------------------------------------------------------------------------------------------------------------------------|
| 分域 | 数据库表 |
| 模型与会话 | ai_api_key、ai_model、ai_prompt_template、ai_chat_conversation、ai_chat_message、ai_model_scene_route |
| 知识库与语义 | 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_metric_category、ai_scm_metric、ai_scm_metric_sql、ai_scm_metric_calc_task、ai_scm_metric_result、ai_scm_dashboard |
| 预警与消息 | ai_scm_warning_rule、ai_scm_warning_event、ai_scm_push_strategy、ai_scm_push_log、ai_scm_message、ai_scm_subscription |
| 报表与预测 | ai_scm_report_template、ai_scm_report_task、ai_scm_forecast_result、ai_scm_recommendation、ai_scm_recommendation_action、ai_scm_recommendation_effect |
| 审计与日志 | ai_scm_nlq_log、ai_scm_model_call_log、ai_scm_operation_log |
八、数据库表之间的主要关系
|-------------------------|--------|-----------------------------------------------------------------------------------|-----------------------------|
| 主表 | 关系 | 从表 | 说明 |
| ai_api_key | 1:N | ai_model | 一个API密钥可供多个模型配置复用。 |
| ai_model | 1:N | ai_chat_message / ai_scm_model_call_log / ai_scm_nlq_log / ai_scm_forecast_result | 记录消息、调用日志、问数日志、预测结果的实际模型来源。 |
| ai_prompt_template | 1:N | ai_scm_report_template / ai_model_scene_route | 报表模板和场景路由可引用提示词模板。 |
| ai_chat_conversation | 1:N | ai_chat_message | 一次会话下有多条消息。 |
| ai_knowledge | 1:N | ai_knowledge_document | 一个知识库包含多份文档。 |
| ai_knowledge_document | 1:N | ai_knowledge_segment | 文档解析后切分为多个知识片段。 |
| ai_scm_data_asset | 1:N | ai_scm_field_semantic / ai_scm_metric | 数据资产支撑字段语义和指标取数。 |
| ai_scm_metric_category | 1:N | ai_scm_metric | 指标分类下挂多个指标。 |
| ai_scm_metric | 1:N | ai_scm_metric_sql / ai_scm_metric_result / ai_scm_warning_rule | 指标可配置SQL、生成快照、驱动预警。 |
| ai_scm_metric_calc_task | N:1 | ai_scm_metric | 指标任务按周期计算某个指标。 |
| ai_scm_warning_rule | 1:N | ai_scm_warning_event | 预警规则触发多个预警事件。 |
| ai_scm_push_strategy | 1:N | ai_scm_warning_rule / ai_scm_push_log | 预警规则引用推送策略，推送执行产生推送记录。 |
| ai_scm_report_template | 1:N | ai_scm_report_task | 报表模板派生多个生成任务。 |
| ai_scm_warning_event | 1:N | ai_scm_recommendation | 预警事件可生成经营建议。 |
| ai_scm_recommendation | 1:N | ai_scm_recommendation_action / ai_scm_recommendation_effect | 建议执行和效果评估形成闭环。 |
| ai_scm_nlq_template | 1:N | ai_scm_nlq_log | 问数样例被复用后形成问数日志。 |
九、数据库表结构字段说明
以下为AI助手核心表结构字段级数据字典。现有表来自升鲜宝AI助手建表SQL，建议新增表用于补齐链路。
9.1 ai_api_key
表说明：AI模型API密钥配置表
|--------|----------------|---------------|--------|---------|---------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | key_name | varchar(100) | 否 | | 密钥名称 |
| 3 | provider_code | varchar(50) | 否 | | 模型服务商编码，如 openai/deepseek/qwen |
| 4 | provider_name | varchar(100) | 是 | NULL | 模型服务商名称 |
| 5 | api_key_cipher | varchar(1000) | 否 | | 加密后的API Key密文 |
| 6 | api_key_mask | varchar(100) | 是 | NULL | 脱敏展示Key，如 sk-****abcd |
| 7 | endpoint_url | varchar(500) | 是 | NULL | 接口地址 |
| 8 | env_type | tinyint | 否 | 1 | 环境类型 1生产 2测试 3备用 |
| 9 | scope_json | json | 是 | NULL | 授权范围JSON，如chat/embedding/rerank |
| 10 | expire_date | bigint | 是 | NULL | 过期时间 |
| 11 | quota_limit | bigint | 是 | NULL | 调用额度上限 |
| 12 | quota_used | bigint | 否 | 0 | 已使用调用量 |
| 13 | last_test_date | bigint | 是 | NULL | 最近测试时间 |
| 14 | secret_version | varchar(50) | 是 | NULL | 密钥版本号 |
| 15 | sort_code | int | 否 | '1' | 排序码 |
| 16 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 17 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 18 | creator | bigint | 否 | '0' | 创建人id |
| 19 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 20 | updater | bigint | 否 | '0' | 修改人id |
| 21 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 22 | remark | varchar(255) | 是 | NULL | 备注 |
| 23 | dept_id | bigint | 是 | '0' | 机构id |
9.2 ai_model
表说明：AI大模型配置表
|--------|-------------------|---------------|--------|----------|--------------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | model_name | varchar(100) | 否 | | 模型名称 |
| 3 | model_code | varchar(100) | 否 | | 模型编码 |
| 4 | provider_code | varchar(50) | 否 | | 模型服务商编码 |
| 5 | api_key_id | bigint | 是 | NULL | 关联 ai_api_key.id |
| 6 | model_type | tinyint | 否 | 1 | 模型类型 1聊天 2推理 3Embedding 4Rerank 5多模态 |
| 7 | endpoint_url | varchar(500) | 是 | NULL | 模型接口地址，可覆盖密钥接口 |
| 8 | context_length | int | 是 | NULL | 上下文长度 |
| 9 | max_output_tokens | int | 是 | 4096 | 最大输出Token |
| 10 | temperature | decimal(6,3) | 是 | 0.700 | 默认温度 |
| 11 | top_p | decimal(6,3) | 是 | 0.900 | TopP参数 |
| 12 | frequency_penalty | decimal(6,3) | 是 | 0.000 | 频率惩罚 |
| 13 | presence_penalty | decimal(6,3) | 是 | 0.000 | 存在惩罚 |
| 14 | cost_input_1k | decimal(18,6) | 是 | 0.000000 | 输入千Token成本 |
| 15 | cost_output_1k | decimal(18,6) | 是 | 0.000000 | 输出千Token成本 |
| 16 | default_flag | int | 否 | 0 | 是否默认模型 0否1是 |
| 17 | fallback_order | int | 否 | 0 | 降级顺序 |
| 18 | sort_code | int | 否 | '1' | 排序码 |
| 19 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 20 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 21 | creator | bigint | 否 | '0' | 创建人id |
| 22 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 23 | updater | bigint | 否 | '0' | 修改人id |
| 24 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 25 | remark | varchar(255) | 是 | NULL | 备注 |
| 26 | dept_id | bigint | 是 | '0' | 机构id |
9.3 ai_prompt_template
表说明：AI提示词模板表
|--------|----------------------|--------------|--------|---------|-------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | prompt_code | varchar(100) | 否 | | 提示词编码 |
| 3 | prompt_name | varchar(150) | 否 | | 提示词名称 |
| 4 | scene_code | varchar(100) | 否 | | 业务场景编码 |
| 5 | model_type | tinyint | 否 | 1 | 适用模型类型 |
| 6 | language_code | varchar(20) | 是 | zh-CN | 语言编码 |
| 7 | system_prompt | text | 是 | NULL | 系统提示词 |
| 8 | user_prompt_template | mediumtext | 是 | NULL | 用户提示词模板 |
| 9 | output_schema | json | 是 | NULL | 输出JSON Schema |
| 10 | version_no | varchar(30) | 否 | v1.0 | 版本号 |
| 11 | publish_state | tinyint | 否 | 0 | 发布状态 0草稿 1已发布 2停用 |
| 12 | last_publish_date | bigint | 是 | NULL | 最近发布时间 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.4 ai_chat_conversation
表说明：AI对话会话表
|--------|--------------------|--------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | conversation_code | varchar(64) | 否 | | 会话编号 |
| 3 | conversation_title | varchar(200) | 是 | NULL | 会话标题 |
| 4 | user_id | bigint | 否 | 0 | 用户ID |
| 5 | scene_code | varchar(100) | 是 | NULL | 业务场景编码 |
| 6 | source_module | varchar(100) | 是 | NULL | 来源模块 |
| 7 | language_code | varchar(20) | 是 | zh-CN | 语言编码 |
| 8 | context_json | json | 是 | NULL | 会话上下文 |
| 9 | last_message_date | bigint | 是 | NULL | 最近消息时间 |
| 10 | message_count | int | 否 | 0 | 消息数量 |
| 11 | conversation_state | tinyint | 否 | 1 | 会话状态 1进行中 2归档 |
| 12 | sort_code | int | 否 | '1' | 排序码 |
| 13 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | '0' | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | '0' | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | '0' | 机构id |
9.5 ai_chat_message
表说明：AI对话消息表
|--------|-----------------|---------------|--------|----------|---------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | conversation_id | bigint | 否 | | 会话ID |
| 3 | message_role | varchar(20) | 否 | | 消息角色 system/user/assistant/tool |
| 4 | message_content | mediumtext | 否 | | 消息内容 |
| 5 | reference_json | json | 是 | NULL | 引用来源JSON |
| 6 | model_id | bigint | 是 | NULL | 模型ID |
| 7 | input_tokens | int | 否 | 0 | 输入Token |
| 8 | output_tokens | int | 否 | 0 | 输出Token |
| 9 | cost_amount | decimal(18,6) | 否 | 0.000000 | 模型调用成本 |
| 10 | safe_state | tinyint | 否 | 1 | 安全状态 1通过 2拦截 3需审核 |
| 11 | message_state | tinyint | 否 | 1 | 消息状态 1正常 2撤回 3失败 |
| 12 | sort_code | int | 否 | '1' | 排序码 |
| 13 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | '0' | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | '0' | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | '0' | 机构id |
9.6 ai_knowledge
表说明：AI知识库表
|--------|--------------------|--------------|--------|---------|-------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | knowledge_code | varchar(64) | 否 | | 知识库编码 |
| 3 | knowledge_name | varchar(150) | 否 | | 知识库名称 |
| 4 | knowledge_type | tinyint | 否 | 1 | 类型 1文档库 2问答库 3业务规则库 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | language_code | varchar(20) | 是 | zh-CN | 语言编码 |
| 7 | embedding_model_id | bigint | 是 | NULL | Embedding模型ID |
| 8 | rerank_model_id | bigint | 是 | NULL | Rerank模型ID |
| 9 | document_count | int | 否 | 0 | 文档数量 |
| 10 | segment_count | int | 否 | 0 | 分段数量 |
| 11 | vector_count | int | 否 | 0 | 向量数量 |
| 12 | sync_state | tinyint | 否 | 0 | 同步状态 0未同步 1同步中 2已同步 3失败 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.7 ai_knowledge_document
表说明：AI知识库文档表
|--------|---------------|--------------|--------|---------|-------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | knowledge_id | bigint | 否 | | 知识库ID |
| 3 | document_code | varchar(64) | 否 | | 文档编号 |
| 4 | document_name | varchar(255) | 否 | | 文档名称 |
| 5 | file_type | varchar(30) | 是 | NULL | 文件类型 PDF/DOCX/XLSX/TXT等 |
| 6 | file_url | varchar(500) | 是 | NULL | 文件地址 |
| 7 | file_size | bigint | 是 | NULL | 文件大小 |
| 8 | parse_state | tinyint | 否 | 0 | 解析状态 0待解析 1成功 2失败 |
| 9 | chunk_state | tinyint | 否 | 0 | 切分状态 0待切分 1成功 2失败 |
| 10 | index_state | tinyint | 否 | 0 | 索引状态 0待索引 1成功 2失败 |
| 11 | page_count | int | 否 | 0 | 页数 |
| 12 | segment_count | int | 否 | 0 | 分段数 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.8 ai_knowledge_segment
表说明：AI知识库分段向量表
|--------|--------------------|--------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | knowledge_id | bigint | 否 | | 知识库ID |
| 3 | document_id | bigint | 否 | | 文档ID |
| 4 | segment_code | varchar(64) | 否 | | 分段编号 |
| 5 | segment_no | int | 否 | 0 | 分段序号 |
| 6 | segment_title | varchar(255) | 是 | NULL | 分段标题 |
| 7 | segment_content | mediumtext | 否 | | 分段内容 |
| 8 | content_hash | varchar(64) | 是 | NULL | 内容Hash |
| 9 | vector_id | varchar(128) | 是 | NULL | 向量库ID |
| 10 | embedding_model_id | bigint | 是 | NULL | Embedding模型ID |
| 11 | token_count | int | 否 | 0 | Token数量 |
| 12 | page_no | int | 是 | NULL | 页码 |
| 13 | source_position | varchar(255) | 是 | NULL | 来源位置描述 |
| 14 | sort_code | int | 否 | '1' | 排序码 |
| 15 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 16 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 17 | creator | bigint | 否 | '0' | 创建人id |
| 18 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 19 | updater | bigint | 否 | '0' | 修改人id |
| 20 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 21 | remark | varchar(255) | 是 | NULL | 备注 |
| 22 | dept_id | bigint | 是 | '0' | 机构id |
9.9 ai_scm_data_asset
表说明：AI供应链数据资产表
|--------|-----------------|--------------|--------|---------|-----------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | asset_code | varchar(64) | 否 | | 资产编码 |
| 3 | asset_name | varchar(150) | 否 | | 资产名称 |
| 4 | source_system | varchar(100) | 否 | | 来源系统 |
| 5 | source_table | varchar(100) | 否 | | 来源表名 |
| 6 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 7 | data_level | tinyint | 否 | 1 | 数据级别 1明细 2汇总 3主数据 4配置 |
| 8 | sensitive_level | tinyint | 否 | 1 | 敏感级别 1普通 2内部 3敏感 4高敏 |
| 9 | refresh_type | tinyint | 否 | 1 | 刷新方式 1实时 2定时 3手动 |
| 10 | refresh_cron | varchar(100) | 是 | NULL | 刷新cron |
| 11 | owner_user_id | bigint | 是 | NULL | 数据负责人 |
| 12 | asset_state | tinyint | 否 | 1 | 资产状态 1正常 2异常 3停用 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.10 ai_scm_field_semantic
表说明：AI字段语义映射表
|--------|------------------|--------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | asset_id | bigint | 否 | | 数据资产ID |
| 3 | table_name | varchar(100) | 否 | | 表名 |
| 4 | field_name | varchar(100) | 否 | | 字段名 |
| 5 | field_title | varchar(100) | 否 | | 字段中文名 |
| 6 | field_type | varchar(100) | 是 | NULL | 字段类型 |
| 7 | business_meaning | varchar(500) | 是 | NULL | 业务含义 |
| 8 | semantic_tags | varchar(500) | 是 | NULL | 语义标签 |
| 9 | metric_flag | int | 否 | 0 | 是否可作为指标 0否1是 |
| 10 | dimension_flag | int | 否 | 0 | 是否可作为维度 0否1是 |
| 11 | filter_flag | int | 否 | 0 | 是否可过滤 |
| 12 | sensitive_flag | int | 否 | 0 | 是否敏感字段 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.11 ai_scm_business_mapping
表说明：AI业务映射树表
|--------|-------------------|--------------|--------|---------|---------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | parent_id | bigint | 否 | 0 | 父节点ID |
| 3 | mapping_code | varchar(100) | 否 | | 映射编码 |
| 4 | mapping_name | varchar(150) | 否 | | 映射名称 |
| 5 | mapping_type | tinyint | 否 | 1 | 类型 1业务域 2实体 3字段 4指标 5关系 |
| 6 | source_object | varchar(150) | 是 | NULL | 来源对象 |
| 7 | target_object | varchar(150) | 是 | NULL | 目标对象 |
| 8 | relation_type | varchar(50) | 是 | NULL | 关系类型 belong/include/join/metric |
| 9 | mapping_rule_json | json | 是 | NULL | 映射规则JSON |
| 10 | sort_code | int | 否 | '1' | 排序码 |
| 11 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 12 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 13 | creator | bigint | 否 | '0' | 创建人id |
| 14 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 15 | updater | bigint | 否 | '0' | 修改人id |
| 16 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 17 | remark | varchar(255) | 是 | NULL | 备注 |
| 18 | dept_id | bigint | 是 | '0' | 机构id |
9.12 ai_scm_metric_category
表说明：AI指标分类表
|--------|-----------------|--------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | parent_id | bigint | 否 | 0 | 父分类ID |
| 3 | category_code | varchar(64) | 否 | | 分类编码 |
| 4 | category_name | varchar(100) | 否 | | 分类名称 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | category_level | int | 否 | 1 | 分类层级 |
| 7 | category_path | varchar(500) | 是 | NULL | 分类路径 |
| 8 | sort_code | int | 否 | '1' | 排序码 |
| 9 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 10 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 11 | creator | bigint | 否 | '0' | 创建人id |
| 12 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 13 | updater | bigint | 否 | '0' | 修改人id |
| 14 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 15 | remark | varchar(255) | 是 | NULL | 备注 |
| 16 | dept_id | bigint | 是 | '0' | 机构id |
9.13 ai_scm_metric
表说明：AI指标定义表
|--------|-----------------|---------------|--------|---------|------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | metric_code | varchar(100) | 否 | | 指标编码 |
| 3 | metric_name | varchar(150) | 否 | | 指标名称 |
| 4 | category_id | bigint | 是 | NULL | 指标分类ID |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | metric_type | tinyint | 否 | 1 | 指标类型 1基础 2计算 3比率 4排名 |
| 7 | unit_name | varchar(50) | 是 | NULL | 单位 |
| 8 | decimal_places | int | 否 | 2 | 小数位 |
| 9 | stat_cycle | varchar(30) | 是 | day | 统计周期 day/week/month/realtime |
| 10 | source_asset_id | bigint | 是 | NULL | 来源数据资产ID |
| 11 | dimension_json | json | 是 | NULL | 可用维度JSON |
| 12 | formula_desc | varchar(1000) | 是 | NULL | 中文计算口径 |
| 13 | warning_flag | int | 否 | 0 | 是否支持预警 |
| 14 | sort_code | int | 否 | '1' | 排序码 |
| 15 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 16 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 17 | creator | bigint | 否 | '0' | 创建人id |
| 18 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 19 | updater | bigint | 否 | '0' | 修改人id |
| 20 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 21 | remark | varchar(255) | 是 | NULL | 备注 |
| 22 | dept_id | bigint | 是 | '0' | 机构id |
9.14 ai_scm_metric_sql
表说明：AI指标SQL配置表
|--------|------------------|--------------|--------|---------|-------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | metric_id | bigint | 否 | | 指标ID |
| 3 | sql_version | varchar(30) | 否 | v1.0 | SQL版本 |
| 4 | data_source_code | varchar(100) | 是 | NULL | 数据源编码 |
| 5 | sql_text | mediumtext | 否 | | 指标SQL |
| 6 | param_json | json | 是 | NULL | 参数定义JSON |
| 7 | test_state | tinyint | 否 | 0 | 测试状态 0未测 1成功 2失败 |
| 8 | last_test_date | bigint | 是 | NULL | 最近测试时间 |
| 9 | publish_state | tinyint | 否 | 0 | 发布状态 0草稿 1已发布 2停用 |
| 10 | sort_code | int | 否 | '1' | 排序码 |
| 11 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 12 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 13 | creator | bigint | 否 | '0' | 创建人id |
| 14 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 15 | updater | bigint | 否 | '0' | 修改人id |
| 16 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 17 | remark | varchar(255) | 是 | NULL | 备注 |
| 18 | dept_id | bigint | 是 | '0' | 机构id |
9.15 ai_scm_metric_result
表说明：AI指标结果表
|--------|-------------------|---------------|--------|---------|------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | metric_id | bigint | 否 | | 指标ID |
| 3 | metric_code | varchar(100) | 否 | | 指标编码 |
| 4 | stat_date | varchar(20) | 否 | | 统计日期 |
| 5 | stat_cycle | varchar(30) | 否 | day | 统计周期 |
| 6 | dimension_key | varchar(200) | 是 | NULL | 维度Key |
| 7 | dimension_name | varchar(200) | 是 | NULL | 维度名称 |
| 8 | metric_value | decimal(24,6) | 是 | NULL | 指标值 |
| 9 | metric_value_text | varchar(255) | 是 | NULL | 指标文本值 |
| 10 | yoy_value | decimal(18,6) | 是 | NULL | 同比 |
| 11 | mom_value | decimal(18,6) | 是 | NULL | 环比 |
| 12 | calc_state | tinyint | 否 | 1 | 计算状态 1成功 2失败 3预警 |
| 13 | calc_date | bigint | 是 | NULL | 计算时间 |
| 14 | sort_code | int | 否 | '1' | 排序码 |
| 15 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 16 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 17 | creator | bigint | 否 | '0' | 创建人id |
| 18 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 19 | updater | bigint | 否 | '0' | 修改人id |
| 20 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 21 | remark | varchar(255) | 是 | NULL | 备注 |
| 22 | dept_id | bigint | 是 | '0' | 机构id |
9.16 ai_scm_dashboard
表说明：AI看板配置表
|--------|-----------------|--------------|--------|---------|------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | dashboard_code | varchar(64) | 否 | | 看板编码 |
| 3 | dashboard_name | varchar(150) | 否 | | 看板名称 |
| 4 | dashboard_type | tinyint | 否 | 1 | 类型 1经营 2销售 3采购 4库存 5财务 |
| 5 | layout_json | json | 是 | NULL | 布局配置JSON |
| 6 | component_json | json | 是 | NULL | 组件配置JSON |
| 7 | visibility_json | json | 是 | NULL | 可见范围JSON |
| 8 | publish_state | tinyint | 否 | 0 | 发布状态 0草稿 1已发布 2下线 |
| 9 | sort_code | int | 否 | '1' | 排序码 |
| 10 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 11 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 12 | creator | bigint | 否 | '0' | 创建人id |
| 13 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 14 | updater | bigint | 否 | '0' | 修改人id |
| 15 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 16 | remark | varchar(255) | 是 | NULL | 备注 |
| 17 | dept_id | bigint | 是 | '0' | 机构id |
9.17 ai_scm_report_template
表说明：AI报表模板表
|--------|--------------------|--------------|--------|----------|----------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | template_code | varchar(64) | 否 | | 模板编码 |
| 3 | template_name | varchar(150) | 否 | | 模板名称 |
| 4 | report_type | tinyint | 否 | 1 | 报表类型 1日报 2周报 3月报 4专题 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | metric_json | json | 是 | NULL | 指标配置JSON |
| 7 | section_json | json | 是 | NULL | 章节配置JSON |
| 8 | prompt_template_id | bigint | 是 | NULL | 提示词模板ID |
| 9 | output_format | varchar(50) | 是 | docx,pdf | 输出格式 |
| 10 | publish_state | tinyint | 否 | 0 | 发布状态 |
| 11 | sort_code | int | 否 | '1' | 排序码 |
| 12 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 13 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 14 | creator | bigint | 否 | '0' | 创建人id |
| 15 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 16 | updater | bigint | 否 | '0' | 修改人id |
| 17 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 18 | remark | varchar(255) | 是 | NULL | 备注 |
| 19 | dept_id | bigint | 是 | '0' | 机构id |
9.18 ai_scm_report_task
表说明：AI报表生成任务表
|--------|-------------|---------------|--------|---------|------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | task_code | varchar(64) | 否 | | 任务编号 |
| 3 | template_id | bigint | 否 | | 模板ID |
| 4 | report_name | varchar(200) | 否 | | 报表名称 |
| 5 | report_date | varchar(20) | 是 | NULL | 报表日期 |
| 6 | task_type | tinyint | 否 | 1 | 任务类型 1手动 2定时 |
| 7 | task_state | tinyint | 否 | 0 | 任务状态 0待执行 1执行中 2成功 3失败 |
| 8 | start_date | bigint | 是 | NULL | 开始时间 |
| 9 | finish_date | bigint | 是 | NULL | 结束时间 |
| 10 | file_url | varchar(500) | 是 | NULL | 报表文件地址 |
| 11 | error_msg | varchar(1000) | 是 | NULL | 失败原因 |
| 12 | sort_code | int | 否 | '1' | 排序码 |
| 13 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | '0' | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | '0' | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | '0' | 机构id |
9.19 ai_scm_warning_rule
表说明：AI预警规则表
|--------|------------------|--------------|--------|---------|-------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | rule_code | varchar(64) | 否 | | 规则编码 |
| 3 | rule_name | varchar(150) | 否 | | 规则名称 |
| 4 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 5 | metric_id | bigint | 是 | NULL | 关联指标ID |
| 6 | warning_level | tinyint | 否 | 2 | 预警级别 1低 2中 3高 4紧急 |
| 7 | trigger_type | tinyint | 否 | 1 | 触发方式 1阈值 2环比 3同比 4规则表达式 |
| 8 | condition_json | json | 否 | | 触发条件JSON |
| 9 | scope_json | json | 是 | NULL | 生效范围JSON |
| 10 | push_strategy_id | bigint | 是 | NULL | 推送策略ID |
| 11 | rule_state | tinyint | 否 | 1 | 规则状态 1启用 2停用 |
| 12 | sort_code | int | 否 | '1' | 排序码 |
| 13 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | '0' | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | '0' | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | '0' | 机构id |
9.20 ai_scm_warning_event
表说明：AI预警事件表
|--------|---------------------|---------------|--------|---------|-----------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | event_code | varchar(64) | 否 | | 事件编号 |
| 3 | rule_id | bigint | 否 | | 规则ID |
| 4 | event_title | varchar(200) | 否 | | 事件标题 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | warning_level | tinyint | 否 | 2 | 预警级别 |
| 7 | trigger_value | varchar(100) | 是 | NULL | 触发值 |
| 8 | threshold_value | varchar(100) | 是 | NULL | 阈值 |
| 9 | related_bill_code | varchar(100) | 是 | NULL | 关联单据号 |
| 10 | related_object_json | json | 是 | NULL | 关联对象JSON |
| 11 | event_state | tinyint | 否 | 0 | 事件状态 0未处理 1处理中 2已处理 3忽略 4关闭 |
| 12 | handler_id | bigint | 是 | NULL | 处理人ID |
| 13 | handle_date | bigint | 是 | NULL | 处理时间 |
| 14 | handle_result | varchar(1000) | 是 | NULL | 处理结果 |
| 15 | sort_code | int | 否 | '1' | 排序码 |
| 16 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 17 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 18 | creator | bigint | 否 | '0' | 创建人id |
| 19 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 20 | updater | bigint | 否 | '0' | 修改人id |
| 21 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 22 | remark | varchar(255) | 是 | NULL | 备注 |
| 23 | dept_id | bigint | 是 | '0' | 机构id |
9.21 ai_scm_push_strategy
表说明：AI消息推送策略表
|--------|----------------|--------------|--------|---------|-----------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | strategy_code | varchar(64) | 否 | | 策略编码 |
| 3 | strategy_name | varchar(150) | 否 | | 策略名称 |
| 4 | message_type | tinyint | 否 | 1 | 消息类型 1预警 2报表 3订阅 4系统 |
| 5 | channel_json | json | 否 | | 渠道JSON 站内信/短信/邮件/企业微信 |
| 6 | receiver_json | json | 否 | | 接收人JSON |
| 7 | trigger_mode | tinyint | 否 | 1 | 触发模式 1实时 2定时 3汇总 |
| 8 | cron_expr | varchar(100) | 是 | NULL | 定时表达式 |
| 9 | quiet_period | varchar(100) | 是 | NULL | 免打扰时段 |
| 10 | strategy_state | tinyint | 否 | 1 | 策略状态 1启用 2停用 |
| 11 | sort_code | int | 否 | '1' | 排序码 |
| 12 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 13 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 14 | creator | bigint | 否 | '0' | 创建人id |
| 15 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 16 | updater | bigint | 否 | '0' | 修改人id |
| 17 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 18 | remark | varchar(255) | 是 | NULL | 备注 |
| 19 | dept_id | bigint | 是 | '0' | 机构id |
9.22 ai_scm_message
表说明：AI助手消息中心表
|--------|-----------------|--------------|--------|---------|------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | message_code | varchar(64) | 否 | | 消息编号 |
| 3 | message_title | varchar(200) | 否 | | 消息标题 |
| 4 | message_type | tinyint | 否 | 1 | 消息类型 1系统 2AI快报 3预警 4报表 |
| 5 | message_content | mediumtext | 是 | NULL | 消息内容 |
| 6 | receiver_id | bigint | 否 | 0 | 接收人ID |
| 7 | read_flag | int | 否 | 0 | 已读标记 0未读 1已读 |
| 8 | read_date | bigint | 是 | NULL | 阅读时间 |
| 9 | source_id | bigint | 是 | NULL | 来源业务ID |
| 10 | source_type | varchar(100) | 是 | NULL | 来源类型 |
| 11 | sort_code | int | 否 | '1' | 排序码 |
| 12 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 13 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 14 | creator | bigint | 否 | '0' | 创建人id |
| 15 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 16 | updater | bigint | 否 | '0' | 修改人id |
| 17 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 18 | remark | varchar(255) | 是 | NULL | 备注 |
| 19 | dept_id | bigint | 是 | '0' | 机构id |
9.23 ai_scm_subscription
表说明：AI用户订阅配置表
|--------|--------------------|--------------|--------|---------|----------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | subscription_code | varchar(64) | 否 | | 订阅编号 |
| 3 | user_id | bigint | 否 | | 用户ID |
| 4 | subscription_name | varchar(150) | 否 | | 订阅名称 |
| 5 | subscription_type | tinyint | 否 | 1 | 订阅类型 1报表 2预警 3问数 4快报 |
| 6 | target_id | bigint | 是 | NULL | 订阅对象ID |
| 7 | channel_json | json | 是 | NULL | 接收渠道JSON |
| 8 | cron_expr | varchar(100) | 是 | NULL | 推送频率 |
| 9 | subscription_state | tinyint | 否 | 1 | 订阅状态 1启用 2停用 |
| 10 | sort_code | int | 否 | '1' | 排序码 |
| 11 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 12 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 13 | creator | bigint | 否 | '0' | 创建人id |
| 14 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 15 | updater | bigint | 否 | '0' | 修改人id |
| 16 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 17 | remark | varchar(255) | 是 | NULL | 备注 |
| 18 | dept_id | bigint | 是 | '0' | 机构id |
9.24 ai_scm_nlq_template
表说明：AI常用问数模板表
|--------|-----------------|---------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | question_code | varchar(64) | 否 | | 问题编码 |
| 3 | question_title | varchar(200) | 否 | | 问题标题 |
| 4 | question_text | varchar(1000) | 否 | | 自然语言问题模板 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | param_json | json | 是 | NULL | 参数JSON |
| 7 | permission_code | varchar(100) | 是 | NULL | 所需权限编码 |
| 8 | use_count | int | 否 | 0 | 使用次数 |
| 9 | sort_code | int | 否 | '1' | 排序码 |
| 10 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 11 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 12 | creator | bigint | 否 | '0' | 创建人id |
| 13 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 14 | updater | bigint | 否 | '0' | 修改人id |
| 15 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 16 | remark | varchar(255) | 是 | NULL | 备注 |
| 17 | dept_id | bigint | 是 | '0' | 机构id |
9.25 ai_scm_nlq_log
表说明：AI自然语言问数日志表
|--------|-----------------|---------------|--------|---------|---------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | log_code | varchar(64) | 否 | | 日志编号 |
| 3 | user_id | bigint | 否 | 0 | 用户ID |
| 4 | question_text | varchar(2000) | 否 | | 用户问题 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | generated_sql | mediumtext | 是 | NULL | 生成SQL |
| 7 | sql_safe_state | tinyint | 否 | 0 | SQL安全状态 0待审 1通过 2拦截 |
| 8 | execute_state | tinyint | 否 | 0 | 执行状态 0未执行 1成功 2失败 |
| 9 | result_summary | mediumtext | 是 | NULL | 结果摘要 |
| 10 | elapsed_ms | int | 是 | NULL | 总耗时毫秒 |
| 11 | model_id | bigint | 是 | NULL | 模型ID |
| 12 | sort_code | int | 否 | '1' | 排序码 |
| 13 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | '0' | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | '0' | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | '0' | 机构id |
9.26 ai_scm_forecast_result
表说明：AI预测结果表
|--------|--------------------|---------------|--------|---------|--------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | forecast_code | varchar(64) | 否 | | 预测编号 |
| 3 | forecast_type | tinyint | 否 | 1 | 预测类型 1销量 2库存 3采购 4缺货 5毛利 |
| 4 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 5 | target_object_type | varchar(100) | 是 | NULL | 预测对象类型 |
| 6 | target_object_id | bigint | 是 | NULL | 预测对象ID |
| 7 | forecast_period | varchar(50) | 是 | NULL | 预测周期 |
| 8 | forecast_value | decimal(24,6) | 是 | NULL | 预测值 |
| 9 | confidence_score | decimal(8,4) | 是 | NULL | 置信度 |
| 10 | model_id | bigint | 是 | NULL | 模型ID |
| 11 | feature_json | json | 是 | NULL | 特征JSON |
| 12 | forecast_date | bigint | 是 | NULL | 预测时间 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.27 ai_scm_recommendation
表说明：AI经营建议表
|--------|-------------------|---------------|--------|---------|-------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | recommend_code | varchar(64) | 否 | | 建议编号 |
| 3 | recommend_title | varchar(200) | 否 | | 建议标题 |
| 4 | recommend_type | tinyint | 否 | 1 | 建议类型 1补货 2调价 3促销 4配送 5供应商 6风控 |
| 5 | business_domain | varchar(100) | 是 | NULL | 业务域 |
| 6 | related_event_id | bigint | 是 | NULL | 关联预警事件ID |
| 7 | recommend_content | mediumtext | 否 | | 建议内容 |
| 8 | expected_effect | varchar(1000) | 是 | NULL | 预期效果 |
| 9 | priority_level | tinyint | 否 | 2 | 优先级 1低 2中 3高 4紧急 |
| 10 | adopt_state | tinyint | 否 | 0 | 采纳状态 0待确认 1已采纳 2已拒绝 3已执行 |
| 11 | adopt_user_id | bigint | 是 | NULL | 采纳人ID |
| 12 | adopt_date | bigint | 是 | NULL | 采纳时间 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.28 ai_scm_model_call_log
表说明：AI模型调用日志表
|--------|---------------|---------------|--------|----------|------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | call_code | varchar(64) | 否 | | 调用编号 |
| 3 | model_id | bigint | 是 | NULL | 模型ID |
| 4 | provider_code | varchar(50) | 是 | NULL | 服务商编码 |
| 5 | scene_code | varchar(100) | 是 | NULL | 场景编码 |
| 6 | request_id | varchar(100) | 是 | NULL | 外部请求ID |
| 7 | user_id | bigint | 是 | NULL | 用户ID |
| 8 | input_tokens | int | 否 | 0 | 输入Token |
| 9 | output_tokens | int | 否 | 0 | 输出Token |
| 10 | elapsed_ms | int | 是 | NULL | 耗时毫秒 |
| 11 | cost_amount | decimal(18,6) | 否 | 0.000000 | 成本金额 |
| 12 | call_state | tinyint | 否 | 1 | 调用状态 1成功 2失败 3超时 |
| 13 | error_msg | varchar(1000) | 是 | NULL | 错误信息 |
| 14 | sort_code | int | 否 | '1' | 排序码 |
| 15 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 16 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 17 | creator | bigint | 否 | '0' | 创建人id |
| 18 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 19 | updater | bigint | 否 | '0' | 修改人id |
| 20 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 21 | remark | varchar(255) | 是 | NULL | 备注 |
| 22 | dept_id | bigint | 是 | '0' | 机构id |
9.29 ai_scm_operation_log
表说明：AI助手操作日志表
|--------|-------------------|---------------|--------|---------|---------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | log_code | varchar(64) | 否 | | 日志编号 |
| 3 | user_id | bigint | 否 | 0 | 操作人ID |
| 4 | user_name | varchar(100) | 是 | NULL | 操作人名称 |
| 5 | operation_module | varchar(100) | 否 | | 操作模块 |
| 6 | operation_type | varchar(50) | 否 | | 操作类型 |
| 7 | operation_content | varchar(1000) | 是 | NULL | 操作内容 |
| 8 | business_id | bigint | 是 | NULL | 业务ID |
| 9 | business_code | varchar(100) | 是 | NULL | 业务编号 |
| 10 | ip_address | varchar(100) | 是 | NULL | IP地址 |
| 11 | user_agent | varchar(500) | 是 | NULL | 浏览器信息 |
| 12 | operation_state | tinyint | 否 | 1 | 操作状态 1成功 2失败 |
| 13 | sort_code | int | 否 | '1' | 排序码 |
| 14 | del_flag | int | 否 | '0' | 删除标记 0正常 1删除 |
| 15 | enabled | int | 否 | '1' | 状态 0禁用 1正常 |
| 16 | creator | bigint | 否 | '0' | 创建人id |
| 17 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 18 | updater | bigint | 否 | '0' | 修改人id |
| 19 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 20 | remark | varchar(255) | 是 | NULL | 备注 |
| 21 | dept_id | bigint | 是 | '0' | 机构id |
9.30 ai_scm_metric_calc_task （建议新增）
表说明：AI指标计算任务表
|--------|---------------|---------------|--------|---------|----------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | task_code | varchar(64) | 否 | | 任务编码 |
| 3 | task_name | varchar(128) | 否 | | 任务名称 |
| 4 | metric_id | bigint | 否 | | 指标ID，关联 ai_scm_metric.id |
| 5 | calc_cycle | varchar(32) | 是 | NULL | 计算周期 day/week/month/hour |
| 6 | calc_cron | varchar(64) | 是 | NULL | 计算Cron表达式 |
| 7 | calc_date | varchar(32) | 是 | NULL | 统计日期 |
| 8 | task_state | int | 否 | 0 | 任务状态 0待执行 1执行中 2成功 3失败 4取消 |
| 9 | start_date | bigint | 是 | NULL | 开始时间 |
| 10 | finish_date | bigint | 是 | NULL | 完成时间 |
| 11 | success_count | int | 否 | 0 | 成功数量 |
| 12 | fail_count | int | 否 | 0 | 失败数量 |
| 13 | error_msg | varchar(1000) | 是 | NULL | 失败原因 |
| 14 | sort_code | int | 否 | 1 | 排序码 |
| 15 | del_flag | int | 否 | 0 | 删除标记 0正常 1删除 |
| 16 | enabled | int | 否 | 1 | 状态 0禁用 1正常 |
| 17 | creator | bigint | 否 | 0 | 创建人id |
| 18 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 19 | updater | bigint | 否 | 0 | 修改人id |
| 20 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 21 | remark | varchar(255) | 是 | NULL | 备注 |
| 22 | dept_id | bigint | 是 | 0 | 机构id |
9.31 ai_scm_push_log （建议新增）
表说明：AI消息推送记录表
|--------|-----------------|--------------|--------|---------|--------------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | push_code | varchar(64) | 否 | | 推送编码 |
| 3 | source_type | varchar(32) | 是 | NULL | 来源类型 warning/report/recommend/system |
| 4 | source_id | bigint | 是 | NULL | 来源业务ID |
| 5 | strategy_id | bigint | 是 | NULL | 推送策略ID，关联 ai_scm_push_strategy.id |
| 6 | receiver_id | bigint | 是 | NULL | 接收人ID |
| 7 | receiver_name | varchar(64) | 是 | NULL | 接收人名称 |
| 8 | channel_type | varchar(32) | 是 | NULL | 渠道 station/sms/email/wechat |
| 9 | message_title | varchar(200) | 是 | NULL | 消息标题 |
| 10 | message_content | text | 是 | NULL | 消息内容 |
| 11 | send_state | int | 否 | 0 | 发送状态 0待发送 1成功 2失败 |
| 12 | send_date | bigint | 是 | NULL | 发送时间 |
| 13 | read_flag | int | 否 | 0 | 是否已读 0未读 1已读 |
| 14 | read_date | bigint | 是 | NULL | 阅读时间 |
| 15 | retry_count | int | 否 | 0 | 重试次数 |
| 16 | fail_reason | varchar(500) | 是 | NULL | 失败原因 |
| 17 | sort_code | int | 否 | 1 | 排序码 |
| 18 | del_flag | int | 否 | 0 | 删除标记 0正常 1删除 |
| 19 | enabled | int | 否 | 1 | 状态 0禁用 1正常 |
| 20 | creator | bigint | 否 | 0 | 创建人id |
| 21 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 22 | updater | bigint | 否 | 0 | 修改人id |
| 23 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 24 | remark | varchar(255) | 是 | NULL | 备注 |
| 25 | dept_id | bigint | 是 | 0 | 机构id |
9.32 ai_model_scene_route （建议新增）
表说明：AI模型场景路由配置表
|--------|--------------------|--------------|--------|---------|----------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | scene_code | varchar(64) | 否 | | 场景编码 |
| 3 | scene_name | varchar(128) | 否 | | 场景名称 |
| 4 | primary_model_id | bigint | 否 | | 主模型ID，关联 ai_model.id |
| 5 | fallback_model_id | bigint | 是 | NULL | 备用模型ID |
| 6 | prompt_template_id | bigint | 是 | NULL | 提示词模板ID，关联 ai_prompt_template.id |
| 7 | param_scheme_id | bigint | 是 | NULL | 参数方案ID |
| 8 | route_state | int | 否 | 1 | 路由状态 0停用 1启用 |
| 9 | timeout_ms | int | 否 | 30000 | 超时时间毫秒 |
| 10 | max_retry_count | int | 否 | 1 | 最大重试次数 |
| 11 | sort_code | int | 否 | 1 | 排序码 |
| 12 | del_flag | int | 否 | 0 | 删除标记 0正常 1删除 |
| 13 | enabled | int | 否 | 1 | 状态 0禁用 1正常 |
| 14 | creator | bigint | 否 | 0 | 创建人id |
| 15 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 16 | updater | bigint | 否 | 0 | 修改人id |
| 17 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 18 | remark | varchar(255) | 是 | NULL | 备注 |
| 19 | dept_id | bigint | 是 | 0 | 机构id |
9.33 ai_scm_recommendation_action （建议新增）
表说明：AI经营建议执行动作表
|--------|-------------------|--------------|--------|---------|-------------------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | recommend_id | bigint | 否 | | 建议ID，关联 ai_scm_recommendation.id |
| 3 | action_code | varchar(64) | 否 | | 执行动作编码 |
| 4 | action_type | varchar(32) | 否 | | 动作类型 adopt/reject/close/transfer/purchase |
| 5 | action_content | text | 是 | NULL | 动作内容 |
| 6 | action_user_id | bigint | 是 | NULL | 执行人ID |
| 7 | action_date | bigint | 是 | NULL | 执行时间 |
| 8 | related_bill_type | varchar(50) | 是 | NULL | 关联业务单据类型 |
| 9 | related_bill_id | bigint | 是 | NULL | 关联业务单据ID |
| 10 | related_bill_code | varchar(64) | 是 | NULL | 关联业务单号 |
| 11 | action_state | int | 否 | 0 | 动作状态 0待执行 1已执行 2失败 |
| 12 | sort_code | int | 否 | 1 | 排序码 |
| 13 | del_flag | int | 否 | 0 | 删除标记 0正常 1删除 |
| 14 | enabled | int | 否 | 1 | 状态 0禁用 1正常 |
| 15 | creator | bigint | 否 | 0 | 创建人id |
| 16 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 17 | updater | bigint | 否 | 0 | 修改人id |
| 18 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 19 | remark | varchar(255) | 是 | NULL | 备注 |
| 20 | dept_id | bigint | 是 | 0 | 机构id |
9.34 ai_scm_recommendation_effect （建议新增）
表说明：AI经营建议采纳效果评估表
|--------|--------------------|---------------|--------|---------|-------------------------------------------|
| 序号 | 字段名 | 类型 | 可空 | 默认值 | 字段说明 |
| 1 | id | bigint | 否 | | 主键ID |
| 2 | recommend_id | bigint | 否 | | 建议ID，关联 ai_scm_recommendation.id |
| 3 | action_id | bigint | 是 | NULL | 执行动作ID，关联 ai_scm_recommendation_action.id |
| 4 | effect_code | varchar(64) | 否 | | 效果评估编码 |
| 5 | before_metric_json | json | 是 | NULL | 采纳前指标快照 |
| 6 | after_metric_json | json | 是 | NULL | 采纳后指标快照 |
| 7 | effect_score | decimal(10,2) | 是 | NULL | 效果评分 |
| 8 | effect_summary | varchar(1000) | 是 | NULL | 效果总结 |
| 9 | effect_state | int | 否 | 0 | 评估状态 0待评估 1有效 2无效 3待观察 |
| 10 | evaluate_date | bigint | 是 | NULL | 评估时间 |
| 11 | sort_code | int | 否 | 1 | 排序码 |
| 12 | del_flag | int | 否 | 0 | 删除标记 0正常 1删除 |
| 13 | enabled | int | 否 | 1 | 状态 0禁用 1正常 |
| 14 | creator | bigint | 否 | 0 | 创建人id |
| 15 | create_date | bigint | 是 | NULL | 创建时间，13位毫秒时间戳 |
| 16 | updater | bigint | 否 | 0 | 修改人id |
| 17 | update_date | bigint | 是 | NULL | 修改时间，13位毫秒时间戳 |
| 18 | remark | varchar(255) | 是 | NULL | 备注 |
| 19 | dept_id | bigint | 是 | 0 | 机构id |
十、关键业务流程开发说明
10.1 AI智能问数流程
• 用户在AI智能问数输入自然语言问题。
• 系统读取业务术语库、表字段语义、业务表映射、问数样例库进行语义解析。
• 系统调用模型场景路由选择适合SQL生成的模型和提示词。
• 生成SQL后必须进入生成SQL审计，只允许SELECT，禁止写操作。
• 审计通过后执行只读查询，返回结果并调用大模型生成解释。
• 全过程记录问数日志、模型调用日志、工具调用日志和成本Token统计。
10.2 指标计算流程
• 数据资产管理登记真实业务表，并同步字段到表字段语义。
• 指标分类与指标定义维护业务指标。
• 指标口径维护定义指标业务含义，指标取数SQL维护统计SQL。
• 指标计算任务按Cron或手工触发计算。
• 计算结果写入指标快照，供分析、预警、报表、预测使用。
10.3 预警闭环流程
• 预警规则选择指标、阈值、范围、等级和推送策略。
• 定时扫描指标快照，满足条件则生成预警事件。
• 预警事件进入今日异常待办和对应主题预警页面。
• 系统根据推送策略生成推送记录和消息中心消息。
• 处理人处理并填写结果，必要时生成经营建议。
10.4 报表生成流程
• 报表模板配置章节、指标、图表和提示词模板。
• 报表任务按手工或定时触发。
• 任务读取指标快照和预警事件，调用大模型生成分析文本。
• 结果形成报表生成记录，并提供导出下载。
• 订阅用户通过消息中心或我的订阅推送接收报表。
10.5 预测决策流程
• 销量预测读取历史销量、季节性、促销、节假日、库存等特征，输出预测结果。
• 补货建议基于销量预测、当前库存、安全库存、在途数量、供应商交期计算建议补货量。
• 库存优化分析高库存、低周转、缺货、库龄，输出优化动作。
• 采购建议和调拨建议可生成建议动作，进入经营建议闭环。
• 采纳效果评估对比采纳前后指标变化，形成效果评分。
十一、安全、权限与审计要求
• API Key必须加密存储，前端只允许展示脱敏值。
• AI智能问数必须做SQL安全审计，禁止DDL/DML，限制表白名单、字段权限和返回行数。
• 财务毛利、采购价、供应商评分、成本Token、API密钥等敏感页面必须接入菜单授权和按钮权限。
• 模型调用、问数、工具调用、SQL生成、报表导出、建议采纳必须记录日志。
• 敏感字段输出必须脱敏，例如手机号、身份证、客户价格、API密钥、供应商敏感价格等。
十二、验收清单
• 菜单：AI助手作为一级菜单，9大二级模块清晰，三级页面可访问。
• 数据链路：数据资产、字段语义、业务表映射、指标、预警、报表、预测、消息、审计完整闭环。
• 前端目录：所有AI页面统一在 views/ai 下，不创建 views/aiassistant。
• 数据库：核心29张表 + 建议补齐5张表结构清晰，并包含升鲜宝通用字段。
• 接口：所有核心页面具备分页、详情、新增、修改、删除/启停、导出等基础能力。
• 安全：SQL审计、模型日志、Token成本、异常调用、操作日志均可追踪。