Files
shanxia2.0/backend/graphify-out/GRAPH_REPORT.md
T

51 KiB
Raw Blame History

Graph Report - backend (2026-08-02)

Corpus Check

  • 303 files · ~206,845 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 4549 nodes · 15463 edges · 532 communities (514 shown, 18 thin omitted)
  • Extraction: 97% EXTRACTED · 3% INFERRED · 0% AMBIGUOUS · INFERRED: 410 edges (avg confidence: 0.53)
  • Token cost: 0 input · 0 output

Graph Freshness

  • Built from commit: 8d9f5777
  • 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)

God Nodes (most connected - your core abstractions)

  1. BaseModel - 442 edges
  2. get_tenant_no() - 349 edges
  3. DbUserContext - 254 edges
  4. success_response() - 253 edges
  5. error_response() - 235 edges
  6. generate_uuid() - 195 edges
  7. BxUserContext - 183 edges
  8. crm_user_info() - 137 edges
  9. assert_row_deletable_by_creator() - 83 edges
  10. ApiResponse - 79 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 (532 total, 18 thin omitted)

Community 0 - "Community 0"

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

Community 1 - "Community 1"

Cohesion: 0.15 Nodes (22): _build_quote_filters(), _decimal_value(), _fill_contract_linked_count(), list_quotes(), _parse_optional_datetime(), _period_key(), Any, datetime (+14 more)

Community 2 - "Community 2"

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

Cohesion: 0.08 Nodes (87): attachment_download_url(), attachment_preview_url(), AttachmentDownloadUrlBody, create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_post() (+79 more)

Community 4 - "Community 4"

Cohesion: 0.09 Nodes (76): _apply_list_filters(), assign_opportunities(), batch_update_expect_date(), batch_update_stage(), change_stage(), create_opportunity(), _decimal_value(), _enrich_user_names() (+68 more)

Community 5 - "Community 5"

Cohesion: 0.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 6 - "Community 6"

Cohesion: 0.28 Nodes (17): _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), _get_address(), get_transport_address(), list_all_transport_addresses(), list_transport_addresses() (+9 more)

Community 7 - "Community 7"

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

Cohesion: 0.13 Nodes (48): register_quote_routes(), create_from_quote(), _quote_products_to_contract_products(), Java: createFromQuote — 返回合同 id, accept_quote(), calculate_quote_amount(), create_new_version(), create_quote() (+40 more)

Community 11 - "Community 11"

Cohesion: 0.10 Nodes (55): cancel_apply(), create_apply(), create_disburse(), delete_applies(), delete_disburses(), get_apply(), get_disburse(), list_applies() (+47 more)

Community 12 - "Community 12"

Cohesion: 0.05 Nodes (67): contact_add(), contact_delete(), contact_update(), customer_create(), customer_delete(), customer_update(), customer_name_exists(), BaseModel (+59 more)

Community 13 - "Community 13"

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

Cohesion: 0.16 Nodes (32): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+24 more)

Community 15 - "Community 15"

Cohesion: 0.11 Nodes (13): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, 报销单勾选的发票附件(同一发票可勾选多个附件,各占一条)。, ReimburseInvoiceBriefOut, ReimburseInvoiceLinkIn, Any, Session (+5 more)

Community 16 - "Community 16"

Cohesion: 0.09 Nodes (60): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), get_apply(), get_record(), list_applies() (+52 more)

Community 18 - "Community 18"

Cohesion: 0.15 Nodes (30): advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _fill_offset_amounts(), get_advance() (+22 more)

Community 19 - "Community 19"

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

Community 21 - "Community 21"

Cohesion: 0.10 Nodes (54): _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() (+46 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.11 Nodes (8): convert_heic_to_jpeg(), OSSStorage, process_image_content(), QiniuStorage, 文件存储工具模块 支持多种存储方式: 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 将 HEIC/HEIF 格式转换为 JPEG 格式, 处理图片内容,如果是 HEIC 格式则转换为 JPEG, BytesIO

Community 24 - "Community 24"

Cohesion: 0.20 Nodes (18): create_vehicle(), list_vehicles(), update_vehicle(), _vehicle_to_detail(), _vehicle_to_read(), generate_uuid(), PlVehiclePersonnel, 车辆-人员关联表 pl_vehicle_personnel (+10 more)

Community 25 - "Community 25"

Cohesion: 0.08 Nodes (75): _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() (+67 more)

Community 26 - "Community 26"

Cohesion: 0.10 Nodes (45): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, register_contract_routes(), 接口菜单权限守卫。super_admin 直接放行。, require_menu_code(), batch_assign_owner(), batch_submit_contract_approval(), create_from_opportunity(), download_contract_pdf() (+37 more)

Community 27 - "Community 27"

Cohesion: 0.19 Nodes (28): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), _generate_plan_no(), get_plan() (+20 more)

