Files
zkxw/backend/graphify-out/GRAPH_REPORT.md
T
2026-08-06 22:21:14 +08:00

20 KiB
Raw Blame History

Graph Report - app (2026-08-06)

Corpus Check

  • Large corpus: 242 files · ~297,473 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.

Summary

  • 5134 nodes · 28066 edges · 40 communities detected
  • Extraction: 32% EXTRACTED · 68% INFERRED · 0% AMBIGUOUS · INFERRED: 19173 edges (avg confidence: 0.6)
  • Token cost: 0 input · 0 output

Community Hubs (Navigation)

God Nodes (most connected - your core abstractions)

  1. success_response() - 732 edges
  2. error_response() - 605 edges
  3. SysUser - 595 edges
  4. BizQcTaskResult - 346 edges
  5. BizProductionMaterial - 329 edges
  6. BizProductionMaterialUsage - 323 edges
  7. BizQcMaterialUsage - 321 edges
  8. BizQcMaterial - 311 edges
  9. BizProductionMaterialStockBatch - 310 edges
  10. BizMaterialUsage - 307 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
  • 中试服务交付管理 API(交付信息、交付物料、交付方式) --uses--> SysUser [INFERRED] api/pilot_delivery.py → models/models.py
  • 保留匹配节点及其全部上级,供关键词检索后仍能正确组树。 --uses--> SysDept [INFERRED] crud/dept.py → models/models.py
  • 物品单位 CRUD(biz_item_unit) --uses--> BizItemUnit [INFERRED] crud/item_unit.py → models/models.py

Communities

Community 0 - "Community 0"

Cohesion: 0.01 Nodes (943): attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu(), create_post() (+935 more)

Community 1 - "Community 1"

Cohesion: 0.01 Nodes (647): generate_uuid(), 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() (+639 more)

Community 2 - "Community 2"

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

Community 3 - "Community 3"

Cohesion: 0.06 Nodes (566): BatchRefundFinanceSubmitBody, 细胞存储 — 采集协议单 / 审核 / 财务确认 / 分期预警 API, 持久化协议子资源。 缴费(含明细校验)须在样本之前:明细校验失败时不得已占用样本编码。 各子表 CRUD 内部仍可能分段 commit,创建接, 与列表接口一致:按租户 + 角色数据权限判断是否可访问该协议单。, If mother info exists but no customerId, create a customer record and link it., RefundFinanceSubmitBody, 保险公司及险种价格管理 API(保险公司 + 开票信息 + 险种价格), Base (+558 more)

Community 4 - "Community 4"

Cohesion: 0.01 Nodes (348): _normalize_date_bound(), complete_protocol_invoice_request(), create_collection_protocol(), delete_collection_protocol(), _ensure_customer_for_mother(), get_collection_protocol_detail(), _get_current_user_id(), get_invoice_eligible_payments() (+340 more)

Community 5 - "Community 5"

Cohesion: 0.01 Nodes (305): _body_to_payload(), _get_current_user_id(), get_production_reception_by_sample_code(), get_production_reception_detail(), _get_tenant_no(), post_production_reception(), put_production_reception(), _resolve_reception_id() (+297 more)

Community 6 - "Community 6"

Cohesion: 0.03 Nodes (215): 截止日期:仅日期时扩到当天 23:59:59。, 发起前预览审批链(条件齐后解析最终路径与审批人)。, 兼容旧 GET:无 formData,含条件分支时多为待确定占位。, _app_to_dict(), _copied_app_name(), copy_app(), create_app(), _create_version() (+207 more)

Community 7 - "Community 7"

Cohesion: 0.02 Nodes (123): get_designer_data(), _error_json(), lifespan(), 数据库异常:返回 JSON 并保留 CORS 头,避免浏览器只报跨域错误, 未捕获异常:统一 JSON 500,确保跨域场景下仍有 Access-Control-Allow-Origin, sqlalchemy_exception_handler(), unhandled_exception_handler(), BaseHTTPMiddleware (+115 more)

Community 8 - "Community 8"

Cohesion: 0.03 Nodes (147): _avatar_url_field(), _build_current_user_payload(), _build_user_info_payload(), get_current_user_profile(), get_web_auth_menu_codes(), _jwt_user_payload(), logout(), 公共接口(Web 登录、刷新 Token、登出;用户模型对齐 docs/sql/zkxw.sql 基线) (+139 more)

