提交

backend/app.pid

@@ -1 +1 @@
-17842
+55575

backend/app/api/crm.py

@@ -474,7 +474,8 @@ def customer_create(
         user_id = _user.get("user_id", "") or _user.get("id", "")
         dept_id = _user.get("dept_id", "")
 
-        if customer_name_exists(db, body.customer_name, tenant_no):
+        customer_name = (body.customer_name or "").strip()
+        if customer_name_exists(db, tenant_no, customer_name):
             return error_response(400, "客户名称已存在")
 
         obj = create_customer(
@@ -507,7 +508,9 @@ def customer_update(
         data = body.model_dump(exclude_unset=True)
         customer_id = data.pop("id")
         if "customer_name" in data:
-            if customer_name_exists(db, data["customer_name"], tenant_no, exclude_id=customer_id):
+            customer_name = (data["customer_name"] or "").strip()
+            data["customer_name"] = customer_name
+            if customer_name_exists(db, tenant_no, customer_name, exclude_id=customer_id):
                 return error_response(400, "客户名称已存在")
 
         obj = update_customer(db, customer_id, user_id=user_id, tenant_no=tenant_no, user_info=user_info, **data)

backend/app/crud/crm/clue.py

@@ -463,7 +463,7 @@ def convert_clue(
     user_info=None,
 ) -> dict:
     from app.crud.crm.contact import create_contact
-    from app.crud.crm.customer import check_duplicate_customer, generate_customer_no
+    from app.crud.crm.customer import check_duplicate_customer, customer_name_exists, generate_customer_no
     from app.models.crm_models import CrmCustomer
 
     clue = get_clue(db, clue_id)
@@ -480,6 +480,17 @@ def convert_clue(
             name = dup_customers[0].get("customerName") or dup_customers[0].get("customer_name")
             raise ValueError(f"该手机号已存在客户记录【{name}】，无法转化")
 
+    customer_name = (
+        customer_data.get("customer_name")
+        or clue.company
+        or clue.clue_name
+        or ""
+    ).strip()
+    if not customer_name:
+        raise ValueError("客户名称不能为空")
+    if customer_name_exists(db, tenant_no, customer_name):
+        raise ValueError(f"客户名称【{customer_name}】已存在，无法转化")
+
     now = datetime.now()
     customer_type = (
         customer_data.get("customer_type")
@@ -490,7 +501,7 @@ def convert_clue(
     customer = CrmCustomer(
         id=generate_uuid(),
         customer_no=generate_customer_no(db, tenant_no),
-        customer_name=customer_data.get("customer_name") or clue.company or clue.clue_name or "",
+        customer_name=customer_name,
         customer_type=customer_type,
         mobile=clue.mobile or "",
         email=clue.email or "",

backend/app/crud/crm/customer.py

@@ -421,8 +421,11 @@ def generate_customer_no(db: Session, tenant_no: str) -> str:
 def customer_name_exists(
     db: Session, tenant_no: str, name: str, exclude_id: str = None
 ) -> bool:
+    normalized = (name or "").strip()
+    if not normalized:
+        return False
     q = db.query(CrmCustomer).filter(
-        CrmCustomer.customer_name == name,
+        CrmCustomer.customer_name == normalized,
         CrmCustomer.tenant_no == tenant_no,
         CrmCustomer.del_flag == 0,
     )
@@ -445,7 +448,9 @@ def check_duplicate_customer(
     if mobile:
         or_clauses.append(CrmCustomer.mobile == mobile)
     if customer_name:
-        or_clauses.append(CrmCustomer.customer_name == customer_name)
+        normalized_name = customer_name.strip()
+        if normalized_name:
+            or_clauses.append(CrmCustomer.customer_name == normalized_name)
     if not or_clauses:
         return []
     rows = db.query(CrmCustomer).filter(*conditions).filter(or_(*or_clauses)).all()
@@ -461,6 +466,13 @@ def create_customer(
     dept_id: str = "",
     **kwargs,
 ) -> CrmCustomer:
+    customer_name = (kwargs.get("customer_name") or "").strip()
+    if not customer_name:
+        raise ValueError("客户名称不能为空")
+    if customer_name_exists(db, tenant_no, customer_name):
+        raise ValueError("客户名称已存在")
+    kwargs["customer_name"] = customer_name
+
     customer_no = kwargs.get("customer_no")
     if not customer_no:
         customer_no = generate_customer_no(db, tenant_no)
@@ -542,6 +554,15 @@ def update_customer(
         raise ValueError("客户不存在")
     _ensure_customer_in_scope(db, obj, user_info, obj.tenant_no)
 
+    if "customer_name" in kwargs and kwargs.get("customer_name") is not None:
+        normalized_name = (kwargs.get("customer_name") or "").strip()
+        if not normalized_name:
+            raise ValueError("客户名称不能为空")
+        if normalized_name != (obj.customer_name or "").strip():
+            if customer_name_exists(db, obj.tenant_no, normalized_name, exclude_id=customer_id):
+                raise ValueError("客户名称已存在")
+        kwargs["customer_name"] = normalized_name
+
     # name_pinyin_abbr 单独处理，避免双重赋值
     _updatable = (
         "customer_name", "short_name", "customer_type", "mobile", "telephone",

backend/graphify-out/.graphify_labels.json

@@ -101,35 +101,54 @@
   "99": "redis_client.py",
   "100": "price_letter_detail",
   "101": "tenant.py",
+  "102": "BaseStorage",
   "103": "pl_internal_customer.py",
   "104": "apply_crm_create_by_scope",
   "105": "pool_customer_assign",
   "106": "site.py",
   "107": "apply_pl_scope",
   "108": "statistics.py",
+  "109": "duty.py",
   "110": "list_duty_staff_users",
   "111": "dict_data.py",
+  "112": "merge_duplicate_crm_customers.py",
   "113": "dict_type.py",
+  "114": "mappers.py",
   "115": "site.py",
   "116": "Community 116",
   "117": "price_letter_detail",
   "118": "Community 118",
   "119": "Community 119",
+  "120": "oper_log_decorator.py",
   "121": "post.py",
   "122": "site.py",
   "123": "customer_options",
+  "124": "vehicle_recharge.py",
   "125": "resolve_crm_product",
   "126": "customer_pool.py",
+  "127": "get_current_user_by_token",
   "128": "product_allowed",
   "129": "BaseStorage",
+  "130": "invoice_info.py",
+  "131": "customer_follow.py",
   "132": "context.py",
+  "133": "inventory_id.py",
+  "134": "price_letter_detail",
+  "135": "storage.py",
   "136": "Community 136",
-  "137": "customer_options",
+  "137": "plan_has_incomplete_hazard_cert_exists",
   "138": "Community 138",
   "139": "get_current_user_by_token",
   "140": "UserRole",
+  "141": "redis_client.py",
+  "142": "opportunity_export",
+  "143": "_build_user_info_payload",
+  "144": "config.py",
   "145": "resolve_crm_product",
+  "146": "list_public_vehicle_plates",
   "147": "Community 147",
+  "148": "_UserCRUDCompat",
+  "149": "datetime_parse.py",
   "151": "Community 151",
   "159": "customer_update",
   "162": ".to_tenant_user_dict",

backend/graphify-out/2026-08-24/.graphify_labels.json

@@ -0,0 +1,169 @@
+{
+  "0": "Community 0",
+  "1": "Community 1",
+  "2": "Community 2",
+  "3": "Community 3",
+  "4": "Community 4",
+  "5": "Community 5",
+  "6": "Community 6",
+  "7": "Community 7",
+  "8": "Community 8",
+  "9": "Community 9",
+  "10": "Community 10",
+  "11": "Community 11",
+  "12": "Community 12",
+  "13": "Community 13",
+  "14": "Community 14",
+  "15": "Community 15",
+  "16": "Community 16",
+  "17": "Community 17",
+  "18": "Community 18",
+  "19": "Community 19",
+  "20": "Community 20",
+  "21": "Community 21",
+  "22": "Community 22",
+  "23": "Community 23",
+  "24": "Community 24",
+  "25": "Community 25",
+  "26": "Community 26",
+  "27": "Community 27",
+  "28": "Community 28",
+  "29": "Community 29",
+  "30": "Community 30",
+  "31": "Community 31",
+  "32": "Community 32",
+  "33": "Community 33",
+  "34": "Community 34",
+  "35": "Community 35",
+  "36": "Community 36",
+  "37": "Community 37",
+  "38": "Community 38",
+  "39": "Community 39",
+  "40": "Community 40",
+  "41": "Community 41",
+  "42": "Community 42",
+  "43": "Community 43",
+  "44": "Community 44",
+  "45": "Community 45",
+  "46": "Community 46",
+  "47": "Community 47",
+  "48": "Community 48",
+  "49": "Community 49",
+  "50": "Community 50",
+  "51": "Community 51",
+  "52": "Community 52",
+  "53": "Community 53",
+  "54": "Community 54",
+  "55": "Community 55",
+  "56": "Community 56",
+  "57": "Community 57",
+  "58": "Community 58",
+  "59": "Community 59",
+  "60": "Community 60",
+  "61": "Community 61",
+  "62": "Community 62",
+  "63": "Community 63",
+  "64": "Community 64",
+  "65": "Community 65",
+  "66": "Community 66",
+  "67": "Community 67",
+  "68": "Community 68",
+  "69": "Community 69",
+  "70": "Community 70",
+  "71": "Community 71",
+  "72": "Community 72",
+  "73": "Community 73",
+  "74": "Community 74",
+  "75": "apply_crm_create_by_scope",
+  "76": "opportunity_follow.py",
+  "77": "Community 77",
+  "78": "Community 78",
+  "79": "PlCarrier",
+  "80": "resolve_crm_product",
+  "81": "customer_follow.py",
+  "82": "storage.py",
+  "83": "Community 83",
+  "84": "Community 84",
+  "85": "allocate_next_biz_no",
+  "86": "Community 86",
+  "87": "Community 87",
+  "88": "CrmProduct",
+  "89": "pl_ocr_service.py",
+  "90": "WechatMessageService",
+  "91": "opportunity_product.py",
+  "92": "Community 92",
+  "93": "api_request_log_middleware.py",
+  "94": "assert_contract_editable_for_update",
+  "95": "test_pl_public_link_archived.py",
+  "96": "minio_url.py",
+  "97": "contact.py",
+  "98": "LocalStorage",
+  "99": "redis_client.py",
+  "100": "price_letter_detail",
+  "101": "tenant.py",
+  "102": "BaseStorage",
+  "103": "pl_internal_customer.py",
+  "104": "apply_crm_create_by_scope",
+  "105": "pool_customer_assign",
+  "106": "site.py",
+  "107": "apply_pl_scope",
+  "108": "statistics.py",
+  "110": "list_duty_staff_users",
+  "111": "dict_data.py",
+  "113": "dict_type.py",
+  "115": "site.py",
+  "116": "Community 116",
+  "117": "price_letter_detail",
+  "118": "Community 118",
+  "119": "Community 119",
+  "121": "post.py",
+  "122": "site.py",
+  "123": "customer_options",
+  "125": "resolve_crm_product",
+  "126": "customer_pool.py",
+  "128": "product_allowed",
+  "129": "BaseStorage",
+  "132": "context.py",
+  "136": "Community 136",
+  "138": "Community 138",
+  "139": "get_current_user_by_token",
+  "140": "UserRole",
+  "145": "resolve_crm_product",
+  "147": "Community 147",
+  "151": "Community 151",
+  "159": "customer_update",
+  "162": ".to_tenant_user_dict",
+  "164": "get_client_ip",
+  "166": "code:block1 (/iflytek/shanxia2.0/backend)",
+  "170": "test_quote_approver_setting.py",
+  "173": "resolve_create_time_bounds",
+  "179": "test_pl_vehicle_personnel_photo_schema.py",
+  "206": "crm_quote_pdf.py",
+  "207": "shanxia2.0 后端骨架（FastAPI）",
+  "220": "api_crypto_middleware.py",
+  "237": "order_status_compat.py",
+  "239": "shanxia2.0 Backend 生产部署说明",
+  "246": "db_collation.py",
+  "254": "Activate.ps1",
+  "263": "__init__.py",
+  "264": "__init__.py",
+  "304": "__init__.py",
+  "305": "__init__.py",
+  "306": "__init__.py",
+  "307": "__init__.py",
+  "308": "__init__.py",
+  "309": "__init__.py",
+  "310": "__init__.py",
+  "311": "__init__.py",
+  "312": "__init__.py",
+  "495": "code:bash (cd /path/to/shanxia2.0)",
+  "496": "code:bash (./start-prod.sh status    # 查看状态)",
+  "497": "code:bash (curl -s http://127.0.0.1:9111/health)",
+  "498": "code:bash (cd /iflytek/shanxia2.0/backend)",
+  "499": "code:bash (python -m venv venv)",
+  "500": "code:bash (pip install -r requirements.txt)",
+  "501": "code:env (# 数据库配置)",
+  "502": "code:bash (uvicorn app.main:app --reload --port 8000)",
+  "503": "BaseModel",
+  "504": "PlanResourceSnapshotMixin"
+}

backend/graphify-out/2026-08-24/GRAPH_REPORT.md

@@ -0,0 +1,790 @@
+# Graph Report - backend  (2026-08-24)
+
+## Corpus Check
+- 343 files · ~235,546 words
+- Verdict: corpus is large enough that graph structure adds value.
+
+## Summary
+- 4814 nodes · 18141 edges · 167 communities (151 shown, 16 thin omitted)
+- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 911 edges (avg confidence: 0.52)
+- Token cost: 0 input · 0 output
+
+## Graph Freshness
+- Built from commit: `dd1acdc7`
+- Run `git rev-parse HEAD` and compare to check if the graph is stale.
+- Run `graphify update .` after code changes (no API cost).
+
+## Community Hubs (Navigation)
+- [[_COMMUNITY_Community 0|Community 0]]
+- [[_COMMUNITY_Community 1|Community 1]]
+- [[_COMMUNITY_Community 2|Community 2]]
+- [[_COMMUNITY_Community 3|Community 3]]
+- [[_COMMUNITY_Community 4|Community 4]]
+- [[_COMMUNITY_Community 5|Community 5]]
+- [[_COMMUNITY_Community 6|Community 6]]
+- [[_COMMUNITY_Community 7|Community 7]]
+- [[_COMMUNITY_Community 8|Community 8]]
+- [[_COMMUNITY_Community 9|Community 9]]
+- [[_COMMUNITY_Community 10|Community 10]]
+- [[_COMMUNITY_Community 11|Community 11]]
+- [[_COMMUNITY_Community 12|Community 12]]
+- [[_COMMUNITY_Community 13|Community 13]]
+- [[_COMMUNITY_Community 14|Community 14]]
+- [[_COMMUNITY_Community 15|Community 15]]
+- [[_COMMUNITY_Community 16|Community 16]]
+- [[_COMMUNITY_Community 17|Community 17]]
+- [[_COMMUNITY_Community 18|Community 18]]
+- [[_COMMUNITY_Community 19|Community 19]]
+- [[_COMMUNITY_Community 20|Community 20]]
+- [[_COMMUNITY_Community 21|Community 21]]
+- [[_COMMUNITY_Community 22|Community 22]]
+- [[_COMMUNITY_Community 23|Community 23]]
+- [[_COMMUNITY_Community 24|Community 24]]
+- [[_COMMUNITY_Community 25|Community 25]]
+- [[_COMMUNITY_Community 26|Community 26]]
+- [[_COMMUNITY_Community 27|Community 27]]
+- [[_COMMUNITY_Community 28|Community 28]]
+- [[_COMMUNITY_Community 29|Community 29]]
+- [[_COMMUNITY_Community 30|Community 30]]
+- [[_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]]
+- [[_COMMUNITY_Community 44|Community 44]]
+- [[_COMMUNITY_Community 45|Community 45]]
+- [[_COMMUNITY_Community 46|Community 46]]
+- [[_COMMUNITY_Community 47|Community 47]]
+- [[_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 53|Community 53]]
+- [[_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 65|Community 65]]
+- [[_COMMUNITY_Community 66|Community 66]]
+- [[_COMMUNITY_Community 67|Community 67]]
+- [[_COMMUNITY_Community 68|Community 68]]
+- [[_COMMUNITY_Community 69|Community 69]]
+- [[_COMMUNITY_Community 70|Community 70]]
+- [[_COMMUNITY_Community 71|Community 71]]
+- [[_COMMUNITY_Community 72|Community 72]]
+- [[_COMMUNITY_Community 73|Community 73]]
+- [[_COMMUNITY_Community 74|Community 74]]
+- [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]]
+- [[_COMMUNITY_opportunity_follow.py|opportunity_follow.py]]
+- [[_COMMUNITY_Community 77|Community 77]]
+- [[_COMMUNITY_Community 78|Community 78]]
+- [[_COMMUNITY_PlCarrier|PlCarrier]]
+- [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
+- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
+- [[_COMMUNITY_storage.py|storage.py]]
+- [[_COMMUNITY_Community 83|Community 83]]
+- [[_COMMUNITY_Community 84|Community 84]]
+- [[_COMMUNITY_allocate_next_biz_no|allocate_next_biz_no]]
+- [[_COMMUNITY_Community 86|Community 86]]
+- [[_COMMUNITY_Community 87|Community 87]]
+- [[_COMMUNITY_CrmProduct|CrmProduct]]
+- [[_COMMUNITY_pl_ocr_service.py|pl_ocr_service.py]]
+- [[_COMMUNITY_WechatMessageService|WechatMessageService]]
+- [[_COMMUNITY_opportunity_product.py|opportunity_product.py]]
+- [[_COMMUNITY_Community 92|Community 92]]
+- [[_COMMUNITY_api_request_log_middleware.py|api_request_log_middleware.py]]
+- [[_COMMUNITY_assert_contract_editable_for_update|assert_contract_editable_for_update]]
+- [[_COMMUNITY_test_pl_public_link_archived.py|test_pl_public_link_archived.py]]
+- [[_COMMUNITY_minio_url.py|minio_url.py]]
+- [[_COMMUNITY_contact.py|contact.py]]
+- [[_COMMUNITY_LocalStorage|LocalStorage]]
+- [[_COMMUNITY_redis_client.py|redis_client.py]]
+- [[_COMMUNITY_price_letter_detail|price_letter_detail]]
+- [[_COMMUNITY_tenant.py|tenant.py]]
+- [[_COMMUNITY_BaseStorage|BaseStorage]]
+- [[_COMMUNITY_pl_internal_customer.py|pl_internal_customer.py]]
+- [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]]
+- [[_COMMUNITY_pool_customer_assign|pool_customer_assign]]
+- [[_COMMUNITY_site.py|site.py]]
+- [[_COMMUNITY_apply_pl_scope|apply_pl_scope]]
+- [[_COMMUNITY_statistics.py|statistics.py]]
+- [[_COMMUNITY_list_duty_staff_users|list_duty_staff_users]]
+- [[_COMMUNITY_dict_data.py|dict_data.py]]
+- [[_COMMUNITY_dict_type.py|dict_type.py]]
+- [[_COMMUNITY_site.py|site.py]]
+- [[_COMMUNITY_Community 116|Community 116]]
+- [[_COMMUNITY_price_letter_detail|price_letter_detail]]
+- [[_COMMUNITY_Community 118|Community 118]]
+- [[_COMMUNITY_Community 119|Community 119]]
+- [[_COMMUNITY_post.py|post.py]]
+- [[_COMMUNITY_site.py|site.py]]
+- [[_COMMUNITY_customer_options|customer_options]]
+- [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
+- [[_COMMUNITY_customer_pool.py|customer_pool.py]]
+- [[_COMMUNITY_product_allowed|product_allowed]]
+- [[_COMMUNITY_BaseStorage|BaseStorage]]
+- [[_COMMUNITY_context.py|context.py]]
+- [[_COMMUNITY_Community 136|Community 136]]
+- [[_COMMUNITY_Community 138|Community 138]]
+- [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
+- [[_COMMUNITY_UserRole|UserRole]]
+- [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
+- [[_COMMUNITY_Community 147|Community 147]]
+- [[_COMMUNITY_Community 151|Community 151]]
+- [[_COMMUNITY_customer_update|customer_update]]
+- [[_COMMUNITY_.to_tenant_user_dict|.to_tenant_user_dict]]
+- [[_COMMUNITY_get_client_ip|get_client_ip]]
+- [[_COMMUNITY_codeblock1 (iflytekshanxia2.0backend)|code:block1 (/iflytek/shanxia2.0/backend)]]
+- [[_COMMUNITY_test_quote_approver_setting.py|test_quote_approver_setting.py]]
+- [[_COMMUNITY_resolve_create_time_bounds|resolve_create_time_bounds]]
+- [[_COMMUNITY_test_pl_vehicle_personnel_photo_schema.py|test_pl_vehicle_personnel_photo_schema.py]]
+- [[_COMMUNITY_crm_quote_pdf.py|crm_quote_pdf.py]]
+- [[_COMMUNITY_shanxia2.0 后端骨架（FastAPI）|shanxia2.0 后端骨架（FastAPI）]]
+- [[_COMMUNITY_api_crypto_middleware.py|api_crypto_middleware.py]]
+- [[_COMMUNITY_order_status_compat.py|order_status_compat.py]]
+- [[_COMMUNITY_shanxia2.0 Backend 生产部署说明|shanxia2.0 Backend 生产部署说明]]
+- [[_COMMUNITY_db_collation.py|db_collation.py]]
+- [[_COMMUNITY___init__.py|__init__.py]]
+- [[_COMMUNITY___init__.py|__init__.py]]
+- [[_COMMUNITY_codebash (cd pathtoshanxia2.0)|code:bash (cd /path/to/shanxia2.0)]]
+- [[_COMMUNITY_codebash (.start-prod.sh status     查看状态)|code:bash (./start-prod.sh status    # 查看状态)]]
+- [[_COMMUNITY_codebash (curl -s http127.0.0.19111health)|code:bash (curl -s http://127.0.0.1:9111/health)]]
+- [[_COMMUNITY_codebash (cd iflytekshanxia2.0backend)|code:bash (cd /iflytek/shanxia2.0/backend)]]
+- [[_COMMUNITY_codebash (python -m venv venv)|code:bash (python -m venv venv)]]
+- [[_COMMUNITY_codebash (pip install -r requirements.txt)|code:bash (pip install -r requirements.txt)]]
+- [[_COMMUNITY_codeenv ( 数据库配置)|code:env (# 数据库配置)]]
+- [[_COMMUNITY_codebash (uvicorn app.mainapp --reload --port 8000)|code:bash (uvicorn app.main:app --reload --port 8000)]]
+- [[_COMMUNITY_BaseModel|BaseModel]]
+- [[_COMMUNITY_PlanResourceSnapshotMixin|PlanResourceSnapshotMixin]]
+
+## God Nodes (most connected - your core abstractions)
+1. `BaseModel` - 506 edges
+2. `get_tenant_no()` - 381 edges
+3. `DbUserContext` - 305 edges
+4. `success_response()` - 273 edges
+5. `error_response()` - 269 edges
+6. `BxUserContext` - 204 edges
+7. `generate_uuid()` - 198 edges
+8. `crm_user_info()` - 138 edges
+9. `ExportValidationError` - 108 edges
+10. `ExportColumn` - 106 edges
+
+## Surprising Connections (you probably didn't know these)
+- `BackfillRule` --uses--> `Settings`  [INFERRED]
+  scripts/migrate_crm_sys_oss.py → app/core/config.py
+- `MigrationStats` --uses--> `Settings`  [INFERRED]
+  scripts/migrate_bx_data.py → app/core/config.py
+- `StepStats` --uses--> `Settings`  [INFERRED]
+  scripts/migrate_bx_data.py → app/core/config.py
+- `MigrationStats` --uses--> `Settings`  [INFERRED]
+  scripts/migrate_crm_clue.py → app/core/config.py
+- `StepStats` --uses--> `Settings`  [INFERRED]
+  scripts/migrate_crm_clue.py → app/core/config.py
+
+## Import Cycles
+- None detected.
+
+## Communities (167 total, 16 thin omitted)
+
+### Community 0 - "Community 0"
+Cohesion: 0.16
+Nodes (21): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+13 more)
+
+### Community 1 - "Community 1"
+Cohesion: 0.07
+Nodes (39): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractApprovalPassBody, ContractApprovalRejectBody, ContractApprovalTransferBody (+31 more)
+
+### Community 2 - "Community 2"
+Cohesion: 0.09
+Nodes (45): dump_export_row(), issue_status_label(), Any, Session, respond_xlsx(), status_label(), advance_issue_stats(), batch_offset() (+37 more)
+
+### Community 3 - "Community 3"
+Cohesion: 0.08
+Nodes (92): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+84 more)
+
+### Community 4 - "Community 4"
+Cohesion: 0.12
+Nodes (61): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+53 more)
+
+### Community 5 - "Community 5"
+Cohesion: 0.04
+Nodes (95): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), delete_plan(), _determine_plan_type(), _ensure_subpack_slip_no() (+87 more)
+
+### Community 6 - "Community 6"
+Cohesion: 0.08
+Nodes (58): customer_create(), customer_update(), follow_by_customer(), follow_detail(), convert_clue(), assign_customer(), batch_claim_customers(), check_duplicate_customer() (+50 more)
+
+### Community 7 - "Community 7"
+Cohesion: 0.03
+Nodes (200): category_add(), category_delete(), category_tree(), category_update(), clue_assign(), clue_convert(), clue_create(), clue_delete() (+192 more)
+
+### Community 8 - "Community 8"
+Cohesion: 0.10
+Nodes (34): invalidate_all_approvals(), 作废该合同全部有效审批记录（含已通过/已拒绝），用于再编辑或重新提审。, approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals() (+26 more)
+
+### Community 9 - "Community 9"
+Cohesion: 0.09
+Nodes (53): download_reimburse_import_template(), clue_import_template(), customer_import_template(), product_import_template(), build_annotated_result_bytes(), build_applicant_label(), build_expense_path_labels(), build_import_template_bytes() (+45 more)
+
+### Community 10 - "Community 10"
+Cohesion: 0.17
+Nodes (18): export_document_reminders(), export_inventory_ledger(), assert_export_row_count(), _build_workbook(), DictLabelResolver, export_rows_to_xlsx_response(), filter_export_columns(), Any (+10 more)
+
+### Community 11 - "Community 11"
+Cohesion: 0.10
+Nodes (59): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), export_urea_applies(), export_urea_disburse_board(), get_apply() (+51 more)
+
+### Community 12 - "Community 12"
+Cohesion: 0.06
+Nodes (46): create_leave(), AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest (+38 more)
+
+### Community 13 - "Community 13"
+Cohesion: 0.13
+Nodes (38): bx_health(), 报销（bx）API 路由聚合 — REST 风格，协议对齐 bx 原系统。, P0 健康检查：验证 bx 路由已挂载且响应协议为 code=0。, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse() (+30 more)
+
+### Community 14 - "Community 14"
+Cohesion: 0.09
+Nodes (38): 报销模块认证适配：门户 JWT 用户 → bx 业务上下文。, BxInvoiceLedger, BxInvoiceWalletSummary, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, filter_current_cycle_approvals() (+30 more)
+
+### Community 15 - "Community 15"
+Cohesion: 0.11
+Nodes (14): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseApplyOut, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn, Any (+6 more)
+
+### Community 16 - "Community 16"
+Cohesion: 0.09
+Nodes (64): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply() (+56 more)
+
+### Community 17 - "Community 17"
+Cohesion: 0.05
+Nodes (99): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName（用 nick_name）。 (+91 more)
+
+### Community 18 - "Community 18"
+Cohesion: 0.10
+Nodes (40): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+32 more)
+
+### Community 19 - "Community 19"
+Cohesion: 0.18
+Nodes (31): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), legacy_parent_id(), load_oss_id_to_url(), load_runtime_settings() (+23 more)
+
+### Community 20 - "Community 20"
+Cohesion: 0.11
+Nodes (42): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements(), export_unsettled_plans(), _generate_settlement_no() (+34 more)
+
+### Community 21 - "Community 21"
+Cohesion: 0.09
+Nodes (55): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors() (+47 more)
+
+### Community 22 - "Community 22"
+Cohesion: 0.08
+Nodes (28): parse_admin_request_json(), Any, Request, 运营 Web（/web/admin）JSON 请求体解析。  与 ApiCryptoMiddleware 配合：中间件未改写 body 时，在路由内解密 `{, 读取 JSON body；dict 时走 resolve_request_payload（明文 / 密文 / data 包装）。      Returns:, ApiCryptoError, _b64url_decode(), _b64url_encode() (+20 more)
+
+### Community 23 - "Community 23"
+Cohesion: 0.08
+Nodes (72): create_from_contract(), create_plan(), create_plan_full(), _generate_plan_no(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, 生成计划编号 POYYYYMMDD###（当日 3 位序号，每日重置）, update_plan(), PlPlan (+64 more)
+
+### Community 24 - "Community 24"
+Cohesion: 0.19
+Nodes (16): DictEnsureError, ensure_dict_data(), ensure_remove_dict_data(), Session, 业务页字典 ensure：白名单内按 label 复用或插入 sys_dict_data。, label miss, but preferred value already exists → reuse, no insert, test_ensure_honors_explicit_preferred_value_on_insert(), test_ensure_inserts_new_with_value_equals_label() (+8 more)
+
+### Community 25 - "Community 25"
+Cohesion: 0.26
+Nodes (12): list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析（替代 Hutool UserAgentUtil）, Java: queryLogsByQuoteId (+4 more)
+
+### Community 26 - "Community 26"
+Cohesion: 0.14
+Nodes (31): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+23 more)
+
+### Community 27 - "Community 27"
+Cohesion: 0.07
+Nodes (57): CRM 报价单 API 路由 — 挂接到 crm.router, BaseModel, PagedQuery, PagedResponse, InvoiceAttachmentOut, InvoiceOut, LedgerOut, WalletSummaryOut (+49 more)
+
+### Community 28 - "Community 28"
+Cohesion: 0.09
+Nodes (64): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+56 more)
+
+### Community 29 - "Community 29"
+Cohesion: 0.18
+Nodes (18): align_contract_no_to_sign_date(), generate_contract_no(), date, Java: generateContractNo — {供方编码}/X-JT{yyyyMMdd}{3位序号}      流水与撞号检测须含软删：uk_contr, 标准编号替换日期段，保留序号；非标准返回 None。, 将标准合同编号日期段对齐签订日；撞号则序号顺延（含软删查重）。      非标准编号原样返回。无签订日则原样返回。, replace_contract_no_date(), _mock_last_contract() (+10 more)
+
+### Community 30 - "Community 30"
+Cohesion: 0.16
+Nodes (26): clear_target_categories(), compute_level(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+18 more)
+
+### Community 31 - "Community 31"
+Cohesion: 0.10
+Nodes (44): PlInboundOrderItemBrandQty, 入库明细品牌数量 pl_inbound_order_item_brand_qty, 按运输计划单据类型解析地磅往来单位（不区分 CRM 合同类型）。      - 入库单 inbound：供方 → party_a，其次 supplier_nam, resolve_partner_company(), apply_site_feedback(), build_io_order_site_url(), create_io_order_for_transport(), _dibang_qty_by_plan_product() (+36 more)
+
+### Community 32 - "Community 32"
+Cohesion: 0.19
+Nodes (23): 验证密码（哈希非 bcrypt 或损坏时返回 False，避免抛错）, verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+15 more)
+
+### Community 33 - "Community 33"
+Cohesion: 0.09
+Nodes (49): contact_detail(), invoice_info_add(), invoice_info_by_customer(), _invoice_info_by_customer_impl(), invoice_info_delete(), invoice_info_list(), invoice_info_set_default(), invoice_info_update() (+41 more)
+
+### Community 34 - "Community 34"
+Cohesion: 0.14
+Nodes (20): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+12 more)
+
+### Community 35 - "Community 35"
+Cohesion: 0.18
+Nodes (36): clear_portal_workflow(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_bx_user_mapping(), load_runtime_settings() (+28 more)
+
+### Community 36 - "Community 36"
+Cohesion: 0.13
+Nodes (27): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_update(), pool_rule_update_status(), create_pool_rule(), delete_pool_rules() (+19 more)
+
+### Community 37 - "Community 37"
+Cohesion: 0.12
+Nodes (21): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), menu_badge_stats(), Session, Session (+13 more)
+
+### Community 38 - "Community 38"
+Cohesion: 0.18
+Nodes (11): Config, decrypt_login_payload(), ensure_initialized(), extract_login_credentials(), get_public_pem(), Any, 登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。, Base64 密文 -> JSON 对象（须含 username、password、ts 毫秒时间戳）。 (+3 more)
+
+### Community 39 - "Community 39"
+Cohesion: 0.12
+Nodes (44): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_follow_detail(), assign_clues(), check_convert(), check_duplicate_clue(), create_clue() (+36 more)
+
+### Community 40 - "Community 40"
+Cohesion: 0.16
+Nodes (32): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), _enrich_change_rows(), execute_change(), export_contract_changes(), export_contract_templates() (+24 more)
+
+### Community 41 - "Community 41"
+Cohesion: 0.18
+Nodes (31): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+23 more)
+
+### Community 42 - "Community 42"
+Cohesion: 0.19
+Nodes (32): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+24 more)
+
+### Community 43 - "Community 43"
+Cohesion: 0.15
+Nodes (19): BxExportBodyBase, create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices() (+11 more)
+
+### Community 44 - "Community 44"
+Cohesion: 0.19
+Nodes (28): apply_biz_backfill(), BackfillRule, BizRef, build_biz_index(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows() (+20 more)
+
+### Community 45 - "Community 45"
+Cohesion: 0.26
+Nodes (50): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+42 more)
+
+### Community 46 - "Community 46"
+Cohesion: 0.08
+Nodes (86): register_contract_routes(), _apply_contract_entity_fields(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_filters(), _build_contract_name_from_parties(), _build_customer_address(), _calc_amount_with_tax() (+78 more)
+
+### Community 47 - "Community 47"
+Cohesion: 0.15
+Nodes (16): pool_customer_assign(), pool_customer_claim(), pool_record_detail(), pool_record_list(), get_pool_record(), list_pool_records(), Any, Session (+8 more)
+
+### Community 48 - "Community 48"
+Cohesion: 0.21
+Nodes (22): clear_target_products(), count_target_rows(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+14 more)
+
+### Community 49 - "Community 49"
+Cohesion: 0.13
+Nodes (19): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+11 more)
+
+### Community 50 - "Community 50"
+Cohesion: 0.16
+Nodes (29): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version(), get_nodes_by_version(), get_pending_tasks_by_node() (+21 more)
+
+### Community 51 - "Community 51"
+Cohesion: 0.22
+Nodes (21): _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), export_transport_addresses(), _get_address(), get_transport_address(), list_all_transport_addresses() (+13 more)
+
+### Community 52 - "Community 52"
+Cohesion: 0.05
+Nodes (80): 返回 (作废, 归档)。现场链接实际走入库/出库单公共页。, _resolve_io_order_link_flags(), _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images() (+72 more)
+
+### Community 53 - "Community 53"
+Cohesion: 0.12
+Nodes (16): 供方全量列表（下拉）— Java: CrmSupplierInfoController.listAll, 供方详情 — Java: CrmSupplierInfoController.getInfo, 新增供方 — Java: CrmSupplierInfoController.add, 修改供方 — Java: CrmSupplierInfoController.edit, 删除供方 — Java: CrmSupplierInfoController.remove, supplier_info_add(), supplier_info_delete(), supplier_info_detail() (+8 more)
+
+### Community 54 - "Community 54"
+Cohesion: 0.10
+Nodes (37): create_personnel(), get_personnel(), list_personnel(), _personnel_to_detail(), _personnel_to_read(), update_personnel(), PlCert, CertRead (+29 more)
+
+### Community 55 - "Community 55"
+Cohesion: 0.45
+Nodes (11): _customer_base_query(), get_follow_statistics(), get_industry_statistics(), get_level_statistics(), get_overview_statistics(), get_owner_statistics(), get_source_statistics(), get_trend_statistics() (+3 more)
+
+### Community 56 - "Community 56"
+Cohesion: 0.14
+Nodes (25): load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。, 软删旧品牌量行后按归档结果插入；无品牌约定则只软删不插入。, validate_brand_qty_rows() (+17 more)
+
+### Community 57 - "Community 57"
+Cohesion: 0.13
+Nodes (21): API 路由包 — 山峡化工生产一体化门户, delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves() (+13 more)
+
+### Community 58 - "Community 58"
+Cohesion: 0.18
+Nodes (21): allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title(), parse_optional_date(), parse_reimburse_date(), preview_reimburse_title_seq() (+13 more)
+
+### Community 59 - "Community 59"
+Cohesion: 0.20
+Nodes (28): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+20 more)
+
+### Community 60 - "Community 60"
+Cohesion: 0.19
+Nodes (7): _guess_preview_content_type(), MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint；未配置或与内网相同时复用 self.client。, 按对象键后缀推断内联预览 Content-Type（纠正上传时未写入 MIME 的情况）。, MinIO 预签名下载 URL，携带原始文件名。, MinIO 预签名内联预览 URL（图片新标签页 / PDF iframe 等）。          上传时 put_object 未写 content_typ
+
+### Community 61 - "Community 61"
+Cohesion: 0.11
+Nodes (43): DbInboundOutbound, DbSequence, 地磅（db）模块数据模型 — 对齐 docs/sql/db_tables.sql, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id() (+35 more)
+
+### Community 62 - "Community 62"
+Cohesion: 0.09
+Nodes (69): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+61 more)
+
+### Community 63 - "Community 63"
+Cohesion: 0.25
+Nodes (17): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+9 more)
+
+### Community 64 - "Community 64"
+Cohesion: 0.15
+Nodes (23): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+15 more)
+
+### Community 65 - "Community 65"
+Cohesion: 0.09
+Nodes (63): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+55 more)
+
+### Community 66 - "Community 66"
+Cohesion: 0.12
+Nodes (38): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+30 more)
+
+### Community 67 - "Community 67"
+Cohesion: 0.12
+Nodes (36): get_password_hash(), Namespace, build_merged_users(), bx_role_labels(), check_minio(), check_mysql(), check_redis(), _clip() (+28 more)
+
+### Community 68 - "Community 68"
+Cohesion: 0.24
+Nodes (18): _actor_ids(), _actor_names(), assert_row_deletable_by_creator(), assert_rows_deletable_by_creator(), can_delete_by_creator(), is_super_admin(), normalize_user_info(), Any (+10 more)
+
+### Community 69 - "Community 69"
+Cohesion: 0.15
+Nodes (27): _append_user_scope_conditions(), apply_data_scope(), assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 数据权限过滤（V0.3：基于角色 data_scope 的查询级行级过滤）  data_scope 值：   1 = 全部数据   2 = 本部门数据   3 (+19 more)
+
+### Community 70 - "Community 70"
+Cohesion: 0.18
+Nodes (29): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+21 more)
+
+### Community 71 - "Community 71"
+Cohesion: 0.10
+Nodes (46): approve_carrier(), create_carrier(), create_driver(), export_carriers(), export_drivers(), get_carrier(), get_driver(), list_carriers() (+38 more)
+
+### Community 72 - "Community 72"
+Cohesion: 0.25
+Nodes (18): batch_generate_sample_codes(), batch_issue_sample_codes(), batch_revoke_sample_codes(), create_sample_code(), get_sample_code(), list_sample_codes(), _parse_issued_time(), Any (+10 more)
+
+### Community 73 - "Community 73"
+Cohesion: 0.20
+Nodes (25): derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+17 more)
+
+### Community 74 - "Community 74"
+Cohesion: 0.08
+Nodes (78): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), export_plans(), _generate_plan_no() (+70 more)
+
+### Community 75 - "apply_crm_create_by_scope"
+Cohesion: 0.17
+Nodes (11): get_current_time(), parse_datetime(), datetime, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session (+3 more)
+
+### Community 76 - "opportunity_follow.py"
+Cohesion: 0.31
+Nodes (8): _plan_type_to_business_type(), _normalize_plan_date(), date, Session, 运输计划 · 工厂现场链接（与地磅出入库单解耦）, 入库/出库安排运输：按产品生成现场链接（不写 db_inbound_outbound）。, sync_site_links_for_transport(), TransportSiteLinkResult
+
+### Community 77 - "Community 77"
+Cohesion: 0.11
+Nodes (12): get_wechat_pay_client(), get_wechat_pay_v2(), Any, 微信支付工具模块  支持微信支付 V3 API 文档参考: https://pay.weixin.qq.com/docs/v3/apis/index.html, 统一下单接口 (V3)          Args:             out_trade_no: 商户订单号             total_amo, 申请退款          Args:             out_trade_no: 商户订单号             total_amount: 订单, 小程序调起支付的二次签名参数（与公众号 JSAPI 规则一致）, 统一下单 (V2 API)          Args:             out_trade_no: 商户订单号             total_f (+4 more)
+
+### Community 78 - "Community 78"
+Cohesion: 0.24
+Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType
+
+### Community 79 - "PlCarrier"
+Cohesion: 0.29
+Nodes (12): build_name_pinyin_abbr(), normalize_name_pinyin_abbr(), 名称拼音首字母缩写：库内存小写，检索时大小写不敏感。, 保存时解析拼音字段。      - submitted_provided=True：用提交值（空则按 name 生成）     - 否则：已有非空 existi, resolve_name_pinyin_abbr(), test_chinese_and_alnum(), test_empty_and_whitespace(), test_resolve_not_submitted_empty_existing_generates() (+4 more)
+
+### Community 80 - "resolve_crm_product"
+Cohesion: 0.19
+Nodes (17): _apply_list_filters(), create_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java, Java: queryList（不分页，报价单下拉） (+9 more)
+
+### Community 81 - "customer_follow.py"
+Cohesion: 0.16
+Nodes (25): bind_vehicle_driver(), create_vehicle(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle(), export_personnel(), export_vehicles() (+17 more)
+
+### Community 82 - "storage.py"
+Cohesion: 0.11
+Nodes (41): put_plan_side_contracts(), PlanContractGapRead, PlanContractLink, PlanSideContractsUpdateBody, apply_pl_scope(), Session, PL 模块数据权限辅助（create_by / create_dept_id，无 owner_field）。, is_internal_customer_name() (+33 more)
+
+### Community 83 - "Community 83"
+Cohesion: 0.15
+Nodes (30): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+22 more)
+
+### Community 84 - "Community 84"
+Cohesion: 0.23
+Nodes (23): build_id_maps(), clip_text(), count_rows(), export_mapping(), fetch_rows(), legacy_id_to_str(), main(), map_id() (+15 more)
+
+### Community 85 - "allocate_next_biz_no"
+Cohesion: 0.07
+Nodes (54): operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session, 导出操作日志（当前筛选全量，或 ids 已选）。, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info() (+46 more)
+
+### Community 86 - "Community 86"
+Cohesion: 0.12
+Nodes (15): _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, 定期 ping MySQL，避免远程库/NAT 回收空闲 TCP 后首请求长时间卡住。 (+7 more)
+
+### Community 87 - "Community 87"
+Cohesion: 0.24
+Nodes (11): extract_minio_object_key(), join_relative_urls(), normalize_oss_storage_url(), MinIO 附件 URL 规范化（数据迁移共用）。  背景 ---- CRM / 地磅 / 报销与 shanxia2.0 共用同一 MinIO（bucket 默, 业务表 OSS ID 串 → 相对 URL 串（用于客户证照、跟进附件等）。, 去掉预签名 query（``?X-Amz-...``）。, 将绝对/相对 URL 规范为 MinIO object key（不含 bucket）。, 迁移 CRM ``sys_oss`` 行：``url`` + ``file_name`` → 门户相对路径。 (+3 more)
+
+### Community 88 - "CrmProduct"
+Cohesion: 0.35
+Nodes (16): ensure_crm_create_by_row_in_scope(), create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime(), Any (+8 more)
+
+### Community 89 - "pl_ocr_service.py"
+Cohesion: 0.19
+Nodes (22): PlOcrUsageMonth, 阿里云 OCR 月度调用计数 pl_ocr_usage_month（按自然月全局统计）, assert_quota_available(), _build_ocr_client(), compress_image_bytes(), current_usage_month(), _first_attachment_url(), get_or_create_usage_row() (+14 more)
+
+### Community 90 - "WechatMessageService"
+Cohesion: 0.17
+Nodes (8): 发送订单状态通知                  Args:             openid: 用户openid             order_n, 发送支付成功通知                  Args:             openid: 用户openid             order_n, 发送配送通知                  Args:             openid: 配送员openid             task_no:, 发送配送时效预警                  Args:             openid: 配送员openid             task_n, 发送退款结果通知                  Args:             openid: 用户openid             order_n, 发送催单通知给配送员                  Args:             deliver_openid: 配送员openid, 发送模板消息                  Args:             openid: 用户openid             template_, WechatMessageService
+
+### Community 91 - "opportunity_product.py"
+Cohesion: 0.33
+Nodes (11): create_leave(), get_leave(), list_leaves(), Any, Session, _row_to_dict(), soft_delete_leave(), update_leave() (+3 more)
+
+### Community 92 - "Community 92"
+Cohesion: 0.20
+Nodes (21): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+13 more)
+
+### Community 93 - "api_request_log_middleware.py"
+Cohesion: 0.09
+Nodes (36): DocumentReminderExportBody, InventoryLedgerExportBody, ApiRequestLogCRUD, Session, list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic） (+28 more)
+
+### Community 94 - "assert_contract_editable_for_update"
+Cohesion: 0.60
+Nodes (3): assert_contract_editable_for_update(), test_assert_allows_editable(), test_assert_rejects_non_editable()
+
+### Community 95 - "test_pl_public_link_archived.py"
+Cohesion: 0.29
+Nodes (6): Config, format_api_error_message(), PageResult, Exception, 将 HTTP/SQLAlchemy 等异常转为可展示的错误文案（避免 str([]) 空列表）。, ResponseModel
+
+### Community 96 - "minio_url.py"
+Cohesion: 0.30
+Nodes (12): PlCarrier, assert_carrier_eligible_for_transport(), carrier_agreement_expired(), carrier_audit_approved(), carrier_eligible_for_transport(), carrier_qualification_complete(), date, 资质附件均为选填，保留函数签名供兼容调用。 (+4 more)
+
+### Community 97 - "contact.py"
+Cohesion: 0.67
+Nodes (3): list_product_options(), 产品下拉 options：keyword 按产品名称/拼音首字母模糊匹配，不匹配产品编号。, test_list_product_options_keyword_only_filters_product_name()
+
+### Community 98 - "LocalStorage"
+Cohesion: 0.35
+Nodes (11): create_tenant(), get_tenant(), list_tenants(), Any, Session, _row_to_dict(), soft_delete_tenant(), tenant_no_exists() (+3 more)
+
+### Community 99 - "redis_client.py"
+Cohesion: 0.13
+Nodes (17): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, 按 18 位身份证号重算 pl_personnel.age，仅更新算出值与库中不一致的记录。返回更新条数。, refresh_personnel_ages_from_id_card(), check_customer_protect_time(), pool_recovery_job(), Session (+9 more)
+
+### Community 100 - "price_letter_detail"
+Cohesion: 0.27
+Nodes (15): Settings, BaseSettings, apply_renumber(), build_mapping(), fetch_products(), format_new_product_no(), load_settings_env(), main() (+7 more)
+
+### Community 101 - "tenant.py"
+Cohesion: 0.29
+Nodes (15): clue_statistics_level(), clue_statistics_overview(), clue_statistics_owner(), clue_statistics_source(), clue_statistics_trend(), _apply_create_range(), _base_query(), get_clue_level_statistics() (+7 more)
+
+### Community 102 - "BaseStorage"
+Cohesion: 0.22
+Nodes (3): BaseStorage, 带下载文件名的访问 URL；默认实现为普通访问地址。, 浏览器内联预览 URL；默认实现为普通访问地址。
+
+### Community 104 - "apply_crm_create_by_scope"
+Cohesion: 0.25
+Nodes (17): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+9 more)
+
+### Community 105 - "pool_customer_assign"
+Cohesion: 0.24
+Nodes (12): get_last_month_range(), month_range(), date, Session, 地磅计划按月自动生成 — 迁移自 simple-dibang-xiaoshou/auto-create-plan/auto_create_monthly_pla, 按月自动生成采购计划。      - 默认仅在每月 1 日执行（force=True 时跳过该限制，供手动触发验收）     - 遍历所有租户，按上月计划模板生, run_auto_generate_monthly_plans(), default_execution_status() (+4 more)
+
+### Community 106 - "site.py"
+Cohesion: 0.17
+Nodes (30): CarrierExportBody, DriverExportBody, paste_recognize_commit(), PersonnelExportBody, VehicleExportBody, generate_uuid(), PlPersonnel, PlVehicleDriver (+22 more)
+
+### Community 107 - "apply_pl_scope"
+Cohesion: 0.08
+Nodes (59): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def(), _enrich_task_list(), export_completed_tasks() (+51 more)
+
+### Community 108 - "statistics.py"
+Cohesion: 0.20
+Nodes (24): count_source_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+16 more)
+
+### Community 110 - "list_duty_staff_users"
+Cohesion: 0.33
+Nodes (13): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), Any (+5 more)
+
+### Community 111 - "dict_data.py"
+Cohesion: 0.27
+Nodes (11): create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), Any, Session, 字典数据 CRUD（sys_dict_data）, 字典下拉选项：租户主数据，忽略数据范围（user_info 保留兼容调用方，不参与过滤）。 (+3 more)
+
+### Community 113 - "dict_type.py"
+Cohesion: 0.35
+Nodes (11): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), Any, Session, 字典类型 CRUD（sys_dict_type）, _row_to_dict() (+3 more)
+
+### Community 115 - "site.py"
+Cohesion: 0.28
+Nodes (14): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+6 more)
+
+### Community 116 - "Community 116"
+Cohesion: 0.18
+Nodes (27): calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_products_by_quote_ids() (+19 more)
+
+### Community 117 - "price_letter_detail"
+Cohesion: 0.47
+Nodes (8): create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId, resolve_storage_path(), SysOss
+
+### Community 118 - "Community 118"
+Cohesion: 0.20
+Nodes (24): batch_insert_contract_products(), calculate_subtotal(), _decimal_value(), delete_price_tiers_by_contract_id(), delete_products_by_contract_id(), _get_field(), insert_contract_product(), _letter_oss_ids_to_json() (+16 more)
+
+### Community 119 - "Community 119"
+Cohesion: 0.12
+Nodes (37): CertRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), is_huolala_trailer_no(), match_required_cert_name(), _missing_field_labels() (+29 more)
+
+### Community 121 - "post.py"
+Cohesion: 0.39
+Nodes (10): create_post(), get_post(), list_posts(), post_code_exists(), Any, Session, _row_to_dict(), soft_delete_post() (+2 more)
+
+### Community 122 - "site.py"
+Cohesion: 0.39
+Nodes (10): create_site(), get_site(), list_sites(), Any, Session, _row_to_dict(), site_code_exists(), soft_delete_site() (+2 more)
+
+### Community 123 - "customer_options"
+Cohesion: 0.19
+Nodes (13): PlInboundOrder, PlOutboundOrder, 运输计划-入库单 pl_inbound_order, 运输计划-出库单 pl_outbound_order, load_plan_arrange_copy_flags(), PlanArrangeCopyFlags, Session, 运输计划列表：批量计算「复制给司机 / 现场 / 磅单二维码」按钮显示标志。  语义与查看弹窗 / usePlPlanArrangeActions 对齐： - (+5 more)
+
+### Community 125 - "resolve_crm_product"
+Cohesion: 0.50
+Nodes (4): customer_options(), 客户下拉选项（租户内只读，不做 owner 数据权限）, CustomerOptionsBody, 客户下拉选项请求体（租户内只读搜索，不做 owner 数据权限）
+
+### Community 126 - "customer_pool.py"
+Cohesion: 0.36
+Nodes (13): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), menu_name_exists(), Any (+5 more)
+
+### Community 128 - "product_allowed"
+Cohesion: 0.28
+Nodes (11): assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed(), Any, Session, 批量回填明细行 isToxic/isExplosive（来自产品主数据，供前端切换主体剔除）。, test_dual_requires_both() (+3 more)
+
+### Community 129 - "BaseStorage"
+Cohesion: 0.12
+Nodes (24): _auto_contract_name_body(), generate_contract_name(), 按面板单位全称精确匹配交易主体/客户主数据，取 shortName；对不上则用全称。, 前端预览误用单位全称时，名称片段会等于面板/客户/开票全称。, 按面板供方(partyA)-需方(partyB)生成：{供方简称}-{需方简称}（{合同编号}）。      - 名称为空：按主数据简称自动生成     - 名, resolve_party_short_name(), _strip_contract_name_no_suffix(), _user_contract_name_uses_party_full_name() (+16 more)
+
+### Community 132 - "context.py"
+Cohesion: 0.18
+Nodes (10): contact_add(), contact_delete(), contact_update(), ContactByCustomerBody, ContactCreateBody, ContactDeleteBody, ContactDetailBody, ContactSetPrimaryBody (+2 more)
+
+### Community 136 - "Community 136"
+Cohesion: 0.26
+Nodes (14): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD（sys_role / sys_role_menu / sys_role_data_scope_detail） (+6 more)
+
+### Community 138 - "Community 138"
+Cohesion: 0.33
+Nodes (19): check_python(), create_venv(), ensure_dirs(), ensure_valid_venv(), ensure_venv_and_runtime(), install_dependencies(), is_running(), log_error() (+11 more)
+
+### Community 139 - "get_current_user_by_token"
+Cohesion: 0.22
+Nodes (15): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage，对外保持 bx 协议。 (+7 more)
+
+### Community 145 - "resolve_crm_product"
+Cohesion: 0.14
+Nodes (24): PlTransportProductBrandQty, PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, 运输单产品回传品牌数量 pl_transport_product_brand_qty, _dict_field(), format_brand_qty_summary(), load_transport_driver_product_feedbacks(), persist_io_item_brand_qtys() (+16 more)
+
+### Community 147 - "Community 147"
+Cohesion: 0.37
+Nodes (17): check_env(), check_python(), create_venv(), init_env(), install_dependencies(), log_error(), log_info(), log_success() (+9 more)
+
+### Community 159 - "customer_update"
+Cohesion: 0.24
+Nodes (14): get_web_auth_menu_codes(), 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), Session, Web 管理端登录：基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析, 角色仅勾选按钮（F）时，补齐祖先 C/M 菜单 id，便于前端匹配 :list 路由。 (+6 more)
+
+### Community 162 - ".to_tenant_user_dict"
+Cohesion: 0.42
+Nodes (7): default_settlement_clause(), test_advance_payment_clause(), test_arrive_payment_clause(), test_empty_falls_back_to_arrive(), test_monthly_settlement_clause_uses_label(), test_unknown_falls_back_to_arrive(), test_volume_quarterly_other_labels()
+
+### Community 164 - "get_client_ip"
+Cohesion: 0.09
+Nodes (46): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), _jwt_user_payload(), logout(), public_quote_share(), Request (+38 more)
+
+### Community 170 - "test_quote_approver_setting.py"
+Cohesion: 0.11
+Nodes (7): convert_heic_to_jpeg(), OSSStorage, process_image_content(), QiniuStorage, 文件存储工具模块  支持多种存储方式： 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 将 HEIC/HEIF 格式转换为 JPEG 格式, 处理图片内容，如果是 HEIC 格式则转换为 JPEG
+
+### Community 173 - "resolve_create_time_bounds"
+Cohesion: 0.06
+Nodes (80): _build_driver_url(), ContractGapExportBody, get_plan_arrange_info(), PlanExportBody, 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport() (+72 more)
+
+### Community 179 - "test_pl_vehicle_personnel_photo_schema.py"
+Cohesion: 0.27
+Nodes (16): add_favorite(), count_active(), find_active(), find_soft_deleted(), list_favorites(), _next_order_num(), normalize_menu_path(), Any (+8 more)
+
+### Community 206 - "crm_quote_pdf.py"
+Cohesion: 0.36
+Nodes (10): build_quote_html(), _default_value(), _format_date(), _format_discount(), _format_money(), generate_quote_pdf(), _get_pdf_styles(), Any (+2 more)
+
+### Community 207 - "shanxia2.0 后端骨架（FastAPI）"
+Cohesion: 0.18
+Nodes (10): 1. 创建虚拟环境, 2. 安装依赖, 3. 配置环境变量, 4. 启动服务, API 路由分组, shanxia2.0 后端骨架（FastAPI）, 开发规范, 快速开始 (+2 more)
+
+### Community 220 - "api_crypto_middleware.py"
+Cohesion: 0.14
+Nodes (23): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+15 more)
+
+### Community 237 - "order_status_compat.py"
+Cohesion: 0.36
+Nodes (7): derive_legacy_status_from_three(), derive_three_status_from_legacy(), Decimal, 阶段A兼容：从旧 status 推导三字段。     约束：旧 status 本身混合了支付/配送/订单生命周期，因此只能尽力推断；     若业务侧已有更精确, 阶段A兼容：从三字段反推旧 status（用于旧前端/旧筛选参数兼容）。, ThreeStatus, _to_decimal()
+
+### Community 239 - "shanxia2.0 Backend 生产部署说明"
+Cohesion: 0.25
+Nodes (7): 1. 上传到服务器, 2. 服务器首次启动, 3. 日常运维, 4. 配置文件, 5. 与 Nginx 配合, 6. 常见问题, shanxia2.0 Backend 生产部署说明
+
+### Community 246 - "db_collation.py"
+Cohesion: 0.38
+Nodes (6): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则，避免 Illegal mix of collations。, 跨表字符串等值比较（JOIN / WHERE）时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci()
+
+## Knowledge Gaps
+- **30 isolated node(s):** `Config`, `Config`, `Config`, `Config`, `Config` (+25 more)
+  These have ≤1 connection - possible missing edges or undocumented components.
+- **16 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
+
+## Suggested Questions
+_Questions this graph is uniquely positioned to answer:_
+
+- **Why does `generate_uuid()` connect `site.py` to `Community 4`, `Community 5`, `Community 6`, `Community 8`, `Community 136`, `Community 11`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `resolve_crm_product`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `Community 26`, `Community 28`, `Community 31`, `Community 32`, `Community 33`, `get_client_ip`, `Community 36`, `Community 39`, `Community 40`, `resolve_create_time_bounds`, `Community 46`, `Community 47`, `Community 49`, `Community 50`, `Community 51`, `Community 54`, `Community 56`, `Community 61`, `Community 62`, `Community 64`, `Community 65`, `Community 67`, `Community 71`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `opportunity_follow.py`, `resolve_crm_product`, `customer_follow.py`, `Community 83`, `CrmProduct`, `pl_ocr_service.py`, `opportunity_product.py`, `Community 92`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `pool_customer_assign`, `list_duty_staff_users`, `dict_data.py`, `dict_type.py`, `Community 116`, `price_letter_detail`, `Community 118`, `post.py`, `site.py`, `customer_pool.py`?**
+  _High betweenness centrality (0.191) - this node is a cross-community bridge._
+- **Why does `BaseModel` connect `Community 27` to `Community 0`, `Community 1`, `Community 2`, `context.py`, `Community 5`, `Community 6`, `Community 7`, `Community 11`, `UserRole`, `Community 12`, `Community 13`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `Community 20`, `Community 23`, `Community 26`, `Community 28`, `Community 33`, `Community 34`, `Community 36`, `Community 37`, `Community 40`, `Community 41`, `Community 43`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 49`, `Community 51`, `Community 52`, `Community 53`, `Community 54`, `Community 57`, `Community 63`, `Community 64`, `Community 65`, `Community 66`, `Community 71`, `Community 74`, `storage.py`, `allocate_next_biz_no`, `api_request_log_middleware.py`, `test_pl_public_link_archived.py`, `tenant.py`, `site.py`, `apply_pl_scope`, `site.py`, `Community 119`, `resolve_crm_product`?**
+  _High betweenness centrality (0.094) - this node is a cross-community bridge._
+- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 38`, `Community 70`, `Community 73`, `Community 42`, `statistics.py`, `Community 44`, `Community 48`, `Community 19`, `Community 59`, `Community 30`?**
+  _High betweenness centrality (0.094) - this node is a cross-community bridge._
+- **Are the 30 inferred relationships involving `DbUserContext` (e.g. with `InventoryExportBody` and `InventoryRelatedData`) actually correct?**
+  _`DbUserContext` has 30 INFERRED edges - model-reasoned connections that need verification._
+- **What connects `API 路由包 — 山峡化工生产一体化门户`, `返回运营端角色下拉选项（label=库中角色名，value=Web 角色码）。`, `返回用户下拉选项（label=昵称，value=用户ID，附带 nickName/userNo）。      供申请人/审批人等选择场景使用，返回本租户全部有效` to the rest of the system?**
+  _612 weakly-connected nodes found - possible documentation gaps or missing edges._
+- **Should `Community 1` be split into smaller, more focused modules?**
+  _Cohesion score 0.06666666666666667 - nodes in this community are weakly interconnected._
+- **Should `Community 2` be split into smaller, more focused modules?**
+  _Cohesion score 0.0936026936026936 - nodes in this community are weakly interconnected._

backend/graphify-out/GRAPH_REPORT.md

@@ -1,16 +1,16 @@
-# Graph Report - backend  (2026-08-23)
+# Graph Report - backend  (2026-08-24)
 
 ## Corpus Check
-- 343 files · ~235,447 words
+- 344 files · ~237,323 words
 - Verdict: corpus is large enough that graph structure adds value.
 
 ## Summary
-- 4814 nodes · 18137 edges · 167 communities (152 shown, 15 thin omitted)
+- 4835 nodes · 18202 edges · 186 communities (170 shown, 16 thin omitted)
 - Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 911 edges (avg confidence: 0.52)
 - Token cost: 0 input · 0 output
 
 ## Graph Freshness
-- Built from commit: `b74d4836`
+- Built from commit: `dd1acdc7`
 - Run `git rev-parse HEAD` and compare to check if the graph is stale.
 - Run `graphify update .` after code changes (no API cost).
 
@@ -117,35 +117,54 @@
 - [[_COMMUNITY_redis_client.py|redis_client.py]]
 - [[_COMMUNITY_price_letter_detail|price_letter_detail]]
 - [[_COMMUNITY_tenant.py|tenant.py]]
+- [[_COMMUNITY_BaseStorage|BaseStorage]]
 - [[_COMMUNITY_pl_internal_customer.py|pl_internal_customer.py]]
 - [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]]
 - [[_COMMUNITY_pool_customer_assign|pool_customer_assign]]
 - [[_COMMUNITY_site.py|site.py]]
 - [[_COMMUNITY_apply_pl_scope|apply_pl_scope]]
 - [[_COMMUNITY_statistics.py|statistics.py]]
+- [[_COMMUNITY_duty.py|duty.py]]
 - [[_COMMUNITY_list_duty_staff_users|list_duty_staff_users]]
 - [[_COMMUNITY_dict_data.py|dict_data.py]]
+- [[_COMMUNITY_merge_duplicate_crm_customers.py|merge_duplicate_crm_customers.py]]
 - [[_COMMUNITY_dict_type.py|dict_type.py]]
+- [[_COMMUNITY_mappers.py|mappers.py]]
 - [[_COMMUNITY_site.py|site.py]]
 - [[_COMMUNITY_Community 116|Community 116]]
 - [[_COMMUNITY_price_letter_detail|price_letter_detail]]
 - [[_COMMUNITY_Community 118|Community 118]]
 - [[_COMMUNITY_Community 119|Community 119]]
+- [[_COMMUNITY_oper_log_decorator.py|oper_log_decorator.py]]
 - [[_COMMUNITY_post.py|post.py]]
 - [[_COMMUNITY_site.py|site.py]]
 - [[_COMMUNITY_customer_options|customer_options]]
+- [[_COMMUNITY_vehicle_recharge.py|vehicle_recharge.py]]
 - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
 - [[_COMMUNITY_customer_pool.py|customer_pool.py]]
+- [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
 - [[_COMMUNITY_product_allowed|product_allowed]]
 - [[_COMMUNITY_BaseStorage|BaseStorage]]
+- [[_COMMUNITY_invoice_info.py|invoice_info.py]]
+- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
 - [[_COMMUNITY_context.py|context.py]]
+- [[_COMMUNITY_inventory_id.py|inventory_id.py]]
+- [[_COMMUNITY_price_letter_detail|price_letter_detail]]
+- [[_COMMUNITY_storage.py|storage.py]]
 - [[_COMMUNITY_Community 136|Community 136]]
-- [[_COMMUNITY_customer_options|customer_options]]
+- [[_COMMUNITY_plan_has_incomplete_hazard_cert_exists|plan_has_incomplete_hazard_cert_exists]]
 - [[_COMMUNITY_Community 138|Community 138]]
 - [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
 - [[_COMMUNITY_UserRole|UserRole]]
+- [[_COMMUNITY_redis_client.py|redis_client.py]]
+- [[_COMMUNITY_opportunity_export|opportunity_export]]
+- [[_COMMUNITY__build_user_info_payload|_build_user_info_payload]]
+- [[_COMMUNITY_config.py|config.py]]
 - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
+- [[_COMMUNITY_list_public_vehicle_plates|list_public_vehicle_plates]]
 - [[_COMMUNITY_Community 147|Community 147]]
+- [[_COMMUNITY__UserCRUDCompat|_UserCRUDCompat]]
+- [[_COMMUNITY_datetime_parse.py|datetime_parse.py]]
 - [[_COMMUNITY_Community 151|Community 151]]
 - [[_COMMUNITY_customer_update|customer_update]]
 - [[_COMMUNITY_.to_tenant_user_dict|.to_tenant_user_dict]]
@@ -200,103 +219,103 @@
 ## Import Cycles
 - None detected.
 
-## Communities (167 total, 15 thin omitted)
+## Communities (186 total, 16 thin omitted)
 
 ### Community 0 - "Community 0"
-Cohesion: 0.16
-Nodes (21): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+13 more)
+Cohesion: 0.13
+Nodes (38): approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), create_personnel(), delete_carrier(), delete_driver(), delete_personnel() (+30 more)
 
 ### Community 1 - "Community 1"
-Cohesion: 0.07
-Nodes (39): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractApprovalPassBody, ContractApprovalRejectBody, ContractApprovalTransferBody (+31 more)
+Cohesion: 0.08
+Nodes (35): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractBatchAssignBody, ContractBatchSubmitBody, ContractChangeCreateBody (+27 more)
 
 ### Community 2 - "Community 2"
-Cohesion: 0.14
-Nodes (36): advance_issue_stats(), batch_offset(), export_advance_issues(), export_advance_issues_xlsx(), export_pending_payments(), export_processed_payments(), issue_advance(), list_advance_issues() (+28 more)
+Cohesion: 0.08
+Nodes (53): dump_export_row(), issue_status_label(), Any, Session, respond_xlsx(), status_label(), advance_issue_stats(), batch_offset() (+45 more)
 
 ### Community 3 - "Community 3"
 Cohesion: 0.07
-Nodes (94): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+86 more)
+Nodes (82): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+74 more)
 
 ### Community 4 - "Community 4"
 Cohesion: 0.12
 Nodes (61): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+53 more)
 
 ### Community 5 - "Community 5"
-Cohesion: 0.04
-Nodes (95): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), delete_plan(), _determine_plan_type(), _ensure_subpack_slip_no() (+87 more)
+Cohesion: 0.06
+Nodes (89): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract(), create_plan(), create_plan_full() (+81 more)
 
 ### Community 6 - "Community 6"
-Cohesion: 0.08
-Nodes (59): customer_create(), customer_update(), follow_by_customer(), follow_detail(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer() (+51 more)
+Cohesion: 0.14
+Nodes (38): assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer(), create_customer(), customer_name_exists(), deal_customer(), _enrich_user_names() (+30 more)
 
 ### Community 7 - "Community 7"
-Cohesion: 0.03
-Nodes (191): category_add(), category_delete(), category_tree(), category_update(), clue_export(), clue_follow_statistics(), clue_import(), clue_list() (+183 more)
+Cohesion: 0.07
+Nodes (78): clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_list(), clue_mine(), clue_to_follow() (+70 more)
 
 ### Community 8 - "Community 8"
 Cohesion: 0.10
 Nodes (34): invalidate_all_approvals(), 作废该合同全部有效审批记录（含已通过/已拒绝），用于再编辑或重新提审。, approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals() (+26 more)
 
 ### Community 9 - "Community 9"
-Cohesion: 0.09
-Nodes (53): download_reimburse_import_template(), clue_import_template(), customer_import_template(), product_import_template(), build_annotated_result_bytes(), build_applicant_label(), build_expense_path_labels(), build_import_template_bytes() (+45 more)
+Cohesion: 0.10
+Nodes (48): download_reimburse_import_template(), build_annotated_result_bytes(), build_applicant_label(), build_expense_path_labels(), build_import_template_bytes(), cell_str(), _ids_visible_in_web_tree(), import_reimburse_workbook() (+40 more)
 
 ### Community 10 - "Community 10"
-Cohesion: 0.60
-Nodes (4): _build_workbook(), DictLabelResolver, Any, 导出单元格解析：按列配置做字典翻译或自定义格式化。
+Cohesion: 0.08
+Nodes (39): demo_xlsx_export(), export_depts(), export_menus(), export_posts(), export_role_management(), export_sites(), export_tenants(), export_users() (+31 more)
 
 ### Community 11 - "Community 11"
-Cohesion: 0.10
-Nodes (59): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), export_urea_applies(), export_urea_disburse_board(), get_apply() (+51 more)
+Cohesion: 0.15
+Nodes (40): PlVehicleUreaApply, PlVehicleUreaDisburse, 车辆尿素申请 pl_vehicle_urea_apply, 车辆尿素发放登记 pl_vehicle_urea_disburse, Decimal, VehicleUreaApplyCreate, VehicleUreaApplyRead, VehicleUreaApplyUpdate (+32 more)
 
 ### Community 12 - "Community 12"
-Cohesion: 0.06
-Nodes (46): create_leave(), AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest (+38 more)
+Cohesion: 0.05
+Nodes (69): MaintenanceApplyExportBody, MaintProcessExportBody, BaseModel, AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse (+61 more)
 
 ### Community 13 - "Community 13"
-Cohesion: 0.11
-Nodes (40): BxApplyListExportBody, Session, respond_xlsx(), approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse() (+32 more)
+Cohesion: 0.15
+Nodes (36): BxApplyListExportBody, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), export_approved_by_me_reimburses(), export_my_reimburses() (+28 more)
 
 ### Community 14 - "Community 14"
 Cohesion: 0.09
-Nodes (33): 报销模块认证适配：门户 JWT 用户 → bx 业务上下文。, BxAttachment, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, ReimburseDetailOut, filter_current_cycle_approvals() (+25 more)
+Nodes (36): build_dict_value_from_label(), ensure_dict_data(), format_hhmm(), format_time_label(), grab(), join_work_plans(), normalize_person_name(), _pad_hhmm() (+28 more)
 
 ### Community 15 - "Community 15"
 Cohesion: 0.11
-Nodes (14): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn, Any, Session (+6 more)
+Nodes (16): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, BxReimburseInvoice, BxReimburseOffset, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn (+8 more)
 
 ### Community 16 - "Community 16"
-Cohesion: 0.09
-Nodes (64): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply() (+56 more)
+Cohesion: 0.11
+Nodes (51): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), get_apply(), get_record(), Session (+43 more)
 
 ### Community 17 - "Community 17"
-Cohesion: 0.11
-Nodes (32): assert_user_is_duty_staff(), build_dict_value_from_label(), DutyBizError, ensure_dict_data(), grab(), list_duty_staff_users(), normalize_person_name(), _pad_hhmm() (+24 more)
+Cohesion: 0.17
+Nodes (36): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, assert_user_is_duty_staff(), _assignment_dict(), build_public_url(), _count_active_assignments() (+28 more)
 
 ### Community 18 - "Community 18"
 Cohesion: 0.10
-Nodes (51): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+43 more)
+Nodes (42): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+34 more)
 
 ### Community 19 - "Community 19"
 Cohesion: 0.18
-Nodes (17): get_oper_log_meta(), OperLogMeta, 请求级操作日志元数据（ContextVar）, 供异步落库线程使用，避免 ContextVar 跨线程丢失。, set_oper_log_meta(), snapshot_oper_log_meta(), _format_summary(), oper_log() (+9 more)
+Nodes (31): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), legacy_parent_id(), load_oss_id_to_url(), load_runtime_settings() (+23 more)
 
 ### Community 20 - "Community 20"
-Cohesion: 0.11
-Nodes (42): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements(), export_unsettled_plans(), _generate_settlement_no() (+34 more)
+Cohesion: 0.13
+Nodes (35): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements(), export_unsettled_plans(), _generate_settlement_no() (+27 more)
 
 ### Community 21 - "Community 21"
-Cohesion: 0.09
-Nodes (55): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors() (+47 more)
+Cohesion: 0.08
+Nodes (60): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors() (+52 more)
 
 ### Community 22 - "Community 22"
 Cohesion: 0.08
 Nodes (28): parse_admin_request_json(), Any, Request, 运营 Web（/web/admin）JSON 请求体解析。  与 ApiCryptoMiddleware 配合：中间件未改写 body 时，在路由内解密 `{, 读取 JSON body；dict 时走 resolve_request_payload（明文 / 密文 / data 包装）。      Returns:, ApiCryptoError, _b64url_decode(), _b64url_encode() (+20 more)
 
 ### Community 23 - "Community 23"
-Cohesion: 0.08
-Nodes (72): create_from_contract(), create_plan(), create_plan_full(), _generate_plan_no(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, 生成计划编号 POYYYYMMDD###（当日 3 位序号，每日重置）, update_plan(), PlPlan (+64 more)
+Cohesion: 0.09
+Nodes (69): ContractGapExportBody, _generate_notify_message(), PlanExportBody, update_plan(), PlPlan, PlPlanChange, PlPlanProduct, PlPlanTransport (+61 more)
 
 ### Community 24 - "Community 24"
 Cohesion: 0.19
@@ -307,16 +326,16 @@ Cohesion: 0.26
 Nodes (12): list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析（替代 Hutool UserAgentUtil）, Java: queryLogsByQuoteId (+4 more)
 
 ### Community 26 - "Community 26"
-Cohesion: 0.14
-Nodes (31): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+23 more)
+Cohesion: 0.11
+Nodes (43): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+35 more)
 
 ### Community 27 - "Community 27"
-Cohesion: 0.07
-Nodes (57): CRM 报价单 API 路由 — 挂接到 crm.router, BaseModel, PagedQuery, PagedResponse, InvoiceAttachmentOut, InvoiceOut, LedgerOut, WalletSummaryOut (+49 more)
+Cohesion: 0.11
+Nodes (32): CRM 报价单 API 路由 — 挂接到 crm.router, QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody, QuoteCreateBody (+24 more)
 
 ### Community 28 - "Community 28"
 Cohesion: 0.09
-Nodes (64): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+56 more)
+Nodes (61): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+53 more)
 
 ### Community 29 - "Community 29"
 Cohesion: 0.18
@@ -327,148 +346,148 @@ Cohesion: 0.16
 Nodes (26): clear_target_categories(), compute_level(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+18 more)
 
 ### Community 31 - "Community 31"
-Cohesion: 0.10
-Nodes (44): PlInboundOrderItemBrandQty, 入库明细品牌数量 pl_inbound_order_item_brand_qty, 按运输计划单据类型解析地磅往来单位（不区分 CRM 合同类型）。      - 入库单 inbound：供方 → party_a，其次 supplier_nam, resolve_partner_company(), apply_site_feedback(), build_io_order_site_url(), create_io_order_for_transport(), _dibang_qty_by_plan_product() (+36 more)
+Cohesion: 0.11
+Nodes (40): apply_dibang_prefill_to_order(), apply_site_feedback(), build_io_order_site_url(), create_io_order_for_transport(), _dibang_qty_by_plan_product(), enrich_io_items_with_brand_feedback(), enrich_io_order_dict(), _format_io_product_summary_line() (+32 more)
 
 ### Community 32 - "Community 32"
 Cohesion: 0.19
 Nodes (23): 验证密码（哈希非 bcrypt 或损坏时返回 False，避免抛错）, verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+15 more)
 
 ### Community 33 - "Community 33"
-Cohesion: 0.12
-Nodes (31): clue_detail(), customer_detail(), invoice_info_add(), invoice_info_by_customer(), _invoice_info_by_customer_impl(), invoice_info_delete(), invoice_info_list(), invoice_info_set_default() (+23 more)
+Cohesion: 0.24
+Nodes (18): create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any, date, Session, _row_to_dict() (+10 more)
 
 ### Community 34 - "Community 34"
-Cohesion: 0.22
-Nodes (15): ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+7 more)
+Cohesion: 0.15
+Nodes (21): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+13 more)
 
 ### Community 35 - "Community 35"
 Cohesion: 0.18
 Nodes (36): clear_portal_workflow(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_bx_user_mapping(), load_runtime_settings() (+28 more)
 
 ### Community 36 - "Community 36"
-Cohesion: 0.31
-Nodes (3): Any, Session, WorkflowEngine
+Cohesion: 0.13
+Nodes (27): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_update(), pool_rule_update_status(), create_pool_rule(), delete_pool_rules() (+19 more)
 
 ### Community 37 - "Community 37"
-Cohesion: 0.12
-Nodes (21): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), menu_badge_stats(), Session, Session (+13 more)
+Cohesion: 0.10
+Nodes (36): menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult, cancel_apply(), create_apply() (+28 more)
 
 ### Community 38 - "Community 38"
-Cohesion: 0.18
-Nodes (11): Config, decrypt_login_payload(), ensure_initialized(), extract_login_credentials(), get_public_pem(), Any, 登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。, Base64 密文 -> JSON 对象（须含 username、password、ts 毫秒时间戳）。 (+3 more)
+Cohesion: 0.31
+Nodes (9): decrypt_login_payload(), ensure_initialized(), extract_login_credentials(), get_public_pem(), Any, 登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。, Base64 密文 -> JSON 对象（须含 username、password、ts 毫秒时间戳）。, 从请求体解析用户名、密码。     返回 (username, password, error_message)；error_message 非空时表示失败。 (+1 more)
 
 ### Community 39 - "Community 39"
-Cohesion: 0.06
-Nodes (69): clue_assign(), clue_check_convert(), clue_check_duplicate(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete() (+61 more)
+Cohesion: 0.22
+Nodes (28): assign_clues(), check_convert(), check_duplicate_clue(), convert_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope(), get_clue() (+20 more)
 
 ### Community 40 - "Community 40"
-Cohesion: 0.16
-Nodes (32): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), _enrich_change_rows(), execute_change(), export_contract_changes(), export_contract_templates() (+24 more)
+Cohesion: 0.12
+Nodes (32): _apply_contract_entity_fields(), _build_contract_filters(), _calc_amount_with_tax(), contract_no_exists(), create_contract(), create_contract_template(), create_from_opportunity(), create_from_quote() (+24 more)
 
 ### Community 41 - "Community 41"
-Cohesion: 0.18
-Nodes (31): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+23 more)
+Cohesion: 0.22
+Nodes (27): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+19 more)
 
 ### Community 42 - "Community 42"
-Cohesion: 0.05
-Nodes (102): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+94 more)
+Cohesion: 0.19
+Nodes (32): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+24 more)
 
 ### Community 43 - "Community 43"
-Cohesion: 0.12
-Nodes (24): create_invoice(), list_invoices(), Request, 一次上传一条发票：多文件挂同一档案，金额为总额，只写一条额度流水。      使用 request.form().getlist，兼容只传 1 个文件时 Fas, BxInvoice, BxInvoiceLedger, BxInvoiceWalletSummary, InvoiceService (+16 more)
+Cohesion: 0.09
+Nodes (37): BxExportBodyBase, create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices() (+29 more)
 
 ### Community 44 - "Community 44"
-Cohesion: 0.18
-Nodes (31): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, _assignment_dict(), build_public_url(), _count_active_assignments(), _day_dict() (+23 more)
+Cohesion: 0.19
+Nodes (28): apply_biz_backfill(), BackfillRule, BizRef, build_biz_index(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows() (+20 more)
 
 ### Community 45 - "Community 45"
-Cohesion: 0.26
-Nodes (50): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+42 more)
+Cohesion: 0.31
+Nodes (49): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+41 more)
 
 ### Community 46 - "Community 46"
-Cohesion: 0.08
-Nodes (86): register_contract_routes(), _apply_contract_entity_fields(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_filters(), _build_contract_name_from_parties(), _build_customer_address(), _calc_amount_with_tax() (+78 more)
+Cohesion: 0.10
+Nodes (65): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), _build_customer_address(), _change_row_to_dict(), _contract_period_key(), contract_row_to_dict(), create_contract_change() (+57 more)
 
 ### Community 47 - "Community 47"
-Cohesion: 0.10
-Nodes (32): pool_customer_assign(), pool_customer_claim(), pool_customer_list(), pool_record_detail(), pool_record_list(), get_pool_record(), list_pool_records(), Any (+24 more)
+Cohesion: 0.12
+Nodes (20): pool_customer_assign(), pool_customer_claim(), pool_customer_export(), pool_customer_list(), pool_record_detail(), pool_record_list(), list_pool_customers(), get_pool_record() (+12 more)
 
 ### Community 48 - "Community 48"
 Cohesion: 0.21
 Nodes (22): clear_target_products(), count_target_rows(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+14 more)
 
 ### Community 49 - "Community 49"
-Cohesion: 0.12
-Nodes (23): ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), BxExportBodyBase, dump_export_row(), issue_status_label(), Any, status_label() (+15 more)
+Cohesion: 0.14
+Nodes (19): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+11 more)
 
 ### Community 50 - "Community 50"
-Cohesion: 0.16
-Nodes (29): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version(), get_nodes_by_version(), get_pending_tasks_by_node() (+21 more)
+Cohesion: 0.17
+Nodes (27): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version(), get_nodes_by_version(), get_pending_tasks_by_node() (+19 more)
 
 ### Community 51 - "Community 51"
-Cohesion: 0.12
-Nodes (35): export_document_reminders(), export_inventory_ledger(), _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), export_transport_addresses(), _get_address() (+27 more)
+Cohesion: 0.22
+Nodes (21): _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), export_transport_addresses(), _get_address(), get_transport_address(), list_all_transport_addresses() (+13 more)
 
 ### Community 52 - "Community 52"
 Cohesion: 0.05
