0 Fork 0

Files

T

zlwuandCursor 7a5b8c3d96 chore: update graphify after plan-archive price permission

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-09-03 16:48:28 +08:00

94 KiB

Raw Blame History

Graph Report - backend (2026-09-03)

Corpus Check

370 files · ~260,140 words
Verdict: corpus is large enough that graph structure adds value.

Summary

9440 nodes · 33518 edges · 302 communities (278 shown, 24 thin omitted)
Extraction: 82% EXTRACTED · 18% INFERRED · 0% AMBIGUOUS · INFERRED: 6061 edges (avg confidence: 0.69)
Token cost: 0 input · 0 output

Graph Freshness

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

God Nodes (most connected - your core abstractions)

BaseModel - 533 edges
get_tenant_no() - 387 edges
get_tenant_no() - 350 edges
DbUserContext - 311 edges
success_response() - 279 edges
error_response() - 274 edges
success_response() - 257 edges
error_response() - 252 edges
generate_uuid() - 216 edges
BxUserContext - 204 edges

Surprising Connections (you probably didn't know these)

migrate_users() --calls--> get_password_hash() [INFERRED] scripts/migrate_users.py → app/core/security.py
StepStats --uses--> Settings [INFERRED] scripts/migrate_crm_opportunity.py → app/core/config.py
MigrationStats --uses--> Settings [INFERRED] scripts/migrate_crm_opportunity.py → app/core/config.py
StepStats --uses--> Settings [INFERRED] scripts/migrate_crm_payment_invoice.py → app/core/config.py
MigrationStats --uses--> Settings [INFERRED] scripts/migrate_crm_payment_invoice.py → app/core/config.py

Communities (302 total, 24 thin omitted)

Community 0 - "Community 0"

Cohesion: 0.01 Nodes (228): BaseModel, _coerce_optional_id(), validate_approver_id(), WorkflowDefCreate, WorkflowDefOut, WorkflowDefUpdate, WorkflowNodeCreate, WorkflowNodeOut (+220 more)

Community 1 - "Community 1"

Cohesion: 0.03 Nodes (168): _apply_exclude_follow_status_filter(), _apply_follow_status_filter(), archive_plan(), archive_plan_draft(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract() (+160 more)

Community 2 - "Community 2"

Cohesion: 0.04 Nodes (163): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+155 more)

Community 3 - "Community 3"

Cohesion: 0.04 Nodes (149): category_add(), category_delete(), category_tree(), category_update(), clue_detail(), clue_export(), clue_import(), clue_list() (+141 more)

Community 4 - "Community 4"

Cohesion: 0.04 Nodes (137): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+129 more)

Community 5 - "Community 5"

Cohesion: 0.04 Nodes (135): delete_plan(), approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), create_personnel(), create_vehicle(), delete_carrier() (+127 more)

Community 6 - "Community 6"

Cohesion: 0.05 Nodes (117): 地磅 API 路由聚合 — REST 风格，协议对齐原 simple-dibang-xiaoshou。, _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory() (+109 more)

Community 7 - "Community 7"

Cohesion: 0.05 Nodes (126): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+118 more)

Community 8 - "Community 8"

Cohesion: 0.05 Nodes (120): CRM 报价单 API 路由 — 挂接到 crm.router, register_quote_routes(), apply_crm_owner_scope(), ensure_crm_owner_row_in_scope(), Session, CRM 数据权限辅助（负责人 owner_user_id + 标准 create_by/create_dept_id）。, accept_quote(), delete_pending_approvals() (+112 more)

Community 9 - "Community 9"

Cohesion: 0.06 Nodes (119): register_contract_routes(), CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _apply_contract_entity_fields(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_filters(), _build_contract_name_from_parties() (+111 more)

Community 10 - "Community 10"

Cohesion: 0.04 Nodes (102): clue_export(), contact_export(), _filter_export_rows_by_ids(), follow_export(), _map_product_export_column_keys(), opportunity_export(), pool_customer_export(), pool_rule_export() (+94 more)

Community 11 - "Community 11"

Cohesion: 0.06 Nodes (96): _generate_notify_message(), PlInboundOrder, PlOutboundOrder, PlPlan, PlPlanDelivery, PlPlanLoad, PlTransportDbLink, 运输计划-装货段 pl_plan_load（plan 1:1） (+88 more)

Community 12 - "Community 12"

Cohesion: 0.04 Nodes (90): 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 生成 — 租户内纯数字自增，并发安全。 (+82 more)

Community 13 - "Community 13"

Cohesion: 0.06 Nodes (89): accumulate_stop_products(), aggregate_contract_product_plan_qtys(), assert_contract_qty_for_arrange(), auto_start_execute_approved_contracts(), _bucket_for_plan(), collect_plan_contract_qty_checks(), contract_ids_linked_to_plan(), contract_product_has_fixed_qty() (+81 more)

Community 14 - "Community 14"

Cohesion: 0.05 Nodes (95): _apply_contract_entity_fields(), batch_assign_owner(), batch_submit_contract_approval(), _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _change_row_to_dict(), contract_no_exists() (+87 more)

Community 15 - "Community 15"

Cohesion: 0.04 Nodes (65): CRM 报价单 API 路由 — 挂接到 crm.router, list_public_vehicle_plates(), Session, 地磅公共只读：免登车牌 options（现场填写页）, 免登：按出入库/计划解析 tenant_no，返回 pl_vehicle 车牌（self + carrier）。, _resolve_tenant_no(), Session, read_customer_stop_pref() (+57 more)

Community 16 - "Community 16"

Cohesion: 0.05 Nodes (82): PlInboundOrder, PlInboundOrderItem, PlInboundOrderItemBrandQty, PlOutboundOrder, PlOutboundOrderItem, PlOutboundOrderItemBrandQty, PlPlan, PlPlanDelivery (+74 more)

Community 17 - "Community 17"

Cohesion: 0.04 Nodes (86): clue_import_template(), customer_import_template(), customer_options(), invoice_info_add(), invoice_info_by_customer(), _invoice_info_by_customer_impl(), invoice_info_delete(), invoice_info_list() (+78 more)

Community 18 - "Community 18"

Cohesion: 0.07 Nodes (88): PlTransportApproval, 运输审批记录表 pl_transport_approval, BrandOption, BrandQtyItem, _attach_history_products(), _as_date(), _build_driver_url(), _build_history_stop_reads() (+80 more)

Community 19 - "Community 19"

Cohesion: 0.07 Nodes (86): generate_id(), DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, DutyAssignmentIn, DutySlotSaveIn, assert_user_is_duty_staff() (+78 more)

Community 20 - "Community 20"

Cohesion: 0.11 Nodes (85): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+77 more)

Community 21 - "Community 21"

Cohesion: 0.05 Nodes (83): clue_detail(), clue_list(), clue_mine(), clue_statistics_level(), clue_statistics_overview(), clue_statistics_owner(), clue_statistics_source(), clue_statistics_trend() (+75 more)

Community 22 - "Community 22"

Cohesion: 0.07 Nodes (69): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, _fmt_latest_version(), get_business_all_tasks(), _get_business_form_fields(), get_instance_detail() (+61 more)

Community 23 - "Community 23"

Cohesion: 0.05 Nodes (78): _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() (+70 more)

Community 24 - "Community 24"

