# Graph Report - app  (2026-10-16)

## Corpus Check
- Large corpus: 309 files · ~377,476 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.

## Summary
- 6334 nodes · 35045 edges · 41 communities detected
- Extraction: 32% EXTRACTED · 68% INFERRED · 0% AMBIGUOUS · INFERRED: 23955 edges (avg confidence: 0.6)
- Token cost: 0 input · 0 output

## Community Hubs (Navigation)
- [[_COMMUNITY_Community 0|Community 0]]
- [[_COMMUNITY_Community 1|Community 1]]
- [[_COMMUNITY_Community 2|Community 2]]
- [[_COMMUNITY_Community 3|Community 3]]
- [[_COMMUNITY_Community 4|Community 4]]
- [[_COMMUNITY_Community 5|Community 5]]
- [[_COMMUNITY_Community 6|Community 6]]
- [[_COMMUNITY_Community 7|Community 7]]
- [[_COMMUNITY_Community 8|Community 8]]
- [[_COMMUNITY_Community 9|Community 9]]
- [[_COMMUNITY_Community 10|Community 10]]
- [[_COMMUNITY_Community 11|Community 11]]
- [[_COMMUNITY_Community 12|Community 12]]
- [[_COMMUNITY_Community 13|Community 13]]
- [[_COMMUNITY_Community 14|Community 14]]
- [[_COMMUNITY_Community 15|Community 15]]
- [[_COMMUNITY_Community 16|Community 16]]
- [[_COMMUNITY_Community 17|Community 17]]
- [[_COMMUNITY_Community 18|Community 18]]
- [[_COMMUNITY_Community 19|Community 19]]
- [[_COMMUNITY_Community 20|Community 20]]
- [[_COMMUNITY_Community 21|Community 21]]
- [[_COMMUNITY_Community 22|Community 22]]
- [[_COMMUNITY_Community 23|Community 23]]
- [[_COMMUNITY_Community 24|Community 24]]
- [[_COMMUNITY_Community 25|Community 25]]
- [[_COMMUNITY_Community 26|Community 26]]
- [[_COMMUNITY_Community 27|Community 27]]
- [[_COMMUNITY_Community 28|Community 28]]
- [[_COMMUNITY_Community 29|Community 29]]
- [[_COMMUNITY_Community 30|Community 30]]
- [[_COMMUNITY_Community 31|Community 31]]
- [[_COMMUNITY_Community 32|Community 32]]
- [[_COMMUNITY_Community 33|Community 33]]
- [[_COMMUNITY_Community 34|Community 34]]
- [[_COMMUNITY_Community 37|Community 37]]
- [[_COMMUNITY_Community 38|Community 38]]
- [[_COMMUNITY_Community 39|Community 39]]
- [[_COMMUNITY_Community 40|Community 40]]
- [[_COMMUNITY_Community 41|Community 41]]
- [[_COMMUNITY_Community 42|Community 42]]

## God Nodes (most connected - your core abstractions)
1. `success_response()` - 828 edges
2. `SysUser` - 727 edges
3. `error_response()` - 697 edges
4. `BizQcTaskResult` - 386 edges
5. `BizProductionMaterial` - 370 edges
6. `BizProductionMaterialUsage` - 363 edges
7. `BizQcMaterialUsage` - 361 edges
8. `BizQcMaterial` - 351 edges
9. `BizProductionMaterialStockBatch` - 350 edges
10. `BizMaterialUsage` - 347 edges

## Surprising Connections (you probably didn't know these)
- `统一记录 API 请求/响应出入参的中间件` --uses--> `SysApiRequestLog`  [INFERRED]
  core/api_request_log_middleware.py → models/models.py
- `从用户表读取当前租户，拒绝信任 JWT/请求中的租户覆盖。` --uses--> `SysUser`  [INFERRED]
  core/menu_guard.py → models/models.py
- `盘点登记：待处理领用记录（未标记已使用完）。` --uses--> `SysUser`  [INFERRED]
  api/material.py → models/models.py
- `预签约订单 / 意向金转账 / 转正式 API` --uses--> `SysUser`  [INFERRED]
  api/presign_order.py → models/models.py
- `中试服务管理 API（细胞产品类型/规格/价格体系/项目价格、渠道信息、体检机构）` --uses--> `SysUser`  [INFERRED]
  api/pilot_service.py → models/models.py

## Communities

### Community 0 - "Community 0"
Cohesion: 0.01
Nodes (1132): _assert_user_tenant_access(), attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu() (+1124 more)

### Community 1 - "Community 1"
Cohesion: 0.01
Nodes (824): validate_ymd(), BaseSettings, Config, secret_key_must_be_strong(), Settings, generate_uuid(), ApiRequestLogCRUD, delete() (+816 more)