-Nodes (80): 返回 (作废, 归档)。现场链接实际走入库/出库单公共页。, _resolve_io_order_link_flags(), _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images() (+72 more)
+Nodes (82): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+74 more)
 
 ### Community 53 - "Community 53"
-Cohesion: 0.56
-Nodes (3): BxExpenseItem, ExpenseItemService, Session
+Cohesion: 0.12
+Nodes (16): 供方全量列表（下拉）— Java: CrmSupplierInfoController.listAll, 供方详情 — Java: CrmSupplierInfoController.getInfo, 新增供方 — Java: CrmSupplierInfoController.add, 修改供方 — Java: CrmSupplierInfoController.edit, 删除供方 — Java: CrmSupplierInfoController.remove, supplier_info_add(), supplier_info_delete(), supplier_info_detail() (+8 more)
 
 ### Community 54 - "Community 54"
-Cohesion: 0.10
-Nodes (37): create_personnel(), get_personnel(), list_personnel(), _personnel_to_detail(), _personnel_to_read(), update_personnel(), PlCert, CertRead (+29 more)
+Cohesion: 0.12
+Nodes (29): list_personnel(), _personnel_to_read(), PlCert, CertRead, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot (+21 more)
 
 ### Community 55 - "Community 55"
 Cohesion: 0.45
 Nodes (11): _customer_base_query(), get_follow_statistics(), get_industry_statistics(), get_level_statistics(), get_overview_statistics(), get_owner_statistics(), get_source_statistics(), get_trend_statistics() (+3 more)
 
 ### Community 56 - "Community 56"