Community 28 - "Community 28"

Cohesion: 0.10 Nodes (60): PlFreightSettlement, PlFreightSettlementApproval, PlFreightSettlementTransport, PlRemittanceVoucher, 运费结算表 pl_freight_settlement, 运费结算审批 pl_freight_settlement_approval, 结算单-运输关联表 pl_freight_settlement_transport, 汇款凭证表 pl_remittance_voucher (+52 more)

Community 29 - "Community 29"

Cohesion: 0.13 Nodes (28): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+20 more)

Community 30 - "Community 30"

Cohesion: 0.15 Nodes (16): menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult, _auto_fill_create_dept_id(), get_db() (+8 more)

Community 33 - "Community 33"

Cohesion: 0.20 Nodes (15): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+7 more)

Community 34 - "Community 34"

Cohesion: 0.06 Nodes (87): create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any, date, Session, _row_to_dict() (+79 more)

Community 35 - "Community 35"

Cohesion: 0.09 Nodes (62): 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() (+54 more)

Community 36 - "Community 36"

Cohesion: 0.08 Nodes (60): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), create_process_def(), _enrich_task_list(), get_business_all_tasks(), _get_business_form_fields(), get_designer_data() (+52 more)

Community 37 - "Community 37"

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

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

Cohesion: 0.14 Nodes (42): assign_clues(), check_convert(), check_duplicate_clue(), convert_clue(), create_clue(), _enrich_user_names(), _ensure_clue_in_scope(), create_clue_follow() (+34 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.10 Nodes (30): create_invoice(), delete_invoice(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request, Session (+22 more)

Community 44 - "Community 44"

Cohesion: 0.12 Nodes (15): Config, _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常:返回 JSON 并保留 CORS 头,避免浏览器只报跨域错误, 未捕获异常:统一 JSON 500,确保跨域场景下仍有 Access-Control-Allow-Origin (+7 more)

Community 45 - "Community 45"

Cohesion: 0.16 Nodes (19): ApiRequestLogMiddleware, _claims_from_auth(), _format_body_bytes(), _persist_log(), Any, Request, 统一记录 API 请求/响应出入参的中间件, _redact_obj() (+11 more)

Community 46 - "Community 46"

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

Cohesion: 0.17 Nodes (27): _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), _generate_batch_no(), _get_inventory(), _get_inventory_by_id() (+19 more)

Community 49 - "Community 49"

Cohesion: 0.11 Nodes (34): create_personnel(), list_personnel(), _personnel_to_detail(), _personnel_to_read(), PlCert, PlDocumentReminder, PlPersonnel, 证件到期提醒表 pl_document_reminder (+26 more)

Community 50 - "Community 50"

Cohesion: 0.11 Nodes (38): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), _generate_settlement_no(), get_settlement(), get_settlement_approval_flow() (+30 more)

Community 51 - "Community 51"

Cohesion: 0.08 Nodes (43): _build_public_page(), _format_file_size(), _format_plan_date(), get_public_transport(), _get_transport_by_token(), _parse_feedback_images(), Session, UploadFile (+35 more)

Community 52 - "Community 52"

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

Cohesion: 0.09 Nodes (41): 报销模块认证适配:门户 JWT 用户 → bx 业务上下文。, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销(bx)模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时,进度接口仅展示当前轮次。, 审批进度仅展示当前轮次;完整历史由 get_approval_history 返回。 (+33 more)

Community 54 - "Community 54"

Cohesion: 0.26 Nodes (23): _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound(), get_outbound_by_plan(), inbound_site_url(), list_inbound() (+15 more)

Community 58 - "Community 58"

