集团管理层
关注驾驶舱、决策包、决策历史和工作流队列，完成上会审阅和审批。
快速开始
把 Sunshine 当作每日经营驾驶舱使用。
先看驾驶舱，再检查预测和治理队列，处理各角色负责的风险动作，最后生成价格委员会 决策包。当前本地演示使用 SQLite 种子数据，但浏览器、HTTP API 和 MCP 工具都已经 通过同一个服务层访问数据。
- 查看价差压力。 打开驾驶舱，确认今日价差、开放预警、高风险订单、合同条款和库存敞口。
- 校验预测驱动。 对比 7 天、30 天、90 天预测周期，先判断趋势，再决定是否触发价格动作。
- 处理治理任务。 从工作流队列进入订单复核、合同校验、预警处理、执行追踪和数据质量整改。
- 形成决策包。 生成、编辑、审批并归档价格委员会材料，让关键结论进入审计历史。
角色路径
按岗位进入对应工作流。
本地版本内置企业角色，用于演示权限控制、敏感字段脱敏、站点范围过滤和任务归属。 正式生产环境应接入企业 SSO/IAM。
财务/风控
监控毛利风险、更新预警、运行情景推演、导入预测结果并准备上会输入。
销售人员
导入销售订单，复核订单毛利，查看客户敞口，并推动调价或补充条款。
合同/法务
解析合同文本，校验价格条款，修正抽取结果，并退役过期条款风险。
采购人员
查看采购建议，把库存风险、价格信号和锁价策略转化为采购执行动作。
系统管理员
管理用户、数据源、阈值规则、模型版本和本地适配器/生产连接器就绪度。
日常流程
从市场信号到可审计决策。
识别市场信号
查看价格连接器、来源覆盖、价差状态和当前开放风险预警。
验证预测判断
按目标和周期查看煤价、焦价、钢材因子、煤焦价差、库存风险和订单风险。
定位业务对象
进入订单、合同、库存和采购模块，确认受影响客户、基地、条款和敞口。
执行治理动作
更新复核状态，校验合同条款，处理预警，分派执行任务，并保留审计记录。
输出上会材料
生成决策包，完善建议口径，审批或归档，并在决策历史中沉淀结果。
功能模块
每个页面解决什么问题。
煤焦价差驾驶舱
面向管理层的一分钟经营视图，聚合价差压力、风险订单、合同风险、库存敞口和采购建议。
- 在摘要型、数据密集型、视觉重点型视图之间切换。
- 打开 AI Copilot 生成页面上下文草稿。
- 从驾驶舱快速跳转到决策包或风险模块。
市场情报
展示市场价格、来源覆盖、预测信号和企业背景情报。
- 通过 MCPServices 刷新外部公司情报。
- 检查价格来源、置信度和连接器就绪度。
- 把价格卡片作为情景推演和订单复核依据。
预测探索
围绕 Sunshine 自研 ML/LLM 的目标、周期、区间和驱动因子做经营判断。
- 查看预测值、上下界、置信度和驱动因子。
- 导入带模型版本信息的新预测结果。
- 退役过期预测，同时保留审计历史。
订单毛利
对销售订单进行预期毛利、风险毛利和最差情景毛利复核。
- 导入订单并自动计算毛利指标。
- 筛选高风险订单并更新审批状态。
- 打开客户画像和基地画像抽屉查看背景。
合同风险
解析合同文本，识别价格条款、触发条件和建议动作。
- 解析新增合同文本并生成条款列表。
- 人工校验、编辑或退役合同价格条款。
- 在上会前确认条款风险和补充动作。
库存与采购
管理库存价格敞口、锁量情况、风险评级和采购建议。
- 导入库存敞口记录和市场价格。
- 复核采购建议和执行状态。
- 把库存风险连接到后续执行任务。
预警与执行追踪
把风险预警和执行任务变成可分派、可跟踪、可关闭的经营动作。
- 创建、确认、解决或退役风险预警。
- 给执行任务设置负责人、截止日期和状态。
- 用工作流队列按优先级推进事项。
系统配置
管理数据源、阈值规则、模型回测、用户权限、审计事件和数据质量报告。
- 识别本地 adapter 与生产连接器差距。
- 维护角色权限和本地演示用户。
- 查看审计事件和数据质量检查。
API 与 MCP
浏览器、HTTP API、MCP 工具共用同一服务边界。
浏览器调用 HTTP API，MCP Server 暴露工具和资源。两条路径都进入
MCPServices，再由本地 SQLite adapter 或未来生产 adapter 读取和写入数据。
npm.cmd run dev
# 或
python -m sunshine.server$env:SUNSHINE_DB_PATH='C:\tmp\sunshine.sqlite'
npm.cmd run devGET /api/health
GET /api/dashboard?actor=risk.finance
GET /api/workflow-queue?actor=risk.financenpm.cmd run mcp
tools: sunshine_dashboard,
sunshine_list_orders,
sunshine_create_decision_pack常见任务
从哪里开始，做到什么结果。
| 任务 | 入口 | 动作 | 结果 |
|---|---|---|---|
| 排查订单毛利压力 | 驾驶舱 / 订单毛利 | 打开高风险订单，复核价格、成本、交付和最差情景假设。 | 审批状态更新，并生成审计事件。 |
| 校验合同价格条款 | 合同风险 | 解析合同文本，校验抽取条款，修正触发条件和建议动作。 | 条款进入已校验状态，降低上会歧义。 |
| 检查库存价格敞口 | 库存敞口 | 导入库存记录，对比单位成本、市场价格和已锁订单量。 | 形成风险评级和建议动作。 |
| 准备价格委员会材料 | 价格委员会决策包 | 生成决策包，编辑建议口径，审批或归档。 | 形成可追溯的决策包和历史记录。 |
| 评估生产接入准备度 | 系统配置 | 检查数据源、模型版本、质量报告和本地 adapter 状态。 | 输出生产连接器差距清单。 |
生产治理
从本地演示走向生产前，需要补齐这些边界。
Sunshine 已经把应用访问集中在服务层，但当前版本仍是本地演示形态：用户、权限和 SQLite 数据均为开发适配器。共享部署前，应接入企业 IAM、生产数据连接器和正式审计策略。
身份与权限
本地演示通过请求中的 actor 展示角色效果。生产环境应由服务端会话、
SSO 或 IAM 解析真实身份，不能信任客户端传入的角色或用户名。
敏感数据脱敏
订单、合同和库存已经演示角色脱敏。生产前还应统一覆盖画像、用户列表、健康检查、 MCP 资源和所有导出面。
连接器迁移
将本地市场、合同、ERP、SRM、MES 和工作流数据替换为生产 adapter。HTTP 路由和
MCP 工具保持稳定，只替换 EnterpriseDataAdapter 后端实现。
审计与留痕
写入动作会生成审计事件。生产环境需明确审计保留周期、审批证据、操作者身份、 数据来源和异常处理策略。
开始使用
进入决策中枢，从今日煤焦价差开始。
这份中文指南可用于演示讲解、团队培训、业务试点和生产迁移规划。