shanxia2.0/backend/graphify-out/2026-08-26/GRAPH_REPORT.md

# Graph Report - backend  (2026-08-26)

## Corpus Check
- 354 files · ~248,721 words
- Verdict: corpus is large enough that graph structure adds value.

## Summary
- 5068 nodes · 19179 edges · 173 communities (157 shown, 16 thin omitted)
- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 1002 edges (avg confidence: 0.52)
- Token cost: 0 input · 0 output

## Graph Freshness
- Built from commit: `e56d227f`
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
- Run `graphify update .` after code changes (no API cost).

## Community Hubs (Navigation)
- [[_COMMUNITY_Community 0|Community 0]]
- [[_COMMUNITY_Community 1|Community 1]]
- [[_COMMUNITY_Community 2|Community 2]]
- [[_COMMUNITY_Community 3|Community 3]]
- [[_COMMUNITY_Community 4|Community 4]]
- [[_COMMUNITY_Community 5|Community 5]]
- [[_COMMUNITY_Community 6|Community 6]]
- [[_COMMUNITY_Community 7|Community 7]]
- [[_COMMUNITY_Community 8|Community 8]]
- [[_COMMUNITY_Community 9|Community 9]]
- [[_COMMUNITY_Community 10|Community 10]]
- [[_COMMUNITY_Community 11|Community 11]]
- [[_COMMUNITY_Community 12|Community 12]]
- [[_COMMUNITY_Community 13|Community 13]]
- [[_COMMUNITY_Community 14|Community 14]]
- [[_COMMUNITY_Community 15|Community 15]]
- [[_COMMUNITY_Community 16|Community 16]]
- [[_COMMUNITY_Community 17|Community 17]]
- [[_COMMUNITY_Community 18|Community 18]]
- [[_COMMUNITY_Community 19|Community 19]]
- [[_COMMUNITY_Community 20|Community 20]]
- [[_COMMUNITY_Community 21|Community 21]]
- [[_COMMUNITY_Community 22|Community 22]]
- [[_COMMUNITY_Community 23|Community 23]]
- [[_COMMUNITY_Community 24|Community 24]]
- [[_COMMUNITY_Community 25|Community 25]]
- [[_COMMUNITY_Community 26|Community 26]]
- [[_COMMUNITY_Community 27|Community 27]]
- [[_COMMUNITY_Community 28|Community 28]]
- [[_COMMUNITY_Community 29|Community 29]]
- [[_COMMUNITY_Community 30|Community 30]]
- [[_COMMUNITY_Community 31|Community 31]]
- [[_COMMUNITY_Community 32|Community 32]]
- [[_COMMUNITY_Community 33|Community 33]]
- [[_COMMUNITY_Community 34|Community 34]]
- [[_COMMUNITY_Community 35|Community 35]]
- [[_COMMUNITY_Community 36|Community 36]]
- [[_COMMUNITY_Community 37|Community 37]]
- [[_COMMUNITY_Community 38|Community 38]]
- [[_COMMUNITY_Community 39|Community 39]]
- [[_COMMUNITY_Community 40|Community 40]]
- [[_COMMUNITY_Community 41|Community 41]]
- [[_COMMUNITY_Community 42|Community 42]]
- [[_COMMUNITY_Community 43|Community 43]]
- [[_COMMUNITY_Community 44|Community 44]]
- [[_COMMUNITY_Community 45|Community 45]]
- [[_COMMUNITY_Community 46|Community 46]]
- [[_COMMUNITY_Community 47|Community 47]]
- [[_COMMUNITY_Community 48|Community 48]]
- [[_COMMUNITY_Community 49|Community 49]]
- [[_COMMUNITY_Community 50|Community 50]]
- [[_COMMUNITY_Community 51|Community 51]]
- [[_COMMUNITY_Community 52|Community 52]]
- [[_COMMUNITY_Community 53|Community 53]]
- [[_COMMUNITY_Community 54|Community 54]]
- [[_COMMUNITY_Community 55|Community 55]]
- [[_COMMUNITY_Community 56|Community 56]]
- [[_COMMUNITY_Community 57|Community 57]]
- [[_COMMUNITY_Community 58|Community 58]]
- [[_COMMUNITY_Community 59|Community 59]]
- [[_COMMUNITY_Community 60|Community 60]]
- [[_COMMUNITY_Community 61|Community 61]]
- [[_COMMUNITY_Community 62|Community 62]]
- [[_COMMUNITY_Community 63|Community 63]]
- [[_COMMUNITY_Community 64|Community 64]]
- [[_COMMUNITY_Community 65|Community 65]]
- [[_COMMUNITY_Community 66|Community 66]]
- [[_COMMUNITY_Community 67|Community 67]]
- [[_COMMUNITY_Community 68|Community 68]]
- [[_COMMUNITY_Community 69|Community 69]]
- [[_COMMUNITY_Community 70|Community 70]]
- [[_COMMUNITY_Community 71|Community 71]]
- [[_COMMUNITY_Community 72|Community 72]]
- [[_COMMUNITY_Community 73|Community 73]]
- [[_COMMUNITY_Community 74|Community 74]]
- [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]]
- [[_COMMUNITY_opportunity_follow.py|opportunity_follow.py]]
- [[_COMMUNITY_Community 77|Community 77]]
- [[_COMMUNITY_Community 78|Community 78]]
- [[_COMMUNITY_PlCarrier|PlCarrier]]
- [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
- [[_COMMUNITY_customer_follow.py|customer_follow.py]]
- [[_COMMUNITY_Community 83|Community 83]]
- [[_COMMUNITY_Community 84|Community 84]]
- [[_COMMUNITY_allocate_next_biz_no|allocate_next_biz_no]]
- [[_COMMUNITY_Community 86|Community 86]]
- [[_COMMUNITY_Community 87|Community 87]]
- [[_COMMUNITY_CrmProduct|CrmProduct]]
- [[_COMMUNITY_pl_ocr_service.py|pl_ocr_service.py]]
- [[_COMMUNITY_WechatMessageService|WechatMessageService]]
- [[_COMMUNITY_Community 92|Community 92]]
- [[_COMMUNITY_api_request_log_middleware.py|api_request_log_middleware.py]]
- [[_COMMUNITY_assert_contract_editable_for_update|assert_contract_editable_for_update]]
- [[_COMMUNITY_test_pl_public_link_archived.py|test_pl_public_link_archived.py]]
- [[_COMMUNITY_minio_url.py|minio_url.py]]
- [[_COMMUNITY_contact.py|contact.py]]
- [[_COMMUNITY_LocalStorage|LocalStorage]]
- [[_COMMUNITY_redis_client.py|redis_client.py]]
- [[_COMMUNITY_price_letter_detail|price_letter_detail]]
- [[_COMMUNITY_tenant.py|tenant.py]]
- [[_COMMUNITY_BaseStorage|BaseStorage]]
- [[_COMMUNITY_pl_internal_customer.py|pl_internal_customer.py]]
- [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]]
- [[_COMMUNITY_pool_customer_assign|pool_customer_assign]]
- [[_COMMUNITY_site.py|site.py]]
- [[_COMMUNITY_apply_pl_scope|apply_pl_scope]]
- [[_COMMUNITY_statistics.py|statistics.py]]
- [[_COMMUNITY_test_pl_plan_stop_rules.py|test_pl_plan_stop_rules.py]]
- [[_COMMUNITY_list_duty_staff_users|list_duty_staff_users]]
- [[_COMMUNITY_merge_duplicate_crm_customers.py|merge_duplicate_crm_customers.py]]
- [[_COMMUNITY_dict_type.py|dict_type.py]]
- [[_COMMUNITY_crm_models.py|crm_models.py]]
- [[_COMMUNITY_site.py|site.py]]
- [[_COMMUNITY_Community 116|Community 116]]
- [[_COMMUNITY_parse_hhmm|parse_hhmm]]
- [[_COMMUNITY_Community 118|Community 118]]
- [[_COMMUNITY_Community 119|Community 119]]
- [[_COMMUNITY_oper_log_decorator.py|oper_log_decorator.py]]
- [[_COMMUNITY_post.py|post.py]]
- [[_COMMUNITY_site.py|site.py]]
- [[_COMMUNITY_customer_options|customer_options]]
- [[_COMMUNITY_LocalStorage|LocalStorage]]
- [[_COMMUNITY_ethnic.py|ethnic.py]]
- [[_COMMUNITY_product_allowed|product_allowed]]
- [[_COMMUNITY_BaseStorage|BaseStorage]]
- [[_COMMUNITY__filter_export_rows_by_ids|_filter_export_rows_by_ids]]
- [[_COMMUNITY_resolve_crm_product|resolve_crm_product]]
- [[_COMMUNITY_context.py|context.py]]
- [[_COMMUNITY_inventory_id.py|inventory_id.py]]
- [[_COMMUNITY_list_contacts|list_contacts]]
- [[_COMMUNITY_Community 136|Community 136]]
- [[_COMMUNITY_get_db_current_user_optional|get_db_current_user_optional]]
- [[_COMMUNITY_Community 138|Community 138]]
- [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]]
- [[_COMMUNITY_UserRole|UserRole]]
- [[_COMMUNITY_admin_request_json.py|admin_request_json.py]]
- [[_COMMUNITY_.to_list_kwargs|.to_list_kwargs]]
- [[_COMMUNITY_Community 147|Community 147]]
- [[_COMMUNITY_Community 151|Community 151]]
- [[_COMMUNITY_customer_options|customer_options]]
- [[_COMMUNITY_.to_tenant_user_dict|.to_tenant_user_dict]]
- [[_COMMUNITY_get_client_ip|get_client_ip]]
- [[_COMMUNITY_codeblock1 (iflytekshanxia2.0backend)|code:block1 (/iflytek/shanxia2.0/backend)]]
- [[_COMMUNITY_resolve_create_time_bounds|resolve_create_time_bounds]]
- [[_COMMUNITY_test_pl_vehicle_personnel_photo_schema.py|test_pl_vehicle_personnel_photo_schema.py]]
- [[_COMMUNITY_crm_quote_pdf.py|crm_quote_pdf.py]]
- [[_COMMUNITY_shanxia2.0 后端骨架（FastAPI）|shanxia2.0 后端骨架（FastAPI）]]
- [[_COMMUNITY_api_crypto_middleware.py|api_crypto_middleware.py]]
- [[_COMMUNITY_order_status_compat.py|order_status_compat.py]]
- [[_COMMUNITY_shanxia2.0 Backend 生产部署说明|shanxia2.0 Backend 生产部署说明]]
- [[_COMMUNITY_db_collation.py|db_collation.py]]
- [[_COMMUNITY___init__.py|__init__.py]]
- [[_COMMUNITY___init__.py|__init__.py]]
- [[_COMMUNITY_codebash (cd pathtoshanxia2.0)|code:bash (cd /path/to/shanxia2.0)]]
- [[_COMMUNITY_codebash (.start-prod.sh status     查看状态)|code:bash (./start-prod.sh status    # 查看状态)]]
- [[_COMMUNITY_codebash (curl -s http127.0.0.19111health)|code:bash (curl -s http://127.0.0.1:9111/health)]]
- [[_COMMUNITY_codebash (cd iflytekshanxia2.0backend)|code:bash (cd /iflytek/shanxia2.0/backend)]]
- [[_COMMUNITY_codebash (python -m venv venv)|code:bash (python -m venv venv)]]
- [[_COMMUNITY_codebash (pip install -r requirements.txt)|code:bash (pip install -r requirements.txt)]]
- [[_COMMUNITY_codeenv ( 数据库配置)|code:env (# 数据库配置)]]
- [[_COMMUNITY_codebash (uvicorn app.mainapp --reload --port 8000)|code:bash (uvicorn app.main:app --reload --port 8000)]]
- [[_COMMUNITY_BaseModel|BaseModel]]
- [[_COMMUNITY_PlanResourceSnapshotMixin|PlanResourceSnapshotMixin]]

## God Nodes (most connected - your core abstractions)
1. `BaseModel` - 526 edges
2. `get_tenant_no()` - 384 edges
3. `DbUserContext` - 308 edges
4. `success_response()` - 278 edges
5. `error_response()` - 273 edges
6. `generate_uuid()` - 211 edges
7. `BxUserContext` - 204 edges
8. `crm_user_info()` - 138 edges
9. `ExportValidationError` - 108 edges
10. `ExportColumn` - 106 edges

## Surprising Connections (you probably didn't know these)
- `BackfillRule` --uses--> `Settings`  [INFERRED]
  scripts/migrate_crm_sys_oss.py → app/core/config.py
- `MigrationStats` --uses--> `Settings`  [INFERRED]
  scripts/migrate_bx_data.py → app/core/config.py
- `StepStats` --uses--> `Settings`  [INFERRED]
  scripts/migrate_bx_data.py → app/core/config.py
- `MigrationStats` --uses--> `Settings`  [INFERRED]
  scripts/migrate_crm_clue.py → app/core/config.py
- `StepStats` --uses--> `Settings`  [INFERRED]
  scripts/migrate_crm_clue.py → app/core/config.py

## Import Cycles
- None detected.

## Communities (173 total, 16 thin omitted)

### Community 0 - "Community 0"
Cohesion: 0.15
Nodes (22): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName（用 nick_name）。 (+14 more)

### Community 1 - "Community 1"
Cohesion: 0.07
Nodes (35): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractApprovalPassBody, ContractApprovalRejectBody, ContractApprovalTransferBody, ContractBatchAssignBody, ContractBatchSubmitBody (+27 more)

### Community 2 - "Community 2"
Cohesion: 0.14
Nodes (39): dump_export_row(), issue_status_label(), Any, Session, respond_xlsx(), status_label(), advance_issue_stats(), batch_offset() (+31 more)

### Community 3 - "Community 3"
Cohesion: 0.06
Nodes (88): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+80 more)

### Community 4 - "Community 4"
Cohesion: 0.11
Nodes (62): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+54 more)

### Community 5 - "Community 5"
Cohesion: 0.04
Nodes (141): archive_plan(), _build_plan_archive_export_rows(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract(), create_plan(), create_plan_full(), _determine_plan_type() (+133 more)

### Community 6 - "Community 6"
Cohesion: 0.15
Nodes (41): convert_clue(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer(), create_customer(), customer_name_exists(), deal_customer() (+33 more)

### Community 7 - "Community 7"
Cohesion: 0.15
Nodes (32): create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any, date, Session, _row_to_dict() (+24 more)

### Community 8 - "Community 8"
Cohesion: 0.09
Nodes (36): can_user_approve(), invalidate_all_approvals(), 作废该合同全部有效审批记录（含已通过/已拒绝），用于再编辑或重新提审。, 顺序审批：当前步骤 pending 且 is_current=1。      同一审批人若同时存在历史已处理记录与当前轮 pending，优先取 pending, approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals() (+28 more)

### Community 9 - "Community 9"
Cohesion: 0.10
Nodes (48): download_reimburse_import_template(), build_annotated_result_bytes(), build_applicant_label(), build_expense_path_labels(), build_import_template_bytes(), cell_str(), _ids_visible_in_web_tree(), import_reimburse_workbook() (+40 more)

### Community 10 - "Community 10"
Cohesion: 0.06
Nodes (62): export_depts(), export_menus(), export_role_management(), export_tenants(), list_tenants(), 导出角色列表（当前筛选全量，或 ids 已选）。, 导出租户列表（当前筛选全量，或 ids 已选）。, export_inventory_ledger() (+54 more)

### Community 11 - "Community 11"
Cohesion: 0.10
Nodes (59): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), export_urea_applies(), export_urea_disburse_board(), get_apply() (+51 more)

### Community 12 - "Community 12"
Cohesion: 0.07
Nodes (44): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+36 more)

### Community 13 - "Community 13"
Cohesion: 0.08
Nodes (52): bx_health(), 报销（bx）API 路由聚合 — REST 风格，协议对齐 bx 原系统。, P0 健康检查：验证 bx 路由已挂载且响应协议为 code=0。, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse() (+44 more)

### Community 14 - "Community 14"
Cohesion: 0.09
Nodes (60): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_name_from_parties(), _contract_period_key(), contract_row_to_dict(), create_from_opportunity(), download_contract_pdf() (+52 more)

### Community 15 - "Community 15"
Cohesion: 0.11
Nodes (16): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, BxReimburseInvoice, BxReimburseOffset, 报销单勾选的发票附件（同一发票可勾选多个附件，各占一条）。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn (+8 more)

### Community 16 - "Community 16"
Cohesion: 0.07
Nodes (82): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_list(), clue_mine() (+74 more)

### Community 17 - "Community 17"
Cohesion: 0.08
Nodes (40): approve_carrier(), create_carrier(), get_carrier(), list_carriers(), reject_carrier(), update_carrier(), PlCarrier, carrier_to_read() (+32 more)

### Community 18 - "Community 18"
Cohesion: 0.10
Nodes (45): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+37 more)

### Community 19 - "Community 19"
Cohesion: 0.23
Nodes (10): check_customer_protect_time(), pool_recovery_job(), Session, 每天凌晨1点：检查保护期到期客户，跟进次数不足则退回公海, 每天早上9点：保护期到期提醒（3天内到期且跟进不足）, _recycle_to_pool(), remind_customer_recycle(), warn_customer_recycle() (+2 more)

### Community 20 - "Community 20"
Cohesion: 0.17
Nodes (25): create_vehicle(), get_vehicle(), list_personnel(), list_vehicles(), _personnel_to_read(), update_vehicle(), _vehicle_to_detail(), _vehicle_to_read() (+17 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)

### 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.07
Nodes (55): _as_date(), _build_driver_url(), _build_public_page(), _build_stop_product_reads(), _format_file_size(), _format_plan_date(), get_public_transport(), get_public_transport_history() (+47 more)

### Community 24 - "Community 24"
Cohesion: 0.12
Nodes (29): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), menu_name_exists(), Any (+21 more)

### Community 25 - "Community 25"
Cohesion: 0.26
Nodes (12): list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析（替代 Hutool UserAgentUtil）, Java: queryLogsByQuoteId (+4 more)

### Community 26 - "Community 26"
Cohesion: 0.13
Nodes (28): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply() (+20 more)

### Community 27 - "Community 27"
Cohesion: 0.10
Nodes (33): CRM 报价单 API 路由 — 挂接到 crm.router, total_pages(), QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody (+25 more)

### Community 28 - "Community 28"
Cohesion: 0.05
Nodes (109): check_document_expiry(), document_reminder_stats(), DocumentReminderExportBody, export_document_reminders(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions() (+101 more)

### Community 29 - "Community 29"
Cohesion: 0.10
Nodes (29): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+21 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.11
Nodes (7): convert_heic_to_jpeg(), OSSStorage, process_image_content(), QiniuStorage, 文件存储工具模块  支持多种存储方式： 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 将 HEIC/HEIF 格式转换为 JPEG 格式, 处理图片内容，如果是 HEIC 格式则转换为 JPEG

### Community 32 - "Community 32"
Cohesion: 0.15
Nodes (27): 验证密码（哈希非 bcrypt 或损坏时返回 False，避免抛错）, verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+19 more)

### Community 33 - "Community 33"
Cohesion: 0.16
Nodes (30): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), export_plans(), _generate_plan_no() (+22 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)

### 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.08
Nodes (58): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _collect_category_with_ancestors(), create_category() (+50 more)

### Community 37 - "Community 37"
Cohesion: 0.11
Nodes (33): PlPlanDelivery, PlPlanDeliveryProduct, PlPlanLoad, PlPlanLoadProduct, 运输计划-装货段 pl_plan_load（plan 1:1）, 运输计划-装货段产品明细 pl_plan_load_product, 运输计划-送货段 pl_plan_delivery（plan 1:N）, 运输计划-送货段产品明细 pl_plan_delivery_product (+25 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.13
Nodes (28): PlInventoryTransaction, 库存流水表 pl_inventory_transaction, load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 按计划产品明细 ID 批量加载归档品牌数量（brandId/brandName/qty）。 (+20 more)

### Community 40 - "Community 40"
Cohesion: 0.10
Nodes (32): build_dict_value_from_label(), ensure_dict_data(), grab(), join_work_plans(), list_duty_staff_users(), normalize_person_name(), _pad_hhmm(), parse_time_range_input() (+24 more)

### Community 41 - "Community 41"
Cohesion: 0.22
Nodes (27): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+19 more)

### Community 42 - "Community 42"
Cohesion: 0.05
Nodes (103): _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() (+95 more)

### Community 43 - "Community 43"
Cohesion: 0.09
Nodes (37): BxExportBodyBase, create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices() (+29 more)

### Community 44 - "Community 44"
Cohesion: 0.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.27
Nodes (53): AttachmentDownloadUrlBody, demo_xlsx_export(), DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody (+45 more)

### Community 46 - "Community 46"
Cohesion: 0.15
Nodes (33): _apply_contract_entity_fields(), _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _change_row_to_dict(), contract_no_exists(), create_contract(), create_contract_change() (+25 more)

### Community 47 - "Community 47"
Cohesion: 0.16
Nodes (32): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+24 more)

### Community 48 - "Community 48"
Cohesion: 0.17
Nodes (24): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), execute_change(), export_contract_changes(), export_contract_templates(), _get_change_row(), list_contract_changes(), list_contract_templates() (+16 more)

### Community 49 - "Community 49"
Cohesion: 0.18
Nodes (16): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+8 more)

### Community 50 - "Community 50"
Cohesion: 0.11
Nodes (44): PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, DeliverySlipPrintRead, PlanContractLink, PlanDeliveryBody, PlanDeliveryRead, PlanLoadBody, PlanLoadRead (+36 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.16
Nodes (25): put_plan_side_contracts(), PlanContractGapRead, is_internal_customer_name(), 运输计划：内置山峡/云栋客户判定（合同可免）, build_plan_contract_gap_read(), compute_contract_gap_sides(), _demander_gap_expr(), list_plan_contract_gaps() (+17 more)

### Community 53 - "Community 53"
Cohesion: 0.20
Nodes (31): 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() (+23 more)

### Community 54 - "Community 54"
Cohesion: 0.16
Nodes (29): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing(), _get_weighing(), get_weighing_related() (+21 more)

### Community 55 - "Community 55"
Cohesion: 0.06
Nodes (37): category_add(), category_delete(), category_tree(), category_update(), clue_import(), _map_product_export_column_keys(), product_add(), product_delete() (+29 more)

### Community 56 - "Community 56"
Cohesion: 0.11
Nodes (31): 返回 (作废, 归档)。现场链接实际走入库/出库单公共页。, _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() (+23 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.11
Nodes (32): ReimburseDetailOut, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时，进度接口仅展示当前轮次。, 审批进度仅展示当前轮次；完整历史由 get_approval_history 返回。, allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title() (+24 more)

### Community 59 - "Community 59"
Cohesion: 0.20
Nodes (28): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+20 more)

### Community 60 - "Community 60"
Cohesion: 0.19
Nodes (7): _guess_preview_content_type(), MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint；未配置或与内网相同时复用 self.client。, 按对象键后缀推断内联预览 Content-Type（纠正上传时未写入 MIME 的情况）。, MinIO 预签名下载 URL，携带原始文件名。, MinIO 预签名内联预览 URL（图片新标签页 / PDF iframe 等）。          上传时 put_object 未写 content_typ

### Community 61 - "Community 61"
Cohesion: 0.08
Nodes (62): cancel_plan(), 作废运输计划：取消跟进状态、作废关联地磅出入库单、取消运输单。, PlTransportDbLink, PlTransportSiteLink, 运输-地磅出入库关联 pl_transport_db_link, 运输计划现场链接 pl_transport_site_link（与地磅出入库单解耦）, _apply_plan_quantity_delta(), apply_stop_dibang_options() (+54 more)

### Community 62 - "Community 62"
Cohesion: 0.10
Nodes (51): assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value(), _enrich_contact_fields(), _enrich_supplier_name() (+43 more)

### Community 63 - "Community 63"
Cohesion: 0.10
Nodes (59): bind_vehicle_driver(), CarrierExportBody, create_driver(), create_personnel(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle() (+51 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.11
Nodes (53): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), get_apply(), get_process(), list_reminders() (+45 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)

### Community 67 - "Community 67"
Cohesion: 0.12
Nodes (36): get_password_hash(), Namespace, build_merged_users(), bx_role_labels(), check_minio(), check_mysql(), check_redis(), _clip() (+28 more)

### Community 68 - "Community 68"
Cohesion: 0.24
Nodes (18): _actor_ids(), _actor_names(), assert_row_deletable_by_creator(), assert_rows_deletable_by_creator(), can_delete_by_creator(), is_super_admin(), normalize_user_info(), Any (+10 more)

### Community 69 - "Community 69"
Cohesion: 0.17
Nodes (27): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version(), get_nodes_by_version(), get_pending_tasks_by_node() (+19 more)

### Community 70 - "Community 70"
Cohesion: 0.24
Nodes (20): register_quote_routes(), accept_quote(), _ensure_quote_in_scope(), generate_pdf(), generate_share(), get_quote(), get_quote_detail(), _get_quote_in_scope() (+12 more)

### Community 71 - "Community 71"
Cohesion: 0.08
Nodes (25): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_list(), clue_follow_update() (+17 more)

### Community 72 - "Community 72"
Cohesion: 0.25
Nodes (18): batch_generate_sample_codes(), batch_issue_sample_codes(), batch_revoke_sample_codes(), create_sample_code(), get_sample_code(), list_sample_codes(), _parse_issued_time(), Any (+10 more)

### Community 73 - "Community 73"
Cohesion: 0.20
Nodes (25): derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+17 more)

### Community 74 - "Community 74"
Cohesion: 0.27
Nodes (18): get_plan_related(), format_datetime(), _create_by_name(), datetime_end_of_day(), fmt_date(), fmt_datetime(), inventory_date_to_api(), inventory_to_read() (+10 more)

### Community 75 - "apply_crm_create_by_scope"
Cohesion: 0.13
Nodes (32): apply_crm_create_by_scope(), ensure_crm_create_by_row_in_scope(), create_pool_rule(), delete_pool_rules(), execute_pool_rules(), _execute_single_rule(), get_pool_rule(), list_pool_rules() (+24 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)

### Community 77 - "Community 77"
Cohesion: 0.11
Nodes (12): get_wechat_pay_client(), get_wechat_pay_v2(), Any, 微信支付工具模块  支持微信支付 V3 API 文档参考: https://pay.weixin.qq.com/docs/v3/apis/index.html, 统一下单接口 (V3)          Args:             out_trade_no: 商户订单号             total_amo, 申请退款          Args:             out_trade_no: 商户订单号             total_amount: 订单, 小程序调起支付的二次签名参数（与公众号 JSAPI 规则一致）, 统一下单 (V2 API)          Args:             out_trade_no: 商户订单号             total_f (+4 more)

### Community 78 - "Community 78"
Cohesion: 0.24
Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType

### Community 79 - "PlCarrier"
Cohesion: 0.17
Nodes (11): price_letter_add(), price_letter_detail(), price_letter_list(), price_letter_update(), price_letter_void(), PriceLetterCreateBody, PriceLetterDetailBody, PriceLetterListBody (+3 more)

### Community 80 - "resolve_crm_product"
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 81 - "customer_follow.py"
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.17
Nodes (28): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), create_approval_records() (+20 more)

### Community 84 - "Community 84"
Cohesion: 0.10
Nodes (32): 微信消息通知服务  支持微信小程序模板消息推送  使用方式:     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_ (+24 more)

### Community 85 - "allocate_next_biz_no"
Cohesion: 0.14
Nodes (41): assign_clues(), check_convert(), check_duplicate_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope(), create_clue_follow(), delete_clue_follow() (+33 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)

### Community 87 - "Community 87"
Cohesion: 0.15
Nodes (14): 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 等价） (+6 more)

### Community 88 - "CrmProduct"
Cohesion: 0.23
Nodes (17): PlCustomerStopPref, 客户装/送货物流默认记忆 pl_customer_stop_pref, _as_str(), build_stop_pref_upsert_items(), get_customer_stop_pref(), Any, Session, 供 plan 保存调用；异常由调用方用 savepoint 吞掉。 (+9 more)

### Community 89 - "pl_ocr_service.py"
Cohesion: 0.19
Nodes (22): PlOcrUsageMonth, 阿里云 OCR 月度调用计数 pl_ocr_usage_month（按自然月全局统计）, assert_quota_available(), _build_ocr_client(), compress_image_bytes(), current_usage_month(), _first_attachment_url(), get_or_create_usage_row() (+14 more)

### Community 90 - "WechatMessageService"
Cohesion: 0.37
Nodes (14): create_opportunity_follow(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime(), Any, datetime, Session (+6 more)

### Community 92 - "Community 92"
Cohesion: 0.20
Nodes (21): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+13 more)

### Community 93 - "api_request_log_middleware.py"
Cohesion: 0.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 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
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.16
Nodes (19): ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+11 more)

