提交

backend/app.pid

@@ -1 +1 @@
-37304
+48523

backend/app/api/pl/plan.py

@@ -63,10 +63,15 @@ from app.schemas.pl.plan import (
     PlanRead,
     PlanSideContractsUpdateBody,
     PlanSiteFeedbackUpdateBody,
+    PlanStopContractsUpdateBody,
     PlanUpdate,
     PlanWithProducts,
 )
-from app.services.pl_plan_contract_gap import list_plan_contract_gaps, update_plan_side_contracts
+from app.services.pl_plan_contract_gap import (
+    list_plan_contract_gaps,
+    update_plan_side_contracts,
+    update_plan_stop_contracts,
+)
 from app.services.pl_brand_archive import load_brand_qtys_by_plan_product_ids
 from app.services.pl_product_display import (
     load_crm_product_alias_maps,
@@ -93,6 +98,7 @@ from app.services.pl_plan_archive_stop_service import (
     sum_delivery_outbound_qty,
     sync_plan_products_from_stop_archive,
 )
+from app.services.pl_plan_archive_export import build_plan_archive_export_rows
 from app.services.pl_plan_list_attachments import load_plan_document_attachments_by_plan_ids
 from app.services.pl_plan_print_service import get_delivery_slip_print_context
 from app.services.pl_plan_stop_service import (
@@ -345,6 +351,11 @@ def list_plans(
         alias="certUploadStatus",
         description="incomplete=至少一张必需危化证书未上传",
     ),
+    hazard_cert_ready: Optional[int] = Query(
+        default=None,
+        alias="hazardCertReady",
+        description="0=未确认齐备 1=已确认齐备",
+    ),
     page: int = Query(default=1, ge=1),
     page_size: int = Query(default=20, ge=1, le=500, alias="pageSize"),
     db: Session = Depends(get_db),
@@ -411,6 +422,9 @@ def list_plans(
     if (cert_upload_status or "").strip().lower() == "incomplete":
         query = query.filter(plan_has_incomplete_hazard_cert_exists(tenant_no))
 
+    if hazard_cert_ready is not None:
+        query = query.filter(PlPlan.hazard_cert_ready == int(hazard_cert_ready))
+
     query = apply_pl_scope(query, PlPlan, user, db, tenant_no)
 
     # 统计总数
@@ -537,37 +551,33 @@ PLAN_EXPORT_COLUMNS = [
 
 PLAN_ARCHIVE_EXPORT_COLUMNS = [
     ExportColumn(title="序号", field="rowNo"),
-    ExportColumn(title="到货日期", field="deliveryDate"),
-    ExportColumn(title="供方名称", field="supplierName"),
-    ExportColumn(title="需方名称", field="customerName"),
+    ExportColumn(title="计划编号", field="planNo"),
+    ExportColumn(title="计划日期", field="planDate"),
+    ExportColumn(title="归档状态", field="archiveStatus"),
+    ExportColumn(title="跟进状态", field="followStatus"),
+    ExportColumn(title="单据类型", field="planType"),
+    ExportColumn(title="段次", field="stopKind"),
+    ExportColumn(title="客户", field="stopCustomer"),
+    ExportColumn(title="地址", field="stopAddress"),
+    ExportColumn(title="段次时间", field="stopTime"),
     ExportColumn(title="产品名称", field="productName"),
     ExportColumn(title="型号/规格", field="model"),
     ExportColumn(title="包装", field="packageSpec"),
     ExportColumn(title="单位", field="unit"),
-    ExportColumn(title="入库数", field="inboundQty"),
-    ExportColumn(title="入库价", field="inboundPrice"),
-    ExportColumn(title="入库金额", field="inboundAmount"),
-    ExportColumn(title="出库数", field="outboundQty"),
-    ExportColumn(title="出库价", field="outboundPrice"),
-    ExportColumn(title="出库金额", field="outboundAmount"),
+    ExportColumn(title="计划数量", field="planQty"),
+    ExportColumn(title="实际数量", field="actualQty"),
+    ExportColumn(title="入库数量", field="inboundQty"),
+    ExportColumn(title="出库数量", field="outboundQty"),
+    ExportColumn(title="单价（元）", field="unitPrice"),
+    ExportColumn(title="金额（元）", field="amount"),
     ExportColumn(title="车牌号", field="licensePlate"),
     ExportColumn(title="运费单位", field="freightType"),
     ExportColumn(title="运费单价", field="freightPrice"),
     ExportColumn(title="运费金额", field="freightAmount"),
+    ExportColumn(title="ERP", field="erpEntered"),
     ExportColumn(title="备注", field="remark"),
 ]
 
-PLAN_ARCHIVE_FREIGHT_TYPE_LABELS = {
-    "by_weight": "按重量",
-    "by_trip": "按趟",
-}
-
-
-def _format_plan_delivery_date_for_export(plan: PlPlan) -> str:
-    if plan.delivery_time is None:
-        return ""
-    return str(plan.delivery_time)[:10]
-
 
 def _load_transports_by_id(db: Session, tenant_no: str, transport_ids: list[str]) -> dict[str, PlTransport]:
     if not transport_ids:
@@ -584,89 +594,6 @@ def _load_transports_by_id(db: Session, tenant_no: str, transport_ids: list[str]
     return {row.id: row for row in rows}
 
 
-def _load_products_by_plan_id(db: Session, tenant_no: str, plan_ids: list[str]) -> dict[str, list[PlPlanProduct]]:
-    if not plan_ids:
-        return {}
-    products = (
-        db.query(PlPlanProduct)
-        .filter(
-            PlPlanProduct.tenant_no == tenant_no,
-            PlPlanProduct.del_flag == 0,
-            PlPlanProduct.plan_id.in_(plan_ids),
-        )
-        .order_by(PlPlanProduct.order_num)
-        .all()
-    )
-    grouped: dict[str, list[PlPlanProduct]] = {}
-    for product in products:
-        grouped.setdefault(product.plan_id, []).append(product)
-    return grouped
-
-
-def _build_plan_archive_export_rows(
-    plans: list[PlPlan],
-    products_by_plan: dict[str, list[PlPlanProduct]],
-    transports_by_id: dict[str, PlTransport],
-) -> list[dict]:
-    rows: list[dict] = []
-    row_no = 0
-    for plan in plans:
-        products = products_by_plan.get(plan.id, [])
-        transport = transports_by_id.get(plan.transport_id) if plan.transport_id else None
-        freight_type_raw = transport.freight_type if transport else "by_weight"
-        freight_type_label = PLAN_ARCHIVE_FREIGHT_TYPE_LABELS.get(
-            freight_type_raw, freight_type_raw or ""
-        )
-        freight_price = transport.freight_price if transport else None
-        freight_amount = plan.freight_amount
-        if freight_amount is None and transport is not None:
-            freight_amount = transport.freight_amount
-        plan_common = {
-            "deliveryDate": _format_plan_delivery_date_for_export(plan),
-            "supplierName": plan.supplier_name or "",
-            "customerName": plan.customer_name or "",
-            "licensePlate": plan.license_plate or "",
-            "freightType": freight_type_label,
-            "freightPrice": freight_price,
-            "freightAmount": freight_amount,
-            "remark": "",
-        }
-        product_rows = products or [None]
-        for product in product_rows:
-            row_no += 1
-            row = {
-                **plan_common,
-                "rowNo": row_no,
-                "productName": "",
-                "model": "",
-                "packageSpec": "",
-                "unit": "",
-                "inboundQty": None,
-                "inboundPrice": None,
-                "inboundAmount": None,
-                "outboundQty": None,
-                "outboundPrice": None,
-                "outboundAmount": None,
-            }
-            if product is not None:
-                row.update(
-                    {
-                        "productName": product.product_name or "",
-                        "model": product.model or "",
-                        "packageSpec": product.package_spec or "",
-                        "unit": product.unit or "",
-                        "inboundQty": product.inbound_qty,
-                        "inboundPrice": product.inbound_price,
-                        "inboundAmount": product.inbound_amount,
-                        "outboundQty": product.outbound_qty,
-                        "outboundPrice": product.outbound_price,
-                        "outboundAmount": product.outbound_amount,
-                    }
-                )
-            rows.append(row)
-    return rows
-
-
 class PlanExportBody(BaseModel):
     q: Optional[str] = None
     plan_no: Optional[str] = Field(default=None, alias="planNo")
@@ -681,6 +608,7 @@ class PlanExportBody(BaseModel):
     plan_date_to: Optional[date] = Field(default=None, alias="planDateTo")
     has_hazard_product: Optional[int] = Field(default=None, alias="hasHazardProduct")
     cert_upload_status: Optional[str] = Field(default=None, alias="certUploadStatus")
+    hazard_cert_ready: Optional[int] = Field(default=None, alias="hazardCertReady")
     ids: Optional[List[str]] = None
     columns: Optional[List[str]] = None
     export_format: Optional[str] = Field(default=None, alias="exportFormat", description="archive=运输计划归档专用导出")
@@ -743,6 +671,8 @@ def export_plans(
             query = query.filter(plan_has_hazard_product_exists(tenant_no))
         if (body.cert_upload_status or "").strip().lower() == "incomplete":
             query = query.filter(plan_has_incomplete_hazard_cert_exists(tenant_no))
+        if body.hazard_cert_ready is not None:
+            query = query.filter(PlPlan.hazard_cert_ready == int(body.hazard_cert_ready))
         if body.ids:
             query = query.filter(PlPlan.id.in_(body.ids))
         query = apply_pl_scope(query, PlPlan, user, db, tenant_no)
@@ -750,12 +680,10 @@ def export_plans(
         date_str = datetime.now().strftime("%Y%m%d")
         is_archive_export = (body.export_format or "").strip().lower() == "archive"
         if is_archive_export:
-            plan_ids = [plan.id for plan in plans]
-            products_by_plan = _load_products_by_plan_id(db, tenant_no, plan_ids)
             transport_ids = [plan.transport_id for plan in plans if plan.transport_id]
             transports_by_id = _load_transports_by_id(db, tenant_no, transport_ids)
-            items = _build_plan_archive_export_rows(plans, products_by_plan, transports_by_id)
-            cols = PLAN_ARCHIVE_EXPORT_COLUMNS
+            items = build_plan_archive_export_rows(db, tenant_no, plans, transports_by_id)
+            cols = filter_export_columns(PLAN_ARCHIVE_EXPORT_COLUMNS, body.columns)
             sheet_title = "计划归档"
             filename_stem = f"计划归档_{date_str}"
         else:
@@ -948,6 +876,31 @@ def export_contract_gaps(
         raise HTTPException(status_code=400, detail=str(e)) from e
 
 
+@router.put("/{id}/stop-contracts", response_model=PlanContractGapRead)
+def put_plan_stop_contracts(
+    id: str,
+    payload: PlanStopContractsUpdateBody,
+    db: Session = Depends(get_db),
+    user: DbUserContext = Depends(get_db_current_user),
+) -> PlanContractGapRead:
+    """保存某装货/送货段合同关联（合同补全）。"""
+    tenant_no = get_tenant_no(db, user.to_tenant_user_dict())
+    plan = _get_plan(db, tenant_no, id, user)
+    result = update_plan_stop_contracts(
+        db,
+        tenant_no=tenant_no,
+        plan=plan,
+        stop_type=payload.stop_type,
+        stop_id=payload.stop_id,
+        contracts=payload.contracts,
+        user_id=user.id,
+        dept_id=user.dept_id,
+    )
+    plan.update_by = user.id
+    db.commit()
+    return result
+
+
 @router.put("/{id}/contracts/{side}", response_model=PlanContractGapRead)
 def put_plan_side_contracts(
     id: str,

backend/app/models/pl_models.py

@@ -455,16 +455,22 @@ class PlPlanProduct(Base):
 
 
 class PlPlanProductBrandQty(Base):
-    """计划产品归档品牌数量 pl_plan_product_brand_qty"""
+    """计划产品归档品牌数量 pl_plan_product_brand_qty
+
+    stop_product_id 为空：计划产品级汇总；非空：装货/送货段产品行上的填写值。
+    """
 
     __tablename__ = "pl_plan_product_brand_qty"
 
     id = Column(String(64), primary_key=True, comment="主键ID")
     plan_id = Column(String(64), nullable=False, comment="计划ID")
     plan_product_id = Column(String(64), nullable=False, comment="计划产品明细ID")
+    stop_type = Column(String(20), nullable=True, comment="load/delivery，空=计划级汇总")
+    stop_product_id = Column(String(64), nullable=True, comment="段产品行ID，空=计划级汇总")
     brand_id = Column(String(64), nullable=False, default="", comment="品牌ID，空串=无品牌键")
     brand_name = Column(String(100), nullable=True, comment="品牌名称")
     qty = Column(DECIMAL(15, 3), nullable=False, default=0, comment="本品牌归档实际数量")
+    unit_price = Column(DECIMAL(15, 4), nullable=True, comment="本品牌归档单价")
     tenant_no = Column(String(64), nullable=False, default="shanxia2.0", comment="租户编号")
     order_num = Column(Integer, nullable=True, comment="排序号")
     remark = Column(String(512), nullable=True, comment="备注")

backend/app/schemas/pl/plan.py

@@ -82,6 +82,7 @@ class PlanArchiveBrandQtyItem(BaseModel):
     brand_id: str = Field(default="", alias="brandId")
     brand_name: Optional[str] = Field(default=None, alias="brandName")
     qty: Decimal = Field(..., ge=0)
+    unit_price: Optional[Decimal] = Field(default=None, alias="unitPrice", ge=0, description="本品牌单价")
     model_config = {"populate_by_name": True}
 
 
@@ -129,6 +130,9 @@ class PlanStopProductRead(PlanStopProductBody):
     outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", description="出库数量（送货段归档）")
     outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", description="出库单价（送货段归档）")
     outbound_amount: Optional[Decimal] = Field(default=None, alias="outboundAmount", description="出库金额（送货段归档）")
+    brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(
+        default=None, alias="brandQtys", description="本段归档品牌数量"
+    )
     tenant_no: str = Field(alias="tenantNo")
     order_num: Optional[int] = Field(default=None, alias="orderNum")
     create_time: datetime = Field(alias="createTime")
@@ -557,6 +561,9 @@ class PlanArchiveStopProductItem(BaseModel):
     inbound_price: Optional[Decimal] = Field(default=None, alias="inboundPrice", ge=0, description="入库单价（装货段）")
     outbound_qty: Optional[Decimal] = Field(default=None, alias="outboundQty", ge=0, description="出库数量（送货段）")
     outbound_price: Optional[Decimal] = Field(default=None, alias="outboundPrice", ge=0, description="出库单价（送货段）")
+    brand_qtys: Optional[list[PlanArchiveBrandQtyItem]] = Field(
+        default=None, alias="brandQtys", description="本段归档品牌数量（与归档弹窗填写一致）"
+    )
     model_config = {"populate_by_name": True}
 
 
@@ -642,6 +649,13 @@ class PlanSideContractsUpdateBody(BaseModel):
     model_config = {"populate_by_name": True}
 
 
+class PlanStopContractsUpdateBody(BaseModel):
+    stop_type: str = Field(..., alias="stopType", description="load | delivery")
+    stop_id: str = Field(..., alias="stopId", description="装货/送货段ID")
+    contracts: list[PlanContractLink] = Field(default_factory=list)
+    model_config = {"populate_by_name": True}
+
+
 class PlanContractGapRead(BaseModel):
     id: str
     plan_no: str = Field(..., alias="planNo")
@@ -658,6 +672,8 @@ class PlanContractGapRead(BaseModel):
     supplier_contracts: list[PlanContractLink] = Field(default_factory=list, alias="supplierContracts")
     demander_contracts: list[PlanContractLink] = Field(default_factory=list, alias="demanderContracts")
     products: list[PlanProductRead] = Field(default_factory=list, description="产品明细")
+    load: Optional["PlanLoadRead"] = Field(default=None, description="装货段")
+    deliveries: list["PlanDeliveryRead"] = Field(default_factory=list, alias="deliveries", description="送货段列表")
     model_config = {"populate_by_name": True, "from_attributes": True}
 
 

backend/app/services/pl_brand_archive.py

@@ -2,19 +2,46 @@
 from decimal import Decimal
 from typing import Any, Optional
 
+from sqlalchemy import or_
 from sqlalchemy.orm import Session
 
 from app.core.utils import generate_uuid
 from app.models.pl_models import PlPlanProductBrandQty
 
 
+def _is_plan_level_row(row: PlPlanProductBrandQty) -> bool:
+    return not (getattr(row, "stop_product_id", None) or "").strip()
+
+
+def _row_to_brand_dict(row: PlPlanProductBrandQty) -> dict[str, Any]:
+    data: dict[str, Any] = {
+        "brandId": row.brand_id or "",
+        "brandName": row.brand_name,
+        "qty": Decimal(str(row.qty or 0)),
+    }
+    if row.unit_price is not None:
+        data["unitPrice"] = Decimal(str(row.unit_price))
+    return data
+
+
+def _parse_unit_price(item: dict[str, Any]) -> Optional[Decimal]:
+    raw = item.get("unitPrice")
+    if raw is None:
+        raw = item.get("unit_price")
+    if raw is None:
+        raw = item.get("price")
+    if raw is None or raw == "":
+        return None
+    return Decimal(str(raw))
+
+
 def load_brand_qtys_by_plan_product_ids(
     db: Session,
     *,
     tenant_no: str,
     plan_product_ids: list[str],
 ) -> dict[str, list[dict[str, Any]]]:
-    """按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。"""
+    """按计划产品明细 ID 批量加载计划级归档品牌数量（brandId/brandName/qty/unitPrice）。"""
     ids = [pid for pid in plan_product_ids if pid]
     if not ids:
         return {}
@@ -24,6 +51,39 @@ def load_brand_qtys_by_plan_product_ids(
             PlPlanProductBrandQty.plan_product_id.in_(ids),
             PlPlanProductBrandQty.tenant_no == tenant_no,
             PlPlanProductBrandQty.del_flag == 0,
+            or_(
+                PlPlanProductBrandQty.stop_product_id.is_(None),
+                PlPlanProductBrandQty.stop_product_id == "",
+            ),
+        )
+        .order_by(PlPlanProductBrandQty.order_num.asc())
+        .all()
+    )
+    grouped: dict[str, list[dict[str, Any]]] = {}
+    for row in rows:
+        qty = Decimal(str(row.qty or 0))
+        if qty <= 0:
+            continue
+        grouped.setdefault(row.plan_product_id, []).append(_row_to_brand_dict(row))
+    return grouped
+
+
+def load_brand_qtys_by_stop_product_ids(
+    db: Session,
+    *,
+    tenant_no: str,
+    stop_product_ids: list[str],
+) -> dict[str, list[dict[str, Any]]]:
+    """按装货/送货段产品行 ID 批量加载段级归档品牌数量。"""
+    ids = [pid for pid in stop_product_ids if pid]
+    if not ids:
+        return {}
+    rows = (
+        db.query(PlPlanProductBrandQty)
+        .filter(
+            PlPlanProductBrandQty.stop_product_id.in_(ids),
+            PlPlanProductBrandQty.tenant_no == tenant_no,
+            PlPlanProductBrandQty.del_flag == 0,
         )
         .order_by(PlPlanProductBrandQty.order_num.asc())
         .all()
@@ -33,13 +93,10 @@ def load_brand_qtys_by_plan_product_ids(
         qty = Decimal(str(row.qty or 0))
         if qty <= 0:
             continue
-        grouped.setdefault(row.plan_product_id, []).append(
-            {
-                "brandId": row.brand_id or "",
-                "brandName": row.brand_name,
-                "qty": qty,
-            }
-        )
+        stop_id = (row.stop_product_id or "").strip()
+        if not stop_id:
+            continue
+        grouped.setdefault(stop_id, []).append(_row_to_brand_dict(row))
     return grouped
 
 
@@ -72,7 +129,7 @@ def persist_plan_product_brand_qtys(
     user_id: str,
     dept_id: str = "",
 ) -> None:
-    """软删旧品牌量行后按归档结果插入；无品牌约定则只软删不插入。"""
+    """软删计划级旧品牌量行后按归档结果插入；无品牌约定则只软删不插入。不触碰段级行。"""
     existing = (
         db.query(PlPlanProductBrandQty)
         .filter(
@@ -83,6 +140,8 @@ def persist_plan_product_brand_qtys(
         .all()
     )
     for row in existing:
+        if not _is_plan_level_row(row):
+            continue
         row.del_flag = 1
         row.update_by = user_id
 
@@ -101,9 +160,72 @@ def persist_plan_product_brand_qtys(
                 tenant_no=tenant_no,
                 plan_id=plan_id,
                 plan_product_id=plan_product_id,
+                stop_type=None,
+                stop_product_id=None,
                 brand_id=brand_id,
                 brand_name=brand_name,
                 qty=qty,
+                unit_price=_parse_unit_price(item),
+                order_num=idx,
+                create_by=user_id,
+                create_dept_id=dept_id or "",
+                update_by=user_id,
+            )
+        )
+
+
+def persist_stop_product_brand_qtys(
+    db: Session,
+    *,
+    tenant_no: str,
+    plan_id: str,
+    plan_product_id: str,
+    stop_type: str,
+    stop_product_id: str,
+    brand_mode: Optional[str],
+    rows: list[dict[str, Any]],
+    user_id: str,
+    dept_id: str = "",
+) -> None:
+    """软删该段产品行旧品牌量后写入；无有效数量则只软删。"""
+    stop_id = (stop_product_id or "").strip()
+    if not stop_id:
+        return
+    existing = (
+        db.query(PlPlanProductBrandQty)
+        .filter(
+            PlPlanProductBrandQty.stop_product_id == stop_id,
+            PlPlanProductBrandQty.tenant_no == tenant_no,
+            PlPlanProductBrandQty.del_flag == 0,
+        )
+        .all()
+    )
+    for row in existing:
+        row.del_flag = 1
+        row.update_by = user_id
+
+    positive = [item for item in rows if Decimal(str(item.get("qty") or 0)) > 0]
+    if not brand_mode and not positive:
+        return
+
+    for idx, item in enumerate(rows):
+        qty = Decimal(str(item.get("qty") or 0))
+        if qty <= 0:
+            continue
+        brand_id = item.get("brandId") or item.get("brand_id") or ""
+        brand_name = item.get("brandName") or item.get("brand_name")
+        db.add(
+            PlPlanProductBrandQty(
+                id=generate_uuid(),
+                tenant_no=tenant_no,
+                plan_id=plan_id,
+                plan_product_id=plan_product_id,
+                stop_type=stop_type,
+                stop_product_id=stop_id,
+                brand_id=brand_id,
+                brand_name=brand_name,
+                qty=qty,
+                unit_price=_parse_unit_price(item),
                 order_num=idx,
                 create_by=user_id,
                 create_dept_id=dept_id or "",

backend/app/services/pl_plan_archive_stop_service.py

@@ -21,6 +21,7 @@ from app.schemas.pl.plan import (
     PlanArchiveLoadBlock,
     PlanArchiveStopProductItem,
 )
+from app.services.pl_brand_archive import persist_stop_product_brand_qtys
 from app.services.pl_internal_customer import is_internal_customer_name
 
 
@@ -60,6 +61,56 @@ def _apply_stop_product_archive(
     row.update_by = user_id
 
 
+def _brand_rows_from_item(item: PlanArchiveStopProductItem) -> list[dict]:
+    if not item.brand_qtys:
+        return []
+    rows: list[dict] = []
+    for bq in item.brand_qtys:
+        row: dict = {
+            "brandId": bq.brand_id or "",
+            "brandName": bq.brand_name,
+            "qty": bq.qty,
+        }
+        if bq.unit_price is not None:
+            row["unitPrice"] = bq.unit_price
+        rows.append(row)
+    return rows
+
+
+def _persist_stop_brand_qtys(
+    db: Session,
+    *,
+    tenant_no: str,
+    plan: PlPlan,
+    stop_type: str,
+    stop_row: PlPlanLoadProduct | PlPlanDeliveryProduct,
+    item: PlanArchiveStopProductItem,
+    user_id: str,
+) -> None:
+    plan_product = (
+        db.query(PlPlanProduct)
+        .filter(
+            PlPlanProduct.id == stop_row.plan_product_id,
+            PlPlanProduct.tenant_no == tenant_no,
+            PlPlanProduct.del_flag == 0,
+        )
+        .first()
+    )
+    brand_mode = plan_product.brand_mode if plan_product else None
+    persist_stop_product_brand_qtys(
+        db,
+        tenant_no=tenant_no,
+        plan_id=plan.id,
+        plan_product_id=stop_row.plan_product_id,
+        stop_type=stop_type,
+        stop_product_id=stop_row.id,
+        brand_mode=brand_mode,
+        rows=_brand_rows_from_item(item),
+        user_id=user_id,
+        dept_id=getattr(stop_row, "create_dept_id", "") or "",
+    )
+
+
 def apply_archive_stop_quantities(
     db: Session,
     *,
@@ -102,6 +153,15 @@ def apply_archive_stop_quantities(
         _apply_stop_product_archive(
             row, item, mode="inbound", label="装货段", user_id=user_id
         )
+        _persist_stop_brand_qtys(
+            db,
+            tenant_no=tenant_no,
+            plan=plan,
+            stop_type="load",
+            stop_row=row,
+            item=item,
+            user_id=user_id,
+        )
 
     deliveries = (
         db.query(PlPlanDelivery)
@@ -142,6 +202,15 @@ def apply_archive_stop_quantities(
             _apply_stop_product_archive(
                 row, item, mode="outbound", label=label, user_id=user_id
             )
+            _persist_stop_brand_qtys(
+                db,
+                tenant_no=tenant_no,
+                plan=plan,
+                stop_type="delivery",
+                stop_row=row,
+                item=item,
+                user_id=user_id,
+            )
 
 
 def sync_plan_products_from_stop_archive(

backend/app/services/pl_plan_contract_gap.py

@@ -1,14 +1,27 @@
 from __future__ import annotations
 
-from datetime import date
+from datetime import date, datetime
 from typing import List, Optional, TYPE_CHECKING
 
 from fastapi import HTTPException
 from sqlalchemy import and_, exists, func, or_, select
 from sqlalchemy.orm import Session
 
-from app.models.pl_models import PlPlan, PlPlanContract, PlPlanProduct
-from app.schemas.pl.plan import PlanContractGapRead, PlanContractLink, PlanProductRead
+from app.core.utils import generate_uuid
+from app.models.pl_models import (
+    PlPlan,
+    PlPlanContract,
+    PlPlanDelivery,
+    PlPlanLoad,
+    PlPlanProduct,
+)
+from app.schemas.pl.plan import (
+    PlanContractGapRead,
+    PlanContractLink,
+    PlanDeliveryRead,
+    PlanLoadRead,
+    PlanProductRead,
+)
 from app.services.pl_data_scope import apply_pl_scope
 from app.services.pl_internal_customer import INTERNAL_CUSTOMER_NAMES, is_internal_customer_name
 from app.services.pl_plan_service import (
@@ -19,11 +32,26 @@ from app.services.pl_plan_service import (
     load_plan_contracts_grouped,
     replace_plan_contracts,
 )
+from app.services.pl_plan_stop_service import (
+    PLAN_CONTRACT_SIDE_DELIVERY,
+    PLAN_CONTRACT_SIDE_LOAD,
+    load_plan_stops_grouped,
+)
+from app.services.pl_product_display import load_crm_product_alias_maps, resolve_product_display_names
 
 if TYPE_CHECKING:
     from app.core.db_auth import DbUserContext
 
 
+def stop_contract_gap(customer_name: Optional[str], contract_count: int) -> bool:
+    """段次客户非内置且未关联合同时视为缺口。"""
+    return not is_internal_customer_name(customer_name) and contract_count <= 0
+
+
+def side_is_exempt(name: Optional[str]) -> bool:
+    return is_internal_customer_name(name)
+
+
 def compute_contract_gap_sides(
     *,
     supplier_name: Optional[str],
@@ -32,57 +60,178 @@ def compute_contract_gap_sides(
     demander_contract_count: int,
 ) -> List[str]:
     gaps: List[str] = []
-    if not is_internal_customer_name(supplier_name) and supplier_contract_count <= 0:
+    if stop_contract_gap(supplier_name, supplier_contract_count):
         gaps.append("supplier")
-    if not is_internal_customer_name(customer_name) and demander_contract_count <= 0:
+    if stop_contract_gap(customer_name, demander_contract_count):
         gaps.append("demander")
     return gaps
 
 
-def side_is_exempt(name: Optional[str]) -> bool:
-    return is_internal_customer_name(name)
+def compute_plan_gap_sides_from_stops(
+    load_read: Optional[PlanLoadRead],
+    delivery_reads: list[PlanDeliveryRead],
+    *,
+    supplier_name: Optional[str] = None,
+    customer_name: Optional[str] = None,
+    supplier_contract_count: int = 0,
+    demander_contract_count: int = 0,
+) -> list[str]:
+    """按段次汇总计划是否仍有合同缺口（supplier=装货侧，demander=送货侧）。"""
+    has_load_gap = False
+    has_delivery_gap = False
+
+    if load_read is not None:
+        has_load_gap = stop_contract_gap(load_read.customer_name, len(load_read.contracts or []))
+    elif stop_contract_gap(supplier_name, supplier_contract_count):
+        has_load_gap = True
+
+    if delivery_reads:
+        has_delivery_gap = any(
+            stop_contract_gap(item.customer_name, len(item.contracts or []))
+            for item in delivery_reads
+        )
+    elif stop_contract_gap(customer_name, demander_contract_count):
+        has_delivery_gap = True
+
+    gaps: list[str] = []
+    if has_load_gap:
+        gaps.append("supplier")
+    if has_delivery_gap:
+        gaps.append("demander")
+    return gaps
 
 
-def _side_contract_exists(tenant_no: str, side: str):
+def _stop_contract_exists(tenant_no: str, plan_id_expr, stop_id_expr, legacy_sides: tuple[str, ...]):
     return exists(
         select(PlPlanContract.id).where(
-            PlPlanContract.plan_id == PlPlan.id,
+            PlPlanContract.plan_id == plan_id_expr,
             PlPlanContract.tenant_no == tenant_no,
             PlPlanContract.del_flag == 0,
-            PlPlanContract.side == side,
+            or_(
+                PlPlanContract.stop_id == stop_id_expr,
+                and_(
+                    or_(PlPlanContract.stop_id.is_(None), PlPlanContract.stop_id == ""),
+                    PlPlanContract.side.in_(legacy_sides),
+                ),
+            ),
         )
     )
 
 
-def _supplier_gap_expr(tenant_no: str):
+def _load_stop_gap_expr(tenant_no: str):
     internal_names = tuple(INTERNAL_CUSTOMER_NAMES)
+    customer_not_internal = or_(
+        PlPlanLoad.customer_name.is_(None),
+        PlPlanLoad.customer_name == "",
+        ~PlPlanLoad.customer_name.in_(internal_names),
+    )
+    return exists(
+        select(PlPlanLoad.id).where(
+            PlPlanLoad.plan_id == PlPlan.id,
+            PlPlanLoad.tenant_no == tenant_no,
+            PlPlanLoad.del_flag == 0,
+            customer_not_internal,
+            ~_stop_contract_exists(
+                tenant_no,
+                PlPlan.id,
+                PlPlanLoad.id,
+                (PLAN_CONTRACT_SIDE_LOAD, PLAN_CONTRACT_SIDE_SUPPLIER),
+            ),
+        )
+    )
+
+
+def _delivery_stop_gap_expr(tenant_no: str):
+    internal_names = tuple(INTERNAL_CUSTOMER_NAMES)
+    customer_not_internal = or_(
+        PlPlanDelivery.customer_name.is_(None),
+        PlPlanDelivery.customer_name == "",
+        ~PlPlanDelivery.customer_name.in_(internal_names),
+    )
+    return exists(
+        select(PlPlanDelivery.id).where(
+            PlPlanDelivery.plan_id == PlPlan.id,
+            PlPlanDelivery.tenant_no == tenant_no,
+            PlPlanDelivery.del_flag == 0,
+            customer_not_internal,
+            ~_stop_contract_exists(
+                tenant_no,
+                PlPlan.id,
+                PlPlanDelivery.id,
+                (PLAN_CONTRACT_SIDE_DELIVERY, PLAN_CONTRACT_SIDE_DEMANDER),
+            ),
+        )
+    )
+
+
+def _legacy_supplier_gap_expr(tenant_no: str):
+    internal_names = tuple(INTERNAL_CUSTOMER_NAMES)
+    has_load = exists(
+        select(PlPlanLoad.id).where(
+            PlPlanLoad.plan_id == PlPlan.id,
+            PlPlanLoad.tenant_no == tenant_no,
+            PlPlanLoad.del_flag == 0,
+        )
+    )
     supplier_not_internal = or_(
         PlPlan.supplier_name.is_(None),
         PlPlan.supplier_name == "",
         ~PlPlan.supplier_name.in_(internal_names),
     )
     return and_(
+        ~has_load,
         supplier_not_internal,
-        ~_side_contract_exists(tenant_no, PLAN_CONTRACT_SIDE_SUPPLIER),
+        ~_stop_contract_exists(
+            tenant_no,
+            PlPlan.id,
+            PlPlan.id,
+            (PLAN_CONTRACT_SIDE_SUPPLIER,),
+        ),
     )
 
 
-def _demander_gap_expr(tenant_no: str):
+def _legacy_demander_gap_expr(tenant_no: str):
     internal_names = tuple(INTERNAL_CUSTOMER_NAMES)
+    has_delivery = exists(
+        select(PlPlanDelivery.id).where(
+            PlPlanDelivery.plan_id == PlPlan.id,
+            PlPlanDelivery.tenant_no == tenant_no,
+            PlPlanDelivery.del_flag == 0,
+        )
+    )
     customer_not_internal = or_(
         PlPlan.customer_name.is_(None),
         PlPlan.customer_name == "",
         ~PlPlan.customer_name.in_(internal_names),
     )
     return and_(
+        ~has_delivery,
         customer_not_internal,
-        ~_side_contract_exists(tenant_no, PLAN_CONTRACT_SIDE_DEMANDER),
+        ~_stop_contract_exists(
+            tenant_no,
+            PlPlan.id,
+            PlPlan.id,
+            (PLAN_CONTRACT_SIDE_DEMANDER,),
+        ),
     )
 
 
 def plan_has_contract_gap_exists(tenant_no: str):
-    """列表筛选：计划存在合同缺口（非内置侧缺少有效 pl_plan_contract 关联）。"""
-    return or_(_supplier_gap_expr(tenant_no), _demander_gap_expr(tenant_no))
+    """列表筛选：任一段次（或旧计划级）存在合同缺口。"""
+    return or_(
+        _load_stop_gap_expr(tenant_no),
+        _delivery_stop_gap_expr(tenant_no),
+        _legacy_supplier_gap_expr(tenant_no),
+        _legacy_demander_gap_expr(tenant_no),
+    )
+
+
+def _supplier_gap_expr(tenant_no: str):
+    return or_(_load_stop_gap_expr(tenant_no), _legacy_supplier_gap_expr(tenant_no))
+
+
+def _demander_gap_expr(tenant_no: str):
+    return or_(_delivery_stop_gap_expr(tenant_no), _legacy_demander_gap_expr(tenant_no))
 
 
 def build_plan_contract_gap_read(
@@ -91,8 +240,13 @@ def build_plan_contract_gap_read(
     supplier_contracts: list[PlanContractLink],
     demander_contracts: list[PlanContractLink],
     products: Optional[list[PlanProductRead]] = None,
+    load_read: Optional[PlanLoadRead] = None,
+    delivery_reads: Optional[list[PlanDeliveryRead]] = None,
 ) -> PlanContractGapRead:
-    gap_sides = compute_contract_gap_sides(
+    deliveries = list(delivery_reads or [])
+    gap_sides = compute_plan_gap_sides_from_stops(
+        load_read,
+        deliveries,
         supplier_name=plan.supplier_name,
         customer_name=plan.customer_name,
         supplier_contract_count=len(supplier_contracts),
@@ -114,12 +268,16 @@ def build_plan_contract_gap_read(
         supplierContracts=supplier_contracts,
         demanderContracts=demander_contracts,
         products=list(products or []),
+        load=load_read,
+        deliveries=deliveries,
     )
 
 
 def _load_products_by_plan_ids(
     db: Session,
     plan_ids: list[str],
+    *,
+    tenant_no: str,
 ) -> dict[str, list[PlanProductRead]]:
     if not plan_ids:
         return {}
@@ -132,9 +290,21 @@ def _load_products_by_plan_ids(
         .order_by(PlPlanProduct.order_num.asc(), PlPlanProduct.create_time.asc())
         .all()
     )
+    product_ids = {(row.product_id or "").strip() for row in rows if (row.product_id or "").strip()}
+    standard_by_id, alias_options_by_id = load_crm_product_alias_maps(
+        db, tenant_no=tenant_no, product_ids=product_ids
+    )
     out: dict[str, list[PlanProductRead]] = {pid: [] for pid in plan_ids}
     for row in rows:
-        out.setdefault(row.plan_id, []).append(PlanProductRead.model_validate(row))
+        item = PlanProductRead.model_validate(row)
+        display_name, _alias = resolve_product_display_names(
+            saved_product_name=row.product_name,
+            product_id=row.product_id,
+            standard_by_id=standard_by_id,
+            alias_options_by_id=alias_options_by_id,
+        )
+        item.product_name = display_name or (row.product_name or "")
+        out.setdefault(row.plan_id, []).append(item)
     return out
 
 
@@ -179,10 +349,28 @@ def list_plan_contract_gaps(
         kw = customer_keyword.strip()
         if kw:
             kw_lower = kw.lower()
+            load_match = exists(
+                select(PlPlanLoad.id).where(
+                    PlPlanLoad.plan_id == PlPlan.id,
+                    PlPlanLoad.tenant_no == tenant_no,
+                    PlPlanLoad.del_flag == 0,
+                    func.lower(PlPlanLoad.customer_name).contains(kw_lower),
+                )
+            )
+            delivery_match = exists(
+                select(PlPlanDelivery.id).where(
+                    PlPlanDelivery.plan_id == PlPlan.id,
+                    PlPlanDelivery.tenant_no == tenant_no,
+                    PlPlanDelivery.del_flag == 0,
+                    func.lower(PlPlanDelivery.customer_name).contains(kw_lower),
+                )
+            )
             query = query.filter(
                 or_(
                     func.lower(PlPlan.supplier_name).contains(kw_lower),
                     func.lower(PlPlan.customer_name).contains(kw_lower),
+                    load_match,
+                    delivery_match,
                 )
             )
 
@@ -196,11 +384,29 @@ def list_plan_contract_gaps(
         q_kw = q.strip()
         if q_kw:
             q_lower = q_kw.lower()
+            load_match = exists(
+                select(PlPlanLoad.id).where(
+                    PlPlanLoad.plan_id == PlPlan.id,
+                    PlPlanLoad.tenant_no == tenant_no,
+                    PlPlanLoad.del_flag == 0,
+                    func.lower(PlPlanLoad.customer_name).contains(q_lower),
+                )
+            )
+            delivery_match = exists(
+                select(PlPlanDelivery.id).where(
+                    PlPlanDelivery.plan_id == PlPlan.id,
+                    PlPlanDelivery.tenant_no == tenant_no,
+                    PlPlanDelivery.del_flag == 0,
+                    func.lower(PlPlanDelivery.customer_name).contains(q_lower),
+                )
+            )
             query = query.filter(
                 or_(
                     PlPlan.plan_no.contains(q_kw),
                     func.lower(PlPlan.supplier_name).contains(q_lower),
                     func.lower(PlPlan.customer_name).contains(q_lower),
+                    load_match,
+                    delivery_match,
                 )
             )
 
@@ -217,22 +423,200 @@ def list_plan_contract_gaps(
 
     plan_ids = [plan.id for plan in plans]
     contracts_by_plan = load_plan_contracts_grouped(db, tenant_no, plan_ids)
-    products_by_plan = _load_products_by_plan_ids(db, plan_ids)
+    products_by_plan = _load_products_by_plan_ids(db, plan_ids, tenant_no=tenant_no)
+    stops_by_plan = load_plan_stops_grouped(db, tenant_no, plan_ids)
 
     items: list[PlanContractGapRead] = []
     for plan in plans:
         supplier_contracts, demander_contracts = contracts_by_plan.get(plan.id, ([], []))
+        load_read, delivery_reads = stops_by_plan.get(plan.id, (None, []))
         items.append(
             build_plan_contract_gap_read(
                 plan,
                 supplier_contracts=supplier_contracts,
                 demander_contracts=demander_contracts,
                 products=products_by_plan.get(plan.id, []),
+                load_read=load_read,
+                delivery_reads=delivery_reads,
             )
         )
     return total, items
 
 
+def _write_stop_contract_rows(
+    db: Session,
+    *,
+    tenant_no: str,
+    plan_id: str,
+    stop_id: str,
+    side: str,
+    contracts: list[PlanContractLink],
+    user_id: Optional[str],
+    dept_id: Optional[str],
+) -> None:
+    now = datetime.now()
+    db.query(PlPlanContract).filter(
+        PlPlanContract.plan_id == plan_id,
+        PlPlanContract.tenant_no == tenant_no,
+        PlPlanContract.del_flag == 0,
+        PlPlanContract.stop_id == stop_id,
+    ).update(
+        {"del_flag": 1, "update_by": user_id, "update_time": now},
+        synchronize_session=False,
+    )
+    order_num = 0
+    for link in contracts:
+        order_num += 1
+        db.add(
+            PlPlanContract(
+                id=generate_uuid(),
+                plan_id=plan_id,
+                side=side,
+                stop_id=stop_id,
+                contract_id=link.contract_id,
+                contract_no=link.contract_no,
+                tenant_no=tenant_no,
+                order_num=order_num,
+                create_by=user_id,
+                create_dept_id=dept_id or "",
+                create_time=now,
+                update_by=user_id,
+                update_time=now,
+                del_flag=0,
+            )
+        )
+
+
+def _clear_legacy_side_contracts(
+    db: Session,
+    *,
+    tenant_no: str,
+    plan_id: str,
+    legacy_sides: tuple[str, ...],
+    user_id: Optional[str],
+) -> None:
+    now = datetime.now()
+    db.query(PlPlanContract).filter(
+        PlPlanContract.plan_id == plan_id,
+        PlPlanContract.tenant_no == tenant_no,
+        PlPlanContract.del_flag == 0,
+        or_(PlPlanContract.stop_id.is_(None), PlPlanContract.stop_id == ""),
+        PlPlanContract.side.in_(legacy_sides),
+    ).update(
+        {"del_flag": 1, "update_by": user_id, "update_time": now},
+        synchronize_session=False,
+    )
+
+
+def update_plan_stop_contracts(
+    db: Session,
+    *,
+    tenant_no: str,
+    plan: PlPlan,
+    stop_type: str,
+    stop_id: str,
+    contracts: list[PlanContractLink],
+    user_id: Optional[str],
+    dept_id: Optional[str],
+) -> PlanContractGapRead:
+    """保存某装货/送货段的合同关联。"""
+    if plan.follow_status == "cancelled":
+        raise HTTPException(status_code=400, detail="已作废的计划不能修改")
+
+    stop_type_norm = (stop_type or "").strip().lower()
+    stop_id_norm = (stop_id or "").strip()
+    if stop_type_norm not in ("load", "delivery") or not stop_id_norm:
+        raise HTTPException(status_code=422, detail="stopType 必须为 load 或 delivery，且 stopId 不能为空")
+
+    if stop_type_norm == "load":
+        stop = (
+            db.query(PlPlanLoad)
+            .filter(
+                PlPlanLoad.id == stop_id_norm,
+                PlPlanLoad.plan_id == plan.id,
+                PlPlanLoad.tenant_no == tenant_no,
+                PlPlanLoad.del_flag == 0,
+            )
+            .first()
+        )
+        side = PLAN_CONTRACT_SIDE_LOAD
+        legacy_sides = (PLAN_CONTRACT_SIDE_SUPPLIER,)
+        side_label = "装货段合同"
+    else:
+        stop = (
+            db.query(PlPlanDelivery)
+            .filter(
+                PlPlanDelivery.id == stop_id_norm,
+                PlPlanDelivery.plan_id == plan.id,
+                PlPlanDelivery.tenant_no == tenant_no,
+                PlPlanDelivery.del_flag == 0,
+            )
+            .first()
+        )
+        side = PLAN_CONTRACT_SIDE_DELIVERY
+        legacy_sides = (PLAN_CONTRACT_SIDE_DEMANDER,)
+        side_label = "送货段合同"
+
+    if not stop:
+        raise HTTPException(status_code=404, detail="段次不存在")
+
+    if is_internal_customer_name(stop.customer_name):
+        raise HTTPException(status_code=400, detail="内置客户无需补充合同")
+
+    links = _normalize_contract_links(contracts)
+    expected_customer_id = stop.customer_id
+    resolved: list[PlanContractLink] = []
+    for link in links:
+        contract = assert_contract_selectable_for_plan(
+            db,
+            link.contract_id,
+            tenant_no,
+            expected_customer_id=expected_customer_id,
+            side_label=side_label,
+        )
+        resolved.append(
+            PlanContractLink(
+                contractId=contract.id,
+                contractNo=contract.contract_no or link.contract_no,
+                stopId=stop_id_norm,
+            )
+        )
+
+    _clear_legacy_side_contracts(
+        db,
+        tenant_no=tenant_no,
+        plan_id=plan.id,
+        legacy_sides=legacy_sides,
+        user_id=user_id,
+    )
+    _write_stop_contract_rows(
+        db,
+        tenant_no=tenant_no,
+        plan_id=plan.id,
+        stop_id=stop_id_norm,
+        side=side,
+        contracts=resolved,
+        user_id=user_id,
+        dept_id=dept_id,
+    )
+
+    supplier_contracts, demander_contracts = load_plan_contracts_grouped(
+        db, tenant_no, [plan.id]
+    ).get(plan.id, ([], []))
+    products = _load_products_by_plan_ids(db, [plan.id], tenant_no=tenant_no).get(plan.id, [])
+    load_read, delivery_reads = load_plan_stops_grouped(db, tenant_no, [plan.id]).get(
+        plan.id, (None, [])
+    )
+    return build_plan_contract_gap_read(
+        plan,
+        supplier_contracts=supplier_contracts,
+        demander_contracts=demander_contracts,
+        products=products,
+        load_read=load_read,
+        delivery_reads=delivery_reads,
+    )
+
+
 def update_plan_side_contracts(
     db: Session,
     *,
@@ -243,7 +627,7 @@ def update_plan_side_contracts(
     user_id: Optional[str],
     dept_id: Optional[str],
 ) -> PlanContractGapRead:
-    """单侧保存计划合同关联；允许空列表，不强制非内置侧必须有合同。"""
+    """单侧保存计划合同关联（旧计划级接口，兼容保留）。"""
     if plan.follow_status == "cancelled":
         raise HTTPException(status_code=400, detail="已作废的计划不能修改")
     if side not in (PLAN_CONTRACT_SIDE_SUPPLIER, PLAN_CONTRACT_SIDE_DEMANDER):
@@ -288,10 +672,15 @@ def update_plan_side_contracts(
     supplier_contracts, demander_contracts = load_plan_contracts_grouped(
         db, tenant_no, [plan.id]
     ).get(plan.id, ([], []))
-    products = _load_products_by_plan_ids(db, [plan.id]).get(plan.id, [])
+    products = _load_products_by_plan_ids(db, [plan.id], tenant_no=tenant_no).get(plan.id, [])
+    load_read, delivery_reads = load_plan_stops_grouped(db, tenant_no, [plan.id]).get(
+        plan.id, (None, [])
+    )
     return build_plan_contract_gap_read(
         plan,
         supplier_contracts=supplier_contracts,
         demander_contracts=demander_contracts,
         products=products,
+        load_read=load_read,
+        delivery_reads=delivery_reads,
     )

backend/app/services/pl_plan_service.py

@@ -1435,6 +1435,7 @@ def apply_archive_product_quantities(
                     "brandId": bq.brand_id or "",
                     "brandName": bq.brand_name,
                     "qty": bq.qty,
+                    **({"unitPrice": bq.unit_price} if bq.unit_price is not None else {}),
                 }
                 for bq in item.brand_qtys
             ]
@@ -1489,6 +1490,7 @@ def apply_archive_brand_qtys_only(
                 "brandId": bq.brand_id or "",
                 "brandName": bq.brand_name,
                 "qty": bq.qty,
+                **({"unitPrice": bq.unit_price} if bq.unit_price is not None else {}),
             }
             for bq in item.brand_qtys
         ]

backend/app/services/pl_plan_stop_service.py

@@ -20,6 +20,7 @@ from app.models.pl_models import (
     PlTransportAddress,
 )
 from app.schemas.pl.plan import (
+    PlanArchiveBrandQtyItem,
     PlanContractLink,
     PlanDeliveryBody,
     PlanDeliveryRead,
@@ -28,6 +29,7 @@ from app.schemas.pl.plan import (
     PlanStopProductBody,
     PlanStopProductRead,
 )
+from app.services.pl_brand_archive import load_brand_qtys_by_stop_product_ids
 from app.services.pl_internal_customer import is_internal_customer_name
 from app.services.pl_plan_stop_rules import resolve_stop_dibang_defaults, warn_qty_imbalance
 from app.services.pl_plan_service import (
@@ -35,6 +37,7 @@ from app.services.pl_plan_service import (
     PLAN_CONTRACT_SIDE_SUPPLIER,
     assert_contract_selectable_for_plan,
 )
+from app.services.pl_product_display import load_crm_product_alias_maps, resolve_product_display_names
 
 PLAN_CONTRACT_SIDE_LOAD = "load"
 PLAN_CONTRACT_SIDE_DELIVERY = "delivery"
@@ -48,12 +51,86 @@ def _contract_link(row: PlPlanContract) -> PlanContractLink:
     )
 
 
-def _load_stop_product(row: PlPlanLoadProduct) -> PlanStopProductRead:
-    return PlanStopProductRead.model_validate(row)
+def _attach_stop_brand_qtys(
+    product: PlanStopProductRead,
+    brand_qtys_by_stop: dict[str, list[dict]],
+) -> PlanStopProductRead:
+    raw = brand_qtys_by_stop.get(product.id) or None
+    if raw:
+        product.brand_qtys = [PlanArchiveBrandQtyItem.model_validate(x) for x in raw]
+    else:
+        product.brand_qtys = None
+    return product
 
 
-def _delivery_stop_product(row: PlPlanDeliveryProduct) -> PlanStopProductRead:
-    return PlanStopProductRead.model_validate(row)
+def _resolve_stop_list_product_name(
+    *,
+    saved_product_name: Optional[str],
+    product_id: Optional[str],
+    standard_by_id: dict[str, str],
+    alias_options_by_id: dict[str, list[str]],
+) -> str:
+    """列表展示用：优先 CRM 标准名，不展示别名。"""
+    display_name, _alias = resolve_product_display_names(
+        saved_product_name=saved_product_name,
+        product_id=product_id,
+        standard_by_id=standard_by_id,
+        alias_options_by_id=alias_options_by_id,
+    )
+    return display_name or (saved_product_name or "")
+
+
+def _apply_stop_list_product_name(
+    product: PlanStopProductRead,
+    *,
+    standard_by_id: dict[str, str],
+    alias_options_by_id: dict[str, list[str]],
+) -> PlanStopProductRead:
+    product.product_name = _resolve_stop_list_product_name(
+        saved_product_name=product.product_name,
+        product_id=product.product_id,
+        standard_by_id=standard_by_id,
+        alias_options_by_id=alias_options_by_id,
+    )
+    return product
+
+
+def _load_stop_product(
+    row: PlPlanLoadProduct,
+    brand_qtys_by_stop: dict[str, list[dict]] | None = None,
+    *,
+    standard_by_id: dict[str, str] | None = None,
+    alias_options_by_id: dict[str, list[str]] | None = None,
+) -> PlanStopProductRead:
+    product = PlanStopProductRead.model_validate(row)
+    if standard_by_id is not None and alias_options_by_id is not None:
+        product = _apply_stop_list_product_name(
+            product,
+            standard_by_id=standard_by_id,
+            alias_options_by_id=alias_options_by_id,
+        )
+    if brand_qtys_by_stop is not None:
+        return _attach_stop_brand_qtys(product, brand_qtys_by_stop)
+    return product
+
+
+def _delivery_stop_product(
+    row: PlPlanDeliveryProduct,
+    brand_qtys_by_stop: dict[str, list[dict]] | None = None,
+    *,
+    standard_by_id: dict[str, str] | None = None,
+    alias_options_by_id: dict[str, list[str]] | None = None,
+) -> PlanStopProductRead:
+    product = PlanStopProductRead.model_validate(row)
+    if standard_by_id is not None and alias_options_by_id is not None:
+        product = _apply_stop_list_product_name(
+            product,
+            standard_by_id=standard_by_id,
+            alias_options_by_id=alias_options_by_id,
+        )
+    if brand_qtys_by_stop is not None:
+        return _attach_stop_brand_qtys(product, brand_qtys_by_stop)
+    return product
 
 
 def load_stop_contract_rows_grouped(
@@ -228,6 +305,27 @@ def load_plan_stops_grouped(
         ):
             delivery_products[row.delivery_id].append(row)
 
+    stop_product_ids: list[str] = []
+    crm_product_ids: set[str] = set()
+    for rows in load_products.values():
+        for p in rows:
+            if p.id:
+                stop_product_ids.append(p.id)
+            if (p.product_id or "").strip():
+                crm_product_ids.add(p.product_id.strip())
+    for rows in delivery_products.values():
+        for p in rows:
+            if p.id:
+                stop_product_ids.append(p.id)
+            if (p.product_id or "").strip():
+                crm_product_ids.add(p.product_id.strip())
+    brand_qtys_by_stop = load_brand_qtys_by_stop_product_ids(
+        db, tenant_no=tenant_no, stop_product_ids=stop_product_ids
+    )
+    standard_by_id, alias_options_by_id = load_crm_product_alias_maps(
+        db, tenant_no=tenant_no, product_ids=crm_product_ids
+    )
+
     contracts_by_plan = load_stop_contract_rows_grouped(db, tenant_no, plan_ids)
 
     result: dict[str, tuple[Optional[PlanLoadRead], list[PlanDeliveryRead]]] = {}
@@ -246,7 +344,15 @@ def load_plan_stops_grouped(
             )
             if resolved_load_address:
                 load_read.address = resolved_load_address
-            load_read.products = [_load_stop_product(p) for p in load_products.get(load_row.id, [])]
+            load_read.products = [
+                _load_stop_product(
+                    p,
+                    brand_qtys_by_stop,
+                    standard_by_id=standard_by_id,
+                    alias_options_by_id=alias_options_by_id,
+                )
+                for p in load_products.get(load_row.id, [])
+            ]
             load_read.contracts = _contracts_for_stop(
                 contract_rows,
                 load_row.id,
@@ -267,7 +373,13 @@ def load_plan_stops_grouped(
             if resolved_delivery_address:
                 delivery_read.address = resolved_delivery_address
             delivery_read.products = [
-                _delivery_stop_product(p) for p in delivery_products.get(delivery_row.id, [])
+                _delivery_stop_product(
+                    p,
+                    brand_qtys_by_stop,
+                    standard_by_id=standard_by_id,
+                    alias_options_by_id=alias_options_by_id,
+                )
+                for p in delivery_products.get(delivery_row.id, [])
             ]
             legacy_sides = (PLAN_CONTRACT_SIDE_DELIVERY, PLAN_CONTRACT_SIDE_DEMANDER)
             # 未迁移合同仅挂到第一个送货段

backend/graphify-out/.graphify_labels.json

@@ -109,8 +109,8 @@
   "107": "apply_pl_scope",
   "108": "statistics.py",
   "109": "test_pl_plan_stop_rules.py",
-  "110": "monitor.py",
-  "111": "run_auto_generate_monthly_plans",
+  "110": "pool_rule.py",
+  "111": "test_pl_public_transport_history.py",
   "112": "merge_duplicate_crm_customers.py",
   "113": "dict_type.py",
   "114": "dept.py",
@@ -119,8 +119,8 @@
   "117": "pl_plan_list_attachments.py",
   "118": "Community 118",
   "119": "Community 119",
-  "120": "oper_log_decorator.py",
-  "121": "customer_follow.py",
+  "120": "list_duty_staff_users",
+  "121": "_build_user_info_payload",
   "122": "post.py",
   "123": "customer_options",
   "124": "LocalStorage",
@@ -131,31 +131,23 @@
   "129": "BaseStorage",
   "130": "_filter_export_rows_by_ids",
   "131": "resolve_crm_product",
-  "132": "list_products",
+  "132": ".to_list_kwargs",
   "133": "inventory_id.py",
   "134": "list_contacts",
-  "135": "customer.py",
   "136": "get_db_current_user_optional",
   "137": "iter_user_menu_perm_codes",
   "138": "Community 138",
   "139": "get_current_user_by_token",
-  "140": "UserRole",
-  "141": "customer_follow.py",
   "142": "clear_pl_plan_instance_data.py",
   "143": "calc_age_from_chinese_id_card",
   "144": "response.py",
-  "145": "duty_schedule.py",
-  "146": "duty.py",
   "147": "Community 147",
-  "148": "unsettled_plans_q_filter",
   "149": "list_product_options",
   "150": "get_db_current_user_optional",
   "151": "Community 151",
-  "152": "customer_options",
   "153": "pl_feedback_brand_qty.py",
   "154": "LocalStorage",
   "155": "WechatMessageService",
-  "156": "_map_role_name_to_web",
   "162": ".to_tenant_user_dict",
   "164": "get_client_ip",
   "166": "code:block1 (/iflytek/shanxia2.0/backend)",

backend/graphify-out/.graphify_root

@@ -1 +1 @@
-/Users/wuzilong/work/00code/shanxia2.0/backend
+backend

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

@@ -109,38 +109,43 @@
   "107": "apply_pl_scope",
   "108": "statistics.py",
   "109": "test_pl_plan_stop_rules.py",
-  "111": "run_auto_generate_monthly_plans",
   "112": "merge_duplicate_crm_customers.py",
   "113": "dict_type.py",
   "114": "dept.py",
   "115": "site.py",
   "116": "Community 116",
+  "117": "pl_plan_list_attachments.py",
   "118": "Community 118",
   "119": "Community 119",
-  "120": "oper_log_decorator.py",
-  "121": "customer_follow.py",
   "122": "post.py",
   "123": "customer_options",
   "124": "LocalStorage",
   "125": "ethnic.py",
+  "126": "oper_log.py",
+  "127": "Any",
+  "128": "api_crypto.py",
   "129": "BaseStorage",
   "130": "_filter_export_rows_by_ids",
   "131": "resolve_crm_product",
   "133": "inventory_id.py",
   "134": "list_contacts",
   "136": "get_db_current_user_optional",
+  "137": "iter_user_menu_perm_codes",
   "138": "Community 138",
   "139": "get_current_user_by_token",
-  "140": "UserRole",
   "142": "clear_pl_plan_instance_data.py",
+  "143": "calc_age_from_chinese_id_card",
+  "144": "response.py",
   "145": "duty_schedule.py",
-  "146": "duty.py",
   "147": "Community 147",
+  "149": "list_product_options",
+  "150": "get_db_current_user_optional",
   "151": "Community 151",
-  "152": "customer_options",
   "153": "pl_feedback_brand_qty.py",
   "154": "LocalStorage",
   "155": "WechatMessageService",
+  "156": "_map_role_name_to_web",
+  "158": "DutyDaySaveBody",
   "162": ".to_tenant_user_dict",
   "164": "get_client_ip",
   "166": "code:block1 (/iflytek/shanxia2.0/backend)",

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

@@ -1,16 +1,16 @@
 # Graph Report - backend  (2026-08-27)
 
 ## Corpus Check
-- 358 files · ~251,642 words
+- 361 files · ~254,425 words
 - Verdict: corpus is large enough that graph structure adds value.
 
 ## Summary
-- 5124 nodes · 19395 edges · 175 communities (160 shown, 15 thin omitted)
-- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 1003 edges (avg confidence: 0.52)
+- 5188 nodes · 19649 edges · 180 communities (165 shown, 15 thin omitted)
+- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 1009 edges (avg confidence: 0.52)
 - Token cost: 0 input · 0 output
 
 ## Graph Freshness
-- Built from commit: `e56d227f`
+- Built from commit: `4611dbc2`
 - Run `git rev-parse HEAD` and compare to check if the graph is stale.
 - Run `graphify update .` after code changes (no API cost).
 
@@ -125,38 +125,43 @@
 - [[_COMMUNITY_apply_pl_scope|apply_pl_scope]]
 - [[_COMMUNITY_statistics.py|statistics.py]]
 - [[_COMMUNITY_test_pl_plan_stop_rules.py|test_pl_plan_stop_rules.py]]
-- [[_COMMUNITY_run_auto_generate_monthly_plans|run_auto_generate_monthly_plans]]
 - [[_COMMUNITY_merge_duplicate_crm_customers.py|merge_duplicate_crm_customers.py]]
 - [[_COMMUNITY_dict_type.py|dict_type.py]]
 - [[_COMMUNITY_dept.py|dept.py]]
 - [[_COMMUNITY_site.py|site.py]]
 - [[_COMMUNITY_Community 116|Community 116]]
+- [[_COMMUNITY_pl_plan_list_attachments.py|pl_plan_list_attachments.py]]
 - [[_COMMUNITY_Community 118|Community 118]]
 - [[_COMMUNITY_Community 119|Community 119]]
-- [[_COMMUNITY_oper_log_decorator.py|oper_log_decorator.py]]
-- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
 - [[_COMMUNITY_post.py|post.py]]
 - [[_COMMUNITY_customer_options|customer_options]]
 - [[_COMMUNITY_LocalStorage|LocalStorage]]
 - [[_COMMUNITY_ethnic.py|ethnic.py]]
+- [[_COMMUNITY_oper_log.py|oper_log.py]]
+- [[_COMMUNITY_Any|Any]]
+- [[_COMMUNITY_api_crypto.py|api_crypto.py]]
 - [[_COMMUNITY_BaseStorage|BaseStorage]]
 - [[_COMMUNITY__filter_export_rows_by_ids|_filter_export_rows_by_ids]]
 - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
 - [[_COMMUNITY_inventory_id.py|inventory_id.py]]
 - [[_COMMUNITY_list_contacts|list_contacts]]
 - [[_COMMUNITY_get_db_current_user_optional|get_db_current_user_optional]]
+- [[_COMMUNITY_iter_user_menu_perm_codes|iter_user_menu_perm_codes]]
 - [[_COMMUNITY_Community 138|Community 138]]
 - [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
-- [[_COMMUNITY_UserRole|UserRole]]
 - [[_COMMUNITY_clear_pl_plan_instance_data.py|clear_pl_plan_instance_data.py]]
+- [[_COMMUNITY_calc_age_from_chinese_id_card|calc_age_from_chinese_id_card]]
+- [[_COMMUNITY_response.py|response.py]]
 - [[_COMMUNITY_duty_schedule.py|duty_schedule.py]]
-- [[_COMMUNITY_duty.py|duty.py]]
 - [[_COMMUNITY_Community 147|Community 147]]
+- [[_COMMUNITY_list_product_options|list_product_options]]
+- [[_COMMUNITY_get_db_current_user_optional|get_db_current_user_optional]]
 - [[_COMMUNITY_Community 151|Community 151]]
-- [[_COMMUNITY_customer_options|customer_options]]
 - [[_COMMUNITY_pl_feedback_brand_qty.py|pl_feedback_brand_qty.py]]
 - [[_COMMUNITY_LocalStorage|LocalStorage]]
 - [[_COMMUNITY_WechatMessageService|WechatMessageService]]
+- [[_COMMUNITY__map_role_name_to_web|_map_role_name_to_web]]
+- [[_COMMUNITY_DutyDaySaveBody|DutyDaySaveBody]]
 - [[_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)]]
@@ -182,16 +187,16 @@
 - [[_COMMUNITY_PlanResourceSnapshotMixin|PlanResourceSnapshotMixin]]
 
 ## God Nodes (most connected - your core abstractions)
-1. `BaseModel` - 528 edges
-2. `get_tenant_no()` - 384 edges
-3. `DbUserContext` - 308 edges
+1. `BaseModel` - 529 edges
+2. `get_tenant_no()` - 385 edges
+3. `DbUserContext` - 309 edges
 4. `success_response()` - 279 edges
 5. `error_response()` - 274 edges
-6. `generate_uuid()` - 212 edges
+6. `generate_uuid()` - 215 edges
 7. `BxUserContext` - 204 edges
 8. `crm_user_info()` - 138 edges
-9. `ExportValidationError` - 108 edges
-10. `PlPlan` - 106 edges
+9. `PlPlan` - 110 edges
+10. `ExportValidationError` - 108 edges
 
 ## Surprising Connections (you probably didn't know these)
 - `BackfillRule` --uses--> `Settings`  [INFERRED]
@@ -208,111 +213,111 @@
 ## Import Cycles
 - None detected.
 
-## Communities (175 total, 15 thin omitted)
+## Communities (180 total, 15 thin omitted)
 
 ### Community 0 - "Community 0"
-Cohesion: 0.05
-Nodes (101): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract(), create_plan(), _determine_plan_type() (+93 more)
+Cohesion: 0.04
+Nodes (104): archive_plan(), _build_driver_url(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract(), create_plan(), delete_plan() (+96 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.20
-Nodes (19): allocate_reimburse_title_seq(), format_reimburse_title(), generate_title(), is_auto_reimburse_title(), parse_optional_date(), parse_reimburse_date(), preview_reimburse_title_seq(), date (+11 more)
+Cohesion: 0.13
+Nodes (23): _alias_row_to_dict(), _brand_row_to_dict(), _build_category_tree(), _category_row_to_dict(), _collect_category_with_ancestors(), get_product_by_no(), list_categories(), list_category_tree() (+15 more)
 
 ### Community 3 - "Community 3"
 Cohesion: 0.06
-Nodes (98): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+90 more)
+Nodes (86): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+78 more)
 
 ### Community 4 - "Community 4"
 Cohesion: 0.09
-Nodes (75): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+67 more)
+Nodes (76): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+68 more)
 
 ### Community 5 - "Community 5"
 Cohesion: 0.08
-Nodes (73): create_plan_full(), _generate_notify_message(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, update_plan(), PlPlan, PlPlanProduct, 计划产品明细表 pl_plan_product, PlanArchiveFreightBlock (+65 more)
+Nodes (62): PlanArchiveFreightBlock, PlanArchiveProductItem, PlanDriverFeedbackUpdateBody, PlanSiteFeedbackUpdateBody, PlanTransportCreateBlock, all_hazard_products_cert_complete(), apply_archive_brand_qtys_only(), apply_archive_freight() (+54 more)
 
 ### Community 6 - "Community 6"
-Cohesion: 0.08
-Nodes (59): customer_create(), customer_update(), follow_by_customer(), follow_detail(), convert_clue(), assign_customer(), batch_claim_customers(), check_duplicate_customer() (+51 more)
+Cohesion: 0.12
+Nodes (49): customer_create(), customer_update(), follow_by_customer(), follow_detail(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer() (+41 more)
 
 ### Community 7 - "Community 7"
-Cohesion: 0.11
-Nodes (43): Session, respond_xlsx(), approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), export_approved_by_me_reimburses() (+35 more)
+Cohesion: 0.10
+Nodes (43): approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), download_reimburse_import_template(), export_approved_by_me_reimburses(), export_my_reimburses() (+35 more)
 
 ### Community 8 - "Community 8"
-Cohesion: 0.11
-Nodes (32): approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals(), list_quote_approvals(), Any (+24 more)
+Cohesion: 0.10
+Nodes (34): can_user_approve(), 顺序审批：当前步骤 pending 且 is_current=1。      同一审批人若同时存在历史已处理记录与当前轮 pending，优先取 pending, 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 (51): 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() (+43 more)
+Nodes (49): convert_heic_to_jpeg(), 将 HEIC/HEIF 格式转换为 JPEG 格式, build_annotated_result_bytes(), build_applicant_label(), build_expense_path_labels(), build_import_template_bytes(), cell_str(), _ids_visible_in_web_tree() (+41 more)
 
 ### Community 10 - "Community 10"
-Cohesion: 0.09
-Nodes (35): export_depts(), export_menus(), export_posts(), export_tenants(), export_users(), list_tenants(), 导出职位列表（当前筛选全量，或 ids 已选）。, 导出租户列表（当前筛选全量，或 ids 已选）。 (+27 more)
+Cohesion: 0.15
+Nodes (20): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), _jwt_user_payload(), public_quote_share(), Request, Session (+12 more)
 
 ### Community 11 - "Community 11"
 Cohesion: 0.15
-Nodes (39): PlVehicleUreaApply, PlVehicleUreaDisburse, 车辆尿素申请 pl_vehicle_urea_apply, 车辆尿素发放登记 pl_vehicle_urea_disburse, Decimal, VehicleUreaApplyCreate, VehicleUreaApplyRead, VehicleUreaApplyUpdate (+31 more)
+Nodes (40): PlVehicleUreaApply, PlVehicleUreaDisburse, 车辆尿素申请 pl_vehicle_urea_apply, 车辆尿素发放登记 pl_vehicle_urea_disburse, Decimal, VehicleUreaApplyCreate, VehicleUreaApplyRead, VehicleUreaApplyUpdate (+32 more)
 
 ### Community 12 - "Community 12"
-Cohesion: 0.07
-Nodes (45): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+37 more)
+Cohesion: 0.05
+Nodes (74): contact_add(), contact_delete(), contact_update(), customer_delete(), BaseModel, AttachmentUploadResponse, ChangePasswordRequest, Config (+66 more)
 
 ### Community 13 - "Community 13"
 Cohesion: 0.11
-Nodes (43): parse_date_str(), apply_stop_dibang_options(), _create_db_inventory(), _create_db_plan(), _delivery_stop_products(), DibangInventoryLinkResult, _direction_to_business_type(), find_monthly_db_plan() (+35 more)
+Nodes (56): PlPlan, PlPlanProduct, PlTransportDbLink, 计划产品明细表 pl_plan_product, 运输-地磅出入库关联 pl_transport_db_link, _apply_plan_quantity_delta(), apply_stop_dibang_options(), _create_db_inventory() (+48 more)
 
 ### Community 14 - "Community 14"
-Cohesion: 0.09
-Nodes (36): approve_carrier(), create_carrier(), get_carrier(), update_carrier(), PlCarrier, carrier_to_read(), CarrierBase, CarrierCreate (+28 more)
+Cohesion: 0.10
+Nodes (32): approve_carrier(), create_carrier(), get_carrier(), list_carriers(), reject_carrier(), update_carrier(), carrier_to_read(), CarrierAuditReject (+24 more)
 
 ### Community 15 - "Community 15"
-Cohesion: 0.11
-Nodes (15): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseApplyOut, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn, Any (+7 more)
+Cohesion: 0.07
+Nodes (38): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, BxReimburseInvoice, BxReimburseOffset, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseDetailOut (+30 more)
 
 ### Community 16 - "Community 16"
 Cohesion: 0.04
-Nodes (127): clue_export(), clue_import(), clue_list(), clue_mine(), clue_to_follow(), clue_today_new(), contact_birthday(), contact_decision() (+119 more)
+Nodes (167): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export(), clue_follow_statistics(), clue_import(), clue_list(), clue_mine() (+159 more)
 
 ### Community 17 - "Community 17"
-Cohesion: 0.12
-Nodes (46): bind_vehicle_driver(), CarrierExportBody, create_driver(), create_personnel(), delete_driver(), delete_personnel(), DriverExportBody, export_carriers() (+38 more)
+Cohesion: 0.13
+Nodes (45): bind_vehicle_driver(), CarrierExportBody, create_driver(), create_personnel(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle() (+37 more)
 
 ### Community 18 - "Community 18"
-Cohesion: 0.12
-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)
+Cohesion: 0.10
+Nodes (48): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+40 more)
 
 ### Community 19 - "Community 19"
-Cohesion: 0.10
-Nodes (29): create_vehicle(), export_vehicles(), get_vehicle(), list_vehicles(), 导出车辆列表（当前筛选全量，或 ids 已选）。, update_vehicle(), _vehicle_to_detail(), _vehicle_to_read() (+21 more)
+Cohesion: 0.20
+Nodes (21): generate_uuid(), VehiclePersonnelRow, ConflictAction, PastePersonnelIn, PasteVehicleIn, 运输计划 - 三方粘贴识别提交 Schema, commit_paste_recognize(), _conflict_map() (+13 more)
 
 ### Community 20 - "Community 20"
-Cohesion: 0.16
-Nodes (33): dump_export_row(), issue_status_label(), Any, status_label(), advance_issue_stats(), batch_offset(), export_advance_issues(), export_advance_issues_xlsx() (+25 more)
+Cohesion: 0.14
+Nodes (35): advance_issue_stats(), batch_offset(), export_advance_issues(), export_advance_issues_xlsx(), export_pending_payments(), export_processed_payments(), issue_advance(), list_advance_issues() (+27 more)
 
 ### Community 21 - "Community 21"
-Cohesion: 0.13
-Nodes (44): create_apply(), create_record(), update_apply(), PlVehicleRechargeApply, PlVehicleRechargeRecord, 车辆ETC/加油充值申请 pl_vehicle_recharge_apply, 车辆ETC/加油充值发放登记 pl_vehicle_recharge_record, Decimal (+36 more)
+Cohesion: 0.12
+Nodes (45): create_apply(), create_record(), update_apply(), update_record(), PlVehicleRechargeApply, PlVehicleRechargeRecord, 车辆ETC/加油充值申请 pl_vehicle_recharge_apply, 车辆ETC/加油充值发放登记 pl_vehicle_recharge_record (+37 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.14
-Nodes (26): load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。, 软删旧品牌量行后按归档结果插入；无品牌约定则只软删不插入。, validate_brand_qty_rows() (+18 more)
+Cohesion: 0.12
+Nodes (35): PlPlanProductBrandQty, 计划产品归档品牌数量 pl_plan_product_brand_qty      stop_product_id 为空：计划产品级汇总；非空：装货/送货段产品, _is_plan_level_row(), load_brand_qtys_by_plan_product_ids(), load_brand_qtys_by_stop_product_ids(), _parse_unit_price(), persist_plan_product_brand_qtys(), persist_stop_product_brand_qtys() (+27 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)
+Cohesion: 0.21
+Nodes (14): Java: viewByShareCode, list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析（替代 Hutool UserAgentUtil） (+6 more)
 
 ### Community 26 - "Community 26"
 Cohesion: 0.18
@@ -323,128 +328,128 @@ 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 28 - "Community 28"
-Cohesion: 0.05
-Nodes (96): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), _generate_settlement_no(), get_settlement(), get_settlement_approval_flow() (+88 more)
+Cohesion: 0.06
+Nodes (96): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_unsettled_plans(), _generate_settlement_no(), get_settlement() (+88 more)
 
 ### Community 29 - "Community 29"
-Cohesion: 0.07
-Nodes (70): CrmProductBrand, PlPlanDelivery, PlPlanDeliveryProduct, PlPlanLoad, PlPlanLoadProduct, PlTransportDriverStopFeedback, PlTransportSiteStopFeedback, 运输计划-装货段 pl_plan_load（plan 1:1） (+62 more)
+Cohesion: 0.10
+Nodes (36): PlPlanDelivery, PlPlanDeliveryProduct, PlPlanLoad, PlPlanLoadProduct, 运输计划-装货段 pl_plan_load（plan 1:1）, 运输计划-装货段产品明细 pl_plan_load_product, 运输计划-送货段 pl_plan_delivery（plan 1:N）, 运输计划-送货段产品明细 pl_plan_delivery_product (+28 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.17
-Nodes (24): PlanContractGapRead, build_plan_contract_gap_read(), compute_contract_gap_sides(), _demander_gap_expr(), list_plan_contract_gaps(), _load_products_by_plan_ids(), plan_has_contract_gap_exists(), date (+16 more)
+Cohesion: 0.16
+Nodes (33): put_plan_side_contracts(), put_plan_stop_contracts(), PlanContractGapRead, PlanContractLink, PlanProductRead, is_internal_customer_name(), build_plan_contract_gap_read(), _clear_legacy_side_contracts() (+25 more)
 
 ### Community 32 - "Community 32"
 Cohesion: 0.16
 Nodes (25): change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user(), list_user_ids_bound_to_post(), list_users() (+17 more)
 
 ### Community 33 - "Community 33"
-Cohesion: 0.14
-Nodes (11): BxAdvanceApply, BxAdvanceApproval, AdvanceService, Any, Session, 同一节点多次审批时，取 approval_time 最新的一条作为当前节点状态。, 返回全部审批动作，按时间正序排列，用于展示完整审批历史。, Any (+3 more)
+Cohesion: 0.23
+Nodes (19): contact_by_customer(), contact_detail(), contact_set_primary(), create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any (+11 more)
 
 ### Community 34 - "Community 34"
-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.08
+Nodes (36): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+28 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.09
-Nodes (56): _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() (+48 more)
+Cohesion: 0.17
+Nodes (29): _assert_brand_deletable(), barcode_exists(), category_code_exists(), create_category(), create_product(), generate_auto_product_no(), generate_barcode(), generate_product_no() (+21 more)
 
 ### Community 37 - "Community 37"
-Cohesion: 0.16
-Nodes (32): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+24 more)
+Cohesion: 0.10
+Nodes (48): check_document_expiry(), document_reminder_stats(), export_document_reminders(), export_inventory_ledger(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions() (+40 more)
 
 ### Community 38 - "Community 38"
 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.20
-Nodes (15): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+7 more)
+Cohesion: 0.10
+Nodes (28): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+20 more)
 
 ### Community 40 - "Community 40"
-Cohesion: 0.09
-Nodes (37): build_dict_value_from_label(), ensure_dict_data(), format_hhmm(), format_time_label(), grab(), list_duty_staff_users(), normalize_person_name(), _pad_hhmm() (+29 more)
+Cohesion: 0.05
+Nodes (89): generate_id(), camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, DutyAssignment (+81 more)
 
 ### Community 41 - "Community 41"
-Cohesion: 0.15
-Nodes (39): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+31 more)
+Cohesion: 0.16
+Nodes (36): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+28 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.14
-Nodes (24): create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request (+16 more)
+Cohesion: 0.09
+Nodes (35): create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request (+27 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.25
-Nodes (55): AttachmentDownloadUrlBody, demo_xlsx_export(), DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody (+47 more)
+Cohesion: 0.30
+Nodes (48): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+40 more)
 
 ### Community 46 - "Community 46"
-Cohesion: 0.35
-Nodes (12): ConflictAction, PastePersonnelIn, PasteVehicleIn, 运输计划 - 三方粘贴识别提交 Schema, commit_paste_recognize(), _conflict_map(), _find_personnel_by_id_card(), _find_vehicle_by_plate() (+4 more)
+Cohesion: 0.15
+Nodes (39): PlTransportDriverStopFeedback, PlTransportSiteStopFeedback, 运输单-司机按段附件回传 pl_transport_driver_stop_feedback, 运输单-现场按段回传 pl_transport_site_stop_feedback, _direction_label(), _dump_product_feedbacks(), _dump_urls(), _get_driver_feedback_row() (+31 more)
 
 ### Community 47 - "Community 47"
-Cohesion: 0.17
-Nodes (28): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+20 more)
+Cohesion: 0.10
+Nodes (19): 供方全量列表（下拉）— Java: CrmSupplierInfoController.listAll, 供方详情 — Java: CrmSupplierInfoController.getInfo, 新增供方 — Java: CrmSupplierInfoController.add, 修改供方 — Java: CrmSupplierInfoController.edit, 删除供方 — Java: CrmSupplierInfoController.remove, 导出供方列表 — Java: CrmSupplierInfoController.export, supplier_info_add(), supplier_info_delete() (+11 more)
 
 ### Community 48 - "Community 48"
-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.09
+Nodes (65): 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() (+57 more)
 
 ### Community 49 - "Community 49"
-Cohesion: 0.14
-Nodes (20): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+12 more)
+Cohesion: 0.21
+Nodes (19): cancel_apply(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply(), get_record(), list_applies() (+11 more)
 
 ### Community 50 - "Community 50"
-Cohesion: 0.15
-Nodes (17): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), CrmCustomerPool, check_customer_protect_time() (+9 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 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.13
-Nodes (25): 报销模块认证适配：门户 JWT 用户 → bx 业务上下文。, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时，进度接口仅展示当前轮次。, 审批进度仅展示当前轮次；完整历史由 get_approval_history 返回。 (+17 more)
+Cohesion: 0.18
+Nodes (17): _build_quote_filters(), _decimal_value(), _fill_contract_linked_count(), list_quotes(), _parse_optional_datetime(), _period_key(), Any, datetime (+9 more)
 
 ### Community 53 - "Community 53"
 Cohesion: 0.20
 Nodes (7): _FakeQuery, _FakeSession, _plan(), 现场链接生成条件：装货/送货段含山峡或云栋客户, test_external_stops_do_not_require_site_link(), test_internal_delivery_requires_site_link(), test_legacy_plan_customer_fallback()
 
 ### Community 54 - "Community 54"
-Cohesion: 0.13
-Nodes (44): get_plan_related(), PlanRelatedData, _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing() (+36 more)
+Cohesion: 0.28
+Nodes (14): DeliverySlipPrintRead, build_delivery_slip_print(), _customer_key(), _delivery_matches_customer(), get_delivery_slip_print_context(), list_delivery_print_customers(), _merge_stop_products(), Session (+6 more)
 
 ### Community 55 - "Community 55"
 Cohesion: 0.07
-Nodes (39): API 路由包 — 山峡化工生产一体化门户, export_leaves(), _leave_local_callback(), LeaveExportBody, list_leaves(), 导出请假列表（当前筛选全量，或 ids 已选）。, get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单） (+31 more)
+Nodes (39): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+31 more)
 
 ### Community 56 - "Community 56"
-Cohesion: 0.07
-Nodes (78): _as_date(), _build_driver_url(), _build_history_stop_reads(), _build_public_page(), _build_stop_product_reads(), _format_file_size(), _format_plan_date(), get_public_transport() (+70 more)
+Cohesion: 0.05
+Nodes (99): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+91 more)
 
 ### Community 57 - "Community 57"
 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 58 - "Community 58"
-Cohesion: 0.16
-Nodes (33): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), _enrich_change_rows(), execute_change(), export_contract_changes(), export_contract_templates() (+25 more)
+Cohesion: 0.14
+Nodes (22): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+14 more)
 
 ### Community 59 - "Community 59"
 Cohesion: 0.20
@@ -455,48 +460,48 @@ 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.09
-Nodes (59): PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, DeliveryPrintCustomerOption, PlanContractLink, PlanDeliveryBody, PlanDeliveryRead, PlanLoadBody, PlanLoadRead (+51 more)
+Cohesion: 0.11
+Nodes (45): create_plan_full(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, update_plan(), PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, PlanDeliveryBody, PlanLoadBody, PlanStopProductBody (+37 more)
 
 ### Community 62 - "Community 62"
-Cohesion: 0.10
-Nodes (68): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+60 more)
+Cohesion: 0.12
+Nodes (52): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), calculate_quote_amount(), create_new_version(), create_quote(), _enrich_contact_fields(), _enrich_supplier_name() (+44 more)
 
 ### Community 63 - "Community 63"
-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)
+Cohesion: 0.12
+Nodes (38): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), create_contract_template(), _enrich_change_rows(), execute_change(), export_contract_changes() (+30 more)
 
 ### Community 64 - "Community 64"
 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 65 - "Community 65"
-Cohesion: 0.18
-Nodes (36): PlVehicleMaintenanceApply, PlVehicleMaintenanceProcess, 车辆维保申请 pl_vehicle_maintenance_apply, 车辆维保处理登记 pl_vehicle_maintenance_process, VehicleMaintenanceApplyCreate, VehicleMaintenanceApplyRead, VehicleMaintenanceApplyUpdate, VehicleMaintenanceProcessBoardItem (+28 more)
+Cohesion: 0.15
+Nodes (42): PlVehicleMaintenanceApply, PlVehicleMaintenanceProcess, 车辆维保申请 pl_vehicle_maintenance_apply, 车辆维保处理登记 pl_vehicle_maintenance_process, Decimal, VehicleMaintenanceApplyCreate, VehicleMaintenanceApplyRead, VehicleMaintenanceApplyReminder (+34 more)
 
 ### Community 66 - "Community 66"
-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)
+Cohesion: 0.09
+Nodes (34): API 路由包 — 山峡化工生产一体化门户, create_leave(), delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody (+26 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.18
-Nodes (24): delete_plan(), delete_carrier(), delete_vehicle(), unbind_vehicle_driver(), delete_plan(), _actor_ids(), _actor_names(), assert_row_deletable_by_creator() (+16 more)
+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.33
-Nodes (8): allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session, 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。     须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, BizNoKind
+Cohesion: 0.07
+Nodes (63): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def(), _enrich_task_list(), export_completed_tasks() (+55 more)
 
 ### Community 70 - "Community 70"
 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 71 - "Community 71"
-Cohesion: 0.16
-Nodes (24): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_process_board(), get_apply(), get_process() (+16 more)
+Cohesion: 0.04
+Nodes (75): category_add(), category_delete(), category_tree(), category_update(), clue_assign(), clue_convert(), clue_create(), clue_delete() (+67 more)
 
 ### Community 72 - "Community 72"
 Cohesion: 0.25
@@ -507,56 +512,56 @@ 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.13
-Nodes (28): 地磅 API 路由聚合 — REST 风格，协议对齐原 simple-dibang-xiaoshou。, _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), export_plans(), get_plan(), _get_plan_by_id_only() (+20 more)
+Cohesion: 0.06
+Nodes (110): 地磅 API 路由聚合 — REST 风格，协议对齐原 simple-dibang-xiaoshou。, _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), _generate_batch_no() (+102 more)
 
 ### Community 75 - "apply_crm_create_by_scope"
-Cohesion: 0.24
-Nodes (13): BxInvoiceLedger, BxInvoiceWalletSummary, InvoiceLedgerService, Any, Decimal, Session, should_skip_release(), summarize_entries() (+5 more)
+Cohesion: 0.14
+Nodes (29): menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult, cancel_apply(), create_apply() (+21 more)
 
 ### Community 76 - "opportunity_follow.py"
-Cohesion: 0.08
-Nodes (50): operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session, 导出操作日志（当前筛选全量，或 ids 已选）。, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info() (+42 more)
+Cohesion: 0.15
+Nodes (25): _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 (+17 more)
 
 ### 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.04
-Nodes (102): category_add(), category_delete(), category_tree(), category_update(), clue_import_template(), contact_add(), contact_by_customer(), contact_delete() (+94 more)
+Cohesion: 0.18
+Nodes (21): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+13 more)
 
 ### Community 79 - "PlCarrier"
-Cohesion: 0.31
-Nodes (14): create_pool_rule(), delete_pool_rules(), execute_pool_rules(), _execute_single_rule(), get_pool_rule(), list_pool_rules(), Any, Session (+6 more)
+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)
 
 ### Community 81 - "customer_follow.py"
-Cohesion: 0.19
-Nodes (20): statistics_follow(), statistics_industry(), statistics_level(), statistics_overview(), statistics_owner(), statistics_source(), statistics_trend(), _customer_base_query() (+12 more)
+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 82 - "list_duty_staff_users"
-Cohesion: 0.33
-Nodes (13): apply_pl_scope(), Session, PL 模块数据权限辅助（create_by / create_dept_id，无 owner_field）。, build_menu_badge_counts(), count_document_reminder_expired_pending(), count_freight_approval_pending(), count_freight_disburse_pending(), _count_pending_applies() (+5 more)
+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 83 - "Community 83"
-Cohesion: 0.14
-Nodes (32): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+24 more)
+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(), create_approval_records() (+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.06
-Nodes (69): clue_assign(), clue_check_convert(), clue_check_duplicate(), clue_convert(), clue_create(), clue_delete(), clue_detail(), clue_follow_create() (+61 more)
+Cohesion: 0.13
+Nodes (42): clue_follow_detail(), assign_clues(), check_convert(), check_duplicate_clue(), convert_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope() (+34 more)
 
 ### Community 86 - "Community 86"
-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)
+Cohesion: 0.10
+Nodes (37): align_contract_no_to_sign_date(), contract_no_exists(), create_contract(), create_from_opportunity(), create_from_quote(), generate_contract_no(), _get_field(), is_framework_contract_type() (+29 more)
 
 ### Community 87 - "Community 87"
-Cohesion: 0.29
-Nodes (16): ensure_crm_customer_linked_row_in_scope(), ensure_crm_owner_row_in_scope(), Session, CRM 数据权限辅助（负责人 owner_user_id + 标准 create_by/create_dept_id）。, 客户子表（开票信息等）：先校验关联客户 owner scope，否则校验 create_by。, _clear_default_for_customer(), create_invoice_info(), get_invoice_info() (+8 more)
+Cohesion: 0.14
+Nodes (27): 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(), 按客户ID查询开票信息（与 by-customer 等价） (+19 more)
 
 ### Community 88 - "CrmProduct"
 Cohesion: 0.23
@@ -567,88 +572,84 @@ 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.21
-Nodes (17): apply_crm_create_by_scope(), _apply_list_filters(), create_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+9 more)
+Cohesion: 0.17
+Nodes (21): apply_crm_create_by_scope(), ensure_crm_create_by_row_in_scope(), ensure_crm_owner_row_in_scope(), Session, CRM 数据权限辅助（负责人 owner_user_id + 标准 create_by/create_dept_id）。, _apply_list_filters(), create_supplier_info(), list_all_supplier_info() (+13 more)
 
 ### Community 91 - "unsettled_plans_q_filter"
 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)
+Cohesion: 0.28
+Nodes (14): _assert_users_exist(), get_setting(), join_approver_ids(), parse_approver_ids(), prefill_approver_ids(), Any, Session, 返回可预填的审批人 ID 列表；不可用则空列表。 (+6 more)
 
 ### Community 93 - "api_request_log_middleware.py"
-Cohesion: 0.07
-Nodes (45): DocumentReminderExportBody, InventoryLedgerExportBody, ApiRequestLogCRUD, Session, list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic） (+37 more)
+Cohesion: 0.57
+Nodes (7): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), CrmContractApproverSetting
 
 ### 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.38
+Cohesion: 0.30
 Nodes (14): _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 (+6 more)
 
 ### Community 96 - "minio_url.py"
-Cohesion: 0.23
-Nodes (14): _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj(), _schedule_persist_log() (+6 more)
+Cohesion: 0.05
+Nodes (64): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+56 more)
 
 ### Community 97 - "contact.py"
-Cohesion: 0.24
-Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType
+Cohesion: 0.36
+Nodes (7): list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), 民族码表 sys_ethnic（国标 GB/T 3304，全局）, SysEthnic
 
 ### 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.16
-Nodes (21): PlCert, PlDocumentReminder, 证件到期提醒表 pl_document_reminder, CertRead, SnapshotCertRead, certs_to_read(), list_owner_certs(), list_owner_certs_batch() (+13 more)
+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 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.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.24
+Nodes (13): get_product(), soft_delete_product(), assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed(), Any, Session (+5 more)
 
 ### Community 102 - "BaseStorage"
-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)
+Cohesion: 0.43
+Nodes (5): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, test_calc_age_from_18_digit_id(), test_calc_age_rejects_invalid()
 
 ### Community 103 - "pl_internal_customer.py"
-Cohesion: 0.24
-Nodes (12): _apply_plan_product_update(), apply_product_snapshot_to_plan(), apply_product_snapshot_to_weighing(), ProductSnapshot, Session, 地磅模块 — CRM 产品解析与快照写入。, 校验 CRM 产品并返回名称/规格快照。新建单据 product_id 必填。      require_on_shelf=False 用于运输计划联动地磅等历, resolve_crm_product() (+4 more)
+Cohesion: 0.40
+Nodes (3): Any, 供 get_tenant_no 等门户工具使用。, 与门户 JWT / apply_data_scope 所需的 user_info 字段对齐。
 
 ### 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.67
 Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析：前端 date-picker 仅传 YYYY-MM-DD。
 
 ### Community 106 - "site.py"
-Cohesion: 0.38
-Nodes (10): generate_uuid(), create_oss(), create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId (+2 more)
+Cohesion: 0.40
+Nodes (9): create_oss(), create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId, resolve_storage_path() (+1 more)
 
 ### Community 107 - "apply_pl_scope"
-Cohesion: 0.08
-Nodes (58): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), _enrich_task_list(), export_completed_tasks(), export_my_instances() (+50 more)
+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 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 - "test_pl_plan_stop_rules.py"
-Cohesion: 0.14
-Nodes (25): _extract_qty(), _fmt_qty(), Any, Decimal, 运输计划多段：内部客户地磅默认值与数量平衡校验, resolve_stop_dibang_defaults(), _sum_qty(), warn_qty_imbalance() (+17 more)
-
-### Community 111 - "run_auto_generate_monthly_plans"
-Cohesion: 0.27
-Nodes (11): _generate_plan_no(), 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() (+3 more)
+Cohesion: 0.12
+Nodes (28): _extract_qty(), _fmt_qty(), Any, Decimal, 运输计划多段：内部客户地磅默认值与数量平衡校验, 地磅默认勾选以装货客户是否为内部客户为准。, resolve_stop_dibang_defaults(), _sum_qty() (+20 more)
 
 ### Community 112 - "merge_duplicate_crm_customers.py"
 Cohesion: 0.26
@@ -663,44 +664,52 @@ 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 115 - "site.py"
-Cohesion: 0.11
-Nodes (18): ApiCryptoMiddleware, ApiRequestLogMiddleware, _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误 (+10 more)
+Cohesion: 0.25
+Nodes (9): _error_json(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, sqlalchemy_exception_handler(), unhandled_exception_handler(), JSONResponse (+1 more)
 
 ### Community 116 - "Community 116"
-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)
+Cohesion: 0.20
+Nodes (25): calculate_subtotal(), _decimal_value(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_products_by_quote_ids(), list_quote_products() (+17 more)
+
+### Community 117 - "pl_plan_list_attachments.py"
+Cohesion: 0.26
+Nodes (12): load_plan_document_attachments_by_plan_ids(), _parse_image_urls(), Session, 运输计划列表：聚合司机/现场/出入库现场等单据附件。, _short_label(), _stop_sort_key(), _stop_source_label(), test_parse_image_urls_csv() (+4 more)
 
 ### Community 118 - "Community 118"
-Cohesion: 0.18
-Nodes (25): 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() (+17 more)
+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 (38): CertRow, VehiclePersonnelRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), is_huolala_trailer_no(), match_required_cert_name() (+30 more)
-
-### Community 120 - "oper_log_decorator.py"
-Cohesion: 0.16
-Nodes (25): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), DbInboundOutbound, DbPurchasePlan, 地磅（db）模块数据模型 — 对齐 docs/sql/db_tables.sql (+17 more)
-
-### Community 121 - "customer_follow.py"
-Cohesion: 0.07
-Nodes (49): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+41 more)
+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 122 - "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 123 - "customer_options"
-Cohesion: 0.06
-Nodes (61): CRM 报价单 API 路由 — 挂接到 crm.router, RecognizeCertResult, PageResult, ResponseModel, BaseModel, PagedQuery, PagedResponse, InvoiceAttachmentOut (+53 more)
+Cohesion: 0.11
+Nodes (32): CRM 报价单 API 路由 — 挂接到 crm.router, QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody, QuoteCreateBody (+24 more)
 
 ### Community 124 - "LocalStorage"
 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 125 - "ethnic.py"
-Cohesion: 0.04
-Nodes (99): _build_driver_url(), get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label() (+91 more)
+Cohesion: 0.07
+Nodes (59): _make_handlers(), PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, _dict_field(), format_brand_qty_summary(), load_transport_driver_product_feedbacks(), persist_io_item_brand_qtys(), persist_transport_product_feedback() (+51 more)
+
+### Community 126 - "oper_log.py"
+Cohesion: 0.28
+Nodes (8): list_products(), 分页查询产品列表      keyword 默认匹配：名称 / 编号 / 拼音首字母。     选择器场景可关闭编号匹配、开启规格型号匹配（避免短数字误命中产品, 产品/客户列表 keyword：名称/编号/拼音首字母 OR 匹配。, 选择器：名称/拼音/规格型号，不匹配产品编号。, test_list_customer_options_keyword_includes_name_and_pinyin(), test_list_customers_keyword_includes_name_and_pinyin(), test_list_products_keyword_includes_name_and_pinyin(), test_list_products_keyword_selector_mode_excludes_product_no_includes_model()
+
+### Community 127 - "Any"
+Cohesion: 0.10
+Nodes (46): PlanDeliveryRead, PlanLoadRead, PlanStopProductRead, _append_legacy_plan_product_rows(), _append_stop_product_rows(), build_plan_archive_export_rows(), _empty_product_fields(), _format_date_value() (+38 more)
+
+### Community 128 - "api_crypto.py"
+Cohesion: 0.47
+Nodes (3): get_current_time(), parse_datetime(), datetime
 
 ### Community 129 - "BaseStorage"
 Cohesion: 0.12
@@ -711,76 +720,92 @@ 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 131 - "resolve_crm_product"
-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)
+Cohesion: 0.49
+Nodes (10): clue_statistics_level(), _apply_create_range(), _base_query(), get_clue_level_statistics(), get_clue_overview_statistics(), get_clue_owner_statistics(), get_clue_source_statistics(), get_clue_trend_statistics() (+2 more)
 
 ### Community 133 - "inventory_id.py"
-Cohesion: 0.18
-Nodes (14): get_current_time(), parse_datetime(), datetime, DbSequence, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id() (+6 more)
+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 - "list_contacts"
-Cohesion: 0.22
-Nodes (3): BaseStorage, 带下载文件名的访问 URL；默认实现为普通访问地址。, 浏览器内联预览 URL；默认实现为普通访问地址。
+Cohesion: 0.17
+Nodes (3): BaseStorage, QiniuStorage, 浏览器内联预览 URL；默认实现为普通访问地址。
 
 ### Community 136 - "get_db_current_user_optional"
-Cohesion: 0.09
-Nodes (43): Session, recognize_cert(), RecognizeCertBody, cancel_apply(), delete_applies(), delete_records(), get_apply(), get_record() (+35 more)
+Cohesion: 0.10
+Nodes (26): export_inventory(), 导出出入库列表（当前筛选全量，或 ids 已选）。, export_plans(), 导出计划列表（当前筛选全量，或 ids 已选）。, export_weighing(), _kg_to_ton(), 导出地磅单列表（当前筛选全量，或 ids 已选）。, export_settlements() (+18 more)
+
+### Community 137 - "iter_user_menu_perm_codes"
+Cohesion: 0.21
+Nodes (16): get_web_auth_menu_codes(), 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。, _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 的角色与菜单权限解析 (+8 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 140 - "UserRole"
-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)
+Cohesion: 0.25
+Nodes (13): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage，对外保持 bx 协议。 (+5 more)
 
 ### Community 142 - "clear_pl_plan_instance_data.py"
 Cohesion: 0.46
 Nodes (7): _count(), _delete(), _engine_from_env(), main(), Engine, 清空运输计划（pl_plan）及关联实例数据，便于测试环境重新走流程。  用法（在 backend 目录、已配置 .env DATABASE_URL）：   p, _table_exists()
 
-### Community 145 - "duty_schedule.py"
-Cohesion: 0.17
-Nodes (33): 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() (+25 more)
-
-### Community 146 - "duty.py"
+### Community 143 - "calc_age_from_chinese_id_card"
 Cohesion: 0.19
-Nodes (16): _enrich_assign_names(), 指定用户时补全 personName（用 nick_name）。, save_day(), DutyAssignmentIn, DutyDaySaveBody, DutyDictEnsureBody, DutyLinkBody, DutySlotSaveIn (+8 more)
+Nodes (23): create_vehicle(), get_vehicle(), list_personnel(), list_vehicles(), update_vehicle(), _vehicle_to_detail(), _vehicle_to_read(), PlCert (+15 more)
+
+### Community 144 - "response.py"
+Cohesion: 0.12
+Nodes (27): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+19 more)
+
+### Community 145 - "duty_schedule.py"
+Cohesion: 0.67
+Nodes (3): list_product_options(), 产品下拉 options：keyword 按产品名称/拼音首字母模糊匹配，不匹配产品编号。, test_list_product_options_keyword_only_filters_product_name()
 
 ### 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 152 - "customer_options"
