Files
zkxw/backend/graphify-out/GRAPH_REPORT.md
T
2026-08-25 09:19:31 +08:00

21 KiB
Raw Blame History

Graph Report - app (2026-08-20)

Corpus Check

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

Summary

  • 5425 nodes · 29863 edges · 43 communities detected
  • Extraction: 31% EXTRACTED · 69% INFERRED · 0% AMBIGUOUS · INFERRED: 20492 edges (avg confidence: 0.6)
  • Token cost: 0 input · 0 output

Community Hubs (Navigation)

God Nodes (most connected - your core abstractions)

  1. success_response() - 759 edges
  2. error_response() - 629 edges
  3. SysUser - 605 edges
  4. BizQcTaskResult - 352 edges
  5. BizProductionMaterial - 335 edges
  6. BizProductionMaterialUsage - 329 edges
  7. BizQcMaterialUsage - 327 edges
  8. BizQcMaterial - 317 edges
  9. BizProductionMaterialStockBatch - 316 edges
  10. BizMaterialUsage - 313 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
  • sync_lab_storage_seq_after_use() --calls--> generate_uuid() [INFERRED] crud/sample_reception_lab_code.py → core/utils.py
  • 微信小程序登录业务:openid + 手机号一致性校验。 --uses--> SysUser [INFERRED] services/wechat_login_service.py → models/models.py
  • 已绑定 openid 时静默换票(无需手机号授权)。 --uses--> SysUser [INFERRED] services/wechat_login_service.py → models/models.py

Communities

Community 0 - "Community 0"

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

Community 1 - "Community 1"

Cohesion: 0.01 Nodes (835): generate_uuid(), ApiRequestLogCRUD, delete(), get_multi_with_filters(), create_cell_sample_type(), get_cell_sample_type(), list_cell_sample_types(), 细胞样本类型 CRUD(biz_cell_sample_type) (+827 more)

Community 2 - "Community 2"

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

Community 3 - "Community 3"

Cohesion: 0.07 Nodes (465): 环境检测 — 检测项维护 + 登记管理 API, 保险公司及险种价格管理 API(保险公司 + 开票信息 + 险种价格), ProcessDefCreateBody, ProcessDefUpdateBody, PublishVersionBody, 审批意见:前端传 commentText,兼容 comment。, StartInstanceBody, TaskActionBody (+457 more)

Community 4 - "Community 4"

Cohesion: 0.01 Nodes (328): _normalize_date_bound(), format_date(), generate_id(), optional_date(), parse_date(), 将字符串 / date / datetime 转为 date 或 None, camel_to_snake(), get_model_attr() (+320 more)

Community 5 - "Community 5"

Cohesion: 0.01 Nodes (292): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则,避免 Illegal mix of collations。, 跨表字符串等值比较(JOIN / WHERE)时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci(), build_void_type_label_map(), format_protocol_status_label() (+284 more)

Community 6 - "Community 6"

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

Community 7 - "Community 7"

Cohesion: 0.07 Nodes (250): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegionCreateBody, CollectionRegionUpdateBody, CustomerCreateBody, CustomerUpdateBody, HospitalCreateBody, HospitalUpdateBody (+242 more)

Community 8 - "Community 8"

Cohesion: 0.02 Nodes (155): mp_bind(), mp_bind_status(), 小程序鉴权:微信登录 / 绑定 openid。, 当前用户是否已绑定微信服务号 openid。, 服务号网页授权 code 绑定当前用户(需 Bearer)。, 微信登录:openid 已绑定时可静默换票;否则须授权手机号且与账号 phone_no 一致。, 密码登录后绑定当前微信 openid(需 Bearer)。, _resolve_user_id() (+147 more)

Community 9 - "Community 9"

Cohesion: 0.03 Nodes (137): list_ethnics_for_select(), apply_data_scope(), _get_child_dept_ids(), get_user_dept_id(), _resolve_user_role_scopes(), list_ethnics(), 民族码表 CRUD(全局 sys_ethnic), _row_to_dict() (+129 more)

Community 10 - "Community 10"

Cohesion: 0.03 Nodes (119): get_next_cell_product_code(), _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() (+111 more)

Community 11 - "Community 11"

Cohesion: 0.05 Nodes (116): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, list_storage_slot_stats(), OccupancyCreateBody (+108 more)

Community 12 - "Community 12"

Cohesion: 0.04 Nodes (85): _collect_descendants(), _current_user(), _find_mobile_root(), list_my_mobile_menus(), _mobile_menu_icon(), _mobile_menu_icon_colors(), 小程序菜单:当前用户在「移动端菜单」树下有权限的入口。, 宫格图标底色/图形色(可按入口自定义,不强制品牌绿)。 (+77 more)

Community 13 - "Community 13"

Cohesion: 0.05 Nodes (22): extract_avatar_storage_key(), 用户头像 URL 解析(sys_user.avatar 可能存 MinIO 相对路径或完整 URL), 从 upload 返回值或历史完整 URL 中提取 avatar/ 相对路径。, 服务端内部拼完整 URL(邮件等);Web API 应返回库中原始路径。, resolve_avatar_display_url(), BaseStorage, convert_heic_to_jpeg(), get_storage() (+14 more)

Community 14 - "Community 14"

Cohesion: 0.09 Nodes (50): complete_application(), create_basic_experiment_sale_schedules(), create_infusion_plan(), create_schedule(), _create_schedule_products(), _format_yyyy_mm_dd(), _generate_application_no(), get_application() (+42 more)

Community 15 - "Community 15"

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

