cykj/shanxia2.0
1
0 Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
bfa0d50597e403bd2fea95d7a7facb3c57cf077f
shanxia2.0/backend/graphify-out/GRAPH_REPORT.md
T
zlwuandCursor b5c49e3fc8 chore: update graphify after pl_plan create_date 
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-27 16:30:29 +08:00

45 KiB
Raw Blame History

Graph Report - backend (2026-07-27)

Corpus Check

  • 267 files · ~173,061 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 3988 nodes · 13804 edges · 517 communities (499 shown, 18 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: 5ebaec2e
  • 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 - 431 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() - 175 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_no_role_scopes_returns_empty_query() --calls--> apply_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py
  • test_scope4_invokes_filter_via_scope_collection() --calls--> apply_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py
  • test_scope4_with_owner_field_passes_owner_to_helper() --calls--> apply_data_scope() [EXTRACTED] tests/test_data_scope.py → app/core/data_scope.py

Import Cycles

  • None detected.

Communities (517 total, 18 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.10 Nodes (54): approve_carrier(), bind_vehicle_driver(), create_carrier(), create_driver(), create_personnel(), delete_driver(), delete_personnel(), delete_vehicle() (+46 more)

Community 3 - "Community 3"

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

Community 6 - "Community 6"

Cohesion: 0.12 Nodes (35): advance_pending_approval_stats(), advance_status_counts(), approve_advance(), approved_by_me(), create_advance(), delete_advance(), _fill_offset_amounts(), get_advance() (+27 more)

Community 7 - "Community 7"

Cohesion: 0.23 Nodes (28): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, MenuCreateBody (+20 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.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.09 Nodes (43): _build_page(), _get_by_token(), _make_handlers(), _models(), Session, 运输计划 · 入库/出库单现场免登录公共 API, _auto_fill_create_dept_id(), get_db() (+35 more)

Community 15 - "Community 15"

Cohesion: 0.13 Nodes (11): BxReimburseApply, BxReimburseApproval, BxReimburseDetail, ReimburseApplyOut, ReimburseInvoiceBriefOut, Any, Session, 是否可选择他人作为报销申请人（超管或具备按钮权限）。 (+3 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.19 Nodes (17): extend_session(), get_client_ip(), get_current_user_simple(), is_refresh_token_valid(), is_session_valid(), Request, 同步 Redis 调用；失败时返回 None 供调用方降级。, 刷新会话 TTL（已登录用户每次 API 校验通过后滑动续期） (+9 more)

Community 21 - "Community 21"

Cohesion: 0.10 Nodes (48): barcode_exists(), _build_category_tree(), category_code_exists(), _category_row_to_dict(), _collect_category_with_ancestors(), create_category(), create_oss(), create_product() (+40 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.08 Nodes (57): _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() (+49 more)

Community 26 - "Community 26"

Cohesion: 0.10 Nodes (55): register_contract_routes(), batch_assign_owner(), batch_submit_contract_approval(), _build_customer_address(), _contract_period_key(), contract_row_to_dict(), download_contract_pdf(), _ensure_contract_in_scope() (+47 more)

Community 27 - "Community 27"

Cohesion: 0.24 Nodes (7): menu_badge_stats(), Session, Session, recognize_cert(), RecognizeCertBody, RecognizeCertResult, PlMenuBadgeStatsRead

Community 28 - "Community 28"

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

Community 29 - "Community 29"

Cohesion: 0.27 Nodes (17): _build_public_page(), _build_site_product_read(), _format_file_size(), get_public_site(), _get_site_link_by_token(), _parse_feedback_images(), Session, UploadFile (+9 more)

Community 30 - "Community 30"

Cohesion: 0.12 Nodes (26): _avatar_url_field(), _build_user_info_payload(), change_current_user_password(), get_current_user_profile(), _jwt_user_payload(), logout(), public_quote_share(), Request (+18 more)

Community 33 - "Community 33"

Cohesion: 0.27 Nodes (6): BxExpenseItem, Any, Session, ExpenseItemService, Session, M

Community 34 - "Community 34"

Cohesion: 0.11 Nodes (49): customer_create(), customer_update(), follow_by_customer(), follow_detail(), assign_customer(), batch_claim_customers(), check_duplicate_customer(), claim_customer() (+41 more)

Community 35 - "Community 35"

Cohesion: 0.10 Nodes (71): CRM 报价单 API 路由 — 挂接到 crm.router, register_quote_routes(), accept_quote(), _build_quote_filters(), calculate_quote_amount(), create_new_version(), create_quote(), _decimal_value() (+63 more)

Community 36 - "Community 36"

Cohesion: 0.14 Nodes (34): check_document_expiry(), document_reminder_stats(), get_inventory_ledger(), get_summary(), list_document_reminders(), list_transactions(), list_warnings(), date (+26 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.16 Nodes (22): _build_public_page(), _format_file_size(), _format_plan_date(), get_public_transport(), _get_transport_by_token(), _parse_feedback_images(), Session, UploadFile (+14 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.11 Nodes (37): approve_settlement_legacy(), cancel_settlement(), create_settlement(), delete_settlement(), disburse_settlement(), _generate_settlement_no(), get_settlement(), get_settlement_approval_flow() (+29 more)

Community 43 - "Community 43"

Cohesion: 0.12 Nodes (26): create_invoice(), delete_invoice(), get_mine_wallet_summary(), list_invoice_ledgers(), list_invoice_wallets(), list_invoices(), Request, Session (+18 more)

Community 44 - "Community 44"

Cohesion: 0.31 Nodes (3): Any, Session, WorkflowEngine

Community 45 - "Community 45"

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

Cohesion: 0.22 Nodes (8): CustomerAssignPoolBody, CustomerCheckDuplicateBody, CustomerClaimBody, CustomerDealBody, CustomerDetailBody, CustomerIntoPoolBody, CustomerTransferBody, CRM 客户管理 Pydantic Schemas

Community 48 - "Community 48"

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

Community 49 - "Community 49"

Cohesion: 0.05 Nodes (110): clue_detail(), clue_export(), clue_follow_detail(), clue_follow_statistics(), clue_import(), clue_list(), clue_mine(), clue_to_follow() (+102 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 (33): _apply_plan_product_update(), _apply_plan_update(), AutoGenerateMonthlyResult, _base_query(), create_plan(), _generate_plan_no(), get_plan(), _get_plan_by_id_only() (+25 more)

Community 52 - "Community 52"

Cohesion: 0.06 Nodes (52): 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 非空时表示失败。 (+44 more)

Community 53 - "Community 53"

Cohesion: 0.09 Nodes (36): bind_biz(), delete_attachment(), download_file(), list_by_biz(), _parse_id_list(), preview_attachment(), Session, UploadFile (+28 more)

Community 54 - "Community 54"

Cohesion: 0.10 Nodes (34): contact_add(), contact_birthday(), contact_by_customer(), contact_decision(), contact_delete(), contact_detail(), contact_export(), contact_list() (+26 more)

Community 58 - "Community 58"

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

Community 59 - "Community 59"

Cohesion: 0.12 Nodes (51): PlPlanProduct, PlPlanTransport, 计划产品明细表 pl_plan_product, 计划-运输关联表 pl_plan_transport, PlanArchiveFreightBlock, PlanArchiveProductItem, PlanProductCreate, PlanTransportCreateBlock (+43 more)

Community 60 - "Community 60"

Cohesion: 0.09 Nodes (35): CRM 合同 API 路由 — GET/PUT/DELETE/POST 对齐原 Java CRM, ContractApprovalActionBody, ContractApprovalPassBody, ContractApprovalRejectBody, ContractApprovalTransferBody, ContractBatchAssignBody, ContractBatchSubmitBody, ContractChangeCreateBody (+27 more)

Community 61 - "Community 61"

Cohesion: 0.11 Nodes (48): _generate_notify_message(), _is_rearrange(), 仅计划已正式安排才算「调整运输」。 创建/编辑表单预选车辆会留下 draft 运输单，计划仍为 pending； 若把非 cancelled, PlPlan, PlTransport, PlTransportDbLink, 运输-地磅出入库关联 pl_transport_db_link, _apply_plan_quantity_delta() (+40 more)

Community 62 - "Community 62"

Cohesion: 0.19 Nodes (26): create_vehicle(), get_vehicle(), paste_recognize_commit(), update_vehicle(), _vehicle_to_detail(), generate_uuid(), PlVehicle, VehicleDetailRead (+18 more)

Community 63 - "Community 63"

Cohesion: 0.21 Nodes (13): format_datetime(), get_current_time(), parse_datetime(), datetime, datetime_end_of_day(), fmt_date(), fmt_datetime(), inventory_date_to_api() (+5 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.18 Nodes (18): create_workflow(), delete_workflow(), get_workflow(), get_workflow_by_biz_type(), list_workflows(), Session, save_workflow_nodes(), update_workflow() (+10 more)

Community 67 - "Community 67"

Cohesion: 0.17 Nodes (23): change_password(), create_user(), get_user(), get_user_with_relations(), _hash_password(), list_post_ids_for_user(), list_user_ids_bound_to_post(), list_users() (+15 more)

Community 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.16 Nodes (21): assert_row_in_data_scope(), _collect_scope_ids(), _get_child_dept_ids(), get_user_dept_id(), Session, 合并多角色数据范围为 dept_ids / user_ids 并集。, 判断单行数据是否在当前用户数据权限范围内。, 从 SysUser 读取用户的 dept_id。 (+13 more)

Community 70 - "Community 70"

Cohesion: 0.15 Nodes (33): 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() (+25 more)

Community 71 - "Community 71"

Cohesion: 0.09 Nodes (37): BaseModel, PagedQuery, PagedResponse, InvoiceAttachmentOut, InvoiceOut, LedgerOut, WalletSummaryOut, QuoteAcceptBody (+29 more)

Community 72 - "Community 72"

Cohesion: 0.14 Nodes (28): _apply_contract_entity_fields(), _build_contract_filters(), _calc_amount_with_tax(), create_contract(), create_from_opportunity(), create_from_quote(), _decimal_value(), generate_contract_name() (+20 more)

Community 73 - "Community 73"

Cohesion: 0.52 Nodes (3): ApiRequestLogCRUD, Session, SysApiRequestLog

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.15 Nodes (35): CRM 合同子模块路由 — 变更/模板/审批独立页, register_contract_sub_routes(), _change_row_to_dict(), create_contract_change(), create_contract_template(), _enrich_change_rows(), execute_change(), export_contract_changes() (+27 more)

Community 81 - "Community 81"

Cohesion: 0.50 Nodes (5): get_current_user(), get_current_user_by_token(), Session, 根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）, 获取当前用户（sync 依赖，配合 sync 路由在线程池执行，避免阻塞事件循环）。

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 (30): apply_data_scope(), 根据用户角色的数据权限过滤查询。 适用于业务单据列表/详情（报销单、客户、运单等）。 以下场景 SHALL NOT 调用本函数（仅租户隔离即, create_instance(), create_process_def(), create_task(), get_all_tasks_for_business(), get_instance(), get_latest_version() (+22 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.24 Nodes (16): allocate_reimburse_title_seq(), format_reimburse_title(), generate_apply_code(), generate_title(), is_auto_reimburse_title(), parse_reimburse_date(), preview_reimburse_title_seq(), date (+8 more)

Community 88 - "Community 88"

Cohesion: 0.12 Nodes (23): API 路由包 — 山峡化工生产一体化门户, create_leave(), delete_leave(), get_leave(), _leave_local_callback(), leave_workflow_callback(), list_leaves(), Session (+15 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.50 Nodes (3): Config, LeaveResponse, Pydantic schemas - 请假申请

Community 95 - "Community 95"

Cohesion: 0.22 Nodes (20): _get_default_invoice_info(), apply_crm_create_by_scope(), ensure_crm_contact_row_in_scope(), ensure_crm_customer_linked_row_in_scope(), ensure_crm_owner_row_in_scope(), Session, CRM 数据权限辅助（负责人 owner_user_id + 标准 create_by/create_dept_id）。, 联系人：create_by 在范围内，或关联客户在 owner 范围内。 (+12 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 106 - "Community 106"

Cohesion: 0.15 Nodes (21): list_vehicles(), _vehicle_to_read(), CertRead, VehicleListResponse, 运输计划 - 安排运输时车辆/人员/证件资源快照 Schema, SnapshotCertRead, SnapshotPersonnelRow, TransportResourceSnapshot (+13 more)

Community 107 - "Community 107"

Cohesion: 0.15 Nodes (20): get_web_auth_menu_codes(), 获取当前用户菜单权限标识（sys_menu.perms，经角色继承）。, get_user_menu_codes(), Session, 菜单 code 权限守卫（V0.3：通过 sys_user_role → sys_role_menu → sys_menu.perms）, 读取用户授权的菜单权限标识集合（与前端 meta.menuCode / perms 对齐）。, 接口菜单权限守卫。super_admin 直接放行。, require_menu_code() (+12 more)

Community 109 - "Community 109"

Cohesion: 0.12 Nodes (45): create_expense_item(), delete_expense_item(), get_expense_item(), get_expense_item_tree(), Session, update_expense_item(), bx_health(), 报销（bx）API 路由聚合 — REST 风格，协议对齐 bx 原系统。 (+37 more)

Community 110 - "Base"

Cohesion: 0.07 Nodes (44): list_ethnics(), Any, Session, 民族码表 CRUD（全局 sys_ethnic）, _row_to_dict(), BizAttachment, 数据模型（与 docs/sql/shanxia2.0.sql 全库导出基线对齐的核心系统表）, Web 管理端约定角色（由 sys_role.role_name 映射而来，非数据库枚举） (+36 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 115 - "Community 115"

Cohesion: 0.36 Nodes (8): operlog_detail(), operlog_list(), Session, 操作日志分页列表（基于 API 请求日志适配 RuoYi OperLog 结构）, _user_info(), OperLogDetailBody, OperLogListBody, 操作日志（兼容 RuoYi OperLog 视图）

Community 116 - "Community 116"

Cohesion: 0.22 Nodes (21): 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() (+13 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 (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.18 Nodes (24): delete_plan(), delete_carrier(), unbind_vehicle_driver(), _actor_ids(), _actor_names(), assert_row_deletable_by_creator(), assert_rows_deletable_by_creator(), can_delete_by_creator() (+16 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.18 Nodes (23): _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 (+15 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.13 Nodes (28): _apply_list_filters(), create_supplier_info(), get_supplier_info(), list_all_supplier_info(), list_supplier_info(), Any, Session, CRM 供方信息 CRUD — 对照 CrmSupplierInfoServiceImpl.java (+20 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.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.25 Nodes (14): 获取用户所有角色的数据权限配置。 返回: [{"data_scope": str, "details": [SysRoleDataScopeDetai, _resolve_user_role_scopes(), business_type_from_path(), title_from_path(), _apply_oper_log_scope(), get_oper_log(), list_oper_logs(), _oper_log_row_in_scope() (+6 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.24 Nodes (14): PlCert, list_owner_certs(), list_owner_certs_batch(), nearest_expire_date(), _normalize_cert_row(), date, Session, 扫描 pl_cert 生成到期提醒，返回新建条数。 (+6 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.21 Nodes (14): Config, Settings, create_tenant(), get_tenant(), list_tenants(), Any, Session, _row_to_dict() (+6 more)

Community 184 - "apply_pl_scope"

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 187 - "quote_share_log.py"

Cohesion: 0.18 Nodes (15): list_share_logs(), _parse_user_agent(), Any, Session, CRM 报价单分享访问日志 CRUD — 对照 CrmQuoteShareLogServiceImpl.java, 简易 User-Agent 解析（替代 Hutool UserAgentUtil）, Java: queryLogsByQuoteId, record_visit() (+7 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.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 238 - "export_rows_to_xlsx_response"

Cohesion: 0.21 Nodes (11): CRM 模块 Excel 导出列定义（字段与字典类型对齐 Java *Vo @ExcelDictFormat）。, _build_workbook(), DictLabelResolver, ExportColumn, load_dict_label_maps(), Any, Session, Excel 导出工具：集中处理字典 code → label（对齐 Java ExcelDictConvert / ExcelDictPreloadConver (+3 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 (82): clue_import_template(), customer_import_template(), invoice_info_add(), invoice_info_by_customer(), _invoice_info_by_customer_impl(), invoice_info_delete(), invoice_info_list(), invoice_info_set_default() (+74 more)

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 BaseModel connect Community 71 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 27, Community 156, Community 29, Community 34, Community 36, Community 38, Community 42, Community 46, Community 48, Community 49, Community 51, Community 53, Community 54, Community 58, Community 59, Community 60, Community 62, Community 65, Community 66, Community 70, Community 74, clue_statistics.py, Community 78, Community 86, Community 88, pl_vehicle_recharge_service.py, Community 92, Community 106, Community 109, Base, Community 115, Community 119, Community 127? High betweenness centrality (0.125) - this node is a cross-community bridge.
  • Why does generate_uuid() connect Community 62 to Community 2, Community 4, Community 5, Community 134, Community 135, Community 136, transport_address.py, Community 11, Community 14, Community 15, Community 16, Community 21, Community 152, Community 25, Community 26, Community 28, Community 30, Community 159, Community 33, 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, pl_cert_service.py, quote_share_log.py, Community 59, Community 61, Community 63, post.py, dict_data.py, site.py, Community 67, Community 66, Community 68, Community 64, Community 65, Community 72, Community 78, Community 83, Community 84, Community 86, pl_ocr_service.py, Community 95, allocate_next_biz_no, Community 106, Community 116, Community 118, 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, Community 3, BaseModel, Community 5, Community 6, transport_address.py, Community 11, Community 13, Community 15, Community 16, Community 18, Community 25, Community 26, Community 27, Community 33, Community 34, Community 35, Community 36, Community 42, Community 43, Community 48, Community 50, Community 51, Community 53, Community 54, Community 60, Community 62, Community 65, Community 66, Community 74, clue_statistics.py, Community 78, Community 86, Community 106, Community 109, Community 122, Community 127? High betweenness centrality (0.085) - 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? 453 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.
Reference in new issue View Git Blame Copy Permalink