-Cohesion: 0.14
-Nodes (25): load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。, 软删旧品牌量行后按归档结果插入；无品牌约定则只软删不插入。, validate_brand_qty_rows() (+17 more)
+Cohesion: 0.12
+Nodes (28): PlInventory, PlInventoryTransaction, 库存流水表 pl_inventory_transaction, load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session (+20 more)
 
 ### Community 57 - "Community 57"
-Cohesion: 0.13
-Nodes (21): API 路由包 — 山峡化工生产一体化门户, delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves() (+13 more)
+Cohesion: 0.19
+Nodes (18): create_leave(), delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves() (+10 more)
 
 ### Community 58 - "Community 58"
-Cohesion: 0.18
-Nodes (21): allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title(), parse_optional_date(), parse_reimburse_date(), preview_reimburse_title_seq() (+13 more)
+Cohesion: 0.09
+Nodes (38): get_current_time(), parse_datetime(), datetime, ReimburseDetailOut, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时，进度接口仅展示当前轮次。, 审批进度仅展示当前轮次；完整历史由 get_approval_history 返回。, 报销模块 Service 基类 — 租户隔离 + UUID + 软删除。 (+30 more)
 
 ### Community 59 - "Community 59"
 Cohesion: 0.20
 Nodes (28): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+20 more)
 
 ### Community 60 - "Community 60"