Cohesion: 0.17 Nodes (20): operlog_detail(), operlog_list(), Session, 操作日志分页列表(基于 API 请求日志适配 RuoYi OperLog 结构), _user_info(), business_type_from_path(), title_from_path(), _apply_oper_log_scope() (+12 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.16 Nodes (31): bx_health(), 报销(bx)API 路由聚合 — REST 风格,协议对齐 bx 原系统。, P0 健康检查:验证 bx 路由已挂载且响应协议为 code=0。, approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse() (+23 more)

Community 61 - "Community 61"

Cohesion: 0.16 Nodes (33): DbInboundOutbound, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, _apply_plan_quantity_delta(), _create_db_inventory(), _create_db_plan(), DibangInventoryLinkResult, find_monthly_db_plan() (+25 more)

Community 62 - "Community 62"

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

Cohesion: 0.24 Nodes (9): _dispatch_local(), Any, 工作流回调服务 —— 流程状态变更时通知业务系统, 注册本地回调函数。当 callback_url 以 path 开头时直接调用 fn。, 尝试本地直调。返回 True 表示已处理,False 表示无匹配的本地回调。, 流程实例状态变更后,向业务系统发送回调通知。 优先级: 1. 如果 callback_url 是内部路径(以 / 开头),优先尝试本地直调, register_local_callback(), trigger_callback() (+1 more)

Community 64 - "Community 64"

Cohesion: 0.04 Nodes (147): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_import_template() (+139 more)

Community 65 - "Community 65"

Cohesion: 0.10 Nodes (58): cancel_apply(), create_apply(), create_process(), delete_applies(), delete_processes(), get_apply(), get_process(), list_applies() (+50 more)

Community 66 - "Community 66"

Cohesion: 0.15 Nodes (24): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+16 more)

Community 67 - "Community 67"

Cohesion: 0.29 Nodes (16): ensure_crm_customer_linked_row_in_scope(), ensure_crm_owner_row_in_scope(), Session, CRM 数据权限辅助(负责人 owner_user_id + 标准 create_by/create_dept_id)。, 客户子表(开票信息等):先校验关联客户 owner scope,否则校验 create_by。, _clear_default_for_customer(), create_invoice_info(), get_invoice_info() (+8 more)

Community 68 - "Community 68"

Cohesion: 0.27 Nodes (17): get_vehicle(), paste_recognize_commit(), PlVehicle, ConflictAction, PasteCommitBody, PasteCommitResult, PastePersonnelIn, PasteVehicleIn (+9 more)

Community 69 - "Community 69"

Cohesion: 0.15 Nodes (27): _append_user_scope_conditions(), apply_data_scope(), assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 (+19 more)

Community 70 - "Community 70"

Cohesion: 0.39 Nodes (10): create_post(), get_post(), list_posts(), post_code_exists(), Any, Session, _row_to_dict(), soft_delete_post() (+2 more)

Community 71 - "Community 71"

Cohesion: 0.11 Nodes (32): CRM 报价单 API 路由 — 挂接到 crm.router, QuoteApproverSettingSaveBody, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody, QuoteCreateBody (+24 more)

Community 72 - "Community 72"

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 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.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 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.15 Nodes (14): invoice_info_add(), invoice_info_by_customer(), _invoice_info_by_customer_impl(), invoice_info_delete(), invoice_info_list(), invoice_info_set_default(), invoice_info_update(), 按客户ID查询开票信息(与 by-customer 等价) (+6 more)

Community 81 - "Community 81"

Cohesion: 0.22 Nodes (14): format_datetime(), get_current_time(), parse_datetime(), datetime, datetime_end_of_day(), fmt_date(), fmt_datetime(), inventory_date_to_api() (+6 more)

Community 83 - "Community 83"

Cohesion: 0.17 Nodes (28): _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer(), _build_approval_list_filters(), create_approval_records() (+20 more)

Community 84 - "Community 84"

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

Community 86 - "Community 86"

Cohesion: 0.18 Nodes (27): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), _get_weighing(), get_weighing_related(), list_weighing() (+19 more)

Community 87 - "Community 87"

Cohesion: 0.20 Nodes (19): approve_quote(), can_user_approve(), create_approval_records(), delete_pending_approvals(), get_quote_approval(), list_quote_approvals(), Any, Session (+11 more)

Community 88 - "Any"

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 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 91 - "pl_vehicle_recharge_service.py"

