feat: improved wecomm message field

printing/services.py

@@ -24,6 +24,49 @@ class PrintingJobLatestState:
     advanced_at: str
 
 
+def build_printing_job_followup_url(*, printing_order_id: int | None) -> str:
+    tmpl = getattr(
+        settings,
+        "PRINTING_JOB_STATE_ADVANCED_FOLLOWUP_URL_TEMPLATE",
+        "https://app.yuwen.cloud/workstation/production/batch-advance?orderId={order_id}",
+    )
+    oid = printing_order_id if printing_order_id is not None else ""
+    try:
+        return str(tmpl).format(order_id=str(oid))
+    except Exception:
+        # template mis-config should not crash critical flows
+        return f"https://app.yuwen.cloud/workstation/production/batch-advance?orderId={oid}"
+
+
+def _truncate_text(s: str, max_len: int) -> str:
+    s = s or ""
+    if len(s) <= max_len:
+        return s
+    return s[: max(0, int(max_len) - 6)] + "...(截断)"
+
+
+def render_process_params_markdown(*, params: dict, max_items: int = 60, max_value_len: int = 200) -> str:
+    """
+    Render process params as markdown lines.
+    Example:
+      - **温度**：25
+    """
+    if not params:
+        return "- （无）"
+
+    items = []
+    for k in sorted(params.keys(), key=lambda x: str(x)):
+        v = params.get(k)
+        kk = _truncate_text(str(k), 80)
+        vv = _truncate_text(str(v), int(max_value_len))
+        items.append(f"- **{kk}**：{vv}")
+
+    if len(items) > int(max_items):
+        remain = len(items) - int(max_items)
+        items = items[: int(max_items)] + [f"- ……（其余 {remain} 项已省略）"]
+    return "\n".join(items)
+
+
 def _user_label(user) -> str:
     """
     Format a human-readable sender label from Django User.
@@ -71,6 +114,8 @@ def render_printing_job_state_markdown(
     state_name: str,
     advanced_at: str,
     sender_label: str,
+    followup_url: str,
+    process_params_markdown: str,
 ) -> str:
     template = getattr(
         settings,
@@ -83,6 +128,10 @@ def render_printing_job_state_markdown(
             "- **推进状态**：**{state_name}**\n"
             "- **推进时间**：`{advanced_at}`\n"
             "- **发送者**：{sender}\n"
+            "- **跟进地址**：[{followup_url}]({followup_url})\n"
+            "\n"
+            "**工序参数**：\n"
+            "{process_params_markdown}\n"
         ),
     )
     return template.format(
@@ -91,6 +140,8 @@ def render_printing_job_state_markdown(
         state_name=str(state_name),
         advanced_at=str(advanced_at),
         sender=str(sender_label or "系统自动发送"),
+        followup_url=str(followup_url),
+        process_params_markdown=str(process_params_markdown),
     )
 
 
@@ -113,17 +164,45 @@ def send_printing_job_latest_state_wecom(
     if not job:
         raise ValueError(f"PrintingJob 不存在：id={printing_job_id}")
 
-    latest = get_printing_job_latest_state(job=job)
+    # latest state log for parameters
+    state_log = (
+        job.business_object.state_logs.filter(is_cancelled=False)
+        .select_related("state")
+        .order_by("-completed_at", "-id")
+        .first()
+        if job.business_object
+        else None
+    )
+    if state_log is None:
+        state_name = "未开始"
+        advanced_at = "-"
+        params = {}
+    else:
+        state_name = getattr(state_log.state, "name", None) or str(state_log.state)
+        advanced_at = timezone.localtime(state_log.completed_at).strftime("%Y-%m-%d %H:%M:%S")
+        params = state_log.get_all_parameters_summary(include_cancelled=False)
+
+    followup_url = build_printing_job_followup_url(printing_order_id=job.printing_order_id)
+    process_params_markdown = render_process_params_markdown(params=params)
     msg = render_printing_job_state_markdown(
         printing_order_id=str(job.printing_order_id),
         printing_job_id=str(job.id),
-        state_name=latest.state_name,
-        advanced_at=latest.advanced_at,
+        state_name=str(state_name),
+        advanced_at=str(advanced_at),
         sender_label=sender_label,
+        followup_url=followup_url,
+        process_params_markdown=process_params_markdown,
     )
 
     if dry_run:
-        return {"dry_run": True, "message": msg, "state_name": latest.state_name, "advanced_at": latest.advanced_at}
+        return {
+            "dry_run": True,
+            "message": msg,
+            "state_name": str(state_name),
+            "advanced_at": str(advanced_at),
+            "followup_url": str(followup_url),
+            "process_params": params,
+        }
 
     resp = send_wecom_webhook_message(
         content=msg,
@@ -134,8 +213,10 @@ def send_printing_job_latest_state_wecom(
     return {
         "dry_run": False,
         "message": msg,
-        "state_name": latest.state_name,
-        "advanced_at": latest.advanced_at,
+        "state_name": str(state_name),
+        "advanced_at": str(advanced_at),
+        "followup_url": str(followup_url),
+        "process_params": params,
         "wecom": resp.raw,
         "ok": resp.ok,
         "errcode": resp.errcode,