### Community 97 - "contact.py"
Cohesion: 0.07
Nodes (38): list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单）, Session (+30 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.14
Nodes (20): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, VehiclePersonnelRow, build_personnel_summary(), load_vehicle_personnel_rows(), load_vehicle_personnel_summaries(), Session (+12 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.60
Nodes (5): product_allowed(), test_dual_requires_both(), test_explosive_only_requires_allow_explosive(), test_plain_always_allowed(), test_toxic_only_requires_allow_toxic()

### Community 102 - "BaseStorage"
Cohesion: 0.05
Nodes (72): clue_import_template(), contact_add(), contact_delete(), contact_update(), customer_create(), customer_import_template(), opportunity_add(), opportunity_assign() (+64 more)

### Community 103 - "pl_internal_customer.py"
Cohesion: 0.27
Nodes (10): apply_product_snapshot_to_inventory(), ProductSnapshot, Session, 地磅模块 — CRM 产品解析与快照写入。, 校验 CRM 产品并返回名称/规格快照。新建单据 product_id 必填。      require_on_shelf=False 用于运输计划联动地磅等历, resolve_crm_product(), _product(), resolve_crm_product：运输联动场景允许已下架产品。 (+2 more)

### Community 104 - "apply_crm_create_by_scope"
Cohesion: 0.16
Nodes (23): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), create_price_letter(), get_price_letter() (+15 more)

### Community 105 - "pool_customer_assign"
Cohesion: 0.14
Nodes (13): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_update(), pool_rule_update_status(), PoolRuleAddBody, PoolRuleDeleteBody (+5 more)

### Community 106 - "site.py"
Cohesion: 0.11
Nodes (51): _build_public_page(), _format_file_size(), _format_plan_date(), get_public_transport_site(), _get_transport_by_site_token(), Session, UploadFile, 运输计划 · 现场按段免登录公共 API（一车多卸） (+43 more)

### Community 107 - "apply_pl_scope"
Cohesion: 0.09
Nodes (37): CompletedTaskExportBody, MyInstanceExportBody, PendingTaskExportBody, ProcessDefCreateBody, ProcessDefExportBody, ProcessDefUpdateBody, PublishVersionBody, 审批意见：前端传 commentText，兼容 comment。 (+29 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.15
Nodes (23): _extract_qty(), _fmt_qty(), Any, Decimal, 运输计划多段：内部客户地磅默认值与数量平衡校验, resolve_stop_dibang_defaults(), _sum_qty(), warn_qty_imbalance() (+15 more)

### Community 110 - "list_duty_staff_users"
Cohesion: 0.33
Nodes (13): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), Any (+5 more)

### Community 112 - "merge_duplicate_crm_customers.py"
Cohesion: 0.26
Nodes (22): Connection, backup_tables(), _contact_key(), discover_merge_pairs(), fetch_customer(), _invoice_key(), load_database_url(), main() (+14 more)

### Community 113 - "dict_type.py"
Cohesion: 0.35
Nodes (11): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), Any, Session, 字典类型 CRUD（sys_dict_type）, _row_to_dict() (+3 more)