-Cohesion: 0.31
-Nodes (9): format_hhmm(), format_time_label(), parse_hhmm(), test_format_time_label_cross_day(), test_format_time_label_empty(), test_format_time_label_same_day(), test_parse_hhmm(), test_parse_hhmm_invalid_raises() (+1 more)
+Cohesion: 0.24
+Nodes (5): MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint；未配置或与内网相同时复用 self.client。, MinIO 预签名下载 URL，携带原始文件名。, MinIO 预签名内联预览 URL（图片新标签页 / PDF iframe 等）。          上传时 put_object 未写 content_typ
 
 ### Community 61 - "Community 61"
-Cohesion: 0.11
-Nodes (40): PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, apply_product_snapshot_to_plan(), ProductSnapshot, Session, 地磅模块 — CRM 产品解析与快照写入。, 校验 CRM 产品并返回名称/规格快照。新建单据 product_id 必填。      require_on_shelf=False 用于运输计划联动地磅等历, resolve_crm_product() (+32 more)
+Cohesion: 0.15
+Nodes (37): 地磅公共只读：免登车牌 options（现场填写页）, DbInboundOutbound, DbPurchasePlan, 地磅（db）模块数据模型 — 对齐 docs/sql/db_tables.sql, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, parse_date_str(), _apply_plan_quantity_delta() (+29 more)
 
 ### Community 62 - "Community 62"
-Cohesion: 0.09
-Nodes (69): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+61 more)
+Cohesion: 0.10
+Nodes (67): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+59 more)
 
 ### Community 63 - "Community 63"
-Cohesion: 0.22
-Nodes (18): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+10 more)
+Cohesion: 0.32
+Nodes (16): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+8 more)
 
 ### Community 64 - "Community 64"
-Cohesion: 0.19
-Nodes (17): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+9 more)
+Cohesion: 0.13
+Nodes (23): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+15 more)
 
 ### Community 65 - "Community 65"
-Cohesion: 0.09
-Nodes (63): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+55 more)
+Cohesion: 0.10
+Nodes (61): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+53 more)
 
 ### Community 66 - "Community 66"
-Cohesion: 0.11
-Nodes (41): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+33 more)
+Cohesion: 0.17
+Nodes (29): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+21 more)
 
 ### Community 67 - "Community 67"
 Cohesion: 0.12
@@ -479,16 +498,16 @@ Cohesion: 0.24
 Nodes (18): _actor_ids(), _actor_names(), assert_row_deletable_by_creator(), assert_rows_deletable_by_creator(), can_delete_by_creator(), is_super_admin(), normalize_user_info(), Any (+10 more)
 
 ### Community 69 - "Community 69"
-Cohesion: 0.15
-Nodes (27): _append_user_scope_conditions(), apply_data_scope(), assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 数据权限过滤（V0.3：基于角色 data_scope 的查询级行级过滤）  data_scope 值：   1 = 全部数据   2 = 本部门数据   3 (+19 more)
+Cohesion: 0.11
+Nodes (32): _append_user_scope_conditions(), apply_data_scope(), assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 数据权限过滤（V0.3：基于角色 data_scope 的查询级行级过滤）  data_scope 值：   1 = 全部数据   2 = 本部门数据   3 (+24 more)
 
 ### Community 70 - "Community 70"
 Cohesion: 0.18
 Nodes (29): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+21 more)
 
 ### Community 71 - "Community 71"
-Cohesion: 0.10
-Nodes (46): approve_carrier(), create_carrier(), create_driver(), export_carriers(), export_drivers(), get_carrier(), get_driver(), list_carriers() (+38 more)
+Cohesion: 0.14
+Nodes (23): CarrierAuditReject, CarrierBase, CarrierCreate, CarrierQualificationBase, DriverBase, DriverCreate, DriverListResponse, DriverUpdate (+15 more)
 
 ### Community 72 - "Community 72"
 Cohesion: 0.25
@@ -499,16 +518,16 @@ Cohesion: 0.20
 Nodes (25): derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+17 more)
 
 ### Community 74 - "Community 74"
-Cohesion: 0.08
-Nodes (77): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), export_plans(), _generate_plan_no() (+69 more)
+Cohesion: 0.11
+Nodes (38): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing(), _get_weighing(), get_weighing_related() (+30 more)
 
 ### Community 75 - "apply_crm_create_by_scope"
-Cohesion: 0.17
-Nodes (11): get_current_time(), parse_datetime(), datetime, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session (+3 more)
+Cohesion: 0.33
+Nodes (8): allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session, 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。     须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, BizNoKind
 
 ### Community 76 - "opportunity_follow.py"
-Cohesion: 0.31
-Nodes (8): _plan_type_to_business_type(), _normalize_plan_date(), date, Session, 运输计划 · 工厂现场链接（与地磅出入库单解耦）, 入库/出库安排运输：按产品生成现场链接（不写 db_inbound_outbound）。, sync_site_links_for_transport(), TransportSiteLinkResult
+Cohesion: 0.14
+Nodes (15): 流程实例 wf_process_instance, WfProcessInstance, _dispatch_local(), Any, 工作流回调服务 —— 流程状态变更时通知业务系统, 注册本地回调函数。当 callback_url 以 path 开头时直接调用 fn。, 尝试本地直调。返回 True 表示已处理，False 表示无匹配的本地回调。, 流程实例状态变更后，向业务系统发送回调通知。      优先级：     1. 如果 callback_url 是内部路径（以 / 开头），优先尝试本地直调 (+7 more)
 
 ### Community 77 - "Community 77"
 Cohesion: 0.11