Cohesion: 0.09 Nodes (64): _apply_contract_entity_fields(), can_user_approve(), Java: canUserApprove — 顺序审批,当前步骤 pending 且 is_current=1, _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _change_row_to_dict(), _contract_period_key() (+56 more)

Community 92 - "Community 92"

Cohesion: 0.16 Nodes (25): 验证密码(哈希非 bcrypt 或损坏时返回 False,避免抛错), verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+17 more)

Community 93 - "_invoice_info_by_customer_impl"

Cohesion: 0.24 Nodes (13): get_product(), soft_delete_product(), assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed(), Any, Session (+5 more)

Community 94 - "response.py"

Cohesion: 0.12 Nodes (15): pool_rule_add(), pool_rule_delete(), pool_rule_detail(), pool_rule_execute(), pool_rule_list(), pool_rule_update(), pool_rule_update_status(), PoolRuleAddBody (+7 more)

Community 95 - "Community 95"

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 97 - "_ensure_subpack_slip_no"

Cohesion: 0.09 Nodes (51): approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle() (+43 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 - ".to_tenant_user_dict"

Cohesion: 0.23 Nodes (12): CRM 模块 Excel 导出列定义(字段与字典类型对齐 Java *Vo @ExcelDictFormat)。, _build_workbook(), DictLabelResolver, export_rows_to_xlsx_response(), ExportColumn, Any, Excel 导出工具:集中处理字典 code → label(对齐 Java ExcelDictConvert / ExcelDictPreloadConver, CRM 列表导出统一入口:表头 + 行数据 + 字典 label 转换 + 文件流响应。 (+4 more)

Community 102 - "dept.py"

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 104 - "apply_crm_create_by_scope"

Cohesion: 0.24 Nodes (7): camel_to_snake(), CRUDBase, get_model_attr(), HistoryCRUD, Any, Session, ModelType

Community 105 - "list_customers"

Cohesion: 0.15 Nodes (22): extend_session(), get_client_ip(), get_current_user(), get_current_user_by_token(), get_current_user_simple(), is_refresh_token_valid(), is_session_valid(), Request (+14 more)

Community 106 - "Community 106"

Cohesion: 0.38 Nodes (11): apply_pl_scope(), Session, PL 模块数据权限辅助(create_by / create_dept_id,无 owner_field)。, build_menu_badge_counts(), count_document_reminder_expired_pending(), count_freight_approval_pending(), count_freight_disburse_pending(), _count_pending_applies() (+3 more)

Community 107 - "apply_pl_scope"

Cohesion: 0.03 Nodes (97): category_add(), category_delete(), category_tree(), category_update(), clue_assign(), clue_convert(), clue_create(), clue_delete() (+89 more)

Community 109 - "Community 109"

Cohesion: 0.20 Nodes (13): create_expense_item(), delete_expense_item(), get_expense_item(), get_expense_item_tree(), Session, update_expense_item(), BxExpenseItem, _coerce_id() (+5 more)

Community 110 - "Base"

Cohesion: 0.17 Nodes (18): get_user_menu_codes(), Session, 菜单 code 权限守卫(V0.3:通过 sys_user_role → sys_role_menu → sys_menu.perms), 读取用户授权的菜单权限标识集合(与前端 meta.menuCode / perms 对齐)。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes(), _map_role_name_to_web() (+10 more)

Community 111 - "Community 111"

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 112 - "storage.py"

Cohesion: 0.22 Nodes (17): _apply_list_filters(), create_supplier_info(), get_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+9 more)

Community 113 - "quote_share_log.py"

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 114 - "db_models.py"

Cohesion: 0.24 Nodes (12): DbSequence, 地磅(db)模块数据模型 — 对齐 docs/sql/db_tables.sql, _allocate_inbound_outbound_id(), _ensure_sequence_row(), max_numeric_inbound_outbound_id(), next_inbound_outbound_id(), Session, 出入库单 id 生成 — 租户内纯数字自增,并发安全。 (+4 more)

Community 115 - "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 116 - "Community 116"

Cohesion: 0.19 Nodes (25): calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product(), list_quote_products() (+17 more)

Community 118 - "Community 118"

Cohesion: 0.22 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 119 - "Community 119"

Cohesion: 0.17 Nodes (27): CertRow, VehiclePersonnelRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), match_required_cert_name(), _missing_field_labels() (+19 more)

Community 122 - "Community 122"

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