### Community 114 - "crm_models.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 115 - "site.py"
Cohesion: 0.12
Nodes (15): _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, 定期 ping MySQL，避免远程库/NAT 回收空闲 TCP 后首请求长时间卡住。 (+7 more)

### Community 116 - "Community 116"
Cohesion: 0.13
Nodes (33): create_from_quote(), _quote_products_to_contract_products(), Java: createFromQuote — 返回合同 id, calculate_subtotal(), _decimal_value(), _ensure_quote_parent_scope(), _get_field(), get_quote_product() (+25 more)

### Community 117 - "parse_hhmm"
Cohesion: 0.31
Nodes (9): format_hhmm(), format_time_label(), parse_hhmm(), test_format_time_label_cross_day(), test_format_time_label_empty(), test_format_time_label_same_day(), test_parse_hhmm(), test_parse_hhmm_invalid_raises() (+1 more)

### Community 118 - "Community 118"
Cohesion: 0.20
Nodes (24): batch_insert_contract_products(), calculate_subtotal(), _decimal_value(), delete_price_tiers_by_contract_id(), delete_products_by_contract_id(), _get_field(), insert_contract_product(), _letter_oss_ids_to_json() (+16 more)

### Community 119 - "Community 119"
Cohesion: 0.12
Nodes (37): CertRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), is_huolala_trailer_no(), match_required_cert_name(), _missing_field_labels() (+29 more)