### Community 2 - "Community 2"
Cohesion: 0.04
Nodes (796): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegionCreateBody, CollectionRegionUpdateBody, CustomerCreateBody, CustomerUpdateBody, HospitalCreateBody, HospitalUpdateBody (+788 more)

### Community 3 - "Community 3"
Cohesion: 0.01
Nodes (682): GarmentBatchDeleteBody, GarmentBatchDiscardBody, GarmentCreateBody, GarmentDiscardBody, GarmentUpdateBody, SterilizeLogBatchBody, SterilizeLogCreateBody, SterilizeLogUpdateBody (+674 more)

### Community 4 - "Community 4"
Cohesion: 0.02
Nodes (410): AttachmentDownloadUrlBody, DeptCreateBody, DeptUpdateBody, DictDataCreateBody, DictDataUpdateBody, DictTypeCreateBody, DictTypeUpdateBody, ExpressCompanyCreateBody (+402 more)

### Community 5 - "Community 5"
Cohesion: 0.01
Nodes (378): _save_sample_payments(), build_void_type_label_map(), generate_id(), camel_to_snake(), get_model_attr(), HistoryCRUD, _active_invoiced_payment_detail_ids(), align_fq_payment_details_payload() (+370 more)

### Community 6 - "Community 6"
Cohesion: 0.02
Nodes (269): _normalize_date_bound(), assert_donation_sensitive_fields(), batch_delete_research_donations(), change_donation_status(), convert_from_storage(), convert_to_storage(), create_research_donation(), delete_research_donation() (+261 more)

### Community 7 - "Community 7"
Cohesion: 0.02
Nodes (272): format_protocol_status_label(), resolve_void_type_label(), get_schedule_detail(), add_task_step(), _aggregate_production_tab_step_field(), assert_step_assignee_for_write(), assert_task_assignee(), assert_task_step_assignee_or_legacy() (+264 more)

### Community 8 - "Community 8"
Cohesion: 0.01
Nodes (215): _register_attachment_routes(), _register_freight_routes(), _register_payment_routes(), _register_presign_routes(), _register_protocol_routes(), mp_bind_status(), 小程序鉴权：微信登录 / 绑定 openid。, 当前用户是否已绑定微信服务号 openid。 (+207 more)

### Community 9 - "Community 9"
Cohesion: 0.02
Nodes (178): list_ethnics_for_select(), _leave_local_callback(), get_designer_data(), apply_data_scope(), _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), get_dept() (+170 more)

### Community 10 - "Community 10"
Cohesion: 0.03
Nodes (118): 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() (+110 more)

### Community 11 - "Community 11"
Cohesion: 0.05
Nodes (113): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, OccupancyCreateBody, 运营支撑 API（洁净室、进出记录、仓储设施、储位、展厅预约） (+105 more)

### Community 12 - "Community 12"
Cohesion: 0.04
Nodes (97): get_customer_service_dict(), _get_tenant_no(), _get_current_user_id(), get_sample_insurance(), get_sample_storage_cert(), _get_tenant_no(), put_sample_insurance(), put_sample_storage_cert() (+89 more)

### Community 13 - "Community 13"
Cohesion: 0.05
Nodes (79): api_save_application(), auto_generate_schedules(), complete_application(), create_application(), create_basic_experiment_sale_schedules(), create_infusion_plan(), create_schedule(), _create_schedule_products() (+71 more)

### Community 14 - "Community 14"
Cohesion: 0.09
Nodes (53): _active_item_lock_query(), _amount(), assert_link_target_access(), _batch_dict(), _cell_item_query(), _collection_lock_query(), create_freight(), _creator_name_map() (+45 more)

### Community 15 - "Community 15"
Cohesion: 0.12
Nodes (31): _assert_routes_exist(), assert_set_writable(), collect_missing_route_ids(), create_set(), create_set_from_work_order(), create_tasks_from_set(), delete_set(), get_set() (+23 more)

### Community 16 - "Community 16"
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 17 - "Community 17"
Cohesion: 0.13
Nodes (24): get_customer(), id_card_taken(), list_customers(), 客户 CRUD（biz_customer）, _row_to_dict(), soft_delete_customer(), update_customer(), _age_from_id_card() (+16 more)

### Community 18 - "Community 18"
Cohesion: 0.17
Nodes (23): apply_overtime_kit_hours(), _build_rest_day_segments(), _build_workday_windows(), calc_overtime_hours(), _day_at_minutes(), _day_start_ms(), _extract_rules(), _format_ymd() (+15 more)

### Community 19 - "Community 19"
Cohesion: 0.2
Nodes (19): _code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), get_material_entity(), get_my_usages(), _is_enabled_status() (+11 more)