Cohesion: 0.07 Nodes (82): create_plan_full(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, update_plan(), PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, PlanContractGapRead, PlanContractLink, PlanDeliveryBody (+74 more)

Community 25 - "Community 25"

Cohesion: 0.06 Nodes (76): 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() (+68 more)

Community 26 - "Community 26"

Cohesion: 0.04 Nodes (70): category_add(), category_tree(), category_update(), price_letter_list(), price_letter_update(), price_letter_void(), product_add(), product_delete() (+62 more)

Community 27 - "Community 27"

Cohesion: 0.11 Nodes (70): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+62 more)

Community 28 - "Community 28"

Cohesion: 0.07 Nodes (70): _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() (+62 more)

Community 29 - "Community 29"

Cohesion: 0.08 Nodes (65): DeliverySlipPrintRead, PlanDeliveryRead, PlanLoadRead, PlanStopProductRead, _append_legacy_plan_product_rows(), _append_stop_product_rows(), build_plan_archive_export_rows(), _empty_product_fields() (+57 more)

Community 30 - "Community 30"

Cohesion: 0.06 Nodes (62): PlCustomerStopPref, 客户装/送货物流默认记忆 pl_customer_stop_pref, _as_str(), build_stop_pref_upsert_items(), get_customer_stop_pref(), Any, Session, 供 plan 保存调用；异常由调用方用 savepoint 吞掉。 (+54 more)

Community 31 - "Community 31"

Cohesion: 0.07 Nodes (66): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_detail(), clue_follow_list() (+58 more)

Community 32 - "Community 32"

Cohesion: 0.06 Nodes (65): _build_contract_name_from_parties(), _get_supplier_short_name(), 根据供需方面板与主数据生成/校正合同名称。, accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version() (+57 more)

Community 33 - "Community 33"

Cohesion: 0.09 Nodes (62): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), export_recharge_applies(), export_recharge_disburse_board(), get_apply() (+54 more)

Community 34 - "Community 34"

Cohesion: 0.1 Nodes (60): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), export_urea_applies(), get_apply(), get_disburse() (+52 more)

Community 35 - "Community 35"

Cohesion: 0.09 Nodes (36): create_invoice(), delete_invoice(), export_invoice_wallets(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request (+28 more)

Community 36 - "Community 36"

Cohesion: 0.06 Nodes (55): CarrierExportBody, DriverExportBody, PersonnelExportBody, VehicleExportBody, DocumentReminderExportBody, InventoryLedgerExportBody, ContractGapExportBody, PlanExportBody (+47 more)

Community 37 - "Community 37"

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 38 - "Community 38"

Cohesion: 0.08 Nodes (39): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+31 more)

Community 39 - "Community 39"

Cohesion: 0.1 Nodes (60): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), get_apply(), get_process() (+52 more)

Community 40 - "Community 40"

Cohesion: 0.05 Nodes (37): ApiCryptoError, _b64url_decode(), _b64url_encode(), decrypt_json(), encrypt_json(), Any, BusinessException, InvalidStatusTransitionException (+29 more)

Community 41 - "Community 41"

Cohesion: 0.09 Nodes (59): CrmContact, CrmContract, CrmContractProduct, CrmCustomerFollow, CrmPriceLetter, CrmProduct, CRM 模块数据模型（产品分类、产品主表、统一附件表、客户管理、公海池、线索管理）, CRM-调价函档案（独立，不关联合同/报价单） (+51 more)

Community 42 - "Community 42"

Cohesion: 0.05 Nodes (56): get_user_menu_codes(), 读取用户授权的菜单权限标识集合（与前端 meta.menuCode / perms 对齐）。, _apply_exclude_follow_status_filter(), _apply_follow_status_filter(), cancel_plan_wait_notice(), create_plan(), _determine_plan_type(), _ensure_subpack_slip_no() (+48 more)

Community 43 - "Community 43"

Cohesion: 0.05 Nodes (48): API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，14 个一级菜单）, day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict() (+40 more)

Community 44 - "Community 44"

Cohesion: 0.07 Nodes (45): LeaveExportBody, CompletedTaskExportBody, MyInstanceExportBody, PendingTaskExportBody, ProcessDefCreateBody, ProcessDefExportBody, ProcessDefUpdateBody, PublishVersionBody (+37 more)

Community 45 - "Community 45"

Cohesion: 0.09 Nodes (52): _make_handlers(), PlInboundOrderItem, PlInboundOrderItemBrandQty, PlOutboundOrderItem, 运输计划-入库单明细 pl_inbound_order_item, 入库明细品牌数量 pl_inbound_order_item_brand_qty, 运输计划-出库单明细 pl_outbound_order_item, apply_dibang_prefill_to_order() (+44 more)

Community 46 - "Community 46"

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

Community 47 - "Community 47"

Cohesion: 0.08 Nodes (51): _approval_record_dict(), approve(), batch_offset(), build_apply_out_with_details(), can_change_applicant(), create_with_details(), get_approval_history(), get_approvals() (+43 more)

Community 48 - "Community 48"

Cohesion: 0.26 Nodes (50): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+42 more)

Community 49 - "Community 49"

Cohesion: 0.09 Nodes (51): _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() (+43 more)

Community 50 - "Community 50"

Cohesion: 0.06 Nodes (49): PlPlanChange, PlPlanProductBrandQty, 计划产品归档品牌数量 pl_plan_product_brand_qty stop_product_id 为空：计划产品级汇总；非空：装货/送货段产品, 计划变更记录表 pl_plan_change, archive_plan(), archive_plan_draft(), update_plan_driver_feedback(), update_plan_site_feedback() (+41 more)

Community 51 - "Community 51"

Cohesion: 0.09 Nodes (41): advance_issue_stats(), batch_offset(), export_advance_issues(), export_advance_issues_xlsx(), export_pending_payments(), export_processed_payments(), issue_advance(), list_advance_issues() (+33 more)

Community 52 - "Community 52"

Cohesion: 0.08 Nodes (50): PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher, _advance_after_approval(), _approval_to_dict() (+42 more)

Community 53 - "Community 53"

Cohesion: 0.11 Nodes (47): customer_create(), customer_update(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer(), create_customer(), customer_name_exists() (+39 more)

Community 54 - "Community 54"

Cohesion: 0.06 Nodes (41): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, CRM 合同子模块路由 — 变更/模板/审批独立页, CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractApprovalPassBody (+33 more)

Community 55 - "Community 55"

Cohesion: 0.07 Nodes (41): customer_create(), customer_deal(), customer_delete(), customer_into_pool(), customer_transfer(), customer_update(), follow_add(), follow_by_customer() (+33 more)

Community 56 - "Community 56"

Cohesion: 0.08 Nodes (47): CrmProductBrand, PlTransportDriverStopFeedback, PlTransportSiteStopFeedback, 运输单-司机按段附件回传 pl_transport_driver_stop_feedback, 运输单-现场按段回传 pl_transport_site_stop_feedback, _build_public_page(), _build_site_url(), _format_file_size() (+39 more)

Community 57 - "Community 57"

Cohesion: 0.09 Nodes (44): ApiResponse, create_expense_item(), delete_expense_item(), get_expense_item(), get_expense_item_tree(), update_expense_item(), create_invoice(), delete_invoice() (+36 more)

Community 58 - "Community 58"

Cohesion: 0.11 Nodes (39): DbUserContext, get_db_current_user(), get_db_current_user_optional(), 地磅模块认证适配：门户 JWT 用户 → db 业务上下文。, db Router/Service 使用的当前用户上下文。, 与门户 JWT / apply_data_scope 所需的 user_info 字段对齐。, 有 Bearer 且为 admin/super_admin 时返回上下文，否则 None（供三方 H5 无登录调用）。, CreateLinkForPlanPayload (+31 more)

Community 59 - "Community 59"

Cohesion: 0.08 Nodes (40): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+32 more)