Cohesion: 0.05 Nodes (67): _build_page(), _get_by_token(), _make_handlers(), _models(), Session, 运输计划 · 入库/出库单现场免登录公共 API, 附件上传 bizType 与 MinIO 目录映射(对齐原 CRM oss 上传语义), 优先使用显式 folder;否则按 bizType 映射默认目录。 (+59 more)

Community 126 - "customer_pool.py"

Cohesion: 0.45 Nodes (11): _customer_base_query(), get_follow_statistics(), get_industry_statistics(), get_level_statistics(), get_overview_statistics(), get_owner_statistics(), get_source_statistics(), get_trend_statistics() (+3 more)

Community 127 - "Community 127"

Cohesion: 0.38 Nodes (14): _cargo_stats(), get_dashboard_stats(), get_inbound_by_cargo(), get_inbound_by_partner_cargo(), get_outbound_by_cargo(), get_outbound_by_partner_cargo(), _partner_cargo_stats(), Session (+6 more)

Community 128 - "plan.py"

Cohesion: 0.10 Nodes (63): create_from_contract(), create_plan(), create_plan_full(), _generate_plan_no(), 创建运输计划(完整表单:合同产品 + 可选预选车辆,不自动安排运输), 生成计划编号 POYYYYMMDD###(当日 3 位序号,每日重置), update_plan(), PlPlan (+55 more)

Community 129 - "BaseStorage"

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 130 - "datetime_parse.py"

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 131 - "LocalStorage"

Cohesion: 0.36 Nodes (7): list_ethnics(), Any, Session, 民族码表 CRUD(全局 sys_ethnic), _row_to_dict(), 民族码表 sys_ethnic(国标 GB/T 3304,全局), SysEthnic

Community 132 - "crm_supplier_hazard.py"

Cohesion: 0.29 Nodes (12): build_updates(), derive_source_url(), fetch_source_customers(), legacy_id_to_str(), load_oss_map(), load_runtime_settings(), load_settings_env(), main() (+4 more)

Community 134 - "Community 134"

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 135 - "post.py"

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

Cohesion: 0.22 Nodes (16): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD(sys_role / sys_role_menu / sys_role_data_scope_detail) (+8 more)

Community 137 - "statistics.py"

Cohesion: 0.09 Nodes (37): advance_issue_stats(), batch_offset(), export_advance_issues(), issue_advance(), list_advance_issues(), list_advance_offset_records(), list_pending_payments(), list_processed_payments() (+29 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 - "Community 139"

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 141 - "clue_statistics.py"

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 143 - "SysEthnic"

Cohesion: 0.33 Nodes (11): create_leave(), get_leave(), list_leaves(), Any, Session, _row_to_dict(), soft_delete_leave(), update_leave() (+3 more)

Community 144 - "SysApiRequestLog"

Cohesion: 0.51 Nodes (10): apply_site_feedback(), OrderItem, _header(), _item(), test_apply_site_feedback_does_not_reset_first_submitted_at(), test_apply_site_feedback_keeps_in_progress_when_requested(), test_apply_site_feedback_rejects_already_voided(), test_apply_site_feedback_rejects_invalid_status() (+2 more)

Community 145 - "minio_url.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 146 - "__init__.py"

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 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 150 - "ContractListQuery"

Cohesion: 0.08 Nodes (48): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), execute_change(), _get_change_row(), Java Controller TODO — 保持 pending,记录备注, soft_delete_contract_changes(), soft_delete_contract_templates(), submit_change_approval() (+40 more)

Community 152 - "Community 152"

Cohesion: 0.17 Nodes (10): get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,14 个一级菜单), 运营端角色守卫:admin / super_admin 可访问。, require_admin_or_super_admin(), Config, format_api_error_message(), PageResult, Exception (+2 more)

Community 154 - "web_login_rsa_public_key"

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

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 159 - "context.py"

Cohesion: 0.46 Nodes (7): CrmProductBrand, apply_updates(), collect_candidates(), main(), parse_name(), Path, write_csv()

Community 160 - "register_local_callback"

Cohesion: 0.21 Nodes (15): API 路由包 — 山峡化工生产一体化门户, create_leave(), delete_leave(), get_leave(), _leave_local_callback(), leave_workflow_callback(), list_leaves(), Session (+7 more)

Community 161 - "backfill_crm_contract_attachment_urls.py"

