Files
zkxw/backend/graphify-out/GRAPH_REPORT.md
T
2026-05-22 07:16:53 +08:00

23 KiB
Raw Blame History

Graph Report - app (2026-05-21)

Corpus Check

  • 135 files · ~119,973 words
  • Verdict: corpus is large enough that graph structure adds value.

Summary

  • 2411 nodes · 9448 edges · 57 communities detected
  • Extraction: 42% EXTRACTED · 58% INFERRED · 0% AMBIGUOUS · INFERRED: 5492 edges (avg confidence: 0.63)
  • Token cost: 0 input · 0 output

Community Hubs (Navigation)

God Nodes (most connected - your core abstractions)

  1. success_response() - 380 edges
  2. error_response() - 305 edges
  3. SysUser - 217 edges
  4. BizQcMaterialUsage - 197 edges
  5. BizMaterialStockLog - 193 edges
  6. BizQcTaskResult - 193 edges
  7. BizQcMaterial - 193 edges
  8. BizMaterial - 190 edges
  9. BizQcItemParam - 188 edges
  10. generate_uuid() - 131 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 - "Community 0"

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

Community 1 - "Community 1"

Cohesion: 0.02 Nodes (369): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, ExpressCompanyCreateBody (+361 more)

Community 2 - "Community 2"

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

Community 3 - "Community 3"

Cohesion: 0.02 Nodes (192): generate_uuid(), _code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), list_materials(), options_list() (+184 more)

Community 4 - "Community 4"

Cohesion: 0.03 Nodes (138): create_collection_protocol(), delete_collection_protocol(), _ensure_customer_for_mother(), get_collection_protocol_detail(), _get_current_user_id(), _get_tenant_no(), list_collection_protocol_audits(), list_collection_protocols() (+130 more)

Community 5 - "Community 5"

Cohesion: 0.08 Nodes (136): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegionCreateBody, CollectionRegionUpdateBody, CustomerCreateBody, CustomerUpdateBody, HospitalCreateBody, HospitalUpdateBody (+128 more)

Community 6 - "Community 6"

Cohesion: 0.04 Nodes (105): _format_attachment_file_size(), get_protocol_nos_used_in_protocols(), urls_to_attachment_list(), _accept_conclusion_label(), _attach_reception_detail(), complete_production_work_order(), create_production_work_order_from_reception(), _enrich_wo_items() (+97 more)

Community 7 - "Community 7"

Cohesion: 0.03 Nodes (55): get_designer_data(), BaseStorage, convert_heic_to_jpeg(), get_storage(), LocalStorage, MinIOStorage, OSSStorage, process_image_content() (+47 more)

Community 8 - "Community 8"

Cohesion: 0.04 Nodes (65): list_roles_for_select(), _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)。 (+57 more)

Community 9 - "Community 9"

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

Community 10 - "Community 10"

Cohesion: 0.16 Nodes (32): _create_insurance_company(), _create_insurance_company_invoice(), _create_insurance_project_price(), delete_insurance_company(), delete_insurance_company_invoice(), delete_insurance_project_price(), _fmt_dt(), _generate_uuid() (+24 more)

Community 11 - "Community 11"

Cohesion: 0.15 Nodes (31): _audit_to_dict(), batch_delete_donations(), _collection_to_dict(), _create_collection(), create_donation(), _create_party(), _create_samples(), _create_transport() (+23 more)

Community 12 - "Community 12"

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

Cohesion: 0.15 Nodes (22): Config, Config, ProductReviewMediaBase, ProductReviewMediaCreate, ProductReviewMediaCreateBatch, ProductReviewMediaListResponse, ProductReviewMediaResponse, ProductReviewMediaUpdate (+14 more)

Community 14 - "Community 14"

Cohesion: 0.17 Nodes (12): BusinessException, InvalidStatusTransitionException, log_delivery_operation(), log_operation(), log_order_operation(), log_settlement_operation(), log_user_operation(), OrderLockedException (+4 more)