Community 60 - "Community 60"

Cohesion: 0.08 Nodes (30): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, get_password_hash(), 验证密码（哈希非 bcrypt 或损坏时返回 False，避免抛错） (+22 more)

Community 61 - "Community 61"

Cohesion: 0.08 Nodes (46): PlPlanContract, 运输计划-合同关联（分侧多选） pl_plan_contract, create_plan_full(), 创建运输计划（完整表单：供方/需方 + 产品库产品 + 可选预选车辆，不自动安排运输）, update_plan(), savepoint 包裹；失败只记日志，不抛给计划主流程。, safe_upsert_prefs_from_plan_stops(), is_internal_customer_name() (+38 more)

Community 62 - "Community 62"

Cohesion: 0.13 Nodes (38): PlanStopProductBody, assert_delivery_products_in_selected_contract(), assert_load_products_in_selected_contract(), _assert_product_rows_in_contract_allowed(), assert_stop_contract_required(), _normalize_contract_links(), 段 address 为空时，按经纬度从运输地址库补全 full_address。, 非内部客户装/送货段保存时必须至少选一份合同。 (+30 more)

Community 63 - "Community 63"

Cohesion: 0.12 Nodes (20): BxAdvanceApply, BxAdvanceApproval, AdvanceService, Any, Session, 同一节点多次审批时，取 approval_time 最新的一条作为当前节点状态。, 返回全部审批动作，按时间正序排列，用于展示完整审批历史。, filter_current_cycle_approvals() (+12 more)

Community 64 - "Community 64"

Cohesion: 0.09 Nodes (42): PlCert, bind_vehicle_driver(), CertRead, CertRow, create_driver(), create_personnel(), create_vehicle(), get_driver() (+34 more)

Community 65 - "Community 65"

Cohesion: 0.08 Nodes (44): PlPlanTransport, 计划-运输关联表 pl_plan_transport, patch_plan_hazard_cert_ready(), patch_plan_product_certs(), 更新计划危化品产品证书（购买证/运输证/合法使用证明，不触发安排运输）, all_hazard_products_cert_complete(), _apply_payload_to_transport_row(), apply_vehicle_prefill_to_plan() (+36 more)

Community 66 - "Community 66"

Cohesion: 0.11 Nodes (42): _opp_list_kwargs(), opportunity_kanban(), opportunity_list(), opportunity_mine_list(), _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage() (+34 more)

Community 67 - "Community 67"

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 68 - "Community 68"

Cohesion: 0.1 Nodes (42): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, assert_user_is_duty_staff(), _assignment_dict(), build_dict_value_from_label(), build_public_url() (+34 more)

Community 69 - "Community 69"

Cohesion: 0.07 Nodes (39): follow_delete(), follow_detail(), follow_update(), opportunity_follow_delete(), opportunity_follow_list(), pool_rule_delete(), pool_rule_detail(), pool_rule_list() (+31 more)

Community 70 - "Community 70"

Cohesion: 0.06 Nodes (39): AdvanceApplyCreate, AdvanceApplyOut, AdvanceApplyUpdate, AdvanceApprovalCreate, AdvanceApprovalOut, AdvanceApproverPendingStatsOut, AdvanceFinanceIssueStatsOut, AdvanceIssueOut (+31 more)

Community 71 - "Community 71"

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 72 - "Community 72"

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)

Community 73 - "Community 73"

Cohesion: 0.11 Nodes (35): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+27 more)

Community 74 - "Community 74"

Cohesion: 0.11 Nodes (35): AdvanceService, AttachmentService, BxCrudService, ExpenseItemService, InvoiceService, add_entry(), assert_can_delete_invoice(), calc_summary() (+27 more)

Community 75 - "apply_crm_create_by_scope"

Cohesion: 0.13 Nodes (36): _extract_qty(), _fmt_qty(), Any, Decimal, 运输计划多段：内部客户地磅默认值与数量平衡校验, 地磅默认勾选以本段客户是否为内部客户（山峡/云栋）为准。, resolve_stop_dibang_defaults(), _sum_qty() (+28 more)

Community 76 - "opportunity_follow.py"

Cohesion: 0.1 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 77 - "Community 77"

Cohesion: 0.12 Nodes (36): 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() (+28 more)

Community 78 - "Community 78"

Cohesion: 0.13 Nodes (36): 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() (+28 more)

Community 79 - "PlCarrier"

Cohesion: 0.21 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 80 - "resolve_crm_product"

Cohesion: 0.15 Nodes (36): get_password_hash(), Namespace, build_merged_users(), bx_role_labels(), check_minio(), check_mysql(), check_redis(), _clip() (+28 more)

Community 81 - "customer_follow.py"

Cohesion: 0.08 Nodes (32): _append_user_scope_conditions(), apply_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), 数据权限过滤（V0.3：基于角色 data_scope 的查询级行级过滤） data_scope 值： 1 = 全部数据 2 = 本部门数据 3, 合并多角色数据范围为 dept_ids / user_ids 并集。, 根据用户角色的数据权限过滤查询。适用于业务单据列表/详情（报销单、客户、运单等）。以下场景 SHALL NOT 调用本函数（仅租户隔离即 (+24 more)

Community 82 - "list_duty_staff_users"

Cohesion: 0.11 Nodes (33): clue_follow_create(), clue_follow_detail(), clue_follow_list(), clue_follow_update(), assign_clues(), check_convert(), check_duplicate_clue(), convert_clue() (+25 more)

Community 83 - "Community 83"