Community 9 - "Community 9"

Cohesion: 0.03 Nodes (155): _batch_line_to_dict(), cancel_check(), _check_header_to_dict(), complete_check(), _get_check(), get_check_detail(), _line_counts(), list_checks() (+147 more)

Community 10 - "Community 10"

Cohesion: 0.03 Nodes (150): api_save_application(), get_protocol_nos_used_in_protocols(), _fmt_dt(), get_handover_by_schedule(), get_outbound_handover(), get_outbound_handover_view(), _handover_row_to_dict(), _handover_view_dict() (+142 more)

Community 11 - "Community 11"

Cohesion: 0.03 Nodes (141): _ancestor_link_from_cell_product_input(), _ancestor_sample_chain_link(), _apply_cell_product_status_change(), _build_ancestor_chain(), _build_descendant_chain(), _build_facility_path_label(), build_split_product_codes(), create_cell_product() (+133 more)

Community 12 - "Community 12"

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

Community 13 - "Community 13"

Cohesion: 0.45 Nodes (71): BatchStockInBody, BatchStockInItem, BatchStockOutBody, BatchStockOutItem, ConsumableCreateBody, ConsumablePackCreateBody, ConsumablePackUpdateBody, ConsumableUpdateBody (+63 more)

Community 14 - "Community 14"

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

Cohesion: 0.17 Nodes (29): _amount_for_row(), _batch_map(), deduct_for_task(), _deduct_task_usage_legacy_batch(), _display_remark(), _fmt_date_val(), _linked_qc_task_no_map(), list_linked_task_usages() (+21 more)

Community 16 - "Community 16"

Cohesion: 0.19 Nodes (20): _code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), get_material_entity(), get_my_usages(), _is_enabled_status() (+12 more)

Community 17 - "Community 17"

Cohesion: 0.21 Nodes (19): _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() (+11 more)

Community 18 - "Community 18"

Cohesion: 0.19 Nodes (17): apply_trip_kit_days(), calc_trip_leg_days(), _day_index(), _end_offset(), _extract_rules(), is_half_day_multiple(), _kit_trip_fields(), 出差套件:半日制行程时长(与前端 oa-trip-days.ts 对齐) (+9 more)

Community 19 - "Community 19"

Cohesion: 0.27 Nodes (12): create_equipment(), _dec(), equipment_code_exists(), equipment_is_referenced(), get_equipment(), list_equipments(), _norm_status(), _parse_date() (+4 more)

Community 20 - "Community 20"

Cohesion: 0.27 Nodes (12): _field_label(), _is_empty(), _is_required(), _parse_money(), OA 表单设计器:金额控件 form_data 校验, 校验 form_data 中金额控件的值格式,返回中文错误列表(空表示通过)。, 解析金额值。成功返回 (number, None);失败返回 (None, error_key)。, _rule_props() (+4 more)

Community 21 - "Community 21"

Cohesion: 0.24 Nodes (11): deduct_for_step(), _display_remark(), list_stock_logs(), _parse_receiver_purpose_from_remark(), 试剂变动记录 CRUD(biz_reagent_stock_log), 撤销步骤此前 step_save 扣减,便于重新填报。, 扣减试剂库存并生成变动记录。调用方控制事务,本函数不 commit。, _resolve_receiver_purpose() (+3 more)

Community 22 - "Community 22"

Cohesion: 0.24 Nodes (11): deduct_for_step(), _display_remark(), list_stock_logs(), _parse_receiver_purpose_from_remark(), 耗材变动记录 CRUD(biz_consumable_stock_log), 撤销步骤此前 step_save 扣减,便于重新填报。, 扣减耗材库存并生成变动记录。调用方控制事务,本函数不 commit。, _resolve_receiver_purpose() (+3 more)

Community 23 - "Community 23"

Cohesion: 0.31 Nodes (10): create_account(), _filtered_query(), get_account(), list_accounts(), list_options(), OA 收款账户 CRUD(oa_receive_account), row_to_dict(), soft_delete_account() (+2 more)

Community 24 - "Community 24"

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

Community 25 - "Community 25"

Cohesion: 0.29 Nodes (2): BaseModel, SoftDeleteModel

Community 26 - "Community 26"

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