### Community 120 - "oper_log_decorator.py"
Cohesion: 0.05
Nodes (87): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _make_handlers(), _models(), _parse_history_date() (+79 more)

### Community 121 - "post.py"
Cohesion: 0.39
Nodes (10): create_post(), get_post(), list_posts(), post_code_exists(), Any, Session, _row_to_dict(), soft_delete_post() (+2 more)

### Community 122 - "site.py"
Cohesion: 0.39
Nodes (10): create_site(), get_site(), list_sites(), Any, Session, _row_to_dict(), site_code_exists(), soft_delete_site() (+2 more)

### Community 123 - "customer_options"
Cohesion: 0.04
Nodes (104): RecognizeCertResult, force_plan_follow_status(), 强制修改跟进状态（仅改字段，不作废联动、不补运输安排）。需权限 pl:plan:force-follow-status。, PageResult, ResponseModel, BaseModel, ContactByCustomerBody, ContactDetailBody (+96 more)

### Community 125 - "ethnic.py"
Cohesion: 0.36
Nodes (7): list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), 民族码表 sys_ethnic（国标 GB/T 3304，全局）, SysEthnic

### Community 128 - "product_allowed"
Cohesion: 0.24
Nodes (12): get_last_month_range(), month_range(), date, Session, 地磅计划按月自动生成 — 迁移自 simple-dibang-xiaoshou/auto-create-plan/auto_create_monthly_pla, 按月自动生成采购计划。      - 默认仅在每月 1 日执行（force=True 时跳过该限制，供手动触发验收）     - 遍历所有租户，按上月计划模板生, run_auto_generate_monthly_plans(), default_execution_status() (+4 more)

