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

45 KiB
Raw Blame History

Graph Report - backend (2026-07-28)

Corpus Check

  • 272 files · ~176,387 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 4038 nodes · 13975 edges · 515 communities (499 shown, 16 thin omitted)
  • Extraction: 98% EXTRACTED · 2% INFERRED · 0% AMBIGUOUS · INFERRED: 318 edges (avg confidence: 0.53)
  • Token cost: 0 input · 0 output

Graph Freshness

  • Built from commit: dd31fb53
  • 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 - 434 edges
  2. get_tenant_no() - 347 edges
  3. success_response() - 253 edges
  4. DbUserContext - 252 edges
  5. error_response() - 235 edges
  6. generate_uuid() - 184 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)

  • test_resolve_create_date_defaults_today() --calls--> _resolve_create_date() [EXTRACTED] tests/test_pl_plan_create_date.py → app/api/pl/plan.py
  • test_resolve_create_date_uses_explicit() --calls--> _resolve_create_date() [EXTRACTED] tests/test_pl_plan_create_date.py → app/api/pl/plan.py
  • test_row_in_data_scope_denied() --calls--> row_in_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py
  • test_row_in_data_scope_self_by_create_by() --calls--> row_in_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py
  • test_row_in_data_scope_self_by_owner_field() --calls--> row_in_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py

Import Cycles

  • None detected.

Communities (515 total, 16 thin omitted)

Community 0 - "Community 0"

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

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

Cohesion: 0.08 Nodes (79): approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), create_personnel(), create_vehicle(), delete_carrier(), delete_driver() (+71 more)

Community 3 - "Community 3"

Cohesion: 0.10 Nodes (64): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_post(), create_role_management() (+56 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.07 Nodes (71): archive_plan(), _build_driver_url(), cancel_plan(), count_plans_by_contract(), create_from_contract(), create_plan(), create_plan_full(), delete_plan() (+63 more)

Community 6 - "Community 6"

Cohesion: 0.11 Nodes (53): advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _fill_offset_amounts(), get_advance() (+45 more)

Community 7 - "Community 7"

Cohesion: 0.27 Nodes (26): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, MenuCreateBody (+18 more)

Community 8 - "Community 8"

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

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.08 Nodes (40): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+32 more)

Community 13 - "Community 13"

Cohesion: 0.08 Nodes (23): category_add(), category_delete(), category_tree(), category_update(), product_add(), product_delete(), product_detail(), product_options() (+15 more)

Community 14 - "Community 14"

Cohesion: 0.12 Nodes (54): _generate_notify_message(), update_plan(), PlPlan, PlPlanProduct, 计划产品明细表 pl_plan_product, PlanArchiveFreightBlock, PlanArchiveProductItem, PlanProductCreate (+46 more)

Community 15 - "Community 15"

Cohesion: 0.10 Nodes (40): approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), get_approval_history(), get_approvals(), get_generated_title() (+32 more)

Community 16 - "Community 16"

Cohesion: 0.07 Nodes (79): cancel_apply(), create_apply(), create_record(), delete_applies(), delete_records(), get_apply(), get_record(), list_applies() (+71 more)

Community 18 - "Community 18"

Cohesion: 0.15 Nodes (9): _coerce_id(), OffsetItem, PaymentFinanceStatsOut, ReimburseApplyCreate, ReimburseApprovalOut, ReimburseApproverPendingStatsOut, ReimburseDetailCreate, ReimburseDetailOut (+1 more)

Community 19 - "Community 19"

Cohesion: 0.09 Nodes (46): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), _jwt_user_payload(), logout(), public_quote_share(), Request (+38 more)

Community 21 - "Community 21"

Cohesion: 0.09 Nodes (56): _alias_row_to_dict(), _assert_brand_deletable(), barcode_exists(), _brand_row_to_dict(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors() (+48 more)

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.67 Nodes (3): parse_optional_plan_datetime(), datetime, 运输计划相关日期时间解析:前端 date-picker 仅传 YYYY-MM-DD。

Community 25 - "Community 25"

Cohesion: 0.08 Nodes (59): _apply_plan_logistics_from_payload(), _apply_transport_arrange_fields(), arrange_transport(), _assert_vehicle_carrier_eligible(), _build_arrange_result(), _build_driver_url(), create_transport(), _ensure_driver_access_token() (+51 more)

Community 26 - "Community 26"

Cohesion: 0.14 Nodes (39): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), download_contract_pdf(), _enrich_change_rows(), _ensure_contract_in_scope(), finish_contract(), generate_template_no() (+31 more)

