Files
shanxia2.0/backend/graphify-out/GRAPH_REPORT.md
T
2026-05-20 09:28:36 +08:00

21 KiB
Raw Blame History

Graph Report - app (2026-05-20)

Corpus Check

  • 134 files · ~111,253 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 2296 nodes · 8837 edges · 52 communities detected
  • Extraction: 42% EXTRACTED · 58% INFERRED · 0% AMBIGUOUS · INFERRED: 5082 edges (avg confidence: 0.63)
  • Token cost: 0 input · 0 output

Community Hubs (Navigation)

God Nodes (most connected - your core abstractions)

  1. success_response() - 367 edges
  2. error_response() - 293 edges
  3. SysUser - 202 edges
  4. BizQcTaskResult - 193 edges
  5. BizQcMaterialUsage - 190 edges
  6. BizMaterialStockLog - 189 edges
  7. BizQcMaterial - 189 edges
  8. BizMaterial - 188 edges
  9. BizQcItemParam - 188 edges
  10. generate_uuid() - 123 edges

Surprising Connections (you probably didn't know these)

  • 统一记录 API 请求/响应出入参的中间件 --uses--> SysApiRequestLog [INFERRED] core/api_request_log_middleware.py → models/models.py
  • get_menu_list() --calls--> success_response() [INFERRED] api/menu.py → core/response.py
  • 公共接口(Web 登录、刷新 Token、登出;用户模型对齐 docs/sql/zkxw.sql 基线) --uses--> SysUser [INFERRED] api/public.py → models/models.py
  • 与 web-admin userInfo 字段约定一致。 --uses--> SysUser [INFERRED] api/public.py → models/models.py
  • Web 端登录用 RSA 公钥(PKCS#1 v1.5,与 JSEncrypt 一致) --uses--> SysUser [INFERRED] api/public.py → models/models.py

Communities

Community 0 - "API Schemas & Bodies"

Cohesion: 0.01 Nodes (381): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, ExpressCompanyCreateBody (+373 more)

Community 1 - "API Route Handlers"

Cohesion: 0.02 Nodes (379): attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu(), create_post() (+371 more)

Community 2 - "Collection Protocol"

Cohesion: 0.05 Nodes (260): AuditCreateBody, BatchDetailIdsBody, BatchRefundFinanceSubmitBody, FinanceConfirmBody, FullmoonTodoInsuranceBody, ProtocolCreateBody, ProtocolUpdateBody, 细胞存储 — 采集协议单 / 审核 / 财务确认 / 分期预警 API (+252 more)

Community 3 - "CRUD Operations"

Cohesion: 0.02 Nodes (165): generate_uuid(), create_consumable_pack(), get_consumable_pack(), get_pack_detail(), _item_row_to_dict(), list_all_packs(), list_consumable_packs(), pack_code_exists() (+157 more)

Community 4 - "Services & Mixed CRUD"

Cohesion: 0.03 Nodes (107): _persist_protocol_sub_resources(), delete(), get_multi_with_filters(), create_cell_product(), delete_cell_product(), get_cell_product(), list_cell_products(), 细胞产品 CRUD(biz_cell_product) (+99 more)

Community 5 - "Protocol & Work Order CRUD"

Cohesion: 0.05 Nodes (89): _format_attachment_file_size(), get_protocol_nos_used_in_protocols(), urls_to_attachment_list(), complete_production_work_order(), create_production_work_order_from_reception(), _fmt_dt(), _generate_work_order_no(), get_production_work_order() (+81 more)

Community 6 - "Auth & Public API"

Cohesion: 0.04 Nodes (64): _avatar_url_field(), _build_user_info_payload(), get_web_auth_menu_codes(), _jwt_user_payload(), logout(), 公共接口(Web 登录、刷新 Token、登出;用户模型对齐 docs/sql/zkxw.sql 基线), 登出:吊销 Redis 会话(若已配置 REDIS_HOST)。, 获取当前用户菜单权限标识(sys_menu.perms,经角色继承)。 (+56 more)

Community 7 - "Research Donation"

Cohesion: 0.07 Nodes (66): _parse_datetime_fields(), AuditSubmitBody, batch_delete_research_donations(), BatchDeleteBody, change_donation_status(), convert_from_storage(), convert_to_storage(), ConvertFromStorageBody (+58 more)

Community 8 - "Core Exceptions & Logging"

Cohesion: 0.05 Nodes (26): BusinessException, InvalidStatusTransitionException, log_delivery_operation(), log_operation(), log_order_operation(), log_settlement_operation(), log_user_operation(), OrderLockedException (+18 more)

Community 9 - "Workflow Engine"

Cohesion: 0.06 Nodes (55): get_designer_data(), ProcessDefCreateBody, ProcessDefUpdateBody, PublishVersionBody, 审批意见:前端传 commentText,兼容 comment。, StartInstanceBody, TaskActionBody, list_results_by_task() (+47 more)

Community 10 - "Operations Management"

Cohesion: 0.07 Nodes (62): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, 运营支撑 API(洁净室、进出记录、仓储设施、储位、展厅预约), StorageFacilityCreateBody (+54 more)

Community 11 - "Production Management"

Cohesion: 0.43 Nodes (45): ConsumableCreateBody, ConsumablePackCreateBody, ConsumablePackUpdateBody, ConsumableUpdateBody, OutputTypeCreateBody, OutputTypeUpdateBody, PackItemInput, ProcessCategoryCreateBody (+37 more)

Community 12 - "Core Middleware & Crypto"

Cohesion: 0.08 Nodes (35): BaseHTTPMiddleware, parse_admin_request_json(), 运营 Web(/web/admin)JSON 请求体解析。 与 ApiCryptoMiddleware 配合:中间件未改写 body 时,在路由内解密 `, 读取 JSON body;dict 时走 resolve_request_payload(明文 / 密文 / data 包装)。 Returns:, ApiCryptoError, _b64url_decode(), _b64url_encode(), decrypt_json() (+27 more)

Community 13 - "WeChat Pay Integration"

Cohesion: 0.12 Nodes (11): get_wechat_pay_client(), get_wechat_pay_v2(), 微信支付工具模块 支持微信支付 V3 API 文档参考: https://pay.weixin.qq.com/docs/v3/apis/index.ht, 统一下单接口 (V3) Args: out_trade_no: 商户订单号 total, 申请退款 Args: out_trade_no: 商户订单号 total_amount, 小程序调起支付的二次签名参数(与公众号 JSAPI 规则一致), 统一下单 (V2 API) Args: out_trade_no: 商户订单号 tot, 生成签名 V3 (SHA256 with RSA) (+3 more)

Community 14 - "Process CRUD"

Cohesion: 0.22 Nodes (18): _consumable_row_to_dict(), create_process(), _create_sub_consumable(), _create_sub_data_collection(), _create_sub_output(), _create_sub_reagent(), _data_collection_row_to_dict(), get_process() (+10 more)

Community 15 - "QC Third Party"

Cohesion: 0.18 Nodes (18): company_code_exists(), create_company(), get_company(), list_companies(), list_company_options(), _row_to_dict(), soft_delete_company(), update_company() (+10 more)

Community 16 - "Insurance Company"

Cohesion: 0.26 Nodes (16): InsuranceCompanyCreateBody, InsuranceCompanyInvoiceCreateBody, InsuranceCompanyInvoiceUpdateBody, InsuranceCompanyUpdateBody, InsuranceProjectPriceCreateBody, InsuranceProjectPriceUpdateBody, _list_insurance_companies(), 保险公司管理 API(保险公司 + 开票信息 + 项目价格) (+8 more)

Community 17 - "Role Management"

Cohesion: 0.19 Nodes (12): get_role_data_scope(), get_role_menus(), create_role(), get_role(), get_role_menu_ids(), list_roles(), 角色 CRUD(sys_role / sys_role_menu / sys_role_data_scope_detail), role_name_exists() (+4 more)

Community 18 - "Collection Region"

Cohesion: 0.23 Nodes (12): create_collection_region(), create_hospital(), get_collection_region(), get_hospital(), _hospital_to_dict(), list_collection_regions(), list_hospitals(), _region_to_dict() (+4 more)

Community 19 - "WeChat Messages"

Cohesion: 0.24 Nodes (9): 微信消息通知服务 支持微信小程序模板消息推送 使用方式: from app.core.wechat_message import Wech, 发送模板消息 Args: openid: 用户openid templ, send_delivery_notice(), send_delivery_warning(), send_order_status(), send_payment_success(), send_refund_result(), send_urge_notification() (+1 more)

Community 20 - "Module 20"

Cohesion: 0.23 Nodes (12): Config, ProductBase, ProductCategoryBase, ProductCategoryCreate, ProductCategoryResponse, ProductCreate, ProductResponse, ProductUnitBase (+4 more)

Community 21 - "Module 21"

Cohesion: 0.27 Nodes (10): batch_issue_sample_codes(), batch_revoke_sample_codes(), create_sample_code(), get_sample_code(), list_sample_codes(), 样本编码池 CRUD(biz_sample_code), _row_to_dict(), sample_code_exists() (+2 more)

Community 22 - "Module 22"

Cohesion: 0.26 Nodes (10): list_menus(), _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), _row_to_dict() (+2 more)

Community 23 - "Module 23"

Cohesion: 0.27 Nodes (10): batch_issue_protocol_nos(), batch_revoke_protocol_nos(), create_protocol_no(), get_protocol_no(), list_protocol_nos(), protocol_no_exists(), 采集协议号池 CRUD(biz_collection_protocol_no), _row_to_dict() (+2 more)

Community 24 - "Module 24"

Cohesion: 0.24 Nodes (9): dict_data_options(), create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), 字典数据 CRUD(sys_dict_data), _row_to_dict(), soft_delete_dict_data() (+1 more)

Community 25 - "Module 25"

Cohesion: 0.29 Nodes (10): list_depts(), _build_tree(), _cascade_soft_delete(), create_dept(), get_dept(), list_depts(), list_depts_tree(), _row_to_dict() (+2 more)

Community 26 - "Module 26"

Cohesion: 0.31 Nodes (8): consumable_code_exists(), create_consumable(), get_consumable(), list_consumables(), 耗材 CRUD(biz_consumable), _row_to_dict(), soft_delete_consumable(), update_consumable()

Community 27 - "Module 27"

Cohesion: 0.31 Nodes (8): create_sop_document(), get_sop_document(), list_sop_documents(), SOP文档 CRUD(biz_sop_document), _row_to_dict(), soft_delete_sop_document(), sop_code_exists(), update_sop_document()

Community 28 - "Module 28"

Cohesion: 0.31 Nodes (8): create_express_company(), express_code_exists(), get_express_company(), list_express_companies(), 快递公司 CRUD(biz_express_company), _row_to_dict(), soft_delete_express_company(), update_express_company()

Community 29 - "Module 29"

Cohesion: 0.38 Nodes (9): create_check_item(), get_check_item(), item_code_exists(), list_active_check_items(), list_check_items(), _order_query(), _row_to_dict(), soft_delete_check_item() (+1 more)

Community 30 - "Module 30"

Cohesion: 0.31 Nodes (8): category_code_exists(), create_process_category(), get_process_category(), list_process_categories(), 工艺工序分类 CRUD(biz_process_category), _row_to_dict(), soft_delete_process_category(), update_process_category()

Community 31 - "Module 31"

Cohesion: 0.31 Nodes (8): create_item_unit(), get_item_unit(), list_item_units(), 物品单位 CRUD(biz_item_unit), _row_to_dict(), soft_delete_item_unit(), unit_code_exists(), update_item_unit()

Community 32 - "Module 32"

Cohesion: 0.31 Nodes (8): create_customer(), get_customer(), id_card_taken(), list_customers(), 客户 CRUD(biz_customer), _row_to_dict(), soft_delete_customer(), update_customer()

Community 33 - "Module 33"

Cohesion: 0.31 Nodes (8): create_cell_sample_type(), get_cell_sample_type(), list_cell_sample_types(), 细胞样本类型 CRUD(biz_cell_sample_type), _row_to_dict(), soft_delete_cell_sample_type(), type_code_exists(), update_cell_sample_type()

Community 34 - "Module 34"

Cohesion: 0.31 Nodes (8): create_output_type(), get_output_type(), list_output_types(), 工艺产出物类型 CRUD(biz_output_type), _row_to_dict(), soft_delete_output_type(), type_code_exists(), update_output_type()

Community 35 - "Module 35"

Cohesion: 0.36 Nodes (7): create_dict_type(), dict_type_code_exists(), get_dict_type(), list_dict_types(), _row_to_dict(), soft_delete_dict_type(), update_dict_type()

Community 36 - "Module 36"

Cohesion: 0.36 Nodes (7): create_tenant(), get_tenant(), list_tenants(), _row_to_dict(), soft_delete_tenant(), tenant_no_exists(), update_tenant()

Community 37 - "Module 37"

Cohesion: 0.36 Nodes (7): create_reagent(), get_reagent(), list_reagents(), reagent_code_exists(), _row_to_dict(), soft_delete_reagent(), update_reagent()

Community 38 - "Module 38"

Cohesion: 0.39 Nodes (8): create_lab_item(), get_lab_item(), item_code_exists(), list_active_lab_items(), list_lab_items(), _row_to_dict(), soft_delete_lab_item(), update_lab_item()

Community 39 - "Module 39"

Cohesion: 0.36 Nodes (7): create_site(), get_site(), list_sites(), _row_to_dict(), site_code_exists(), soft_delete_site(), update_site()

Community 40 - "Module 40"

Cohesion: 0.29 Nodes (2): BaseModel, SoftDeleteModel

Community 41 - "Module 41"

Cohesion: 0.38 Nodes (6): derive_legacy_status_from_three(), derive_three_status_from_legacy(), 阶段A兼容:从旧 status 推导三字段。 约束:旧 status 本身混合了支付/配送/订单生命周期,因此只能尽力推断; 若业务侧已有更精确, 阶段A兼容:从三字段反推旧 status(用于旧前端/旧筛选参数兼容)。, ThreeStatus, _to_decimal()

Community 42 - "Module 42"

Cohesion: 0.4 Nodes (4): list_ethnics_for_select(), list_ethnics(), 民族码表 CRUD(全局 sys_ethnic), _row_to_dict()

Community 43 - "Module 43"

Cohesion: 0.5 Nodes (3): BaseSettings, Config, Settings

Community 44 - "Module 44"

Cohesion: 0.67 Nodes (2): get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,供后端菜单模式联调)

Community 46 - "Module 46"

Cohesion: 1.0 Nodes (1): API 路由包(骨架:公共鉴权 + 静态菜单 + 运营端占位)

Community 49 - "Module 49"

Cohesion: 1.0 Nodes (1): 发送订单状态通知 Args: openid: 用户openid ord

Community 50 - "Module 50"

Cohesion: 1.0 Nodes (1): 发送支付成功通知 Args: openid: 用户openid ord

Community 51 - "Module 51"

Cohesion: 1.0 Nodes (1): 发送配送通知 Args: openid: 配送员openid task

Community 52 - "Module 52"

Cohesion: 1.0 Nodes (1): 发送配送时效预警 Args: openid: 配送员openid ta

Community 53 - "Module 53"

Cohesion: 1.0 Nodes (1): 发送退款结果通知 Args: openid: 用户openid ord

Community 54 - "Module 54"

Cohesion: 1.0 Nodes (1): 发送催单通知给配送员 Args: deliver_openid: 配送员openid

Knowledge Gaps

  • 84 isolated node(s): 刷新会话 TTL(用于 refreshToken 延长会话), 写入 refreshToken(用于 one-time 使用/吊销), 根据 token 获取当前用户(包含 Redis 会话校验), 登录凭据 RSA 解密(与前端 JSEncrypt PKCS#1 v1.5 兼容)。, Base64 密文 -> JSON 对象(须含 username、password、ts 毫秒时间戳)。 (+79 more) These have ≤1 connection - possible missing edges or undocumented components.
  • Thin community Module 40 (8 nodes): BaseModel, .to_dict(), get_active(), base.py, SoftDeleteModel, .restore(), .soft_delete(), __tablename__() Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 44 (3 nodes): get_menu_list(), menu.py, 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,供后端菜单模式联调) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 46 (2 nodes): __init__.py, API 路由包(骨架:公共鉴权 + 静态菜单 + 运营端占位) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 49 (1 nodes): 发送订单状态通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 50 (1 nodes): 发送支付成功通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 51 (1 nodes): 发送配送通知 Args: openid: 配送员openid task Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 52 (1 nodes): 发送配送时效预警 Args: openid: 配送员openid ta Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 53 (1 nodes): 发送退款结果通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Module 54 (1 nodes): 发送催单通知给配送员 Args: deliver_openid: 配送员openid Too small to be a meaningful cluster - may be noise or needs more connections extracted.

Suggested Questions

Questions this graph is uniquely positioned to answer:

  • Why does generate_uuid() connect CRUD Operations to API Schemas & Bodies, API Route Handlers, Collection Protocol, Services & Mixed CRUD, Protocol & Work Order CRUD, Auth & Public API, Research Donation, Workflow Engine, Operations Management, Process CRUD, QC Third Party, Role Management, Collection Region, Module 21, Module 22, Module 23, Module 24, Module 25, Module 26, Module 27, Module 28, Module 29, Module 30, Module 31, Module 32, Module 33, Module 34, Module 35, Module 36, Module 37, Module 38, Module 39? High betweenness centrality (0.099) - this node is a cross-community bridge.
  • Why does SysUser connect API Schemas & Bodies to Collection Protocol, Protocol & Work Order CRUD, Auth & Public API, Research Donation, Workflow Engine, Operations Management, Production Management, Insurance Company? High betweenness centrality (0.096) - this node is a cross-community bridge.
  • Why does success_response() connect API Route Handlers to API Schemas & Bodies, Auth & Public API, Research Donation, Workflow Engine, Module 42, Module 44, Insurance Company, Role Management, Module 22, Module 24, Module 25? High betweenness centrality (0.089) - this node is a cross-community bridge.
  • Are the 366 inferred relationships involving success_response() (e.g. with web_login_rsa_public_key() and web_login()) actually correct? success_response() has 366 INFERRED edges - model-reasoned connections that need verification.
  • Are the 331 inferred relationships involving str (e.g. with extract_login_credentials() and ._make_request()) actually correct? str has 331 INFERRED edges - model-reasoned connections that need verification.
  • Are the 292 inferred relationships involving error_response() (e.g. with _json_error_response() and web_login()) actually correct? error_response() has 292 INFERRED edges - model-reasoned connections that need verification.
  • Are the 200 inferred relationships involving SysUser (e.g. with 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 and 从 SysUser 读取用户的 dept_id。) actually correct? SysUser has 200 INFERRED edges - model-reasoned connections that need verification.