### Community 129 - "BaseStorage"
Cohesion: 0.12
Nodes (24): _auto_contract_name_body(), generate_contract_name(), 按面板单位全称精确匹配交易主体/客户主数据，取 shortName；对不上则用全称。, 前端预览误用单位全称时，名称片段会等于面板/客户/开票全称。, 按面板供方(partyA)-需方(partyB)生成：{供方简称}-{需方简称}（{合同编号}）。      - 名称为空：按主数据简称自动生成     - 名, resolve_party_short_name(), _strip_contract_name_no_suffix(), _user_contract_name_uses_party_full_name() (+16 more)

### Community 130 - "_filter_export_rows_by_ids"
Cohesion: 0.18
Nodes (17): get_user_menu_codes(), Session, 读取用户授权的菜单权限标识集合（与前端 meta.menuCode / perms 对齐）。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), _map_role_name_to_web(), Session (+9 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)

### Community 132 - "context.py"
Cohesion: 0.14
Nodes (21): generate_uuid(), get_current_time(), parse_datetime(), datetime, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime (+13 more)

### Community 133 - "inventory_id.py"
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 137 - "get_db_current_user_optional"
Cohesion: 0.29
Nodes (8): get_current_user(), get_current_user_by_token(), Session, 根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）, 获取当前用户（sync 依赖，配合 sync 路由在线程池执行，避免阻塞事件循环）。, get_db_current_user_optional(), Session, 有 Bearer 且为 admin/super_admin 时返回上下文，否则 None（供三方 H5 无登录调用）。