Community 27 - "Community 27"

Cohesion: 0.27 Nodes (18): register_quote_routes(), accept_quote(), _ensure_quote_in_scope(), generate_pdf(), generate_share(), get_quote(), get_quote_detail(), _get_quote_in_scope() (+10 more)

Community 28 - "Community 28"

Cohesion: 0.06 Nodes (98): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+90 more)

Community 29 - "Community 29"

Cohesion: 0.07 Nodes (54): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+46 more)

Community 30 - "Community 30"

Cohesion: 0.10 Nodes (42): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), execute_change(), export_contract_changes(), export_contract_templates(), _get_change_row() (+34 more)

Community 33 - "Community 33"

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

Community 34 - "Community 34"

Cohesion: 0.20 Nodes (30): assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer(), create_customer(), deal_customer(), _enrich_user_names(), _ensure_customer_in_scope() (+22 more)

Community 35 - "Community 35"

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

Community 36 - "Community 36"

Cohesion: 0.11 Nodes (19): 数据模型(与 docs/sql/shanxia2.0.sql 全库导出基线对齐的核心系统表), Web 管理端约定角色(由 sys_role.role_name 映射而来,非数据库枚举), 流程实例 wf_process_instance, 用户-角色关联 sys_user_role(V0.3), SysUserRole, UserRole, WfProcessInstance, Web 管理端登录:基于 V0.3 sys_user / sys_user_role / sys_role 的角色与菜单权限解析 (+11 more)

Community 37 - "Community 37"

Cohesion: 0.11 Nodes (22): get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,14 个一级菜单), menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, _auto_fill_create_dept_id() (+14 more)

Community 38 - "Community 38"

Cohesion: 0.16 Nodes (24): generate_uuid(), persist_plan_product_brand_qtys(), Any, Decimal, Session, 软删旧品牌量行后按归档结果插入;无品牌约定则只软删不插入。, validate_brand_qty_rows(), apply_archive_inventory_for_plan() (+16 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 42 - "Community 42"

Cohesion: 0.15 Nodes (31): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), _generate_settlement_no(), get_settlement(), get_settlement_approval_flow() (+23 more)

Community 43 - "Community 43"

Cohesion: 0.11 Nodes (27): create_invoice(), delete_invoice(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request, Session (+19 more)

Community 44 - "Community 44"

Cohesion: 0.13 Nodes (17): ApiCryptoMiddleware, ApiRequestLogMiddleware, _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常:返回 JSON 并保留 CORS 头,避免浏览器只报跨域错误 (+9 more)

Community 45 - "Community 45"

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

Cohesion: 0.25 Nodes (7): CustomerFollowByCustomerBody, CustomerFollowCreateBody, CustomerFollowDeleteBody, CustomerFollowDetailBody, CustomerFollowListBody, CustomerFollowUpdateBody, CRM 客户跟进记录 Pydantic Schemas

Community 48 - "Community 48"

Cohesion: 0.15 Nodes (32): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), _generate_batch_no(), _get_inventory() (+24 more)

Community 49 - "Community 49"

Cohesion: 0.08 Nodes (86): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_list() (+78 more)

Community 50 - "Community 50"

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

Community 51 - "Community 51"

Cohesion: 0.14 Nodes (29): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), _generate_plan_no(), get_plan() (+21 more)

Community 52 - "Community 52"

Cohesion: 0.14 Nodes (20): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), create_oss(), get_oss_by_url() (+12 more)

Community 53 - "Community 53"

Cohesion: 0.13 Nodes (28): filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时,进度接口仅展示当前轮次。, 审批进度仅展示当前轮次;完整历史由 get_approval_history 返回。, allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title() (+20 more)

Community 54 - "Community 54"

