137 lines
7.1 KiB
Python
137 lines
7.1 KiB
Python
|
"""MOM 内部接口客户端 —— Track 主动调用 MOM 的**唯一**通道
|
|||
|
|
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════
|
|||
|
|
为什么这里用 HTTP，而「读」却直连 MOM 库
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════
|
|||
|
|
Track 读 MOM 一律走 `app/core/mom_database.py` 直连只读库（见 mom_outbound_service
|
|||
|
|
的模块头论证：MOM 的查询接口要 JWT + permission_required，且对非特权账号按
|
|||
|
|
`consumer_name` 做行级隔离，服务账号只能拿到自己名下的数据）。
|
|||
|
|
|
|||
|
|
但「写」不能直连库：跳过 MOM 的业务校验、权限与审批流，会写出 MOM 自己都不认的数据。
|
|||
|
|
所以走 MOM 为此新开的内部接口（X-API-Key 鉴权，不走 JWT —— Track 没有也不需要
|
|||
|
|
MOM 账号，申请人身份由请求体显式携带）。
|
|||
|
|
|
|||
|
|
⚠️ 别因为有了本模块就把「读」也搬过来。两条路各有各的理由，不要合并。
|
|||
|
|
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════
|
|||
|
|
失败语义（对用户要诚实）
|
|||
|
|
═══════════════════════════════════════════════════════════════════════════
|
|||
|
|
报废是**写**操作，静默失败最伤人 —— 用户以为报上去了，MOM 里其实什么都没有。
|
|||
|
|
所以这里不吞任何错误：连不上、鉴权失败、被 MOM 拒绝，都以带中文原因的形式抛出去，
|
|||
|
|
由端点转成用户看得懂的提示。
|
|||
|
|
"""
|
|||
|
|
import logging
|
|||
|
|
|
|||
|
|
import httpx
|
|||
|
|
|
|||
|
|
from app.core.config import settings
|
|||
|
|
|
|||
|
|
logger = logging.getLogger(__name__)
|
|||
|
|
|
|||
|
|
# 超时：MOM 侧要做「退回 + 建报废申请」两次写库，给宽一点。
|
|||
|
|
# 但也不能无限等 —— 请求挂住时用户会一直转圈，宁可失败让他重试（有幂等兜底）。
|
|||
|
|
_TIMEOUT = httpx.Timeout(30.0, connect=10.0)
|
|||
|
|
|
|||
|
|
_PATH = "/api/v1/internal/production-scrap"
|
|||
|
|
|
|||
|
|
|
|||
|
|
class MomScrapError(Exception):
|
|||
|
|
"""调 MOM 报废接口失败。
|
|||
|
|
|
|||
|
|
message 是**给用户看的中文原因**，端点直接把它转成响应 detail，
|
|||
|
|
不要再包一层「报废失败: ...」——
|
|||
|
|
MOM 返回的文案本身已经说清了（如「退回数量(9999)超出可退额度(5)」）。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
def __init__(self, message: str, *, mom_status_code: int | None = None,
|
|||
|
|
mom_code: int | None = None):
|
|||
|
|
super().__init__(message)
|
|||
|
|
self.message = message
|
|||
|
|
self.mom_status_code = mom_status_code
|
|||
|
|
self.mom_code = mom_code
|
|||
|
|
|
|||
|
|
|
|||
|
|
async def submit_production_scrap(*, outbound_id: int, return_qty: float,
|
|||
|
|
track_ref: str, applicant_id: int,
|
|||
|
|
reason: str | None = None,
|
|||
|
|
operator: str = "Track系统") -> dict:
|
|||
|
|
"""提交生产报废 → MOM 的 `POST /api/v1/internal/production-scrap`。
|
|||
|
|
|
|||
|
|
一次调用完成「退回(不良品) → 在管不良品 → 提交报废申请（待审批）」。
|
|||
|
|
返回 MOM 的 `data` 段（含 `scrap_request_no` / `defective_goods_id` / `duplicate`）。
|
|||
|
|
|
|||
|
|
:param outbound_id: MOM `trans_outbound.id`，即 Track 侧的 `mom_line_id`
|
|||
|
|
:param track_ref: Track 侧生成的唯一单据号（幂等锚点），重试必须传同一个
|
|||
|
|
:param applicant_id: MOM `sys_user.id`。Track 的 `user.sub` 就是它，
|
|||
|
|
所以 MOM 里显示的申请人就是**实际操作人本人**，不是服务账号
|
|||
|
|
"""
|
|||
|
|
api_key = (settings.MOM_INTERNAL_API_KEY or "").strip()
|
|||
|
|
if not api_key:
|
|||
|
|
# Fail-Closed：不静默降级成「假装成功」
|
|||
|
|
raise MomScrapError(
|
|||
|
|
"报废功能未启用：Track 未配置 MOM_INTERNAL_API_KEY，请联系管理员"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
base_url = (settings.MOM_INTERNAL_API_URL or "").rstrip("/")
|
|||
|
|
if not base_url:
|
|||
|
|
raise MomScrapError("报废功能未启用：Track 未配置 MOM_INTERNAL_API_URL")
|
|||
|
|
|
|||
|
|
payload = {
|
|||
|
|
# 公司 = 部门。MOM 会拿它跟出库物料实际所属公司强校验，不符直接拒绝。
|
|||
|
|
'company_name': settings.ORG_DEPARTMENT,
|
|||
|
|
'outbound_id': int(outbound_id),
|
|||
|
|
'return_qty': float(return_qty),
|
|||
|
|
# ★ 恒为 True：本流程 = 退回并提交报废申请。
|
|||
|
|
# false 那个分支（只登记为在管不良品）留给以后按需开放。
|
|||
|
|
'submit_scrap': True,
|
|||
|
|
'track_ref': track_ref,
|
|||
|
|
# 生产损耗。分类**必须显式传**，不能让 MOM 从来源推导 ——
|
|||
|
|
# 生产报废与 MOM 手工报的不良品退回共用同一张 trans_defective_goods 表，
|
|||
|
|
# 一推导就会把生产损失静默算成库存损失。
|
|||
|
|
'reason_category': 'PRODUCTION',
|
|||
|
|
'reason': (reason or '').strip() or None,
|
|||
|
|
'applicant_id': int(applicant_id),
|
|||
|
|
'operator': operator,
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
url = f"{base_url}{_PATH}"
|
|||
|
|
try:
|
|||
|
|
async with httpx.AsyncClient(timeout=_TIMEOUT) as client:
|
|||
|
|
resp = await client.post(url, json=payload, headers={'X-API-Key': api_key})
|
|||
|
|
except httpx.TimeoutException:
|
|||
|
|
logger.warning(f"[MomScrap] 调用 MOM 超时 url={url} track_ref={track_ref}")
|
|||
|
|
raise MomScrapError("提交报废超时：MOM 未在 30 秒内响应，请稍后用同一单据重试")
|
|||
|
|
except httpx.HTTPError as e:
|
|||
|
|
logger.error(f"[MomScrap] 连接 MOM 失败 url={url}: {e}")
|
|||
|
|
raise MomScrapError(f"无法连接 MOM 报废接口：{e}")
|
|||
|
|
|
|||
|
|
# MOM 统一信封 {code, msg, data}；非 JSON 响应说明打到了别的东西（如 nginx 错误页）
|
|||
|
|
try:
|
|||
|
|
body = resp.json()
|
|||
|
|
except ValueError:
|
|||
|
|
logger.error(f"[MomScrap] MOM 返回非 JSON（HTTP {resp.status_code}）：{resp.text[:200]}")
|
|||
|
|
raise MomScrapError(f"MOM 报废接口返回异常（HTTP {resp.status_code}）")
|
|||
|
|
|
|||
|
|
mom_code = body.get('code')
|
|||
|
|
mom_msg = (body.get('msg') or '').strip()
|
|||
|
|
|
|||
|
|
if resp.status_code != 200 or mom_code != 200:
|
|||
|
|
# MOM 的文案本身就是中文且具体（含数量、额度等），直接透传，
|
|||
|
|
# 不要在前面再加一层「报废失败:」，那只会把真正的信息挤到后面。
|
|||
|
|
logger.warning(
|
|||
|
|
f"[MomScrap] MOM 拒绝 HTTP {resp.status_code} code={mom_code} "
|
|||
|
|
f"track_ref={track_ref}: {mom_msg}"
|
|||
|
|
)
|
|||
|
|
raise MomScrapError(
|
|||
|
|
mom_msg or f"MOM 报废接口返回 HTTP {resp.status_code}",
|
|||
|
|
mom_status_code=resp.status_code, mom_code=mom_code,
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
data = body.get('data') or {}
|
|||
|
|
logger.info(
|
|||
|
|
f"[MomScrap] 受理成功 track_ref={track_ref} outbound={outbound_id} "
|
|||
|
|
f"qty={return_qty} duplicate={data.get('duplicate')} "
|
|||
|
|
f"request_no={(data.get('scrap') or {}).get('request_no')}"
|
|||
|
|
)
|
|||
|
|
return data
|