Gemini 预览提取
在 市场情报 页输入文本，选择 Gemini 或 按后端配置，点击 预览提取。托管环境会调用 Gemini，但不会写入数据库。
gemini_complete
persisted=false
事件候选
01 · 快速开始
登录、切换、退出
托管环境默认不再直接进入“托管只读访客”。用户先选择一个业务角色，系统再按该角色读取数据、遮蔽敏感字段，并进入最相关的业务页面。
打开应用
访问 旭阳煤焦价差 AI 决策中枢，首先看到角色选择页。该页面是演示入口，不会触发任何写入。
选择业务角色
点击角色卡片，例如“财务风控”会进入 预测探索，“销售负责人”会进入 订单毛利，“合同法务”会进入 合同风险。
查看角色相关信息
页面会使用 actor 上下文读取数据。托管环境允许角色化读取，但所有写入仍被 Cloud Run 生产保护拦截。
退出并返回角色页
点击右上角 退出，清空当前角色，返回角色选择页，可重新选择另一个视角。
02 · 角色视角
每个角色看到什么
角色用于演示真实企业权限下的数据范围、默认入口和敏感字段遮蔽。它不是生产 SSO，但服务边界已经预留生产 IAM/SSO 适配器。
| 角色 | 默认入口 | 重点信息 | 典型动作 |
|---|---|---|---|
| 集团管理层 集团全部数据 |
煤焦价差驾驶舱 | 价差健康度、风险订单、决策包、执行闭环。 | 审阅今日建议，进入价格委员会决策包。 |
| 基地负责人 河北基地 |
库存敞口 | 基地库存、采购建议、执行任务。 | 查看库存跌价敞口与基地执行节奏。 |
| 采购负责人 集团采购 |
采购建议 | 煤种、供应商、目标价格、采购窗口。 | 比较建议采购量和价格窗口。 |
| 销售负责人 重点客户 |
订单毛利 | 客户订单、毛利、最差情景、复核状态。 | 识别低毛利订单，提交价委会复核。 |
| 合同法务 合同库 |
合同风险 | 条款解析、调价机制、人工校验队列。 | 校验价格条款、补差机制和履约风险。 |
| 财务风控 集团全部数据 |
预测探索 | 价差预测、模型拟合、事件入模、风控解释。 | 预览市场事件，分析价差与订单毛利风险。 |
| 系统管理员 系统全域 |
数据源 / 模型版本 | 数据源、模型注册表、权限矩阵、阈值规则。 | 检查集成状态、治理策略和模型状态。 |
03 · 市场情报
从市场文本到 forecast-impact events
市场情报页把晨会纪要、新闻、研报和政策事件转化为可解释的预测事件候选，并与煤焦价差、焦煤价格、焦炭价格和订单毛利风险关联。
正式生成情报
本地演示环境可点击 生成情报，系统会持久化 AI brief，并创建待复核事件。Cloud Run 托管环境会阻止写入，这是生产安全护栏。
needs_review
审计链路
本地可写
04 · 预测探索
模型拟合、事件特征和经营解释
预测探索页展示 Sunshine 自有 forecasting 能力，不依赖参考 forecast repo 运行。当前包含可解释 baseline、模型拟合练习、特征快照和事件入模复核。
预测目标
覆盖焦煤价格、焦炭价格、钢材需求因子、煤焦价差、库存价格风险和订单毛利风险。
预测周期
支持 7、30、90 天。页面展示预测值、上下界、置信度、驱动因子和模型状态。
模型拟合练习
/api/model-fitting-exercise 返回本地拟合、holdout 指标、候选模型和事件特征使用情况。
最佳实践
先查看基础预测，再查看事件候选是否已被人工批准。未批准事件不会进入拟合特征，避免把未验证传闻直接放入生产预测。
05 · 经营风险
订单、合同、库存、采购协同查看
风险页面把预测结果连接到经营对象，帮助团队从“价差变化”进一步看到“订单亏损、合同条款、库存跌价和采购窗口”。
订单毛利
查看销售价格、配煤成本、加工物流、资金成本、预期毛利和最差情景。销售角色可以看到客户相关信息，受限角色会看到字段遮蔽。
合同风险
聚焦调价机制、固定价条款、人工校验状态和条款风险。适合法务角色检查合同文本与价格联动条款。
库存敞口
追踪未锁价库存、市场价格、跌价敞口和基地范围。基地负责人默认进入该页。
采购建议
展示煤种、供应商、建议量、目标价和时机窗口，帮助采购在价格压力变化时调整节奏。
06 · 决策包
价格委员会从信号到行动
价格委员会决策包把预测、订单、合同、库存、预警和执行任务组合成一份可审阅材料。
从驾驶舱进入决策包
管理层可从首页的今日经营建议进入决策包，查看高风险订单、合同条款和库存敞口。
运行情景推演
选择煤价和焦价变化，系统更新受影响的订单、库存和合同风险，为会议讨论准备量化视角。
形成执行任务
批准后进入执行追踪。托管环境展示流程；本地环境可演示写入和审计记录。
07 · 治理与只读
为什么托管环境可选角色但仍然安全
Cloud Run 托管环境允许 GET 请求携带演示角色上下文，用于展示角色化读取、遮蔽和过滤。所有 POST、PATCH、DELETE 仍被服务端阻止。
读路径
例如 /api/orders?actor=sales.lead 会按销售角色返回可见字段，敏感数据由 MCPServices 进行遮蔽。
写路径
托管环境的写请求返回 403，提示本地 demo mutations 在非 localhost 环境禁用。
LLM Secret
GEMINI_API_KEY 通过 Cloud Run Secret 注入，仅服务端使用；浏览器不会看到密钥。
审计与适配器
MCPServices 是 HTTP、MCP 工具和未来 ERP/SRM/MES/市场数据接入的统一服务边界。
08 · 演示脚本
推荐 8 分钟 walkthrough
适合面向业务方、管理层或技术评审进行一次端到端演示。
第 1 分钟：角色登录
打开应用，说明托管只读与角色化读取。选择“财务风控”。
第 2-3 分钟：预测探索
展示煤焦价差 30 天预测、置信区间、模型拟合练习和事件特征。
第 4 分钟：市场情报 Gemini
进入市场情报，点击 预览提取，说明 Gemini 返回 forecast-impact events 且托管不持久化。
第 5-6 分钟：经营风险联动
切换销售、法务、基地或采购角色，查看对应订单、合同、库存、采购页面。
第 7 分钟：决策包
展示价格委员会决策包如何聚合预测、风险对象和执行任务。
第 8 分钟：治理说明
打开系统页，说明数据源、模型版本、权限矩阵、审计和 Cloud Run 只读保护。
09 · 常见问题
演示时最容易问到的问题
为什么托管环境不能保存？
这是刻意设计。公开托管环境用于安全演示，只允许读和 Gemini 预览；写入请在 localhost 或受控企业环境启用。
Gemini 会不会替代本地模型？
不会。Gemini 用于市场文本理解和事件抽取；数值预测、拟合练习和特征治理属于 Sunshine 自有 ML 能力。
历史数据如何接入？
当前本地接口支持批量导入历史观测，未来生产环境通过 EnterpriseDataAdapter 接 ERP、SRM、MES、市场行情和数据仓库。
怎样判断事件能否入模？
事件需要有方向、影响分、置信度、目标和来源证据。默认进入复核队列，人工批准后才作为事件特征用于拟合。