Cohesion: 0.29 Nodes (16): create_contact(), get_contact(), list_contacts_by_customer(), _parse_optional_date(), Any, date, Session, _row_to_dict() (+8 more)

Community 58 - "Community 58"

Cohesion: 0.17 Nodes (23): calculate_quote_amount(), create_new_version(), create_quote(), _enrich_contact_fields(), _enrich_supplier_name(), generate_quote_no(), generate_quote_title(), _get_field() (+15 more)

Community 59 - "Community 59"

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

Cohesion: 0.09 Nodes (23): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, ContractApprovalActionBody, ContractBatchAssignBody, ContractBatchSubmitBody, ContractCreateBody, ContractExportBody, ContractInvalidBody, ContractListQuery (+15 more)

Community 61 - "Community 61"

Cohesion: 0.11 Nodes (47): DbInboundOutbound, DbPurchasePlan, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, parse_date_str(), _apply_plan_quantity_delta(), _create_db_inventory(), _create_db_plan() (+39 more)

Community 62 - "Community 62"

Cohesion: 0.11 Nodes (36): paste_recognize_commit(), PlVehiclePersonnel, 车辆-人员关联表 pl_vehicle_personnel, VehiclePersonnelRow, ConflictAction, PasteCommitBody, PasteCommitResult, PastePersonnelIn (+28 more)

Community 63 - "Community 63"

Cohesion: 0.28 Nodes (11): assert_products_allowed_for_supplier(), enrich_products_with_hazard_flags(), get_supplier_hazard_flags(), product_allowed(), Any, Session, 批量回填明细行 isToxic/isExplosive(来自产品主数据,供前端切换主体剔除)。, test_dual_requires_both() (+3 more)

Community 64 - "Community 64"

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 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.16 Nodes (19): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+11 more)

Community 67 - "Community 67"

Cohesion: 0.14 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 68 - "Community 68"

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

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

Community 70 - "Community 70"

Cohesion: 0.14 Nodes (32): approve_task(), _assert_wf_instance_in_scope(), _business_type_label(), create_process_def(), delete_process_def(), _enrich_task_list(), get_business_all_tasks(), _get_business_form_fields() (+24 more)

Community 71 - "Community 71"

Cohesion: 0.08 Nodes (49): CRM 报价单 API 路由 — 挂接到 crm.router, RecognizeCertResult, BaseModel, CustomerAssignPoolBody, CustomerCheckDuplicateBody, CustomerClaimBody, CustomerDealBody, CustomerDetailBody (+41 more)

Community 72 - "Community 72"

Cohesion: 0.15 Nodes (28): _apply_contract_entity_fields(), _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _contract_period_key(), contract_row_to_dict(), create_contract_template(), _decimal_value() (+20 more)

Community 73 - "Community 73"

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

Cohesion: 0.07 Nodes (62): _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound(), get_outbound_by_plan(), inbound_site_url(), list_inbound() (+54 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.31 Nodes (15): ensure_crm_create_by_row_in_scope(), create_pool_rule(), delete_pool_rules(), execute_pool_rules(), _execute_single_rule(), get_pool_rule(), list_pool_rules(), Any (+7 more)

Community 81 - "Community 81"

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

Community 83 - "Community 83"

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

Community 84 - "Community 84"

Cohesion: 0.16 Nodes (31): create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_nodes_by_version(), get_pending_tasks_by_node(), get_process_def() (+23 more)

Community 86 - "Community 86"

Cohesion: 0.19 Nodes (26): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), _get_weighing(), get_weighing_related(), list_weighing() (+18 more)

Community 87 - "Community 87"

Cohesion: 0.18 Nodes (10): contact_add(), contact_delete(), contact_update(), ContactByCustomerBody, ContactCreateBody, ContactDeleteBody, ContactDetailBody, ContactSetPrimaryBody (+2 more)

Community 88 - "Community 88"