@@ -523,40 +542,40 @@ Cohesion: 0.29
 Nodes (12): build_name_pinyin_abbr(), normalize_name_pinyin_abbr(), 名称拼音首字母缩写：库内存小写，检索时大小写不敏感。, 保存时解析拼音字段。      - submitted_provided=True：用提交值（空则按 name 生成）     - 否则：已有非空 existi, resolve_name_pinyin_abbr(), test_chinese_and_alnum(), test_empty_and_whitespace(), test_resolve_not_submitted_empty_existing_generates() (+4 more)
 
 ### Community 80 - "resolve_crm_product"
-Cohesion: 0.19
-Nodes (17): _apply_list_filters(), create_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java, Java: queryList（不分页，报价单下拉） (+9 more)
+Cohesion: 0.12
+Nodes (33): create_clue_follow(), delete_clue_follow(), get_clue_follow(), get_follow_statistics(), list_clue_follows(), Any, Session, 更新线索跟进记录，必要时同步线索 next_time (+25 more)
 
 ### Community 81 - "customer_follow.py"
-Cohesion: 0.16
-Nodes (25): bind_vehicle_driver(), create_vehicle(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle(), export_personnel(), export_vehicles() (+17 more)
+Cohesion: 0.28
+Nodes (13): create_vehicle(), export_vehicles(), get_vehicle(), list_vehicles(), 导出车辆列表（当前筛选全量，或 ids 已选）。, update_vehicle(), _vehicle_to_detail(), _vehicle_to_read() (+5 more)
 
 ### Community 82 - "storage.py"
-Cohesion: 0.11
-Nodes (41): put_plan_side_contracts(), PlanContractGapRead, PlanContractLink, PlanSideContractsUpdateBody, apply_pl_scope(), Session, PL 模块数据权限辅助（create_by / create_dept_id，无 owner_field）。, is_internal_customer_name() (+33 more)
+Cohesion: 0.13
+Nodes (33): PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, PlanContractGapRead, PlanContractLink, PlanProductRead, is_internal_customer_name(), 运输计划：内置山峡/云栋客户判定（合同可免）, build_plan_contract_gap_read() (+25 more)
 
 ### Community 83 - "Community 83"
-Cohesion: 0.15
-Nodes (30): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+22 more)
+Cohesion: 0.09
+Nodes (52): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer() (+44 more)
 
 ### Community 84 - "Community 84"
 Cohesion: 0.23
 Nodes (23): build_id_maps(), clip_text(), count_rows(), export_mapping(), fetch_rows(), legacy_id_to_str(), main(), map_id() (+15 more)
 
 ### Community 85 - "allocate_next_biz_no"
-Cohesion: 0.16
-Nodes (23): operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session, 导出操作日志（当前筛选全量，或 ids 已选）。, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info() (+15 more)
+Cohesion: 0.15
+Nodes (23): _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj(), _schedule_persist_log() (+15 more)
 
 ### Community 86 - "Community 86"
-Cohesion: 0.12
-Nodes (15): _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, 定期 ping MySQL，避免远程库/NAT 回收空闲 TCP 后首请求长时间卡住。 (+7 more)
+Cohesion: 0.11
+Nodes (18): ApiCryptoMiddleware, ApiRequestLogMiddleware, _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误 (+10 more)
 
 ### Community 87 - "Community 87"
-Cohesion: 0.12
-Nodes (26): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName（用 nick_name）。 (+18 more)
+Cohesion: 0.24
+Nodes (11): extract_minio_object_key(), join_relative_urls(), normalize_oss_storage_url(), MinIO 附件 URL 规范化（数据迁移共用）。  背景 ---- CRM / 地磅 / 报销与 shanxia2.0 共用同一 MinIO（bucket 默, 业务表 OSS ID 串 → 相对 URL 串（用于客户证照、跟进附件等）。, 去掉预签名 query（``?X-Amz-...``）。, 将绝对/相对 URL 规范为 MinIO object key（不含 bucket）。, 迁移 CRM ``sys_oss`` 行：``url`` + ``file_name`` → 门户相对路径。 (+3 more)
 
 ### Community 88 - "CrmProduct"
-Cohesion: 0.35
-Nodes (16): ensure_crm_create_by_row_in_scope(), create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime(), Any (+8 more)
+Cohesion: 0.36
+Nodes (15): create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime(), Any, datetime (+7 more)
 
 ### Community 89 - "pl_ocr_service.py"
 Cohesion: 0.19
@@ -567,16 +586,16 @@ Cohesion: 0.17
 Nodes (8): 发送订单状态通知                  Args:             openid: 用户openid             order_n, 发送支付成功通知                  Args:             openid: 用户openid             order_n, 发送配送通知                  Args:             openid: 配送员openid             task_no:, 发送配送时效预警                  Args:             openid: 配送员openid             task_n, 发送退款结果通知                  Args:             openid: 用户openid             order_n, 发送催单通知给配送员                  Args:             deliver_openid: 配送员openid, 发送模板消息                  Args:             openid: 用户openid             template_, WechatMessageService
 
 ### Community 91 - "opportunity_product.py"
-Cohesion: 0.33
-Nodes (11): create_leave(), get_leave(), list_leaves(), Any, Session, _row_to_dict(), soft_delete_leave(), update_leave() (+3 more)
+Cohesion: 0.07
+Nodes (28): category_add(), category_delete(), category_tree(), category_update(), _map_product_export_column_keys(), product_add(), product_delete(), product_detail() (+20 more)
 
 ### Community 92 - "Community 92"
 Cohesion: 0.20
 Nodes (21): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+13 more)
 
 ### Community 93 - "api_request_log_middleware.py"
-Cohesion: 0.50
-Nodes (4): ApiRequestLogCRUD, Session, SysApiRequestLog, SysApiRequestLogHis
+Cohesion: 0.07
+Nodes (46): ApiRequestLogCRUD, Session, list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), create_leave() (+38 more)
 
 ### Community 94 - "assert_contract_editable_for_update"
 Cohesion: 0.60
@@ -591,16 +610,16 @@ Cohesion: 0.30
 Nodes (12): PlCarrier, assert_carrier_eligible_for_transport(), carrier_agreement_expired(), carrier_audit_approved(), carrier_eligible_for_transport(), carrier_qualification_complete(), date, 资质附件均为选填，保留函数签名供兼容调用。 (+4 more)
 
 ### Community 97 - "contact.py"
-Cohesion: 0.67
-Nodes (3): list_product_options(), 产品下拉 options：keyword 按产品名称/拼音首字母模糊匹配，不匹配产品编号。, test_list_product_options_keyword_only_filters_product_name()
+Cohesion: 0.15
+Nodes (25): 地磅 API 路由聚合 — REST 风格，协议对齐原 simple-dibang-xiaoshou。, _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), _generate_plan_no() (+17 more)
 
 ### Community 98 - "LocalStorage"
 Cohesion: 0.35
 Nodes (11): create_tenant(), get_tenant(), list_tenants(), Any, Session, _row_to_dict(), soft_delete_tenant(), tenant_no_exists() (+3 more)
 
 ### Community 99 - "redis_client.py"
-Cohesion: 0.13
-Nodes (17): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, 按 18 位身份证号重算 pl_personnel.age，仅更新算出值与库中不一致的记录。返回更新条数。, refresh_personnel_ages_from_id_card(), check_customer_protect_time(), pool_recovery_job(), Session (+9 more)
+Cohesion: 0.12
+Nodes (25): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, generate_uuid(), VehiclePersonnelRow, load_vehicle_personnel_rows(), Session, 运输计划 - 人员 upsert 与车辆-人员关联保存 (+17 more)
 
 ### Community 100 - "price_letter_detail"
 Cohesion: 0.27
@@ -610,30 +629,38 @@ Nodes (15): Settings, BaseSettings, apply_renumber(), build_mapping(), fetch_pro
 Cohesion: 0.29
 Nodes (15): clue_statistics_level(), clue_statistics_overview(), clue_statistics_owner(), clue_statistics_source(), clue_statistics_trend(), _apply_create_range(), _base_query(), get_clue_level_statistics() (+7 more)
 
+### Community 102 - "BaseStorage"
+Cohesion: 0.22
+Nodes (3): BaseStorage, 带下载文件名的访问 URL；默认实现为普通访问地址。, 浏览器内联预览 URL；默认实现为普通访问地址。
+
 ### Community 103 - "pl_internal_customer.py"
-Cohesion: 0.36
-Nodes (7): list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), 民族码表 sys_ethnic（国标 GB/T 3304，全局）, SysEthnic
+Cohesion: 0.08
+Nodes (25): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_list(), clue_follow_update() (+17 more)
 
 ### Community 104 - "apply_crm_create_by_scope"
-Cohesion: 0.25
-Nodes (17): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+9 more)
+Cohesion: 0.29
+Nodes (15): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+7 more)
 
 ### Community 105 - "pool_customer_assign"
 Cohesion: 0.24
 Nodes (12): get_last_month_range(), month_range(), date, Session, 地磅计划按月自动生成 — 迁移自 simple-dibang-xiaoshou/auto-create-plan/auto_create_monthly_pla, 按月自动生成采购计划。      - 默认仅在每月 1 日执行（force=True 时跳过该限制，供手动触发验收）     - 遍历所有租户，按上月计划模板生, run_auto_generate_monthly_plans(), default_execution_status() (+4 more)
 
 ### Community 106 - "site.py"
-Cohesion: 0.17
-Nodes (30): CarrierExportBody, DriverExportBody, paste_recognize_commit(), PersonnelExportBody, VehicleExportBody, generate_uuid(), PlPersonnel, PlVehicleDriver (+22 more)
+Cohesion: 0.21
+Nodes (24): CarrierExportBody, DriverExportBody, paste_recognize_commit(), PersonnelExportBody, VehicleExportBody, PlPersonnel, PlVehicleDriver, PlVehiclePersonnel (+16 more)
 
 ### Community 107 - "apply_pl_scope"
-Cohesion: 0.07
-Nodes (77): DocumentReminderExportBody, InventoryLedgerExportBody, approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def() (+69 more)
+Cohesion: 0.12
+Nodes (47): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def(), _enrich_task_list(), export_completed_tasks() (+39 more)
 
 ### Community 108 - "statistics.py"
 Cohesion: 0.20
 Nodes (24): count_source_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+16 more)
 
+### Community 109 - "duty.py"
+Cohesion: 0.15
+Nodes (22): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName（用 nick_name）。 (+14 more)
+
 ### Community 110 - "list_duty_staff_users"
 Cohesion: 0.33
 Nodes (13): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), Any (+5 more)
@@ -642,21 +669,29 @@ Nodes (13): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), cr
 Cohesion: 0.27
 Nodes (11): create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), Any, Session, 字典数据 CRUD（sys_dict_data）, 字典下拉选项：租户主数据，忽略数据范围（user_info 保留兼容调用方，不参与过滤）。 (+3 more)
 
+### Community 112 - "merge_duplicate_crm_customers.py"
+Cohesion: 0.29
+Nodes (20): Connection, backup_tables(), _contact_key(), discover_merge_pairs(), fetch_customer(), _invoice_key(), load_database_url(), main() (+12 more)
+
 ### Community 113 - "dict_type.py"
 Cohesion: 0.35
 Nodes (11): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), Any, Session, 字典类型 CRUD（sys_dict_type）, _row_to_dict() (+3 more)
 
+### Community 114 - "mappers.py"
+Cohesion: 0.26
+Nodes (19): get_plan_related(), format_datetime(), _create_by_name(), datetime_end_of_day(), fmt_date(), fmt_datetime(), inventory_date_to_api(), inventory_to_read() (+11 more)
+
 ### Community 115 - "site.py"
 Cohesion: 0.28
 Nodes (14): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+6 more)
 
 ### Community 116 - "Community 116"
-Cohesion: 0.18
-Nodes (27): calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_products_by_quote_ids() (+19 more)
+Cohesion: 0.17
+Nodes (28): batch_insert_quote_products(), calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product() (+20 more)
 
 ### Community 117 - "price_letter_detail"
-Cohesion: 0.47
-Nodes (8): create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId, resolve_storage_path(), SysOss
+Cohesion: 0.36
+Nodes (9): create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId, resolve_storage_path(), CRM 模块数据模型（产品分类、产品主表、统一附件表、客户管理、公海池、线索管理） (+1 more)
 
 ### Community 118 - "Community 118"
 Cohesion: 0.20
@@ -666,6 +701,10 @@ Nodes (24): batch_insert_contract_products(), calculate_subtotal(), _decimal_val
 Cohesion: 0.12
 Nodes (37): CertRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), is_huolala_trailer_no(), match_required_cert_name(), _missing_field_labels() (+29 more)
 
+### Community 120 - "oper_log_decorator.py"
+Cohesion: 0.18
+Nodes (17): get_oper_log_meta(), OperLogMeta, 请求级操作日志元数据（ContextVar）, 供异步落库线程使用，避免 ContextVar 跨线程丢失。, set_oper_log_meta(), snapshot_oper_log_meta(), _format_summary(), oper_log() (+9 more)
+
 ### Community 121 - "post.py"
 Cohesion: 0.39
 Nodes (10): create_post(), get_post(), list_posts(), post_code_exists(), Any, Session, _row_to_dict(), soft_delete_post() (+2 more)
@@ -675,8 +714,12 @@ Cohesion: 0.39
 Nodes (10): create_site(), get_site(), list_sites(), Any, Session, _row_to_dict(), site_code_exists(), soft_delete_site() (+2 more)
 
 ### Community 123 - "customer_options"
-Cohesion: 0.19
-Nodes (13): PlInboundOrder, PlOutboundOrder, 运输计划-入库单 pl_inbound_order, 运输计划-出库单 pl_outbound_order, load_plan_arrange_copy_flags(), PlanArrangeCopyFlags, Session, 运输计划列表：批量计算「复制给司机 / 现场 / 磅单二维码」按钮显示标志。  语义与查看弹窗 / usePlPlanArrangeActions 对齐： - (+5 more)
+Cohesion: 0.07
+Nodes (47): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+39 more)
+
+### Community 124 - "vehicle_recharge.py"
+Cohesion: 0.25
+Nodes (13): export_recharge_applies(), export_recharge_disburse_board(), list_applies(), list_disburse_board(), list_records(), pending_apply_options(), date, RechargeApplyExportBody (+5 more)
 
 ### Community 125 - "resolve_crm_product"
 Cohesion: 0.50
@@ -686,61 +729,109 @@ Nodes (4): customer_options(), 客户下拉选项（租户内只读，不做 own
 Cohesion: 0.36
 Nodes (13): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), menu_name_exists(), Any (+5 more)
 
+### Community 127 - "get_current_user_by_token"
+Cohesion: 0.21
+Nodes (14): change_current_user_password(), get_current_user_profile(), get_web_auth_menu_codes(), public_quote_share(), Request, Session, 获取当前用户信息（与 sys_user 字段对应）。, 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。 (+6 more)
+
 ### Community 128 - "product_allowed"
-Cohesion: 0.28
-Nodes (11): assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed(), Any, Session, 批量回填明细行 isToxic/isExplosive（来自产品主数据，供前端切换主体剔除）。, test_dual_requires_both() (+3 more)
+Cohesion: 0.21
+Nodes (15): _build_contract_name_from_parties(), _get_supplier_short_name(), 根据供需方面板与主数据生成/校正合同名称。, get_supplier_info(), assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed() (+7 more)
 
 ### Community 129 - "BaseStorage"
 Cohesion: 0.12
 Nodes (24): _auto_contract_name_body(), generate_contract_name(), 按面板单位全称精确匹配交易主体/客户主数据，取 shortName；对不上则用全称。, 前端预览误用单位全称时，名称片段会等于面板/客户/开票全称。, 按面板供方(partyA)-需方(partyB)生成：{供方简称}-{需方简称}（{合同编号}）。      - 名称为空：按主数据简称自动生成     - 名, resolve_party_short_name(), _strip_contract_name_no_suffix(), _user_contract_name_uses_party_full_name() (+16 more)
 
+### Community 130 - "invoice_info.py"
+Cohesion: 0.38
+Nodes (13): ensure_crm_customer_linked_row_in_scope(), 客户子表（开票信息等）：先校验关联客户 owner scope，否则校验 create_by。, _clear_default_for_customer(), create_invoice_info(), get_invoice_info(), list_invoice_info_by_customer(), Any, Session (+5 more)
+
+### Community 131 - "customer_follow.py"
+Cohesion: 0.40
+Nodes (12): create_follow(), _enrich_follow_dict(), get_follow(), list_follows(), list_follows_by_customer(), Any, Session, _row_to_dict() (+4 more)
+
 ### Community 132 - "context.py"
-Cohesion: 0.10
-Nodes (36): contact_add(), contact_birthday(), contact_by_customer(), contact_decision(), contact_delete(), contact_detail(), contact_export(), contact_list() (+28 more)
+Cohesion: 0.04
+Nodes (81): clue_import_template(), contact_add(), contact_delete(), contact_update(), customer_create(), customer_delete(), customer_import_template(), customer_update() (+73 more)
+
+### Community 133 - "inventory_id.py"
+Cohesion: 0.28
+Nodes (11): DbSequence, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id(), Session, 出入库单 id 生成 — 租户内纯数字自增，并发安全。, 当前租户下纯数字 id 的最大值（不含 UUID 等非数字主键）。 (+3 more)
+
+### Community 134 - "price_letter_detail"
+Cohesion: 0.17
+Nodes (11): price_letter_add(), price_letter_detail(), price_letter_list(), price_letter_update(), price_letter_void(), PriceLetterCreateBody, PriceLetterDetailBody, PriceLetterListBody (+3 more)
+
+### Community 135 - "storage.py"
+Cohesion: 0.18
+Nodes (6): convert_heic_to_jpeg(), _guess_preview_content_type(), QiniuStorage, 文件存储工具模块  支持多种存储方式： 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 按对象键后缀推断内联预览 Content-Type（纠正上传时未写入 MIME 的情况）。, 将 HEIC/HEIF 格式转换为 JPEG 格式
 
 ### Community 136 - "Community 136"
-Cohesion: 0.19
-Nodes (18): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD（sys_role / sys_role_menu / sys_role_data_scope_detail） (+10 more)
+Cohesion: 0.26
+Nodes (14): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD（sys_role / sys_role_menu / sys_role_data_scope_detail） (+6 more)
 
-### Community 137 - "customer_options"
-Cohesion: 0.40
-Nodes (3): Any, 供 get_tenant_no 等门户工具使用。, 与门户 JWT / apply_data_scope 所需的 user_info 字段对齐。
+### Community 137 - "plan_has_incomplete_hazard_cert_exists"
+Cohesion: 0.25
+Nodes (10): _cert_url_blank(), plan_has_hazard_product_exists(), plan_has_incomplete_hazard_cert_exists(), 证书 URL 为空（NULL / 空串 / 纯空白）。, 列表筛选：计划下存在 CRM 标识为易制毒/易制爆的产品。, 列表筛选：存在危化产品且至少一张必需证书未上传。, _compile(), 危化品证上传列表筛选：EXISTS 子查询应覆盖 CRM 危化标识与证书缺口。 (+2 more)
 
 ### Community 138 - "Community 138"
 Cohesion: 0.33
 Nodes (19): check_python(), create_venv(), ensure_dirs(), ensure_valid_venv(), ensure_venv_and_runtime(), install_dependencies(), is_running(), log_error() (+11 more)
 
 ### Community 139 - "get_current_user_by_token"
-Cohesion: 0.11
-Nodes (30): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+22 more)
+Cohesion: 0.22
+Nodes (15): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage，对外保持 bx 协议。 (+7 more)
+
+### Community 140 - "UserRole"
+Cohesion: 0.10
+Nodes (22): API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单）, operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session (+14 more)
+
+### Community 141 - "redis_client.py"
+Cohesion: 0.39
+Nodes (8): get_redis_client(), get_sync_redis_client(), Redis, 共享 Redis 客户端（同步：会话鉴权；异步：API 加密 nonce）。, 同步 Redis（auth 会话等，在线程池中调用）。, 异步 Redis（API 加密 nonce 等中间件）。, _redis_common_kwargs(), redis_enabled()
+
+### Community 142 - "opportunity_export"
+Cohesion: 0.48
+Nodes (7): _opp_list_kwargs(), opportunity_export(), opportunity_kanban(), opportunity_list(), opportunity_mine_list(), OpportunityKanbanBody, OpportunityListBody
+
+### Community 143 - "_build_user_info_payload"
+Cohesion: 0.40
+Nodes (5): _avatar_url_field(), _build_user_info_payload(), 与 web-admin 静态路由 meta.roles（admin/super_admin）对齐的单元素数组。, 与 web-admin `userInfo` 字段约定一致。, _web_role_list()
 
 ### Community 145 - "resolve_crm_product"
 Cohesion: 0.14
 Nodes (24): PlTransportProductBrandQty, PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, 运输单产品回传品牌数量 pl_transport_product_brand_qty, _dict_field(), format_brand_qty_summary(), load_transport_driver_product_feedbacks(), persist_io_item_brand_qtys() (+16 more)
 
+### Community 146 - "list_public_vehicle_plates"
+Cohesion: 0.67
+Nodes (4): list_public_vehicle_plates(), Session, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no()
+
 ### Community 147 - "Community 147"
 Cohesion: 0.37
 Nodes (17): check_env(), check_python(), create_venv(), init_env(), install_dependencies(), log_error(), log_info(), log_success() (+9 more)
 
+### Community 149 - "datetime_parse.py"
+Cohesion: 0.67
+Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析：前端 date-picker 仅传 YYYY-MM-DD。
+
 ### Community 159 - "customer_update"
 Cohesion: 0.24
-Nodes (14): get_web_auth_menu_codes(), 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), Session, Web 管理端登录：基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析, 角色仅勾选按钮（F）时，补齐祖先 C/M 菜单 id，便于前端匹配 :list 路由。 (+6 more)
+Nodes (14): _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), _map_role_name_to_web(), Session, Web 管理端登录：基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析, 角色仅勾选按钮（F）时，补齐祖先 C/M 菜单 id，便于前端匹配 :list 路由。, 用户通过角色关联得到的菜单权限标识（sys_menu.perms，与前端 meta.menuCode 对齐）。 (+6 more)
 
 ### Community 162 - ".to_tenant_user_dict"
 Cohesion: 0.42
 Nodes (7): default_settlement_clause(), test_advance_payment_clause(), test_arrive_payment_clause(), test_empty_falls_back_to_arrive(), test_monthly_settlement_clause_uses_label(), test_unknown_falls_back_to_arrive(), test_volume_quarterly_other_labels()
 
 ### Community 164 - "get_client_ip"
