270 lines
20 KiB
Python
270 lines
20 KiB
Python
# ============================================================
|
||
# 门禁 Harness v1（moduleId: core-harness, 可重生 ✅）
|
||
# plan.md §3.3：所有写操作的唯一入口。M1 实现：
|
||
# - 权力分级：P0/P1 放行；P2 生成确认卡（人工批准后才执行）
|
||
# - 待确认队列：confirmId → 待执行动作（会话内存）
|
||
# - 执行/驳回均写审计（§3.6）
|
||
# ============================================================
|
||
from __future__ import annotations # 前向类型引用
|
||
|
||
import uuid # 确认卡 ID
|
||
from typing import Any, Callable # 类型标注
|
||
|
||
from server.contracts import UIAction, UIBlock # 确认卡的 UI 块契约
|
||
|
||
# 待确认动作表：confirmId → {action, params, summary, sessionId}
|
||
# M1 用模块级内存（单进程）；M2 起随会话树持久化
|
||
_pending: dict[str, dict[str, Any]] = {}
|
||
|
||
# 动作 → 权力等级 映射（封闭表：未登记的动作一律拒绝）
|
||
# ⚠ 文档同步铁律（plan.md §12.9）：改本表必同步 docs/architecture/harness.md 权力矩阵
|
||
_POWER_MAP: dict[str, str] = {
|
||
"schedule.run": "P1", # 试排：写草稿版本（沙盒语义）
|
||
"schedule.publish": "P2", # 发布：写主干世界状态 → 必须人工确认
|
||
"order.upsert": "P2", # 订单新增/编辑：写主干订单池 → 必须人工确认
|
||
"order.cancel": "P2", # 订单取消：影响后续排产输入 → 必须人工确认
|
||
"order.complete": "P2", # 订单完成：影响后续排产输入 → 必须人工确认
|
||
"order.delete": "P2", # 订单删除：物理移除订单池 → 必须人工确认
|
||
"order.clear": "P2", # 一键清空订单池 → 必须人工确认
|
||
"order.submit": "P1", # OR-03：提交审核（不写批准态）
|
||
"order.approve": "P2", # OR-03：批准进排产池
|
||
"order.reject": "P2", # OR-03：驳回
|
||
"order.pool": "P0", # OR-03：订单池摘要
|
||
"rush.evaluate": "P1", # OR-04：插单影响快评（沙盒）
|
||
"rush.apply": "P2", # OR-04：采用插单写主干+草稿排产
|
||
"forecast.query": "P0", # OR-05：预测订单只读
|
||
"forecast.upsert": "P2", # OR-05：新建/编辑预测
|
||
"forecast.delete": "P2", # OR-05：删除预测
|
||
"forecast.convert": "P2", # OR-05：预测转正为销售订单
|
||
"plan.buckets": "P0", # PL-01：时间分桶计划（只读）
|
||
"plan.rccp": "P0", # PL-02：有限/无限粗能力对照（只读）
|
||
"plan.feasibility": "P0", # PL-03：交期可行性（只读）
|
||
"plan.inventory": "P0", # PL-04：库存投影（只读）
|
||
"plan.leveling": "P0", # PL-05：产能平衡/削峰建议（只读）
|
||
"plan.supply": "P0", # PL-06：产供方向决策（只读）
|
||
"data.import": "P2", # 批量导入订单/物料：写主干 → 必须人工确认
|
||
"import.commit": "P2", # Excel/CSV 导入入库：写主干 → 必须人工确认
|
||
"flex.site.load": "P2", # 现场生产路线：替换 flex* 主数据 → 确认卡
|
||
"master.line.upsert": "P2", # 产线编辑/停启用：改后续新排产资源池 → 必须人工确认
|
||
"master.material.upsert": "P2", # 物料新建/全字段/停用：改齐套与产品池 → 必须人工确认
|
||
"master.maintenance.upsert": "P2", # 维保新增/取消：改设备避让窗口 → 必须人工确认
|
||
"master.bom.upsert": "P2", # BOM 增删改：改齐套需求与采购建议 → 必须人工确认
|
||
"master.routing.upsert": "P2", # 工艺路线/步骤：改占槽工时与外协标记 → 必须人工确认
|
||
"master.operation.upsert": "P2", # 工序库：改路线可选步骤 → 必须人工确认
|
||
"master.lineProduct.upsert": "P2", # 产线-产品绑定：改选线依据 → 必须人工确认
|
||
"master.changeover.upsert": "P2", # MD-06：换型矩阵写入 → 必须人工确认
|
||
"master.clear": "P2", # 一键清理主数据板块（回种）→ 必须人工确认
|
||
"master.query": "P0", # 自然语言检索订单/主数据（只读）
|
||
"changeover.query": "P0", # MD-06：换型矩阵只读
|
||
"campaign.preview": "P0", # SC-08：战役合并预览（只读）
|
||
"params.update": "P2", # OR-02：排产参数/客户等级权重 → 必须人工确认
|
||
"params.query": "P0", # OR-02：查看当前排产参数（只读）
|
||
"constraint.profile.query": "P0", # SC-04：约束剖面只读
|
||
"constraint.profile.save": "P2", # SC-04：约束剖面保存
|
||
"order.decompose": "P1", # 订单分解：产出采购/委外建议草稿，不碰主数据
|
||
"mrp.release": "P2", # MRP 下达：草稿建议单转正式采购/委外 → 必须人工确认
|
||
"flex.schedule": "P1", # 柔性排产：能力池+虚拟产线，只写 flex* 草稿表
|
||
"flex.reschedule": "P2", # 分级重排 L2/L3/L4：影响面大 → 确认卡
|
||
"flex.swap": "P1", # L1 局部换机：只改正目标工单
|
||
"flex.capacity": "P0", # 瓶颈产能评估：只读能力池算日产能
|
||
"flex.simulate_due": "P0", # 交期承诺模拟：深拷贝沙盒试排，不碰主干
|
||
"flex.compare": "P0", # 三模式对比：沙盒试排，不碰主干
|
||
"flex.rush": "P1", # 紧急插单：写 flexOrders + 重排草稿
|
||
"flex.fault": "P1", # 设备故障：缩池 + 可选重排
|
||
"flex.resource.patch": "P1", # 柔性资源补丁：设备状态/区域、模具寿命/锁定
|
||
"flex.conflict.resolve": "P1", # EX-03：冲突安全修复（重排类另走 P2 stage）
|
||
"conflict.list": "P0", # EX-03：冲突中心只读
|
||
"flex.adjust.preview": "P0", # EX-04：拖拽调程预览（只读校验）
|
||
"flex.adjust.commit": "P2", # EX-04：拖拽调程提交（新草稿版本）
|
||
"schedule.adjust.preview": "P0", # EX-04：固定轨调程预览
|
||
"schedule.adjust.commit": "P2", # EX-04：固定轨调程提交
|
||
"sap.status": "P0", # MD-05：SAP 连接状态（只读）
|
||
"sap.sync.inbound": "P2", # MD-05：SAP→APS 拉单/库存
|
||
"sap.sync.outbound": "P2", # MD-05：APS→SAP 开完工回写（Mock）
|
||
"mes.status": "P0", # EX-05：MES 连接状态
|
||
"mes.dispatch": "P3", # EX-05：下发车间（外部副作用）
|
||
"mes.report": "P1", # EX-09：报工回流写工单进度
|
||
|
||
"scenario.compare": "P1", # 方案对比：只写 Explore 沙盒（§5.1）
|
||
"scenario.sensitivity": "P1", # SC-06：敏感性分析沙盒 Tornado
|
||
"sop.compile": "P0", # IND-02：SOP 编译预览
|
||
"sop.apply": "P2", # IND-02：应用 SOP 规则包
|
||
"checkpoint.create": "P1", # 建档：只新增快照，不改世界
|
||
"checkpoint.rollback": "P2", # 回滚：整体替换主干世界 → 必须人工确认
|
||
"data.reset": "P2", # 重置数据：破坏性 → 必须人工确认
|
||
"knowledge.query": "P0", # 知识检索：只读（M3 §8.2）
|
||
"guidance.next": "P0", # AG-07：主动引导下一步建议（只读）
|
||
"project.create": "P1", # AG-08：新建项目（不改世界）
|
||
"project.delete": "P1", # AG-08：删项目元数据（不删世界）
|
||
"session.create": "P1", # AG-08：新建会话
|
||
"message.append": "P1", # AG-08：追加/同步会话消息
|
||
"message.replace": "P1", # AG-08：整包替换会话消息
|
||
"workspace.replace": "P1", # AG-08：整包同步工作区（迁移用）
|
||
"plan.trace": "P0", # 计划追溯：只读单据链
|
||
"report.generate": "P1", # 报告生成：产出文档并入知识库（M3 §9.10 规则3）
|
||
"viewport.*": "P0", # 视口命令：纯视图状态
|
||
"query.*": "P0", # 查询：只读
|
||
}
|
||
|
||
# 各动作的中文说明（门禁管理台"权力矩阵"页签展示用；与 _POWER_MAP 键集合一致）
|
||
_POLICY_DESC: dict[str, str] = {
|
||
"schedule.run": "试排：只产草稿版本，不动已发布主干",
|
||
"schedule.publish": "发布：写主干并推进订单状态，影响下游执行",
|
||
"order.upsert": "新增/编辑销售订单：改后续排产输入",
|
||
"order.cancel": "取消销售订单：从后续排产输入中排除",
|
||
"order.complete": "完成销售订单：从后续排产输入中排除",
|
||
"order.delete": "删除销售订单：从订单池物理移除",
|
||
"order.clear": "一键清空全部销售订单与采购/委外建议",
|
||
"order.submit": "订单提交审核：DRAFT/CHANGED → SUBMITTED",
|
||
"order.approve": "订单批准：SUBMITTED/CHANGED → APPROVED（可排产）",
|
||
"order.reject": "订单驳回：SUBMITTED/CHANGED → REJECTED",
|
||
"order.pool": "订单池摘要：待审/已批/变更计数（只读）",
|
||
"rush.evaluate": "插单快评：沙盒对比受影响订单/延迟/冲突（不改主干）",
|
||
"rush.apply": "采用插单：写急单入池并生成 DRAFT 排产版本（写前自动建档）",
|
||
"forecast.query": "预测订单查询：长周期需求台账（只读）",
|
||
"forecast.upsert": "新建/编辑预测订单（不默认进正式排产）",
|
||
"forecast.delete": "删除预测订单台账",
|
||
"forecast.convert": "预测转正为 APPROVED 销售订单",
|
||
"plan.buckets": "时间分桶计划：日/周/月/混合粗能力对照（只读）",
|
||
"plan.rccp": "有限/无限产能粗评估对照（RCCP，只读）",
|
||
"plan.feasibility": "交期可行性：累计粗能力能否按期（前置于排产）",
|
||
"plan.inventory": "库存投影：物料随时间可用量曲线（只读）",
|
||
"plan.leveling": "产能平衡/削峰：超载桶挪到空档建议（只读）",
|
||
"plan.supply": "产供方向：加班/扩线/外协结构化建议（只读）",
|
||
"data.import": "自然语言批量导入订单或物料主数据",
|
||
"import.commit": "Excel/CSV 导入入库（校验通过行写入主干）",
|
||
"flex.site.load": "加载现场完整生产路线：清空 flex* 演示种子并写入现场订单/路线/BOM",
|
||
"master.line.upsert": "编辑/停启用产线：改后续新排产的资源池",
|
||
"master.material.upsert": "新建/编辑/停用物料：改齐套检查与可选产品池",
|
||
"master.maintenance.upsert": "新增/取消维保：改设备避让窗口",
|
||
"master.bom.upsert": "BOM 头/明细增删改：改齐套需求与采购建议输入",
|
||
"master.routing.upsert": "工艺路线/步骤增删改：改占槽工时与外协标记",
|
||
"master.operation.upsert": "工序库新建/编辑：改路线可选步骤",
|
||
"master.lineProduct.upsert": "产线-产品绑定：改排产选线依据（排产前必需）",
|
||
"master.changeover.upsert": "换型矩阵：产品族切换准备时间（分钟）",
|
||
"master.clear": "一键清理主数据板块：按范围清空（非回种）",
|
||
"master.query": "查询订单/物料/工序/BOM/工艺路线/主数据概览（只读）",
|
||
"changeover.query": "换型矩阵只读查询",
|
||
"campaign.preview": "战役/批次合并预览（同产品交期窗口）",
|
||
"params.update": "排产参数：客户等级权重/目标权重/展望期（只影响新版本）",
|
||
"params.query": "排产参数查询：只读当前客户等级与目标权重",
|
||
"constraint.profile.query": "约束配置查询：只读硬/软约束剖面",
|
||
"constraint.profile.save": "约束配置保存：启停/硬软切换（只影响新版本与发布门禁）",
|
||
"order.decompose": "订单分解：按 BOM/工艺产出采购与委外建议（草稿）",
|
||
"mrp.release": "MRP 下达：草稿采购/委外建议单确认转为正式（RELEASED）",
|
||
"flex.schedule": "柔性排产：设备能力池动态组虚拟产线，只产草稿版本",
|
||
"flex.reschedule": "分级重排：L2短窗/L3日窗/L4全局（需确认）",
|
||
"flex.swap": "L1局部换机：池内备机接手，他单不动",
|
||
"flex.capacity": "瓶颈产能：按能力池实时算各工序日产能与限制性瓶颈",
|
||
"flex.simulate_due": "交期承诺：询单沙盒试排，给乐观/预计/悲观完工与缺口建议",
|
||
"flex.compare": "三模式对比：正排/倒排/瓶颈锚沙盒 KPI 对比",
|
||
"flex.rush": "紧急插单：高优先柔性订单写入并瓶颈锚重排",
|
||
"flex.fault": "设备故障：设备退出能力池并可选全量重排",
|
||
"flex.resource.patch": "柔性资源补丁：设备停复机/调区、模具寿命与锁定",
|
||
"flex.conflict.resolve": "冲突修复：L1换机/解锁模具等安全修复（重排类走确认卡）",
|
||
"conflict.list": "冲突中心：列出最新版本未解决冲突与建议",
|
||
"flex.adjust.preview": "甘特调程预览：边拖边校验，不改世界",
|
||
"flex.adjust.commit": "甘特调程提交：生成新草稿版本（需确认）",
|
||
"schedule.adjust.preview": "固定甘特调程预览：工位占槽/先后/维保校验",
|
||
"schedule.adjust.commit": "固定甘特调程提交：生成新草稿版本（需确认）",
|
||
"sap.status": "SAP 连接状态：Mock 桩只读探测",
|
||
"sap.sync.inbound": "SAP 入站：拉生产订单与库存写入柔性世界",
|
||
"sap.sync.outbound": "SAP 出站：工序开完工回写（Mock，幂等）",
|
||
"mes.status": "MES 连接状态：Mock 桩只读探测",
|
||
"mes.dispatch": "MES 下发：排产工单推送车间（外部副作用，幂等）",
|
||
"mes.report": "MES 报工：进度回流更新工单状态",
|
||
"scenario.compare": "方案对比：多策略试排全程在深拷贝沙盒",
|
||
"scenario.sensitivity": "敏感性分析：参数扰动 Tornado（沙盒不写主干）",
|
||
"sop.compile": "SOP→约束编译预览（不写主干）",
|
||
"sop.apply": "应用 SOP 规则包到约束剖面/换型策略",
|
||
"checkpoint.create": "建档：只新增成对快照文件",
|
||
"checkpoint.rollback": "回滚：整体替换主干世界（时间旅行）",
|
||
"data.reset": "重置：清空重播种子数据",
|
||
"knowledge.query": "知识检索：只读命中知识资产，回答强制带出处",
|
||
"guidance.next": "主动引导：按空态/冲突/知识未命中给出下一步口令",
|
||
"project.create": "新建项目与默认会话（只写工作区元数据，不改排产世界）",
|
||
"project.delete": "删除项目及其会话/文件/消息（不删除世界状态）",
|
||
"session.create": "在项目下新建会话话题",
|
||
"message.append": "向会话追加一条消息",
|
||
"message.replace": "整包替换会话消息（前端防抖同步）",
|
||
"workspace.replace": "整包同步工作区（本地迁移到服务端）",
|
||
"plan.trace": "计划追溯/钉扎：固定 SO 链或柔性 FO→BOM→VL→WO→设备负荷（OR-06）",
|
||
"report.generate": "报告生成：冻结快照模板化产出，报告入知识库",
|
||
"viewport.*": "视口命令：纯前端视图状态（模式/过滤/聚焦/高亮）",
|
||
"query.*": "查询：只读（KPI/世界视图）",
|
||
}
|
||
|
||
|
||
def list_policy() -> list[dict[str, str]]:
|
||
"""权力矩阵投影（门禁管理台数据源；P0 只读，§6.10.2）。
|
||
|
||
Returns: [{action, power, desc, confirm}] 列表，顺序与 _POWER_MAP 声明一致。
|
||
"""
|
||
return [{
|
||
"action": action, # 动作名（支持前缀通配）
|
||
"power": power, # 权力等级 P0-P3
|
||
"desc": _POLICY_DESC.get(action, ""), # 中文说明
|
||
"confirm": power in ("P2", "P3"), # 是否需要人工确认
|
||
} for action, power in _POWER_MAP.items()]
|
||
|
||
|
||
def power_of(action: str) -> str:
|
||
"""查动作的权力等级（前缀通配；未登记按最高 P3 拒绝——白名单原则）。"""
|
||
if action in _POWER_MAP: # 精确命中
|
||
return _POWER_MAP[action]
|
||
prefix = action.split(".")[0] + ".*" # 前缀通配（viewport.* / query.*）
|
||
return _POWER_MAP.get(prefix, "P3") # 未登记 → P3（默认最严）
|
||
|
||
|
||
def needs_confirm(action: str) -> bool:
|
||
"""该动作是否需要人工确认（P2/P3 强制过卡，§3.2 权力边界）。"""
|
||
return power_of(action) in ("P2", "P3") # 写主干/外部副作用必须确认
|
||
|
||
|
||
def stage_confirmation(session_id: str, action: str, params: dict[str, Any],
|
||
title: str, summary_lines: list[str]) -> UIBlock:
|
||
"""把 P2 动作压入待确认队列并生成确认卡 UI 块（动作此刻并未执行）。
|
||
|
||
权力等级：P1（只登记意图与出卡，不触发任何写）。
|
||
"""
|
||
confirm_id = uuid.uuid4().hex[:12] # 生成确认 ID（防猜测）
|
||
_pending[confirm_id] = { # 登记待确认动作
|
||
"sessionId": session_id, "action": action, "params": params,
|
||
}
|
||
return UIBlock( # 确认卡：前端渲染为审批卡片
|
||
blockId=f"confirm-{confirm_id}", # 块 ID 复用确认 ID
|
||
type="confirm-card", # 块类型
|
||
props={ # 卡片内容
|
||
"confirmId": confirm_id, # 前端回传用
|
||
"title": title, # 卡片标题
|
||
"summary": summary_lines, # 影响面说明（逐行）
|
||
"power": power_of(action), # 展示权力等级
|
||
"action": action, # 待执行动作名
|
||
},
|
||
actions=[ # 批准/驳回两个动作
|
||
UIAction(actionId="confirm", label="批准执行", power=power_of(action), # type: ignore[arg-type]
|
||
payload={"confirmId": confirm_id}),
|
||
UIAction(actionId="reject", label="驳回", power="P0", payload={"confirmId": confirm_id}),
|
||
],
|
||
)
|
||
|
||
|
||
def take_confirmation(confirm_id: str) -> dict[str, Any] | None:
|
||
"""取出并移除一条待确认动作（一次性令牌语义：批准/驳回后即失效）。"""
|
||
return _pending.pop(confirm_id, None) # 不存在返回 None（过期/重放防护）
|
||
|
||
|
||
def list_pending() -> list[dict[str, Any]]:
|
||
"""列出全部待确认动作（门禁管理台"待审批"页签的数据源，§6.10.2）。"""
|
||
return [{"confirmId": cid, **info} for cid, info in _pending.items()] # 附带令牌一并返回（只读投影）
|
||
|
||
|
||
def guard(action: str, params: dict[str, Any], executor: Callable[[], Any]):
|
||
"""P0/P1 动作的直通执行护栏：校验权力等级后执行（P2/P3 禁止走此通道）。
|
||
|
||
权力等级：随 action 而定；本函数强制 P2/P3 抛错（必须走 stage_confirmation）。
|
||
"""
|
||
if needs_confirm(action): # P2/P3 误入直通通道
|
||
raise PermissionError(f"动作 {action} 为 {power_of(action)}，必须经确认卡执行") # 硬拒绝
|
||
return executor() # P0/P1 直接执行
|