Community 15 - "Community 15"

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

Cohesion: 0.18 Nodes (17): get_next_cell_product_code(), _build_facility_path_label(), build_split_product_codes(), create_cell_product(), create_cell_products_batch(), create_cell_products_by_quantity(), delete_cell_product(), _enrich_product_dicts() (+9 more)

Community 17 - "Community 17"

Cohesion: 0.21 Nodes (15): batch_issue_protocol_nos(), batch_revoke_protocol_nos(), create_protocol_no(), enrich_issued_user_names(), get_protocol_no(), list_protocol_nos(), _parse_issued_time(), protocol_no_exists() (+7 more)

Community 18 - "Community 18"

Cohesion: 0.17 Nodes (15): Config, QuotationBase, QuotationCreate, QuotationDetailResponse, QuotationItemBase, QuotationItemCreate, QuotationItemResponse, QuotationItemUpdate (+7 more)

Community 19 - "Community 19"

Cohesion: 0.21 Nodes (13): _access_log_to_dict(), create_access_log(), create_clean_room(), get_access_log(), get_clean_room(), list_access_logs(), list_clean_rooms(), room_code_exists() (+5 more)

Community 20 - "Community 20"

Cohesion: 0.25 Nodes (13): code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), list_materials(), _norm_status(), options_list() (+5 more)

Community 21 - "Community 21"

Cohesion: 0.26 Nodes (12): batch_issue_sample_codes(), batch_revoke_sample_codes(), create_sample_code(), get_sample_code(), list_sample_codes(), _parse_issued_time(), 样本编码池 CRUD(biz_sample_code), _resolve_issued_user_display_name() (+4 more)

Community 22 - "Community 22"

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

Cohesion: 0.22 Nodes (12): Config, InquiryBase, InquiryCreate, InquiryDetailResponse, InquiryItemBase, InquiryItemCreate, InquiryItemResponse, InquiryListResponse (+4 more)

Community 24 - "Community 24"

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

Community 25 - "Community 25"

Cohesion: 0.3 Nodes (10): create_consumable_pack(), get_consumable_pack(), get_pack_detail(), _item_row_to_dict(), list_all_packs(), list_consumable_packs(), pack_code_exists(), _row_to_dict() (+2 more)

Community 26 - "Community 26"

Cohesion: 0.27 Nodes (11): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), 保留匹配节点及其全部上级,供关键词检索后仍能正确组树。 (+3 more)

Community 27 - "Community 27"

Cohesion: 0.29 Nodes (9): _build_tree(), _cascade_soft_delete(), create_menu(), get_menu(), list_menus(), list_menus_tree(), _row_to_dict(), soft_delete_menu() (+1 more)

Community 28 - "Community 28"

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

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

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

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

Cohesion: 0.27 Nodes (8): create_dict_data(), get_dict_data(), list_dict_data(), list_dict_data_options(), 字典数据 CRUD(sys_dict_data), _row_to_dict(), soft_delete_dict_data(), update_dict_data()

Community 33 - "Community 33"

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

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

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

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

Cohesion: 0.31 Nodes (9): appointment_no_exists(), create_exhibition_appointment(), _generate_appointment_no(), get_exhibition_appointment(), list_exhibition_appointments(), 展览预约 CRUD(biz_exhibition_appointment), 生成预约编号:YYYYMMDD + 6位序号(如 20260515000001), soft_delete_exhibition_appointment() (+1 more)

Community 38 - "Community 38"

Cohesion: 0.36 Nodes (7): create_post(), get_post(), list_posts(), post_code_exists(), _row_to_dict(), soft_delete_post(), update_post()

Community 39 - "Community 39"

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

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

Community 41 - "Community 41"

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

Community 42 - "Community 42"

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

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

Community 44 - "Community 44"

Cohesion: 0.29 Nodes (2): BaseModel, SoftDeleteModel

Community 45 - "Community 45"

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

Community 46 - "Community 46"

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

Community 47 - "Community 47"

