提交

2026-09-11 21:03:53 +08:00
1 parent 195c89e6b7
commit d294ecad84
@@ -27,3 +27,12 @@ web-admin/**/*.local
 web-admin/.env
 web-admin/.env.*
 !web-admin/.env.docker
+
+mobile-oa-h5/node_modules
+mobile-oa-h5/dist
+mobile-oa-h5/.env
+mobile-oa-h5/.env.*
+!mobile-oa-h5/.env.docker
+
+# 小程序原生工程不进 web 镜像构建上下文
+mobile-h5/
@@ -50,12 +50,16 @@ __pycache__/
 .env.*
 !.env.example
 !mobile-oa-h5/.env.development
+!mobile-oa-h5/.env.docker
+!web-admin/.env.docker
 *.pem
 *.key
 *.p12
 secrets/
 生产环境信息/root密码
 生产环境信息/*_nginx/
+生产环境信息/微信生产.env.snippet
+生产环境信息/微信配置-测试号备份.txt

 # 日志与临时文件
 *.log
@@ -60,6 +60,8 @@ DATABASE_URL=mysql+pymysql://root:password@localhost:3306/zkxw
 # WXPAY_SANDBOX=false

 # 微信服务号（OA 审批/抄送模板消息；access_token 用服务号凭证，miniprogram.appid 仍用 WXPAY_MINI_APPID）
+# 总开关：模板未就绪时保持 false；配置好三套模板 ID 后再改为 true
+# WX_MP_NOTIFY_ENABLED=false
 # WX_MP_APPID=wx_service_account_appid
 # WX_MP_SECRET=wx_service_account_secret
 # WX_MP_TEMPLATE_APPROVAL=20rTii7gNFx5N998H4AlZe4AsQSV_62otPKti7pG7FI
@@ -101,6 +101,8 @@ class Settings(BaseSettings):
    WX_TEMPLATE_DELIVERY_WARNING: str = ""  # 配送时效预警模板ID

    # 微信服务号（OA 审批/抄送通知）
+    # 总开关：false 时不发送审批/抄送/申请人进度模板消息（模板未就绪或微信能力不可用时关闭）
+    WX_MP_NOTIFY_ENABLED: bool = False
    WX_MP_APPID: str = ""
    WX_MP_SECRET: str = ""
    WX_MP_TEMPLATE_APPROVAL: str = ""
@@ -8,6 +8,7 @@ from typing import Iterable, List, Optional

 from urllib.parse import urlencode

+from app.core.config import settings
 from app.core.database import SessionLocal
 from app.models.models import OaApp, OaInstance, OaTask, SysUser
 from app.services.wechat_mp_message import (
@@ -219,7 +220,14 @@ def _send_applicant_progress(
    )


+def _oa_wx_notify_enabled() -> bool:
+    return bool(getattr(settings, "WX_MP_NOTIFY_ENABLED", False))
+
+
 def notify_oa_tasks_sync(task_ids: Iterable[str]) -> None:
+    if not _oa_wx_notify_enabled():
+        logger.info("oa wx notify skipped: WX_MP_NOTIFY_ENABLED=false")
+        return
    ids = [str(x).strip() for x in task_ids if str(x).strip()]
    if not ids:
        return
@@ -250,6 +258,9 @@ def notify_oa_applicant_progress_sync(
    result: str,
    task_id: str = "",
 ) -> None:
+    if not _oa_wx_notify_enabled():
+        logger.info("oa wx applicant progress skipped: WX_MP_NOTIFY_ENABLED=false")
+        return
    db = None
    try:
        db = SessionLocal()
@@ -272,6 +283,9 @@ def notify_oa_applicant_progress_sync(


 def schedule_oa_task_notifies(task_ids: List[str]) -> None:
+    if not _oa_wx_notify_enabled():
+        logger.info("oa wx notify schedule skipped: WX_MP_NOTIFY_ENABLED=false")
+        return
    ids = [str(x).strip() for x in (task_ids or []) if str(x).strip()]
    if not ids:
        return
@@ -287,6 +301,11 @@ def schedule_oa_applicant_progress(
    action: str,
    task_id: str = "",
 ) -> None:
+    if not _oa_wx_notify_enabled():
+        logger.info(
+            "oa wx applicant progress schedule skipped: WX_MP_NOTIFY_ENABLED=false"
+        )
+        return
    iid = (instance_id or "").strip()
    if not iid:
        return
@@ -432,7 +432,7 @@
      "label": "Config",
      "file_type": "code",
      "source_file": "core/config.py",
-      "source_location": "L175"
+      "source_location": "L177"
    },
    {
      "id": "core_wechat_pay_py",
@@ -38428,70 +38428,77 @@
      "label": "map_oa_action_to_result()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L41"
+      "source_location": "L42"
    },
    {
      "id": "services_oa_wechat_notify_build_oa_detail_pagepath",
      "label": "build_oa_detail_pagepath()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L45"
+      "source_location": "L46"
    },
    {
      "id": "services_oa_wechat_notify_build_matter_title",
      "label": "_build_matter_title()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L66"
+      "source_location": "L67"
    },
    {
      "id": "services_oa_wechat_notify_resolve_process_and_applicant",
      "label": "_resolve_process_and_applicant()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L74"
+      "source_location": "L75"
    },
    {
      "id": "services_oa_wechat_notify_send_one",
      "label": "_send_one()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L94"
+      "source_location": "L95"
    },
    {
      "id": "services_oa_wechat_notify_send_applicant_progress",
      "label": "_send_applicant_progress()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L149"
+      "source_location": "L150"
+    },
+    {
+      "id": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "label": "_oa_wx_notify_enabled()",
+      "file_type": "code",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L223"
    },
    {
      "id": "services_oa_wechat_notify_notify_oa_tasks_sync",
      "label": "notify_oa_tasks_sync()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L222"
+      "source_location": "L227"
    },
    {
      "id": "services_oa_wechat_notify_notify_oa_applicant_progress_sync",
      "label": "notify_oa_applicant_progress_sync()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L246"
+      "source_location": "L254"
    },
    {
      "id": "services_oa_wechat_notify_schedule_oa_task_notifies",
      "label": "schedule_oa_task_notifies()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L274"
+      "source_location": "L285"
    },
    {
      "id": "services_oa_wechat_notify_schedule_oa_applicant_progress",
      "label": "schedule_oa_applicant_progress()",
      "file_type": "code",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L283"
+      "source_location": "L297"
    },
    {
      "id": "services_oa_wechat_notify_rationale_1",
@@ -38501,18 +38508,18 @@
      "source_location": "L1"
    },
    {
-      "id": "services_oa_wechat_notify_rationale_52",
+      "id": "services_oa_wechat_notify_rationale_53",
      "label": "\u62fc\u5c0f\u7a0b\u5e8f pagepath\uff08\u65e0\u524d\u5bfc /\uff09\uff1bquery \u505a urlencode\uff0c\u4fdd\u8bc1 returnPath \u542b\u659c\u6760\u53ef\u7528\u3002",
      "file_type": "rationale",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L52"
+      "source_location": "L53"
    },
    {
-      "id": "services_oa_wechat_notify_rationale_67",
+      "id": "services_oa_wechat_notify_rationale_68",
      "label": "\u7533\u8bf7\u4e8b\u9879/\u4e1a\u52a1\u540d\u79f0\uff1a\u7533\u8bf7\u4eba - \u6d41\u7a0b\u540d\u79f0\u3002",
      "file_type": "rationale",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L67"
+      "source_location": "L68"
    },
    {
      "id": "services_oa_confirmation_kit_sync_py",
@@ -40063,7 +40070,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "core/config.py",
-      "source_location": "L175",
+      "source_location": "L177",
      "weight": 1.0
    },
    {
@@ -139950,7 +139957,7 @@
    },
    {
      "source": "services_oa_wechat_notify_py",
-      "target": "app_core_database",
+      "target": "app_core_config",
      "relation": "imports_from",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
@@ -139959,7 +139966,7 @@
    },
    {
      "source": "services_oa_wechat_notify_py",
-      "target": "app_models_models",
+      "target": "app_core_database",
      "relation": "imports_from",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
@@ -139968,20 +139975,29 @@
    },
    {
      "source": "services_oa_wechat_notify_py",
-      "target": "app_services_wechat_mp_message",
+      "target": "app_models_models",
      "relation": "imports_from",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
      "source_location": "L13",
      "weight": 1.0
    },
+    {
+      "source": "services_oa_wechat_notify_py",
+      "target": "app_services_wechat_mp_message",
+      "relation": "imports_from",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L14",
+      "weight": 1.0
+    },
    {
      "source": "services_oa_wechat_notify_py",
      "target": "services_oa_wechat_notify_map_oa_action_to_result",
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L41",
+      "source_location": "L42",
      "weight": 1.0
    },
    {
@@ -139990,7 +140006,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L45",
+      "source_location": "L46",
      "weight": 1.0
    },
    {
@@ -139999,7 +140015,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L66",
+      "source_location": "L67",
      "weight": 1.0
    },
    {
@@ -140008,7 +140024,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L74",
+      "source_location": "L75",
      "weight": 1.0
    },
    {
@@ -140017,7 +140033,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L94",
+      "source_location": "L95",
      "weight": 1.0
    },
    {
@@ -140026,7 +140042,16 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L149",
+      "source_location": "L150",
+      "weight": 1.0
+    },
+    {
+      "source": "services_oa_wechat_notify_py",
+      "target": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "relation": "contains",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L223",
      "weight": 1.0
    },
    {
@@ -140035,7 +140060,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L222",
+      "source_location": "L227",
      "weight": 1.0
    },
    {
@@ -140044,7 +140069,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L246",
+      "source_location": "L254",
      "weight": 1.0
    },
    {
@@ -140053,7 +140078,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L274",
+      "source_location": "L285",
      "weight": 1.0
    },
    {
@@ -140062,7 +140087,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L283",
+      "source_location": "L297",
      "weight": 1.0
    },
    {
@@ -140071,7 +140096,7 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L108",
+      "source_location": "L109",
      "weight": 1.0
    },
    {
@@ -140080,7 +140105,7 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L110",
+      "source_location": "L111",
      "weight": 1.0
    },
    {
@@ -140089,7 +140114,7 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L116",
+      "source_location": "L117",
      "weight": 1.0
    },
    {
@@ -140098,7 +140123,7 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L191",
+      "source_location": "L192",
      "weight": 1.0
    },
    {
@@ -140107,7 +140132,16 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L205",
+      "source_location": "L206",
+      "weight": 1.0
+    },
+    {
+      "source": "services_oa_wechat_notify_notify_oa_tasks_sync",
+      "target": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "relation": "calls",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L228",
      "weight": 1.0
    },
    {
@@ -140116,7 +140150,16 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L236",
+      "source_location": "L244",
+      "weight": 1.0
+    },
+    {
+      "source": "services_oa_wechat_notify_notify_oa_applicant_progress_sync",
+      "target": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "relation": "calls",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L261",
      "weight": 1.0
    },
    {
@@ -140125,7 +140168,25 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L256",
+      "source_location": "L267",
+      "weight": 1.0
+    },
+    {
+      "source": "services_oa_wechat_notify_schedule_oa_task_notifies",
+      "target": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "relation": "calls",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L286",
+      "weight": 1.0
+    },
+    {
+      "source": "services_oa_wechat_notify_schedule_oa_applicant_progress",
+      "target": "services_oa_wechat_notify_oa_wx_notify_enabled",
+      "relation": "calls",
+      "confidence": "EXTRACTED",
+      "source_file": "services/oa_wechat_notify.py",
+      "source_location": "L304",
      "weight": 1.0
    },
    {
@@ -140134,7 +140195,7 @@
      "relation": "calls",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L293",
+      "source_location": "L312",
      "weight": 1.0
    },
    {
@@ -140147,21 +140208,21 @@
      "weight": 1.0
    },
    {
-      "source": "services_oa_wechat_notify_rationale_52",
+      "source": "services_oa_wechat_notify_rationale_53",
      "target": "services_oa_wechat_notify_build_oa_detail_pagepath",
      "relation": "rationale_for",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L52",
+      "source_location": "L53",
      "weight": 1.0
    },
    {
-      "source": "services_oa_wechat_notify_rationale_67",
+      "source": "services_oa_wechat_notify_rationale_68",
      "target": "services_oa_wechat_notify_build_matter_title",
      "relation": "rationale_for",
      "confidence": "EXTRACTED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L67",
+      "source_location": "L68",
      "weight": 1.0
    },
    {
@@ -273361,25 +273422,25 @@
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_52",
+      "source": "services_oa_wechat_notify_rationale_53",
      "target": "models_models_oaapp",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_67",
+      "source": "services_oa_wechat_notify_rationale_68",
      "target": "models_models_oaapp",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
@@ -273388,25 +273449,25 @@
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_52",
+      "source": "services_oa_wechat_notify_rationale_53",
      "target": "models_models_oainstance",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_67",
+      "source": "services_oa_wechat_notify_rationale_68",
      "target": "models_models_oainstance",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
@@ -273415,25 +273476,25 @@
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_52",
+      "source": "services_oa_wechat_notify_rationale_53",
      "target": "models_models_oatask",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_67",
+      "source": "services_oa_wechat_notify_rationale_68",
      "target": "models_models_oatask",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
@@ -273442,25 +273503,25 @@
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_52",
+      "source": "services_oa_wechat_notify_rationale_53",
      "target": "models_models_sysuser",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
-      "source": "services_oa_wechat_notify_rationale_67",
+      "source": "services_oa_wechat_notify_rationale_68",
      "target": "models_models_sysuser",
      "relation": "uses",
      "confidence": "INFERRED",
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L12",
+      "source_location": "L13",
      "weight": 0.8
    },
    {
@@ -340088,7 +340149,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L42",
+      "source_location": "L43",
      "weight": 1.0
    },
    {
@@ -340098,7 +340159,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L122",
+      "source_location": "L123",
      "weight": 1.0
    },
    {
@@ -340108,7 +340169,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L138",
+      "source_location": "L139",
      "weight": 1.0
    },
    {
@@ -340118,7 +340179,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L211",
+      "source_location": "L212",
      "weight": 1.0
    },
    {
@@ -340128,7 +340189,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L223",
+      "source_location": "L231",
      "weight": 1.0
    },
    {
@@ -340138,7 +340199,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L238",
+      "source_location": "L246",
      "weight": 1.0
    },
    {
@@ -340148,7 +340209,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L264",
+      "source_location": "L275",
      "weight": 1.0
    },
    {
@@ -340158,7 +340219,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "services/oa_wechat_notify.py",
-      "source_location": "L275",
+      "source_location": "L289",
      "weight": 1.0
    },
    {
@@ -1,10 +1,10 @@
-# Graph Report - app  (2026-09-01)
+# Graph Report - app  (2026-09-11)

 ## Corpus Check
- Large corpus: 264 files · ~317,066 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.
+- Large corpus: 264 files · ~317,127 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.

 ## Summary
- 5467 nodes · 30077 edges · 42 communities detected
+- 5468 nodes · 30082 edges · 40 communities detected
 - Extraction: 31% EXTRACTED · 69% INFERRED · 0% AMBIGUOUS · INFERRED: 20619 edges (avg confidence: 0.6)
 - Token cost: 0 input · 0 output

@@ -43,14 +43,12 @@
 - [[_COMMUNITY_Community 31|Community 31]]
 - [[_COMMUNITY_Community 32|Community 32]]
 - [[_COMMUNITY_Community 33|Community 33]]
- [[_COMMUNITY_Community 34|Community 34]]
- [[_COMMUNITY_Community 35|Community 35]]
+- [[_COMMUNITY_Community 36|Community 36]]
+- [[_COMMUNITY_Community 37|Community 37]]
 - [[_COMMUNITY_Community 38|Community 38]]
 - [[_COMMUNITY_Community 39|Community 39]]
 - [[_COMMUNITY_Community 40|Community 40]]
 - [[_COMMUNITY_Community 41|Community 41]]
- [[_COMMUNITY_Community 42|Community 42]]
- [[_COMMUNITY_Community 43|Community 43]]

 ## God Nodes (most connected - your core abstractions)
 1. `success_response()` - 762 edges
@@ -69,34 +67,34 @@
  core/api_request_log_middleware.py → models/models.py
 - `get_menu_list()` --calls--> `success_response()`  [INFERRED]
  api/menu.py → core/response.py
- `sync_lab_storage_seq_after_use()` --calls--> `generate_uuid()`  [INFERRED]
-  crud/sample_reception_lab_code.py → core/utils.py
 - `微信小程序登录业务：openid + 手机号一致性校验。` --uses--> `SysUser`  [INFERRED]
  services/wechat_login_service.py → models/models.py
 - `已绑定 openid 时静默换票（无需手机号授权）。` --uses--> `SysUser`  [INFERRED]
  services/wechat_login_service.py → models/models.py
+- `根据 openid + 本次授权手机号解析可登录员工。      Returns:         (user, error_message, error_co` --uses--> `SysUser`  [INFERRED]
+  services/wechat_login_service.py → models/models.py

 ## Communities

 ### Community 0 - "Community 0"
 Cohesion: 0.01
-Nodes (1046): attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu(), create_post() (+1038 more)
+Nodes (1075): attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu(), create_post() (+1067 more)

 ### Community 1 - "Community 1"
 Cohesion: 0.01
-Nodes (753): generate_uuid(), allocate_next_biz_no(), _format_biz_no(), _prefix_for(), 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。     须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, create_cell_sample_type(), get_cell_sample_type() (+745 more)
+Nodes (734): generate_uuid(), allocate_next_biz_no(), _format_biz_no(), _prefix_for(), 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。     须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, create_cell_sample_type(), get_cell_sample_type() (+726 more)

 ### Community 2 - "Community 2"
 Cohesion: 0.01
 Nodes (655): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, ExpressCompanyCreateBody (+647 more)

 ### Community 3 - "Community 3"
-Cohesion: 0.07
-Nodes (434): 环境检测 — 检测项维护 + 登记管理 API, 保险公司及险种价格管理 API（保险公司 + 开票信息 + 险种价格）, ProcessDefCreateBody, ProcessDefUpdateBody, PublishVersionBody, 审批意见：前端传 commentText，兼容 comment。, StartInstanceBody, TaskActionBody (+426 more)
+Cohesion: 0.01
+Nodes (420): _normalize_date_bound(), _persist_protocol_sub_resources(), list_ethnics_for_select(), apply_data_scope(), _get_child_dept_ids(), get_user_dept_id(), _resolve_user_role_scopes(), format_date() (+412 more)

 ### Community 4 - "Community 4"
-Cohesion: 0.01
-Nodes (310): _normalize_date_bound(), _persist_protocol_sub_resources(), _body_to_payload(), _get_current_user_id(), get_production_reception_detail(), _get_tenant_no(), post_production_reception(), put_production_reception() (+302 more)
+Cohesion: 0.08
+Nodes (388): 环境检测 — 检测项维护 + 登记管理 API, 保险公司及险种价格管理 API（保险公司 + 开票信息 + 险种价格）, 小程序菜单：当前用户在「移动端菜单」树下有权限的入口。, 宫格图标底色/图形色（可按入口自定义，不强制品牌绿）。, 按路由匹配移动端宫格图标（与 mobile-h5 van-icon 字形名对齐）。, ProcessDefCreateBody, ProcessDefUpdateBody, PublishVersionBody (+380 more)

 ### Community 5 - "Community 5"
 Cohesion: 0.06
@@ -104,31 +102,31 @@ Nodes (322): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegio

 ### Community 6 - "Community 6"
 Cohesion: 0.02
-Nodes (227): list_ethnics_for_select(), get_designer_data(), apply_data_scope(), _get_child_dept_ids(), get_user_dept_id(), _resolve_user_role_scopes(), ApiRequestLogCRUD, delete() (+219 more)
+Nodes (265): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则，避免 Illegal mix of collations。, 跨表字符串等值比较（JOIN / WHERE）时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci(), build_void_type_label_map(), format_protocol_status_label() (+257 more)

 ### Community 7 - "Community 7"
-Cohesion: 0.02
-Nodes (227): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则，避免 Illegal mix of collations。, 跨表字符串等值比较（JOIN / WHERE）时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci(), build_void_type_label_map(), format_protocol_status_label() (+219 more)
+Cohesion: 0.03
+Nodes (247): 截止日期：仅日期时扩到当天 23:59:59。, 发起前预览审批链（条件齐后解析最终路径与审批人）。, 兼容旧 GET：无 formData，含条件分支时多为待确定占位。, _app_to_dict(), _copied_app_name(), copy_app(), create_app(), create_group() (+239 more)

 ### Community 8 - "Community 8"
-Cohesion: 0.02
-Nodes (226): 截止日期：仅日期时扩到当天 23:59:59。, 发起前预览审批链（条件齐后解析最终路径与审批人）。, 兼容旧 GET：无 formData，含条件分支时多为待确定占位。, _app_to_dict(), _copied_app_name(), copy_app(), create_app(), create_group() (+218 more)
+Cohesion: 0.01
+Nodes (175): 服务号网页授权 code 绑定当前用户（需 Bearer）。, 微信登录：openid 已绑定时可静默换票；否则须授权手机号且与账号 phone_no 一致。, 密码登录后绑定当前微信 openid（需 Bearer）。, wechat_login(), get_designer_data(), _error_json(), lifespan(), 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin (+167 more)

 ### Community 9 - "Community 9"
-Cohesion: 0.02
-Nodes (146): mp_bind_status(), 小程序鉴权：微信登录 / 绑定 openid。, 当前用户是否已绑定微信服务号 openid。, 服务号网页授权 code 绑定当前用户（需 Bearer）。, 微信登录：openid 已绑定时可静默换票；否则须授权手机号且与账号 phone_no 一致。, 密码登录后绑定当前微信 openid（需 Bearer）。, _resolve_user_id(), wechat_bind() (+138 more)
+Cohesion: 0.03
+Nodes (148): api_save_application(), map_payments_by_schedule_ids(), get_protocol_nos_used_in_protocols(), _fmt_dt(), get_handover_by_schedule(), get_outbound_handover(), get_outbound_handover_view(), _handover_row_to_dict() (+140 more)

 ### Community 10 - "Community 10"
-Cohesion: 0.02
-Nodes (197): api_save_application(), map_payments_by_schedule_ids(), _fmt_dt(), get_handover_by_schedule(), get_outbound_handover(), get_outbound_handover_view(), _handover_row_to_dict(), _handover_view_dict() (+189 more)
+Cohesion: 0.04
+Nodes (114): _deduct_step_usage_legacy_batch(), register_step_usage_from_requisition(), revert_step_material_usages(), add_task_step(), _aggregate_production_tab_step_field(), assert_step_assignee_for_write(), assert_task_assignee(), assert_task_step_assignee_or_legacy() (+106 more)

 ### Community 11 - "Community 11"
-Cohesion: 0.06
-Nodes (102): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, list_storage_slot_stats(), OccupancyCreateBody (+94 more)
+Cohesion: 0.05
+Nodes (114): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, list_storage_slot_stats(), OccupancyCreateBody (+106 more)

 ### Community 12 - "Community 12"
-Cohesion: 0.05
-Nodes (73): _collect_descendants(), _current_user(), _find_mobile_root(), list_my_mobile_menus(), _mobile_menu_icon(), _mobile_menu_icon_colors(), 小程序菜单：当前用户在「移动端菜单」树下有权限的入口。, 宫格图标底色/图形色（可按入口自定义，不强制品牌绿）。 (+65 more)
+Cohesion: 0.04
+Nodes (91): _collect_descendants(), _current_user(), _find_mobile_root(), list_my_mobile_menus(), _mobile_menu_icon(), _mobile_menu_icon_colors(), _user_menu_ids(), _jwt_user_payload() (+83 more)

 ### Community 13 - "Community 13"
 Cohesion: 0.05
@@ -143,147 +141,139 @@ Cohesion: 0.12
 Nodes (11): get_wechat_pay_client(), get_wechat_pay_v2(), 微信支付工具模块  支持微信支付 V3 API 文档参考: https://pay.weixin.qq.com/docs/v3/apis/index.ht, 统一下单接口 (V3)          Args:             out_trade_no: 商户订单号             total, 申请退款          Args:             out_trade_no: 商户订单号             total_amount, 小程序调起支付的二次签名参数（与公众号 JSAPI 规则一致）, 统一下单 (V2 API)          Args:             out_trade_no: 商户订单号             tot, 生成签名 V3 (SHA256 with RSA) (+3 more)

 ### Community 16 - "Community 16"
-Cohesion: 0.14
-Nodes (11): apply_formulas_and_linkages(), eval_formula(), _extract_rules(), preprocess_formula(), OA 表单公式与数据联动（禁止任意 eval）, 按 schema 中字段 props.formula / props.linkage 回填 form_data。     linkage 示例: { "when, 将 {field} 转为合法标识符引用 field。, _SafeEval (+3 more)
-
-### Community 17 - "Community 17"
-Cohesion: 0.14
-Nodes (22): 验证密码（哈希非 bcrypt 或损坏时返回 False，避免抛错）, verify_password(), _attach_user_relations(), change_password(), create_user(), _empty_user_relation_fields(), enrich_user_dicts_with_relations(), get_user() (+14 more)
-
-### Community 18 - "Community 18"
-Cohesion: 0.15
-Nodes (21): batch_create_checkups(), create_checkup(), delete_actual_item(), delete_reserve_item(), get_checkup_by_application(), get_checkup_by_id(), list_actual_items(), list_checkups_paginated() (+13 more)
-
-### Community 19 - "Community 19"
 Cohesion: 0.19
 Nodes (21): apply_overtime_kit_hours(), _build_rest_day_segments(), _build_workday_windows(), calc_overtime_hours(), _day_at_minutes(), _day_start_ms(), _extract_rules(), _format_ymd() (+13 more)

-### Community 20 - "Community 20"
+### Community 17 - "Community 17"
 Cohesion: 0.21
 Nodes (19): _consumable_row_to_dict(), create_process(), _create_sub_consumable(), _create_sub_data_collection(), _create_sub_output(), _create_sub_reagent(), _data_collection_row_to_dict(), get_process() (+11 more)

-### Community 21 - "Community 21"
+### Community 18 - "Community 18"
+Cohesion: 0.15
+Nodes (19): _field_label(), _is_empty(), _is_required(), _parse_money(), OA 表单设计器：金额控件 form_data 校验, 校验 form_data 中金额控件的值格式，返回中文错误列表（空表示通过）。, 解析金额值。成功返回 (number, None)；失败返回 (None, error_key)。, _rule_props() (+11 more)
+
+### Community 19 - "Community 19"
 Cohesion: 0.2
 Nodes (19): _code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), get_material_entity(), get_my_usages(), _is_enabled_status() (+11 more)

-### Community 22 - "Community 22"
-Cohesion: 0.24
-Nodes (9): 微信消息通知服务  支持微信小程序模板消息推送  使用方式:     from app.core.wechat_message import Wech, 发送模板消息                  Args:             openid: 用户openid             templ, send_delivery_notice(), send_delivery_warning(), send_order_status(), send_payment_success(), send_refund_result(), send_urge_notification() (+1 more)
+### Community 20 - "Community 20"
+Cohesion: 0.22
+Nodes (15): apply_trip_kit_days(), calc_trip_leg_days(), _day_index(), _end_offset(), _extract_rules(), is_half_day_multiple(), 出差套件：半日制行程时长（与前端 oa-trip-days.ts 对齐）, 遍历 tripKit：行程未手改则覆盖 duration；出差天数未手改则覆盖为各行程时长之和。 (+7 more)

-### Community 23 - "Community 23"
+### Community 21 - "Community 21"
 Cohesion: 0.23
 Nodes (12): Config, ProductBase, ProductCategoryBase, ProductCategoryCreate, ProductCategoryResponse, ProductCreate, ProductResponse, ProductUnitBase (+4 more)

-### Community 24 - "Community 24"
+### Community 22 - "Community 22"
 Cohesion: 0.24
 Nodes (11): deduct_for_step(), _display_remark(), list_stock_logs(), _parse_receiver_purpose_from_remark(), 试剂变动记录 CRUD（biz_reagent_stock_log）, 撤销步骤此前 step_save 扣减，便于重新填报。, 扣减试剂库存并生成变动记录。调用方控制事务，本函数不 commit。, _resolve_receiver_purpose() (+3 more)

-### Community 25 - "Community 25"
+### Community 23 - "Community 23"
 Cohesion: 0.31
 Nodes (10): create_account(), _filtered_query(), get_account(), list_accounts(), list_options(), OA 收款账户 CRUD（oa_receive_account）, row_to_dict(), soft_delete_account() (+2 more)

-### Community 26 - "Community 26"
+### Community 24 - "Community 24"
 Cohesion: 0.29
 Nodes (2): BaseModel, SoftDeleteModel

-### Community 27 - "Community 27"
+### Community 25 - "Community 25"
 Cohesion: 0.38
 Nodes (6): derive_legacy_status_from_three(), derive_three_status_from_legacy(), 阶段A兼容：从旧 status 推导三字段。     约束：旧 status 本身混合了支付/配送/订单生命周期，因此只能尽力推断；     若业务侧已有更精确, 阶段A兼容：从三字段反推旧 status（用于旧前端/旧筛选参数兼容）。, ThreeStatus, _to_decimal()

-### Community 28 - "Community 28"
+### Community 26 - "Community 26"
 Cohesion: 0.4
 Nodes (5): batch_matches_stock_status(), normalize_batch_stock_status(), 质检物料入库批次：按剩余数量过滤的语义辅助。, 纯函数判定（供单测）；list_batches 用 SQL 等价条件。, 返回 'available' | 'exhausted'；全部 / 空 / 非法 → None（不加剩余数量条件）。

-### Community 29 - "Community 29"
+### Community 27 - "Community 27"
 Cohesion: 0.5
 Nodes (3): BaseSettings, Config, Settings

-### Community 30 - "Community 30"
+### Community 28 - "Community 28"
 Cohesion: 0.5
 Nodes (2): _auto_fill_create_dept_id(), ORM before_insert 钩子：当 create_dept_id 为空时，自动从请求上下文填充当前用户部门 ID

-### Community 31 - "Community 31"
+### Community 29 - "Community 29"
 Cohesion: 0.67
 Nodes (2): get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，5 个一级菜单分组）

-### Community 32 - "Community 32"
+### Community 30 - "Community 30"
 Cohesion: 0.67
 Nodes (1): 转正套件：入职日 + 试用期月数 → 建议转正日（YYYY-MM-DD）。

-### Community 33 - "Community 33"
+### Community 31 - "Community 31"
 Cohesion: 1.0
 Nodes (1): 质检物料金额查看授权：专用角色与菜单权限常量。

-### Community 34 - "Community 34"
+### Community 32 - "Community 32"
 Cohesion: 1.0
 Nodes (1): 请求级别的用户上下文变量  通过 contextvars 在请求处理链路中传递当前用户信息， 供 SQLAlchemy 事件监听器等底层机制使用，避免逐层手动传

-### Community 35 - "Community 35"
+### Community 33 - "Community 33"
 Cohesion: 1.0
 Nodes (1): API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位）

-### Community 38 - "Community 38"
+### Community 36 - "Community 36"
 Cohesion: 1.0
 Nodes (1): 发送订单状态通知                  Args:             openid: 用户openid             ord

-### Community 39 - "Community 39"
+### Community 37 - "Community 37"
 Cohesion: 1.0
 Nodes (1): 发送支付成功通知                  Args:             openid: 用户openid             ord

-### Community 40 - "Community 40"
+### Community 38 - "Community 38"
 Cohesion: 1.0
 Nodes (1): 发送配送通知                  Args:             openid: 配送员openid             task

-### Community 41 - "Community 41"
+### Community 39 - "Community 39"
 Cohesion: 1.0
 Nodes (1): 发送配送时效预警                  Args:             openid: 配送员openid             ta

-### Community 42 - "Community 42"
+### Community 40 - "Community 40"
 Cohesion: 1.0
 Nodes (1): 发送退款结果通知                  Args:             openid: 用户openid             ord

-### Community 43 - "Community 43"
+### Community 41 - "Community 41"
 Cohesion: 1.0
 Nodes (1): 发送催单通知给配送员                  Args:             deliver_openid: 配送员openid

 ## Knowledge Gaps
 - **181 isolated node(s):** `刷新会话 TTL（refreshToken 续期；已登录用户每次 API 校验通过后滑动续期）`, `写入 refreshToken（用于 one-time 使用/吊销）`, `根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）`, `登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。`, `加载 RSA 密钥对：优先环境变量，否则使用内置固定默认密钥。` (+176 more)
  These have ≤1 connection - possible missing edges or undocumented components.
- **Thin community `Community 26`** (8 nodes): `BaseModel`, `.to_dict()`, `get_active()`, `base.py`, `SoftDeleteModel`, `.restore()`, `.soft_delete()`, `__tablename__()`
+- **Thin community `Community 24`** (8 nodes): `BaseModel`, `.to_dict()`, `get_active()`, `base.py`, `SoftDeleteModel`, `.restore()`, `.soft_delete()`, `__tablename__()`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 30`** (4 nodes): `_auto_fill_create_dept_id()`, `get_db()`, `database.py`, `ORM before_insert 钩子：当 create_dept_id 为空时，自动从请求上下文填充当前用户部门 ID`
+- **Thin community `Community 28`** (4 nodes): `_auto_fill_create_dept_id()`, `get_db()`, `database.py`, `ORM before_insert 钩子：当 create_dept_id 为空时，自动从请求上下文填充当前用户部门 ID`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 31`** (3 nodes): `get_menu_list()`, `menu.py`, `运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，5 个一级菜单分组）`
+- **Thin community `Community 29`** (3 nodes): `get_menu_list()`, `menu.py`, `运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，5 个一级菜单分组）`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 32`** (3 nodes): `add_months_ymd()`, `oa_confirmation_date.py`, `转正套件：入职日 + 试用期月数 → 建议转正日（YYYY-MM-DD）。`
+- **Thin community `Community 30`** (3 nodes): `add_months_ymd()`, `oa_confirmation_date.py`, `转正套件：入职日 + 试用期月数 → 建议转正日（YYYY-MM-DD）。`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 33`** (2 nodes): `qc_material_amount_auth_constants.py`, `质检物料金额查看授权：专用角色与菜单权限常量。`
+- **Thin community `Community 31`** (2 nodes): `qc_material_amount_auth_constants.py`, `质检物料金额查看授权：专用角色与菜单权限常量。`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 34`** (2 nodes): `context.py`, `请求级别的用户上下文变量  通过 contextvars 在请求处理链路中传递当前用户信息， 供 SQLAlchemy 事件监听器等底层机制使用，避免逐层手动传`
+- **Thin community `Community 32`** (2 nodes): `context.py`, `请求级别的用户上下文变量  通过 contextvars 在请求处理链路中传递当前用户信息， 供 SQLAlchemy 事件监听器等底层机制使用，避免逐层手动传`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 35`** (2 nodes): `__init__.py`, `API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位）`
+- **Thin community `Community 33`** (2 nodes): `__init__.py`, `API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位）`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 38`** (1 nodes): `发送订单状态通知                  Args:             openid: 用户openid             ord`
+- **Thin community `Community 36`** (1 nodes): `发送订单状态通知                  Args:             openid: 用户openid             ord`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 39`** (1 nodes): `发送支付成功通知                  Args:             openid: 用户openid             ord`
+- **Thin community `Community 37`** (1 nodes): `发送支付成功通知                  Args:             openid: 用户openid             ord`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 40`** (1 nodes): `发送配送通知                  Args:             openid: 配送员openid             task`
+- **Thin community `Community 38`** (1 nodes): `发送配送通知                  Args:             openid: 配送员openid             task`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 41`** (1 nodes): `发送配送时效预警                  Args:             openid: 配送员openid             ta`
+- **Thin community `Community 39`** (1 nodes): `发送配送时效预警                  Args:             openid: 配送员openid             ta`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 42`** (1 nodes): `发送退款结果通知                  Args:             openid: 用户openid             ord`
+- **Thin community `Community 40`** (1 nodes): `发送退款结果通知                  Args:             openid: 用户openid             ord`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 43`** (1 nodes): `发送催单通知给配送员                  Args:             deliver_openid: 配送员openid`
+- **Thin community `Community 41`** (1 nodes): `发送催单通知给配送员                  Args:             deliver_openid: 配送员openid`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.

 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_

- **Why does `SysUser` connect `Community 2` to `Community 0`, `Community 1`, `Community 3`, `Community 5`, `Community 6`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 17`, `Community 24`?**
-  _High betweenness centrality (0.112) - this node is a cross-community bridge._
- **Why does `success_response()` connect `Community 0` to `Community 2`, `Community 4`, `Community 6`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 31`?**
+- **Why does `SysUser` connect `Community 2` to `Community 0`, `Community 1`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 9`, `Community 11`, `Community 12`, `Community 22`?**
+  _High betweenness centrality (0.114) - this node is a cross-community bridge._
+- **Why does `success_response()` connect `Community 0` to `Community 2`, `Community 3`, `Community 8`, `Community 9`, `Community 11`, `Community 12`, `Community 13`, `Community 29`?**
  _High betweenness centrality (0.038) - this node is a cross-community bridge._
- **Why does `generate_uuid()` connect `Community 1` to `Community 0`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 14`, `Community 17`, `Community 20`, `Community 21`, `Community 24`, `Community 25`?**
+- **Why does `generate_uuid()` connect `Community 1` to `Community 0`, `Community 3`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 14`, `Community 17`, `Community 19`, `Community 22`, `Community 23`?**
  _High betweenness centrality (0.035) - this node is a cross-community bridge._
 - **Are the 923 inferred relationships involving `str` (e.g. with `unhandled_exception_handler()` and `get_current_user_by_token()`) actually correct?**
  _`str` has 923 INFERRED edges - model-reasoned connections that need verification._
@@ -5,7 +5,7 @@
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/auth.py": 1786415793.4635684,
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/api_crypto.py": 1778578258.039314,
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/login_crypto.py": 1782186069.0708613,
-  "/Users/wuzilong/work/00code/zkxw/backend/app/core/config.py": 1786689356.7261088,
+  "/Users/wuzilong/work/00code/zkxw/backend/app/core/config.py": 1789108015.3185847,
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/wechat_pay.py": 1778578258.0461762,
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/api_request_log_middleware.py": 1779882001.753267,
  "/Users/wuzilong/work/00code/zkxw/backend/app/core/avatar_url.py": 1780540753.5481932,
@@ -259,7 +259,7 @@
  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_money_field.py": 1785380625.3526123,
  "/Users/wuzilong/work/00code/zkxw/backend/app/services/protocol_pay_mode_switch.py": 1785145536.322005,
  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_post_select.py": 1785394392.5716882,
-  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_wechat_notify.py": 1786689795.048216,
+  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_wechat_notify.py": 1789108034.959046,
  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_confirmation_kit_sync.py": 1785403667.4270058,
  "/Users/wuzilong/work/00code/zkxw/backend/app/services/oa_formula.py": 1785145511.513383,
  "/Users/wuzilong/work/00code/zkxw/backend/app/ws/__init__.py": 1778578258.105995
@@ -156,3 +156,38 @@ def test_send_one_routes_approval_vs_cc():
        )
        assert kwargs["title"] == "李四 - 请假申请"
        assert kwargs["process_name"] == "请假申请"
+
+
+def test_schedule_oa_task_notifies_noop_when_disabled():
+    with patch("app.services.oa_wechat_notify.settings") as st, patch(
+        "app.services.oa_wechat_notify.threading.Thread"
+    ) as th:
+        st.WX_MP_NOTIFY_ENABLED = False
+        from app.services.oa_wechat_notify import schedule_oa_task_notifies
+
+        schedule_oa_task_notifies(["t1"])
+        th.assert_not_called()
+
+
+def test_schedule_oa_applicant_progress_noop_when_disabled():
+    with patch("app.services.oa_wechat_notify.settings") as st, patch(
+        "app.services.oa_wechat_notify.threading.Thread"
+    ) as th:
+        st.WX_MP_NOTIFY_ENABLED = False
+        from app.services.oa_wechat_notify import schedule_oa_applicant_progress
+
+        schedule_oa_applicant_progress(
+            instance_id="i1", actor_user_id="u1", action="approve"
+        )
+        th.assert_not_called()
+
+
+def test_notify_oa_tasks_sync_noop_when_disabled():
+    with patch("app.services.oa_wechat_notify.settings") as st, patch(
+        "app.services.oa_wechat_notify.SessionLocal"
+    ) as session_local:
+        st.WX_MP_NOTIFY_ENABLED = False
+        from app.services.oa_wechat_notify import notify_oa_tasks_sync
+
+        notify_oa_tasks_sync(["t1"])
+        session_local.assert_not_called()
@@ -73,8 +73,17 @@ API_ENCRYPT_FAIL_OPEN=false
 # 全量 API 请求日志（需 sys_api_request_log 表，否则可关闭）
 API_REQUEST_LOG_ENABLED=false

-# ---------- 微信支付（可选，不配则支付相关功能不可用）----------
+# ---------- 微信服务号 OA 模板消息（模板未就绪时保持 false）----------
+WX_MP_NOTIFY_ENABLED=false
+# WX_MP_APPID=wxe576b24f873f47cb
+# WX_MP_SECRET=
+# WX_MP_TEMPLATE_APPROVAL=
+# WX_MP_TEMPLATE_CC=
+# WX_MP_TEMPLATE_APPLICANT_PROGRESS=
+
+# ---------- 微信支付 / 小程序凭证（登录、模板消息跳转；Secret 勿提交真实值）----------
 # WXPAY_MCHID=
-# WXPAY_MINI_APPID=
+# WXPAY_MINI_APPID=wx2b139581f4c855e4
+# WXPAY_SECRET=
 # WXPAY_API_KEY=
 # WXPAY_NOTIFY_URL=https://your-domain.com/api/payment/notify
@@ -93,15 +93,16 @@ sudo systemctl restart docker
 ```bash
 ./scripts/package-docker-deploy.sh          # 默认日期版本
 ./scripts/package-docker-deploy.sh v1.0.0   # 指定版本号
+./scripts/package-docker-deploy.sh v1.1.0   # 含 mobile-oa-h5（/oa-h5/）+ 微信开关
 ```

 `package-docker-deploy.sh` 固定构建 **`linux/amd64`** 镜像（适配甲方 Linux x86 云主机）。仅在对方确认为 ARM 云主机时，发版前改脚本中的 `DOCKER_PLATFORM` 为 `linux/arm64`。

 脚本会：

-1. 本地 `docker build` 生成 `zkxw-backend:<版本>`、`zkxw-web:<版本>`
+1. 本地 `docker build` 生成 `zkxw-backend:<版本>`、`zkxw-web:<版本>`（**web 镜像内含 web-admin + `/oa-h5/`（mobile-oa-h5）**）
 2. `docker save` 导出为 `images/zkxw-app-images.tar`
-3. 打包 compose、`.env.example`、`docs/sql/zkxw.sql`（**不含** `backend/`、`web-admin/` 源码）
+3. 打包 compose、`.env.example`、`docs/sql/zkxw.sql`（**不含** `backend/`、`web-admin/`、`mobile-oa-h5/` 源码）

 产物：`dist/zkxw-docker-deploy-<版本>.tar.gz`

@@ -148,11 +149,73 @@ zkxw-docker-deploy-<版本>/
 └── VERSION.txt
 ```

-**不包含**：`backend/`、`web-admin/`、Dockerfile、`.vue` / `.py` 业务源码。
+**不包含**：`backend/`、`web-admin/`、`mobile-oa-h5/`、Dockerfile、`.vue` / `.py` 业务源码。

 数据库脚本 `zkxw.sql` 仅为表结构与基线数据，非应用源代码。

-Nginx 反代配置已打入 `zkxw-web` 镜像，无需单独配置。
+Nginx 反代配置已打入 `zkxw-web` 镜像（含管理端 `/` 与 OA H5 `/oa-h5/`），无需单独配置。
+
+---
+
+## 3.1 从 v1.0.0 增量升级到 v1.1.0（小程序 OA H5 + 微信配置）
+
+适用：已在运行 `zkxw-backend:v1.0.0` / `zkxw-web:v1.0.0`，数据卷保留，**不重装** MySQL/Redis/MinIO。
+
+典型目录（以现网调查为准）：
+
+```text
+/opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+```
+
+### 发版方
+
+```bash
+./scripts/package-docker-deploy.sh v1.1.0
+# 产物：dist/zkxw-docker-deploy-v1.1.0.tar.gz
+```
+
+### 内网机（192.168.200.24）运维
+
+```bash
+# 1) 用户自行上传 tar 到内网机后解压（路径自定，示例）
+cd /opt/zkxw
+tar -xzf zkxw-docker-deploy-v1.1.0.tar.gz
+docker load -i zkxw-docker-deploy-v1.1.0/images/zkxw-app-images.tar
+
+# 2) 改现网 .env（保留原密码；追加/修改下列项）
+cd /opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+# ZKXW_BACKEND_IMAGE=zkxw-backend:v1.1.0
+# ZKXW_WEB_IMAGE=zkxw-web:v1.1.0
+# WXPAY_MINI_APPID=...
+# WXPAY_SECRET=...
+# WX_MP_APPID=...
+# WX_MP_SECRET=...
+# WX_MP_NOTIFY_ENABLED=false
+
+# 3) 只滚动应用（数据卷不动）
+docker compose up -d backend web
+
+# 4) 本机验收
+curl -sI http://127.0.0.1:8112/ | head -5
+curl -sI http://127.0.0.1:8112/oa-h5/ | head -5
+curl -s http://127.0.0.1:8112/health
+```
+
+### 公网网关 39.102.214.125（xwyd.zkxw.cn → 112.30.112.8:60001）
+
+现网 `xwyd.zkxw.cn` 对 `/` 做整站 `proxy_pass` 到内网 `60001`，**一般无需改 Nginx**：
+
+- `https://xwyd.zkxw.cn/` → 管理端  
+- `https://xwyd.zkxw.cn/oa-h5/` → OA H5（新）  
+- `https://xwyd.zkxw.cn/api/`、`/minio/zkxw/` → 随同反代  
+
+内网 `112.30.112.8:60001 → 192.168.200.24:8112` 映射**保持不动**。升级后公网验收：
+
+```bash
+curl -skI https://xwyd.zkxw.cn/oa-h5/ | head -5
+```
+
+若 `/oa-h5/` 404 而本机 `8112` 正常，再查网关是否对路径做了白名单（当前配置为整站反代则无需改）。

 ---

@@ -71,6 +71,17 @@ server {
        }
    }

+    # OA H5（mobile-oa-h5，vite base=/oa-h5/）
+    location = /oa-h5 {
+        return 301 /oa-h5/;
+    }
+
+    location ^~ /oa-h5/ {
+        root /usr/share/nginx/html;
+        try_files $uri $uri/ /oa-h5/index.html;
+        add_header Cache-Control "no-cache" always;
+    }
+
    location / {
        try_files $uri $uri/ /index.html;
    }
@@ -2,6 +2,31 @@
 ARG NODE_IMAGE=docker.m.daocloud.io/library/node:20-alpine
 ARG NGINX_IMAGE=docker.m.daocloud.io/library/nginx:1.27-alpine

+# ---------- OA H5（mobile-oa-h5 → /oa-h5/）----------
+FROM ${NODE_IMAGE} AS oa-h5-builder
+
+ARG NPM_REGISTRY=https://registry.npmmirror.com
+ARG NODE_MAX_OLD_SPACE_SIZE=4096
+ENV NODE_OPTIONS="--max-old-space-size=${NODE_MAX_OLD_SPACE_SIZE}"
+ENV HUSKY=0
+
+RUN npm config set registry "${NPM_REGISTRY}" \
+    && npm config set fetch-retries 5 \
+    && npm config set fetch-retry-mintimeout 60000 \
+    && npm config set fetch-retry-maxtimeout 600000 \
+    && npm config set fetch-timeout 600000
+
+WORKDIR /oa-h5
+
+COPY mobile-oa-h5/package.json mobile-oa-h5/package-lock.json ./
+RUN --mount=type=cache,id=zkxw-oa-h5-npm,target=/root/.npm \
+    npm ci --no-audit --no-fund
+
+COPY mobile-oa-h5/ .
+# 同域 /api、/minio/zkxw + 生产服务号 AppID（见 .env.docker）
+RUN npm run build -- --mode docker
+
+# ---------- Web Admin ----------
 FROM ${NODE_IMAGE} AS builder

 ARG NPM_REGISTRY=https://registry.npmmirror.com
@@ -44,6 +69,7 @@ FROM ${NGINX_IMAGE}

 COPY deploy/docker/nginx/default.conf /etc/nginx/conf.d/default.conf
 COPY --from=builder /app/dist /usr/share/nginx/html
+COPY --from=oa-h5-builder /oa-h5/dist /usr/share/nginx/html/oa-h5

 EXPOSE 80

@@ -12,11 +12,10 @@
   - 无 `productionReception` → 提示并打开「样本接收信息填写」  
   - 质检结论非「接收(js)」时不强制

-2. **生产任务**（所有工单类型，跳过已作废/已完成任务）  
-   - 无未完成任务 → 提示先派发  
-   - 每个工艺步骤须有负责人、计划开始时间  
-   - 凡已录入的产出物行，条码不能为空（无产出行不拦）  
-   - 缺项 → 提示并打开对应【任务执行】弹窗（定位到问题步骤）
+2. **生产任务**（所有工单类型）  
+   - 工单下无任何任务 → 提示先派发  
+   - 仅剩已完成(`ywc`)/已作废(`yzf`) → **放行**（可直接完成工单）  
+   - 存在未完成任务时：每个工艺步骤须有负责人、计划开始时间；已录入产出物行条码不能为空（无产出行不拦）；缺项 → 提示并打开对应【任务执行】弹窗（定位到问题步骤）

 3. 通过后 → 现有「完成工单」结论弹窗

@@ -49,8 +49,9 @@
    /* 快应用特有相关 */
    "quickapp" : {},
    /* 小程序特有相关 */