-Cohesion: 0.50
-Nodes (4): customer_options(), 客户下拉选项（租户内只读，不做 owner 数据权限）, CustomerOptionsBody, 客户下拉选项请求体（租户内只读搜索，不做 owner 数据权限）
+### Community 149 - "list_product_options"
+Cohesion: 0.13
+Nodes (19): 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() (+11 more)
+
+### Community 150 - "get_db_current_user_optional"
+Cohesion: 0.08
+Nodes (42): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_update(), pool_rule_update_status(), get_pool_record(), list_pool_records() (+34 more)
 
 ### Community 153 - "pl_feedback_brand_qty.py"
-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)
+Cohesion: 0.09
+Nodes (40): DocumentReminderExportBody, InventoryLedgerExportBody, ContractGapExportBody, PlanExportBody, TransportExportBody, SoftDeleteModel, BizAttachment, PlDocumentReminder (+32 more)
 
 ### Community 154 - "LocalStorage"
-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
+Cohesion: 0.15
+Nodes (4): OSSStorage, process_image_content(), 带下载文件名的访问 URL；默认实现为普通访问地址。, 处理图片内容，如果是 HEIC 格式则转换为 JPEG
 
 ### Community 155 - "WechatMessageService"
 Cohesion: 0.15
 Nodes (9): 微信消息通知服务  支持微信小程序模板消息推送  使用方式:     from app.core.wechat_message import WechatMes, 发送订单状态通知                  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_ (+1 more)
 