Cohesion: 0.07 Nodes (26): parse_admin_request_json(), Any, Request, 运营 Web（/web/admin）JSON 请求体解析。与 ApiCryptoMiddleware 配合：中间件未改写 body 时，在路由内解密 `{, 读取 JSON body；dict 时走 resolve_request_payload（明文 / 密文 / data 包装）。 Returns:, Config, decrypt_login_payload(), ensure_initialized() (+18 more)

Community 84 - "Community 84"

Cohesion: 0.12 Nodes (24): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+16 more)

Community 85 - "allocate_next_biz_no"

Cohesion: 0.15 Nodes (33): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+25 more)

Community 86 - "Community 86"

Cohesion: 0.11 Nodes (32): _approval_record_dict(), approve(), create(), finance_issue_stats(), get_approval_history(), get_approvals(), get_by_id(), global_status_counts() (+24 more)

Community 87 - "list_customers"

Cohesion: 0.23 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 88 - "CrmProduct"

Cohesion: 0.11 Nodes (24): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+16 more)

Community 89 - "pl_ocr_service.py"

Cohesion: 0.11 Nodes (32): create_leave(), delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves() (+24 more)

Community 90 - "WechatMessageService"

Cohesion: 0.15 Nodes (30): CertRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), match_required_cert_name(), _missing_field_labels(), Session (+22 more)

Community 91 - "unsettled_plans_q_filter"

Cohesion: 0.13 Nodes (30): add_favorite(), count_active(), find_active(), find_soft_deleted(), list_favorites(), _next_order_num(), normalize_menu_path(), Any (+22 more)

Community 92 - "Community 92"

Cohesion: 0.12 Nodes (32): _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() (+24 more)

Community 93 - "api_request_log_middleware.py"

Cohesion: 0.22 Nodes (31): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), legacy_parent_id(), load_oss_id_to_url(), load_runtime_settings() (+23 more)

Community 94 - "assert_contract_editable_for_update"

Cohesion: 0.12 Nodes (32): contact_add(), contact_birthday(), contact_by_customer(), contact_decision(), contact_delete(), contact_detail(), contact_list(), contact_primary() (+24 more)

Community 95 - "test_pl_public_link_archived.py"

Cohesion: 0.14 Nodes (30): _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 (+22 more)

Community 96 - "minio_url.py"

Cohesion: 0.12 Nodes (31): invalidate_all_approvals(), 作废该合同全部有效审批记录（含已通过/已拒绝），用于再编辑或重新提审。, approve_quote(), can_user_approve(), create_approval_records(), get_quote_approval(), invalidate_all_approvals(), list_quote_approvals() (+23 more)

Community 97 - "contact.py"

Cohesion: 0.12 Nodes (30): export_expense_items(), _flatten_expense_tree(), BxApplyListExportBody, BxExportBodyBase, dump_export_row(), issue_status_label(), status_label(), advance_issue_stats() (+22 more)

Community 98 - "LocalStorage"

Cohesion: 0.12 Nodes (29): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), create_pool_rule(), delete_pool_rules() (+21 more)

Community 99 - "redis_client.py"

Cohesion: 0.15 Nodes (28): PlPlanDeliveryProduct, PlPlanLoadProduct, 运输计划-装货段产品明细 pl_plan_load_product, 运输计划-送货段产品明细 pl_plan_delivery_product, PlanArchiveDeliveryBlock, PlanArchiveLoadBlock, PlanArchiveStopProductItem, apply_archive_stop_quantities() (+20 more)

Community 100 - "price_letter_detail"

Cohesion: 0.21 Nodes (30): apply_biz_backfill(), BackfillRule, BizRef, build_biz_index(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows() (+22 more)

Community 101 - "tenant.py"

Cohesion: 0.22 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 102 - "BaseStorage"

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 103 - "pl_internal_customer.py"

Cohesion: 0.12 Nodes (11): get_wechat_pay_client(), get_wechat_pay_v2(), 微信支付工具模块支持微信支付 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, 生成签名 V3 (SHA256 with RSA) (+3 more)

Community 104 - "apply_crm_create_by_scope"

Cohesion: 0.09 Nodes (27): bind_biz(), count_invoice_attach_by_biz_ids(), create(), delete_attachment(), download_file(), get_by_biz(), get_by_id(), list_by_biz() (+19 more)

Community 105 - "pool_customer_assign"

Cohesion: 0.12 Nodes (30): clue_follow_delete(), soft_delete(), assert_row_deletable_by_creator(), user_info_from_context(), delete_clue_follow(), 软删除跟进记录，并回写线索 follow_count / last_time, delete_inventory(), delete_plan() (+22 more)

Community 106 - "site.py"

Cohesion: 0.14 Nodes (30): PlVehicleUreaApply, PlVehicleUreaDisburse, 车辆尿素申请 pl_vehicle_urea_apply, 车辆尿素发放登记 pl_vehicle_urea_disburse, VehicleUreaDisburseBoardItem, apply_to_read(), _assert_vehicle_exists(), board_item_to_read() (+22 more)

Community 107 - "apply_pl_scope"

Cohesion: 0.14 Nodes (30): PlVehicleMaintenanceApply, PlVehicleMaintenanceProcess, 车辆维保申请 pl_vehicle_maintenance_apply, 车辆维保处理登记 pl_vehicle_maintenance_process, VehicleMaintenanceProcessBoardItem, apply_to_read(), _assert_vehicle_exists(), board_item_to_read() (+22 more)

Community 108 - "statistics.py"

Cohesion: 0.23 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 109 - "test_pl_plan_stop_rules.py"

Cohesion: 0.15 Nodes (30): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+22 more)

Community 110 - "pool_rule.py"

Cohesion: 0.11 Nodes (29): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), can_user_approve() (+21 more)

Community 111 - "test_pl_public_transport_history.py"

Cohesion: 0.14 Nodes (29): PlVehicleRechargeApply, PlVehicleRechargeRecord, 车辆ETC/加油充值申请 pl_vehicle_recharge_apply, 车辆ETC/加油充值发放登记 pl_vehicle_recharge_record, apply_to_read(), _assert_vehicle_exists(), board_item_to_read(), cancel_apply() (+21 more)

Community 112 - "merge_duplicate_crm_customers.py"

Cohesion: 0.11 Nodes (28): set_warning_threshold(), update_document_reminder(), update_warning(), _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result() (+20 more)

Community 113 - "dict_type.py"

Cohesion: 0.09 Nodes (25): IoOrderItemPatch, IoOrderItemRead, IoOrderListResponse, IoOrderPatch, IoOrderRead, PublicIoOrderFeedback, PublicIoOrderHistoryPageRead, PublicIoOrderHistoryProductRead (+17 more)

Community 114 - "dept.py"

Cohesion: 0.16 Nodes (28): PlDocumentReminder, PlInventory, PlInventoryTransaction, PlInventoryWarning, 库存流水表 pl_inventory_transaction, 库存预警表 pl_inventory_warning, 证件到期提醒表 pl_document_reminder, DocumentReminderExportBody (+20 more)

Community 115 - "site.py"

Cohesion: 0.14 Nodes (25): _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj(), _schedule_persist_log() (+17 more)

Community 116 - "Community 116"

Cohesion: 0.24 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 117 - "pl_plan_list_attachments.py"

Cohesion: 0.2 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 118 - "Community 118"

Cohesion: 0.13 Nodes (26): price_letter_add(), price_letter_detail(), price_letter_list(), price_letter_update(), price_letter_void(), create_price_letter(), get_price_letter(), list_price_letters() (+18 more)

Community 119 - "Community 119"

Cohesion: 0.12 Nodes (24): ApiRequestLogMiddleware, BaseHTTPMiddleware, ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+16 more)

Community 120 - "list_duty_staff_users"

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 121 - "_build_user_info_payload"

Cohesion: 0.18 Nodes (27): calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_products_by_quote_ids() (+19 more)

Community 122 - "post.py"

Cohesion: 0.16 Nodes (24): ReimburseDetailOut, allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title(), parse_optional_date(), parse_reimburse_date() (+16 more)

Community 123 - "customer_options"

Cohesion: 0.13 Nodes (17): plan_requires_site_link(), Session, 运输计划：内置山峡/云栋客户判定（合同可免）, 装货或送货段任一段客户为山峡/云栋时，需要生成现场链接。, plan_requires_site_link(), 运输计划：内置山峡/云栋客户判定（合同可免）, 装货或送货段任一段客户为山峡/云栋时，需要生成现场链接。, load_plan_arrange_copy_flags() (+9 more)

Community 124 - "LocalStorage"

Cohesion: 0.09 Nodes (25): 分页查询供方列表 — Java: CrmSupplierInfoController.list, 供方全量列表（下拉）— Java: CrmSupplierInfoController.listAll, 新增供方 — Java: CrmSupplierInfoController.add, 修改供方 — Java: CrmSupplierInfoController.edit, 删除供方 — Java: CrmSupplierInfoController.remove, supplier_info_add(), supplier_info_delete(), supplier_info_list() (+17 more)

Community 125 - "ethnic.py"

Cohesion: 0.11 Nodes (26): CarrierAuditReject, CarrierBase, CarrierCreate, CarrierListResponse, CarrierQualificationBase, CarrierRead, CarrierUpdate, DriverBase (+18 more)

Community 126 - "oper_log.py"

Cohesion: 0.11 Nodes (24): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), list_document_reminders(), list_transactions(), list_warnings(), PlMenuBadgeStatsRead, menu_badge_stats() (+16 more)

Community 127 - "Any"

Cohesion: 0.25 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 128 - "api_crypto.py"

Cohesion: 0.17 Nodes (23): 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() (+15 more)

Community 129 - "BaseStorage"

Cohesion: 0.14 Nodes (23): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), _enrich_task_list(), export_completed_tasks(), export_my_instances(), export_pending_tasks(), export_process_defs() (+15 more)

Community 130 - "_filter_export_rows_by_ids"

Cohesion: 0.13 Nodes (21): _db_pool_keepalive_loop(), _error_json(), health_check(), lifespan(), _mask_secret(), Exception, Request, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误 (+13 more)

Community 131 - "resolve_crm_product"

Cohesion: 0.16 Nodes (24): align_contract_no_to_sign_date(), generate_contract_no(), date, Java: generateContractNo — {供方编码}/X-JT{yyyyMMdd}{3位序号} 流水与撞号检测须含软删：uk_contr, 标准编号替换日期段，保留序号；非标准返回 None。, 将标准合同编号日期段对齐签订日；撞号则序号顺延（含软删查重）。非标准编号原样返回。无签订日则原样返回。, replace_contract_no_date(), align_contract_no_to_sign_date() (+16 more)

Community 132 - ".to_list_kwargs"

Cohesion: 0.19 Nodes (24): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+16 more)

Community 133 - "inventory_id.py"

Cohesion: 0.16 Nodes (23): PlFreightSettlement, 运费结算表 pl_freight_settlement, FreightSettlementApprovalActionBody, FreightSettlementBase, FreightSettlementByTransportRead, FreightSettlementCreate, FreightSettlementDisburseBody, FreightSettlementListItem (+15 more)

Community 134 - "list_contacts"

Cohesion: 0.2 Nodes (23): get_plan(), build_plan_contract_gap_read(), _clear_legacy_side_contracts(), _delivery_stop_gap_expr(), _demander_gap_expr(), _legacy_demander_gap_expr(), _legacy_supplier_gap_expr(), list_plan_contract_gaps() (+15 more)

Community 135 - "context.py"

Cohesion: 0.27 Nodes (23): build_id_maps(), clip_text(), count_rows(), export_mapping(), fetch_rows(), legacy_id_to_str(), main(), map_id() (+15 more)

Community 136 - "get_db_current_user_optional"

Cohesion: 0.15 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 137 - "iter_user_menu_perm_codes"

Cohesion: 0.18 Nodes (21): DictEnsureError, ensure_dict_data(), ensure_remove_dict_data(), Session, 业务页字典 ensure：白名单内按 label 复用或插入 sys_dict_data。, DictEnsureError, ensure_dict_data(), ensure_remove_dict_data() (+13 more)

Community 138 - "Community 138"

Cohesion: 0.16 Nodes (23): batch_insert_quote_products(), calculate_subtotal(), _decimal_value(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_products_by_quote_ids() (+15 more)

Community 139 - "customer_options"

Cohesion: 0.17 Nodes (23): export_inbound(), _export_orders(), export_outbound(), _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound() (+15 more)

Community 140 - "crm_export_columns.py"

Cohesion: 0.26 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 141 - "web_login_rsa_public_key"

Cohesion: 0.3 Nodes (22): Connection, backup_tables(), _contact_key(), discover_merge_pairs(), fetch_customer(), _invoice_key(), load_database_url(), main() (+14 more)

Community 142 - "clear_pl_plan_instance_data.py"

Cohesion: 0.11 Nodes (16): get_current_time(), parse_datetime(), datetime, ApiRequestLogCRUD, delete(), allocate_next_biz_no(), _format_biz_no(), _prefix_for() (+8 more)

Community 143 - "create_from_quote"

Cohesion: 0.16 Nodes (21): opportunity_product_add(), opportunity_product_batch_add(), opportunity_product_delete(), opportunity_product_detail(), opportunity_product_list(), opportunity_product_list_by_opportunity(), opportunity_product_update(), batch_add_opportunity_products() (+13 more)

Community 144 - "response.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 145 - "list_products"

Cohesion: 0.25 Nodes (22): opportunity_product_add(), opportunity_product_update(), batch_add_opportunity_products(), _calc_subtotal(), create_opportunity_product(), _decimal_value(), _fill_product_redundant(), _get_opportunity_for_product() (+14 more)

Community 146 - "dict_data.py"

Cohesion: 0.16 Nodes (21): 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() (+13 more)

Community 147 - "Community 147"

Cohesion: 0.22 Nodes (21): opportunity_follow_add(), opportunity_follow_delete(), opportunity_follow_update(), create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows() (+13 more)

Community 148 - "plan_has_incomplete_hazard_cert_exists"

Cohesion: 0.13 Nodes (17): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, calc_age_from_chinese_id_card(), 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, build_personnel_summary(), load_vehicle_personnel_summaries(), 运输计划 - 人员 upsert 与车辆-人员关联保存 (+9 more)

Community 149 - ".to_tenant_user_dict"

Cohesion: 0.2 Nodes (20): 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() (+12 more)

Community 150 - "list_product_options"

Cohesion: 0.13 Nodes (20): approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals(), list_quote_approvals(), CRM 报价单审批 CRUD — 对照 CrmQuoteApprovalServiceImpl.java (+12 more)

Community 151 - "Community 151"

Cohesion: 0.15 Nodes (20): cancel_plan(), 作废运输计划：取消跟进状态、作废关联地磅出入库单、取消运输单。, apply_dibang_prefill_to_order(), create_io_order_for_transport(), _dibang_qty_by_plan_product(), enrich_io_items_with_brand_feedback(), enrich_io_order_dict(), _format_io_product_summary_line() (+12 more)

Community 152 - "register_local_callback"

Cohesion: 0.16 Nodes (18): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+10 more)

Community 153 - "web_login_rsa_public_key"

Cohesion: 0.13 Nodes (5): generate_id(), camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD

Community 154 - "redis_client.py"

Cohesion: 0.23 Nodes (17): 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() (+9 more)

Community 155 - "WechatMessageService"

Cohesion: 0.25 Nodes (17): _actor_ids(), _actor_names(), assert_rows_deletable_by_creator(), can_delete_by_creator(), is_super_admin(), normalize_user_info(), Any, 删除权限：仅创建人可删（super_admin 例外）。 (+9 more)

Community 156 - "list_product_options"

Cohesion: 0.25 Nodes (17): Settings, BaseSettings, Config, Settings, apply_renumber(), build_mapping(), fetch_products(), format_new_product_no() (+9 more)

Community 157 - "datetime_parse.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 158 - "create_from_quote"

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 159 - "web_login_rsa_public_key"

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 160 - "get_client_ip"

Cohesion: 0.15 Nodes (4): LocalStorage, process_image_content(), 带下载文件名的访问 URL；默认实现为普通访问地址。, 处理图片内容，如果是 HEIC 格式则转换为 JPEG

Community 161 - "context.py"

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 162 - ".to_tenant_user_dict"

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 163 - "Community 163"

Cohesion: 0.22 Nodes (18): apply_crm_create_by_scope(), _apply_list_filters(), create_supplier_info(), get_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session (+10 more)

Community 164 - "Community 164"

Cohesion: 0.15 Nodes (14): create_role(), get_role(), list_roles(), 角色 CRUD（sys_role / sys_role_menu / sys_role_data_scope_detail）, role_name_exists(), _row_to_dict(), soft_delete_role(), update_role() (+6 more)

Community 165 - "list_duty_staff_users"

Cohesion: 0.24 Nodes (17): PlCarrier, PlPersonnel, PlVehicle, PlVehicleDriver, PlVehiclePersonnel, 车辆-人员关联表 pl_vehicle_personnel, 车辆-司机关联表 pl_vehicle_driver（兼容旧表）, CarrierExportBody (+9 more)

Community 166 - "code:block1 (/iflytek/shanxia2.0/backend)"

Cohesion: 0.32 Nodes (16): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+8 more)

Community 167 - "Community 167"

Cohesion: 0.37 Nodes (17): check_env(), check_python(), create_venv(), init_env(), install_dependencies(), log_error(), log_info(), log_success() (+9 more)

Community 168 - "Community 168"

Cohesion: 0.28 Nodes (15): can_query_others_wallet(), _count_invoices(), create(), delete(), get_mine_summary(), is_wallet_admin(), list_invoices(), list_ledgers() (+7 more)

Community 169 - "Community 169"

Cohesion: 0.26 Nodes (14): 发放登记页：申请单 + 关联发放信息（左连接）, RechargeApplyExportBody, RechargeDisburseExportBody, VehicleRechargeApplyCreate, VehicleRechargeApplyListResponse, VehicleRechargeApplyOption, VehicleRechargeApplyRead, VehicleRechargeApplyUpdate (+6 more)

Community 170 - "Community 170"

Cohesion: 0.22 Nodes (14): batch_generate_sample_codes(), batch_issue_sample_codes(), batch_revoke_sample_codes(), create_sample_code(), get_sample_code(), list_sample_codes(), _parse_issued_time(), 样本编码池 CRUD（biz_sample_code） (+6 more)

Community 171 - "Community 171"

Cohesion: 0.2 Nodes (15): invoice_info_add(), invoice_info_set_default(), invoice_info_update(), _get_default_invoice_info(), ensure_crm_customer_linked_row_in_scope(), 客户子表（开票信息等）：先校验关联客户 owner scope，否则校验 create_by。, _clear_default_for_customer(), create_invoice_info() (+7 more)

Community 172 - "Community 172"

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 173 - "resolve_create_time_bounds"

Cohesion: 0.12 Nodes (15): 技术栈, 1. 创建虚拟环境, 项目结构, 2. 安装依赖, 3. 配置环境变量, 快速开始, 4. 启动服务, 开发规范 (+7 more)

Community 174 - "Community 174"

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 175 - "Community 175"

Cohesion: 0.24 Nodes (15): _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), is_huolala_trailer_no(), match_required_cert_name(), _missing_field_labels(), 三方车辆证件不强制；保留函数供兼容调用，恒为通过。, should_require_trailer_certs() (+7 more)

Community 176 - "Community 176"

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

Community 177 - "Community 177"

Cohesion: 0.22 Nodes (12): 附件上传 bizType 与 MinIO 目录映射（对齐原 CRM oss 上传语义）, 优先使用显式 folder；否则按 bizType 映射默认目录。, resolve_upload_folder(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images() (+4 more)

Community 178 - "Community 178"

Cohesion: 0.29 Nodes (11): UreaApplyExportBody, UreaDisburseExportBody, VehicleUreaApplyCreate, VehicleUreaApplyListResponse, VehicleUreaApplyRead, VehicleUreaApplyUpdate, VehicleUreaDisburseBoardListResponse, VehicleUreaDisburseCreate (+3 more)

Community 179 - "test_pl_vehicle_personnel_photo_schema.py"

Cohesion: 0.3 Nodes (13): MaintenanceApplyExportBody, MaintProcessExportBody, VehicleMaintenanceApplyCreate, VehicleMaintenanceApplyListResponse, VehicleMaintenanceApplyRead, VehicleMaintenanceApplyReminder, VehicleMaintenanceApplyUpdate, VehicleMaintenanceProcessBoardListResponse (+5 more)

Community 180 - "Community 180"

Cohesion: 0.18 Nodes (3): process_image_content(), QiniuStorage, 处理图片内容，如果是 HEIC 格式则转换为 JPEG

Community 181 - "Community 181"

Cohesion: 0.26 Nodes (13): _cargo_stats(), DashboardCargoStat, DashboardPartnerCargoStat, DashboardStats, get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo() (+5 more)

Community 182 - "Community 182"

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 183 - "Community 183"

Cohesion: 0.24 Nodes (13): download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage，对外保持 bx 协议。, 将 upload 返回的完整 URL 归一化为存储相对路径（与 admin 附件 upload 一致）。 (+5 more)

Community 184 - "Community 184"

Cohesion: 0.2 Nodes (12): _coerce_id(), ExpenseItemCreate, ExpenseItemExportBody, ExpenseItemOut, ExpenseItemUpdate, validate_parent_id(), InvoiceAttachmentOut, InvoiceOut (+4 more)

Community 185 - "Community 185"

Cohesion: 0.2 Nodes (12): customer_options(), 客户下拉选项（租户内只读，不做 owner 数据权限）, list_customer_options(), 客户下拉选项：租户内只读搜索，不做 owner 数据权限（供地磅/合同等主数据选用）。, list_customer_options(), 客户下拉选项：租户内只读搜索，不做 owner 数据权限（供地磅/合同等主数据选用）。, 产品/客户列表 keyword：名称/编号/拼音首字母 OR 匹配。, 选择器：名称/拼音/规格型号，不匹配产品编号。 (+4 more)

Community 186 - "Community 186"

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 187 - "Community 187"

Cohesion: 0.14 Nodes (13): 1. 上传到服务器, 2. 服务器首次启动, 3. 日常运维, 4. 配置文件, 5. 与 Nginx 配合, 6. 常见问题, code:block1 (/iflytek/shanxia2.0/backend), code:bash (cd /path/to/shanxia2.0) (+5 more)

Community 188 - "Community 188"

Cohesion: 0.38 Nodes (13): ensure_crm_customer_linked_row_in_scope(), 客户子表（开票信息等）：先校验关联客户 owner scope，否则校验 create_by。, _clear_default_for_customer(), create_invoice_info(), get_invoice_info(), list_invoice_info_by_customer(), Any, Session (+5 more)

Community 189 - "Community 189"

Cohesion: 0.21 Nodes (13): _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), _map_role_name_to_web(), Web 管理端登录：基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析, 角色仅勾选按钮（F）时，补齐祖先 C/M 菜单 id，便于前端匹配 :list 路由。, 用户通过角色关联得到的菜单权限标识（sys_menu.perms，与前端 meta.menuCode 对齐）。, 将 sys_role.role_name 映射为 web-admin 使用的 role 字符串。 (+5 more)

Community 190 - "Community 190"

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 191 - "Community 191"

Cohesion: 0.26 Nodes (11): assert_carrier_eligible_for_transport(), carrier_agreement_expired(), carrier_audit_approved(), carrier_eligible_for_transport(), carrier_qualification_complete(), date, 资质附件均为选填，保留函数签名供兼容调用。, _urls_nonempty() (+3 more)

Community 192 - "Community 192"

Cohesion: 0.2 Nodes (12): carrier_to_read(), create_carrier(), get_carrier(), update_carrier(), assert_carrier_eligible_for_transport(), carrier_agreement_expired(), carrier_eligible_for_transport(), carrier_qualification_complete() (+4 more)

Community 193 - "Community 193"

Cohesion: 0.15 Nodes (3): BaseStorage, QiniuStorage, 浏览器内联预览 URL；默认实现为普通访问地址。

Community 194 - "Community 194"

Cohesion: 0.38 Nodes (11): format_brand_qty_summary(), require_brand_qtys_if_needed(), format_brand_qty_summary(), require_brand_qtys_if_needed(), test_format_brand_qty_summary(), test_format_brand_qty_summary_empty(), test_format_brand_qty_summary_zero_only(), test_require_calls_validate_when_positive_rows() (+3 more)

Community 195 - "Community 195"

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 196 - "Community 196"

Cohesion: 0.24 Nodes (9): 微信消息通知服务支持微信小程序模板消息推送使用方式: from app.core.wechat_message import WechatMes, 发送模板消息 Args: openid: 用户openid template_, send_delivery_notice(), send_delivery_warning(), send_order_status(), send_payment_success(), send_refund_result(), send_urge_notification() (+1 more)

Community 197 - "Community 197"

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 198 - "Community 198"

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 199 - "Community 199"

Cohesion: 0.29 Nodes (11): assert_can_save_as_draft(), resolve_follow_status_on_save(), validate_draft_min_fields(), assert_can_save_as_draft(), resolve_follow_status_on_save(), validate_draft_min_fields(), test_assert_can_save_as_draft_rejects_arranged(), test_resolve_follow_status_draft_always_drafting() (+3 more)

Community 200 - "Community 200"

Cohesion: 0.44 Nodes (8): default_settlement_clause(), 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 201 - "Community 201"

Cohesion: 0.17 Nodes (6): convert_heic_to_jpeg(), _guess_preview_content_type(), OSSStorage, 文件存储工具模块支持多种存储方式： 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 按对象键后缀推断内联预览 Content-Type（纠正上传时未写入 MIME 的情况）。, 将 HEIC/HEIF 格式转换为 JPEG 格式

Community 202 - "Community 202"

Cohesion: 0.26 Nodes (11): PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, _dict_field(), load_transport_driver_product_feedbacks(), persist_io_item_brand_qtys(), persist_transport_product_feedback(), Any, Decimal (+3 more)

Community 203 - "Community 203"

Cohesion: 0.27 Nodes (11): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), 保留匹配节点及其全部上级，供关键词检索后仍能正确组树。 (+3 more)

Community 204 - "Community 204"

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 205 - "Community 205"

Cohesion: 0.26 Nodes (10): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), _row_to_dict(), soft_delete_menu() (+2 more)

Community 206 - "crm_quote_pdf.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 207 - "shanxia2.0 后端骨架（FastAPI）"

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 208 - "Community 208"

Cohesion: 0.18 Nodes (6): convert_heic_to_jpeg(), _guess_preview_content_type(), OSSStorage, 文件存储工具模块支持多种存储方式： 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 按对象键后缀推断内联预览 Content-Type（纠正上传时未写入 MIME 的情况）。, 将 HEIC/HEIF 格式转换为 JPEG 格式

Community 209 - "Community 209"

Cohesion: 0.22 Nodes (10): list_share_logs(), _parse_user_agent(), CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析（替代 Hutool UserAgentUtil）, Java: queryLogsByQuoteId, record_visit(), _row_to_dict() (+2 more)

Community 210 - "Community 210"

Cohesion: 0.22 Nodes (10): ChangePasswordRequest, Config, LoginRequest, LoginResponse, ResetPasswordRequest, UserBase, UserCreate, UserListResponse (+2 more)

Community 211 - "Community 211"

Cohesion: 0.24 Nodes (5): MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint；未配置或与内网相同时复用 self.client。, MinIO 预签名下载 URL，携带原始文件名。, MinIO 预签名内联预览 URL（图片新标签页 / PDF iframe 等）。上传时 put_object 未写 content_typ

Community 212 - "Community 212"

Cohesion: 0.22 Nodes (10): _build_driver_url(), get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联（供查看弹窗复制简述/二维码）。, build_transport_inventory_link_read(), 构建运输-地磅出入库关联读模型（不含现场链接，现场链接见 pl_transport_site_link）。, build_io_order_site_url(), get_active_io_order_for_plan(), build_site_records_for_arranged_plan() (+2 more)

Community 213 - "Community 213"

Cohesion: 0.24 Nodes (9): create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), 字典数据 CRUD（sys_dict_data）, 字典下拉选项：租户主数据，忽略数据范围（user_info 保留兼容调用方，不参与过滤）。, _row_to_dict(), soft_delete_dict_data() (+1 more)

Community 214 - "Community 214"

Cohesion: 0.27 Nodes (9): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), 字典类型 CRUD（sys_dict_type）, _row_to_dict(), soft_delete_dict_type(), update_dict_type() (+1 more)

Community 215 - "Community 215"

Cohesion: 0.22 Nodes (7): create_leave(), get_leave(), list_leaves(), _row_to_dict(), soft_delete_leave(), BizLeaveRequest, 请假申请 biz_leave_request

Community 216 - "Community 216"

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 217 - "Community 217"

Cohesion: 0.27 Nodes (9): create_tenant(), get_tenant(), list_tenants(), _row_to_dict(), soft_delete_tenant(), tenant_no_exists(), update_tenant(), 租户表 sys_tenant（V0.3 2.1.1） (+1 more)

Community 218 - "Community 218"

Cohesion: 0.24 Nodes (10): register_contract_routes(), _format_summary(), oper_log(), _pick_field(), _preserve_fastapi_signature(), 路由操作日志装饰器：写入 ContextVar 供中间件落库, 在 handler 执行前设置操作日志元数据。, FastAPI 通过 inspect.signature + wrapper.globals 解析类型；需在原函数命名空间下解析后写回。 (+2 more)

Community 219 - "Community 219"

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 220 - "Community 220"

Cohesion: 0.44 Nodes (9): is_huolala_trailer_no(), should_require_trailer_certs(), should_show_trailer_cert_slots(), validate_self_vehicle_required_certs(), _complete_self_head_certs(), 挂车号分流：货拉拉免挂车证；自有正常挂车号强制；三方不强制。, test_huolala_trailer_helpers(), test_self_huolala_skips_trailer_required_certs() (+1 more)

Community 221 - "Community 221"

Cohesion: 0.24 Nodes (10): _coerce_resource_snapshot(), parse_resource_snapshot(), 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, 从 ORM 文本列或 dict 解析快照。, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot, build_transport_resource_snapshot() (+2 more)

Community 222 - "Community 222"

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

Community 223 - "Community 223"

Cohesion: 0.27 Nodes (4): MinIOStorage, 从 MINIO_BASE_URL 解析公网 endpoint；未配置或与内网相同时复用 self.client。, MinIO 预签名下载 URL，携带原始文件名。, MinIO 预签名内联预览 URL（图片新标签页 / PDF iframe 等）。上传时 put_object 未写 content_typ

Community 224 - "Community 224"

Cohesion: 0.4 Nodes (8): create(), ensure_by_biz_type(), get_by_biz_type(), get_by_id(), save_nodes(), soft_delete(), _tenant_no(), update()

Community 225 - "Community 225"

Cohesion: 0.33 Nodes (9): build_quote_html(), _default_value(), _format_date(), _format_discount(), _format_money(), generate_quote_pdf(), _get_pdf_styles(), CRM 报价单 PDF/HTML 生成 — 对照 CrmQuotePdfServiceImpl.java (+1 more)

Community 226 - "Community 226"

Cohesion: 0.22 Nodes (9): PlTransportProductBrandQty, PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, 运输单产品回传品牌数量 pl_transport_product_brand_qty, _dict_field(), load_transport_driver_product_feedbacks(), persist_transport_product_feedback(), 现场入出库明细与运输回传的品牌数量校验与持久化 (+1 more)

Community 227 - "Community 227"

Cohesion: 0.31 Nodes (8): create_site(), get_site(), list_sites(), _row_to_dict(), site_code_exists(), soft_delete_site(), update_site(), SysSite

Community 228 - "Community 228"

Cohesion: 0.31 Nodes (8): create_post(), get_post(), list_posts(), post_code_exists(), _row_to_dict(), soft_delete_post(), update_post(), SysPost

Community 229 - "Community 229"

Cohesion: 0.29 Nodes (9): extract_minio_object_key(), join_relative_urls(), MinIO 附件 URL 规范化（数据迁移共用）。背景 ---- CRM / 地磅 / 报销与 shanxia2.0 共用同一 MinIO（bucket 默, 业务表 OSS ID 串 → 相对 URL 串（用于客户证照、跟进附件等）。, 去掉预签名 query（?X-Amz-...）。, 将绝对/相对 URL 规范为 MinIO object key（不含 bucket）。, resolve_oss_id_csv(), _strip_legacy_prefix() (+1 more)

Community 230 - "Community 230"

Cohesion: 0.47 Nodes (7): assert_export_row_count(), test_assert_export_row_count_empty(), test_assert_export_row_count_ok(), test_assert_export_row_count_over_limit(), test_filter_export_columns_keeps_order_and_ignores_unknown(), test_filter_export_columns_none_returns_all(), assert_export_row_count()

Community 231 - "Community 231"

Cohesion: 0.53 Nodes (7): _count(), _delete(), _engine_from_env(), main(), Engine, 清空运输计划（pl_plan）及关联实例数据，便于测试环境重新走流程。用法（在 backend 目录、已配置 .env DATABASE_URL）： p, _table_exists()

Community 232 - "Community 232"

Cohesion: 0.28 Nodes (5): _build_workbook(), DictLabelResolver, Excel 导出工具：集中处理字典 code → label（对齐 Java ExcelDictConvert / ExcelDictPreloadConver, 导出单元格解析：按列配置做字典翻译或自定义格式化。, workbook_to_streaming_response()

Community 233 - "Community 233"

Cohesion: 0.22 Nodes (3): BaseStorage, 带下载文件名的访问 URL；默认实现为普通访问地址。, 浏览器内联预览 URL；默认实现为普通访问地址。

Community 234 - "Community 234"

Cohesion: 0.39 Nodes (8): _actor_ids(), _actor_names(), assert_rows_deletable_by_creator(), can_delete_by_creator(), is_super_admin(), normalize_user_info(), 删除权限：仅创建人可删（super_admin 例外）。, row_creator_id()

Community 235 - "Community 235"

Cohesion: 0.33 Nodes (8): decrypt_login_payload(), ensure_initialized(), extract_login_credentials(), get_public_pem(), 登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。, Base64 密文 -> JSON 对象（须含 username、password、ts 毫秒时间戳）。, 从请求体解析用户名、密码。返回 (username, password, error_message)；error_message 非空时表示失败。, _validate_ts()

Community 236 - "Community 236"

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 238 - "Community 238"

Cohesion: 0.39 Nodes (7): operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, 导出操作日志（当前筛选全量，或 ids 已选）。, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info()

Community 240 - "Community 240"

Cohesion: 0.5 Nodes (7): build_delivery_slip_print(), _customer_key(), _delivery_matches_customer(), get_delivery_slip_print_context(), list_delivery_print_customers(), _merge_stop_products(), _resolve_customer_id()

Community 241 - "Community 241"

Cohesion: 0.29 Nodes (6): clear_oper_log_meta(), get_oper_log_meta(), OperLogMeta, 请求级操作日志元数据（ContextVar）, 供异步落库线程使用，避免 ContextVar 跨线程丢失。, snapshot_oper_log_meta()

Community 242 - "Community 242"

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 243 - "Community 243"

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

Community 244 - "Community 244"

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

Community 245 - "Community 245"

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

Community 246 - "db_collation.py"

Cohesion: 0.48 Nodes (5): TransportAddressBase, TransportAddressCreate, TransportAddressExportBody, TransportAddressRead, TransportAddressUpdate

Community 247 - "Community 247"

Community 248 - "Community 248"

Cohesion: 0.52 Nodes (5): assert_contract_editable_for_update(), assert_contract_editable_for_update(), test_assert_allows_editable(), test_assert_rejects_non_editable(), test_editable_statuses()

Community 249 - "Community 249"

Cohesion: 0.33 Nodes (5): check_customer_protect_time(), 每天凌晨1点：检查保护期到期客户，跟进次数不足则退回公海, 每天早上9点：保护期到期提醒（3天内到期且跟进不足）, _recycle_to_pool(), remind_customer_recycle()

Community 250 - "Community 250"

Cohesion: 0.33 Nodes (3): PagedQuery, PagedResponse, bx 原系统 API 响应包装（code=0 / msg / data.rows），与门户 success_response 分离。

Community 251 - "Community 251"

Cohesion: 0.33 Nodes (5): Config, format_api_error_message(), PageResult, 将 HTTP/SQLAlchemy 等异常转为可展示的错误文案（避免 str([]) 空列表）。, ResponseModel

Community 252 - "Community 252"

Cohesion: 0.33 Nodes (4): DutyDictEnsureBody, DutyGrabBody, DutyLinkBody, 值班排班 Pydantic schemas

Community 253 - "Community 253"

Cohesion: 0.47 Nodes (5): build_site_transport_url(), 运输计划现场链接（pl_transport_site_link，与地磅出入库单解耦）。, build_transport_site_link_read(), build_transport_site_link_read_from_row(), _parse_feedback_images()

Community 254 - "Activate.ps1"

Cohesion: 0.6 Nodes (4): _build_workbook(), DictLabelResolver, Any, 导出单元格解析：按列配置做字典翻译或自定义格式化。

Community 255 - "Community 255"

Cohesion: 0.4 Nodes (3): bx_health(), 报销（bx）API 路由聚合 — REST 风格，协议对齐 bx 原系统。, P0 健康检查：验证 bx 路由已挂载且响应协议为 code=0。

Community 256 - "Community 256"

Cohesion: 0.4 Nodes (3): _join_alias_names(), _join_brand_names(), CRM 模块 Excel 导出列定义（字段与字典类型对齐 Java *Vo @ExcelDictFormat）。

Community 257 - "Community 257"

Cohesion: 0.4 Nodes (5): persist_io_item_brand_qtys(), 更新明细实际数量，并按需校验/持久化现场品牌数量。, update_io_order_items_qty_and_brand(), 计划行 brand_mode 丢失时，客户端提交的多品牌明细仍应落库（不能只软删不写）。, test_persist_io_item_brand_qtys_writes_when_brand_mode_missing()

Community 259 - "Community 259"

Cohesion: 0.4 Nodes (3): Any, 供 get_tenant_no 等门户工具使用。, 与门户 JWT / apply_data_scope 所需的 user_info 字段对齐。

Community 261 - "Community 261"

Cohesion: 0.67 Nodes (3): list_ethnics(), 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict()

Knowledge Gaps

1231 isolated node(s): 定期 ping MySQL，避免远程库/NAT 回收空闲 TCP 后首请求长时间卡住。, 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, 每月 1 日凌晨执行：按上月计划模板生成本月计划。, 每天凌晨1点：检查保护期到期客户，跟进次数不足则退回公海 (+1226 more) These have ≤1 connection - possible missing edges or undocumented components.
24 thin communities (<3 nodes) omitted from report — run graphify query to explore isolated nodes.

94 KiB Raw Blame History Unescape Escape