-Cohesion: 0.09
-Nodes (46): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), _jwt_user_payload(), logout(), public_quote_share(), Request (+38 more)
+Cohesion: 0.15
+Nodes (29): _jwt_user_payload(), logout(), 公共接口（Web 登录、刷新 Token、登出；用户模型对齐 docs/sql/shanxia2.0.sql 基线）, 登出：吊销 Redis 会话（若已配置 REDIS_HOST）。无 Token 或已失效时仍返回成功（幂等）。, Web 端登录用 RSA 公钥（PKCS#1 v1.5，与 JSEncrypt 一致）, Web 端登录：账号为 sys_user.user_no，密码为 sys_user.password（bcrypt）。, refresh_token(), web_login() (+21 more)
 
 ### Community 170 - "test_quote_approver_setting.py"
-Cohesion: 0.06
-Nodes (16): BaseStorage, _guess_preview_content_type(), LocalStorage, MinIOStorage, OSSStorage, process_image_content(), Any, Path (+8 more)
+Cohesion: 0.12
+Nodes (5): LocalStorage, OSSStorage, process_image_content(), Path, 处理图片内容，如果是 HEIC 格式则转换为 JPEG
 
 ### Community 173 - "resolve_create_time_bounds"
 Cohesion: 0.06
-Nodes (80): _build_driver_url(), ContractGapExportBody, get_plan_arrange_info(), PlanExportBody, 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport() (+72 more)
+Nodes (71): _build_driver_url(), get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _resolve_other_personnel(), _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible() (+63 more)
 
 ### Community 179 - "test_pl_vehicle_personnel_photo_schema.py"
 Cohesion: 0.27
@@ -755,8 +846,8 @@ Cohesion: 0.18
 Nodes (10): 1. 创建虚拟环境, 2. 安装依赖, 3. 配置环境变量, 4. 启动服务, API 路由分组, shanxia2.0 后端骨架（FastAPI）, 开发规范, 快速开始 (+2 more)
 
 ### Community 220 - "api_crypto_middleware.py"
-Cohesion: 0.14
-Nodes (23): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+15 more)
+Cohesion: 0.24
+Nodes (13): _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key(), Redis (+5 more)
 
 ### Community 237 - "order_status_compat.py"
 Cohesion: 0.36
@@ -773,22 +864,22 @@ Nodes (6): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时
 ## Knowledge Gaps
 - **30 isolated node(s):** `Config`, `Config`, `Config`, `Config`, `Config` (+25 more)
   These have ≤1 connection - possible missing edges or undocumented components.
-- **15 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
+- **16 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
 
 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_
 