+### Community 156 - "_map_role_name_to_web"
+Cohesion: 0.18
+Nodes (12): logout(), 登出：吊销 Redis 会话（若已配置 REDIS_HOST）。无 Token 或已失效时仍返回成功（幂等）。, decode_token(), get_current_user(), get_current_user_by_token(), get_current_user_simple(), Session, 根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期） (+4 more)
+
+### Community 158 - "DutyDaySaveBody"
+Cohesion: 0.20
+Nodes (10): public_grab(), public_page(), Session, Config, format_api_error_message(), PageResult, Exception, 将 HTTP/SQLAlchemy 等异常转为可展示的错误文案（避免 str([]) 空列表）。 (+2 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.07
-Nodes (64): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), get_web_auth_menu_codes(), _jwt_user_payload(), logout(), public_quote_share() (+56 more)
+Cohesion: 0.19
+Nodes (19): refresh_token(), create_access_token(), create_refresh_token(), extend_session(), get_client_ip(), is_refresh_token_valid(), is_session_valid(), Request (+11 more)
 
 ### Community 173 - "resolve_create_time_bounds"
-Cohesion: 0.06
-Nodes (72): ContractGapExportBody, PlanExportBody, _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result(), _build_driver_url() (+64 more)
+Cohesion: 0.05
+Nodes (86): _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result(), _build_driver_url(), create_transport(), _ensure_driver_access_token() (+78 more)
 
 ### Community 179 - "test_pl_vehicle_personnel_photo_schema.py"
 Cohesion: 0.27