### 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 144 - "admin_request_json.py"
Cohesion: 0.10
Nodes (45): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements(), export_unsettled_plans(), _generate_settlement_no() (+37 more)

### Community 146 - ".to_list_kwargs"
Cohesion: 0.12
Nodes (29): API 路由包 — 山峡化工生产一体化门户, create_leave(), delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody (+21 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 152 - "customer_options"
Cohesion: 0.12
Nodes (22): customer_dealed(), customer_key(), customer_list(), customer_long_time_no_follow(), customer_mine(), customer_options(), customer_to_follow(), customer_week_new() (+14 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.11
Nodes (36): _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` 字段约定一致。 (+28 more)

### Community 173 - "resolve_create_time_bounds"
Cohesion: 0.07
Nodes (68): _build_driver_url(), ContractGapExportBody, get_plan_arrange_info(), PlanExportBody, 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport() (+60 more)

### Community 179 - "test_pl_vehicle_personnel_photo_schema.py"
Cohesion: 0.27
Nodes (16): add_favorite(), count_active(), find_active(), find_soft_deleted(), list_favorites(), _next_order_num(), normalize_menu_path(), Any (+8 more)

### Community 206 - "crm_quote_pdf.py"
Cohesion: 0.36
Nodes (10): build_quote_html(), _default_value(), _format_date(), _format_discount(), _format_money(), generate_quote_pdf(), _get_pdf_styles(), Any (+2 more)

### Community 207 - "shanxia2.0 后端骨架（FastAPI）"
Cohesion: 0.18
Nodes (10): 1. 创建虚拟环境, 2. 安装依赖, 3. 配置环境变量, 4. 启动服务, API 路由分组, shanxia2.0 后端骨架（FastAPI）, 开发规范, 快速开始 (+2 more)

### Community 220 - "api_crypto_middleware.py"
Cohesion: 0.13
Nodes (22): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+14 more)

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

### Community 239 - "shanxia2.0 Backend 生产部署说明"
Cohesion: 0.25
Nodes (7): 1. 上传到服务器, 2. 服务器首次启动, 3. 日常运维, 4. 配置文件, 5. 与 Nginx 配合, 6. 常见问题, shanxia2.0 Backend 生产部署说明

### Community 246 - "db_collation.py"
Cohesion: 0.38
Nodes (6): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则，避免 Illegal mix of collations。, 跨表字符串等值比较（JOIN / WHERE）时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci()

## Knowledge Gaps
- **30 isolated node(s):** `Config`, `Config`, `Config`, `Config`, `Config` (+25 more)
  These have ≤1 connection - possible missing edges or undocumented components.
- **16 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.

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

- **Why does `generate_uuid()` connect `context.py` to `product_allowed`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `inventory_id.py`, `Community 11`, `Community 14`, `Community 15`, `Community 17`, `.to_list_kwargs`, `Community 18`, `Community 20`, `Community 21`, `Community 19`, `Community 23`, `Community 24`, `Community 25`, `Community 28`, `Community 29`, `Community 32`, `Community 33`, `Community 34`, `get_client_ip`, `Community 36`, `Community 37`, `Community 39`, `Community 40`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 50`, `Community 51`, `Community 53`, `Community 54`, `Community 58`, `Community 61`, `Community 62`, `Community 63`, `Community 65`, `Community 66`, `Community 67`, `Community 69`, `Community 72`, `apply_crm_create_by_scope`, `Community 83`, `allocate_next_biz_no`, `CrmProduct`, `pl_ocr_service.py`, `WechatMessageService`, `Community 92`, `api_request_log_middleware.py`, `LocalStorage`, `redis_client.py`, `apply_crm_create_by_scope`, `site.py`, `list_duty_staff_users`, `dict_type.py`, `Community 116`, `Community 118`, `oper_log_decorator.py`, `post.py`, `site.py`?**
  _High betweenness centrality (0.159) - this node is a cross-community bridge._
- **Why does `BaseModel` connect `customer_options` to `Community 0`, `Community 1`, `Community 2`, `resolve_crm_product`, `Community 3`, `Community 5`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 15`, `admin_request_json.py`, `Community 16`, `.to_list_kwargs`, `Community 18`, `Community 17`, `Community 20`, `Community 21`, `Community 23`, `customer_options`, `Community 26`, `Community 27`, `Community 28`, `Community 29`, `Community 33`, `Community 34`, `Community 37`, `Community 41`, `Community 43`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 48`, `Community 49`, `Community 50`, `Community 51`, `Community 52`, `Community 54`, `Community 55`, `Community 58`, `Community 63`, `Community 65`, `Community 71`, `opportunity_follow.py`, `PlCarrier`, `resolve_crm_product`, `Community 87`, `test_pl_public_link_archived.py`, `contact.py`, `redis_client.py`, `BaseStorage`, `pool_customer_assign`, `site.py`, `apply_pl_scope`, `crm_models.py`, `Community 119`, `oper_log_decorator.py`?**
  _High betweenness centrality (0.111) - this node is a cross-community bridge._
- **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 73`, `Community 42`, `statistics.py`, `Community 44`, `Community 57`, `Community 59`, `api_crypto_middleware.py`, `Community 30`?**
  _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?**
  _636 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `Community 1` be split into smaller, more focused modules?**
  _Cohesion score 0.0743321718931475 - nodes in this community are weakly interconnected._
- **Should `Community 2` be split into smaller, more focused modules?**
  _Cohesion score 0.13510520487264674 - nodes in this community are weakly interconnected._