### Community 20 - "Community 20"
Cohesion: 0.25
Nodes (15): create_protocol_refund_record(), delete_protocol_refund_record(), _get_current_user_id(), _get_tenant_no(), list_protocol_refund_records(), _protocol_accessible(), update_protocol_refund_record(), create_refund_record() (+7 more)

### Community 21 - "Community 21"
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 22 - "Community 22"
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 23 - "Community 23"
Cohesion: 0.29
Nodes (11): get_detail(), _load_sample_context(), _row_to_dict(), upsert(), dumps_payload(), empty_detail(), loads_payload(), normalize_payload() (+3 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_reagent_stock_log）, 撤销步骤此前 step_save 扣减，便于重新填报。, 扣减试剂库存并生成变动记录。调用方控制事务，本函数不 commit。, _resolve_receiver_purpose() (+3 more)

### Community 25 - "Community 25"
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 26 - "Community 26"
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 27 - "Community 27"
Cohesion: 0.29
Nodes (2): BaseModel, SoftDeleteModel

### 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 (2): _auto_fill_create_dept_id(), ORM before_insert 钩子：当 create_dept_id 为空时，自动从请求上下文填充当前用户部门 ID

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

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

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

### Community 34 - "Community 34"
Cohesion: 1.0
Nodes (1): API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位）

### 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             ord

### Community 39 - "Community 39"
Cohesion: 1.0
Nodes (1): 发送配送通知                  Args:             openid: 配送员openid             task

### Community 40 - "Community 40"
Cohesion: 1.0
Nodes (1): 发送配送时效预警                  Args:             openid: 配送员openid             ta

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

### Community 42 - "Community 42"
Cohesion: 1.0
Nodes (1): 发送催单通知给配送员                  Args:             deliver_openid: 配送员openid

## Knowledge Gaps
- **207 isolated node(s):** `刷新会话 TTL（refreshToken 续期；已登录用户每次 API 校验通过后滑动续期）`, `写入 refreshToken（用于 one-time 使用/吊销）`, `根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）`, `严格判断当前租户用户是否拥有指定移动市场权限码。`, `为移动市场 API 提供租户化、精确匹配的菜单权限依赖。` (+202 more)
  These have ≤1 connection - possible missing edges or undocumented components.
- **Thin community `Community 27`** (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 30`** (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 31`** (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 32`** (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 33`** (2 nodes): `context.py`, `请求级别的用户上下文变量  通过 contextvars 在请求处理链路中传递当前用户信息， 供 SQLAlchemy 事件监听器等底层机制使用，避免逐层手动传`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 34`** (2 nodes): `__init__.py`, `API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位）`
  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             ord`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 39`** (1 nodes): `发送配送通知                  Args:             openid: 配送员openid             task`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 40`** (1 nodes): `发送配送时效预警                  Args:             openid: 配送员openid             ta`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 41`** (1 nodes): `发送退款结果通知                  Args:             openid: 用户openid             ord`
  Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 42`** (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 3` to `Community 0`, `Community 1`, `Community 2`, `Community 4`, `Community 6`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 24`, `Community 25`?**
  _High betweenness centrality (0.112) - this node is a cross-community bridge._
- **Why does `success_response()` connect `Community 0` to `Community 3`, `Community 4`, `Community 6`, `Community 8`, `Community 9`, `Community 10`, `Community 12`, `Community 13`, `Community 20`?**
  _High betweenness centrality (0.038) - this node is a cross-community bridge._
- **Why does `generate_uuid()` connect `Community 1` to `Community 0`, `Community 2`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 13`, `Community 14`, `Community 15`, `Community 19`, `Community 20`, `Community 23`, `Community 24`, `Community 25`, `Community 26`?**
  _High betweenness centrality (0.034) - this node is a cross-community bridge._
- **Are the 1160 inferred relationships involving `str` (e.g. with `unhandled_exception_handler()` and `get_current_user_by_token()`) actually correct?**
  _`str` has 1160 INFERRED edges - model-reasoned connections that need verification._
- **Are the 827 inferred relationships involving `success_response()` (e.g. with `list_storage_release_reviews()` and `get_storage_release_review_detail()`) actually correct?**
  _`success_response()` has 827 INFERRED edges - model-reasoned connections that need verification._
- **Are the 725 inferred relationships involving `SysUser` (e.g. with `菜单 code 权限守卫（V0.3：通过 sys_user_role → sys_role_menu → sys_menu.perms）` and `运营端角色守卫：admin / super_admin 可访问。`) actually correct?**
  _`SysUser` has 725 INFERRED edges - model-reasoned connections that need verification._
- **Are the 696 inferred relationships involving `error_response()` (e.g. with `_json_error_response()` and `list_storage_release_reviews()`) actually correct?**
  _`error_response()` has 696 INFERRED edges - model-reasoned connections that need verification._