Cohesion: 0.18 Nodes (18): create_leave(), delete_leave(), get_leave(), _leave_local_callback(), leave_workflow_callback(), list_leaves(), Session, submit_leave() (+10 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.16 Nodes (21): create_contract(), create_from_opportunity(), create_from_quote(), generate_contract_name(), generate_contract_no(), _get_field(), _get_supplier_short_name(), _normalize_framework_contract_data() (+13 more)

Community 92 - "Community 92"

Cohesion: 0.18 Nodes (12): Config, Settings, decrypt_login_payload(), ensure_initialized(), extract_login_credentials(), get_public_pem(), Any, 登录凭据 RSA 解密(与前端 JSEncrypt PKCS#1 v1.5 兼容)。 (+4 more)

Community 93 - "Community 93"

Cohesion: 0.48 Nodes (7): _opp_list_kwargs(), opportunity_export(), opportunity_kanban(), opportunity_list(), opportunity_mine_list(), OpportunityKanbanBody, OpportunityListBody

Community 94 - "response.py"

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

Community 95 - "Community 95"

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

Cohesion: 0.15 Nodes (14): bx_health(), 报销(bx)API 路由聚合 — REST 风格,协议对齐 bx 原系统。, P0 健康检查:验证 bx 路由已挂载且响应协议为 code=0。, _date_to_str(), _dt_to_str(), PagedQuery, PagedResponse, date (+6 more)

Community 100 - "Community 100"

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

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

Community 102 - "register_local_callback"

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

Cohesion: 0.28 Nodes (15): create_clue_follow(), delete_clue_follow(), get_clue_follow(), get_follow_statistics(), list_clue_follows(), Any, Session, 更新线索跟进记录,必要时同步线索 next_time (+7 more)

Community 105 - "_invoice_info_by_customer_impl"

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

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

Community 107 - "Community 107"

Cohesion: 0.17 Nodes (16): get_web_auth_menu_codes(), 获取当前用户菜单权限标识(sys_menu.perms,经角色继承)。, get_user_menu_codes(), Session, 读取用户授权的菜单权限标识集合(与前端 meta.menuCode / perms 对齐)。, _expand_with_ancestor_menu_ids(), _granted_menu_ids_for_user(), iter_user_menu_perm_codes() (+8 more)

Community 109 - "Community 109"

Cohesion: 0.14 Nodes (18): create_expense_item(), delete_expense_item(), get_expense_item(), get_expense_item_tree(), Session, update_expense_item(), get_bx_current_user(), BxExpenseItem (+10 more)

Community 110 - "Base"

Cohesion: 0.08 Nodes (39): ApiRequestLogCRUD, Session, SoftDeleteModel, BizAttachment, 用户-职位关联 sys_user_post, SysApiRequestLog, SysApiRequestLogHis, SysUserPost (+31 more)

Community 111 - "Community 111"

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

Community 112 - "storage.py"

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 113 - "migrate_20260727_split_brand_from_product_name.py"

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

Community 116 - "Community 116"

Cohesion: 0.19 Nodes (26): batch_insert_quote_products(), calculate_subtotal(), _decimal_value(), delete_products_by_quote_id(), _ensure_quote_parent_scope(), _get_field(), get_quote_product(), insert_quote_product() (+18 more)

Community 118 - "Community 118"

Cohesion: 0.22 Nodes (22): 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() (+14 more)

Community 119 - "Community 119"

Cohesion: 0.17 Nodes (26): CertRow, _cert_row_complete(), collect_required_cert_errors(), _find_cert_for_required(), get_required_personnel_cert_names(), match_required_cert_name(), _missing_field_labels(), Session (+18 more)

Community 122 - "Community 122"

Cohesion: 0.05 Nodes (79): _address_to_read(), _build_address_query(), create_transport_address(), delete_transport_address(), _get_address(), get_transport_address(), list_all_transport_addresses(), list_transport_addresses() (+71 more)

Community 125 - "Community 125"

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

Community 127 - "Community 127"

Cohesion: 0.24 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 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 - "Community 135"

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

Cohesion: 0.19 Nodes (18): create_role(), get_role(), get_role_data_scope(), get_role_menu_ids(), list_roles(), Any, Session, 角色 CRUD(sys_role / sys_role_menu / sys_role_data_scope_detail) (+10 more)

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

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

Community 147 - "Community 147"

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

Community 152 - "Community 152"

Cohesion: 0.21 Nodes (16): _apply_list_filters(), create_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java, Java: queryList(不分页,报价单下拉) (+8 more)

Community 156 - "Community 156"

Cohesion: 0.29 Nodes (13): _assert_editable(), _build_public_page(), _format_file_size(), _get_inventory_by_token(), get_public_inventory(), _parse_feedback_images(), Session, UploadFile (+5 more)

Community 159 - "Community 159"

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 161 - "PlCarrier"

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

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 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 183 - "tenant.py"

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 187 - "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 193 - "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 204 - "MinIOStorage"

Cohesion: 0.32 Nodes (3): MinIOStorage, MinIO 预签名下载 URL,携带原始文件名。, MinIO 预签名内联预览 URL(PDF 等 iframe 场景)。

Community 205 - "clue_statistics.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 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.15 Nodes (21): _claims_from_auth(), _coerce_post_method_override_to_get(), _get_redis_client(), _is_crypto_api(), _json_error_response(), _mark_nonce_once(), _nonce_key(), Redis (+13 more)

Community 227 - "allocate_next_biz_no"

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 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()

Community 260 - "BaseModel"

Cohesion: 0.05 Nodes (69): clue_import_template(), customer_create(), customer_import_template(), customer_update(), opportunity_add(), opportunity_assign(), opportunity_batch_update_expect_date(), opportunity_batch_update_stage() (+61 more)

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 BaseModel connect Community 71 to Community 0, Community 1, Community 2, BaseModel, Community 5, Community 6, Community 7, Community 11, Community 12, Community 13, Community 14, Community 15, Community 16, Community 18, Community 25, Community 156, Community 29, Community 30, Community 28, Community 33, Community 37, Community 42, Community 45, Community 46, Community 173, Community 48, Community 49, Community 51, Community 60, Community 62, Community 65, Community 66, Community 70, Community 73, Community 74, clue_statistics.py, Community 86, Community 87, Community 88, Community 93, response.py, _ensure_subpack_slip_no, _invoice_info_by_customer_impl, Community 109, Base, Community 119, Community 122, Community 127? High betweenness centrality (0.120) - this node is a cross-community bridge.
  • Why does generate_uuid() connect Community 38 to Community 2, Community 4, Community 5, Community 134, Community 135, Community 136, Community 11, Community 14, Community 15, Community 16, Community 19, Community 21, Community 152, Community 25, Community 26, Community 28, Community 30, Community 159, Community 33, Community 34, Community 35, Community 39, Community 43, Community 50, Community 51, Community 52, menu.py, Community 54, tenant.py, Community 53, Community 58, Community 59, quote_share_log.py, Community 61, Community 62, Community 64, dict_data.py, Community 66, Community 67, Community 68, Community 65, Community 72, Community 74, Community 78, Community 83, Community 84, Community 86, pl_ocr_service.py, pl_vehicle_recharge_service.py, Community 95, allocate_next_biz_no, register_local_callback, apply_crm_create_by_scope, Community 109, migrate_20260727_split_brand_from_product_name.py, Community 116, Community 118, Community 122, Community 125? High betweenness centrality (0.093) - this node is a cross-community bridge.
  • Why does get_tenant_no() connect Community 49 to Community 0, Community 1, Community 2, BaseModel, Community 5, Community 6, Community 13, Community 14, Community 15, Community 16, Community 25, Community 26, Community 27, Community 28, Community 30, Community 33, Community 37, Community 42, Community 43, Community 45, Community 48, Community 50, Community 51, Community 53, Community 60, Community 62, Community 65, Community 66, Community 71, Community 73, Community 74, clue_statistics.py, Community 86, Community 87, Community 93, _invoice_info_by_customer_impl, Community 109, Community 122, Community 127? High betweenness centrality (0.084) - 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? 458 weakly-connected nodes found - possible documentation gaps or missing edges.
  • Should Community 0 be split into smaller, more focused modules? Cohesion score 0.08 - nodes in this community are weakly interconnected.
  • Should Community 1 be split into smaller, more focused modules? Cohesion score 0.11764705882352941 - nodes in this community are weakly interconnected.