# ============================================================ # 订单分解 MRP 首切片（moduleId: domain-mrp, 可重生 ✅） # 对标西门子 Opcenter APS 的订单驱动分解：销售订单 → 按 BOM/工艺路线展开 → # 自制（进排产引擎）/ 采购建议（缺料 + 前置期倒排）/ 委外建议（外协工序）。 # 权力等级：order.decompose 为 P1——只产出 DRAFT 建议单（purchaseOrders / # outsourceOrders 两张建议表），不改主数据、不改销售订单； # 建议单的确认下达（转正式采购/委外）留后续切片（P2/P3）。 # 幂等：同一订单重复分解会替换其旧 DRAFT 建议，不会堆积重复行。 # ============================================================ from __future__ import annotations # 前向类型引用 import math # 需求量向上取整 from datetime import datetime # 时间戳 from typing import Any # 类型标注 from server.engines.queries import find_bom_items, find_routing_steps # BOM/工艺查询（P0） from server.timeutil import add_minutes, fmt_date, fmt_dt, parse_dt # 日期工具 World = dict[str, Any] # 世界状态类型别名 # 采购建议的安全缓冲天数（需求日 = 交期 - 前置期 - 缓冲） _PURCHASE_BUFFER_DAYS = 1 def _now() -> str: """当前时间字符串。""" return fmt_dt(datetime.now()) def _ensure_tables(world: World) -> None: """兼容旧世界文件：确保建议表存在（P0 结构自愈，不改业务数据）。""" world.setdefault("purchaseOrders", []) world.setdefault("outsourceOrders", []) def list_mrp(world: World) -> dict[str, Any]: """MRP 建议单投影（P0 只读；订单分解视图数据源）。""" _ensure_tables(world) return { "purchaseOrders": list(world["purchaseOrders"]), "outsourceOrders": list(world["outsourceOrders"]), } def _target_orders(world: World, order_no: str | None) -> list[dict[str, Any]]: """确定分解目标：指定订单号或全部已批准订单（OR-03）。""" from server.aps_domain.orders import SCHEDULABLE_STATUSES orders = [so for so in world["salesOrders"] if so["status"] in SCHEDULABLE_STATUSES] if order_no: # 显式点名单号时放宽：允许未批准单做分解试算 orders = [so for so in world["salesOrders"] if so["orderNo"].lower() == order_no.lower() and so["status"] not in ("CANCELLED", "COMPLETED")] if not orders: raise ValueError(f"没找到可分解的订单：{order_no}") return orders def decompose_orders(world: World, next_id, order_no: str | None = None) -> dict[str, Any]: """按 BOM/工艺路线分解订单（P1：只写 DRAFT 建议表）。 Returns: {orders, make, purchase, outsource} 分解结果摘要（前端/对话共用）。 """ _ensure_tables(world) targets = _target_orders(world, order_no) target_ids = {so["id"] for so in targets} # 幂等：清掉目标订单的旧 DRAFT 建议（已确认的建议保留，后续切片处理） world["purchaseOrders"] = [p for p in world["purchaseOrders"] if not (p["salesOrderId"] in target_ids and p["status"] == "DRAFT")] world["outsourceOrders"] = [o for o in world["outsourceOrders"] if not (o["salesOrderId"] in target_ids and o["status"] == "DRAFT")] make_rows: list[dict[str, Any]] = [] # 自制部分（进排产） purchase_rows: list[dict[str, Any]] = [] # 采购建议 outsource_rows: list[dict[str, Any]] = [] # 委外建议 # 逐订单逐明细展开（净需求 = 毛需求 - 库存 - 在途；负数记 0） # 简化口径：本切片不做跨订单库存分配（同一物料多订单各自算净需求），后续切片引入分配 for so in targets: for item in so.get("items", []): if item["status"] in ("CANCELLED", "COMPLETED"): continue qty = item["quantity"] # ---- 自制：成品本体 → 由排产引擎生成生产订单/工单 ---- make_rows.append({ "salesOrderNo": so["orderNo"], "productId": item["productId"], "productName": item["productName"], "quantity": qty, "note": "由排产引擎生成生产订单与工单", }) # ---- 采购：BOM 展开净需求 ---- for bi in find_bom_items(world, item["productId"]): mat = next(m for m in world["materials"] if m["id"] == bi["materialId"]) gross = bi["quantity"] * qty # 毛需求 shortage = gross - mat.get("stock", 0) - mat.get("inTransit", 0) # 净缺口 if shortage <= 0: continue lead = mat.get("procurementLeadTime", 0) due = parse_dt(so["deliveryDate"] + " 08:00") suggest_date = fmt_date(add_minutes(due, -(lead + _PURCHASE_BUFFER_DAYS) * 24 * 60)) # 前置期倒排 po_id = next_id("purchaseOrder") row = { "id": po_id, "orderNo": f"PUR{po_id:05d}", "salesOrderId": so["id"], "salesOrderNo": so["orderNo"], "materialId": mat["id"], "materialCode": mat["code"], "materialName": mat["name"], "quantity": math.ceil(shortage), "unit": mat["unit"], "leadTimeDays": lead, "suggestedOrderDate": suggest_date, "requiredDate": so["deliveryDate"], "isKeyMaterial": bi.get("isKeyMaterial", False), "status": "DRAFT", # 建议草稿（下达转正式为后续切片） "createdAt": _now(), } world["purchaseOrders"].append(row) purchase_rows.append(row) # ---- 委外：外协工艺步骤 ---- for step in find_routing_steps(world, item["productId"]): if not step.get("isExternal", False): continue op = next((o for o in world["operations"] if o["id"] == step["operationId"]), {}) oo_id = next_id("outsourceOrder") row = { "id": oo_id, "orderNo": f"OUT{oo_id:05d}", "salesOrderId": so["id"], "salesOrderNo": so["orderNo"], "productId": item["productId"], "productName": item["productName"], "operationId": step["operationId"], "operationName": op.get("name", f"OP#{step['operationId']}"), "sequenceNo": step["sequenceNo"], "quantity": qty, "unit": item.get("unit", "件"), "requiredDate": so["deliveryDate"], "status": "DRAFT", "createdAt": _now(), } world["outsourceOrders"].append(row) outsource_rows.append(row) return { "orders": [so["orderNo"] for so in targets], "make": make_rows, "purchase": purchase_rows, "outsource": outsource_rows, } def _release_targets(world: World, order_no: str | None, kind: str) -> tuple[list[dict], list[dict]]: """筛选待下达的 DRAFT 建议单（kind ∈ all/purchase/outsource；可按订单号限定）。""" _ensure_tables(world) so_ids = None if order_no: so = next((s for s in world["salesOrders"] if s["orderNo"].lower() == order_no.lower()), None) if so is None: raise ValueError(f"没找到订单：{order_no}") so_ids = {so["id"]} def _match(row: dict) -> bool: return row["status"] == "DRAFT" and (so_ids is None or row["salesOrderId"] in so_ids) pur = [p for p in world["purchaseOrders"] if _match(p)] if kind in ("all", "purchase") else [] out = [o for o in world["outsourceOrders"] if _match(o)] if kind in ("all", "outsource") else [] return pur, out def confirmation_for_mrp_release(world: World, order_no: str | None, kind: str = "all") -> tuple[str, list[str]]: """生成 MRP 下达 P2 确认卡标题与影响摘要。""" pur, out = _release_targets(world, order_no, kind) if not pur and not out: raise ValueError("没有可下达的草稿建议单（请先执行订单分解）") scope = f"订单 {order_no}" if order_no else "全部订单" title = f"下达 MRP 建议单（{scope}）" lines = [] if pur: lines.append(f"采购建议 {len(pur)} 条 → 转为正式采购单（RELEASED）") if out: lines.append(f"委外建议 {len(out)} 条 → 转为正式委外单（RELEASED）") lines.append("下达后建议单状态置为 RELEASED，进入采购/委外执行（P2 写主干，执行前自动建档）") return title, lines def apply_mrp_release(world: World, order_no: str | None = None, kind: str = "all") -> dict[str, Any]: """把 DRAFT 建议单确认下达为 RELEASED（P2 动作业务侧；调用方负责门禁/快照/审计/落盘）。""" pur, out = _release_targets(world, order_no, kind) released_at = _now() for row in pur + out: row["status"] = "RELEASED" row["releasedAt"] = released_at return {"purchase": pur, "outsource": out, "purchaseCount": len(pur), "outsourceCount": len(out)} def summarize_decomposition(result: dict[str, Any]) -> str: """把分解结果压成对话回执文案（页面与对话共用口径）。""" lines = [f"已分解 {len(result['orders'])} 张订单（{ '、'.join(result['orders'][:5]) }" + ("…" if len(result["orders"]) > 5 else "") + "）："] lines.append(f"· 自制：{len(result['make'])} 项成品 → 执行试排后生成生产订单与工单") if result["purchase"]: top = "、".join(f"{p['materialName']}×{p['quantity']}" for p in result["purchase"][:4]) lines.append(f"· 采购建议：{len(result['purchase'])} 条（{top}" + ("…" if len(result["purchase"]) > 4 else "") + "），已按采购前置期倒排建议下单日") else: lines.append("· 采购建议：0 条（库存与在途可覆盖 BOM 需求）") if result["outsource"]: top = "、".join(f"{o['productName']}·{o['operationName']}" for o in result["outsource"][:3]) lines.append(f"· 委外建议：{len(result['outsource'])} 条（{top}" + ("…" if len(result["outsource"]) > 3 else "") + "），来自外协工艺步骤") else: lines.append("· 委外建议：0 条（工艺路线无外协步骤）") lines.append("建议单可在订单面板「分解」查看；说「追溯 SO…」或打开「追溯」页可看 BOM/库存/工单/负荷全链。") return "\n".join(lines)