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

47 KiB
Raw Blame History

Graph Report - backend (2026-07-28)

Corpus Check

  • 268 files · ~174,927 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 4004 nodes · 13872 edges · 520 communities (503 shown, 17 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: bcfadd23
  • 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 - 433 edges
  2. get_tenant_no() - 347 edges
  3. success_response() - 253 edges
  4. DbUserContext - 252 edges
  5. error_response() - 235 edges
  6. BxUserContext - 183 edges
  7. generate_uuid() - 177 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 (520 total, 17 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.12 Nodes (43): approve_carrier(), bind_vehicle_driver(), create_driver(), create_personnel(), delete_carrier(), delete_driver(), delete_personnel(), delete_vehicle() (+35 more)

Community 3 - "Community 3"

Cohesion: 0.10 Nodes (62): attachment_download_url(), attachment_preview_url(), create_dept(), create_dict_data(), create_dict_type(), create_menu(), create_post(), create_role_management() (+54 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 (109): archive_plan(), count_plans_by_contract(), create_from_contract(), create_plan(), create_plan_full(), delete_plan(), _determine_plan_type(), _generate_plan_no() (+101 more)

Community 6 - "Community 6"

Cohesion: 0.12 Nodes (39): advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _fill_offset_amounts(), get_advance() (+31 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.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.07 Nodes (43): AttachmentUploadResponse, ChangePasswordRequest, Config, LoginRequest, LoginResponse, Pydantic schemas - 用户认证, ResetPasswordRequest, UserCreate (+35 more)

Community 13 - "Community 13"

Cohesion: 0.10 Nodes (19): category_add(), category_tree(), product_add(), product_delete(), product_detail(), product_options(), product_update(), product_update_status() (+11 more)

Community 14 - "Community 14"

Cohesion: 0.07 Nodes (62): cancel_plan(), _generate_notify_message(), 作废运输计划:取消跟进状态、作废关联地磅出入库单、取消运输单。, _build_page(), _get_by_token(), _make_handlers(), _models(), Session (+54 more)

Community 15 - "Community 15"

Cohesion: 0.10 Nodes (38): approve_reimburse(), approved_by_me(), _build_details_data(), create_reimburse(), delete_reimburse(), get_approval_history(), get_approvals(), get_generated_title() (+30 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.11 Nodes (31): advance_issue_stats(), batch_offset(), export_advance_issues(), issue_advance(), list_advance_issues(), list_advance_offset_records(), list_pending_payments(), list_processed_payments() (+23 more)

Community 19 - "Community 19"

Cohesion: 0.08 Nodes (50): _avatar_url_field(), _build_user_info_payload(), _jwt_user_payload(), 公共接口(Web 登录、刷新 Token、登出;用户模型对齐 docs/sql/shanxia2.0.sql 基线), 与 web-admin 静态路由 meta.roles(admin/super_admin)对齐的单元素数组。, 与 web-admin userInfo 字段约定一致。, Web 端登录用 RSA 公钥(PKCS#1 v1.5,与 JSEncrypt 一致), Web 端登录:账号为 sys_user.user_no,密码为 sys_user.password(bcrypt)。 (+42 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.12 Nodes (5): BaseStorage, OSSStorage, QiniuStorage, 文件存储工具模块 支持多种存储方式: 1. 本地存储 (local) - 默认 2. 七牛云存储 (qiniu) - 推荐生产环境使用 3. 阿里云OSS (, 浏览器内联预览 URL;默认实现为普通访问地址。

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.10 Nodes (53): _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() (+45 more)

Community 26 - "Community 26"

Cohesion: 0.14 Nodes (32): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), create_from_opportunity(), download_contract_pdf(), finish_contract(), get_contract_detail(), get_contract_row() (+24 more)

Community 27 - "Community 27"

Cohesion: 0.15 Nodes (29): register_quote_routes(), create_from_quote(), _quote_products_to_contract_products(), Java: createFromQuote — 返回合同 id, accept_quote(), create_new_version(), _ensure_quote_in_scope(), generate_pdf() (+21 more)

Community 28 - "Community 28"

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

Community 29 - "Community 29"

Cohesion: 0.16 Nodes (24): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+16 more)

Community 30 - "Community 30"

Cohesion: 0.24 Nodes (11): change_current_user_password(), get_current_user_profile(), get_web_auth_menu_codes(), logout(), public_quote_share(), Request, Session, 登出:吊销 Redis 会话(若已配置 REDIS_HOST)。 (+3 more)

Community 33 - "Community 33"

Cohesion: 0.18 Nodes (17): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+9 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.12 Nodes (42): _build_quote_filters(), calculate_quote_amount(), create_quote(), _decimal_value(), _enrich_contact_fields(), _enrich_supplier_name(), _fill_contract_linked_count(), generate_quote_no() (+34 more)

Community 36 - "Community 36"

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

Community 37 - "Community 37"

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

Cohesion: 0.20 Nodes (19): _build_public_page(), _format_file_size(), _format_plan_date(), get_public_transport(), _get_transport_by_token(), _parse_feedback_images(), Session, UploadFile (+11 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.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.15 Nodes (14): _db_pool_keepalive_loop(), _error_json(), lifespan(), Exception, Request, 数据库异常:返回 JSON 并保留 CORS 头,避免浏览器只报跨域错误, 未捕获异常:统一 JSON 500,确保跨域场景下仍有 Access-Control-Allow-Origin, 定期 ping MySQL,避免远程库/NAT 回收空闲 TCP 后首请求长时间卡住。 (+6 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.08 Nodes (31): BaseModel, PagedQuery, PagedResponse, InvoiceAttachmentOut, InvoiceOut, LedgerOut, WalletSummaryOut, WorkflowNodeOut (+23 more)

Community 48 - "Community 48"

Cohesion: 0.20 Nodes (26): _apply_inventory_product_update(), _apply_inventory_update(), _base_query(), create_inventory(), create_link_for_plan(), delete_inventory(), _generate_batch_no(), _get_inventory() (+18 more)

Community 49 - "Community 49"

Cohesion: 0.06 Nodes (101): clue_check_convert(), clue_check_duplicate(), clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_list() (+93 more)

Community 50 - "Community 50"

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

Community 51 - "Community 51"

Cohesion: 0.15 Nodes (32): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), delete_plan(), _generate_plan_no(), get_plan() (+24 more)

Community 52 - "Community 52"

Cohesion: 0.18 Nodes (15): get_pool_record(), list_pool_records(), Any, Session, _row_to_dict(), total_pages(), CrmCustomerPool, check_customer_protect_time() (+7 more)

Community 53 - "Community 53"

Cohesion: 0.11 Nodes (35): 报销模块认证适配:门户 JWT 用户 → bx 业务上下文。, BxReimburseInvoice, BxReimburseOffset, BxWorkflowNode, 报销(bx)模块数据模型 — 对齐 docs/sql/20260606_bx_tables.sql, filter_current_cycle_approvals(), 审批轮次过滤 — 驳回后重新提交时,进度接口仅展示当前轮次。, 审批进度仅展示当前轮次;完整历史由 get_approval_history 返回。 (+27 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.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 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.11 Nodes (29): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, ContractApprovalActionBody, ContractBatchAssignBody, ContractBatchSubmitBody, ContractCreateBody, ContractDeleteBody, ContractExportBody, ContractInvalidBody (+21 more)

Community 61 - "Community 61"

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

Community 62 - "Community 62"

Cohesion: 0.29 Nodes (16): paste_recognize_commit(), PlVehicle, ConflictAction, PasteCommitBody, PasteCommitResult, PastePersonnelIn, PasteVehicleIn, 运输计划 - 三方粘贴识别提交 Schema (+8 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.07 Nodes (77): get_plan_related(), PlanRelatedData, menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult (+69 more)

Community 66 - "Community 66"

Cohesion: 0.14 Nodes (20): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+12 more)

Community 67 - "Community 67"

Cohesion: 0.13 Nodes (29): 验证密码(哈希非 bcrypt 或损坏时返回 False,避免抛错), verify_password(), change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user() (+21 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.12 Nodes (31): _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 (+23 more)

Community 70 - "Community 70"

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

Community 71 - "Community 71"

Cohesion: 0.12 Nodes (31): CRM 报价单 API 路由 — 挂接到 crm.router, QuoteAcceptBody, QuoteApprovalApproveBody, QuoteApprovalListBody, QuoteApprovalRefreshNamesBody, QuoteApprovalWithdrawBody, QuoteCreateBody, QuoteDeleteBody (+23 more)

Community 72 - "Community 72"

Cohesion: 0.10 Nodes (64): _apply_contract_entity_fields(), _build_contract_filters(), _build_customer_address(), _calc_amount_with_tax(), _change_row_to_dict(), _contract_period_key(), contract_row_to_dict(), create_contract() (+56 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.19 Nodes (28): _get_by_plan(), get_inbound(), get_inbound_by_plan(), _get_order(), get_outbound(), get_outbound_by_plan(), inbound_site_url(), list_inbound() (+20 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.09 Nodes (54): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _advance_contract_after_approval(), approve_contract(), approve_contract_by_contract_id(), approve_pass(), approve_reject(), approve_transfer() (+46 more)

Community 84 - "Community 84"

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

Community 86 - "Community 86"

Cohesion: 0.14 Nodes (36): _apply_weighing_product_update(), _apply_weighing_update(), _base_query(), create_weighing(), delete_weighing(), _get_weighing(), get_weighing_related(), list_weighing() (+28 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.32 Nodes (12): create_leave(), delete_leave(), get_leave(), _leave_local_callback(), leave_workflow_callback(), list_leaves(), Session, submit_leave() (+4 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 92 - "Community 92"

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 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.40 Nodes (6): _ensure_subpack_slip_no(), _format_subpack_slip_no(), _normalize_subpack_slip_no(), 将历史分装单号统一为 NO:SXFZYYYYMMDD-###, 分配分装单号 NO:SXFZYYYYMMDD-###(按租户每日递增), _subpack_slip_no_seq()

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.67 Nodes (3): 注册本地回调函数。当 callback_url 以 path 开头时直接调用 fn。, register_local_callback(), _LocalCallbackFn

Community 106 - "Community 106"

Cohesion: 0.21 Nodes (17): create_vehicle(), get_vehicle(), update_vehicle(), _vehicle_to_detail(), PlVehiclePersonnel, 车辆-人员关联表 pl_vehicle_personnel, VehicleDetailRead, VehiclePersonnelRow (+9 more)

Community 107 - "Community 107"

Cohesion: 0.11 Nodes (23): API 路由包 — 山峡化工生产一体化门户, get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,14 个一级菜单), get_user_menu_codes(), Session, 菜单 code 权限守卫(V0.3:通过 sys_user_role → sys_role_menu → sys_menu.perms), 运营端角色守卫:admin / super_admin 可访问。, 读取用户授权的菜单权限标识集合(与前端 meta.menuCode / perms 对齐)。 (+15 more)

Community 109 - "Community 109"

Cohesion: 0.16 Nodes (16): create_expense_item(), delete_expense_item(), get_expense_item(), get_expense_item_tree(), Session, update_expense_item(), _auto_fill_create_dept_id(), get_db() (+8 more)

Community 110 - "Base"

Cohesion: 0.09 Nodes (33): ApiRequestLogCRUD, Session, list_ethnics(), Any, Session, 民族码表 CRUD(全局 sys_ethnic), _row_to_dict(), BizAttachment (+25 more)

Community 111 - "Community 111"

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

Community 112 - "storage.py"

Cohesion: 0.25 Nodes (13): get_storage(), download_file_bytes(), file_stream(), get_access_url(), get_download_url(), get_preview_url(), normalize_storage_path(), 报销附件存储适配 — 复用门户 app.core.storage,对外保持 bx 协议。 (+5 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.18 Nodes (24): _parse_letter_oss_ids_from_tier(), batch_insert_contract_products(), calculate_subtotal(), _decimal_value(), delete_price_tiers_by_contract_id(), delete_products_by_contract_id(), _get_field(), insert_contract_product() (+16 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.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 125 - "Community 125"

Cohesion: 0.40 Nodes (9): create_leave(), get_leave(), list_leaves(), Any, Session, _row_to_dict(), soft_delete_leave(), update_leave() (+1 more)

Community 127 - "Community 127"

Cohesion: 0.25 Nodes (17): _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 (+9 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.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 - "transport_address.py"

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 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.18 Nodes (6): convert_heic_to_jpeg(), process_image_content(), 将 HEIC/HEIF 格式转换为 JPEG 格式, 处理图片内容,如果是 HEIC 格式则转换为 JPEG, 带下载文件名的访问 URL;默认实现为普通访问地址。, BytesIO

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 (17): apply_crm_create_by_scope(), _apply_list_filters(), create_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+9 more)

Community 156 - "Community 156"

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

Cohesion: 0.25 Nodes (17): create_price_letter(), get_price_letter(), list_price_letters(), _parse_date(), Any, date, Session, _row_to_dict() (+9 more)

Community 161 - "PlCarrier"

Cohesion: 0.14 Nodes (27): create_carrier(), get_carrier(), update_carrier(), PlCarrier, carrier_to_read(), CarrierBase, CarrierCreate, CarrierQualificationBase (+19 more)

Community 173 - "Community 173"

Cohesion: 0.19 Nodes (18): operlog_detail(), operlog_list(), Session, 操作日志分页列表(基于 API 请求日志适配 RuoYi OperLog 结构), _user_info(), business_type_from_path(), title_from_path(), get_oper_log() (+10 more)

Community 174 - "Community 174"

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 179 - "pl_cert_service.py"

Cohesion: 0.12 Nodes (29): PlCert, PlDocumentReminder, 证件到期提醒表 pl_document_reminder, CertRead, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot (+21 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 182 - "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 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 184 - "apply_pl_scope"

Cohesion: 0.49 Nodes (10): apply_pl_scope(), Session, build_menu_badge_counts(), count_document_reminder_expired_pending(), count_freight_approval_pending(), count_freight_disburse_pending(), _count_pending_applies(), count_plan_archive_pending() (+2 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 191 - "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 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 194 - "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 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.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 227 - "allocate_next_biz_no"

Cohesion: 0.15 Nodes (17): generate_uuid(), get_current_time(), parse_datetime(), datetime, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), datetime (+9 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 238 - "export_rows_to_xlsx_response"

Cohesion: 0.19 Nodes (14): CRM 模块 Excel 导出列定义(字段与字典类型对齐 Java *Vo @ExcelDictFormat)。, _build_workbook(), DictLabelResolver, export_rows_to_xlsx_response(), ExportColumn, load_dict_label_maps(), Any, Session (+6 more)

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 (72): category_delete(), category_update(), clue_import_template(), customer_create(), customer_import_template(), customer_update(), invoice_info_add(), invoice_info_by_customer() (+64 more)

Knowledge Gaps

  • 30 isolated node(s): Config, Config, Config, Config, Config (+25 more) These have ≤1 connection - possible missing edges or undocumented components.
  • 17 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 46 to Community 0, Community 1, Community 2, BaseModel, Community 5, Community 6, Community 7, transport_address.py, Community 11, Community 12, Community 13, Community 15, Community 16, Community 18, Community 25, Community 156, Community 29, Community 33, PlCarrier, Community 36, Community 38, Community 42, Community 45, Community 173, Community 48, Community 49, Community 51, pl_cert_service.py, Community 60, Community 62, Community 65, Community 66, Community 70, Community 71, Community 73, Community 74, clue_statistics.py, Community 83, Community 86, Community 87, Community 88, pl_vehicle_recharge_service.py, Community 93, response.py, Community 106, Community 109, Base, Community 119, Community 127? High betweenness centrality (0.122) - this node is a cross-community bridge.
  • Why does generate_uuid() connect allocate_next_biz_no to Community 2, Community 4, Community 5, Community 134, Community 135, Community 136, transport_address.py, pl_cert_service.py, Community 11, Community 14, Community 15, Community 16, Community 19, Community 21, Community 152, Community 25, Community 27, Community 28, Community 159, PlCarrier, Community 34, Community 35, Community 36, Community 39, Community 43, Community 174, Community 50, Community 51, Community 52, menu.py, Community 54, dict_type.py, tenant.py, Community 53, Community 58, Community 59, quote_share_log.py, Community 61, Community 62, post.py, Community 64, dict_data.py, site.py, Community 67, Community 66, Community 68, Community 65, Community 72, Community 78, Community 83, Community 84, Community 86, pl_ocr_service.py, Community 95, Community 106, Community 116, Community 118, Community 125? High betweenness centrality (0.098) - 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, transport_address.py, Community 11, Community 13, Community 14, Community 15, Community 16, Community 18, Community 25, Community 26, Community 27, Community 33, PlCarrier, Community 36, 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 83, Community 86, Community 87, Community 93, _ensure_subpack_slip_no, Community 106, Community 109, Community 127? High betweenness centrality (0.080) - 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? 454 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.