Community 27 - "Community 27"

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

Community 28 - "Community 28"

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

Community 29 - "Community 29"

Cohesion: 0.67 Nodes (2): get_menu_list(), 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,5 个一级菜单分组)

Community 30 - "Community 30"

Cohesion: 0.67 Nodes (1): 转正套件:入职日 + 试用期月数 → 建议转正日(YYYY-MM-DD)。

Community 31 - "Community 31"

Cohesion: 1.0 Nodes (1): 质检物料金额查看授权:专用角色与菜单权限常量。

Community 32 - "Community 32"

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

Community 33 - "Community 33"

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

Community 36 - "Community 36"

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

Community 37 - "Community 37"

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

Community 38 - "Community 38"

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

Community 39 - "Community 39"

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

Community 40 - "Community 40"

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

Community 41 - "Community 41"

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

Knowledge Gaps

  • 163 isolated node(s): 刷新会话 TTL(refreshToken 续期;已登录用户每次 API 校验通过后滑动续期), 写入 refreshToken(用于 one-time 使用/吊销), 根据 token 获取当前用户(包含 Redis 会话校验;会话滑动续期), 登录凭据 RSA 解密(与前端 JSEncrypt PKCS#1 v1.5 兼容)。, 加载 RSA 密钥对:优先环境变量,否则使用内置固定默认密钥。 (+158 more) These have ≤1 connection - possible missing edges or undocumented components.
  • Thin community Community 25 (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 28 (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 29 (3 nodes): get_menu_list(), menu.py, 运营端菜单接口(与 web-admin 前端静态路由 sqxp.ts 对齐,5 个一级菜单分组) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 30 (3 nodes): add_months_ymd(), oa_confirmation_date.py, 转正套件:入职日 + 试用期月数 → 建议转正日(YYYY-MM-DD)。 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 31 (2 nodes): qc_material_amount_auth_constants.py, 质检物料金额查看授权:专用角色与菜单权限常量。 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 32 (2 nodes): context.py, 请求级别的用户上下文变量 通过 contextvars 在请求处理链路中传递当前用户信息, 供 SQLAlchemy 事件监听器等底层机制使用,避免逐层手动传 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 33 (2 nodes): __init__.py, API 路由包(骨架:公共鉴权 + 静态菜单 + 运营端占位) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 36 (1 nodes): 发送订单状态通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 37 (1 nodes): 发送支付成功通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 38 (1 nodes): 发送配送通知 Args: openid: 配送员openid task Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 39 (1 nodes): 发送配送时效预警 Args: openid: 配送员openid ta Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 40 (1 nodes): 发送退款结果通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 41 (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 SysUser connect Community 2 to Community 0, Community 1, Community 3, Community 4, Community 6, Community 8, Community 9, Community 10, Community 11, Community 12, Community 13, Community 15, Community 16, Community 21, Community 22? High betweenness centrality (0.107) - this node is a cross-community bridge.
  • Why does success_response() connect Community 0 to Community 2, Community 4, Community 5, Community 7, Community 8, Community 10, Community 29? High betweenness centrality (0.045) - this node is a cross-community bridge.
  • Why does generate_uuid() connect Community 1 to Community 0, Community 4, Community 5, Community 6, Community 7, Community 8, Community 9, Community 10, Community 11, Community 12, Community 15, Community 16, Community 17, Community 19, Community 21, Community 22, Community 23? High betweenness centrality (0.038) - this node is a cross-community bridge.
  • Are the 862 inferred relationships involving str (e.g. with unhandled_exception_handler() and get_current_user_by_token()) actually correct? str has 862 INFERRED edges - model-reasoned connections that need verification.
  • Are the 731 inferred relationships involving success_response() (e.g. with list_storage_release_reviews() and get_storage_release_review_detail()) actually correct? success_response() has 731 INFERRED edges - model-reasoned connections that need verification.
  • Are the 604 inferred relationships involving error_response() (e.g. with _json_error_response() and list_storage_release_reviews()) actually correct? error_response() has 604 INFERRED edges - model-reasoned connections that need verification.
  • Are the 593 inferred relationships involving SysUser (e.g. with 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 and 从 SysUser 读取用户的 dept_id。) actually correct? SysUser has 593 INFERRED edges - model-reasoned connections that need verification.