@@ -795,8 +820,8 @@ Cohesion: 0.18
 Nodes (10): 1. 创建虚拟环境, 2. 安装依赖, 3. 配置环境变量, 4. 启动服务, API 路由分组, shanxia2.0 后端骨架（FastAPI）, 开发规范, 快速开始 (+2 more)
 
 ### Community 220 - "api_crypto_middleware.py"
-Cohesion: 0.15
-Nodes (21): _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key(), Redis (+13 more)
+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 237 - "order_status_compat.py"
 Cohesion: 0.36
@@ -818,17 +843,17 @@ Nodes (6): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时
 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_
 
-- **Why does `generate_uuid()` connect `site.py` to `Community 0`, `_filter_export_rows_by_ids`, `Community 4`, `Community 5`, `inventory_id.py`, `Community 6`, `Community 8`, `Community 11`, `Community 13`, `Community 14`, `Community 15`, `Community 17`, `duty_schedule.py`, `Community 19`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `pl_feedback_brand_qty.py`, `Community 28`, `Community 29`, `Community 32`, `Community 33`, `Community 34`, `get_client_ip`, `Community 37`, `Community 36`, `Community 40`, `resolve_create_time_bounds`, `Community 46`, `Community 48`, `Community 50`, `Community 51`, `Community 52`, `Community 54`, `Community 58`, `Community 61`, `Community 62`, `Community 63`, `Community 65`, `Community 66`, `Community 67`, `Community 69`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `Community 78`, `PlCarrier`, `Community 83`, `allocate_next_biz_no`, `Community 87`, `CrmProduct`, `pl_ocr_service.py`, `WechatMessageService`, `unsettled_plans_q_filter`, `Community 92`, `api_request_log_middleware.py`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `run_auto_generate_monthly_plans`, `dict_type.py`, `dept.py`, `Community 116`, `Community 118`, `post.py`, `LocalStorage`, `ethnic.py`?**
-  _High betweenness centrality (0.151) - this node is a cross-community bridge._
-- **Why does `BaseModel` connect `customer_options` to `Community 0`, `Community 1`, `resolve_crm_product`, `Community 3`, `Community 5`, `Community 6`, `Community 7`, `get_db_current_user_optional`, `Community 10`, `Community 11`, `Community 12`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `duty.py`, `Community 20`, `Community 19`, `Community 21`, `customer_options`, `Community 28`, `Community 29`, `Community 31`, `Community 34`, `Community 37`, `Community 39`, `Community 41`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 46`, `Community 49`, `Community 51`, `Community 54`, `Community 55`, `Community 56`, `Community 58`, `Community 61`, `Community 65`, `Community 71`, `Community 74`, `opportunity_follow.py`, `Community 78`, `customer_follow.py`, `allocate_next_biz_no`, `api_request_log_middleware.py`, `test_pl_public_link_archived.py`, `redis_client.py`, `BaseStorage`, `apply_pl_scope`, `Community 119`, `customer_follow.py`, `ethnic.py`?**
-  _High betweenness centrality (0.119) - this node is a cross-community bridge._
-- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 73`, `Community 42`, `Community 59`, `statistics.py`, `Community 44`, `customer_follow.py`, `Community 26`, `Community 27`, `Community 30`, `Community 57`?**
-  _High betweenness centrality (0.119) - this node is a cross-community bridge._
+- **Why does `generate_uuid()` connect `Community 19` to `Community 0`, `api_crypto.py`, `_filter_export_rows_by_ids`, `Community 4`, `inventory_id.py`, `Community 6`, `Community 5`, `Community 8`, `Community 10`, `Community 11`, `Community 13`, `Community 14`, `calc_age_from_chinese_id_card`, `Community 15`, `Community 17`, `Community 18`, `list_product_options`, `get_db_current_user_optional`, `Community 23`, `Community 24`, `Community 25`, `Community 21`, `Community 28`, `Community 29`, `Community 31`, `Community 32`, `Community 33`, `Community 34`, `get_client_ip`, `Community 37`, `Community 36`, `Community 40`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 48`, `Community 50`, `Community 51`, `Community 61`, `Community 62`, `Community 63`, `Community 65`, `Community 67`, `Community 72`, `Community 74`, `PlCarrier`, `Community 83`, `allocate_next_biz_no`, `Community 86`, `Community 87`, `CrmProduct`, `pl_ocr_service.py`, `WechatMessageService`, `unsettled_plans_q_filter`, `Community 92`, `api_request_log_middleware.py`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `site.py`, `apply_pl_scope`, `dict_type.py`, `dept.py`, `Community 116`, `Community 118`, `post.py`, `LocalStorage`, `ethnic.py`?**
+  _High betweenness centrality (0.140) - this node is a cross-community bridge._
+- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 73`, `Community 42`, `Community 59`, `statistics.py`, `Community 44`, `Community 56`, `Community 57`, `Community 26`, `Community 27`, `Community 30`?**
+  _High betweenness centrality (0.126) - this node is a cross-community bridge._
+- **Why does `BaseModel` connect `Community 12` to `Community 0`, `Community 1`, `Community 5`, `Community 7`, `get_db_current_user_optional`, `Community 11`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `Community 19`, `Community 20`, `response.py`, `get_db_current_user_optional`, `Community 21`, `pl_feedback_brand_qty.py`, `Community 28`, `Community 29`, `DutyDaySaveBody`, `Community 31`, `Community 34`, `Community 37`, `Community 39`, `Community 40`, `Community 41`, `Community 43`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 49`, `Community 51`, `Community 54`, `Community 55`, `Community 56`, `Community 58`, `Community 61`, `Community 63`, `Community 65`, `Community 66`, `Community 69`, `Community 71`, `Community 74`, `apply_crm_create_by_scope`, `Community 78`, `Community 87`, `test_pl_public_link_archived.py`, `Community 119`, `customer_options`?**
+  _High betweenness centrality (0.109) - 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?**
-  _644 weakly-connected nodes found - possible documentation gaps or missing edges._
+  _653 weakly-connected nodes found - possible documentation gaps or missing edges._
 - **Should `Community 0` be split into smaller, more focused modules?**
-  _Cohesion score 0.04779874213836478 - nodes in this community are weakly interconnected._
+  _Cohesion score 0.044036697247706424 - 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._
+  _Cohesion score 0.07549361207897794 - nodes in this community are weakly interconnected._

backend/graphify-out/GRAPH_REPORT.md

@@ -1,16 +1,16 @@
 # Graph Report - backend  (2026-08-27)
 
 ## Corpus Check
-- 359 files · ~252,016 words
+- 361 files · ~254,633 words
 - Verdict: corpus is large enough that graph structure adds value.
 
 ## Summary
-- 5135 nodes · 19419 edges · 190 communities (174 shown, 16 thin omitted)
-- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 1003 edges (avg confidence: 0.52)
+- 5191 nodes · 19666 edges · 182 communities (166 shown, 16 thin omitted)
+- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 1009 edges (avg confidence: 0.52)
 - Token cost: 0 input · 0 output
 
 ## Graph Freshness
-- Built from commit: `e56d227f`
+- Built from commit: `4611dbc2`
 - Run `git rev-parse HEAD` and compare to check if the graph is stale.
 - Run `graphify update .` after code changes (no API cost).
 
@@ -125,8 +125,8 @@
 - [[_COMMUNITY_apply_pl_scope|apply_pl_scope]]
 - [[_COMMUNITY_statistics.py|statistics.py]]
 - [[_COMMUNITY_test_pl_plan_stop_rules.py|test_pl_plan_stop_rules.py]]
-- [[_COMMUNITY_monitor.py|monitor.py]]
-- [[_COMMUNITY_run_auto_generate_monthly_plans|run_auto_generate_monthly_plans]]
+- [[_COMMUNITY_pool_rule.py|pool_rule.py]]
+- [[_COMMUNITY_test_pl_public_transport_history.py|test_pl_public_transport_history.py]]
 - [[_COMMUNITY_merge_duplicate_crm_customers.py|merge_duplicate_crm_customers.py]]
 - [[_COMMUNITY_dict_type.py|dict_type.py]]
 - [[_COMMUNITY_dept.py|dept.py]]
@@ -135,8 +135,8 @@
 - [[_COMMUNITY_pl_plan_list_attachments.py|pl_plan_list_attachments.py]]
 - [[_COMMUNITY_Community 118|Community 118]]
 - [[_COMMUNITY_Community 119|Community 119]]
-- [[_COMMUNITY_oper_log_decorator.py|oper_log_decorator.py]]
-- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
+- [[_COMMUNITY_list_duty_staff_users|list_duty_staff_users]]
+- [[_COMMUNITY__build_user_info_payload|_build_user_info_payload]]
 - [[_COMMUNITY_post.py|post.py]]
 - [[_COMMUNITY_customer_options|customer_options]]
 - [[_COMMUNITY_LocalStorage|LocalStorage]]
@@ -147,31 +147,23 @@
 - [[_COMMUNITY_BaseStorage|BaseStorage]]
 - [[_COMMUNITY__filter_export_rows_by_ids|_filter_export_rows_by_ids]]
 - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
-- [[_COMMUNITY_list_products|list_products]]
+- [[_COMMUNITY_.to_list_kwargs|.to_list_kwargs]]
 - [[_COMMUNITY_inventory_id.py|inventory_id.py]]
 - [[_COMMUNITY_list_contacts|list_contacts]]
-- [[_COMMUNITY_customer.py|customer.py]]
 - [[_COMMUNITY_get_db_current_user_optional|get_db_current_user_optional]]
 - [[_COMMUNITY_iter_user_menu_perm_codes|iter_user_menu_perm_codes]]
 - [[_COMMUNITY_Community 138|Community 138]]
 - [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
-- [[_COMMUNITY_UserRole|UserRole]]
-- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
 - [[_COMMUNITY_clear_pl_plan_instance_data.py|clear_pl_plan_instance_data.py]]
 - [[_COMMUNITY_calc_age_from_chinese_id_card|calc_age_from_chinese_id_card]]
 - [[_COMMUNITY_response.py|response.py]]
-- [[_COMMUNITY_duty_schedule.py|duty_schedule.py]]
-- [[_COMMUNITY_duty.py|duty.py]]
 - [[_COMMUNITY_Community 147|Community 147]]
-- [[_COMMUNITY_unsettled_plans_q_filter|unsettled_plans_q_filter]]
 - [[_COMMUNITY_list_product_options|list_product_options]]
 - [[_COMMUNITY_get_db_current_user_optional|get_db_current_user_optional]]
 - [[_COMMUNITY_Community 151|Community 151]]
-- [[_COMMUNITY_customer_options|customer_options]]
 - [[_COMMUNITY_pl_feedback_brand_qty.py|pl_feedback_brand_qty.py]]
 - [[_COMMUNITY_LocalStorage|LocalStorage]]
 - [[_COMMUNITY_WechatMessageService|WechatMessageService]]
-- [[_COMMUNITY__map_role_name_to_web|_map_role_name_to_web]]
 - [[_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)]]
@@ -197,129 +189,129 @@
 - [[_COMMUNITY_PlanResourceSnapshotMixin|PlanResourceSnapshotMixin]]
 
 ## God Nodes (most connected - your core abstractions)
-1. `BaseModel` - 528 edges
-2. `get_tenant_no()` - 384 edges
-3. `DbUserContext` - 308 edges
+1. `BaseModel` - 529 edges
+2. `get_tenant_no()` - 385 edges
+3. `DbUserContext` - 309 edges
 4. `success_response()` - 279 edges
 5. `error_response()` - 274 edges
-6. `generate_uuid()` - 212 edges
+6. `generate_uuid()` - 215 edges
 7. `BxUserContext` - 204 edges
 8. `crm_user_info()` - 138 edges
-9. `ExportValidationError` - 108 edges
-10. `PlPlan` - 106 edges
+9. `PlPlan` - 110 edges
+10. `ExportValidationError` - 108 edges
 
 ## Surprising Connections (you probably didn't know these)
 - `BackfillRule` --uses--> `Settings`  [INFERRED]
   scripts/migrate_crm_sys_oss.py → app/core/config.py
+- `test_history_status_label()` --calls--> `_history_status_label()`  [EXTRACTED]
+  tests/test_pl_public_transport_history.py → app/api/pl/public_transport.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 (190 total, 16 thin omitted)
+## Communities (182 total, 16 thin omitted)
 
 ### Community 0 - "Community 0"
-Cohesion: 0.04
-Nodes (161): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), ContractGapExportBody, count_plans_by_contract(), create_from_contract(), create_plan() (+153 more)
+Cohesion: 0.05
+Nodes (90): _build_driver_url(), create_from_contract(), _determine_plan_type(), _ensure_subpack_slip_no(), export_contract_gaps(), _format_subpack_slip_no(), _generate_notify_message(), _generate_plan_no() (+82 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.18
-Nodes (22): ReimburseDetailOut, allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title(), parse_optional_date(), parse_reimburse_date() (+14 more)
+Cohesion: 0.08
+Nodes (47): 报销模块认证适配：门户 JWT 用户 → bx 业务上下文。, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, ReimburseDetailOut, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时，进度接口仅展示当前轮次。 (+39 more)
 
 ### Community 3 - "Community 3"
 Cohesion: 0.06
-Nodes (117): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+109 more)
+Nodes (86): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+78 more)
 
 ### Community 4 - "Community 4"
-Cohesion: 0.09
-Nodes (75): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+67 more)
+Cohesion: 0.17
+Nodes (43): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+35 more)
 
 ### Community 5 - "Community 5"
-Cohesion: 0.38
-Nodes (6): 解析司机：显式选择优先，否则取车辆关联司机；均无则允许为空。, _resolve_driver(), 运输计划解析司机：车辆未关联司机时允许为空。, 未显式选司机、车辆也无关联司机时，应返回空三元组而非 400。, test_resolve_driver_with_explicit_id_returns_personnel(), test_resolve_driver_without_vehicle_link_returns_none()
+Cohesion: 0.09
+Nodes (70): archive_plan(), create_plan(), get_plan(), update_plan_driver_feedback(), update_plan_site_feedback(), PlPlan, PlPlanProduct, 计划产品明细表 pl_plan_product (+62 more)
 
 ### Community 6 - "Community 6"
 Cohesion: 0.10
 Nodes (51): customer_create(), customer_update(), follow_by_customer(), follow_detail(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer() (+43 more)
 
 ### Community 7 - "Community 7"
-Cohesion: 0.16
-Nodes (35): approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), export_approved_by_me_reimburses(), export_my_reimburses(), export_pending_approval_reimburses() (+27 more)
+Cohesion: 0.15
+Nodes (38): BxApplyListExportBody, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), download_reimburse_import_template(), export_approved_by_me_reimburses() (+30 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)
+Cohesion: 0.11
+Nodes (32): approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals(), list_quote_approvals(), Any (+24 more)
 
 ### Community 9 - "Community 9"
 Cohesion: 0.10
-Nodes (49): 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() (+41 more)
+Nodes (48): 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(), is_example_row() (+40 more)
 
 ### Community 10 - "Community 10"
-Cohesion: 0.22
-Nodes (11): assert_export_row_count(), _build_workbook(), DictLabelResolver, Any, Excel 导出工具：集中处理字典 code → label（对齐 Java ExcelDictConvert / ExcelDictPreloadConver, 导出单元格解析：按列配置做字典翻译或自定义格式化。, test_assert_export_row_count_empty(), test_assert_export_row_count_ok() (+3 more)
+Cohesion: 0.23
+Nodes (12): change_current_user_password(), get_current_user_profile(), public_quote_share(), Request, Session, 获取当前用户信息（与 sys_user 字段对应）。, 公开分享查看报价单 — Java: GET /share/{shareCode}（无 JWT）, get_current_user() (+4 more)
 
 ### Community 11 - "Community 11"
 Cohesion: 0.10
-Nodes (57): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), export_urea_applies(), export_urea_disburse_board(), get_apply() (+49 more)
+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.08
-Nodes (40): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+32 more)
+Cohesion: 0.06
+Nodes (46): create_leave(), AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest (+38 more)
 
 ### Community 13 - "Community 13"
-Cohesion: 0.10
-Nodes (55): DbInboundOutbound, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, _apply_plan_quantity_delta(), apply_stop_dibang_options(), _create_db_inventory(), _create_db_plan(), _delivery_stop_products() (+47 more)
+Cohesion: 0.09
+Nodes (57): PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, default_execution_status(), generate_plan_no(), 生成计划号：SX-YYYYMMDDHHMMSS001, _apply_plan_quantity_delta(), apply_stop_dibang_options(), _create_db_inventory() (+49 more)
 
 ### Community 14 - "Community 14"
-Cohesion: 0.11
-Nodes (22): approve_carrier(), create_carrier(), reject_carrier(), CarrierAuditReject, CarrierBase, CarrierCreate, CarrierQualificationBase, CarrierRead (+14 more)
+Cohesion: 0.14
+Nodes (29): _build_driver_url(), _build_public_page(), _build_stop_product_reads(), _format_file_size(), _format_plan_date(), get_public_transport(), _get_transport_by_token(), _parse_feedback_images() (+21 more)
 
 ### Community 15 - "Community 15"
 Cohesion: 0.11
-Nodes (15): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, BxReimburseInvoice, BxReimburseOffset, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn (+7 more)
+Nodes (14): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseApplyOut, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn, Any (+6 more)
 
 ### Community 16 - "Community 16"
-Cohesion: 0.05
-Nodes (117): category_add(), category_delete(), category_tree(), category_update(), clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export() (+109 more)
+Cohesion: 0.04
+Nodes (194): category_add(), category_delete(), category_tree(), category_update(), clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export() (+186 more)
 
 ### Community 17 - "Community 17"
-Cohesion: 0.11
-Nodes (51): bind_vehicle_driver(), CarrierExportBody, create_driver(), create_personnel(), delete_driver(), delete_personnel(), DriverExportBody, export_carriers() (+43 more)
+Cohesion: 0.06
+Nodes (94): approve_carrier(), bind_vehicle_driver(), CarrierExportBody, create_driver(), create_personnel(), create_vehicle(), delete_carrier(), delete_driver() (+86 more)
 
 ### Community 18 - "Community 18"
-Cohesion: 0.14
-Nodes (37): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+29 more)
+Cohesion: 0.10
+Nodes (43): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+35 more)
 
 ### Community 19 - "Community 19"
-Cohesion: 0.13
-Nodes (35): create_vehicle(), delete_vehicle(), get_vehicle(), update_vehicle(), _vehicle_to_detail(), generate_uuid(), PlVehicle, VehicleDetailRead (+27 more)
+Cohesion: 0.12
+Nodes (40): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), export_plans(), _generate_plan_no() (+32 more)
 
 ### Community 20 - "Community 20"
-Cohesion: 0.12
-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.10
+Nodes (44): dump_export_row(), issue_status_label(), Any, Session, respond_xlsx(), status_label(), advance_issue_stats(), batch_offset() (+36 more)
 
 ### Community 21 - "Community 21"
-Cohesion: 0.18
-Nodes (36): PlVehicleRechargeApply, PlVehicleRechargeRecord, 车辆ETC/加油充值申请 pl_vehicle_recharge_apply, 车辆ETC/加油充值发放登记 pl_vehicle_recharge_record, 发放登记页：申请单 + 关联发放信息（左连接）, VehicleRechargeApplyRead, VehicleRechargeDisburseBoardItem, VehicleRechargeRecordRead (+28 more)
+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 22 - "Community 22"
-Cohesion: 0.19
-Nodes (13): BusinessException, InvalidStatusTransitionException, log_delivery_operation(), log_operation(), log_order_operation(), log_settlement_operation(), log_user_operation(), OrderLockedException (+5 more)
+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.13
-Nodes (28): PlPlanProductBrandQty, 计划产品归档品牌数量 pl_plan_product_brand_qty, load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。 (+20 more)
+Cohesion: 0.11
+Nodes (38): PlInventory, PlInventoryTransaction, PlPlanProductBrandQty, 库存流水表 pl_inventory_transaction, 计划产品归档品牌数量 pl_plan_product_brand_qty      stop_product_id 为空：计划产品级汇总；非空：装货/送货段产品, _is_plan_level_row(), load_brand_qtys_by_plan_product_ids(), load_brand_qtys_by_stop_product_ids() (+30 more)
 
 ### Community 24 - "Community 24"
 Cohesion: 0.19
@@ -338,148 +330,148 @@ 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 28 - "Community 28"
-Cohesion: 0.11
-Nodes (56): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+48 more)
+Cohesion: 0.09
+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.10
-Nodes (35): PlPlanContract, PlPlanDelivery, PlPlanDeliveryProduct, PlPlanLoad, PlPlanLoadProduct, 运输计划-合同关联（分侧多选） pl_plan_contract, 运输计划-装货段 pl_plan_load（plan 1:1）, 运输计划-装货段产品明细 pl_plan_load_product (+27 more)
+Cohesion: 0.11
+Nodes (36): PlPlanDelivery, PlPlanDeliveryProduct, PlPlanLoad, PlPlanLoadProduct, 运输计划-装货段 pl_plan_load（plan 1:1）, 运输计划-装货段产品明细 pl_plan_load_product, 运输计划-送货段 pl_plan_delivery（plan 1:N）, 运输计划-送货段产品明细 pl_plan_delivery_product (+28 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.16
-Nodes (27): put_plan_side_contracts(), PlanContractGapRead, PlanContractLink, PlanProductRead, build_plan_contract_gap_read(), compute_contract_gap_sides(), _demander_gap_expr(), list_plan_contract_gaps() (+19 more)
+Cohesion: 0.19
+Nodes (30): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, _assignment_dict(), build_public_url(), _count_active_assignments(), _day_dict() (+22 more)
 
 ### Community 32 - "Community 32"
 Cohesion: 0.16
 Nodes (25): change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user(), list_user_ids_bound_to_post(), list_users() (+17 more)
 
 ### Community 33 - "Community 33"
-Cohesion: 0.11
-Nodes (21): BxAdvanceApply, BxAdvanceApproval, BxWorkflowNode, AdvanceService, Any, Session, 同一节点多次审批时，取 approval_time 最新的一条作为当前节点状态。, 返回全部审批动作，按时间正序排列，用于展示完整审批历史。 (+13 more)
+Cohesion: 0.17
+Nodes (23): contact_by_customer(), contact_detail(), contact_set_primary(), customer_options(), 客户下拉选项（租户内只读，不做 owner 数据权限）, create_contact(), get_contact(), list_contacts_by_customer() (+15 more)
 
 ### Community 34 - "Community 34"
-Cohesion: 0.18
-Nodes (18): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+10 more)
+Cohesion: 0.14
+Nodes (21): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+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.13
-Nodes (40): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), category_code_exists(), create_category(), create_oss(), create_product() (+32 more)
+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 37 - "Community 37"
-Cohesion: 0.15
-Nodes (34): check_document_expiry(), document_reminder_stats(), export_document_reminders(), export_inventory_ledger(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions() (+26 more)
+Cohesion: 0.09
+Nodes (53): check_document_expiry(), document_reminder_stats(), export_document_reminders(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings() (+45 more)
 
 ### Community 38 - "Community 38"
 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.10
-Nodes (27): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+19 more)
+Cohesion: 0.18
+Nodes (17): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+9 more)
 
 ### Community 40 - "Community 40"
-Cohesion: 0.07
-Nodes (81): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, DutyAssignmentIn, DutyDaySaveBody, DutySlotSaveIn, 值班排班 Pydantic schemas (+73 more)
+Cohesion: 0.11
+Nodes (31): build_dict_value_from_label(), ensure_dict_data(), format_hhmm(), format_time_label(), grab(), normalize_person_name(), _pad_hhmm(), parse_hhmm() (+23 more)
 
 ### Community 41 - "Community 41"
-Cohesion: 0.15
-Nodes (34): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+26 more)
+Cohesion: 0.16
+Nodes (36): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+28 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.12
-Nodes (28): create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request (+20 more)
+Cohesion: 0.10
+Nodes (31): create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request (+23 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.20
-Nodes (61): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+53 more)
+Cohesion: 0.30
+Nodes (48): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+40 more)
 
 ### Community 46 - "Community 46"
-Cohesion: 0.13
-Nodes (45): _build_page(), PlTransportDriverStopFeedback, PlTransportSiteStopFeedback, 运输单-司机按段附件回传 pl_transport_driver_stop_feedback, 运输单-现场按段回传 pl_transport_site_stop_feedback, PublicTransportStopProductRead, PublicTransportStopRead, is_internal_customer_name() (+37 more)
+Cohesion: 0.16
+Nodes (38): PlTransportDriverStopFeedback, PlTransportSiteStopFeedback, 运输单-司机按段附件回传 pl_transport_driver_stop_feedback, 运输单-现场按段回传 pl_transport_site_stop_feedback, _direction_label(), _dump_product_feedbacks(), _dump_urls(), _get_driver_feedback_row() (+30 more)
 
 ### Community 47 - "Community 47"
-Cohesion: 0.19
-Nodes (25): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+17 more)
+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 48 - "Community 48"
-Cohesion: 0.09
-Nodes (68): register_contract_routes(), _apply_contract_entity_fields(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _contract_period_key() (+60 more)
+Cohesion: 0.10
+Nodes (63): _apply_contract_entity_fields(), _build_contract_filters(), _build_contract_name_from_parties(), _build_customer_address(), _calc_amount_with_tax(), _change_row_to_dict(), contract_no_exists(), _contract_period_key() (+55 more)
 
 ### Community 49 - "Community 49"
-Cohesion: 0.09
-Nodes (31): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+23 more)
+Cohesion: 0.14
+Nodes (31): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), download_contract_pdf(), export_contracts(), finish_contract(), get_contract_row(), _get_contract_row_in_scope() (+23 more)
 
 ### Community 50 - "Community 50"
-Cohesion: 0.10
-Nodes (25): generate_qrcode(), get_current_time(), parse_datetime(), datetime, get_last_month_range(), month_range(), date, Session (+17 more)
+Cohesion: 0.19
+Nodes (11): get_current_time(), parse_datetime(), datetime, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session (+3 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.11
-Nodes (38): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_unsettled_plans(), _generate_settlement_no(), get_settlement() (+30 more)
+Cohesion: 0.18
+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 53 - "Community 53"
 Cohesion: 0.20
 Nodes (7): _FakeQuery, _FakeSession, _plan(), 现场链接生成条件：装货/送货段含山峡或云栋客户, test_external_stops_do_not_require_site_link(), test_internal_delivery_requires_site_link(), test_legacy_plan_customer_fallback()
 
 ### Community 54 - "Community 54"
-Cohesion: 0.14
-Nodes (41): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing(), _get_weighing(), get_weighing_related() (+33 more)
+Cohesion: 0.15
+Nodes (21): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+13 more)
 
 ### Community 55 - "Community 55"
-Cohesion: 0.11
-Nodes (23): API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单）, Session, read_customer_stop_pref(), menu_badge_stats(), Session, Session (+15 more)
+Cohesion: 0.09
+Nodes (21): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), Config, _db_pool_keepalive_loop(), _error_json() (+13 more)
 
 ### Community 56 - "Community 56"
-Cohesion: 0.05
-Nodes (96): 返回 (作废, 归档)。现场链接实际走入库/出库单公共页。, _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() (+88 more)
+Cohesion: 0.14
+Nodes (34): _build_history_stop_reads(), get_public_transport_history(), _history_status_label(), _resolve_unit_label(), _build_public_page(), _build_site_history_stop_reads(), _build_site_url(), _format_file_size() (+26 more)
 
 ### Community 57 - "Community 57"
 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 58 - "Community 58"
-Cohesion: 0.15
-Nodes (35): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), create_contract_template(), _enrich_change_rows(), execute_change(), export_contract_changes() (+27 more)
+Cohesion: 0.11
+Nodes (25): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+17 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
+Cohesion: 0.18
 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.09
-Nodes (56): DeliveryPrintCustomerOption, DeliverySlipPrintRead, PlanDeliveryBody, PlanDeliveryRead, PlanLoadBody, PlanLoadRead, PlanStopProductBody, PlanStopProductRead (+48 more)
+Cohesion: 0.11
+Nodes (50): create_plan_full(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, update_plan(), generate_uuid(), PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, PlanContractLink, PlanDeliveryBody (+42 more)
 
 ### Community 62 - "Community 62"
-Cohesion: 0.10
-Nodes (65): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+57 more)
+Cohesion: 0.09
+Nodes (72): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+64 more)
 
 ### Community 63 - "Community 63"
-Cohesion: 0.12
-Nodes (29): contact_add(), contact_by_customer(), contact_delete(), contact_detail(), contact_set_primary(), contact_update(), create_contact(), get_contact() (+21 more)
+Cohesion: 0.18
+Nodes (25): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), execute_change(), export_contract_templates(), _get_change_row(), get_contract_change_detail(), get_contract_template_detail(), list_contract_templates() (+17 more)
 
 ### Community 64 - "Community 64"
 Cohesion: 0.29
@@ -487,31 +479,31 @@ Nodes (12): build_name_pinyin_abbr(), normalize_name_pinyin_abbr(), 名称拼音
 
 ### Community 65 - "Community 65"
 Cohesion: 0.10
-Nodes (61): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+53 more)
+Nodes (60): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_process_board(), get_apply(), get_process() (+52 more)
 
 ### Community 66 - "Community 66"
-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)
+Cohesion: 0.06
+Nodes (40): 地磅 API 路由聚合 — REST 风格，协议对齐原 simple-dibang-xiaoshou。, API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单）, operlog_detail(), operlog_list(), Session, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构） (+32 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.18
-Nodes (24): delete_plan(), delete_carrier(), unbind_vehicle_driver(), delete_plan(), _actor_ids(), _actor_names(), assert_row_deletable_by_creator(), assert_rows_deletable_by_creator() (+16 more)
+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.33
-Nodes (8): allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session, 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。     须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, BizNoKind
+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 70 - "Community 70"
 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 71 - "Community 71"
-Cohesion: 0.12
-Nodes (19): pool_customer_assign(), pool_customer_claim(), pool_customer_export(), pool_customer_list(), pool_record_detail(), pool_record_list(), get_pool_record(), list_pool_records() (+11 more)
+Cohesion: 0.05
+Nodes (71): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_list(), clue_follow_update() (+63 more)
 
 ### Community 72 - "Community 72"
 Cohesion: 0.25
@@ -522,52 +514,52 @@ 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.17
-Nodes (31): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), export_plans(), _generate_plan_no(), get_plan() (+23 more)
+Cohesion: 0.12
+Nodes (46): get_plan_related(), _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing(), _get_weighing() (+38 more)
 
 ### Community 75 - "apply_crm_create_by_scope"
-Cohesion: 0.22
-Nodes (14): BxInvoiceLedger, BxInvoiceWalletSummary, 报销（bx）模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, InvoiceLedgerService, Any, Decimal, Session, should_skip_release() (+6 more)
+Cohesion: 0.06
+Nodes (68): Session, read_customer_stop_pref(), approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements() (+60 more)
 
 ### Community 76 - "opportunity_follow.py"
-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.10
+Nodes (39): _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 (+31 more)
 
 ### 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.04
-Nodes (105): 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(), opportunity_add() (+97 more)
+Cohesion: 0.25
+Nodes (19): opportunity_follow_add(), opportunity_follow_update(), create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime() (+11 more)
 
 ### Community 79 - "PlCarrier"
-Cohesion: 0.22
-Nodes (16): 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） (+8 more)
+Cohesion: 0.07
+Nodes (41): DocumentReminderExportBody, export_inventory_ledger(), InventoryLedgerExportBody, ApiRequestLogCRUD, Session, list_ethnics(), Any, Session (+33 more)
 
 ### Community 81 - "customer_follow.py"
+Cohesion: 0.17
+Nodes (22): create_carrier(), get_carrier(), update_carrier(), PlCarrier, carrier_to_read(), CarrierBase, CarrierCreate, CarrierQualificationBase (+14 more)
+
+### Community 82 - "list_duty_staff_users"
 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 82 - "list_duty_staff_users"
-Cohesion: 0.33
-Nodes (13): apply_pl_scope(), Session, PL 模块数据权限辅助（create_by / create_dept_id，无 owner_field）。, build_menu_badge_counts(), count_document_reminder_expired_pending(), count_freight_approval_pending(), count_freight_disburse_pending(), _count_pending_applies() (+5 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.14
+Nodes (32): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+24 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 (67): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_list(), clue_follow_update() (+59 more)
+Cohesion: 0.13
+Nodes (42): clue_follow_detail(), assign_clues(), check_convert(), check_duplicate_clue(), convert_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope() (+34 more)
 
 ### Community 86 - "Community 86"
-Cohesion: 0.11
-Nodes (34): align_contract_no_to_sign_date(), _build_contract_name_from_parties(), contract_no_exists(), create_contract(), generate_contract_no(), _get_field(), is_framework_contract_type(), _normalize_framework_contract_data() (+26 more)
+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 87 - "Community 87"
 Cohesion: 0.27
@@ -582,76 +574,76 @@ 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.22
-Nodes (17): _apply_list_filters(), create_supplier_info(), get_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+9 more)
+Cohesion: 0.13
+Nodes (25): _apply_list_filters(), create_supplier_info(), get_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+17 more)
 
 ### Community 91 - "unsettled_plans_q_filter"
-Cohesion: 0.11
-Nodes (26): create_leave(), export_leaves(), _leave_local_callback(), LeaveExportBody, list_leaves(), 导出请假列表（当前筛选全量，或 ids 已选）。, create_leave(), get_leave() (+18 more)
+Cohesion: 0.14
+Nodes (26): delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves(), Session (+18 more)
 
 ### Community 92 - "Community 92"
 Cohesion: 0.18
 Nodes (22): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+14 more)
 
 ### Community 93 - "api_request_log_middleware.py"
-Cohesion: 0.09
-Nodes (27): DocumentReminderExportBody, InventoryLedgerExportBody, list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), SoftDeleteModel (+19 more)
+Cohesion: 0.24
+Nodes (8): generate_id(), camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType
 
 ### 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.21
-Nodes (19): _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 (+11 more)
+Cohesion: 0.26
+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)
 
 ### Community 96 - "minio_url.py"
-Cohesion: 0.22
-Nodes (15): ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+7 more)
+Cohesion: 0.10
+Nodes (31): ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+23 more)
 
 ### Community 97 - "contact.py"
-Cohesion: 0.24
-Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType
+Cohesion: 0.34
+Nodes (18): batch_add_opportunity_products(), _calc_subtotal(), create_opportunity_product(), _decimal_value(), _fill_product_redundant(), _get_opportunity_for_product(), get_opportunity_product(), list_opportunity_products() (+10 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.11
-Nodes (30): list_personnel(), list_vehicles(), PlCert, CertRead, parse_resource_snapshot(), Any, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, 从 ORM 文本列或 dict 解析快照。 (+22 more)
+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 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.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.18
+Nodes (17): 返回 (作废, 归档)。现场链接实际走入库/出库单公共页。, _resolve_io_order_link_flags(), _resolve_site_link_flags(), _resolve_driver_link_flags(), PublicTransportPageRead, PublicTransportSitePageRead, 运输计划司机/现场公共链接：归档后应标记并拦截写操作。, test_driver_link_flags_archived_when_plan_archived() (+9 more)
 
 ### Community 102 - "BaseStorage"
-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)
+Cohesion: 0.43
+Nodes (5): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, test_calc_age_from_18_digit_id(), test_calc_age_rejects_invalid()
 
 ### Community 103 - "pl_internal_customer.py"
-Cohesion: 0.27
-Nodes (10): apply_product_snapshot_to_weighing(), ProductSnapshot, Session, 地磅模块 — CRM 产品解析与快照写入。, 校验 CRM 产品并返回名称/规格快照。新建单据 product_id 必填。      require_on_shelf=False 用于运输计划联动地磅等历, resolve_crm_product(), _product(), resolve_crm_product：运输联动场景允许已下架产品。 (+2 more)
+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 104 - "apply_crm_create_by_scope"
-Cohesion: 0.29
-Nodes (15): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+7 more)
+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.67
 Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析：前端 date-picker 仅传 YYYY-MM-DD。
 
 ### Community 106 - "site.py"
-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.40
+Nodes (9): create_oss(), create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件（兼容旧 CRM 雪花 oss_id 迁入后的记录）, 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。      门户新上传把相对路径写入业务字段；迁入合同附件仍存数字 ossId, resolve_storage_path() (+1 more)
 
 ### Community 107 - "apply_pl_scope"
-Cohesion: 0.06
-Nodes (89): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def(), _enrich_task_list(), export_completed_tasks() (+81 more)
+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 108 - "statistics.py"
 Cohesion: 0.20
@@ -661,13 +653,13 @@ Nodes (24): count_source_rows(), derive_source_url(), fetch_portal_admin_id(), f
 Cohesion: 0.12
 Nodes (28): _extract_qty(), _fmt_qty(), Any, Decimal, 运输计划多段：内部客户地磅默认值与数量平衡校验, 地磅默认勾选以装货客户是否为内部客户为准。, resolve_stop_dibang_defaults(), _sum_qty() (+20 more)
 
-### Community 110 - "monitor.py"
-Cohesion: 0.30
-Nodes (12): operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session, 导出操作日志（当前筛选全量，或 ids 已选）。, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info() (+4 more)
+### Community 110 - "pool_rule.py"
+Cohesion: 0.31
+Nodes (14): create_pool_rule(), delete_pool_rules(), execute_pool_rules(), _execute_single_rule(), get_pool_rule(), list_pool_rules(), Any, Session (+6 more)
 
-### Community 111 - "run_auto_generate_monthly_plans"
-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 111 - "test_pl_public_transport_history.py"
+Cohesion: 0.31
+Nodes (9): _as_date(), _history_matches_date(), _normalize_main_plate(), _parse_history_date(), date, test_history_matches_date_or_logic(), test_history_status_label(), test_normalize_main_plate_trims() (+1 more)
 
 ### Community 112 - "merge_duplicate_crm_customers.py"
 Cohesion: 0.26
@@ -682,12 +674,12 @@ 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 115 - "site.py"
-Cohesion: 0.10
-Nodes (20): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), _db_pool_keepalive_loop(), _error_json(), lifespan() (+12 more)
+Cohesion: 0.33
+Nodes (8): DutyAssignmentIn, DutyDaySaveBody, DutySlotSaveIn, 缩容：已有 1 人抢班时 capacity=1 且再指定 1 人应失败。, 历史指定用户无值班人员角色时，原样再保存不得因角色校验失败。, test_save_day_grandfathers_existing_assign_without_role(), test_save_day_rejects_new_assign_without_role(), test_save_day_rejects_shrink_below_grab_count()
 
 ### Community 116 - "Community 116"
-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)
+Cohesion: 0.19
+Nodes (26): 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() (+18 more)
 
 ### Community 117 - "pl_plan_list_attachments.py"
 Cohesion: 0.26
@@ -701,21 +693,21 @@ 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 (9): parse_admin_request_json(), Any, Request, 运营 Web（/web/admin）JSON 请求体解析。  与 ApiCryptoMiddleware 配合：中间件未改写 body 时，在路由内解密 `{, 读取 JSON body；dict 时走 resolve_request_payload（明文 / 密文 / data 包装）。      Returns:, Config, 统一解析接口请求载荷（明文 / 密文信封）。, 兼容明文与密文信封，返回业务层 payload（多为 dict；批量数组接口解密后为 list）。 (+1 more)
+### Community 120 - "list_duty_staff_users"
+Cohesion: 0.33
+Nodes (6): list_duty_staff_users(), 按固定 id 查找「值班人员」角色；找不到再按角色名兜底。, 本租户启用且绑定「值班人员」角色的用户（公开页 users / 管理端 options）。, resolve_duty_staff_role_id(), test_list_duty_staff_users_empty_when_no_role(), test_resolve_duty_staff_role_id_by_fixed_id()
 
-### Community 121 - "customer_follow.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 121 - "_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 122 - "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 123 - "customer_options"
-Cohesion: 0.10
-Nodes (33): CRM 报价单 API 路由 — 挂接到 crm.router, total_pages(), QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody (+25 more)
+Cohesion: 0.05
+Nodes (67): CRM 报价单 API 路由 — 挂接到 crm.router, RecognizeCertResult, PageResult, ResponseModel, BaseModel, SoftDeleteModel, PagedQuery, PagedResponse (+59 more)
 
 ### Community 124 - "LocalStorage"
 Cohesion: 0.39
@@ -723,19 +715,19 @@ Nodes (10): create_site(), get_site(), list_sites(), Any, Session, _row_to_dict(
 
 ### Community 125 - "ethnic.py"
 Cohesion: 0.06
-Nodes (72): _attach_history_products(), _build_history_page(), _get_by_token(), _history_status_label(), _make_handlers(), _models(), _parse_history_date(), date (+64 more)
+Nodes (72): get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _make_handlers(), PlInboundOrder, PlInboundOrderItem, PlInboundOrderItemBrandQty, PlOutboundOrder, PlOutboundOrderItem (+64 more)
 
 ### Community 126 - "oper_log.py"
 Cohesion: 0.28
-Nodes (11): business_type_from_path(), title_from_path(), _apply_oper_log_scope(), get_oper_log(), _oper_log_row_in_scope(), _oper_status(), Any, Session (+3 more)
+Nodes (8): list_products(), 分页查询产品列表      keyword 默认匹配：名称 / 编号 / 拼音首字母。     选择器场景可关闭编号匹配、开启规格型号匹配（避免短数字误命中产品, 产品/客户列表 keyword：名称/编号/拼音首字母 OR 匹配。, 选择器：名称/拼音/规格型号，不匹配产品编号。, test_list_customer_options_keyword_includes_name_and_pinyin(), test_list_customers_keyword_includes_name_and_pinyin(), test_list_products_keyword_includes_name_and_pinyin(), test_list_products_keyword_selector_mode_excludes_product_no_includes_model()
 
 ### Community 127 - "Any"
-Cohesion: 0.22
-Nodes (13): _build_category_tree(), _category_row_to_dict(), _collect_category_with_ancestors(), list_categories(), list_category_tree(), list_oss_by_biz(), _oss_row_to_dict(), Any (+5 more)
+Cohesion: 0.07
+Nodes (67): DeliverySlipPrintRead, PlanDeliveryRead, PlanLoadRead, PlanStopProductRead, is_internal_customer_name(), 运输计划：内置山峡/云栋客户判定（合同可免）, _append_legacy_plan_product_rows(), _append_stop_product_rows() (+59 more)
 
 ### Community 128 - "api_crypto.py"
-Cohesion: 0.25
-Nodes (7): ApiCryptoError, _b64url_decode(), _b64url_encode(), decrypt_json(), encrypt_json(), Any, Exception
+Cohesion: 0.50
+Nodes (5): assert_user_is_duty_staff(), DutyBizError, _resolve_grab_user(), soft_delete_assignment(), test_assert_user_is_duty_staff_rejects_without_role()
 
 ### Community 129 - "BaseStorage"
 Cohesion: 0.12
@@ -746,88 +738,56 @@ 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 131 - "resolve_crm_product"
-Cohesion: 0.58
-Nodes (9): _apply_create_range(), _base_query(), get_clue_level_statistics(), get_clue_overview_statistics(), get_clue_owner_statistics(), get_clue_source_statistics(), get_clue_trend_statistics(), Any (+1 more)
-
-### Community 132 - "list_products"
-Cohesion: 0.22
-Nodes (10): list_products(), _product_row_to_dict(), 产品 ORM 对象转 dict（camelCase 键名）, 分页查询产品列表      keyword 默认匹配：名称 / 编号 / 拼音首字母。     选择器场景可关闭编号匹配、开启规格型号匹配（避免短数字误命中产品, 产品/客户列表 keyword：名称/编号/拼音首字母 OR 匹配。, 选择器：名称/拼音/规格型号，不匹配产品编号。, test_list_customer_options_keyword_includes_name_and_pinyin(), test_list_customers_keyword_includes_name_and_pinyin() (+2 more)
+Cohesion: 0.49
+Nodes (10): clue_statistics_level(), _apply_create_range(), _base_query(), get_clue_level_statistics(), get_clue_overview_statistics(), get_clue_owner_statistics(), get_clue_source_statistics(), get_clue_trend_statistics() (+2 more)
 
 ### Community 133 - "inventory_id.py"
-Cohesion: 0.18
-Nodes (15): DbSequence, 地磅（db）模块数据模型 — 对齐 docs/sql/db_tables.sql, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id(), Session, 出入库单 id 生成 — 租户内纯数字自增，并发安全。 (+7 more)
+Cohesion: 0.24
+Nodes (12): DbSequence, 地磅（db）模块数据模型 — 对齐 docs/sql/db_tables.sql, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id(), Session, 出入库单 id 生成 — 租户内纯数字自增，并发安全。 (+4 more)
 
 ### Community 134 - "list_contacts"
 Cohesion: 0.22
 Nodes (3): BaseStorage, 带下载文件名的访问 URL；默认实现为普通访问地址。, 浏览器内联预览 URL；默认实现为普通访问地址。
 
-### Community 135 - "customer.py"
-Cohesion: 0.22
-Nodes (8): CustomerAssignPoolBody, CustomerCheckDuplicateBody, CustomerClaimBody, CustomerDealBody, CustomerDetailBody, CustomerIntoPoolBody, CustomerTransferBody, CRM 客户管理 Pydantic Schemas
-
 ### Community 136 - "get_db_current_user_optional"
-Cohesion: 0.13
-Nodes (32): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply() (+24 more)
+Cohesion: 0.10
+Nodes (25): demo_xlsx_export(), Demo 列表导出：接收已筛选行与列定义，生成 xlsx。, operlog_export(), OperLogExportBody, 导出操作日志（当前筛选全量，或 ids 已选）。, export_transports(), 导出运输列表（当前筛选全量，或 ids 已选）。, export_applies() (+17 more)
 
 ### Community 137 - "iter_user_menu_perm_codes"
-Cohesion: 0.33
-Nodes (9): _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), Session, 角色仅勾选按钮（F）时，补齐祖先 C/M 菜单 id，便于前端匹配 :list 路由。, 用户通过角色关联得到的菜单权限标识（sys_menu.perms，与前端 meta.menuCode 对齐）。, 用户是否在 sys_user_role 中绑定了至少一个有效角色。, _role_rows_for_user() (+1 more)
+Cohesion: 0.20
+Nodes (15): get_web_auth_menu_codes(), 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。, get_user_menu_codes(), Session, 读取用户授权的菜单权限标识集合（与前端 meta.menuCode / perms 对齐）。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes() (+7 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 140 - "UserRole"
-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 141 - "customer_follow.py"
 Cohesion: 0.25
-Nodes (7): CustomerFollowByCustomerBody, CustomerFollowCreateBody, CustomerFollowDeleteBody, CustomerFollowDetailBody, CustomerFollowListBody, CustomerFollowUpdateBody, CRM 客户跟进记录 Pydantic Schemas
+Nodes (13): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage，对外保持 bx 协议。 (+5 more)
 
 ### Community 142 - "clear_pl_plan_instance_data.py"
 Cohesion: 0.46
 Nodes (7): _count(), _delete(), _engine_from_env(), main(), Engine, 清空运输计划（pl_plan）及关联实例数据，便于测试环境重新走流程。  用法（在 backend 目录、已配置 .env DATABASE_URL）：   p, _table_exists()
 
 ### Community 143 - "calc_age_from_chinese_id_card"
-Cohesion: 0.43
-Nodes (5): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, test_calc_age_from_18_digit_id(), test_calc_age_rejects_invalid()
+Cohesion: 0.14
+Nodes (25): PlCert, CertRead, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot, certs_to_read(), list_owner_certs() (+17 more)
 
 ### Community 144 - "response.py"
-Cohesion: 0.29
-Nodes (6): Config, format_api_error_message(), PageResult, Exception, 将 HTTP/SQLAlchemy 等异常转为可展示的错误文案（避免 str([]) 空列表）。, ResponseModel
-
-### Community 145 - "duty_schedule.py"
-Cohesion: 0.52
-Nodes (3): ApiRequestLogCRUD, Session, SysApiRequestLog
-
-### Community 146 - "duty.py"
-Cohesion: 0.25
-Nodes (13): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName（用 nick_name）。 (+5 more)
+Cohesion: 0.14
+Nodes (23): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+15 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 148 - "unsettled_plans_q_filter"
-Cohesion: 0.50
-Nodes (4): 简易搜索：计划编号 / 客户(供应商) / 车牌 / 承运商名称。, unsettled_plans_q_filter(), 未结算计划简易搜索：q 应覆盖计划编号/客户/车牌/承运商名称。, test_unsettled_plans_q_filter_includes_carrier_and_plate()
-
 ### Community 149 - "list_product_options"
-Cohesion: 0.67
-Nodes (3): list_product_options(), 产品下拉 options：keyword 按产品名称/拼音首字母模糊匹配，不匹配产品编号。, test_list_product_options_keyword_only_filters_product_name()
+Cohesion: 0.31
+Nodes (9): 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(), auto_generate_monthly_plans_job() (+1 more)
 
 ### Community 150 - "get_db_current_user_optional"
-Cohesion: 0.67
-Nodes (3): get_db_current_user_optional(), Session, 有 Bearer 且为 admin/super_admin 时返回上下文，否则 None（供三方 H5 无登录调用）。
-
-### Community 152 - "customer_options"
-Cohesion: 0.50
-Nodes (4): customer_options(), 客户下拉选项（租户内只读，不做 owner 数据权限）, CustomerOptionsBody, 客户下拉选项请求体（租户内只读搜索，不做 owner 数据权限）
+Cohesion: 0.14
+Nodes (19): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), CrmCustomerPool, 按 18 位身份证号重算 pl_personnel.age，仅更新算出值与库中不一致的记录。返回更新条数。 (+11 more)
 
 ### Community 153 - "pl_feedback_brand_qty.py"
 Cohesion: 0.14
@@ -835,7 +795,7 @@ Nodes (24): PlTransportProductBrandQty, PlTransportProductFeedback, 运输单按
 
 ### Community 154 - "LocalStorage"
 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
+Nodes (6): convert_heic_to_jpeg(), OSSStorage, process_image_content(), QiniuStorage, 将 HEIC/HEIF 格式转换为 JPEG 格式, 处理图片内容，如果是 HEIC 格式则转换为 JPEG
 
 ### Community 155 - "WechatMessageService"
 Cohesion: 0.15
@@ -846,12 +806,12 @@ 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.10
-Nodes (43): _avatar_url_field(), _build_user_info_payload(), _jwt_user_payload(), logout(), 公共接口（Web 登录、刷新 Token、登出；用户模型对齐 docs/sql/shanxia2.0.sql 基线）, 登出：吊销 Redis 会话（若已配置 REDIS_HOST）。无 Token 或已失效时仍返回成功（幂等）。, 与 web-admin 静态路由 meta.roles（admin/super_admin）对齐的单元素数组。, 与 web-admin `userInfo` 字段约定一致。 (+35 more)
+Cohesion: 0.13
+Nodes (33): _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() (+25 more)
 
 ### Community 173 - "resolve_create_time_bounds"
-Cohesion: 0.05
-Nodes (99): _build_driver_url(), get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result() (+91 more)
+Cohesion: 0.07
+Nodes (65): ContractGapExportBody, PlanExportBody, _resolve_plan_flags(), _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result() (+57 more)
 
 ### Community 179 - "test_pl_vehicle_personnel_photo_schema.py"
 Cohesion: 0.27
@@ -889,17 +849,17 @@ Nodes (6): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时
 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_
 
-- **Why does `generate_uuid()` connect `Community 19` to `Community 0`, `_filter_export_rows_by_ids`, `Community 2`, `Community 4`, `inventory_id.py`, `Community 6`, `Community 8`, `Community 11`, `Community 13`, `Community 14`, `Community 15`, `Community 17`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `pl_feedback_brand_qty.py`, `Community 28`, `Community 29`, `Community 32`, `Community 33`, `Community 34`, `get_client_ip`, `Community 37`, `Community 36`, `Community 39`, `Community 40`, `resolve_create_time_bounds`, `Community 46`, `Community 48`, `Community 50`, `Community 51`, `Community 54`, `Community 58`, `Community 61`, `Community 62`, `Community 63`, `Community 65`, `Community 66`, `Community 67`, `Community 69`, `Community 71`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `Community 78`, `PlCarrier`, `Community 83`, `allocate_next_biz_no`, `Community 86`, `Community 87`, `CrmProduct`, `pl_ocr_service.py`, `WechatMessageService`, `unsettled_plans_q_filter`, `Community 92`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `site.py`, `apply_pl_scope`, `dict_type.py`, `dept.py`, `Community 116`, `Community 118`, `post.py`, `LocalStorage`, `ethnic.py`?**
-  _High betweenness centrality (0.141) - this node is a cross-community bridge._
-- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 73`, `Community 42`, `Community 59`, `statistics.py`, `Community 44`, `oper_log_decorator.py`, `Community 57`, `Community 26`, `Community 27`, `Community 30`?**
-  _High betweenness centrality (0.118) - this node is a cross-community bridge._
-- **Why does `BaseModel` connect `Community 45` to `Community 0`, `Community 1`, `Community 2`, `Community 6`, `Community 7`, `get_db_current_user_optional`, `customer.py`, `Community 11`, `Community 12`, `customer_follow.py`, `Community 14`, `Community 15`, `response.py`, `Community 17`, `Community 18`, `Community 16`, `Community 20`, `duty.py`, `Community 19`, `Community 21`, `customer_options`, `Community 29`, `Community 31`, `Community 34`, `Community 37`, `Community 39`, `Community 40`, `Community 41`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 47`, `Community 49`, `Community 51`, `Community 52`, `Community 54`, `Community 55`, `Community 56`, `Community 58`, `Community 61`, `Community 63`, `Community 65`, `Community 71`, `Community 74`, `Community 78`, `allocate_next_biz_no`, `unsettled_plans_q_filter`, `api_request_log_middleware.py`, `test_pl_public_link_archived.py`, `redis_client.py`, `BaseStorage`, `apply_pl_scope`, `monitor.py`, `Community 119`, `customer_follow.py`, `customer_options`, `ethnic.py`?**
-  _High betweenness centrality (0.118) - this node is a cross-community bridge._
+- **Why does `generate_uuid()` connect `Community 61` to `Community 0`, `_filter_export_rows_by_ids`, `Community 2`, `Community 4`, `Community 5`, `Community 6`, `inventory_id.py`, `Community 8`, `Community 11`, `Community 13`, `Community 15`, `calc_age_from_chinese_id_card`, `Community 17`, `Community 18`, `Community 19`, `list_product_options`, `get_db_current_user_optional`, `Community 23`, `Community 24`, `Community 25`, `pl_feedback_brand_qty.py`, `Community 21`, `Community 28`, `Community 29`, `Community 31`, `Community 32`, `Community 33`, `Community 34`, `get_client_ip`, `Community 37`, `Community 36`, `Community 40`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 48`, `Community 50`, `Community 51`, `Community 62`, `Community 65`, `Community 67`, `Community 72`, `Community 74`, `Community 78`, `PlCarrier`, `customer_follow.py`, `Community 83`, `allocate_next_biz_no`, `Community 87`, `CrmProduct`, `pl_ocr_service.py`, `WechatMessageService`, `unsettled_plans_q_filter`, `Community 92`, `contact.py`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `site.py`, `apply_pl_scope`, `pool_rule.py`, `dict_type.py`, `dept.py`, `Community 116`, `Community 118`, `post.py`, `LocalStorage`, `ethnic.py`?**
+  _High betweenness centrality (0.137) - this node is a cross-community bridge._
+- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 73`, `Community 42`, `Community 59`, `statistics.py`, `Community 44`, `Community 55`, `Community 57`, `Community 26`, `Community 27`, `Community 30`?**
+  _High betweenness centrality (0.126) - this node is a cross-community bridge._
+- **Why does `BaseModel` connect `customer_options` to `Community 0`, `Community 1`, `Community 2`, `Community 5`, `Community 6`, `Community 7`, `get_db_current_user_optional`, `Community 11`, `Community 12`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `Community 19`, `Community 20`, `Community 21`, `response.py`, `calc_age_from_chinese_id_card`, `Community 29`, `Community 33`, `Community 34`, `Community 37`, `Community 39`, `Community 41`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 51`, `Community 52`, `Community 54`, `Community 56`, `Community 58`, `Community 61`, `Community 63`, `Community 65`, `Community 66`, `Community 69`, `Community 71`, `Community 74`, `apply_crm_create_by_scope`, `Community 78`, `PlCarrier`, `customer_follow.py`, `unsettled_plans_q_filter`, `test_pl_public_link_archived.py`, `tenant.py`, `pl_internal_customer.py`, `site.py`, `Community 119`, `ethnic.py`, `Any`?**
+  _High betweenness centrality (0.109) - 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?**
-  _646 weakly-connected nodes found - possible documentation gaps or missing edges._
+  _654 weakly-connected nodes found - possible documentation gaps or missing edges._
 - **Should `Community 0` be split into smaller, more focused modules?**
-  _Cohesion score 0.03823677945314191 - nodes in this community are weakly interconnected._
+  _Cohesion score 0.05154639175257732 - 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._

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/tests/test_pl_plan_contract_gap.py

@@ -1,7 +1,13 @@
 from sqlalchemy.dialects import mysql
 
+from app.schemas.pl.plan import PlanDeliveryRead, PlanLoadRead
 from app.services.pl_internal_customer import INTERNAL_CUSTOMER_NAMES
-from app.services.pl_plan_contract_gap import compute_contract_gap_sides, plan_has_contract_gap_exists
+from app.services.pl_plan_contract_gap import (
+    compute_contract_gap_sides,
+    compute_plan_gap_sides_from_stops,
+    plan_has_contract_gap_exists,
+    stop_contract_gap,
+)
 
 INTERNAL = next(iter(INTERNAL_CUSTOMER_NAMES))
 
@@ -56,6 +62,74 @@ def test_empty_names_treated_as_non_internal_gap_both():
     assert sides == ["supplier", "demander"]
 
 
+def test_stop_contract_gap_internal_exempt():
+    assert stop_contract_gap(INTERNAL, 0) is False
+    assert stop_contract_gap("外部客户", 0) is True
+    assert stop_contract_gap("外部客户", 1) is False
+
+
+def test_compute_plan_gap_sides_from_stops_multi_delivery():
+    load = PlanLoadRead(
+        id="load1",
+        planId="p1",
+        tenantNo="t1",
+        customerName=INTERNAL,
+        products=[],
+        contracts=[],
+        createTime="2026-08-27T00:00:00",
+        updateTime="2026-08-27T00:00:00",
+    )
+    delivery_ok = PlanDeliveryRead(
+        id="d1",
+        planId="p1",
+        tenantNo="t1",
+        seq=1,
+        customerName="外部客户A",
+        products=[],
+        contracts=[{"contractId": "c1", "contractNo": "HT001"}],
+        createTime="2026-08-27T00:00:00",
+        updateTime="2026-08-27T00:00:00",
+    )
+    delivery_gap = PlanDeliveryRead(
+        id="d2",
+        planId="p1",
+        tenantNo="t1",
+        seq=2,
+        customerName="外部客户B",
+        products=[],
+        contracts=[],
+        createTime="2026-08-27T00:00:00",
+        updateTime="2026-08-27T00:00:00",
+    )
+    sides = compute_plan_gap_sides_from_stops(load, [delivery_ok, delivery_gap])
+    assert sides == ["demander"]
+
+
+def test_compute_plan_gap_sides_from_stops_internal_load_no_gap():
+    load = PlanLoadRead(
+        id="load1",
+        planId="p1",
+        tenantNo="t1",
+        customerName=INTERNAL,
+        products=[],
+        contracts=[],
+        createTime="2026-08-27T00:00:00",
+        updateTime="2026-08-27T00:00:00",
+    )
+    delivery = PlanDeliveryRead(
+        id="d1",
+        planId="p1",
+        tenantNo="t1",
+        seq=1,
+        customerName=INTERNAL,
+        products=[],
+        contracts=[],
+        createTime="2026-08-27T00:00:00",
+        updateTime="2026-08-27T00:00:00",
+    )
+    assert compute_plan_gap_sides_from_stops(load, [delivery]) == []
+
+
 def _compile(clause) -> str:
     return str(
         clause.compile(dialect=mysql.dialect(), compile_kwargs={"literal_binds": True})
@@ -67,5 +141,5 @@ def test_plan_has_contract_gap_exists_mentions_contract_and_internal_names():
     sql = _compile(clause)
 
     assert "pl_plan_contract" in sql
-    assert "supplier" in sql
-    assert "demander" in sql
+    assert "pl_plan_load" in sql
+    assert "pl_plan_delivery" in sql