# Graph Report - backend (2026-08-24) ## Corpus Check - 344 files · ~237,323 words - Verdict: corpus is large enough that graph structure adds value. ## Summary - 4835 nodes · 18202 edges · 186 communities (170 shown, 16 thin omitted) - Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 911 edges (avg confidence: 0.52) - Token cost: 0 input · 0 output ## Graph Freshness - Built from commit: `dd1acdc7` - Run `git rev-parse HEAD` and compare to check if the graph is stale. - Run `graphify update .` after code changes (no API cost). ## Community Hubs (Navigation) - [[_COMMUNITY_Community 0|Community 0]] - [[_COMMUNITY_Community 1|Community 1]] - [[_COMMUNITY_Community 2|Community 2]] - [[_COMMUNITY_Community 3|Community 3]] - [[_COMMUNITY_Community 4|Community 4]] - [[_COMMUNITY_Community 5|Community 5]] - [[_COMMUNITY_Community 6|Community 6]] - [[_COMMUNITY_Community 7|Community 7]] - [[_COMMUNITY_Community 8|Community 8]] - [[_COMMUNITY_Community 9|Community 9]] - [[_COMMUNITY_Community 10|Community 10]] - [[_COMMUNITY_Community 11|Community 11]] - [[_COMMUNITY_Community 12|Community 12]] - [[_COMMUNITY_Community 13|Community 13]] - [[_COMMUNITY_Community 14|Community 14]] - [[_COMMUNITY_Community 15|Community 15]] - [[_COMMUNITY_Community 16|Community 16]] - [[_COMMUNITY_Community 17|Community 17]] - [[_COMMUNITY_Community 18|Community 18]] - [[_COMMUNITY_Community 19|Community 19]] - [[_COMMUNITY_Community 20|Community 20]] - [[_COMMUNITY_Community 21|Community 21]] - [[_COMMUNITY_Community 22|Community 22]] - [[_COMMUNITY_Community 23|Community 23]] - [[_COMMUNITY_Community 24|Community 24]] - [[_COMMUNITY_Community 25|Community 25]] - [[_COMMUNITY_Community 26|Community 26]] - [[_COMMUNITY_Community 27|Community 27]] - [[_COMMUNITY_Community 28|Community 28]] - [[_COMMUNITY_Community 29|Community 29]] - [[_COMMUNITY_Community 30|Community 30]] - [[_COMMUNITY_Community 31|Community 31]] - [[_COMMUNITY_Community 32|Community 32]] - [[_COMMUNITY_Community 33|Community 33]] - [[_COMMUNITY_Community 34|Community 34]] - [[_COMMUNITY_Community 35|Community 35]] - [[_COMMUNITY_Community 36|Community 36]] - [[_COMMUNITY_Community 37|Community 37]] - [[_COMMUNITY_Community 38|Community 38]] - [[_COMMUNITY_Community 39|Community 39]] - [[_COMMUNITY_Community 40|Community 40]] - [[_COMMUNITY_Community 41|Community 41]] - [[_COMMUNITY_Community 42|Community 42]] - [[_COMMUNITY_Community 43|Community 43]] - [[_COMMUNITY_Community 44|Community 44]] - [[_COMMUNITY_Community 45|Community 45]] - [[_COMMUNITY_Community 46|Community 46]] - [[_COMMUNITY_Community 47|Community 47]] - [[_COMMUNITY_Community 48|Community 48]] - [[_COMMUNITY_Community 49|Community 49]] - [[_COMMUNITY_Community 50|Community 50]] - [[_COMMUNITY_Community 51|Community 51]] - [[_COMMUNITY_Community 52|Community 52]] - [[_COMMUNITY_Community 53|Community 53]] - [[_COMMUNITY_Community 54|Community 54]] - [[_COMMUNITY_Community 55|Community 55]] - [[_COMMUNITY_Community 56|Community 56]] - [[_COMMUNITY_Community 57|Community 57]] - [[_COMMUNITY_Community 58|Community 58]] - [[_COMMUNITY_Community 59|Community 59]] - [[_COMMUNITY_Community 60|Community 60]] - [[_COMMUNITY_Community 61|Community 61]] - [[_COMMUNITY_Community 62|Community 62]] - [[_COMMUNITY_Community 63|Community 63]] - [[_COMMUNITY_Community 64|Community 64]] - [[_COMMUNITY_Community 65|Community 65]] - [[_COMMUNITY_Community 66|Community 66]] - [[_COMMUNITY_Community 67|Community 67]] - [[_COMMUNITY_Community 68|Community 68]] - [[_COMMUNITY_Community 69|Community 69]] - [[_COMMUNITY_Community 70|Community 70]] - [[_COMMUNITY_Community 71|Community 71]] - [[_COMMUNITY_Community 72|Community 72]] - [[_COMMUNITY_Community 73|Community 73]] - [[_COMMUNITY_Community 74|Community 74]] - [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]] - [[_COMMUNITY_opportunity_follow.py|opportunity_follow.py]] - [[_COMMUNITY_Community 77|Community 77]] - [[_COMMUNITY_Community 78|Community 78]] - [[_COMMUNITY_PlCarrier|PlCarrier]] - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]] - [[_COMMUNITY_customer_follow.py|customer_follow.py]] - [[_COMMUNITY_storage.py|storage.py]] - [[_COMMUNITY_Community 83|Community 83]] - [[_COMMUNITY_Community 84|Community 84]] - [[_COMMUNITY_allocate_next_biz_no|allocate_next_biz_no]] - [[_COMMUNITY_Community 86|Community 86]] - [[_COMMUNITY_Community 87|Community 87]] - [[_COMMUNITY_CrmProduct|CrmProduct]] - [[_COMMUNITY_pl_ocr_service.py|pl_ocr_service.py]] - [[_COMMUNITY_WechatMessageService|WechatMessageService]] - [[_COMMUNITY_opportunity_product.py|opportunity_product.py]] - [[_COMMUNITY_Community 92|Community 92]] - [[_COMMUNITY_api_request_log_middleware.py|api_request_log_middleware.py]] - [[_COMMUNITY_assert_contract_editable_for_update|assert_contract_editable_for_update]] - [[_COMMUNITY_test_pl_public_link_archived.py|test_pl_public_link_archived.py]] - [[_COMMUNITY_minio_url.py|minio_url.py]] - [[_COMMUNITY_contact.py|contact.py]] - [[_COMMUNITY_LocalStorage|LocalStorage]] - [[_COMMUNITY_redis_client.py|redis_client.py]] - [[_COMMUNITY_price_letter_detail|price_letter_detail]] - [[_COMMUNITY_tenant.py|tenant.py]] - [[_COMMUNITY_BaseStorage|BaseStorage]] - [[_COMMUNITY_pl_internal_customer.py|pl_internal_customer.py]] - [[_COMMUNITY_apply_crm_create_by_scope|apply_crm_create_by_scope]] - [[_COMMUNITY_pool_customer_assign|pool_customer_assign]] - [[_COMMUNITY_site.py|site.py]] - [[_COMMUNITY_apply_pl_scope|apply_pl_scope]] - [[_COMMUNITY_statistics.py|statistics.py]] - [[_COMMUNITY_duty.py|duty.py]] - [[_COMMUNITY_list_duty_staff_users|list_duty_staff_users]] - [[_COMMUNITY_dict_data.py|dict_data.py]] - [[_COMMUNITY_merge_duplicate_crm_customers.py|merge_duplicate_crm_customers.py]] - [[_COMMUNITY_dict_type.py|dict_type.py]] - [[_COMMUNITY_mappers.py|mappers.py]] - [[_COMMUNITY_site.py|site.py]] - [[_COMMUNITY_Community 116|Community 116]] - [[_COMMUNITY_price_letter_detail|price_letter_detail]] - [[_COMMUNITY_Community 118|Community 118]] - [[_COMMUNITY_Community 119|Community 119]] - [[_COMMUNITY_oper_log_decorator.py|oper_log_decorator.py]] - [[_COMMUNITY_post.py|post.py]] - [[_COMMUNITY_site.py|site.py]] - [[_COMMUNITY_customer_options|customer_options]] - [[_COMMUNITY_vehicle_recharge.py|vehicle_recharge.py]] - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]] - [[_COMMUNITY_customer_pool.py|customer_pool.py]] - [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]] - [[_COMMUNITY_product_allowed|product_allowed]] - [[_COMMUNITY_BaseStorage|BaseStorage]] - [[_COMMUNITY_invoice_info.py|invoice_info.py]] - [[_COMMUNITY_customer_follow.py|customer_follow.py]] - [[_COMMUNITY_context.py|context.py]] - [[_COMMUNITY_inventory_id.py|inventory_id.py]] - [[_COMMUNITY_price_letter_detail|price_letter_detail]] - [[_COMMUNITY_storage.py|storage.py]] - [[_COMMUNITY_Community 136|Community 136]] - [[_COMMUNITY_plan_has_incomplete_hazard_cert_exists|plan_has_incomplete_hazard_cert_exists]] - [[_COMMUNITY_Community 138|Community 138]] - [[_COMMUNITY_get_current_user_by_token|get_current_user_by_token]] - [[_COMMUNITY_UserRole|UserRole]] - [[_COMMUNITY_redis_client.py|redis_client.py]] - [[_COMMUNITY_opportunity_export|opportunity_export]] - [[_COMMUNITY__build_user_info_payload|_build_user_info_payload]] - [[_COMMUNITY_config.py|config.py]] - [[_COMMUNITY_resolve_crm_product|resolve_crm_product]] - [[_COMMUNITY_list_public_vehicle_plates|list_public_vehicle_plates]] - [[_COMMUNITY_Community 147|Community 147]] - [[_COMMUNITY__UserCRUDCompat|_UserCRUDCompat]] - [[_COMMUNITY_datetime_parse.py|datetime_parse.py]] - [[_COMMUNITY_Community 151|Community 151]] - [[_COMMUNITY_customer_update|customer_update]] - [[_COMMUNITY_.to_tenant_user_dict|.to_tenant_user_dict]] - [[_COMMUNITY_get_client_ip|get_client_ip]] - [[_COMMUNITY_codeblock1 (iflytekshanxia2.0backend)|code:block1 (/iflytek/shanxia2.0/backend)]] - [[_COMMUNITY_test_quote_approver_setting.py|test_quote_approver_setting.py]] - [[_COMMUNITY_resolve_create_time_bounds|resolve_create_time_bounds]] - [[_COMMUNITY_test_pl_vehicle_personnel_photo_schema.py|test_pl_vehicle_personnel_photo_schema.py]] - [[_COMMUNITY_crm_quote_pdf.py|crm_quote_pdf.py]] - [[_COMMUNITY_shanxia2.0 后端骨架(FastAPI)|shanxia2.0 后端骨架(FastAPI)]] - [[_COMMUNITY_api_crypto_middleware.py|api_crypto_middleware.py]] - [[_COMMUNITY_order_status_compat.py|order_status_compat.py]] - [[_COMMUNITY_shanxia2.0 Backend 生产部署说明|shanxia2.0 Backend 生产部署说明]] - [[_COMMUNITY_db_collation.py|db_collation.py]] - [[_COMMUNITY___init__.py|__init__.py]] - [[_COMMUNITY___init__.py|__init__.py]] - [[_COMMUNITY_codebash (cd pathtoshanxia2.0)|code:bash (cd /path/to/shanxia2.0)]] - [[_COMMUNITY_codebash (.start-prod.sh status 查看状态)|code:bash (./start-prod.sh status # 查看状态)]] - [[_COMMUNITY_codebash (curl -s http127.0.0.19111health)|code:bash (curl -s http://127.0.0.1:9111/health)]] - [[_COMMUNITY_codebash (cd iflytekshanxia2.0backend)|code:bash (cd /iflytek/shanxia2.0/backend)]] - [[_COMMUNITY_codebash (python -m venv venv)|code:bash (python -m venv venv)]] - [[_COMMUNITY_codebash (pip install -r requirements.txt)|code:bash (pip install -r requirements.txt)]] - [[_COMMUNITY_codeenv ( 数据库配置)|code:env (# 数据库配置)]] - [[_COMMUNITY_codebash (uvicorn app.mainapp --reload --port 8000)|code:bash (uvicorn app.main:app --reload --port 8000)]] - [[_COMMUNITY_BaseModel|BaseModel]] - [[_COMMUNITY_PlanResourceSnapshotMixin|PlanResourceSnapshotMixin]] ## God Nodes (most connected - your core abstractions) 1. `BaseModel` - 506 edges 2. `get_tenant_no()` - 381 edges 3. `DbUserContext` - 305 edges 4. `success_response()` - 273 edges 5. `error_response()` - 269 edges 6. `BxUserContext` - 204 edges 7. `generate_uuid()` - 198 edges 8. `crm_user_info()` - 138 edges 9. `ExportValidationError` - 108 edges 10. `ExportColumn` - 106 edges ## Surprising Connections (you probably didn't know these) - `BackfillRule` --uses--> `Settings` [INFERRED] scripts/migrate_crm_sys_oss.py → app/core/config.py - `MigrationStats` --uses--> `Settings` [INFERRED] scripts/migrate_bx_data.py → app/core/config.py - `StepStats` --uses--> `Settings` [INFERRED] scripts/migrate_bx_data.py → app/core/config.py - `MigrationStats` --uses--> `Settings` [INFERRED] scripts/migrate_crm_clue.py → app/core/config.py - `StepStats` --uses--> `Settings` [INFERRED] scripts/migrate_crm_clue.py → app/core/config.py ## Import Cycles - None detected. ## Communities (186 total, 16 thin omitted) ### Community 0 - "Community 0" Cohesion: 0.13 Nodes (38): approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), create_personnel(), delete_carrier(), delete_driver(), delete_personnel() (+30 more) ### Community 1 - "Community 1" Cohesion: 0.08 Nodes (35): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), ContractApproverSettingSaveBody, ContractApprovalActionBody, ContractBatchAssignBody, ContractBatchSubmitBody, ContractChangeCreateBody (+27 more) ### Community 2 - "Community 2" Cohesion: 0.08 Nodes (53): dump_export_row(), issue_status_label(), Any, Session, respond_xlsx(), status_label(), advance_issue_stats(), batch_offset() (+45 more) ### Community 3 - "Community 3" Cohesion: 0.07 Nodes (82): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_menu_favorite(), create_post() (+74 more) ### Community 4 - "Community 4" Cohesion: 0.12 Nodes (61): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+53 more) ### Community 5 - "Community 5" Cohesion: 0.06 Nodes (89): archive_plan(), _build_plan_archive_export_rows(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), create_from_contract(), create_plan(), create_plan_full() (+81 more) ### Community 6 - "Community 6" Cohesion: 0.14 Nodes (38): assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer(), create_customer(), customer_name_exists(), deal_customer(), _enrich_user_names() (+30 more) ### Community 7 - "Community 7" Cohesion: 0.07 Nodes (78): clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_list(), clue_mine(), clue_to_follow() (+70 more) ### Community 8 - "Community 8" Cohesion: 0.10 Nodes (34): invalidate_all_approvals(), 作废该合同全部有效审批记录(含已通过/已拒绝),用于再编辑或重新提审。, approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), invalidate_all_approvals() (+26 more) ### Community 9 - "Community 9" Cohesion: 0.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.08 Nodes (39): demo_xlsx_export(), export_depts(), export_menus(), export_posts(), export_role_management(), export_sites(), export_tenants(), export_users() (+31 more) ### Community 11 - "Community 11" Cohesion: 0.15 Nodes (40): PlVehicleUreaApply, PlVehicleUreaDisburse, 车辆尿素申请 pl_vehicle_urea_apply, 车辆尿素发放登记 pl_vehicle_urea_disburse, Decimal, VehicleUreaApplyCreate, VehicleUreaApplyRead, VehicleUreaApplyUpdate (+32 more) ### Community 12 - "Community 12" Cohesion: 0.05 Nodes (69): MaintenanceApplyExportBody, MaintProcessExportBody, BaseModel, AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse (+61 more) ### Community 13 - "Community 13" Cohesion: 0.15 Nodes (36): BxApplyListExportBody, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), export_approved_by_me_reimburses(), export_my_reimburses() (+28 more) ### Community 14 - "Community 14" Cohesion: 0.09 Nodes (36): build_dict_value_from_label(), ensure_dict_data(), format_hhmm(), format_time_label(), grab(), join_work_plans(), normalize_person_name(), _pad_hhmm() (+28 more) ### Community 15 - "Community 15" Cohesion: 0.11 Nodes (16): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, BxReimburseInvoice, BxReimburseOffset, 报销单勾选的发票附件(同一发票可勾选多个附件,各占一条)。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn (+8 more) ### Community 16 - "Community 16" Cohesion: 0.11 Nodes (51): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), get_apply(), get_record(), Session (+43 more) ### Community 17 - "Community 17" Cohesion: 0.17 Nodes (36): DutyAssignment, DutyDay, DutySlot, 值班排班模型 — docs/superpowers/specs/2026-08-14-duty-schedule-design.md, assert_user_is_duty_staff(), _assignment_dict(), build_public_url(), _count_active_assignments() (+28 more) ### Community 18 - "Community 18" Cohesion: 0.10 Nodes (42): _advance_list_filters(), advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _export_advance_rows() (+34 more) ### Community 19 - "Community 19" Cohesion: 0.18 Nodes (31): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), legacy_parent_id(), load_oss_id_to_url(), load_runtime_settings() (+23 more) ### Community 20 - "Community 20" Cohesion: 0.13 Nodes (35): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), export_settlements(), export_unsettled_plans(), _generate_settlement_no() (+27 more) ### Community 21 - "Community 21" Cohesion: 0.08 Nodes (60): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors() (+52 more) ### Community 22 - "Community 22" Cohesion: 0.08 Nodes (28): parse_admin_request_json(), Any, Request, 运营 Web(/web/admin)JSON 请求体解析。 与 ApiCryptoMiddleware 配合:中间件未改写 body 时,在路由内解密 `{, 读取 JSON body;dict 时走 resolve_request_payload(明文 / 密文 / data 包装)。 Returns:, ApiCryptoError, _b64url_decode(), _b64url_encode() (+20 more) ### Community 23 - "Community 23" Cohesion: 0.09 Nodes (69): ContractGapExportBody, _generate_notify_message(), PlanExportBody, update_plan(), PlPlan, PlPlanChange, PlPlanProduct, PlPlanTransport (+61 more) ### Community 24 - "Community 24" Cohesion: 0.19 Nodes (16): DictEnsureError, ensure_dict_data(), ensure_remove_dict_data(), Session, 业务页字典 ensure:白名单内按 label 复用或插入 sys_dict_data。, label miss, but preferred value already exists → reuse, no insert, test_ensure_honors_explicit_preferred_value_on_insert(), test_ensure_inserts_new_with_value_equals_label() (+8 more) ### Community 25 - "Community 25" Cohesion: 0.26 Nodes (12): list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, Java: statisticsVisits, 简易 User-Agent 解析(替代 Hutool UserAgentUtil), Java: queryLogsByQuoteId (+4 more) ### Community 26 - "Community 26" Cohesion: 0.11 Nodes (43): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+35 more) ### Community 27 - "Community 27" Cohesion: 0.11 Nodes (32): CRM 报价单 API 路由 — 挂接到 crm.router, QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody, QuoteCreateBody (+24 more) ### Community 28 - "Community 28" Cohesion: 0.09 Nodes (61): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+53 more) ### Community 29 - "Community 29" Cohesion: 0.18 Nodes (18): align_contract_no_to_sign_date(), generate_contract_no(), date, Java: generateContractNo — {供方编码}/X-JT{yyyyMMdd}{3位序号} 流水与撞号检测须含软删:uk_contr, 标准编号替换日期段,保留序号;非标准返回 None。, 将标准合同编号日期段对齐签订日;撞号则序号顺延(含软删查重)。 非标准编号原样返回。无签订日则原样返回。, replace_contract_no_date(), _mock_last_contract() (+10 more) ### Community 30 - "Community 30" Cohesion: 0.16 Nodes (26): clear_target_categories(), compute_level(), count_target_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+18 more) ### Community 31 - "Community 31" Cohesion: 0.11 Nodes (40): apply_dibang_prefill_to_order(), apply_site_feedback(), build_io_order_site_url(), create_io_order_for_transport(), _dibang_qty_by_plan_product(), enrich_io_items_with_brand_feedback(), enrich_io_order_dict(), _format_io_product_summary_line() (+32 more) ### Community 32 - "Community 32" Cohesion: 0.19 Nodes (23): 验证密码(哈希非 bcrypt 或损坏时返回 False,避免抛错), verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+15 more) ### Community 33 - "Community 33" Cohesion: 0.24 Nodes (18): create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any, date, Session, _row_to_dict() (+10 more) ### Community 34 - "Community 34" Cohesion: 0.15 Nodes (21): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+13 more) ### Community 35 - "Community 35" Cohesion: 0.18 Nodes (36): clear_portal_workflow(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_bx_user_mapping(), load_runtime_settings() (+28 more) ### Community 36 - "Community 36" Cohesion: 0.13 Nodes (27): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_update(), pool_rule_update_status(), create_pool_rule(), delete_pool_rules() (+19 more) ### Community 37 - "Community 37" Cohesion: 0.10 Nodes (36): menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult, cancel_apply(), create_apply() (+28 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.22 Nodes (28): assign_clues(), check_convert(), check_duplicate_clue(), convert_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope(), get_clue() (+20 more) ### Community 40 - "Community 40" Cohesion: 0.12 Nodes (32): _apply_contract_entity_fields(), _build_contract_filters(), _calc_amount_with_tax(), contract_no_exists(), create_contract(), create_contract_template(), create_from_opportunity(), create_from_quote() (+24 more) ### Community 41 - "Community 41" Cohesion: 0.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.19 Nodes (32): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+24 more) ### Community 43 - "Community 43" Cohesion: 0.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.31 Nodes (49): AttachmentDownloadUrlBody, DemoXlsxColumnSpec, DemoXlsxExportBody, DeptCreateBody, DeptExportBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody (+41 more) ### Community 46 - "Community 46" Cohesion: 0.10 Nodes (65): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), _build_customer_address(), _change_row_to_dict(), _contract_period_key(), contract_row_to_dict(), create_contract_change() (+57 more) ### Community 47 - "Community 47" Cohesion: 0.12 Nodes (20): pool_customer_assign(), pool_customer_claim(), pool_customer_export(), pool_customer_list(), pool_record_detail(), pool_record_list(), list_pool_customers(), get_pool_record() (+12 more) ### Community 48 - "Community 48" Cohesion: 0.21 Nodes (22): clear_target_products(), count_target_rows(), _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings() (+14 more) ### Community 49 - "Community 49" Cohesion: 0.14 Nodes (19): create_expense_item(), delete_expense_item(), ExpenseItemExportBody, export_expense_items(), _flatten_expense_tree(), get_expense_item(), get_expense_item_tree(), Session (+11 more) ### Community 50 - "Community 50" Cohesion: 0.17 Nodes (27): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version(), get_nodes_by_version(), get_pending_tasks_by_node() (+19 more) ### Community 51 - "Community 51" Cohesion: 0.22 Nodes (21): _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), export_transport_addresses(), _get_address(), get_transport_address(), list_all_transport_addresses() (+13 more) ### Community 52 - "Community 52" Cohesion: 0.05 Nodes (82): _attach_history_products(), _build_history_page(), _build_page(), _get_by_token(), _history_status_label(), _models(), _parse_history_date(), date (+74 more) ### Community 53 - "Community 53" Cohesion: 0.12 Nodes (16): 供方全量列表(下拉)— Java: CrmSupplierInfoController.listAll, 供方详情 — Java: CrmSupplierInfoController.getInfo, 新增供方 — Java: CrmSupplierInfoController.add, 修改供方 — Java: CrmSupplierInfoController.edit, 删除供方 — Java: CrmSupplierInfoController.remove, supplier_info_add(), supplier_info_delete(), supplier_info_detail() (+8 more) ### Community 54 - "Community 54" Cohesion: 0.12 Nodes (29): list_personnel(), _personnel_to_read(), PlCert, CertRead, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot (+21 more) ### Community 55 - "Community 55" Cohesion: 0.45 Nodes (11): _customer_base_query(), get_follow_statistics(), get_industry_statistics(), get_level_statistics(), get_overview_statistics(), get_owner_statistics(), get_source_statistics(), get_trend_statistics() (+3 more) ### Community 56 - "Community 56" Cohesion: 0.12 Nodes (28): PlInventory, PlInventoryTransaction, 库存流水表 pl_inventory_transaction, load_brand_qtys_by_plan_product_ids(), persist_plan_product_brand_qtys(), Any, Decimal, Session (+20 more) ### Community 57 - "Community 57" Cohesion: 0.19 Nodes (18): create_leave(), delete_leave(), export_leaves(), get_leave(), _leave_local_callback(), leave_workflow_callback(), LeaveExportBody, list_leaves() (+10 more) ### Community 58 - "Community 58" Cohesion: 0.09 Nodes (38): get_current_time(), parse_datetime(), datetime, ReimburseDetailOut, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时,进度接口仅展示当前轮次。, 审批进度仅展示当前轮次;完整历史由 get_approval_history 返回。, 报销模块 Service 基类 — 租户隔离 + UUID + 软删除。 (+30 more) ### Community 59 - "Community 59" Cohesion: 0.20 Nodes (28): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+20 more) ### Community 60 - "Community 60" Cohesion: 0.24 Nodes (5): MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint;未配置或与内网相同时复用 self.client。, MinIO 预签名下载 URL,携带原始文件名。, MinIO 预签名内联预览 URL(图片新标签页 / PDF iframe 等)。 上传时 put_object 未写 content_typ ### Community 61 - "Community 61" Cohesion: 0.15 Nodes (37): 地磅公共只读:免登车牌 options(现场填写页), DbInboundOutbound, DbPurchasePlan, 地磅(db)模块数据模型 — 对齐 docs/sql/db_tables.sql, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, parse_date_str(), _apply_plan_quantity_delta() (+29 more) ### Community 62 - "Community 62" Cohesion: 0.10 Nodes (67): register_quote_routes(), accept_quote(), assert_quote_editable_for_update(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+59 more) ### Community 63 - "Community 63" Cohesion: 0.32 Nodes (16): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+8 more) ### Community 64 - "Community 64" Cohesion: 0.13 Nodes (23): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+15 more) ### Community 65 - "Community 65" Cohesion: 0.10 Nodes (61): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), export_applies(), export_process_board(), get_apply() (+53 more) ### Community 66 - "Community 66" Cohesion: 0.17 Nodes (29): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), export_inventory(), _generate_batch_no() (+21 more) ### Community 67 - "Community 67" Cohesion: 0.12 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.11 Nodes (32): _append_user_scope_conditions(), apply_data_scope(), assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 (+24 more) ### Community 70 - "Community 70" Cohesion: 0.18 Nodes (29): _dec(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_oss_id_to_url(), load_runtime_settings(), load_settings_env() (+21 more) ### Community 71 - "Community 71" Cohesion: 0.14 Nodes (23): CarrierAuditReject, CarrierBase, CarrierCreate, CarrierQualificationBase, DriverBase, DriverCreate, DriverListResponse, DriverUpdate (+15 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.11 Nodes (38): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), export_weighing(), _get_weighing(), get_weighing_related() (+30 more) ### Community 75 - "apply_crm_create_by_scope" Cohesion: 0.33 Nodes (8): allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime, Session, 业务协议号自动生成:XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。 须在 create 事务内调用;使用 MySQL LAST_INSERT_ID 保证并发安全。, BizNoKind ### Community 76 - "opportunity_follow.py" Cohesion: 0.14 Nodes (15): 流程实例 wf_process_instance, WfProcessInstance, _dispatch_local(), Any, 工作流回调服务 —— 流程状态变更时通知业务系统, 注册本地回调函数。当 callback_url 以 path 开头时直接调用 fn。, 尝试本地直调。返回 True 表示已处理,False 表示无匹配的本地回调。, 流程实例状态变更后,向业务系统发送回调通知。 优先级: 1. 如果 callback_url 是内部路径(以 / 开头),优先尝试本地直调 (+7 more) ### Community 77 - "Community 77" Cohesion: 0.11 Nodes (12): get_wechat_pay_client(), get_wechat_pay_v2(), Any, 微信支付工具模块 支持微信支付 V3 API 文档参考: https://pay.weixin.qq.com/docs/v3/apis/index.html, 统一下单接口 (V3) Args: out_trade_no: 商户订单号 total_amo, 申请退款 Args: out_trade_no: 商户订单号 total_amount: 订单, 小程序调起支付的二次签名参数(与公众号 JSAPI 规则一致), 统一下单 (V2 API) Args: out_trade_no: 商户订单号 total_f (+4 more) ### Community 78 - "Community 78" Cohesion: 0.24 Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType ### Community 79 - "PlCarrier" Cohesion: 0.29 Nodes (12): build_name_pinyin_abbr(), normalize_name_pinyin_abbr(), 名称拼音首字母缩写:库内存小写,检索时大小写不敏感。, 保存时解析拼音字段。 - submitted_provided=True:用提交值(空则按 name 生成) - 否则:已有非空 existi, resolve_name_pinyin_abbr(), test_chinese_and_alnum(), test_empty_and_whitespace(), test_resolve_not_submitted_empty_existing_generates() (+4 more) ### Community 80 - "resolve_crm_product" Cohesion: 0.12 Nodes (33): create_clue_follow(), delete_clue_follow(), get_clue_follow(), get_follow_statistics(), list_clue_follows(), Any, Session, 更新线索跟进记录,必要时同步线索 next_time (+25 more) ### Community 81 - "customer_follow.py" Cohesion: 0.28 Nodes (13): create_vehicle(), export_vehicles(), get_vehicle(), list_vehicles(), 导出车辆列表(当前筛选全量,或 ids 已选)。, update_vehicle(), _vehicle_to_detail(), _vehicle_to_read() (+5 more) ### Community 82 - "storage.py" Cohesion: 0.13 Nodes (33): PlPlanContract, 运输计划-合同关联(分侧多选) pl_plan_contract, PlanContractGapRead, PlanContractLink, PlanProductRead, is_internal_customer_name(), 运输计划:内置山峡/云栋客户判定(合同可免), build_plan_contract_gap_read() (+25 more) ### Community 83 - "Community 83" Cohesion: 0.09 Nodes (52): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer() (+44 more) ### Community 84 - "Community 84" Cohesion: 0.23 Nodes (23): build_id_maps(), clip_text(), count_rows(), export_mapping(), fetch_rows(), legacy_id_to_str(), main(), map_id() (+15 more) ### Community 85 - "allocate_next_biz_no" Cohesion: 0.15 Nodes (23): _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj(), _schedule_persist_log() (+15 more) ### Community 86 - "Community 86" Cohesion: 0.11 Nodes (18): ApiCryptoMiddleware, ApiRequestLogMiddleware, _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常:返回 JSON 并保留 CORS 头,避免浏览器只报跨域错误 (+10 more) ### Community 87 - "Community 87" Cohesion: 0.24 Nodes (11): extract_minio_object_key(), join_relative_urls(), normalize_oss_storage_url(), MinIO 附件 URL 规范化(数据迁移共用)。 背景 ---- CRM / 地磅 / 报销与 shanxia2.0 共用同一 MinIO(bucket 默, 业务表 OSS ID 串 → 相对 URL 串(用于客户证照、跟进附件等)。, 去掉预签名 query(``?X-Amz-...``)。, 将绝对/相对 URL 规范为 MinIO object key(不含 bucket)。, 迁移 CRM ``sys_oss`` 行:``url`` + ``file_name`` → 门户相对路径。 (+3 more) ### Community 88 - "CrmProduct" Cohesion: 0.36 Nodes (15): create_opportunity_follow(), _ensure_parent_opportunity(), get_opportunity_follow(), list_follows_by_opportunity(), list_opportunity_follows(), _parse_optional_datetime(), Any, datetime (+7 more) ### Community 89 - "pl_ocr_service.py" Cohesion: 0.19 Nodes (22): PlOcrUsageMonth, 阿里云 OCR 月度调用计数 pl_ocr_usage_month(按自然月全局统计), assert_quota_available(), _build_ocr_client(), compress_image_bytes(), current_usage_month(), _first_attachment_url(), get_or_create_usage_row() (+14 more) ### Community 90 - "WechatMessageService" Cohesion: 0.17 Nodes (8): 发送订单状态通知 Args: openid: 用户openid order_n, 发送支付成功通知 Args: openid: 用户openid order_n, 发送配送通知 Args: openid: 配送员openid task_no:, 发送配送时效预警 Args: openid: 配送员openid task_n, 发送退款结果通知 Args: openid: 用户openid order_n, 发送催单通知给配送员 Args: deliver_openid: 配送员openid, 发送模板消息 Args: openid: 用户openid template_, WechatMessageService ### Community 91 - "opportunity_product.py" Cohesion: 0.07 Nodes (28): category_add(), category_delete(), category_tree(), category_update(), _map_product_export_column_keys(), product_add(), product_delete(), product_detail() (+20 more) ### Community 92 - "Community 92" Cohesion: 0.20 Nodes (21): _assert_users_exist(), get_setting(), Any, Session, _row_to_dict(), save_setting(), _assert_users_exist(), get_setting() (+13 more) ### Community 93 - "api_request_log_middleware.py" Cohesion: 0.07 Nodes (46): ApiRequestLogCRUD, Session, list_ethnics(), Any, Session, 民族码表 CRUD(全局 sys_ethnic), _row_to_dict(), create_leave() (+38 more) ### Community 94 - "assert_contract_editable_for_update" Cohesion: 0.60 Nodes (3): assert_contract_editable_for_update(), test_assert_allows_editable(), test_assert_rejects_non_editable() ### Community 95 - "test_pl_public_link_archived.py" Cohesion: 0.29 Nodes (6): Config, format_api_error_message(), PageResult, Exception, 将 HTTP/SQLAlchemy 等异常转为可展示的错误文案(避免 str([]) 空列表)。, ResponseModel ### Community 96 - "minio_url.py" Cohesion: 0.30 Nodes (12): PlCarrier, assert_carrier_eligible_for_transport(), carrier_agreement_expired(), carrier_audit_approved(), carrier_eligible_for_transport(), carrier_qualification_complete(), date, 资质附件均为选填,保留函数签名供兼容调用。 (+4 more) ### Community 97 - "contact.py" Cohesion: 0.15 Nodes (25): 地磅 API 路由聚合 — REST 风格,协议对齐原 simple-dibang-xiaoshou。, _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), _generate_plan_no() (+17 more) ### Community 98 - "LocalStorage" Cohesion: 0.35 Nodes (11): create_tenant(), get_tenant(), list_tenants(), Any, Session, _row_to_dict(), soft_delete_tenant(), tenant_no_exists() (+3 more) ### Community 99 - "redis_client.py" Cohesion: 0.12 Nodes (25): calc_age_from_chinese_id_card(), date, 从 18 位身份证号计算周岁。号码不完整或出生日期无效时返回 None。, generate_uuid(), VehiclePersonnelRow, load_vehicle_personnel_rows(), Session, 运输计划 - 人员 upsert 与车辆-人员关联保存 (+17 more) ### Community 100 - "price_letter_detail" Cohesion: 0.27 Nodes (15): Settings, BaseSettings, apply_renumber(), build_mapping(), fetch_products(), format_new_product_no(), load_settings_env(), main() (+7 more) ### Community 101 - "tenant.py" Cohesion: 0.29 Nodes (15): clue_statistics_level(), clue_statistics_overview(), clue_statistics_owner(), clue_statistics_source(), clue_statistics_trend(), _apply_create_range(), _base_query(), get_clue_level_statistics() (+7 more) ### Community 102 - "BaseStorage" Cohesion: 0.22 Nodes (3): BaseStorage, 带下载文件名的访问 URL;默认实现为普通访问地址。, 浏览器内联预览 URL;默认实现为普通访问地址。 ### Community 103 - "pl_internal_customer.py" Cohesion: 0.08 Nodes (25): clue_assign(), clue_convert(), clue_create(), clue_delete(), clue_follow_create(), clue_follow_delete(), clue_follow_list(), clue_follow_update() (+17 more) ### Community 104 - "apply_crm_create_by_scope" Cohesion: 0.29 Nodes (15): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+7 more) ### Community 105 - "pool_customer_assign" Cohesion: 0.24 Nodes (12): get_last_month_range(), month_range(), date, Session, 地磅计划按月自动生成 — 迁移自 simple-dibang-xiaoshou/auto-create-plan/auto_create_monthly_pla, 按月自动生成采购计划。 - 默认仅在每月 1 日执行(force=True 时跳过该限制,供手动触发验收) - 遍历所有租户,按上月计划模板生, run_auto_generate_monthly_plans(), default_execution_status() (+4 more) ### Community 106 - "site.py" Cohesion: 0.21 Nodes (24): CarrierExportBody, DriverExportBody, paste_recognize_commit(), PersonnelExportBody, VehicleExportBody, PlPersonnel, PlVehicleDriver, PlVehiclePersonnel (+16 more) ### Community 107 - "apply_pl_scope" Cohesion: 0.12 Nodes (47): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), CompletedTaskExportBody, create_process_def(), delete_process_def(), _enrich_task_list(), export_completed_tasks() (+39 more) ### Community 108 - "statistics.py" Cohesion: 0.20 Nodes (24): count_source_rows(), derive_source_url(), fetch_portal_admin_id(), fetch_source_rows(), legacy_id_to_str(), load_runtime_settings(), load_settings_env(), load_user_mapping() (+16 more) ### Community 109 - "duty.py" Cohesion: 0.15 Nodes (22): day_detail(), delete_assignment(), duty_user_options(), _enrich_assign_names(), ensure_duty_dict(), month_summary(), Session, 指定用户时补全 personName(用 nick_name)。 (+14 more) ### Community 110 - "list_duty_staff_users" Cohesion: 0.33 Nodes (13): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), Any (+5 more) ### Community 111 - "dict_data.py" Cohesion: 0.27 Nodes (11): create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), Any, Session, 字典数据 CRUD(sys_dict_data), 字典下拉选项:租户主数据,忽略数据范围(user_info 保留兼容调用方,不参与过滤)。 (+3 more) ### Community 112 - "merge_duplicate_crm_customers.py" Cohesion: 0.29 Nodes (20): Connection, backup_tables(), _contact_key(), discover_merge_pairs(), fetch_customer(), _invoice_key(), load_database_url(), main() (+12 more) ### Community 113 - "dict_type.py" Cohesion: 0.35 Nodes (11): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), Any, Session, 字典类型 CRUD(sys_dict_type), _row_to_dict() (+3 more) ### Community 114 - "mappers.py" Cohesion: 0.26 Nodes (19): get_plan_related(), format_datetime(), _create_by_name(), datetime_end_of_day(), fmt_date(), fmt_datetime(), inventory_date_to_api(), inventory_to_read() (+11 more) ### Community 115 - "site.py" Cohesion: 0.28 Nodes (14): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+6 more) ### Community 116 - "Community 116" Cohesion: 0.17 Nodes (28): batch_insert_quote_products(), calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product() (+20 more) ### Community 117 - "price_letter_detail" Cohesion: 0.36 Nodes (9): create_oss(), get_oss_by_id(), get_oss_by_url(), Session, 按主键 id 查询附件(兼容旧 CRM 雪花 oss_id 迁入后的记录), 将 fileUrl 或旧 CRM 数字 ossId 解析为 MinIO 相对路径。 门户新上传把相对路径写入业务字段;迁入合同附件仍存数字 ossId, resolve_storage_path(), CRM 模块数据模型(产品分类、产品主表、统一附件表、客户管理、公海池、线索管理) (+1 more) ### Community 118 - "Community 118" Cohesion: 0.20 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.18 Nodes (17): get_oper_log_meta(), OperLogMeta, 请求级操作日志元数据(ContextVar), 供异步落库线程使用,避免 ContextVar 跨线程丢失。, set_oper_log_meta(), snapshot_oper_log_meta(), _format_summary(), oper_log() (+9 more) ### Community 121 - "post.py" Cohesion: 0.39 Nodes (10): create_post(), get_post(), list_posts(), post_code_exists(), Any, Session, _row_to_dict(), soft_delete_post() (+2 more) ### 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.07 Nodes (47): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+39 more) ### Community 124 - "vehicle_recharge.py" Cohesion: 0.25 Nodes (13): export_recharge_applies(), export_recharge_disburse_board(), list_applies(), list_disburse_board(), list_records(), pending_apply_options(), date, RechargeApplyExportBody (+5 more) ### Community 125 - "resolve_crm_product" Cohesion: 0.50 Nodes (4): customer_options(), 客户下拉选项(租户内只读,不做 owner 数据权限), CustomerOptionsBody, 客户下拉选项请求体(租户内只读搜索,不做 owner 数据权限) ### Community 126 - "customer_pool.py" Cohesion: 0.36 Nodes (13): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), menu_name_exists(), Any (+5 more) ### Community 127 - "get_current_user_by_token" Cohesion: 0.21 Nodes (14): change_current_user_password(), get_current_user_profile(), get_web_auth_menu_codes(), public_quote_share(), Request, Session, 获取当前用户信息(与 sys_user 字段对应)。, 获取当前用户菜单权限标识(sys_menu.perms,经角色继承)。 (+6 more) ### Community 128 - "product_allowed" Cohesion: 0.21 Nodes (15): _build_contract_name_from_parties(), _get_supplier_short_name(), 根据供需方面板与主数据生成/校正合同名称。, get_supplier_info(), assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed() (+7 more) ### Community 129 - "BaseStorage" Cohesion: 0.12 Nodes (24): _auto_contract_name_body(), generate_contract_name(), 按面板单位全称精确匹配交易主体/客户主数据,取 shortName;对不上则用全称。, 前端预览误用单位全称时,名称片段会等于面板/客户/开票全称。, 按面板供方(partyA)-需方(partyB)生成:{供方简称}-{需方简称}({合同编号})。 - 名称为空:按主数据简称自动生成 - 名, resolve_party_short_name(), _strip_contract_name_no_suffix(), _user_contract_name_uses_party_full_name() (+16 more) ### Community 130 - "invoice_info.py" Cohesion: 0.38 Nodes (13): ensure_crm_customer_linked_row_in_scope(), 客户子表(开票信息等):先校验关联客户 owner scope,否则校验 create_by。, _clear_default_for_customer(), create_invoice_info(), get_invoice_info(), list_invoice_info_by_customer(), Any, Session (+5 more) ### Community 131 - "customer_follow.py" Cohesion: 0.40 Nodes (12): create_follow(), _enrich_follow_dict(), get_follow(), list_follows(), list_follows_by_customer(), Any, Session, _row_to_dict() (+4 more) ### Community 132 - "context.py" Cohesion: 0.04 Nodes (81): clue_import_template(), contact_add(), contact_delete(), contact_update(), customer_create(), customer_delete(), customer_import_template(), customer_update() (+73 more) ### Community 133 - "inventory_id.py" Cohesion: 0.28 Nodes (11): DbSequence, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id(), Session, 出入库单 id 生成 — 租户内纯数字自增,并发安全。, 当前租户下纯数字 id 的最大值(不含 UUID 等非数字主键)。 (+3 more) ### Community 134 - "price_letter_detail" Cohesion: 0.17 Nodes (11): price_letter_add(), price_letter_detail(), price_letter_list(), price_letter_update(), price_letter_void(), PriceLetterCreateBody, PriceLetterDetailBody, PriceLetterListBody (+3 more) ### Community 135 - "storage.py" Cohesion: 0.18 Nodes (6): convert_heic_to_jpeg(), _guess_preview_content_type(), QiniuStorage, 文件存储工具模块 支持多种存储方式: 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 按对象键后缀推断内联预览 Content-Type(纠正上传时未写入 MIME 的情况)。, 将 HEIC/HEIF 格式转换为 JPEG 格式 ### Community 136 - "Community 136" Cohesion: 0.26 Nodes (14): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD(sys_role / sys_role_menu / sys_role_data_scope_detail) (+6 more) ### Community 137 - "plan_has_incomplete_hazard_cert_exists" Cohesion: 0.25 Nodes (10): _cert_url_blank(), plan_has_hazard_product_exists(), plan_has_incomplete_hazard_cert_exists(), 证书 URL 为空(NULL / 空串 / 纯空白)。, 列表筛选:计划下存在 CRM 标识为易制毒/易制爆的产品。, 列表筛选:存在危化产品且至少一张必需证书未上传。, _compile(), 危化品证上传列表筛选:EXISTS 子查询应覆盖 CRM 危化标识与证书缺口。 (+2 more) ### Community 138 - "Community 138" Cohesion: 0.33 Nodes (19): check_python(), create_venv(), ensure_dirs(), ensure_valid_venv(), ensure_venv_and_runtime(), install_dependencies(), is_running(), log_error() (+11 more) ### Community 139 - "get_current_user_by_token" Cohesion: 0.22 Nodes (15): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage,对外保持 bx 协议。 (+7 more) ### Community 140 - "UserRole" Cohesion: 0.10 Nodes (22): API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,14 个一级菜单), operlog_detail(), operlog_export(), operlog_list(), OperLogExportBody, Session (+14 more) ### Community 141 - "redis_client.py" Cohesion: 0.39 Nodes (8): get_redis_client(), get_sync_redis_client(), Redis, 共享 Redis 客户端(同步:会话鉴权;异步:API 加密 nonce)。, 同步 Redis(auth 会话等,在线程池中调用)。, 异步 Redis(API 加密 nonce 等中间件)。, _redis_common_kwargs(), redis_enabled() ### Community 142 - "opportunity_export" Cohesion: 0.48 Nodes (7): _opp_list_kwargs(), opportunity_export(), opportunity_kanban(), opportunity_list(), opportunity_mine_list(), OpportunityKanbanBody, OpportunityListBody ### Community 143 - "_build_user_info_payload" Cohesion: 0.40 Nodes (5): _avatar_url_field(), _build_user_info_payload(), 与 web-admin 静态路由 meta.roles(admin/super_admin)对齐的单元素数组。, 与 web-admin `userInfo` 字段约定一致。, _web_role_list() ### Community 145 - "resolve_crm_product" Cohesion: 0.14 Nodes (24): PlTransportProductBrandQty, PlTransportProductFeedback, 运输单按产品回传 pl_transport_product_feedback, 运输单产品回传品牌数量 pl_transport_product_brand_qty, _dict_field(), format_brand_qty_summary(), load_transport_driver_product_feedbacks(), persist_io_item_brand_qtys() (+16 more) ### Community 146 - "list_public_vehicle_plates" Cohesion: 0.67 Nodes (4): list_public_vehicle_plates(), Session, 免登:按出入库/计划解析 tenant_no,返回 pl_vehicle 车牌(self + carrier)。, _resolve_tenant_no() ### Community 147 - "Community 147" Cohesion: 0.37 Nodes (17): check_env(), check_python(), create_venv(), init_env(), install_dependencies(), log_error(), log_info(), log_success() (+9 more) ### Community 149 - "datetime_parse.py" Cohesion: 0.67 Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析:前端 date-picker 仅传 YYYY-MM-DD。 ### Community 159 - "customer_update" Cohesion: 0.24 Nodes (14): _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), _map_role_name_to_web(), Session, Web 管理端登录:基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析, 角色仅勾选按钮(F)时,补齐祖先 C/M 菜单 id,便于前端匹配 :list 路由。, 用户通过角色关联得到的菜单权限标识(sys_menu.perms,与前端 meta.menuCode 对齐)。 (+6 more) ### Community 162 - ".to_tenant_user_dict" Cohesion: 0.42 Nodes (7): default_settlement_clause(), test_advance_payment_clause(), test_arrive_payment_clause(), test_empty_falls_back_to_arrive(), test_monthly_settlement_clause_uses_label(), test_unknown_falls_back_to_arrive(), test_volume_quarterly_other_labels() ### Community 164 - "get_client_ip" Cohesion: 0.15 Nodes (29): _jwt_user_payload(), logout(), 公共接口(Web 登录、刷新 Token、登出;用户模型对齐 docs/sql/shanxia2.0.sql 基线), 登出:吊销 Redis 会话(若已配置 REDIS_HOST)。无 Token 或已失效时仍返回成功(幂等)。, Web 端登录用 RSA 公钥(PKCS#1 v1.5,与 JSEncrypt 一致), Web 端登录:账号为 sys_user.user_no,密码为 sys_user.password(bcrypt)。, refresh_token(), web_login() (+21 more) ### Community 170 - "test_quote_approver_setting.py" Cohesion: 0.12 Nodes (5): LocalStorage, OSSStorage, process_image_content(), Path, 处理图片内容,如果是 HEIC 格式则转换为 JPEG ### Community 173 - "resolve_create_time_bounds" Cohesion: 0.06 Nodes (71): _build_driver_url(), get_plan_arrange_info(), 获取计划已安排运输后的司机链接与地磅出入库关联(供查看弹窗复制简述/二维码)。, _resolve_other_personnel(), _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible() (+63 more) ### Community 179 - "test_pl_vehicle_personnel_photo_schema.py" Cohesion: 0.27 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.24 Nodes (13): _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key(), Redis (+5 more) ### Community 237 - "order_status_compat.py" Cohesion: 0.36 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 `redis_client.py` to `Community 0`, `invoice_info.py`, `customer_follow.py`, `Community 4`, `Community 5`, `Community 6`, `inventory_id.py`, `Community 8`, `Community 136`, `Community 11`, `Community 14`, `Community 15`, `Community 16`, `Community 17`, `Community 18`, `resolve_crm_product`, `Community 21`, `Community 23`, `Community 24`, `Community 25`, `Community 26`, `Community 28`, `Community 31`, `Community 32`, `Community 33`, `get_client_ip`, `Community 36`, `Community 39`, `Community 40`, `Community 43`, `resolve_create_time_bounds`, `Community 46`, `Community 47`, `Community 50`, `Community 51`, `Community 54`, `Community 56`, `Community 58`, `Community 61`, `Community 62`, `Community 64`, `Community 65`, `Community 67`, `Community 72`, `Community 74`, `apply_crm_create_by_scope`, `resolve_crm_product`, `customer_follow.py`, `storage.py`, `Community 83`, `CrmProduct`, `pl_ocr_service.py`, `Community 92`, `api_request_log_middleware.py`, `contact.py`, `LocalStorage`, `apply_crm_create_by_scope`, `pool_customer_assign`, `site.py`, `list_duty_staff_users`, `dict_data.py`, `dict_type.py`, `Community 116`, `price_letter_detail`, `Community 118`, `post.py`, `site.py`, `customer_options`, `customer_pool.py`?** _High betweenness centrality (0.172) - this node is a cross-community bridge._ - **Why does `BaseModel` connect `Community 12` to `Community 0`, `Community 1`, `Community 2`, `Community 3`, `context.py`, `Community 5`, `price_letter_detail`, `Community 7`, `Community 10`, `Community 11`, `UserRole`, `Community 13`, `opportunity_export`, `Community 15`, `Community 16`, `Community 18`, `Community 20`, `Community 23`, `Community 26`, `Community 27`, `Community 34`, `Community 36`, `Community 37`, `Community 41`, `Community 43`, `Community 45`, `resolve_create_time_bounds`, `Community 47`, `Community 49`, `Community 51`, `Community 52`, `Community 53`, `Community 54`, `Community 57`, `Community 58`, `Community 63`, `Community 64`, `Community 65`, `Community 66`, `Community 71`, `Community 74`, `storage.py`, `Community 83`, `opportunity_product.py`, `api_request_log_middleware.py`, `test_pl_public_link_archived.py`, `contact.py`, `redis_client.py`, `tenant.py`, `pl_internal_customer.py`, `site.py`, `apply_pl_scope`, `duty.py`, `site.py`, `Community 119`, `customer_options`, `vehicle_recharge.py`, `resolve_crm_product`?** _High betweenness centrality (0.098) - this node is a cross-community bridge._ - **Why does `Settings` connect `price_letter_detail` to `Community 35`, `Community 67`, `Community 70`, `Community 73`, `Community 42`, `statistics.py`, `Community 44`, `config.py`, `Community 48`, `Community 19`, `Community 59`, `Community 30`?** _High betweenness centrality (0.084) - this node is a cross-community bridge._ - **Are the 30 inferred relationships involving `DbUserContext` (e.g. with `InventoryExportBody` and `InventoryRelatedData`) actually correct?** _`DbUserContext` has 30 INFERRED edges - model-reasoned connections that need verification._ - **What connects `API 路由包 — 山峡化工生产一体化门户`, `返回运营端角色下拉选项(label=库中角色名,value=Web 角色码)。`, `返回用户下拉选项(label=昵称,value=用户ID,附带 nickName/userNo)。 供申请人/审批人等选择场景使用,返回本租户全部有效` to the rest of the system?** _612 weakly-connected nodes found - possible documentation gaps or missing edges._ - **Should `Community 0` be split into smaller, more focused modules?** _Cohesion score 0.12955465587044535 - nodes in this community are weakly interconnected._ - **Should `Community 1` be split into smaller, more focused modules?** _Cohesion score 0.07549361207897794 - nodes in this community are weakly interconnected._