Cohesion: 0.5 Nodes (2): _auto_fill_create_dept_id(), ORM before_insert 钩子:当 create_dept_id 为空时,自动从请求上下文填充当前用户部门 ID

Community 48 - "Community 48"

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

Community 49 - "Community 49"

Cohesion: 1.0 Nodes (1): 请求级别的用户上下文变量 通过 contextvars 在请求处理链路中传递当前用户信息, 供 SQLAlchemy 事件监听器等底层机制使用,避免逐层手动传

Community 50 - "Community 50"

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

Community 53 - "Community 53"

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

Community 54 - "Community 54"

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

Community 55 - "Community 55"

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

Community 56 - "Community 56"

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

Community 57 - "Community 57"

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

Community 58 - "Community 58"

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

Knowledge Gaps

  • 90 isolated node(s): 刷新会话 TTL(refreshToken 续期;已登录用户每次 API 校验通过后滑动续期), 写入 refreshToken(用于 one-time 使用/吊销), 根据 token 获取当前用户(包含 Redis 会话校验;会话滑动续期), 登录凭据 RSA 解密(与前端 JSEncrypt PKCS#1 v1.5 兼容)。, Base64 密文 -> JSON 对象(须含 username、password、ts 毫秒时间戳)。 (+85 more) These have ≤1 connection - possible missing edges or undocumented components.
  • Thin community Community 44 (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 Community 47 (4 nodes): _auto_fill_create_dept_id(), get_db(), database.py, ORM before_insert 钩子:当 create_dept_id 为空时,自动从请求上下文填充当前用户部门 ID Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 48 (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 Community 49 (2 nodes): context.py, 请求级别的用户上下文变量 通过 contextvars 在请求处理链路中传递当前用户信息, 供 SQLAlchemy 事件监听器等底层机制使用,避免逐层手动传 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 50 (2 nodes): __init__.py, API 路由包(骨架:公共鉴权 + 静态菜单 + 运营端占位) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 53 (1 nodes): 发送订单状态通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 54 (1 nodes): 发送支付成功通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 55 (1 nodes): 发送配送通知 Args: openid: 配送员openid task Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 56 (1 nodes): 发送配送时效预警 Args: openid: 配送员openid ta Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 57 (1 nodes): 发送退款结果通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 58 (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 Community 3 to Community 0, Community 2, Community 4, Community 5, Community 6, Community 7, Community 8, Community 9, Community 11, Community 15, Community 16, Community 17, Community 19, Community 20, Community 21, Community 25, Community 26, Community 27, Community 28, Community 29, Community 30, Community 31, Community 32, Community 33, Community 34, Community 35, Community 36, Community 37, Community 38, Community 39, Community 40, Community 41, Community 42, Community 43? High betweenness centrality (0.124) - this node is a cross-community bridge.
  • Why does SysUser connect Community 1 to Community 2, Community 5, Community 6, Community 7, Community 8, Community 10, Community 17, Community 21? High betweenness centrality (0.083) - this node is a cross-community bridge.
  • Why does success_response() connect Community 0 to Community 1, Community 4, Community 5, Community 7, Community 8, Community 10, Community 48, Community 16? High betweenness centrality (0.067) - this node is a cross-community bridge.
  • Are the 379 inferred relationships involving success_response() (e.g. with web_login_rsa_public_key() and web_login()) actually correct? success_response() has 379 INFERRED edges - model-reasoned connections that need verification.
  • Are the 351 inferred relationships involving str (e.g. with extract_login_credentials() and ._make_request()) actually correct? str has 351 INFERRED edges - model-reasoned connections that need verification.
  • Are the 304 inferred relationships involving error_response() (e.g. with _json_error_response() and web_login()) actually correct? error_response() has 304 INFERRED edges - model-reasoned connections that need verification.
  • Are the 215 inferred relationships involving SysUser (e.g. with 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 and 从 SysUser 读取用户的 dept_id。) actually correct? SysUser has 215 INFERRED edges - model-reasoned connections that need verification.