+    /* 生产小程序 AppID；测试备份见 manifest.mp-weixin.appid.test.bak */
    "mp-weixin" : {
-        "appid" : "wxa261ad85f2c99b26",
+        "appid" : "wx2b139581f4c855e4",
        "setting" : {
            "urlCheck" : false,
            "es6" : true
@@ -1,40 +1,55 @@
 /**
- * true = 测试机域名（微信体验版 / 真机）
- * false = 本机联调（模拟器 / 同网手机）
+ * 运行环境开关（改这一处即可切换）
+ * - local：本机联调（模拟器 / 同网手机）
+ * - test ：测试机 www.chengyantek.cn（体验版联调测试后端）
+ * - prod ：生产 xwyd.zkxw.cn（正式/体验版连生产）
 *
- * 微信公众平台须配置 request / 业务域名：www.chengyantek.cn（HTTPS，安全组放行 443）
+ * 微信公众平台须为对应环境配置 request / 业务域名（HTTPS）
 */
-const USE_REMOTE_TEST = false
+export const APP_ENV = 'prod' // 'local' | 'test' | 'prod'

-/** 本机联调 */
-const LOCAL_API_BASE_URL = 'http://127.0.0.1:8000/api'
-/** 本机 OA H5（Vite）；真机同网时把 IP 改成电脑局域网地址 */
-const LOCAL_OA_H5_ORIGIN = 'http://127.0.0.1:5178/oa-h5'
-/** 与 web-admin `.env.development` 的 VITE_MINIO_BASE_URL 对齐 */
-const LOCAL_MINIO_BASE_URL = 'http://47.99.164.66:20004/zkxw'
+const ENV_PRESETS = {
+  local: {
+    apiBaseUrl: 'http://127.0.0.1:8000/api',
+    /** 本机 OA H5（Vite）；真机同网时把 IP 改成电脑局域网地址 */
+    oaH5Origin: 'http://127.0.0.1:5178/oa-h5',
+    /** 与 web-admin `.env.development` 的 VITE_MINIO_BASE_URL 对齐 */
+    minioBaseUrl: 'http://47.99.164.66:20004/zkxw',
+    /** 测试服务号原始 ID（本地联调可沿用测试号） */
+    mpGhUsername: 'gh_e0b5daf10934'
+  },
+  test: {
+    apiBaseUrl: 'https://www.chengyantek.cn/api',
+    oaH5Origin: 'https://www.chengyantek.cn/oa-h5',
+    minioBaseUrl: 'https://www.chengyantek.cn/minio/zkxw',
+    mpGhUsername: 'gh_e0b5daf10934'
+  },
+  prod: {
+    apiBaseUrl: 'https://xwyd.zkxw.cn/api',
+    oaH5Origin: 'https://xwyd.zkxw.cn/oa-h5',
+    minioBaseUrl: 'https://xwyd.zkxw.cn/minio/zkxw',
+    mpGhUsername: 'gh_4d29bb37922f'
+  }
+}

-/** 测试环境 */
-const REMOTE_API_BASE_URL = 'https://www.chengyantek.cn/api'
-const REMOTE_OA_H5_ORIGIN = 'https://www.chengyantek.cn/oa-h5'
-/** 与测试 Nginx `/minio/zkxw` 同域反代对齐 */
-const REMOTE_MINIO_BASE_URL = 'https://www.chengyantek.cn/minio/zkxw'
+const preset = ENV_PRESETS[APP_ENV] || ENV_PRESETS.prod

 /** 后端 API 根路径（含 /api，不含末尾斜杠） */
-export const API_BASE_URL = USE_REMOTE_TEST ? REMOTE_API_BASE_URL : LOCAL_API_BASE_URL
+export const API_BASE_URL = preset.apiBaseUrl

 export const REQUEST_TIMEOUT_MS = 15000

 /** OA 表单 H5 源（web-view） */
-export const OA_H5_ORIGIN = USE_REMOTE_TEST ? REMOTE_OA_H5_ORIGIN : LOCAL_OA_H5_ORIGIN
+export const OA_H5_ORIGIN = preset.oaH5Origin

 /** MinIO 公网/反代基址（不含末尾斜杠）；附件相对 key 需拼此前缀 */
-export const MINIO_BASE_URL = USE_REMOTE_TEST
-  ? REMOTE_MINIO_BASE_URL
-  : LOCAL_MINIO_BASE_URL
+export const MINIO_BASE_URL = preset.minioBaseUrl

 /** 服务号原始 ID（gh_…），用于 openOfficialAccountProfile */
-export const MP_GH_USERNAME = 'gh_e0b5daf10934'
+export const MP_GH_USERNAME = preset.mpGhUsername
+
 /** 关注二维码图片（兜底） */
 export const MP_QRCODE_URL = '/static/mp-qrcode.png'
+
 /** 绑定 H5 路径（相对 OA_H5_ORIGIN） */
 export const MP_BIND_H5_PATH = '/oa-mp-bind/'
@@ -0,0 +1,7 @@
+# mobile-oa-h5 Docker / 生产同域构建（vite build --mode docker）
+# 与 web-admin/.env.docker、deploy/docker MINIO_BASE_URL 对齐
+
+VITE_API_BASE=/api
+VITE_MINIO_BASE_URL=/minio/zkxw
+# 生产微信服务号 AppID（网页授权绑定；勿放 Secret）
+VITE_WX_MP_APPID=wxe576b24f873f47cb
@@ -1,10 +1,58 @@
-/** 与 web-admin `attachmentFullUrl` 对齐：上传接口返回相对 key，表单需存可访问的完整 URL */
+/**
+ * 与 web-admin `attachmentFullUrl` 对齐：上传回写常见为 `/minio/{bucket}/objectKey`，
+ * 不得再拼一次 `VITE_MINIO_BASE_URL`，否则会出现
+ * `/minio/zkxw/minio/zkxw/...`（微信内即 https://域名/minio/zkxw/minio/zkxw/...）。
+ */

-const minioBaseUrl = String(import.meta.env.VITE_MINIO_BASE_URL || '').replace(/\/$/, '')
+function readMinioBase() {
+  return String(import.meta.env.VITE_MINIO_BASE_URL || '').replace(/\/$/, '')
+}

-export function attachmentFullUrl(url) {
+/**
+ * @param {string} url
+ * @param {string} [baseOverride] 单测可注入基址
+ */
+export function attachmentFullUrl(url, baseOverride) {
  const u = String(url || '').trim()
  if (!u) return ''
-  if (/^https?:\/\//i.test(u)) return u
-  return minioBaseUrl ? `${minioBaseUrl}/${u.replace(/^\//, '')}` : u
+
+  const base =
+    baseOverride !== undefined
+      ? String(baseOverride || '').replace(/\/$/, '')
+      : readMinioBase()
+
+  // 完整 URL：若已是 /minio/ 反代路径，微信内改为当前页同源，避免内网 IP 不可达
+  if (/^https?:\/\//i.test(u)) {
+    try {
+      const parsed = new URL(u)
+      if (parsed.pathname.startsWith('/minio/')) {
+        if (typeof location !== 'undefined' && location?.origin) {
+          return `${location.origin}${parsed.pathname}${parsed.search}`
+        }
+        return `${parsed.pathname}${parsed.search}`
+      }
+    } catch {
+      /* keep original */
+    }
+    return u
+  }
+
+  // `/minio/zkxw/oa-approval/...` 或 `minio/zkxw/oa-approval/...`
+  const path = u.startsWith('/') ? u : `/${u}`
+  if (path.startsWith('/minio/')) {
+    const parts = path.split('/').filter(Boolean) // minio, bucket, ...key
+    const objectKey = parts.length >= 3 ? parts.slice(2).join('/') : ''
+    if (objectKey && /^https?:\/\//i.test(base)) {
+      return `${base}/${objectKey}`
+    }
+    if (!base || path === base || path.startsWith(`${base}/`)) return path
+    if (objectKey) return `${base}/${objectKey}`
+    return path
+  }
+
+  if (base && (u === base || u.startsWith(`${base}/`) || path === base || path.startsWith(`${base}/`))) {
+    return path.startsWith('/') ? path : u
+  }
+  if (!base) return u
+  return `${base}/${u.replace(/^\//, '')}`
 }
@@ -0,0 +1,51 @@
+import assert from 'node:assert/strict'
+import { attachmentFullUrl } from './attachment.js'
+
+const BASE_REL = '/minio/zkxw'
+const BASE_ABS = 'https://xwyd.zkxw.cn/minio/zkxw'
+
+{
+  assert.equal(attachmentFullUrl(''), '')
+  assert.equal(
+    attachmentFullUrl('https://cdn.example.com/a.png', BASE_REL),
+    'https://cdn.example.com/a.png'
+  )
+}
+
+// 已带同域反代前缀：不得再拼 → 避免 /minio/zkxw/minio/zkxw/...
+{
+  const key = '/minio/zkxw/oa-approval/202608/10/907efa94baf245dcb47da30880bb0be5.png'
+  assert.equal(attachmentFullUrl(key, BASE_REL), key)
+  assert.equal(
+    attachmentFullUrl(key.slice(1), BASE_REL),
+    key
+  )
+  assert.equal(
+    attachmentFullUrl(key, BASE_ABS),
+    `${BASE_ABS}/oa-approval/202608/10/907efa94baf245dcb47da30880bb0be5.png`
+  )
+}
+
+// 纯 object key
+{
+  assert.equal(
+    attachmentFullUrl('oa-approval/202608/10/x.png', BASE_REL),
+    '/minio/zkxw/oa-approval/202608/10/x.png'
+  )
+  assert.equal(
+    attachmentFullUrl('oa-approval/202608/10/x.png', BASE_ABS),
+    'https://xwyd.zkxw.cn/minio/zkxw/oa-approval/202608/10/x.png'
+  )
+}
+
+// 内网绝对地址（无 location 时退回 pathname，避免双前缀）
+{
+  const intranet =
+    'http://112.30.112.8:60001/minio/zkxw/oa-approval/202608/10/907efa94baf245dcb47da30880bb0be5.png'
+  assert.equal(
+    attachmentFullUrl(intranet, BASE_REL),
+    '/minio/zkxw/oa-approval/202608/10/907efa94baf245dcb47da30880bb0be5.png'
+  )
+}
+
+console.log('attachment.test.js: ok')
@@ -89,6 +89,7 @@ version=${VERSION}
 platform=${DOCKER_PLATFORM}
 backend_image=${BACKEND_IMAGE}
 web_image=${WEB_IMAGE}
+web_includes=web-admin+mobile-oa-h5(/oa-h5/)
 built_at=$(date -Iseconds)
 git_commit=$(git -C "${ROOT}" rev-parse --short HEAD 2>/dev/null || echo unknown)
 deploy_dir=deploy/docker
@@ -104,7 +105,7 @@ echo "应用镜像: $(du -h "${IMAGES_TAR}" | cut -f1)"
 echo "总包大小: $(du -h "${ARCHIVE}" | cut -f1)"
 echo ""
 echo "包内不含前后端源码，包含:"
-echo "  - images/zkxw-app-images.tar"
+echo "  - images/zkxw-app-images.tar（zkxw-backend + zkxw-web，web 含 /oa-h5/）"
 echo "  - deploy/docker/ (compose + .env.example + mysql init)"
 echo "  - docs/sql/zkxw.sql"
 echo "  - 部署指导手册.html（客户安装手册，浏览器打开）"
@@ -0,0 +1,15 @@
+# Web Admin Docker 构建环境（vite build --mode docker）
+# 同域 Nginx 反代：浏览器只访问宿主机 8112
+
+VITE_WITH_CREDENTIALS=false
+
+VITE_API_ENCRYPT_ENABLED=false
+VITE_API_ENCRYPT_FAIL_OPEN=false
+# VITE_API_ENCRYPT_FIXED_SECRET=
+
+VITE_DROP_CONSOLE=true
+
+VITE_BASE_URL=/
+VITE_API_URL=/api
+VITE_ACCESS_MODE=frontend
+VITE_MINIO_BASE_URL=/minio/zkxw
@@ -1048,7 +1048,7 @@
      "label": "checkCompleteProductionWorkOrderGate()",
      "file_type": "code",
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L36"
+      "source_location": "L38"
    },
    {
      "id": "utils_sample_production_reception_fields_ts",
@@ -3262,12 +3262,19 @@
      "source_file": "utils/production-complete-work-order-gate-logic.ts",
      "source_location": "L7"
    },
+    {
+      "id": "utils_production_complete_work_order_gate_logic_classifytasksforcompleteworkordergate",
+      "label": "classifyTasksForCompleteWorkOrderGate()",
+      "file_type": "code",
+      "source_file": "utils/production-complete-work-order-gate-logic.ts",
+      "source_location": "L18"
+    },
    {
      "id": "utils_production_complete_work_order_gate_logic_findtaskstepgateissue",
      "label": "findTaskStepGateIssue()",
      "file_type": "code",
      "source_file": "utils/production-complete-work-order-gate-logic.ts",
-      "source_location": "L12"
+      "source_location": "L31"
    },
    {
      "id": "utils_sample_reception_lab_storage_code_ts",
@@ -27573,7 +27580,7 @@
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L36",
+      "source_location": "L38",
      "weight": 1.0
    },
    {
@@ -31986,13 +31993,22 @@
      "source_location": "L7",
      "weight": 1.0
    },
+    {
+      "source": "utils_production_complete_work_order_gate_logic_ts",
+      "target": "utils_production_complete_work_order_gate_logic_classifytasksforcompleteworkordergate",
+      "relation": "contains",
+      "confidence": "EXTRACTED",
+      "source_file": "utils/production-complete-work-order-gate-logic.ts",
+      "source_location": "L18",
+      "weight": 1.0
+    },
    {
      "source": "utils_production_complete_work_order_gate_logic_ts",
      "target": "utils_production_complete_work_order_gate_logic_findtaskstepgateissue",
      "relation": "contains",
      "confidence": "EXTRACTED",
      "source_file": "utils/production-complete-work-order-gate-logic.ts",
-      "source_location": "L12",
+      "source_location": "L31",
      "weight": 1.0
    },
    {
@@ -73555,7 +73571,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L39",
+      "source_location": "L41",
      "weight": 1.0
    },
    {
@@ -73565,7 +73581,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L48",
+      "source_location": "L50",
      "weight": 1.0
    },
    {
@@ -73575,7 +73591,17 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L67",
+      "source_location": "L69",
+      "weight": 1.0
+    },
+    {
+      "source": "utils_production_complete_work_order_gate_checkcompleteproductionworkordergate",
+      "target": "utils_production_complete_work_order_gate_logic_classifytasksforcompleteworkordergate",
+      "relation": "calls",
+      "confidence": "INFERRED",
+      "confidence_score": 0.8,
+      "source_file": "utils/production-complete-work-order-gate.ts",
+      "source_location": "L74",
      "weight": 1.0
    },
    {
@@ -73585,7 +73611,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "utils/production-complete-work-order-gate.ts",
-      "source_location": "L92",
+      "source_location": "L94",
      "weight": 1.0
    },
    {
@@ -74585,7 +74611,7 @@
      "confidence": "INFERRED",
      "confidence_score": 0.8,
      "source_file": "utils/production-complete-work-order-gate-logic.ts",
-      "source_location": "L16",
+      "source_location": "L35",
      "weight": 1.0
    },
    {
@@ -1,11 +1,11 @@
-# Graph Report - src  (2026-09-02)
+# Graph Report - src  (2026-09-11)

 ## Corpus Check
- Large corpus: 1000 files · ~659,950 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.
+- Large corpus: 1000 files · ~660,141 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.

 ## Summary
- 3601 nodes · 5135 edges · 73 communities detected
- Extraction: 78% EXTRACTED · 22% INFERRED · 0% AMBIGUOUS · INFERRED: 1133 edges (avg confidence: 0.8)
+- 3602 nodes · 5137 edges · 69 communities detected
+- Extraction: 78% EXTRACTED · 22% INFERRED · 0% AMBIGUOUS · INFERRED: 1134 edges (avg confidence: 0.8)
 - Token cost: 0 input · 0 output

 ## Community Hubs (Navigation)
@@ -51,37 +51,33 @@
 - [[_COMMUNITY_Community 39|Community 39]]
 - [[_COMMUNITY_Community 40|Community 40]]
 - [[_COMMUNITY_Community 41|Community 41]]
- [[_COMMUNITY_Community 42|Community 42]]
 - [[_COMMUNITY_Community 43|Community 43]]
 - [[_COMMUNITY_Community 44|Community 44]]
 - [[_COMMUNITY_Community 45|Community 45]]
- [[_COMMUNITY_Community 47|Community 47]]
+- [[_COMMUNITY_Community 46|Community 46]]
 - [[_COMMUNITY_Community 48|Community 48]]
- [[_COMMUNITY_Community 49|Community 49]]
- [[_COMMUNITY_Community 50|Community 50]]
+- [[_COMMUNITY_Community 51|Community 51]]
 - [[_COMMUNITY_Community 52|Community 52]]
+- [[_COMMUNITY_Community 54|Community 54]]
 - [[_COMMUNITY_Community 55|Community 55]]
 - [[_COMMUNITY_Community 56|Community 56]]
+- [[_COMMUNITY_Community 57|Community 57]]
 - [[_COMMUNITY_Community 58|Community 58]]
 - [[_COMMUNITY_Community 59|Community 59]]
 - [[_COMMUNITY_Community 60|Community 60]]
- [[_COMMUNITY_Community 61|Community 61]]
 - [[_COMMUNITY_Community 62|Community 62]]
- [[_COMMUNITY_Community 63|Community 63]]
- [[_COMMUNITY_Community 64|Community 64]]
- [[_COMMUNITY_Community 66|Community 66]]
+- [[_COMMUNITY_Community 65|Community 65]]
 - [[_COMMUNITY_Community 67|Community 67]]
- [[_COMMUNITY_Community 70|Community 70]]
- [[_COMMUNITY_Community 76|Community 76]]
+- [[_COMMUNITY_Community 72|Community 72]]
+- [[_COMMUNITY_Community 74|Community 74]]
+- [[_COMMUNITY_Community 75|Community 75]]
+- [[_COMMUNITY_Community 77|Community 77]]
 - [[_COMMUNITY_Community 78|Community 78]]
 - [[_COMMUNITY_Community 79|Community 79]]
- [[_COMMUNITY_Community 81|Community 81]]
- [[_COMMUNITY_Community 82|Community 82]]
 - [[_COMMUNITY_Community 83|Community 83]]
- [[_COMMUNITY_Community 86|Community 86]]
+- [[_COMMUNITY_Community 96|Community 96]]
+- [[_COMMUNITY_Community 99|Community 99]]
 - [[_COMMUNITY_Community 100|Community 100]]
- [[_COMMUNITY_Community 103|Community 103]]
- [[_COMMUNITY_Community 104|Community 104]]

 ## God Nodes (most connected - your core abstractions)
 1. `get()` - 317 edges
@@ -111,23 +107,23 @@

 ### Community 0 - "Community 0"
 Cohesion: 0.0
-Nodes (206): fetchAccessLogList(), fetchActiveRegions(), fetchCategoryList(), fetchCategoryParameters(), fetchCellProductPriceList(), fetchCellProductSpecList(), fetchCellProductTypeList(), fetchChannelAccount() (+198 more)
+Nodes (205): fetchAccessLogList(), fetchActiveRegions(), fetchCategoryList(), fetchCategoryParameters(), fetchCellProductPriceList(), fetchCellProductSpecList(), fetchCellProductTypeList(), fetchChannelAccount() (+197 more)

 ### Community 1 - "Community 1"
 Cohesion: 0.03
-Nodes (93): fetchUploadAttachment(), FireworkSystem, handleReportUpload(), handleReportUpload(), walk(), async(), addDispatchItem(), createDispatchItem() (+85 more)
+Nodes (90): fetchUploadAttachment(), handleReportUpload(), handleReportUpload(), walk(), if(), async(), addDispatchItem(), createDispatchItem() (+82 more)

 ### Community 2 - "Community 2"
-Cohesion: 0.02
-Nodes (92): batchSavePilotCheckup(), deletePilotCheckupActualItem(), fetchCheckupInstitutionList(), fetchCheckupInstitutionPackageDetail(), fetchCheckupInstitutionPackages(), fetchPilotCheckupDetail(), fetchPilotCheckupList(), fetchUpdatePostBoundRoles() (+84 more)
+Cohesion: 0.03
+Nodes (87): batchSavePilotCheckup(), deletePilotCheckupActualItem(), fetchCheckupInstitutionList(), fetchCheckupInstitutionPackageDetail(), fetchCheckupInstitutionPackages(), fetchPilotCheckupDetail(), fetchPilotCheckupList(), markPilotCheckupChecked() (+79 more)

 ### Community 3 - "Community 3"
 Cohesion: 0.02
-Nodes (69): collectIds(), buildInboundBasicSection(), buildInboundCellStorageViewSections(), buildInboundResearchDonationViewSections(), buildReceptionSection(), buildTransportSection(), resolveInboundProtocolStatus(), buildBaseFields() (+61 more)
+Nodes (73): fetchCheckupInstitutionInvoices(), fetchCheckupInstitutionProjects(), fetchCreateCheckupInstitution(), fetchCreateCheckupInstitutionInvoice(), fetchCreateCheckupInstitutionProject(), fetchUpdateCheckupInstitution(), fetchUpdateCheckupInstitutionInvoice(), fetchUpdateCheckupInstitutionProject() (+65 more)

 ### Community 4 - "Community 4"
 Cohesion: 0.02
-Nodes (58): fetchProductionTaskList(), fetchProductionWasteOutputList(), fetchProductionReceptionBySampleCode(), fetchProductionReceptionSubmit(), fetchProductionReceptionUpdate(), handleDialogClose(), nodeSummary(), onAdd() (+50 more)
+Nodes (60): fetchProductionTaskList(), fetchProductionWasteOutputList(), fetchProductionReceptionBySampleCode(), fetchProductionReceptionSubmit(), fetchProductionReceptionUpdate(), handleDialogClose(), nodeSummary(), onAdd() (+52 more)

 ### Community 5 - "Community 5"
 Cohesion: 0.02
@@ -135,325 +131,311 @@ Nodes (64): fetchBatchDeleteOaReceiveAccounts(), fetchBatchMarkOaCcTasksRead(),

 ### Community 6 - "Community 6"
 Cohesion: 0.03
-Nodes (65): fetchCellSampleTypeList(), fetchCheckupInstitutionInvoices(), fetchCheckupInstitutionProjects(), fetchCreateCellSampleType(), fetchCreateCheckupInstitution(), fetchCreateCheckupInstitutionInvoice(), fetchCreateCheckupInstitutionProject(), fetchDeleteCellSampleType() (+57 more)
+Nodes (79): fetchEthnicList(), formatNowDatetime(), applyDonationBundleToForm(), createEmptyTransport(), ensureEthnicOptionInList(), handleOpenForAdd(), if(), loadEthnicOptions() (+71 more)

 ### Community 7 - "Community 7"
 Cohesion: 0.03
-Nodes (60): useSettingsHandlers(), useSettingsPanel(), useSettingsState(), useCeremony(), useTheme(), if(), branchConditionLines(), collectConditionReferencedFields() (+52 more)
+Nodes (41): fetchGetMenuList(), useSettingsHandlers(), useSettingsPanel(), useSettingsState(), ComponentLoader, IframeRouteManager, MenuProcessor, RouteRegistry (+33 more)

 ### Community 8 - "Community 8"
 Cohesion: 0.03
-Nodes (42): fetchGetMenuList(), fetchGetMenuCodes(), fetchGetUserInfo(), fetchLogin(), fetchUpdateProfile(), fetchUploadProfileAvatar(), MenuProcessor, RoutePermissionValidator (+34 more)
+Nodes (39): handleBlur(), handleFocus(), handleInput(), fetchQcMaterialBatchDetail(), fetchQcMaterialBatchList(), fetchQcMaterialBatchOptions(), fetchQcMaterialList(), fetchQcMaterialOptions() (+31 more)

 ### Community 9 - "Community 9"
 Cohesion: 0.03
-Nodes (56): fetchMyProductionTasks(), fetchMyQcTaskList(), fetchQcTaskDetail(), fetchQcTaskList(), fetchMineTasksForWorkOrders(), useInboundSiblingNavigation(), shouldApplyTriggerSourceFilter(), useQcWorkOrderTabPage() (+48 more)
+Nodes (58): fetchUpdatePostBoundRoles(), fetchOaRelatedSummaries(), RoutePermissionValidator, if(), branchConditionLines(), collectConditionReferencedFields(), collectFormConditionReferencedFields(), flattenFormRules() (+50 more)

 ### Community 10 - "Community 10"
-Cohesion: 0.03
-Nodes (59): fetchFullmoonTodoList(), fetchUpdateFullmoonTodoInsurance(), fetchCollectionProtocolAuditList(), fetchCollectionProtocolDetail(), fetchCollectionProtocolList(), fetchCreateProtocolInvoiceRequest(), fetchInvoiceEligiblePayments(), fetchPaymentDetailList() (+51 more)
+Cohesion: 0.04
+Nodes (47): fetchCreateMenu(), fetchDeleteMenu(), fetchMenuTree(), fetchUpdateMenu(), collectIds(), buildInboundBasicSection(), buildInboundCellStorageViewSections(), buildInboundResearchDonationViewSections() (+39 more)

 ### Community 11 - "Community 11"
-Cohesion: 0.03
-Nodes (56): fetchEthnicList(), formatNowDatetime(), formatHandoverUserLabel(), formatNowDatetime(), fullFileUrl(), handlePreviewAttachment(), isVideoFile(), resetHandoverForm() (+48 more)
+Cohesion: 0.04
+Nodes (46): buildBaseFields(), buildInboundBasicSection(), buildInboundCellStorageProductionViewSections(), buildInboundResearchDonationProductionViewSections(), buildOutboundBasicExperimentProductionViewSections(), buildOutboundClinicalProductionViewSections(), buildOutboundDetail(), buildOutboundPilotProductionViewSections() (+38 more)

 ### Community 12 - "Community 12"
-Cohesion: 0.04
-Nodes (53): buildTemporaryViewSections(), buildInsertedSiblingCard(), resolveShowProtocolPaymentAtGroup(), appendTaskResultSections(), batchTasksForPanelSlot(), buildConfiguredOnlySection(), for(), set() (+45 more)
+Cohesion: 0.03
+Nodes (49): fetchAttachmentDownloadUrl(), qcAttachmentFullUrl(), qcDownloadAttachment(), qcPreviewAttachment(), formatHandoverUserLabel(), formatNowDatetime(), fullFileUrl(), handleDownloadAttachment() (+41 more)

 ### Community 13 - "Community 13"
 Cohesion: 0.04
-Nodes (61): fetchDeptTree(), fetchUserList(), fetchOaFlowPreview(), fetchOaTemplateDetail(), remoteSearchHandoverUsers(), flowNeedsInitiatorSelect(), loadFlowPreview(), loadUsers() (+53 more)
+Nodes (53): fetchMyProductionTasks(), fetchMyQcTaskList(), fetchQcTaskDetail(), fetchQcTaskList(), fetchMineTasksForWorkOrders(), useInboundSiblingNavigation(), shouldApplyTriggerSourceFilter(), useQcWorkOrderTabPage() (+45 more)

 ### Community 14 - "Community 14"
 Cohesion: 0.04
-Nodes (33): handleBlur(), handleFocus(), handleInput(), fetchDeleteMaterialBatch(), fetchMaterialBatchList(), fetchMaterialBatchOptions(), fetchMaterialList(), fetchMaterialOptions() (+25 more)
+Nodes (51): buildTemporaryViewSections(), buildInsertedSiblingCard(), resolveShowProtocolPaymentAtGroup(), batchTasksForPanelSlot(), for(), set(), gateWorkOrder(), sampleTabStatusLabel() (+43 more)

 ### Community 15 - "Community 15"
 Cohesion: 0.05
-Nodes (34): fetchClinicalPaymentDetail(), fetchClinicalPayments(), fetchClinicalReceiptConfirmed(), fetchClinicalReceiptPending(), fetchClinicalRefundConfirmed(), fetchClinicalRefundPending(), fetchOrderAdjusts(), fetchOrderDetail() (+26 more)
+Nodes (60): fetchDeptTree(), fetchUserList(), fetchOaFlowPreview(), fetchOaTemplateDetail(), remoteSearchHandoverUsers(), flowNeedsInitiatorSelect(), loadFlowPreview(), loadUsers() (+52 more)

 ### Community 16 - "Community 16"
 Cohesion: 0.05
-Nodes (39): fetchCreateQcInspectionItemTemplate(), fetchDeleteQcInspectionItemTemplate(), fetchQcInspectionItemTemplateDetail(), fetchQcInspectionItemTemplateList(), fetchQcInspectionItemTemplatesActive(), fetchUpdateQcInspectionItemTemplate(), fetchQcLabTestItemList(), fetchQcLabTestItemsActive() (+31 more)
+Nodes (53): fetchGetMenuCodes(), fetchGetUserInfo(), fetchLogin(), fetchRefreshToken(), fetchUpdateProfile(), fetchUploadProfileAvatar(), toLogin(), fetchUserInfo() (+45 more)

 ### Community 17 - "Community 17"
-Cohesion: 0.07
-Nodes (43): fetchOaRelatedSummaries(), buildFormRows(), buildOaPrintFilename(), buildOaPrintModel(), canvasToPdf(), ensurePlainObject(), exportOaApprovalPdf(), extractUrls() (+35 more)
+Cohesion: 0.04
+Nodes (44): fetchFullmoonTodoList(), fetchUpdateFullmoonTodoInsurance(), fetchCollectionProtocolAuditList(), fetchCollectionProtocolDetail(), fetchCollectionProtocolList(), fetchCreateProtocolInvoiceRequest(), fetchInvoiceEligiblePayments(), fetchPaymentDetailList() (+36 more)

 ### Community 18 - "Community 18"
-Cohesion: 0.06
-Nodes (40): fetchCreateCustomer(), fetchCustomerList(), fetchDeleteCustomer(), fetchUpdateCustomer(), updateInfusionScheduleStatus(), handleAdd(), handleDelete(), handleDropdownCommand() (+32 more)
+Cohesion: 0.05
+Nodes (34): fetchClinicalPaymentDetail(), fetchClinicalPayments(), fetchClinicalReceiptConfirmed(), fetchClinicalReceiptPending(), fetchClinicalRefundConfirmed(), fetchClinicalRefundPending(), fetchOrderAdjusts(), fetchOrderDetail() (+26 more)

 ### Community 19 - "Community 19"
-Cohesion: 0.08
-Nodes (37): formatDatetimeToMinute(), handleChineseDatetimePaste(), parseChineseDatetimeText(), parseBirthOrder(), parseChineseNumeral(), addSampleHint(), earliestCollectTime(), isMaternalBloodEmpty() (+29 more)
+Cohesion: 0.05
+Nodes (33): fetchMineProductionWorkOrderTabStepCounts(), fetchMineProductionWorkOrderTabStepCountsDeduped(), fetchProductionWorkOrderCellProductOptions(), fetchProductionWorkOrderDetail(), fetchProductionWorkOrderList(), fetchProductionWorkOrderQcDispatchOptions(), fetchProductionWorkOrderQcInfo(), fetchProductionWorkOrderTabStepCounts() (+25 more)

 ### Community 20 - "Community 20"
-Cohesion: 0.06
-Nodes (22): fetchQcMaterialBatchDetail(), fetchQcMaterialBatchList(), fetchQcMaterialBatchOptions(), fetchQcMaterialList(), fetchQcMaterialOptions(), fetchUpdateQcMaterialBatch(), fetchMarkQcMaterialUsageFullyUsed(), financeAttachmentsToUrlString() (+14 more)
+Cohesion: 0.05
+Nodes (39): fetchCreateQcInspectionItemTemplate(), fetchDeleteQcInspectionItemTemplate(), fetchQcInspectionItemTemplateDetail(), fetchQcInspectionItemTemplateList(), fetchQcInspectionItemTemplatesActive(), fetchUpdateQcInspectionItemTemplate(), fetchQcLabTestItemList(), fetchQcLabTestItemsActive() (+31 more)

 ### Community 21 - "Community 21"
-Cohesion: 0.1
-Nodes (2): WebSocketClient, TableCache
+Cohesion: 0.06
+Nodes (39): fetchCreateCustomer(), fetchCustomerList(), fetchDeleteCustomer(), fetchUpdateCustomer(), updateInfusionScheduleStatus(), handleAdd(), handleDelete(), handleDropdownCommand() (+31 more)

 ### Community 22 - "Community 22"
 Cohesion: 0.08
-Nodes (33): fetchRefreshToken(), toLogin(), base64ToBytes(), bytesToBase64(), decryptJson(), deriveKey(), encryptJson(), fromBase64Url() (+25 more)
+Nodes (37): formatDatetimeToMinute(), handleChineseDatetimePaste(), parseChineseDatetimeText(), parseBirthOrder(), parseChineseNumeral(), addSampleHint(), earliestCollectTime(), isMaternalBloodEmpty() (+29 more)

 ### Community 23 - "Community 23"
-Cohesion: 0.07
-Nodes (13): fetchProductionWorkOrderQcInfo(), dash(), fmtMoney(), auditorDisplay(), dash(), ensureUnitsInOptions(), expressName(), formatYm() (+5 more)
+Cohesion: 0.08
+Nodes (34): buildFormRows(), buildOaPrintFilename(), buildOaPrintModel(), canvasToPdf(), ensurePlainObject(), exportOaApprovalPdf(), extractUrls(), formatFieldValue() (+26 more)

 ### Community 24 - "Community 24"
+Cohesion: 0.1
+Nodes (2): WebSocketClient, TableCache
+
+### Community 25 - "Community 25"
 Cohesion: 0.09
 Nodes (8): getDefaultLanguage(), checkStorageCompatibility(), StorageConfig, getSystemStorage(), getSysVersion(), StorageKeyManager, StorageCompatibilityManager, validateStorageData()

-### Community 25 - "Community 25"
-Cohesion: 0.08
-Nodes (12): ComponentLoader, IframeRouteManager, RouteTransformer, getFirstMenuPath(), getFirstSecondLevelMenuPath(), isIframe(), isNavigableMenuItem(), isWorkbenchMenuItem() (+4 more)
-
 ### Community 26 - "Community 26"
-Cohesion: 0.08
-Nodes (20): fetchAttachmentDownloadUrl(), attachmentFullUrl(), dash(), handleAttachmentDownload(), handleAttachmentPreview(), ensureUniqueZipEntryName(), fetchAttachmentBlob(), getAttachmentExtension() (+12 more)
-
-### Community 27 - "Community 27"
 Cohesion: 0.09
 Nodes (29): fetchAddTaskStep(), fetchCopyTaskStep(), fetchDeleteTaskStep(), fetchDispatchProductionTaskSteps(), fetchForwardProductionTask(), fetchProductionTaskDetail(), fetchProductionTaskEditorInit(), fetchReassignProductionTask() (+21 more)

-### Community 28 - "Community 28"
-Cohesion: 0.08
-Nodes (22): fetchMineProductionWorkOrderTabStepCounts(), fetchMineProductionWorkOrderTabStepCountsDeduped(), fetchProductionWorkOrderCellProductOptions(), fetchProductionWorkOrderDetail(), fetchProductionWorkOrderList(), fetchProductionWorkOrderQcDispatchOptions(), fetchProductionWorkOrderTabStepCounts(), fetchProductionWorkOrderTabStepCountsDeduped() (+14 more)
+### Community 27 - "Community 27"
+Cohesion: 0.07
+Nodes (19): fetchDeleteMaterialBatch(), fetchMaterialBatchList(), fetchMaterialBatchOptions(), fetchMaterialList(), fetchMaterialOptions(), fetchUpdateMaterialBatch(), fetchMaterialUsageList(), fetchMyMaterialUsageList() (+11 more)

-### Community 29 - "Community 29"
+### Community 28 - "Community 28"
 Cohesion: 0.08
 Nodes (20): createEmptySnapshots(), normalizeConfiguredReagents(), normalizeConsumables(), normalizeDataCollections(), normalizeReagents(), normalizeStepOutputs(), serializeAttachments(), serializeEquipmentIds() (+12 more)

-### Community 30 - "Community 30"
+### Community 29 - "Community 29"
 Cohesion: 0.09
 Nodes (27): completePilotApplication(), deletePilotApplication(), fetchPilotApplicationList(), startPilotApplication(), voidPilotApplication(), handleBatchComplete(), handleBatchStart(), handleBatchVoid() (+19 more)

-### Community 31 - "Community 31"
+### Community 30 - "Community 30"
 Cohesion: 0.09
 Nodes (22): fetchOaAppList(), fetchOaGroupList(), fetchPublishOaApp(), loadData(), loadGroups(), resetForm(), onSuccess(), goBack() (+14 more)

-### Community 32 - "Community 32"
+### Community 31 - "Community 31"
 Cohesion: 0.1
 Nodes (21): displayPeople(), nodeStatusText(), personLines(), personStatusHint(), personTitle(), showNodeComment(), signBadge(), signBadgeText() (+13 more)

-### Community 33 - "Community 33"
+### Community 32 - "Community 32"
 Cohesion: 0.09
 Nodes (12): fetchMineQcWorkOrderTabUnfinishedCounts(), fetchOutboundQcDetail(), fetchQcWorkOrderDetail(), fetchQcWorkOrderList(), fetchQcWorkOrdersBySample(), fetchQcWorkOrderTabUnfinishedCounts(), reload(), reloadTabCounts() (+4 more)

-### Community 34 - "Community 34"
-Cohesion: 0.13
-Nodes (19): fetchCreateMenu(), fetchDeleteMenu(), fetchMenuTree(), fetchUpdateMenu(), postorder(), preorder(), applyTreeExpand(), handleAdd() (+11 more)
-
-### Community 35 - "Community 35"
-Cohesion: 0.1
-Nodes (12): fetchOutboundReleaseMaterial(), fetchOutboundReleaseReviewDetail(), fetchOutboundReleaseReviewList(), fetchReleaseReviewList(), handleReset(), handleSearch(), handleTabChange(), handleToggleSelect() (+4 more)
-
-### Community 36 - "Community 36"
+### Community 33 - "Community 33"
 Cohesion: 0.12
 Nodes (15): addCopyButton(), highlightCode(), insertLineNumbers(), isBlockProcessed(), markBlockAsProcessed(), processBlock(), setupHighlightDirective(), setupRippleDirective() (+7 more)

-### Community 37 - "Community 37"
-Cohesion: 0.14
-Nodes (14): if(), calcTripLegDays(), dayIndex(), emptyTripLeg(), endOffset(), startOffset(), sumTripLegDays(), buildTripKitChildren() (+6 more)
+### Community 34 - "Community 34"
+Cohesion: 0.13
+Nodes (18): fetchCellSampleTypeList(), fetchCreateCellSampleType(), fetchDeleteCellSampleType(), fetchUpdateCellSampleType(), handleAdd(), handleDelete(), handleDropdownCommand(), handleEdit() (+10 more)

-### Community 38 - "Community 38"
+### Community 35 - "Community 35"
 Cohesion: 0.2
 Nodes (14): applyFlagToRule(), applySchema(), countRules(), getActiveRule(), getDesigner(), getSetupState(), onMessage(), readFlag() (+6 more)

-### Community 39 - "Community 39"
-Cohesion: 0.16
-Nodes (14): fetchCreateEnvDetectItem(), fetchDeleteEnvDetectItem(), fetchEnvDetectItemDetail(), fetchEnvDetectItemList(), fetchEnvDetectItemsActive(), fetchUpdateEnvDetectItem(), handleAdd(), handleBatchDelete() (+6 more)
-
-### Community 40 - "Community 40"
+### Community 36 - "Community 36"
 Cohesion: 0.12
 Nodes (6): setupOaConfirmationKit(), ensureOaKitMenu(), setupOaLeaveKit(), setupOaOvertimeKit(), setupOaResignationKit(), setupOaTripKit()

-### Community 41 - "Community 41"
+### Community 37 - "Community 37"
 Cohesion: 0.16
 Nodes (10): useTable(), useTableImpl(), getColumnChecks(), useTableColumns(), createErrorHandler(), createSmartDebounce(), defaultResponseAdapter(), extractPagination() (+2 more)

-### Community 42 - "Community 42"
+### Community 38 - "Community 38"
 Cohesion: 0.27
 Nodes (14): useChart(), useChartComponent(), useChartOps(), colourBlend(), getCssVar(), getDarkColor(), getLightColor(), handleElementThemeColor() (+6 more)

-### Community 43 - "Community 43"
+### Community 39 - "Community 39"
 Cohesion: 0.33
 Nodes (13): buildProtocolPaymentFlowSteps(), dash(), financeReceiptTime(), formatAmount(), hasFinanceReceipt(), hasFinanceRefund(), hasReceiptSubmit(), hasRefundSubmit() (+5 more)

-### Community 44 - "Community 44"
+### Community 40 - "Community 40"
 Cohesion: 0.19
 Nodes (6): fetchServiceOrderTxnList(), handleReset(), handleSearch(), handleTabChange(), loadData(), switchTab()

-### Community 45 - "Community 45"
+### Community 41 - "Community 41"
 Cohesion: 0.24
 Nodes (10): buildPrintDocumentHtml(), cleanupPrintIframe(), embedSopImagesAsDataUrls(), getSopA4ContentHeightPx(), getSopA4EditorHeightPx(), normalizeSopCheckboxes(), prepareSopHtmlForPrint(), printSopHtml() (+2 more)

-### Community 47 - "Community 47"
-Cohesion: 0.24
-Nodes (8): fullFileUrl(), handlePreviewAttachment(), isVideoFile(), normalizeDisplayValue(), resolveReviewCellType(), resolveReviewQuantity(), resolveReviewSpecText(), uniqueJoined()
-
-### Community 48 - "Community 48"
-Cohesion: 0.33
-Nodes (7): buildSheetColumns(), downloadOaHistoryExcel(), exportTimestamp(), pad(), sanitizeFilename(), styleHeaderCell(), writeHeaderRows()
-
-### Community 49 - "Community 49"
+### Community 43 - "Community 43"
 Cohesion: 0.31
 Nodes (4): isSlotAvailable(), resolveStorageSlotRangeFill(), slotFacilityNodeId(), sortBoxSlots()

-### Community 50 - "Community 50"
+### Community 44 - "Community 44"
+Cohesion: 0.25
+Nodes (3): companyProgressTagType(), companyProgressText(), companyGroupProgress()
+
+### Community 45 - "Community 45"
 Cohesion: 0.25
 Nodes (2): handleTouchEnd(), setTransition()

-### Community 52 - "Community 52"
+### Community 46 - "Community 46"
+Cohesion: 0.28
+Nodes (1): FireworkSystem
+
+### Community 48 - "Community 48"
 Cohesion: 0.28
 Nodes (4): isActiveHistoryInstance(), isUploadPreviewLabel(), previewColumnMinWidth(), syncWorktabTitle()

-### Community 55 - "Community 55"
+### Community 51 - "Community 51"
 Cohesion: 0.39
 Nodes (6): isIgnorableScriptError(), normalizeErrorMessage(), registerPromiseErrorHandler(), registerResourceErrorHandler(), scriptErrorHandler(), setupErrorHandle()

-### Community 56 - "Community 56"
+### Community 52 - "Community 52"
 Cohesion: 0.36
 Nodes (1): TableHeightCalculator

-### Community 58 - "Community 58"
+### Community 54 - "Community 54"
 Cohesion: 0.33
 Nodes (2): logApiCryptoBootInfo(), maskSecret()

-### Community 59 - "Community 59"
+### Community 55 - "Community 55"
 Cohesion: 0.38
 Nodes (4): handleFocus(), handleInput(), parseDecimalToNumber(), sanitizeDecimalInput()

-### Community 60 - "Community 60"
+### Community 56 - "Community 56"
 Cohesion: 0.29
-Nodes (1): fetchQcMonthTemplateList()
+Nodes (2): fetchStorageReleaseReviewDetail(), fetchStorageReleaseReviewList()

-### Community 61 - "Community 61"
+### Community 57 - "Community 57"
 Cohesion: 0.4
 Nodes (2): isUnfinishedQcWorkOrder(), resolveQcWorkOrderUnfinishedBadgeCount()

-### Community 62 - "Community 62"
+### Community 58 - "Community 58"
 Cohesion: 0.47
 Nodes (3): isPaymentDueWithinWarnWindow(), parsePaymentDueYmd(), startOfLocalDay()

-### Community 63 - "Community 63"
+### Community 59 - "Community 59"
 Cohesion: 0.5
 Nodes (2): formatProtocolDocDeleteConfirm(), formatProtocolDocSubject()

-### Community 64 - "Community 64"
+### Community 60 - "Community 60"
 Cohesion: 0.5
 Nodes (2): parseEquipmentIds(), syncEquipmentNamesFromOptions()

-### Community 66 - "Community 66"
+### Community 62 - "Community 62"
 Cohesion: 0.5
 Nodes (2): focusInput(), handleKeydown()

-### Community 67 - "Community 67"
-Cohesion: 0.4
-Nodes (1): fetchQcMaterialAmountAuthUsers()
-
-### Community 70 - "Community 70"
+### Community 65 - "Community 65"
 Cohesion: 0.67
 Nodes (2): if(), logSidebarMenu()

-### Community 76 - "Community 76"
+### Community 67 - "Community 67"
+Cohesion: 0.5
+Nodes (1): fetchQcSmsList()
+
+### Community 72 - "Community 72"
 Cohesion: 1.0
 Nodes (2): getSettingDefaults(), resetToDefaults()

-### Community 78 - "Community 78"
+### Community 74 - "Community 74"
 Cohesion: 1.0
 Nodes (2): buildOvertimeKitChildren(), uniqueId()

-### Community 79 - "Community 79"
+### Community 75 - "Community 75"
 Cohesion: 1.0
 Nodes (2): buildLeaveKitChildren(), uniqueId()

-### Community 81 - "Community 81"
+### Community 77 - "Community 77"
 Cohesion: 1.0
 Nodes (2): buildConfirmationKitChildren(), uniqueId()

-### Community 82 - "Community 82"
+### Community 78 - "Community 78"
 Cohesion: 1.0
 Nodes (2): buildResignationKitChildren(), uniqueId()

-### Community 83 - "Community 83"
+### Community 79 - "Community 79"
 Cohesion: 1.0
 Nodes (2): copyTextToClipboard(), copyTextWithFallback()

-### Community 86 - "Community 86"
+### Community 83 - "Community 83"
 Cohesion: 1.0
 Nodes (2): getSourceProtocolAttachment(), normalizeAttachmentFiles()

-### Community 100 - "Community 100"
+### Community 96 - "Community 96"
 Cohesion: 1.0
 Nodes (2): emptyTabCounts(), useProductionWorkOrderTabStepCounts()

-### Community 103 - "Community 103"
+### Community 99 - "Community 99"
 Cohesion: 1.0
 Nodes (2): initialProgress(), useQcWorkOrderAttachmentExport()

-### Community 104 - "Community 104"
+### Community 100 - "Community 100"
 Cohesion: 1.0
 Nodes (2): emptyTabCounts(), useQcWorkOrderTabUnfinishedCounts()

 ## Knowledge Gaps
- **Thin community `Community 21`** (42 nodes): `WebSocketClient`, `.calculateReconnectDelay()`, `.clearAllTimers()`, `.clearConnectionTimers()`, `.clearTimer()`, `.close()`, `.closeCurrentSocketForReconnect()`, `.connect()`, `.connectionStatusText()`, `.constructor()`, `.destroyInstance()`, `.flushMessageQueue()`, `.getInstance()`, `.getReadyStateText()`, `.handleClose()`, `.handleConnectionTimeout()`, `.handleError()`, `.handleMessage()`, `.handleOpen()`, `.init()`, `.isWebSocketConnected()`, `.reconnect()`, `.resetHeartbeat()`, `.send()`, `.startHeartbeat()`, `.startPing()`, `TableCache`, `.cleanupExpired()`, `.clear()`, `.clearByTags()`, `.clearCurrentSearch()`, `.clearPagination()`, `.constructor()`, `.evictLRU()`, `.generateKey()`, `.generateTags()`, `.get()`, `.getStats()`, `.log()`, `.set()`, `index.ts`, `tableCache.ts`
+- **Thin community `Community 24`** (42 nodes): `WebSocketClient`, `.calculateReconnectDelay()`, `.clearAllTimers()`, `.clearConnectionTimers()`, `.clearTimer()`, `.close()`, `.closeCurrentSocketForReconnect()`, `.connect()`, `.connectionStatusText()`, `.constructor()`, `.destroyInstance()`, `.flushMessageQueue()`, `.getInstance()`, `.getReadyStateText()`, `.handleClose()`, `.handleConnectionTimeout()`, `.handleError()`, `.handleMessage()`, `.handleOpen()`, `.init()`, `.isWebSocketConnected()`, `.reconnect()`, `.resetHeartbeat()`, `.send()`, `.startHeartbeat()`, `.startPing()`, `TableCache`, `.cleanupExpired()`, `.clear()`, `.clearByTags()`, `.clearCurrentSearch()`, `.clearPagination()`, `.constructor()`, `.evictLRU()`, `.generateKey()`, `.generateTags()`, `.get()`, `.getStats()`, `.log()`, `.set()`, `index.ts`, `tableCache.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 50`** (9 nodes): `cleanupEventListeners()`, `handleTouchEnd()`, `handleTouchMove()`, `handleTouchStart()`, `handleWheelScroll()`, `if()`, `setTransition()`, `setupEventListeners()`, `index.vue`
+- **Thin community `Community 45`** (9 nodes): `cleanupEventListeners()`, `handleTouchEnd()`, `handleTouchMove()`, `handleTouchStart()`, `handleWheelScroll()`, `if()`, `setTransition()`, `setupEventListeners()`, `index.vue`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 56`** (8 nodes): `TableHeightCalculator`, `.calculate()`, `.calculateOffset()`, `.calculatePaginationOffset()`, `.constructor()`, `.getHeaderHeight()`, `useTableHeight()`, `useTableHeight.ts`
+- **Thin community `Community 46`** (9 nodes): `FireworkSystem`, `.constructor()`, `.createFirework()`, `.createParticle()`, `.getAvailableParticle()`, `.initializePool()`, `.preloadAllImages()`, `.preloadImage()`, `index.vue`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 58`** (7 nodes): `App.vue`, `main.ts`, `refreshButtonAutoIcons()`, `refreshPanelTitleIcons()`, `logApiCryptoBootInfo()`, `maskSecret()`, `console.ts`
+- **Thin community `Community 52`** (8 nodes): `TableHeightCalculator`, `.calculate()`, `.calculateOffset()`, `.calculatePaginationOffset()`, `.constructor()`, `.getHeaderHeight()`, `useTableHeight()`, `useTableHeight.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 60`** (7 nodes): `fetchConfirmQcMonthImport()`, `fetchCreateQcMonthTemplate()`, `fetchDeleteQcMonthTemplate()`, `fetchPreviewQcMonthImport()`, `fetchQcMonthTemplateList()`, `fetchUpdateQcMonthTemplate()`, `qc-material-month-template.ts`
+- **Thin community `Community 54`** (7 nodes): `App.vue`, `main.ts`, `refreshButtonAutoIcons()`, `refreshPanelTitleIcons()`, `logApiCryptoBootInfo()`, `maskSecret()`, `console.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 61`** (6 nodes): `formatQcWorkOrderUnfinishedBadgeCount()`, `isUnfinishedQcWorkOrder()`, `qcWorkOrderUnfinishedBadgeTitle()`, `resolveQcWorkOrderUnfinishedBadgeCount()`, `sumQcWorkOrderGroupUnfinishedBadgeCount()`, `qc-work-order-unfinished-badge.ts`
+- **Thin community `Community 56`** (7 nodes): `batchReviewStorageRelease()`, `batchStoreSample()`, `fetchStorageReleaseReviewDetail()`, `fetchStorageReleaseReviewList()`, `storeSample()`, `submitStorageReleaseReview()`, `storage-release-review.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 63`** (5 nodes): `formatProtocolDocBatchDeleteConfirm()`, `formatProtocolDocDeleteConfirm()`, `formatProtocolDocSubject()`, `getProtocolDocTypeLabel()`, `protocol-doc-label.ts`
+- **Thin community `Community 57`** (6 nodes): `formatQcWorkOrderUnfinishedBadgeCount()`, `isUnfinishedQcWorkOrder()`, `qcWorkOrderUnfinishedBadgeTitle()`, `resolveQcWorkOrderUnfinishedBadgeCount()`, `sumQcWorkOrderGroupUnfinishedBadgeCount()`, `qc-work-order-unfinished-badge.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 64`** (5 nodes): `equipmentOptionLabel()`, `joinEquipmentIds()`, `parseEquipmentIds()`, `syncEquipmentNamesFromOptions()`, `equipment-select.ts`
+- **Thin community `Community 59`** (5 nodes): `formatProtocolDocBatchDeleteConfirm()`, `formatProtocolDocDeleteConfirm()`, `formatProtocolDocSubject()`, `getProtocolDocTypeLabel()`, `protocol-doc-label.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 66`** (5 nodes): `focusInput()`, `handleKeydown()`, `if()`, `search()`, `index.vue`
+- **Thin community `Community 60`** (5 nodes): `equipmentOptionLabel()`, `joinEquipmentIds()`, `parseEquipmentIds()`, `syncEquipmentNamesFromOptions()`, `equipment-select.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 67`** (5 nodes): `fetchBatchRevokeQcMaterialAmountAuth()`, `fetchGrantQcMaterialAmountAuth()`, `fetchQcMaterialAmountAuthUsers()`, `fetchRevokeQcMaterialAmountAuth()`, `qc-material-amount-auth.ts`
+- **Thin community `Community 62`** (5 nodes): `focusInput()`, `handleKeydown()`, `if()`, `search()`, `index.vue`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 70`** (4 nodes): `if()`, `logSidebarMenu()`, `index.vue`, `SidebarSubmenu.vue`
+- **Thin community `Community 65`** (4 nodes): `if()`, `logSidebarMenu()`, `index.vue`, `SidebarSubmenu.vue`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 76`** (3 nodes): `getSettingDefaults()`, `resetToDefaults()`, `setting.ts`
+- **Thin community `Community 67`** (4 nodes): `fetchGenerateQcSms()`, `fetchQcSmsList()`, `fetchToggleQcSmsNotified()`, `qc-sms-notification.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 78`** (3 nodes): `buildOvertimeKitChildren()`, `oa-overtime-kit-rule.ts`, `uniqueId()`
+- **Thin community `Community 72`** (3 nodes): `getSettingDefaults()`, `resetToDefaults()`, `setting.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 79`** (3 nodes): `buildLeaveKitChildren()`, `oa-leave-kit-rule.ts`, `uniqueId()`
+- **Thin community `Community 74`** (3 nodes): `buildOvertimeKitChildren()`, `oa-overtime-kit-rule.ts`, `uniqueId()`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 81`** (3 nodes): `buildConfirmationKitChildren()`, `oa-confirmation-kit-rule.ts`, `uniqueId()`
+- **Thin community `Community 75`** (3 nodes): `buildLeaveKitChildren()`, `oa-leave-kit-rule.ts`, `uniqueId()`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 82`** (3 nodes): `buildResignationKitChildren()`, `oa-resignation-kit-rule.ts`, `uniqueId()`
+- **Thin community `Community 77`** (3 nodes): `buildConfirmationKitChildren()`, `oa-confirmation-kit-rule.ts`, `uniqueId()`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 83`** (3 nodes): `copyTextToClipboard()`, `copyTextWithFallback()`, `copy-text.ts`
+- **Thin community `Community 78`** (3 nodes): `buildResignationKitChildren()`, `oa-resignation-kit-rule.ts`, `uniqueId()`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 86`** (3 nodes): `getSourceProtocolAttachment()`, `normalizeAttachmentFiles()`, `protocol-source-attachment.ts`
+- **Thin community `Community 79`** (3 nodes): `copyTextToClipboard()`, `copyTextWithFallback()`, `copy-text.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 100`** (3 nodes): `emptyTabCounts()`, `useProductionWorkOrderTabStepCounts()`, `useProductionWorkOrderTabStepCounts.ts`
+- **Thin community `Community 83`** (3 nodes): `getSourceProtocolAttachment()`, `normalizeAttachmentFiles()`, `protocol-source-attachment.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 103`** (3 nodes): `initialProgress()`, `useQcWorkOrderAttachmentExport()`, `useQcWorkOrderAttachmentExport.ts`
+- **Thin community `Community 96`** (3 nodes): `emptyTabCounts()`, `useProductionWorkOrderTabStepCounts()`, `useProductionWorkOrderTabStepCounts.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 104`** (3 nodes): `emptyTabCounts()`, `useQcWorkOrderTabUnfinishedCounts()`, `useQcWorkOrderTabUnfinishedCounts.ts`
+- **Thin community `Community 99`** (3 nodes): `initialProgress()`, `useQcWorkOrderAttachmentExport()`, `useQcWorkOrderAttachmentExport.ts`
+  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
+- **Thin community `Community 100`** (3 nodes): `emptyTabCounts()`, `useQcWorkOrderTabUnfinishedCounts()`, `useQcWorkOrderTabUnfinishedCounts.ts`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.

 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_

- **Why does `push()` connect `Community 1` to `Community 0`, `Community 2`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 16`, `Community 17`, `Community 19`, `Community 21`, `Community 22`, `Community 23`, `Community 26`, `Community 27`, `Community 28`, `Community 29`, `Community 30`, `Community 31`, `Community 32`, `Community 33`, `Community 37`, `Community 48`?**
-  _High betweenness centrality (0.334) - this node is a cross-community bridge._
- **Why does `get()` connect `Community 0` to `Community 1`, `Community 2`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `Community 20`, `Community 23`, `Community 27`, `Community 28`, `Community 30`, `Community 31`, `Community 33`, `Community 34`, `Community 35`, `Community 39`, `Community 44`, `Community 49`, `Community 60`, `Community 67`?**
-  _High betweenness centrality (0.242) - this node is a cross-community bridge._
- **Why does `updateSelect()` connect `Community 4` to `Community 1`, `Community 7`?**
-  _High betweenness centrality (0.028) - this node is a cross-community bridge._
+- **Why does `push()` connect `Community 1` to `Community 0`, `Community 2`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 19`, `Community 20`, `Community 22`, `Community 23`, `Community 24`, `Community 26`, `Community 28`, `Community 29`, `Community 30`, `Community 31`, `Community 32`, `Community 46`?**
+  _High betweenness centrality (0.339) - this node is a cross-community bridge._
+- **Why does `get()` connect `Community 0` to `Community 1`, `Community 2`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 8`, `Community 9`, `Community 10`, `Community 13`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `Community 19`, `Community 20`, `Community 21`, `Community 26`, `Community 27`, `Community 29`, `Community 30`, `Community 32`, `Community 34`, `Community 40`, `Community 43`, `Community 56`, `Community 67`?**
+  _High betweenness centrality (0.239) - this node is a cross-community bridge._
+- **Why does `handleDynamicRoutes()` connect `Community 7` to `Community 32`, `Community 5`, `Community 9`, `Community 11`, `Community 16`, `Community 19`, `Community 23`?**
+  _High betweenness centrality (0.039) - this node is a cross-community bridge._
 - **Are the 316 inferred relationships involving `get()` (e.g. with `resolveStorageSlotRangeFill()` and `buildNodeCodePathFromFlat()`) actually correct?**
  _`get()` has 316 INFERRED edges - model-reasoned connections that need verification._
 - **Are the 127 inferred relationships involving `push()` (e.g. with `refreshQcMenuBadges()` and `collectLeafFacilityNodesInTreeOrder()`) actually correct?**
@@ -57,12 +57,12 @@
    </div>
    <div id="legend"></div>
  </div>
-  <div id="stats">3601 nodes &middot; 5135 edges &middot; 399 communities</div>
+  <div id="stats">3602 nodes &middot; 5137 edges &middot; 395 communities</div>
 </div>
 <script>
-const RAW_NODES = [{"id": "app_vue", "label": "App.vue", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "App.vue", "community": 58, "community_name": "Community 58", "source_file": "App.vue", "file_type": "code", "degree": 3}, {"id": "src_app_refreshbuttonautoicons", "label": "refreshButtonAutoIcons()", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "refreshButtonAutoIcons()", "community": 58, "community_name": "Community 58", "source_file": "App.vue", "file_type": "code", "degree": 1}, {"id": "src_app_refreshpaneltitleicons", "label": "refreshPanelTitleIcons()", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "refreshPanelTitleIcons()", "community": 58, "community_name": "Community 58", "source_file": "App.vue", "file_type": "code", "degree": 1}, {"id": "main_ts", "label": "main.ts", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.4, "font": {"size": 0, "color": "#ffffff"}, "title": "main.ts", "community": 58, "community_name": "Community 58", "source_file": "main.ts", "file_type": "code", "degree": 4}, {"id": "src_main_masksecret", "label": "maskSecret()", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "maskSecret()", "community": 58, "community_name": "Community 58", "source_file": "main.ts", "file_type": "code", "degree": 2}, {"id": "src_main_logapicryptobootinfo", "label": "logApiCryptoBootInfo()", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "logApiCryptoBootInfo()", "community": 58, "community_name": "Community 58", "source_file": "main.ts", "file_type": "code", "degree": 2}, {"id": "env_d_ts", "label": "env.d.ts", "color": {"background": "#E15759", "border": "#E15759", "highlight": {"background": "#ffffff", "border": "#E15759"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "env.d.ts", "community": 152, "community_name": "Community 152", "source_file": "env.d.ts", "file_type": "code", "degree": 0}, {"id": "shims_loose_d_ts", "label": "shims-loose.d.ts", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "shims-loose.d.ts", "community": 153, "community_name": "Community 153", "source_file": "shims-loose.d.ts", "file_type": "code", "degree": 0}, {"id": "directives_index_ts", "label": "index.ts", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "index.ts", "community": 36, "community_name": "Community 36", "source_file": "directives/index.ts", "file_type": "code", "degree": 1}, {"id": "directives_index_setupglobdirectives", "label": "setupGlobDirectives()", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 10.5, "font": {"size": 0, "color": "#ffffff"}, "title": "setupGlobDirectives()", "community": 36, "community_name": "Community 36", "source_file": "directives/index.ts", "file_type": "code", "degree": 5}, {"id": "directives_core_roles_ts", "label": "roles.ts", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "roles.ts", "community": 36, "community_name": "Community 36", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 3}, {"id": "core_roles_checkrolepermission", "label": "checkRolePermission()", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "checkRolePermission()", "community": 36, "community_name": "Community 36", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 2}, {"id": "core_roles_removeelement", "label": "removeElement()", "color": {"background": "#B07AA1", "border": "#B07AA1", "highlight": {"background": "#ffffff", "border": "#B07AA1"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "removeElement()", "community": 36, "community_name": "Community 36", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 2}, {"id": "core_roles_setuprolesdirective",Line truncated
-const RAW_EDGES = [{"from": "app_vue", "to": "src_app_refreshbuttonautoicons", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_vue", "to": "src_app_refreshpaneltitleicons", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_vue", "to": "main_ts", "label": "imports_from", "title": "imports_from [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "utils_sys_console_ts", "label": "imports_from", "title": "imports_from [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "src_main_masksecret", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "src_main_logapicryptobootinfo", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "src_main_masksecret", "to": "src_main_logapicryptobootinfo", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_index_ts", "to": "directives_index_setupglobdirectives", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_index_setupglobdirectives", "to": "core_auth_setupauthdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "core_roles_setuprolesdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "business_highlight_setuphighlightdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "business_ripple_setuprippledirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_core_roles_ts", "to": "core_roles_checkrolepermission", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_roles_ts", "to": "core_roles_removeelement", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_roles_ts", "to": "core_roles_setuprolesdirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "core_roles_checkrolepermission", "to": "core_roles_removeelement", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_checkauthpermission", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_removeelement", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_setupauthdirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "core_auth_checkauthpermission", "to": "core_auth_removeelement", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_ripple_ts", "to": "business_ripple_setuprippledirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_highlightcode", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_insertlinenumbers", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_addcopybutton", "label": "contains", "title": "contains [EXTRACTED]", "dLine truncated
-const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "Community 0", "count": 566}, {"cid": 1, "color": "#F28E2B", "label": "Community 1", "count": 133}, {"cid": 2, "color": "#E15759", "label": "Community 2", "count": 130}, {"cid": 3, "color": "#76B7B2", "label": "Community 3", "count": 129}, {"cid": 4, "color": "#59A14F", "label": "Community 4", "count": 116}, {"cid": 5, "color": "#EDC948", "label": "Community 5", "count": 110}, {"cid": 6, "color": "#B07AA1", "label": "Community 6", "count": 99}, {"cid": 7, "color": "#FF9DA7", "label": "Community 7", "count": 96}, {"cid": 8, "color": "#9C755F", "label": "Community 8", "count": 92}, {"cid": 9, "color": "#BAB0AC", "label": "Community 9", "count": 90}, {"cid": 10, "color": "#4E79A7", "label": "Community 10", "count": 90}, {"cid": 11, "color": "#F28E2B", "label": "Community 11", "count": 89}, {"cid": 12, "color": "#E15759", "label": "Community 12", "count": 86}, {"cid": 13, "color": "#76B7B2", "label": "Community 13", "count": 72}, {"cid": 14, "color": "#59A14F", "label": "Community 14", "count": 71}, {"cid": 15, "color": "#EDC948", "label": "Community 15", "count": 61}, {"cid": 16, "color": "#B07AA1", "label": "Community 16", "count": 57}, {"cid": 17, "color": "#FF9DA7", "label": "Community 17", "count": 54}, {"cid": 18, "color": "#9C755F", "label": "Community 18", "count": 53}, {"cid": 19, "color": "#BAB0AC", "label": "Community 19", "count": 47}, {"cid": 20, "color": "#4E79A7", "label": "Community 20", "count": 46}, {"cid": 21, "color": "#F28E2B", "label": "Community 21", "count": 42}, {"cid": 22, "color": "#E15759", "label": "Community 22", "count": 41}, {"cid": 23, "color": "#76B7B2", "label": "Community 23", "count": 40}, {"cid": 24, "color": "#59A14F", "label": "Community 24", "count": 37}, {"cid": 25, "color": "#EDC948", "label": "Community 25", "count": 37}, {"cid": 26, "color": "#B07AA1", "label": "Community 26", "count": 36}, {"cid": 27, "color": "#FF9DA7", "label": "Community 27", "count": 36}, {"cid": 28, "color": "#9C755F", "label": "Community 28", "count": 35}, {"cid": 29, "color": "#BAB0AC", "label": "Community 29", "count": 35}, {"cid": 30, "color": "#4E79A7", "label": "Community 30", "count": 34}, {"cid": 31, "color": "#F28E2B", "label": "Community 31", "count": 33}, {"cid": 32, "color": "#E15759", "label": "Community 32", "count": 31}, {"cid": 33, "color": "#76B7B2", "label": "Community 33", "count": 25}, {"cid": 34, "color": "#59A14F", "label": "Community 34", "count": 24}, {"cid": 35, "color": "#EDC948", "label": "Community 35", "count": 24}, {"cid": 36, "color": "#B07AA1", "label": "Community 36", "count": 22}, {"cid": 37, "color": "#FF9DA7", "label": "Community 37", "count": 21}, {"cid": 38, "color": "#9C755F", "label": "Community 38", "count": 19}, {"cid": 39, "color": "#BAB0AC", "label": "Community 39", "count": 19}, {"cid": 40, "color": "#4E79A7", "label": "Community 40", "count": 17}, {"cid": 41, "color": "#F28E2B", "label": "Community 41", "count": 17}, {"cid": 42, "color": "#E15759", "label": "Community 42", "count": 16}, {"cid": 43, "color": "#76B7B2", "label": "Community 43", "count": 14}, {"cid": 44, "color": "#59A14F", "label": "Community 44", "count": 14}, {"cid": 45, "color": "#EDC948", "label": "Community 45", "count": 13}, {"cid": 46, "color": "#B07AA1", "label": "Community 46", "count": 13}, {"cid": 47, "color": "#FF9DA7", "label": "Community 47", "count": 13}, {"cid": 48, "color": "#9C755F", "label": "Community 48", "count": 10}, {"cid": 49, "color": "#BAB0AC", "label": "Community 49", "count": 9}, {"cid": 50, "color": "#4E79A7", "label": "Community 50", "count": 9}, {"cid": 51, "color": "#F28E2B", "label": "Community 51", "count": 9}, {"cid": 52, "color": "#E15759", "label": "Community 52", "count": 9}, {"cid": 53, "color": "#76B7B2", "label": "Community 53", "count": 9}, {"cid": 54, "color": "#59A14F", "label": "Community 54", "count": 9}, {"cid": 55, "color": "#EDC948", "label": "Community 55", "count": 8}, {"cid": 56, "color": "#B07AA1", "label": "Community 56", "count": 8}, {"cid": 57, "color": "#FF9DA7", "label": "Community 57", "count": 8}, {"cid": 58, "color": "#9C755F", "label": "Community 58", "count": 7}, {"cid": 59, "color": "#BAB0AC", "label": "Community 59", "count": 7}, {"cid": 60, "color": "#4E79A7", "label": "Community 60", "count": 7}, {"cid": 61, "color": "#F28E2B", "label": "Community 61", "count": 6}, {"cid": 62, "color": "#E15759", "label": "Community 62", "count": 6}, {"cid": 63, "color": "#76B7B2", "label": "Community 63", "count": 5}, {"cid": 64, "color": "#59A14F", "label": "Community 64", "count": 5}, {"cid": 65, "color": "#EDC948", "label": "Community 65", "count": 5}, {"cid": 66, "color": "#B07AA1", "label": "Community 66", "count": 5}, {"cid": 67, "color": "#FF9DA7", "label": "Community 67", "count": 5}, {"cid": 68, "color": "#9C755F", "label": "Community 68", "count": 4}, {"cid": 69, "color": "#BAB0AC", "label": "Community 69", "count": 4}, {"cid": 70, "color": "#4E79A7", "label": "CommunLine truncated
+const RAW_NODES = [{"id": "app_vue", "label": "App.vue", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "App.vue", "community": 54, "community_name": "Community 54", "source_file": "App.vue", "file_type": "code", "degree": 3}, {"id": "src_app_refreshbuttonautoicons", "label": "refreshButtonAutoIcons()", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "refreshButtonAutoIcons()", "community": 54, "community_name": "Community 54", "source_file": "App.vue", "file_type": "code", "degree": 1}, {"id": "src_app_refreshpaneltitleicons", "label": "refreshPanelTitleIcons()", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "refreshPanelTitleIcons()", "community": 54, "community_name": "Community 54", "source_file": "App.vue", "file_type": "code", "degree": 1}, {"id": "main_ts", "label": "main.ts", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.4, "font": {"size": 0, "color": "#ffffff"}, "title": "main.ts", "community": 54, "community_name": "Community 54", "source_file": "main.ts", "file_type": "code", "degree": 4}, {"id": "src_main_masksecret", "label": "maskSecret()", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "maskSecret()", "community": 54, "community_name": "Community 54", "source_file": "main.ts", "file_type": "code", "degree": 2}, {"id": "src_main_logapicryptobootinfo", "label": "logApiCryptoBootInfo()", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "logApiCryptoBootInfo()", "community": 54, "community_name": "Community 54", "source_file": "main.ts", "file_type": "code", "degree": 2}, {"id": "env_d_ts", "label": "env.d.ts", "color": {"background": "#9C755F", "border": "#9C755F", "highlight": {"background": "#ffffff", "border": "#9C755F"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "env.d.ts", "community": 148, "community_name": "Community 148", "source_file": "env.d.ts", "file_type": "code", "degree": 0}, {"id": "shims_loose_d_ts", "label": "shims-loose.d.ts", "color": {"background": "#BAB0AC", "border": "#BAB0AC", "highlight": {"background": "#ffffff", "border": "#BAB0AC"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "shims-loose.d.ts", "community": 149, "community_name": "Community 149", "source_file": "shims-loose.d.ts", "file_type": "code", "degree": 0}, {"id": "directives_index_ts", "label": "index.ts", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "index.ts", "community": 33, "community_name": "Community 33", "source_file": "directives/index.ts", "file_type": "code", "degree": 1}, {"id": "directives_index_setupglobdirectives", "label": "setupGlobDirectives()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.5, "font": {"size": 0, "color": "#ffffff"}, "title": "setupGlobDirectives()", "community": 33, "community_name": "Community 33", "source_file": "directives/index.ts", "file_type": "code", "degree": 5}, {"id": "directives_core_roles_ts", "label": "roles.ts", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "roles.ts", "community": 33, "community_name": "Community 33", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 3}, {"id": "core_roles_checkrolepermission", "label": "checkRolePermission()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "checkRolePermission()", "community": 33, "community_name": "Community 33", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 2}, {"id": "core_roles_removeelement", "label": "removeElement()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "removeElement()", "community": 33, "community_name": "Community 33", "source_file": "directives/core/roles.ts", "file_type": "code", "degree": 2}, {"id": "core_roles_setuprolesdirective",Line truncated
+const RAW_EDGES = [{"from": "app_vue", "to": "src_app_refreshbuttonautoicons", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_vue", "to": "src_app_refreshpaneltitleicons", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_vue", "to": "main_ts", "label": "imports_from", "title": "imports_from [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "utils_sys_console_ts", "label": "imports_from", "title": "imports_from [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "src_main_masksecret", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "main_ts", "to": "src_main_logapicryptobootinfo", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "src_main_masksecret", "to": "src_main_logapicryptobootinfo", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_index_ts", "to": "directives_index_setupglobdirectives", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_index_setupglobdirectives", "to": "core_auth_setupauthdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "core_roles_setuprolesdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "business_highlight_setuphighlightdirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_index_setupglobdirectives", "to": "business_ripple_setuprippledirective", "label": "calls", "title": "calls [INFERRED]", "dashes": true, "width": 1, "color": {"opacity": 0.35}, "confidence": "INFERRED"}, {"from": "directives_core_roles_ts", "to": "core_roles_checkrolepermission", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_roles_ts", "to": "core_roles_removeelement", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_roles_ts", "to": "core_roles_setuprolesdirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "core_roles_checkrolepermission", "to": "core_roles_removeelement", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_checkauthpermission", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_removeelement", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_core_auth_ts", "to": "core_auth_setupauthdirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "core_auth_checkauthpermission", "to": "core_auth_removeelement", "label": "calls", "title": "calls [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_ripple_ts", "to": "business_ripple_setuprippledirective", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_highlightcode", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_insertlinenumbers", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "directives_business_highlight_ts", "to": "business_highlight_addcopybutton", "label": "contains", "title": "contains [EXTRACTED]", "dLine truncated
+const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "Community 0", "count": 567}, {"cid": 1, "color": "#F28E2B", "label": "Community 1", "count": 130}, {"cid": 2, "color": "#E15759", "label": "Community 2", "count": 123}, {"cid": 3, "color": "#76B7B2", "label": "Community 3", "count": 120}, {"cid": 4, "color": "#59A14F", "label": "Community 4", "count": 119}, {"cid": 5, "color": "#EDC948", "label": "Community 5", "count": 110}, {"cid": 6, "color": "#B07AA1", "label": "Community 6", "count": 110}, {"cid": 7, "color": "#FF9DA7", "label": "Community 7", "count": 108}, {"cid": 8, "color": "#9C755F", "label": "Community 8", "count": 101}, {"cid": 9, "color": "#BAB0AC", "label": "Community 9", "count": 88}, {"cid": 10, "color": "#4E79A7", "label": "Community 10", "count": 86}, {"cid": 11, "color": "#F28E2B", "label": "Community 11", "count": 84}, {"cid": 12, "color": "#E15759", "label": "Community 12", "count": 83}, {"cid": 13, "color": "#76B7B2", "label": "Community 13", "count": 82}, {"cid": 14, "color": "#59A14F", "label": "Community 14", "count": 77}, {"cid": 15, "color": "#EDC948", "label": "Community 15", "count": 71}, {"cid": 16, "color": "#B07AA1", "label": "Community 16", "count": 69}, {"cid": 17, "color": "#FF9DA7", "label": "Community 17", "count": 69}, {"cid": 18, "color": "#9C755F", "label": "Community 18", "count": 61}, {"cid": 19, "color": "#BAB0AC", "label": "Community 19", "count": 57}, {"cid": 20, "color": "#4E79A7", "label": "Community 20", "count": 57}, {"cid": 21, "color": "#F28E2B", "label": "Community 21", "count": 51}, {"cid": 22, "color": "#E15759", "label": "Community 22", "count": 47}, {"cid": 23, "color": "#76B7B2", "label": "Community 23", "count": 44}, {"cid": 24, "color": "#59A14F", "label": "Community 24", "count": 42}, {"cid": 25, "color": "#EDC948", "label": "Community 25", "count": 37}, {"cid": 26, "color": "#B07AA1", "label": "Community 26", "count": 36}, {"cid": 27, "color": "#FF9DA7", "label": "Community 27", "count": 35}, {"cid": 28, "color": "#9C755F", "label": "Community 28", "count": 35}, {"cid": 29, "color": "#BAB0AC", "label": "Community 29", "count": 34}, {"cid": 30, "color": "#4E79A7", "label": "Community 30", "count": 33}, {"cid": 31, "color": "#F28E2B", "label": "Community 31", "count": 31}, {"cid": 32, "color": "#E15759", "label": "Community 32", "count": 25}, {"cid": 33, "color": "#76B7B2", "label": "Community 33", "count": 22}, {"cid": 34, "color": "#59A14F", "label": "Community 34", "count": 22}, {"cid": 35, "color": "#EDC948", "label": "Community 35", "count": 19}, {"cid": 36, "color": "#B07AA1", "label": "Community 36", "count": 17}, {"cid": 37, "color": "#FF9DA7", "label": "Community 37", "count": 17}, {"cid": 38, "color": "#9C755F", "label": "Community 38", "count": 16}, {"cid": 39, "color": "#BAB0AC", "label": "Community 39", "count": 14}, {"cid": 40, "color": "#4E79A7", "label": "Community 40", "count": 14}, {"cid": 41, "color": "#F28E2B", "label": "Community 41", "count": 13}, {"cid": 42, "color": "#E15759", "label": "Community 42", "count": 13}, {"cid": 43, "color": "#76B7B2", "label": "Community 43", "count": 9}, {"cid": 44, "color": "#59A14F", "label": "Community 44", "count": 9}, {"cid": 45, "color": "#EDC948", "label": "Community 45", "count": 9}, {"cid": 46, "color": "#B07AA1", "label": "Community 46", "count": 9}, {"cid": 47, "color": "#FF9DA7", "label": "Community 47", "count": 9}, {"cid": 48, "color": "#9C755F", "label": "Community 48", "count": 9}, {"cid": 49, "color": "#BAB0AC", "label": "Community 49", "count": 9}, {"cid": 50, "color": "#4E79A7", "label": "Community 50", "count": 9}, {"cid": 51, "color": "#F28E2B", "label": "Community 51", "count": 8}, {"cid": 52, "color": "#E15759", "label": "Community 52", "count": 8}, {"cid": 53, "color": "#76B7B2", "label": "Community 53", "count": 8}, {"cid": 54, "color": "#59A14F", "label": "Community 54", "count": 7}, {"cid": 55, "color": "#EDC948", "label": "Community 55", "count": 7}, {"cid": 56, "color": "#B07AA1", "label": "Community 56", "count": 7}, {"cid": 57, "color": "#FF9DA7", "label": "Community 57", "count": 6}, {"cid": 58, "color": "#9C755F", "label": "Community 58", "count": 6}, {"cid": 59, "color": "#BAB0AC", "label": "Community 59", "count": 5}, {"cid": 60, "color": "#4E79A7", "label": "Community 60", "count": 5}, {"cid": 61, "color": "#F28E2B", "label": "Community 61", "count": 5}, {"cid": 62, "color": "#E15759", "label": "Community 62", "count": 5}, {"cid": 63, "color": "#76B7B2", "label": "Community 63", "count": 4}, {"cid": 64, "color": "#59A14F", "label": "Community 64", "count": 4}, {"cid": 65, "color": "#EDC948", "label": "Community 65", "count": 4}, {"cid": 66, "color": "#B07AA1", "label": "Community 66", "count": 4}, {"cid": 67, "color": "#FF9DA7", "label": "Community 67", "count": 4}, {"cid": 68, "color": "#9C755F", "label": "Community 68", "count": 4}, {"cid": 69, "color": "#BAB0AC", "label": "Community 69", "count": 4}, {"cid": 70, "color": "#4E79A7", "label": "CommunityLine truncated

 // HTML-escape helper — prevents XSS when injecting graph data into innerHTML
 function esc(s) {
@@ -17,8 +17,8 @@
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/common/index.ts": 1781272556.3597305,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/directive/directive.d.ts": 1781272556.3601494,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/api/api.d.ts": 1781272556.3606477,
-  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/import/components.d.ts": 1788326759.6784778,
-  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/import/auto-imports.d.ts": 1788326691.0045059,
+  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/import/components.d.ts": 1788849928.4684184,
+  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/import/auto-imports.d.ts": 1788848629.6992872,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/store/index.ts": 1787887312.735774,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/types/router/index.ts": 1787887320.8486114,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/composables/useAttachmentActions.ts": 1788162977.6691713,
@@ -53,7 +53,7 @@
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/user-avatar.ts": 1781403605.517818,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/fullscreen-loading.ts": 1781272556.3849921,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/chinese-numeral-parse.ts": 1782960575.662593,
-  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate.ts": 1788327947.933196,
+  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate.ts": 1788849799.6596105,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/sample-production-reception-fields.ts": 1788159521.6461987,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-flow-preview-refresh.ts": 1786590578.7629158,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-upload-file-type.ts": 1786413851.5280254,
@@ -102,7 +102,7 @@
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-receive-account-value.ts": 1785390441.8286228,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/datetime-display.ts": 1782806208.3904786,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-form-value-display.test.ts": 1786364545.4796336,
-  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate-logic.ts": 1788327879.123915,
+  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate-logic.ts": 1788849790.2824821,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/sample-reception-lab-storage-code.ts": 1782378453.1031013,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/outbound-qc-pilot-view-sections.ts": 1781566346.7618802,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-app-icons.ts": 1785992369.9430938,
@@ -144,7 +144,7 @@
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/qc-company-task-group.ts": 1788330359.4652264,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-post-value.ts": 1785394332.7419252,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/attachment-zip.ts": 1788162981.821378,
-  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate.test.ts": 1788327892.0457087,
+  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/production-complete-work-order-gate.test.ts": 1788849780.0109205,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/numeric-input-parse.ts": 1782179343.5953708,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/oa-dept-value.ts": 1785148503.1442196,
  "/Users/wuzilong/work/00code/zkxw/web-admin/src/utils/index.ts": 1781272556.410244,
@@ -9,6 +9,25 @@ export function needsProductionReceptionGate(row: ProductionWorkOrderItem): bool
  return src === 'cell_storage' || src === 'research_donation'
 }

+export type CompleteWorkOrderTaskListDecision =
+  | { kind: 'no_tasks' }
+  | { kind: 'all_done' }
+  | { kind: 'check_incomplete'; incomplete: Record<string, any>[] }
+
+/** 完成工单任务门禁：无任务拦截；仅剩已完成/已作废则放行；否则校验未完成任务步骤。 */
+export function classifyTasksForCompleteWorkOrderGate(
+  tasks: Record<string, any>[]
+): CompleteWorkOrderTaskListDecision {
+  const list = Array.isArray(tasks) ? tasks : []
+  if (!list.length) return { kind: 'no_tasks' }
+  const incomplete = list.filter((t) => {
+    const status = String(t.taskStatus || '').trim()
+    return status !== 'yzf' && status !== 'ywc'
+  })
+  if (!incomplete.length) return { kind: 'all_done' }
+  return { kind: 'check_incomplete', incomplete }
+}
+
 export function findTaskStepGateIssue(detail: Record<string, any>): {
  message: string
  stepId?: string
@@ -1,10 +1,43 @@
 import { describe, it } from 'node:test'
 import assert from 'node:assert/strict'
 import {
+  classifyTasksForCompleteWorkOrderGate,
  findTaskStepGateIssue,
  needsProductionReceptionGate
 } from './production-complete-work-order-gate-logic'

+describe('classifyTasksForCompleteWorkOrderGate', () => {
+  it('no_tasks when list empty', () => {
+    assert.deepEqual(classifyTasksForCompleteWorkOrderGate([]), { kind: 'no_tasks' })
+  })
+
+  it('all_done when only completed or voided tasks remain', () => {
+    assert.deepEqual(
+      classifyTasksForCompleteWorkOrderGate([
+        { id: '1', taskStatus: 'ywc' },
+        { id: '2', taskStatus: 'yzf' }
+      ]),
+      { kind: 'all_done' }
+    )
+  })
+
+  it('check_incomplete returns unfinished tasks only', () => {
+    const decision = classifyTasksForCompleteWorkOrderGate([
+      { id: '1', taskStatus: 'ywc' },
+      { id: '2', taskStatus: 'dpz' },
+      { id: '3', taskStatus: 'jxz' },
+      { id: '4', taskStatus: 'yzf' }
+    ])
+    assert.equal(decision.kind, 'check_incomplete')
+    if (decision.kind === 'check_incomplete') {
+      assert.deepEqual(
+        decision.incomplete.map((t) => t.id),
+        ['2', '3']
+      )
+    }
+  })
+})
+
 describe('needsProductionReceptionGate', () => {
  it('true for cell_storage and research_donation', () => {
    assert.equal(needsProductionReceptionGate({ receptionSource: 'cell_storage' } as any), true)
@@ -8,11 +8,13 @@ import {
 } from '@/api/production-task'
 import { fetchProductionReceptionBySampleCode } from '@/api/sample-production-reception'
 import {
+  classifyTasksForCompleteWorkOrderGate,
  findTaskStepGateIssue,
  needsProductionReceptionGate
 } from '@/utils/production-complete-work-order-gate-logic'

 export {
+  classifyTasksForCompleteWorkOrderGate,
  findTaskStepGateIssue,
  needsProductionReceptionGate
 } from '@/utils/production-complete-work-order-gate-logic'
@@ -69,19 +71,19 @@ export async function checkCompleteProductionWorkOrderGate(
    pageSize: 100,
    includeStepSummary: true
  })
-  const tasks = (tasksRes?.list || []).filter((t: Record<string, any>) => {
-    const status = String(t.taskStatus || '').trim()
-    return status !== 'yzf' && status !== 'ywc'
-  })
-
-  if (!tasks.length) {
+  const taskDecision = classifyTasksForCompleteWorkOrderGate(tasksRes?.list || [])
+  if (taskDecision.kind === 'no_tasks') {
    return {
      ok: false,
      action: 'no_tasks',
      message: '请先派发生产任务后再完成工单'
    }
  }
+  if (taskDecision.kind === 'all_done') {
+    return { ok: true }
+  }

+  const tasks = taskDecision.incomplete
  const details = await Promise.all(
    tasks.map((t: Record<string, any>) => fetchProductionTaskDetail(String(t.id)))
  )
@@ -0,0 +1,83 @@
+# v1.1.0 内网部署步骤（192.168.200.24）
+
+> 依据：`200.24-小程序部署前信息调查.md`  
+> 目标：增量更新 backend + web（含 `/oa-h5/`），写入微信生产配置，**不改**数据卷与端口映射。
+
+## 链路（不改映射）
+
+```text
+用户/微信
+  → https://xwyd.zkxw.cn （39.102.214.125 Nginx 整站反代）
+  → http://112.30.112.8:60001
+  → http://192.168.200.24:8112  （Docker web 容器）
+```
+
+- 内网映射 `60001→8112`：**不修改**
+- 公网网关：现为整站 `proxy_pass`，**通常不用改**；升级后验收 `/oa-h5/` 即可
+
+## 现网目录
+
+```text
+/opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+```
+
+当前镜像：`zkxw-backend:v1.0.0` / `zkxw-web:v1.0.0`  
+`COMPOSE_PROFILES=full`，`HTTP_PORT=8112`，`MINIO_BASE_URL=/minio/zkxw`
+
+## 发版方（有源码的机器）
+
+```bash
+cd <仓库根目录>
+./scripts/package-docker-deploy.sh v1.1.0
+# 得到 dist/zkxw-docker-deploy-v1.1.0.tar.gz
+```
+
+将 tar 交给用户，由用户上传到 `192.168.200.24`。
+
+## 内网机操作清单
+
+```bash
+# ——— 1. 解压并 load 镜像 ———
+cd /opt/zkxw
+tar -xzf /path/to/zkxw-docker-deploy-v1.1.0.tar.gz
+docker load -i zkxw-docker-deploy-v1.1.0/images/zkxw-app-images.tar
+docker images | grep zkxw-
+
+# ——— 2. 备份并编辑现网 .env ———
+cd /opt/zkxw/zkxw-docker-deploy-v1.0.0/deploy/docker
+cp -a .env ".env.bak.$(date +%Y%m%d%H%M%S)"
+
+# 修改/追加（密码等原样保留）：
+# ZKXW_BACKEND_IMAGE=zkxw-backend:v1.1.0
+# ZKXW_WEB_IMAGE=zkxw-web:v1.1.0
+# WXPAY_MINI_APPID=wx2b139581f4c855e4
+# WXPAY_SECRET=<生产小程序 Secret>
+# WX_MP_APPID=wxe576b24f873f47cb
+# WX_MP_SECRET=<生产服务号 Secret>
+# WX_MP_NOTIFY_ENABLED=false
+
+# ——— 3. 滚动应用（不动 mysql/redis/minio 数据）———
+docker compose up -d backend web
+docker compose ps
+
+# ——— 4. 本机验收 ———
+curl -sI http://127.0.0.1:8112/ | head -5
+curl -sI http://127.0.0.1:8112/oa-h5/ | head -5
+curl -s http://127.0.0.1:8112/health
+```
+
+## 公网验收（任意可访问机器）
+
+```bash
+curl -skI https://xwyd.zkxw.cn/ | head -5
+curl -skI https://xwyd.zkxw.cn/oa-h5/ | head -5
+curl -sk https://xwyd.zkxw.cn/health
+```
+
+若本机 `8112/oa-h5/` 正常而公网 404：检查 `39.102.214.125` 上 `xwyd.zkxw.cn.conf` 是否仍为整站反代到 `112.30.112.8:60001`（不要做成仅 `/` 白名单）。
+
+## 微信相关说明
+
+- 模板消息总开关：`WX_MP_NOTIFY_ENABLED=false`（模板未就绪保持关闭）
+- 小程序原生包（`mobile-h5`）需另行用微信开发者工具上传，不在本 Docker tar 内
+- H5 构建已写入生产服务号 AppID：`VITE_WX_MP_APPID=wxe576b24f873f47cb`