Cohesion: 0.33 Nodes (10): load_oss_map(), load_runtime_settings(), load_settings_env(), main(), Any, Engine, 返回 (新值, 是否发生了 id→url 替换)。, resolve_token() (+2 more)

Community 162 - "BaseStorage"

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

Community 163 - "login_crypto.py"

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 170 - "test_quote_approver_setting.py"

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 172 - "MinIOStorage"

Cohesion: 0.24 Nodes (5): MinIOStorage, Any, 从 MINIO_BASE_URL 解析公网 endpoint;未配置或与内网相同时复用 self.client。, MinIO 预签名下载 URL,携带原始文件名。, MinIO 预签名内联预览 URL(PDF 等 iframe 场景)。

Community 173 - ".to_tenant_user_dict"

Cohesion: 0.33 Nodes (8): _apply_inventory_product_update(), apply_product_snapshot_to_inventory(), apply_product_snapshot_to_plan(), ProductSnapshot, Session, 地磅模块 — CRM 产品解析与快照写入。, 校验 CRM 产品并返回名称/规格快照。新建单据 product_id 必填。, resolve_crm_product()

Community 174 - "datetime_parse.py"

Cohesion: 0.67 Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析:前端 date-picker 仅传 YYYY-MM-DD。

Community 179 - "_ensure_subpack_slip_no"

Cohesion: 0.07 Nodes (58): archive_plan(), cancel_plan(), cancel_plan_wait_notice(), count_plans_by_contract(), delete_plan(), _determine_plan_type(), _ensure_subpack_slip_no(), _format_subpack_slip_no() (+50 more)

Community 180 - "menu.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 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.21 Nodes (15): ApiCryptoMiddleware, _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key() (+7 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.
  • 18 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 Community 24 to plan.py, Community 0, datetime_parse.py, Community 4, Community 6, Community 134, Community 8, Community 136, post.py, Community 11, Community 7, Community 13, Community 14, SysEthnic, Community 15, Community 16, __init__.py, Community 19, Community 21, Community 25, web_login_rsa_public_key, Community 27, get_client_ip, Community 28, Community 29, context.py, Community 34, Community 38, Community 39, test_quote_approver_setting.py, Community 43, Community 49, _ensure_subpack_slip_no, menu.py, Community 53, Community 51, Community 61, Community 65, Community 66, Community 67, Community 68, Community 70, Community 74, Community 81, Community 83, Community 86, Community 87, pl_ocr_service.py, pl_vehicle_recharge_service.py, Community 92, Community 95, _ensure_subpack_slip_no, dept.py, storage.py, quote_share_log.py, db_models.py, site.py, Community 116, Community 118, Community 125? High betweenness centrality (0.152) - this node is a cross-community bridge.
  • Why does Settings connect price_letter_detail to backfill_crm_contract_attachment_urls.py, Community 35, crm_supplier_hazard.py, Community 5, Community 7, Community 72, Community 73, Community 42, Community 44, Community 52, Any, Community 59, Community 62? High betweenness centrality (0.111) - this node is a cross-community bridge.
  • Why does BaseModel connect Community 12 to plan.py, Community 3, Community 6, statistics.py, Community 11, Community 14, Community 15, Community 16, Community 18, ContractListQuery, Community 152, Community 25, Community 26, Community 27, Community 28, Community 30, register_local_callback, Community 33, Community 36, Community 43, Community 48, Community 49, SoftDeleteModel, Community 50, _ensure_subpack_slip_no, Community 54, Community 58, Community 60, Community 64, Community 65, Community 66, Community 68, Community 71, Community 78, Community 86, response.py, _ensure_subpack_slip_no, apply_pl_scope, Community 109, Community 111, Community 119, Community 125, Community 127? High betweenness centrality (0.109) - this node is a cross-community bridge.
  • Are the 8 inferred relationships involving DbUserContext (e.g. with InventoryRelatedData and AutoGenerateMonthlyResult) actually correct? DbUserContext has 8 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? 495 weakly-connected nodes found - possible documentation gaps or missing edges.
  • Should Community 0 be split into smaller, more focused modules? Cohesion score 0.14979757085020243 - nodes in this community are weakly interconnected.
  • Should Community 1 be split into smaller, more focused modules? Cohesion score 0.1471861471861472 - nodes in this community are weakly interconnected.