-- **Why does `generate_uuid()` connect `site.py` to `context.py`, `Community 5`, `Community 6`, `Community 4`, `Community 8`, `Community 136`, `Community 11`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `resolve_crm_product`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `Community 26`, `Community 28`, `Community 31`, `Community 32`, `Community 33`, `get_client_ip`, `Community 39`, `Community 40`, `Community 43`, `Community 44`, `resolve_create_time_bounds`, `Community 46`, `Community 47`, `Community 50`, `Community 51`, `Community 54`, `Community 56`, `Community 61`, `Community 62`, `Community 64`, `Community 65`, `Community 66`, `Community 67`, `Community 71`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `opportunity_follow.py`, `resolve_crm_product`, `customer_follow.py`, `Community 83`, `CrmProduct`, `pl_ocr_service.py`, `opportunity_product.py`, `Community 92`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `pool_customer_assign`, `list_duty_staff_users`, `dict_data.py`, `dict_type.py`, `Community 116`, `price_letter_detail`, `Community 118`, `post.py`, `site.py`, `customer_pool.py`?**
-  _High betweenness centrality (0.191) - this node is a cross-community bridge._
-- **Why does `BaseModel` connect `Community 27` to `Community 0`, `Community 1`, `Community 2`, `context.py`, `Community 5`, `Community 6`, `Community 7`, `Community 11`, `UserRole`, `Community 12`, `get_current_user_by_token`, `Community 13`, `Community 16`, `Community 14`, `Community 18`, `Community 15`, `Community 20`, `Community 23`, `Community 26`, `Community 28`, `Community 33`, `Community 37`, `Community 39`, `Community 40`, `Community 41`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 49`, `Community 51`, `Community 52`, `Community 54`, `Community 57`, `Community 63`, `Community 64`, `Community 65`, `Community 66`, `Community 71`, `Community 74`, `storage.py`, `allocate_next_biz_no`, `Community 87`, `test_pl_public_link_archived.py`, `tenant.py`, `site.py`, `apply_pl_scope`, `site.py`, `Community 119`, `resolve_crm_product`?**
-  _High betweenness centrality (0.094) - this node is a cross-community bridge._
-- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 38`, `Community 70`, `Community 73`, `Community 42`, `statistics.py`, `Community 48`, `Community 59`, `Community 30`?**
-  _High betweenness centrality (0.094) - this node is a cross-community bridge._
+- **Why does `generate_uuid()` connect `redis_client.py` to `Community 0`, `invoice_info.py`, `customer_follow.py`, `Community 4`, `Community 5`, `Community 6`, `inventory_id.py`, `Community 8`, `Community 136`, `Community 11`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `resolve_crm_product`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `Community 26`, `Community 28`, `Community 31`, `Community 32`, `Community 33`, `get_client_ip`, `Community 36`, `Community 39`, `Community 40`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 47`, `Community 50`, `Community 51`, `Community 54`, `Community 56`, `Community 58`, `Community 61`, `Community 62`, `Community 64`, `Community 65`, `Community 67`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `resolve_crm_product`, `customer_follow.py`, `storage.py`, `Community 83`, `CrmProduct`, `pl_ocr_service.py`, `Community 92`, `api_request_log_middleware.py`, `contact.py`, `LocalStorage`, `apply_crm_create_by_scope`, `pool_customer_assign`, `site.py`, `list_duty_staff_users`, `dict_data.py`, `dict_type.py`, `Community 116`, `price_letter_detail`, `Community 118`, `post.py`, `site.py`, `customer_options`, `customer_pool.py`?**
+  _High betweenness centrality (0.172) - this node is a cross-community bridge._
+- **Why does `BaseModel` connect `Community 12` to `Community 0`, `Community 1`, `Community 2`, `Community 3`, `context.py`, `Community 5`, `price_letter_detail`, `Community 7`, `Community 10`, `Community 11`, `UserRole`, `Community 13`, `opportunity_export`, `Community 15`, `Community 16`, `Community 18`, `Community 20`, `Community 23`, `Community 26`, `Community 27`, `Community 34`, `Community 36`, `Community 37`, `Community 41`, `Community 43`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 49`, `Community 51`, `Community 52`, `Community 53`, `Community 54`, `Community 57`, `Community 58`, `Community 63`, `Community 64`, `Community 65`, `Community 66`, `Community 71`, `Community 74`, `storage.py`, `Community 83`, `opportunity_product.py`, `api_request_log_middleware.py`, `test_pl_public_link_archived.py`, `contact.py`, `redis_client.py`, `tenant.py`, `pl_internal_customer.py`, `site.py`, `apply_pl_scope`, `duty.py`, `site.py`, `Community 119`, `customer_options`, `vehicle_recharge.py`, `resolve_crm_product`?**
+  _High betweenness centrality (0.098) - this node is a cross-community bridge._
+- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 70`, `Community 73`, `Community 42`, `statistics.py`, `Community 44`, `config.py`, `Community 48`, `Community 19`, `Community 59`, `Community 30`?**
+  _High betweenness centrality (0.084) - this node is a cross-community bridge._
 - **Are the 30 inferred relationships involving `DbUserContext` (e.g. with `InventoryExportBody` and `InventoryRelatedData`) actually correct?**
   _`DbUserContext` has 30 INFERRED edges - model-reasoned connections that need verification._
 - **What connects `API 路由包 — 山峡化工生产一体化门户`, `返回运营端角色下拉选项（label=库中角色名，value=Web 角色码）。`, `返回用户下拉选项（label=昵称，value=用户ID，附带 nickName/userNo）。      供申请人/审批人等选择场景使用，返回本租户全部有效` to the rest of the system?**
   _612 weakly-connected nodes found - possible documentation gaps or missing edges._
+- **Should `Community 0` be split into smaller, more focused modules?**
+  _Cohesion score 0.12955465587044535 - nodes in this community are weakly interconnected._
 - **Should `Community 1` be split into smaller, more focused modules?**
-  _Cohesion score 0.06666666666666667 - nodes in this community are weakly interconnected._
-- **Should `Community 2` be split into smaller, more focused modules?**
-  _Cohesion score 0.13732004429678848 - nodes in this community are weakly interconnected._
+  _Cohesion score 0.07549361207897794 - nodes in this community are weakly interconnected._

backend/graphify-out/cache/ast/v0.9.4/227619f14026aff95d83d7088b4b2123ae2ac0a374404311162ef41e6d90599a.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_py", "label": "crm.py", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L1"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_filter_export_rows_by_ids", "label": "_filter_export_rows_by_ids()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L337"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_category_tree", "label": "category_tree()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L354"}, {"id": "productcategorytreebody", "label": "ProductCategoryTreeBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "session", "label": "Session", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_list", "label": "customer_list()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L382"}, {"id": "customerlistbody", "label": "CustomerListBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_detail", "label": "customer_detail()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L416"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_options", "label": "customer_options()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L442"}, {"id": "customeroptionsbody", "label": "CustomerOptionsBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_create", "label": "customer_create()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L466"}, {"id": "customercreatebody", "label": "CustomerCreateBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_update", "label": "customer_update()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L497"}, {"id": "customerupdatebody", "label": "CustomerUpdateBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_delete", "label": "customer_delete()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L526"}, {"id": "customerdeletebody", "label": "CustomerDeleteBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_customer_generate_no", "label": "customer_generate_no()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L554"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_category_add", "label": "category_add()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L570"}, {"id": "productcategorycreatebody", "label": "ProductCategoryCreateBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_category_update", "label": "category_update()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L589"}, {"id": "productcategoryupdatebody", "label": "ProductCategoryUpdateBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_category_delete", "label": "category_delete()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L609"}, {"id": "categorydeletebody", "label": "CategoryDeleteBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_api_crm_product_list", "label": "product_list()", "file_type": "code", "source_file": "app/api/crm.py", "source_location": "L629"}, {"id": "productlistbody", "label": "ProductListBody", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/api/crm.py"}, {"id"Line truncated

backend/graphify-out/cache/ast/v0.9.4/47a8068a2e8cb575c96c45d7d199ad4418c53e89cebcae456496add410623f26.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_py", "label": "clue.py", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L1"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_ensure_clue_in_scope", "label": "_ensure_clue_in_scope()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L18"}, {"id": "session", "label": "Session", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/clue.py"}, {"id": "crmclue", "label": "CrmClue", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/clue.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_total_pages", "label": "total_pages()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L22"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_parse_optional_date", "label": "_parse_optional_date()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L32"}, {"id": "any", "label": "Any", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/clue.py"}, {"id": "date", "label": "date", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/clue.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_parse_optional_datetime", "label": "_parse_optional_datetime()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L50"}, {"id": "datetime", "label": "datetime", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/clue.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_resolve_user_display_name", "label": "_resolve_user_display_name()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L66"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_enrich_user_names", "label": "_enrich_user_names()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L76"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_row_to_dict", "label": "_row_to_dict()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L103"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_list_clues", "label": "list_clues()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L148"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_get_clue", "label": "get_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L248"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_create_clue", "label": "create_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L259"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_update_clue", "label": "update_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L324"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_soft_delete_clue", "label": "soft_delete_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L390"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_assign_clues", "label": "assign_clues()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L413"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_convert_clue", "label": "convert_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L457"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_validate_convertible", "label": "_validate_convertible()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L568"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_check_convert", "label": "check_convert()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L581"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_invalid_clue", "label": "invalid_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L591"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_check_duplicate_clue", "label": "check_duplicate_clue()", "file_type": "code", "source_file": "app/crud/crm/clue.py", "source_location": "L618"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_clue_import_clues", "label": "import_clues()", "file_type": "coLine truncated

backend/graphify-out/cache/ast/v0.9.4/804d2f2f9152539b9453bfa7983480dd787bd55f13a4b0423a77df33cfa38224.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_py", "label": "customer.py", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L1"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_ensure_customer_in_scope", "label": "_ensure_customer_in_scope()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L23"}, {"id": "session", "label": "Session", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/customer.py"}, {"id": "crmcustomer", "label": "CrmCustomer", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/customer.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_total_pages", "label": "total_pages()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L27"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_parse_optional_date", "label": "_parse_optional_date()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L37"}, {"id": "any", "label": "Any", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/customer.py"}, {"id": "date", "label": "date", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/customer.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_parse_optional_datetime", "label": "_parse_optional_datetime()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L55"}, {"id": "datetime", "label": "datetime", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/app/crud/crm/customer.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_resolve_user_display_name", "label": "_resolve_user_display_name()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L71"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_enrich_user_names", "label": "_enrich_user_names()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L81"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_row_to_dict", "label": "_row_to_dict()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L108"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_list_customer_options", "label": "list_customer_options()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L163"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_list_customers", "label": "list_customers()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L214"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_list_pool_customers", "label": "list_pool_customers()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L343"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_get_customer", "label": "get_customer()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L372"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_get_customer_by_no", "label": "get_customer_by_no()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L383"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_generate_customer_no", "label": "generate_customer_no()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L395"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_customer_name_exists", "label": "customer_name_exists()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L421"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_check_duplicate_customer", "label": "check_duplicate_customer()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L437"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_create_customer", "label": "create_customer()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L460"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_crud_crm_customer_update_customer", "label": "update_customer()", "file_type": "code", "source_file": "app/crud/crm/customer.py", "source_location": "L541"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_app_cLine truncated

backend/graphify-out/cache/ast/v0.9.4/eec623d56bea8ec1a1e2ab0370008fa911360c5ff7d48f2b5682f1f287993810.json

@@ -0,0 +1 @@
+{"nodes": [{"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_py", "label": "merge_duplicate_crm_customers.py", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L1"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_norm", "label": "_norm()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L79"}, {"id": "any", "label": "Any", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/scripts/merge_duplicate_crm_customers.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_contact_key", "label": "_contact_key()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L85"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_invoice_key", "label": "_invoice_key()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L92"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_row_to_dict", "label": "_row_to_dict()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L96"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_load_database_url", "label": "load_database_url()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L100"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_discover_merge_pairs", "label": "discover_merge_pairs()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L114"}, {"id": "connection", "label": "Connection", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/scripts/merge_duplicate_crm_customers.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_backup_tables", "label": "backup_tables()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L147"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_fetch_customer", "label": "fetch_customer()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L157"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_merge_contacts", "label": "merge_contacts()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L165"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_merge_invoices", "label": "merge_invoices()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L257"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_migrate_customer_refs", "label": "migrate_customer_refs()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L349"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_merge_customer_master", "label": "merge_customer_master()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L410"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_recalc_customer_stats", "label": "recalc_customer_stats()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L462"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_soft_delete_source_customer", "label": "soft_delete_source_customer()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L529"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_verify", "label": "verify()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L552"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_run", "label": "run()", "file_type": "code", "source_file": "scripts/merge_duplicate_crm_customers.py", "source_location": "L616"}, {"id": "engine", "label": "Engine", "file_type": "code", "source_file": "", "source_location": "", "origin_file": "/Users/wuzilong/work/00code/shanxia2.0/backend/scripts/merge_duplicate_crm_customers.py"}, {"id": "users_wuzilong_work_00code_shanxia2_0_backend_scripts_merge_duplicate_crm_customers_main", "label": "main()", "file_type": "code", "source_file": "scripts/merge_duplicaLine truncated

backend/graphify-out/cache/stat-index.json

@@ -1 +1 @@
-{"/Users/zlwu/work/00code/shanxia2.0/backend/start-prod.sh":{"size":7357,"mtime_ns":1782639355476060453,"hash":"ca89869446be74a2bf2367b3b28f448580220859a39a84ad9613ac5fe35a8433"},"/Users/zlwu/work/00code/shanxia2.0/backend/start.sh":{"size":9548,"mtime_ns":1780114661446983244,"hash":"4d632863e8a0cd81194b491d83a0218a4157435ae812dec76a6f6197b4d48e57"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/__init__.py":{"size":21,"mtime_ns":1780113982281973984,"hash":"60a04ff08fd97084e83ea809fd13feda6d2848be20ebf309e31fc1dad7523230"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/main.py":{"size":6280,"mtime_ns":1782790852770448643,"hash":"8f9da799977bee7134d87a26ff8434ac5ef8eabb0b7368dd537eee49ad7fd00b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/tasks/__init__.py":{"size":2207,"mtime_ns":1783208067881286091,"hash":"313e6da0e91d743ce891dd283458c79b50b24c4d909dc96ca7b3fd9d2bfa5013"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/auth.py":{"size":7457,"mtime_ns":1782790841500516545,"hash":"34bac56e1c2cb6215f4b5fa2dc32d77d4b4abca51428819eebf4afd269cc51cf"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_crypto.py":{"size":1870,"mtime_ns":1780108930724444498,"hash":"c04b748aea86890a5971f749523c7b17dbad1ddd6f9f7f07a5679d159c984e33"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/login_crypto.py":{"size":3858,"mtime_ns":1780108930725155710,"hash":"b82d51afabf2293a9cb1fb2e5f994c383948e7f47ea95fe674686b4f3f3342b1"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/config.py":{"size":6958,"mtime_ns":1784032424448146538,"hash":"c2fb44aedb880733de28afa7f92d2c1c681eb600f821bbeba2bcda3933e5bc37"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/wechat_pay.py":{"size":23585,"mtime_ns":1780108930725768130,"hash":"3d52265ce65d21e7103f94afa1e8547aee0823b5ea6d65c50317436ac81fb4fc"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_request_log_middleware.py":{"size":11971,"mtime_ns":1782701669198208175,"hash":"0b84c32828939e6102bb3647691fa8f04b1f68e0e0e9f28127374cc44e19a11c"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/database.py":{"size":1510,"mtime_ns":1782790847265601586,"hash":"8bc9c8ae62e2be2c6920036582ba448dfcd1711c41cebb62274ff6bc6ee14b0b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/security.py":{"size":728,"mtime_ns":1780108930725470004,"hash":"df0f01115064f7b8de1c81dbe9a6db39360c236610b68c33b3234a51d7f0025b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/request_payload.py":{"size":2842,"mtime_ns":1780108930725350836,"hash":"e9937151530ab1417ef297aef59111977725cf90be2a8fa76c00a0618789aba0"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/__init__.py":{"size":61,"mtime_ns":1780108930724312414,"hash":"3dd1842ee59b0c804176b03b4b8a323bd4a252b7feb1bbc32db64f3a8928570e"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/response.py":{"size":1824,"mtime_ns":1780108930725412462,"hash":"f1739352d65ea8287d76e282a59553aa8d63c97e35764c64ac378aa5bd9c347e"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/menu_guard.py":{"size":1611,"mtime_ns":1780108930725223002,"hash":"3e26077288c3620a4780038b891a326206b45bffe00aca545bdae30172487235"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/db_collation.py":{"size":548,"mtime_ns":1780108930725025043,"hash":"0c680e25a18244ca839a7de6ed1f4313b33bc8da118d89c463aee1b6af00c6f9"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/context.py":{"size":421,"mtime_ns":1780108930724824458,"hash":"83a10aee67162374993c10a30bf8bb8bd9c4b35cf48f42c832415ccebd91660f"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/utils.py":{"size":1498,"mtime_ns":1780108930725607296,"hash":"09323693661c1d4560458b86a954128ccff82bbaf6522da0b44f24da99ddf9ea"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/storage.py":{"size":14141,"mtime_ns":1782855136810943216,"hash":"3ae2c413c10898a8adb3d6773870bafbfbc18c739c10e0e8b4f765b4b5ca6c08"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/order_status_compat.py":{"size":2828,"mtime_ns":1780108930725284669,"hash":"5349e5a0745ee6734c4a995337779307adefc46f453906171988a77de2081540"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/exceptions.py":{"size":4946,"mtime_ns":1780108930725084335,"hash":"79c997d964bca1a4f12f2b92fb1f181fdb9e2b3cf72eae39f4cc164d23794fd7"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/data_scope.py":{"size":8043,"mtime_ns":1782648925694296304,"hash":"626dff86937e5cacec634ecbc61cd53d3763d760223a1d4ec7cd11f64e59a220"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/admin_request_json.py":{"size":2669,"mtime_ns":1780108930724378914,"hash":"4f68b3cf84291e7bddad6ecf4bb4d29ca5e1ec246a9f7f9c4cf5909d0ec1174a"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_crypto_middleware.py":{"size":10876,"mtime_ns":1782790001926627098,"hash":"b39f128b6612589ea6ac5babd30752e9585b3af07b82bb1ad53c9e3c0d90816f"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/wechat_message.py":{"size":11194,"mtime_ns":1780108930725684255,"hash":"5086070deb14d99d1a69e419b2299ec4Line truncated
+{"/Users/zlwu/work/00code/shanxia2.0/backend/start-prod.sh":{"size":7357,"mtime_ns":1782639355476060453,"hash":"ca89869446be74a2bf2367b3b28f448580220859a39a84ad9613ac5fe35a8433"},"/Users/zlwu/work/00code/shanxia2.0/backend/start.sh":{"size":9548,"mtime_ns":1780114661446983244,"hash":"4d632863e8a0cd81194b491d83a0218a4157435ae812dec76a6f6197b4d48e57"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/__init__.py":{"size":21,"mtime_ns":1780113982281973984,"hash":"60a04ff08fd97084e83ea809fd13feda6d2848be20ebf309e31fc1dad7523230"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/main.py":{"size":6280,"mtime_ns":1782790852770448643,"hash":"8f9da799977bee7134d87a26ff8434ac5ef8eabb0b7368dd537eee49ad7fd00b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/tasks/__init__.py":{"size":2207,"mtime_ns":1783208067881286091,"hash":"313e6da0e91d743ce891dd283458c79b50b24c4d909dc96ca7b3fd9d2bfa5013"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/auth.py":{"size":7457,"mtime_ns":1782790841500516545,"hash":"34bac56e1c2cb6215f4b5fa2dc32d77d4b4abca51428819eebf4afd269cc51cf"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_crypto.py":{"size":1870,"mtime_ns":1780108930724444498,"hash":"c04b748aea86890a5971f749523c7b17dbad1ddd6f9f7f07a5679d159c984e33"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/login_crypto.py":{"size":3858,"mtime_ns":1780108930725155710,"hash":"b82d51afabf2293a9cb1fb2e5f994c383948e7f47ea95fe674686b4f3f3342b1"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/config.py":{"size":6958,"mtime_ns":1784032424448146538,"hash":"c2fb44aedb880733de28afa7f92d2c1c681eb600f821bbeba2bcda3933e5bc37"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/wechat_pay.py":{"size":23585,"mtime_ns":1780108930725768130,"hash":"3d52265ce65d21e7103f94afa1e8547aee0823b5ea6d65c50317436ac81fb4fc"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_request_log_middleware.py":{"size":11971,"mtime_ns":1782701669198208175,"hash":"0b84c32828939e6102bb3647691fa8f04b1f68e0e0e9f28127374cc44e19a11c"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/database.py":{"size":1510,"mtime_ns":1782790847265601586,"hash":"8bc9c8ae62e2be2c6920036582ba448dfcd1711c41cebb62274ff6bc6ee14b0b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/security.py":{"size":728,"mtime_ns":1780108930725470004,"hash":"df0f01115064f7b8de1c81dbe9a6db39360c236610b68c33b3234a51d7f0025b"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/request_payload.py":{"size":2842,"mtime_ns":1780108930725350836,"hash":"e9937151530ab1417ef297aef59111977725cf90be2a8fa76c00a0618789aba0"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/__init__.py":{"size":61,"mtime_ns":1780108930724312414,"hash":"3dd1842ee59b0c804176b03b4b8a323bd4a252b7feb1bbc32db64f3a8928570e"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/response.py":{"size":1824,"mtime_ns":1780108930725412462,"hash":"f1739352d65ea8287d76e282a59553aa8d63c97e35764c64ac378aa5bd9c347e"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/menu_guard.py":{"size":1611,"mtime_ns":1780108930725223002,"hash":"3e26077288c3620a4780038b891a326206b45bffe00aca545bdae30172487235"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/db_collation.py":{"size":548,"mtime_ns":1780108930725025043,"hash":"0c680e25a18244ca839a7de6ed1f4313b33bc8da118d89c463aee1b6af00c6f9"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/context.py":{"size":421,"mtime_ns":1780108930724824458,"hash":"83a10aee67162374993c10a30bf8bb8bd9c4b35cf48f42c832415ccebd91660f"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/utils.py":{"size":1498,"mtime_ns":1780108930725607296,"hash":"09323693661c1d4560458b86a954128ccff82bbaf6522da0b44f24da99ddf9ea"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/storage.py":{"size":14141,"mtime_ns":1782855136810943216,"hash":"3ae2c413c10898a8adb3d6773870bafbfbc18c739c10e0e8b4f765b4b5ca6c08"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/order_status_compat.py":{"size":2828,"mtime_ns":1780108930725284669,"hash":"5349e5a0745ee6734c4a995337779307adefc46f453906171988a77de2081540"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/exceptions.py":{"size":4946,"mtime_ns":1780108930725084335,"hash":"79c997d964bca1a4f12f2b92fb1f181fdb9e2b3cf72eae39f4cc164d23794fd7"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/data_scope.py":{"size":8043,"mtime_ns":1782648925694296304,"hash":"626dff86937e5cacec634ecbc61cd53d3763d760223a1d4ec7cd11f64e59a220"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/admin_request_json.py":{"size":2669,"mtime_ns":1780108930724378914,"hash":"4f68b3cf84291e7bddad6ecf4bb4d29ca5e1ec246a9f7f9c4cf5909d0ec1174a"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/api_crypto_middleware.py":{"size":10876,"mtime_ns":1782790001926627098,"hash":"b39f128b6612589ea6ac5babd30752e9585b3af07b82bb1ad53c9e3c0d90816f"},"/Users/zlwu/work/00code/shanxia2.0/backend/app/core/wechat_message.py":{"size":11194,"mtime_ns":1780108930725684255,"hash":"5086070deb14d99d1a69e419b2299ec4Line truncated

backend/graphify-out/graph.html

@@ -63,12 +63,12 @@
     </div>
     <div id="legend"></div>
   </div>
-  <div id="stats">4814 nodes &middot; 18137 edges &middot; 167 communities</div>
+  <div id="stats">4835 nodes &middot; 18202 edges &middot; 186 communities</div>
 </div>
 <script>
-const RAW_NODES = [{"id": "app_init", "label": "__init__.py", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "__init__.py", "community": 304, "community_name": "__init__.py", "source_file": "app/__init__.py", "file_type": "code", "degree": 0}, {"id": "app_api_init", "label": "__init__.py", "color": {"background": "#FF9DA7", "border": "#FF9DA7", "highlight": {"background": "#ffffff", "border": "#FF9DA7"}}, "size": 10.6, "font": {"size": 0, "color": "#ffffff"}, "title": "__init__.py", "community": 57, "community_name": "Community 57", "source_file": "app/api/__init__.py", "file_type": "code", "degree": 10}, {"id": "app_api_init_rationale_1", "label": "API \u8def\u7531\u5305 \u2014 \u5c71\u5ce1\u5316\u5de5\u751f\u4ea7\u4e00\u4f53\u5316\u95e8\u6237", "color": {"background": "#FF9DA7", "border": "#FF9DA7", "highlight": {"background": "#ffffff", "border": "#FF9DA7"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "API \u8def\u7531\u5305 \u2014 \u5c71\u5ce1\u5316\u5de5\u751f\u4ea7\u4e00\u4f53\u5316\u95e8\u6237", "community": 57, "community_name": "Community 57", "source_file": "app/api/__init__.py", "file_type": "rationale", "degree": 1}, {"id": "app_api_admin", "label": "admin.py", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 18.8, "font": {"size": 12, "color": "#ffffff"}, "title": "admin.py", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 149}, {"id": "app_api_admin_list_roles_for_select", "label": "list_roles_for_select()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_roles_for_select()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_py_session", "label": "Session", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 14.1, "font": {"size": 0, "color": "#ffffff"}, "title": "Session", "community": 3, "community_name": "Community 3", "source_file": "", "file_type": "code", "degree": 69}, {"id": "app_api_admin_list_users_for_select", "label": "list_users_for_select()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_users_for_select()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_list_roles_for_designer", "label": "list_roles_for_designer()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_roles_for_designer()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_tenantcreatebody", "label": "TenantCreateBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantCreateBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_tenantupdatebody", "label": "TenantUpdateBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantUpdateBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_list_tenants", "label": "list_tenants()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "list_tenants()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 4}, {"id": "app_api_admin_tenantexportbody", "label": "TenantExportBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantExportBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_export_tenants", "label": "export_tenants()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"Line truncated
-const RAW_EDGES = [{"from": "app_api_init", "to": "app_api_admin", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_bx_init", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_crm", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_db_init", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_leave", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_menu", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_monitor", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_public", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_workflow", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init_rationale_1", "to": "app_api_init", "label": "rationale_for", "title": "rationale_for [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachment_download_url", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachment_preview_url", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachmentdownloadurlbody", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dept", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dict_data", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dict_type", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_menu", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_menu_favorite", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_post", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_role_management", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_site", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_tenant", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_user", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_delete_dept", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_delete_dict_data", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"Line truncated
-const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "Community 0", "count": 24}, {"cid": 1, "color": "#F28E2B", "label": "Community 1", "count": 46}, {"cid": 2, "color": "#E15759", "label": "Community 2", "count": 43}, {"cid": 3, "color": "#76B7B2", "label": "Community 3", "count": 95}, {"cid": 4, "color": "#59A14F", "label": "Community 4", "count": 63}, {"cid": 5, "color": "#EDC948", "label": "Community 5", "count": 100}, {"cid": 6, "color": "#B07AA1", "label": "Community 6", "count": 65}, {"cid": 7, "color": "#FF9DA7", "label": "Community 7", "count": 199}, {"cid": 8, "color": "#9C755F", "label": "Community 8", "count": 37}, {"cid": 9, "color": "#BAB0AC", "label": "Community 9", "count": 56}, {"cid": 10, "color": "#4E79A7", "label": "Community 10", "count": 6}, {"cid": 11, "color": "#F28E2B", "label": "Community 11", "count": 65}, {"cid": 12, "color": "#E15759", "label": "Community 12", "count": 54}, {"cid": 13, "color": "#76B7B2", "label": "Community 13", "count": 48}, {"cid": 14, "color": "#59A14F", "label": "Community 14", "count": 58}, {"cid": 15, "color": "#EDC948", "label": "Community 15", "count": 53}, {"cid": 16, "color": "#B07AA1", "label": "Community 16", "count": 70}, {"cid": 17, "color": "#FF9DA7", "label": "Community 17", "count": 34}, {"cid": 18, "color": "#9C755F", "label": "Community 18", "count": 78}, {"cid": 19, "color": "#BAB0AC", "label": "Community 19", "count": 19}, {"cid": 20, "color": "#4E79A7", "label": "Community 20", "count": 47}, {"cid": 21, "color": "#F28E2B", "label": "Community 21", "count": 56}, {"cid": 22, "color": "#E15759", "label": "Community 22", "count": 43}, {"cid": 23, "color": "#76B7B2", "label": "Community 23", "count": 74}, {"cid": 24, "color": "#59A14F", "label": "Community 24", "count": 19}, {"cid": 25, "color": "#EDC948", "label": "Community 25", "count": 13}, {"cid": 26, "color": "#B07AA1", "label": "Community 26", "count": 33}, {"cid": 27, "color": "#FF9DA7", "label": "Community 27", "count": 65}, {"cid": 28, "color": "#9C755F", "label": "Community 28", "count": 66}, {"cid": 29, "color": "#BAB0AC", "label": "Community 29", "count": 19}, {"cid": 30, "color": "#4E79A7", "label": "Community 30", "count": 27}, {"cid": 31, "color": "#F28E2B", "label": "Community 31", "count": 47}, {"cid": 32, "color": "#E15759", "label": "Community 32", "count": 25}, {"cid": 33, "color": "#76B7B2", "label": "Community 33", "count": 33}, {"cid": 34, "color": "#59A14F", "label": "Community 34", "count": 17}, {"cid": 35, "color": "#EDC948", "label": "Community 35", "count": 38}, {"cid": 36, "color": "#B07AA1", "label": "Community 36", "count": 15}, {"cid": 37, "color": "#FF9DA7", "label": "Community 37", "count": 28}, {"cid": 38, "color": "#9C755F", "label": "Community 38", "count": 15}, {"cid": 39, "color": "#BAB0AC", "label": "Community 39", "count": 72}, {"cid": 40, "color": "#4E79A7", "label": "Community 40", "count": 33}, {"cid": 41, "color": "#F28E2B", "label": "Community 41", "count": 32}, {"cid": 42, "color": "#E15759", "label": "Community 42", "count": 108}, {"cid": 43, "color": "#76B7B2", "label": "Community 43", "count": 50}, {"cid": 44, "color": "#59A14F", "label": "Community 44", "count": 33}, {"cid": 45, "color": "#EDC948", "label": "Community 45", "count": 53}, {"cid": 46, "color": "#B07AA1", "label": "Community 46", "count": 87}, {"cid": 47, "color": "#FF9DA7", "label": "Community 47", "count": 35}, {"cid": 48, "color": "#9C755F", "label": "Community 48", "count": 23}, {"cid": 49, "color": "#BAB0AC", "label": "Community 49", "count": 31}, {"cid": 50, "color": "#4E79A7", "label": "Community 50", "count": 31}, {"cid": 51, "color": "#F28E2B", "label": "Community 51", "count": 40}, {"cid": 52, "color": "#E15759", "label": "Community 52", "count": 87}, {"cid": 53, "color": "#76B7B2", "label": "Community 53", "count": 10}, {"cid": 54, "color": "#59A14F", "label": "Community 54", "count": 42}, {"cid": 55, "color": "#EDC948", "label": "Community 55", "count": 12}, {"cid": 56, "color": "#B07AA1", "label": "Community 56", "count": 27}, {"cid": 57, "color": "#FF9DA7", "label": "Community 57", "count": 25}, {"cid": 58, "color": "#9C755F", "label": "Community 58", "count": 23}, {"cid": 59, "color": "#BAB0AC", "label": "Community 59", "count": 30}, {"cid": 60, "color": "#4E79A7", "label": "Community 60", "count": 9}, {"cid": 61, "color": "#F28E2B", "label": "Community 61", "count": 44}, {"cid": 62, "color": "#E15759", "label": "Community 62", "count": 70}, {"cid": 63, "color": "#76B7B2", "label": "Community 63", "count": 23}, {"cid": 64, "color": "#59A14F", "label": "Community 64", "count": 29}, {"cid": 65, "color": "#EDC948", "label": "Community 65", "count": 67}, {"cid": 66, "color": "#B07AA1", "label": "Community 66", "count": 46}, {"cid": 67, "color": "#FF9DA7", "label": "Community 67", "count": 38}, {"cid": 68, "color": "#9C755F", "label": "Community 68", "count": 20}, {"cid": 69, "color": "#BAB0AC", "label": "Community 69", "count": 29}, {"cid": 70, "color": "#4E79A7", Line truncated
+const RAW_NODES = [{"id": "app_init", "label": "__init__.py", "color": {"background": "#59A14F", "border": "#59A14F", "highlight": {"background": "#ffffff", "border": "#59A14F"}}, "size": 10.0, "font": {"size": 0, "color": "#ffffff"}, "title": "__init__.py", "community": 304, "community_name": "__init__.py", "source_file": "app/__init__.py", "file_type": "code", "degree": 0}, {"id": "app_api_init", "label": "__init__.py", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.6, "font": {"size": 0, "color": "#ffffff"}, "title": "__init__.py", "community": 140, "community_name": "UserRole", "source_file": "app/api/__init__.py", "file_type": "code", "degree": 10}, {"id": "app_api_init_rationale_1", "label": "API \u8def\u7531\u5305 \u2014 \u5c71\u5ce1\u5316\u5de5\u751f\u4ea7\u4e00\u4f53\u5316\u95e8\u6237", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.1, "font": {"size": 0, "color": "#ffffff"}, "title": "API \u8def\u7531\u5305 \u2014 \u5c71\u5ce1\u5316\u5de5\u751f\u4ea7\u4e00\u4f53\u5316\u95e8\u6237", "community": 140, "community_name": "UserRole", "source_file": "app/api/__init__.py", "file_type": "rationale", "degree": 1}, {"id": "app_api_admin", "label": "admin.py", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 18.8, "font": {"size": 12, "color": "#ffffff"}, "title": "admin.py", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 149}, {"id": "app_api_admin_list_roles_for_select", "label": "list_roles_for_select()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_roles_for_select()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_py_session", "label": "Session", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 14.1, "font": {"size": 0, "color": "#ffffff"}, "title": "Session", "community": 3, "community_name": "Community 3", "source_file": "", "file_type": "code", "degree": 69}, {"id": "app_api_admin_list_users_for_select", "label": "list_users_for_select()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_users_for_select()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_list_roles_for_designer", "label": "list_roles_for_designer()", "color": {"background": "#76B7B2", "border": "#76B7B2", "highlight": {"background": "#ffffff", "border": "#76B7B2"}}, "size": 10.3, "font": {"size": 0, "color": "#ffffff"}, "title": "list_roles_for_designer()", "community": 3, "community_name": "Community 3", "source_file": "app/api/admin.py", "file_type": "code", "degree": 5}, {"id": "app_api_admin_tenantcreatebody", "label": "TenantCreateBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantCreateBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_tenantupdatebody", "label": "TenantUpdateBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantUpdateBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_list_tenants", "label": "list_tenants()", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}, "size": 10.2, "font": {"size": 0, "color": "#ffffff"}, "title": "list_tenants()", "community": 10, "community_name": "Community 10", "source_file": "app/api/admin.py", "file_type": "code", "degree": 4}, {"id": "app_api_admin_tenantexportbody", "label": "TenantExportBody", "color": {"background": "#EDC948", "border": "#EDC948", "highlight": {"background": "#ffffff", "border": "#EDC948"}}, "size": 10.8, "font": {"size": 0, "color": "#ffffff"}, "title": "TenantExportBody", "community": 45, "community_name": "Community 45", "source_file": "app/api/admin.py", "file_type": "code", "degree": 13}, {"id": "app_api_admin_export_tenants", "label": "export_tenants()", "color": {"background": "#4E79A7", "border": "#4E79A7", "highlight": {"background": "#ffffff", "border": "#4E79A7"}}Line truncated
+const RAW_EDGES = [{"from": "app_api_init", "to": "app_api_admin", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_bx_init", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_crm", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_db_init", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_leave", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_menu", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_monitor", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_public", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init", "to": "app_api_workflow", "label": "re_exports", "title": "re_exports [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_init_rationale_1", "to": "app_api_init", "label": "rationale_for", "title": "rationale_for [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachment_download_url", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachment_preview_url", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_attachmentdownloadurlbody", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dept", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dict_data", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_dict_type", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_menu", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_menu_favorite", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_post", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_role_management", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_site", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_tenant", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_create_user", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_delete_dept", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"}, {"from": "app_api_admin", "to": "app_api_admin_delete_dict_data", "label": "contains", "title": "contains [EXTRACTED]", "dashes": false, "width": 2, "color": {"opacity": 0.7}, "confidence": "EXTRACTED"Line truncated
+const LEGEND = [{"cid": 0, "color": "#4E79A7", "label": "Community 0", "count": 39}, {"cid": 1, "color": "#F28E2B", "label": "Community 1", "count": 42}, {"cid": 2, "color": "#E15759", "label": "Community 2", "count": 65}, {"cid": 3, "color": "#76B7B2", "label": "Community 3", "count": 83}, {"cid": 4, "color": "#59A14F", "label": "Community 4", "count": 63}, {"cid": 5, "color": "#EDC948", "label": "Community 5", "count": 93}, {"cid": 6, "color": "#B07AA1", "label": "Community 6", "count": 40}, {"cid": 7, "color": "#FF9DA7", "label": "Community 7", "count": 79}, {"cid": 8, "color": "#9C755F", "label": "Community 8", "count": 37}, {"cid": 9, "color": "#BAB0AC", "label": "Community 9", "count": 51}, {"cid": 10, "color": "#4E79A7", "label": "Community 10", "count": 44}, {"cid": 11, "color": "#F28E2B", "label": "Community 11", "count": 45}, {"cid": 12, "color": "#E15759", "label": "Community 12", "count": 80}, {"cid": 13, "color": "#76B7B2", "label": "Community 13", "count": 42}, {"cid": 14, "color": "#59A14F", "label": "Community 14", "count": 38}, {"cid": 15, "color": "#EDC948", "label": "Community 15", "count": 54}, {"cid": 16, "color": "#B07AA1", "label": "Community 16", "count": 56}, {"cid": 17, "color": "#FF9DA7", "label": "Community 17", "count": 38}, {"cid": 18, "color": "#9C755F", "label": "Community 18", "count": 71}, {"cid": 19, "color": "#BAB0AC", "label": "Community 19", "count": 33}, {"cid": 20, "color": "#4E79A7", "label": "Community 20", "count": 38}, {"cid": 21, "color": "#F28E2B", "label": "Community 21", "count": 62}, {"cid": 22, "color": "#E15759", "label": "Community 22", "count": 43}, {"cid": 23, "color": "#76B7B2", "label": "Community 23", "count": 71}, {"cid": 24, "color": "#59A14F", "label": "Community 24", "count": 19}, {"cid": 25, "color": "#EDC948", "label": "Community 25", "count": 13}, {"cid": 26, "color": "#B07AA1", "label": "Community 26", "count": 47}, {"cid": 27, "color": "#FF9DA7", "label": "Community 27", "count": 35}, {"cid": 28, "color": "#9C755F", "label": "Community 28", "count": 63}, {"cid": 29, "color": "#BAB0AC", "label": "Community 29", "count": 19}, {"cid": 30, "color": "#4E79A7", "label": "Community 30", "count": 27}, {"cid": 31, "color": "#F28E2B", "label": "Community 31", "count": 43}, {"cid": 32, "color": "#E15759", "label": "Community 32", "count": 25}, {"cid": 33, "color": "#76B7B2", "label": "Community 33", "count": 20}, {"cid": 34, "color": "#59A14F", "label": "Community 34", "count": 32}, {"cid": 35, "color": "#EDC948", "label": "Community 35", "count": 38}, {"cid": 36, "color": "#B07AA1", "label": "Community 36", "count": 29}, {"cid": 37, "color": "#FF9DA7", "label": "Community 37", "count": 44}, {"cid": 38, "color": "#9C755F", "label": "Community 38", "count": 10}, {"cid": 39, "color": "#BAB0AC", "label": "Community 39", "count": 29}, {"cid": 40, "color": "#4E79A7", "label": "Community 40", "count": 32}, {"cid": 41, "color": "#F28E2B", "label": "Community 41", "count": 28}, {"cid": 42, "color": "#E15759", "label": "Community 42", "count": 34}, {"cid": 43, "color": "#76B7B2", "label": "Community 43", "count": 67}, {"cid": 44, "color": "#59A14F", "label": "Community 44", "count": 29}, {"cid": 45, "color": "#EDC948", "label": "Community 45", "count": 51}, {"cid": 46, "color": "#B07AA1", "label": "Community 46", "count": 66}, {"cid": 47, "color": "#FF9DA7", "label": "Community 47", "count": 22}, {"cid": 48, "color": "#9C755F", "label": "Community 48", "count": 23}, {"cid": 49, "color": "#BAB0AC", "label": "Community 49", "count": 32}, {"cid": 50, "color": "#4E79A7", "label": "Community 50", "count": 29}, {"cid": 51, "color": "#F28E2B", "label": "Community 51", "count": 24}, {"cid": 52, "color": "#E15759", "label": "Community 52", "count": 90}, {"cid": 53, "color": "#76B7B2", "label": "Community 53", "count": 17}, {"cid": 54, "color": "#59A14F", "label": "Community 54", "count": 33}, {"cid": 55, "color": "#EDC948", "label": "Community 55", "count": 12}, {"cid": 56, "color": "#B07AA1", "label": "Community 56", "count": 31}, {"cid": 57, "color": "#FF9DA7", "label": "Community 57", "count": 20}, {"cid": 58, "color": "#9C755F", "label": "Community 58", "count": 48}, {"cid": 59, "color": "#BAB0AC", "label": "Community 59", "count": 30}, {"cid": 60, "color": "#4E79A7", "label": "Community 60", "count": 11}, {"cid": 61, "color": "#F28E2B", "label": "Community 61", "count": 41}, {"cid": 62, "color": "#E15759", "label": "Community 62", "count": 68}, {"cid": 63, "color": "#76B7B2", "label": "Community 63", "count": 18}, {"cid": 64, "color": "#59A14F", "label": "Community 64", "count": 42}, {"cid": 65, "color": "#EDC948", "label": "Community 65", "count": 65}, {"cid": 66, "color": "#B07AA1", "label": "Community 66", "count": 31}, {"cid": 67, "color": "#FF9DA7", "label": "Community 67", "count": 38}, {"cid": 68, "color": "#9C755F", "label": "Community 68", "count": 20}, {"cid": 69, "color": "#BAB0AC", "label": "Community 69", "count": 36}, {"cid": 70, "color": "#4E79A7", "Line truncated
 
 // HTML-escape helper — prevents XSS when injecting graph data into innerHTML
 function esc(s) {

backend/scripts/merge_duplicate_crm_customers.py

@@ -0,0 +1,725 @@
+#!/usr/bin/env python3
+"""合并 CRM 重复客户（测试/生产均可）。
+
+规则摘要：
+- 同名 del_flag=0 客户每组保留 create_time 最新的一条（新业务记录）
+- 旧客户软删，子表 customer_id 迁到保留客户
+- 联系人/开票：核心字段相同则去重；不同则迁移；旧联系人优先 is_primary
+- 开票默认以保留客户（新）侧为准；旧侧不同内容迁移保留
+- 修改前按 YYYYMMDD 备份涉及表
+
+用法：
+  cd backend
+  venv/bin/python scripts/merge_duplicate_crm_customers.py --dry-run
+  venv/bin/python scripts/merge_duplicate_crm_customers.py --execute
+"""
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+from datetime import date, datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple
+
+from sqlalchemy import create_engine, text
+from sqlalchemy.engine import Connection, Engine
+
+BACKEND_ROOT = Path(__file__).resolve().parents[1]
+if str(BACKEND_ROOT) not in sys.path:
+    sys.path.insert(0, str(BACKEND_ROOT))
+
+TABLES_TO_TOUCH = [
+    "crm_customer",
+    "crm_contact",
+    "crm_invoice_info",
+    "crm_customer_follow",
+    "crm_opportunity",
+    "crm_contract",
+    "crm_quote",
+    "crm_price_letter",
+    "crm_clue",
+    "crm_customer_pool",
+    "pl_plan",
+]
+
+CUSTOMER_FILL_FIELDS = [
+    "short_name",
+    "customer_type",
+    "mobile",
+    "telephone",
+    "email",
+    "website",
+    "level",
+    "source",
+    "industry",
+    "park_area",
+    "payment_terms",
+    "scale",
+    "province",
+    "city",
+    "district",
+    "address",
+    "owner_user_id",
+    "owner_user_name",
+    "business_license_img",
+    "business_permit_images",
+    "other_cert_images",
+    "clue_id",
+    "next_time",
+]
+
+INVOICE_COMPARE_FIELDS = [
+    "company_name",
+    "tax_no",
+    "bank_account",
+]
+
+
+def _norm(value: Any) -> str:
+    if value is None:
+        return ""
+    return str(value).strip()
+
+
+def _contact_key(row: Dict[str, Any]) -> str:
+    mobile = _norm(row.get("mobile"))
+    telephone = _norm(row.get("telephone"))
+    phone = mobile or telephone
+    return f"{_norm(row.get('contact_name')).lower()}|{phone}"
+
+
+def _invoice_key(row: Dict[str, Any]) -> str:
+    return "|".join(_norm(row.get(f)).lower() for f in INVOICE_COMPARE_FIELDS)
+
+
+def _row_to_dict(row) -> Dict[str, Any]:
+    return dict(row._mapping)
+
+
+def load_database_url(env_file: Optional[str]) -> str:
+    if env_file:
+        path = Path(env_file)
+        if not path.is_absolute():
+            path = BACKEND_ROOT / path
+        for line in path.read_text(encoding="utf-8").splitlines():
+            line = line.strip()
+            if line.startswith("DATABASE_URL="):
+                return line.split("=", 1)[1].strip()
+    from app.core.config import settings
+
+    return settings.DATABASE_URL
+
+
+def discover_merge_pairs(conn: Connection) -> List[Dict[str, Any]]:
+    rows = conn.execute(
+        text(
+            """
+            SELECT id, customer_name, customer_no, create_time
+            FROM crm_customer
+            WHERE del_flag = 0 AND customer_name IS NOT NULL AND TRIM(customer_name) != ''
+            ORDER BY customer_name, create_time ASC, customer_no ASC
+            """
+        )
+    ).fetchall()
+    grouped: Dict[str, List[Dict[str, Any]]] = {}
+    for row in rows:
+        item = _row_to_dict(row)
+        grouped.setdefault(item["customer_name"], []).append(item)
+
+    pairs: List[Dict[str, Any]] = []
+    for name, items in grouped.items():
+        if len(items) != 2:
+            continue
+        source, keeper = items[0], items[1]
+        pairs.append(
+            {
+                "customer_name": name,
+                "from_id": source["id"],
+                "from_no": source["customer_no"],
+                "to_id": keeper["id"],
+                "to_no": keeper["customer_no"],
+            }
+        )
+    return pairs
+
+
+def backup_tables(conn: Connection, suffix: str, *, execute: bool) -> None:
+    for table in TABLES_TO_TOUCH:
+        backup_name = f"{table}_{suffix}"
+        sql = f"CREATE TABLE `{backup_name}` AS SELECT * FROM `{table}`"
+        print(f"[backup] {sql}")
+        if execute:
+            conn.execute(text(f"DROP TABLE IF EXISTS `{backup_name}`"))
+            conn.execute(text(sql))
+
+
+def fetch_customer(conn: Connection, customer_id: str) -> Optional[Dict[str, Any]]:
+    row = conn.execute(
+        text("SELECT * FROM crm_customer WHERE id = :id"),
+        {"id": customer_id},
+    ).fetchone()
+    return _row_to_dict(row) if row else None
+
+
+def merge_contacts(
+    conn: Connection,
+    pair: Dict[str, Any],
+    keeper_name: str,
+    *,
+    execute: bool,
+) -> Dict[str, int]:
+    stats = {"migrated": 0, "deduped": 0, "kept": 0}
+    from_rows = conn.execute(
+        text(
+            """
+            SELECT * FROM crm_contact
+            WHERE customer_id = :cid AND del_flag = 0
+            ORDER BY is_primary DESC, create_time ASC
+            """
+        ),
+        {"cid": pair["from_id"]},
+    ).fetchall()
+    to_rows = conn.execute(
+        text(
+            """
+            SELECT * FROM crm_contact
+            WHERE customer_id = :cid AND del_flag = 0
+            ORDER BY is_primary DESC, create_time ASC
+            """
+        ),
+        {"cid": pair["to_id"]},
+    ).fetchall()
+    keeper_keys = {_contact_key(_row_to_dict(r)) for r in to_rows}
+
+    for row in from_rows:
+        src = _row_to_dict(row)
+        key = _contact_key(src)
+        if key in keeper_keys:
+            stats["deduped"] += 1
+            print(
+                f"  [contact dedupe] {pair['customer_name']} duplicate key={key} "
+                f"soft-delete {src['id']}"
+            )
+            if execute:
+                conn.execute(
+                    text(
+                        """
+                        UPDATE crm_contact
+                        SET del_flag = 1, update_time = NOW(),
+                            remark = CONCAT(IFNULL(remark, ''), '[合并去重]')
+                        WHERE id = :id
+                        """
+                    ),
+                    {"id": src["id"]},
+                )
+            continue
+
+        stats["migrated"] += 1
+        print(
+            f"  [contact migrate] {src['id']} -> customer {pair['to_id']} "
+            f"set primary=1 (old contact)"
+        )
+        if execute:
+            conn.execute(
+                text(
+                    """
+                    UPDATE crm_contact
+                    SET is_primary = 0, update_time = NOW()
+                    WHERE customer_id = :cid AND del_flag = 0
+                    """
+                ),
+                {"cid": pair["to_id"]},
+            )
+            conn.execute(
+                text(
+                    """
+                    UPDATE crm_contact
+                    SET customer_id = :to_id,
+                        customer_name = :customer_name,
+                        is_primary = 1,
+                        update_time = NOW()
+                    WHERE id = :id
+                    """
+                ),
+                {
+                    "to_id": pair["to_id"],
+                    "customer_name": keeper_name,
+                    "id": src["id"],
+                },
+            )
+        keeper_keys.add(key)
+
+    stats["kept"] = len(to_rows)
+    return stats
+
+
+def normalize_invoice_defaults(
+    conn: Connection,
+    customer_id: str,
+    *,
+    execute: bool,
+    prefer_ids: Optional[List[str]] = None,
+) -> None:
+    """确保保留客户下活跃开票有且仅有一条 is_default=1；优先保留客户（新）侧原默认。"""
+    rows = conn.execute(
+        text(
+            """
+            SELECT id, is_default, create_time
+            FROM crm_invoice_info
+            WHERE customer_id = :cid AND del_flag = 0
+            ORDER BY is_default DESC, create_time ASC
+            """
+        ),
+        {"cid": customer_id},
+    ).fetchall()
+    if not rows:
+        return
+
+    active = [_row_to_dict(r) for r in rows]
+    prefer_set = set(prefer_ids or [])
+    default_id: Optional[str] = None
+
+    if len(active) == 1:
+        default_id = active[0]["id"]
+    else:
+        preferred = [item for item in active if item["id"] in prefer_set]
+        if preferred:
+            for item in preferred:
+                if str(item.get("is_default")) == "1":
+                    default_id = item["id"]
+                    break
+            if not default_id:
+                default_id = preferred[0]["id"]
+        if not default_id:
+            for item in active:
+                if str(item.get("is_default")) == "1":
+                    default_id = item["id"]
+                    break
+        if not default_id:
+            default_id = active[0]["id"]
+
+    print(f"  [invoice default] customer {customer_id} -> {default_id}")
+    if execute:
+        conn.execute(
+            text(
+                """
+                UPDATE crm_invoice_info
+                SET is_default = '0', update_time = NOW()
+                WHERE customer_id = :cid AND del_flag = 0
+                """
+            ),
+            {"cid": customer_id},
+        )
+        conn.execute(
+            text(
+                """
+                UPDATE crm_invoice_info
+                SET is_default = '1', update_time = NOW()
+                WHERE id = :id
+                """
+            ),
+            {"id": default_id},
+        )
+
+
+def merge_invoices(
+    conn: Connection,
+    pair: Dict[str, Any],
+    *,
+    execute: bool,
+) -> Dict[str, int]:
+    stats = {"migrated": 0, "deduped": 0}
+    from_rows = conn.execute(
+        text(
+            """
+            SELECT * FROM crm_invoice_info
+            WHERE customer_id = :cid AND del_flag = 0
+            ORDER BY is_default DESC, create_time ASC
+            """
+        ),
+        {"cid": pair["from_id"]},
+    ).fetchall()
+    to_rows = conn.execute(
+        text(
+            """
+            SELECT * FROM crm_invoice_info
+            WHERE customer_id = :cid AND del_flag = 0
+            ORDER BY is_default DESC, create_time ASC
+            """
+        ),
+        {"cid": pair["to_id"]},
+    ).fetchall()
+    keeper_original_ids = [_row_to_dict(r)["id"] for r in to_rows]
+    keeper_map = {_invoice_key(_row_to_dict(r)): _row_to_dict(r) for r in to_rows}
+
+    for row in from_rows:
+        src = _row_to_dict(row)
+        key = _invoice_key(src)
+        if key in keeper_map:
+            stats["deduped"] += 1
+            print(f"  [invoice dedupe] key={key} soft-delete {src['id']}")
+            if execute:
+                conn.execute(
+                    text(
+                        """
+                        UPDATE crm_invoice_info
+                        SET del_flag = 1, update_time = NOW(),
+                            remark = CONCAT(IFNULL(remark, ''), '[合并去重]')
+                        WHERE id = :id
+                        """
+                    ),
+                    {"id": src["id"]},
+                )
+            continue
+
+        stats["migrated"] += 1
+        print(f"  [invoice migrate] {src['id']} -> customer {pair['to_id']} is_default=0")
+        if execute:
+            conn.execute(
+                text(
+                    """
+                    UPDATE crm_invoice_info
+                    SET customer_id = :to_id,
+                        is_default = '0',
+                        update_time = NOW()
+                    WHERE id = :id
+                    """
+                ),
+                {"to_id": pair["to_id"], "id": src["id"]},
+            )
+        keeper_map[key] = src
+
+    normalize_invoice_defaults(
+        conn,
+        pair["to_id"],
+        execute=execute,
+        prefer_ids=keeper_original_ids,
+    )
+    return stats
+
+
+def migrate_customer_refs(
+    conn: Connection,
+    pair: Dict[str, Any],
+    keeper_name: str,
+    *,
+    execute: bool,
+) -> None:
+    updates = [
+        (
+            "crm_customer_follow",
+            "UPDATE crm_customer_follow SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_opportunity",
+            "UPDATE crm_opportunity SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_contract",
+            "UPDATE crm_contract SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_quote",
+            "UPDATE crm_quote SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_price_letter",
+            "UPDATE crm_price_letter SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_customer_pool",
+            "UPDATE crm_customer_pool SET customer_id=:to_id, customer_name=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "crm_clue",
+            "UPDATE crm_clue SET customer_id=:to_id, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+        (
+            "pl_plan",
+            "UPDATE pl_plan SET customer_id=:to_id, customer_name=:name, party_a=:name, update_time=NOW() "
+            "WHERE customer_id=:from_id AND del_flag=0",
+        ),
+    ]
+    params = {"from_id": pair["from_id"], "to_id": pair["to_id"], "name": keeper_name}
+    for table, sql in updates:
+        count = conn.execute(
+            text(f"SELECT COUNT(*) FROM `{table}` WHERE customer_id=:from_id AND del_flag=0"),
+            {"from_id": pair["from_id"]},
+        ).scalar()
+        if count:
+            print(f"  [{table}] migrate {count} rows")
+            if execute:
+                conn.execute(text(sql), params)
+
+
+def merge_customer_master(
+    conn: Connection,
+    pair: Dict[str, Any],
+    *,
+    execute: bool,
+) -> None:
+    keeper = fetch_customer(conn, pair["to_id"])
+    source = fetch_customer(conn, pair["from_id"])
+    if not keeper or not source:
+        return
+
+    sets = []
+    params: Dict[str, Any] = {"id": pair["to_id"]}
+    for field in CUSTOMER_FILL_FIELDS:
+        k_val = keeper.get(field)
+        s_val = source.get(field)
+        if _norm(k_val):
+            continue
+        if not _norm(s_val):
+            continue
+        sets.append(f"{field} = :{field}")
+        params[field] = s_val
+
+    deal_priority = {"dealed": 3, "lost": 2, "not_deal": 1}
+    if deal_priority.get(_norm(source.get("deal_status")), 0) > deal_priority.get(
+        _norm(keeper.get("deal_status")), 0
+    ):
+        sets.extend(
+            [
+                "deal_status = :deal_status",
+                "deal_time = COALESCE(:deal_time, deal_time)",
+                "deal_amount = GREATEST(IFNULL(deal_amount,0), IFNULL(:deal_amount,0))",
+            ]
+        )
+        params["deal_status"] = source.get("deal_status")
+        params["deal_time"] = source.get("deal_time")
+        params["deal_amount"] = source.get("deal_amount")
+
+    merge_note = (
+        f"[{date.today().isoformat()} 合并客户 {source.get('customer_no')}({source.get('id')})]"
+    )
+    old_remark = _norm(keeper.get("remark"))
+    if merge_note not in old_remark:
+        sets.append("remark = :remark")
+        params["remark"] = f"{old_remark}\n{merge_note}".strip()
+
+    if sets and execute:
+        sql = f"UPDATE crm_customer SET {', '.join(sets)}, update_time = NOW() WHERE id = :id"
+        conn.execute(text(sql), params)
+        print(f"  [customer master] filled fields: {', '.join(x.split(' ')[0] for x in sets)}")
+
+
+def recalc_customer_stats(conn: Connection, customer_id: str, *, execute: bool) -> None:
+    if not execute:
+        return
+    contact_count = conn.execute(
+        text("SELECT COUNT(*) FROM crm_contact WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    opportunity_count = conn.execute(
+        text("SELECT COUNT(*) FROM crm_opportunity WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    contract_count = conn.execute(
+        text("SELECT COUNT(*) FROM crm_contract WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    follow_count = conn.execute(
+        text("SELECT COUNT(*) FROM crm_customer_follow WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    deal_amount = conn.execute(
+        text("SELECT COALESCE(SUM(amount),0) FROM crm_contract WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    last_time = conn.execute(
+        text("SELECT MAX(follow_time) FROM crm_customer_follow WHERE customer_id=:id AND del_flag=0"),
+        {"id": customer_id},
+    ).scalar()
+    next_time = conn.execute(
+        text(
+            """
+            SELECT MAX(next_time) FROM (
+              SELECT next_time FROM crm_customer_follow WHERE customer_id=:id AND del_flag=0
+              UNION ALL
+              SELECT next_time FROM crm_customer WHERE id=:id
+            ) t
+            """
+        ),
+        {"id": customer_id},
+    ).scalar()
+    conn.execute(
+        text(
+            """
+            UPDATE crm_customer
+            SET contact_count=:contact_count,
+                opportunity_count=:opportunity_count,
+                contract_count=:contract_count,
+                follow_count=:follow_count,
+                deal_amount=:deal_amount,
+                last_time=COALESCE(:last_time, last_time),
+                next_time=COALESCE(:next_time, next_time),
+                update_time=NOW()
+            WHERE id=:id
+            """
+        ),
+        {
+            "id": customer_id,
+            "contact_count": contact_count,
+            "opportunity_count": opportunity_count,
+            "contract_count": contract_count,
+            "follow_count": follow_count,
+            "deal_amount": deal_amount,
+            "last_time": last_time,
+            "next_time": next_time,
+        },
+    )
+
+
+def soft_delete_source_customer(
+    conn: Connection,
+    pair: Dict[str, Any],
+    *,
+    execute: bool,
+) -> None:
+    note = f"[{date.today().isoformat()} 已合并至 {pair['to_no']}({pair['to_id']})]"
+    print(f"  [customer soft-delete] {pair['from_no']} ({pair['from_id']})")
+    if execute:
+        conn.execute(
+            text(
+                """
+                UPDATE crm_customer
+                SET del_flag = 1,
+                    remark = CONCAT(IFNULL(remark, ''), :note),
+                    update_time = NOW()
+                WHERE id = :id
+                """
+            ),
+            {"id": pair["from_id"], "note": f"\n{note}"},
+        )
+
+
+def verify(conn: Connection, merged_from_ids: List[str]) -> None:
+    dup_groups = conn.execute(
+        text(
+            """
+            SELECT COUNT(*) FROM (
+              SELECT customer_name FROM crm_customer
+              WHERE del_flag=0 AND customer_name IS NOT NULL AND TRIM(customer_name)!=''
+              GROUP BY customer_name HAVING COUNT(*)>1
+            ) t
+            """
+        )
+    ).scalar()
+
+    merge_orphans = 0
+    if merged_from_ids:
+        placeholders = ", ".join(f":id{i}" for i in range(len(merged_from_ids)))
+        params = {f"id{i}": cid for i, cid in enumerate(merged_from_ids)}
+        merge_orphans = conn.execute(
+            text(
+                f"""
+                SELECT COUNT(*) FROM (
+                  SELECT customer_id FROM crm_contact WHERE del_flag=0
+                  UNION ALL SELECT customer_id FROM crm_invoice_info WHERE del_flag=0
+                  UNION ALL SELECT customer_id FROM crm_contract WHERE del_flag=0
+                  UNION ALL SELECT customer_id FROM crm_quote WHERE del_flag=0
+                  UNION ALL SELECT customer_id FROM pl_plan WHERE del_flag=0
+                ) r
+                WHERE r.customer_id IN ({placeholders})
+                """
+            ),
+            params,
+        ).scalar()
+
+    global_orphans = {}
+    for table in [
+        "crm_contact",
+        "crm_invoice_info",
+        "crm_contract",
+        "crm_quote",
+        "pl_plan",
+    ]:
+        cnt = conn.execute(
+            text(
+                f"""
+                SELECT COUNT(*) FROM `{table}` r
+                LEFT JOIN crm_customer c ON c.id = r.customer_id AND c.del_flag = 0
+                WHERE r.del_flag = 0 AND r.customer_id IS NOT NULL AND c.id IS NULL
+                """
+            )
+        ).scalar()
+        global_orphans[table] = cnt
+
+    print("\n=== verification ===")
+    print(f"duplicate active customer name groups: {dup_groups}")
+    print(f"active refs to merged-deleted customer ids: {merge_orphans}")
+    for table, cnt in global_orphans.items():
+        if cnt:
+            print(f"pre-existing orphan refs in {table}: {cnt}")
+    if dup_groups != 0:
+        raise RuntimeError("duplicate customer names still exist")
+    if merge_orphans != 0:
+        raise RuntimeError("active child rows still reference merged-deleted customers")
+
+
+def run(engine: Engine, *, execute: bool, suffix: str) -> None:
+    pairs = []
+    with engine.connect() as conn:
+        pairs = discover_merge_pairs(conn)
+        print(f"found {len(pairs)} merge pairs")
+        for pair in pairs:
+            print(
+                f"  {pair['customer_name']}: {pair['from_no']} -> {pair['to_no']}"
+            )
+
+    if not pairs:
+        print("nothing to merge")
+        return
+
+    if execute:
+        with engine.begin() as conn:
+            backup_tables(conn, suffix, execute=True)
+
+    with engine.begin() as conn:
+        for pair in pairs:
+            keeper = fetch_customer(conn, pair["to_id"])
+            keeper_name = keeper["customer_name"] if keeper else pair["customer_name"]
+            print(f"\n>>> merge {pair['customer_name']}")
+            merge_contacts(conn, pair, keeper_name, execute=execute)
+            merge_invoices(conn, pair, execute=execute)
+            migrate_customer_refs(conn, pair, keeper_name, execute=execute)
+            merge_customer_master(conn, pair, execute=execute)
+            recalc_customer_stats(conn, pair["to_id"], execute=execute)
+            soft_delete_source_customer(conn, pair, execute=execute)
+
+    if execute:
+        with engine.connect() as conn:
+            verify(conn, [p["from_id"] for p in pairs])
+        print("\nmerge completed successfully")
+    else:
+        print("\ndry-run finished (no changes applied)")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Merge duplicate CRM customers")
+    parser.add_argument("--env-file", default=".env", help="env file with DATABASE_URL")
+    parser.add_argument("--suffix", default=date.today().strftime("%Y%m%d"))
+    parser.add_argument("--dry-run", action="store_true", help="preview only")
+    parser.add_argument("--execute", action="store_true", help="apply changes")
+    args = parser.parse_args()
+    if not args.dry_run and not args.execute:
+        parser.error("specify --dry-run or --execute")
+
+    db_url = load_database_url(args.env_file)
+    print(f"database: {re.sub(r':[^:@/]+@', ':***@', db_url)}")
+    print(f"backup suffix: {args.suffix}")
+    engine = create_engine(db_url, pool_pre_ping=True)
+    run(engine, execute=args.execute, suffix=args.suffix)
+
+
+if __name__ == "__main__":
+    main()