Cohesion: 0.21 Nodes (21): _assert_routes_exist(), collect_missing_route_ids(), create_set(), create_set_from_work_order(), create_tasks_from_set(), delete_set(), get_set(), _item_count_map() (+13 more)

Community 17 - "Community 17"

Cohesion: 0.19 Nodes (21): apply_overtime_kit_hours(), _build_rest_day_segments(), _build_workday_windows(), calc_overtime_hours(), _day_at_minutes(), _day_start_ms(), _extract_rules(), _format_ymd() (+13 more)

Community 18 - "Community 18"

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

Cohesion: 0.22 Nodes (15): apply_trip_kit_days(), calc_trip_leg_days(), _day_index(), _end_offset(), _extract_rules(), is_half_day_multiple(), 出差套件:半日制行程时长(与前端 oa-trip-days.ts 对齐), 遍历 tripKit:行程未手改则覆盖 duration;出差天数未手改则覆盖为各行程时长之和。 (+7 more)

Community 20 - "Community 20"

Cohesion: 0.26 Nodes (14): apply_leave_kit_hours(), calc_leave_hours(), _extract_rules(), _kit_child_fields(), _overlap_minutes_on_day(), _parse_dt(), _parse_hm(), 请假套件:双段工时重叠小时(与前端 oa-leave-hours.ts 对齐) (+6 more)

Community 21 - "Community 21"

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

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

Community 23 - "Community 23"

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

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

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

Cohesion: 0.29 Nodes (2): BaseModel, SoftDeleteModel

Community 27 - "Community 27"

Cohesion: 0.39 Nodes (7): _allow_modify(), apply_owner_field_defaults(), OA 归属人 / 归属部门:只读强制回填与校验辅助, 归属字段处理: - allowModify 为假:强制写入当前发起人 / 主部门(防篡改) - allowModify 为真且字段为空:补默认值, _rule_props(), _schema_rules(), _walk_rules()

Community 28 - "Community 28"

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

Community 29 - "Community 29"

Cohesion: 0.4 Nodes (5): batch_matches_stock_status(), normalize_batch_stock_status(), 质检物料入库批次:按剩余数量过滤的语义辅助。, 纯函数判定(供单测);list_batches 用 SQL 等价条件。, 返回 'available' | 'exhausted';全部 / 空 / 非法 → None(不加剩余数量条件)。

Community 30 - "Community 30"

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

Community 31 - "Community 31"

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

Community 32 - "Community 32"

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

Community 33 - "Community 33"

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

Community 34 - "Community 34"

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

Community 35 - "Community 35"

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

Community 36 - "Community 36"

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

Community 39 - "Community 39"

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

Community 40 - "Community 40"

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

Community 41 - "Community 41"

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

Community 42 - "Community 42"

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

Community 43 - "Community 43"

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

Community 44 - "Community 44"

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

Knowledge Gaps

  • 178 isolated node(s): 刷新会话 TTL(refreshToken 续期;已登录用户每次 API 校验通过后滑动续期), 写入 refreshToken(用于 one-time 使用/吊销), 根据 token 获取当前用户(包含 Redis 会话校验;会话滑动续期), 登录凭据 RSA 解密(与前端 JSEncrypt PKCS#1 v1.5 兼容)。, 加载 RSA 密钥对:优先环境变量,否则使用内置固定默认密钥。 (+173 more) These have ≤1 connection - possible missing edges or undocumented components.
  • Thin community Community 26 (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 31 (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 32 (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 33 (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 34 (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 35 (2 nodes): context.py, 请求级别的用户上下文变量 通过 contextvars 在请求处理链路中传递当前用户信息, 供 SQLAlchemy 事件监听器等底层机制使用,避免逐层手动传 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 36 (2 nodes): __init__.py, API 路由包(骨架:公共鉴权 + 静态菜单 + 运营端占位) Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 39 (1 nodes): 发送订单状态通知 Args: openid: 用户openid ord 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: openid: 配送员openid task Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 42 (1 nodes): 发送配送时效预警 Args: openid: 配送员openid ta Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 43 (1 nodes): 发送退款结果通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
  • Thin community Community 44 (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 5, Community 6, Community 7, Community 8, Community 9, Community 10, Community 11, Community 12, Community 24? High betweenness centrality (0.115) - this node is a cross-community bridge.
  • Why does success_response() connect Community 0 to Community 32, Community 2, Community 8, Community 9, Community 10, Community 11, Community 12? High betweenness centrality (0.040) - this node is a cross-community bridge.
  • Why does OaEngineError connect Community 6 to Community 1, Community 2? High betweenness centrality (0.038) - this node is a cross-community bridge.
  • Are the 912 inferred relationships involving str (e.g. with unhandled_exception_handler() and get_current_user_by_token()) actually correct? str has 912 INFERRED edges - model-reasoned connections that need verification.
  • Are the 758 inferred relationships involving success_response() (e.g. with list_storage_release_reviews() and get_storage_release_review_detail()) actually correct? success_response() has 758 INFERRED edges - model-reasoned connections that need verification.
  • Are the 628 inferred relationships involving error_response() (e.g. with _json_error_response() and list_storage_release_reviews()) actually correct? error_response() has 628 INFERRED edges - model-reasoned connections that need verification.
  • Are the 603 inferred relationships involving SysUser (e.g. with 数据权限过滤(V0.3:基于角色 data_scope 的查询级行级过滤) data_scope 值: 1 = 全部数据 2 = 本部门数据 3 and 从 SysUser 读取用户的 dept_id。) actually correct? SysUser has 603 INFERRED edges - model-reasoned connections that need verification.