zlwuandCursor
57487fd0dc
Persist payment before samples to avoid consuming sample codes on validation failure, soft-delete samples on create rollback, and surface DJ due-amount mismatch as a hint only. Co-authored-by: Cursor <cursoragent@cursor.com>
283 lines
20 KiB
Markdown
283 lines
20 KiB
Markdown
# Graph Report - app (2026-07-27)
|
||
|
||
## Corpus Check
|
||
- Large corpus: 227 files · ~283,122 words. Semantic extraction will be expensive (many Claude tokens). Consider running on a subfolder, or use --no-semantic to run AST-only.
|
||
|
||
## Summary
|
||
- 4823 nodes · 26699 edges · 40 communities detected
|
||
- Extraction: 31% EXTRACTED · 69% INFERRED · 0% AMBIGUOUS · INFERRED: 18332 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 36|Community 36]]
|
||
- [[_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]]
|
||
|
||
## God Nodes (most connected - your core abstractions)
|
||
1. `success_response()` - 715 edges
|
||
2. `error_response()` - 592 edges
|
||
3. `SysUser` - 559 edges
|
||
4. `BizQcTaskResult` - 336 edges
|
||
5. `BizProductionMaterial` - 326 edges
|
||
6. `BizProductionMaterialUsage` - 320 edges
|
||
7. `BizQcMaterialUsage` - 318 edges
|
||
8. `BizQcMaterial` - 308 edges
|
||
9. `BizProductionMaterialStockBatch` - 307 edges
|
||
10. `BizMaterialUsage` - 304 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
|
||
- `保留匹配节点及其全部上级，供关键词检索后仍能正确组树。` --uses--> `SysDept` [INFERRED]
|
||
crud/dept.py → models/models.py
|
||
- `物品单位 CRUD（biz_item_unit）` --uses--> `BizItemUnit` [INFERRED]
|
||
crud/item_unit.py → models/models.py
|
||
- `快递公司 CRUD（biz_express_company）` --uses--> `BizExpressCompany` [INFERRED]
|
||
crud/express_company.py → models/models.py
|
||
|
||
## Communities
|
||
|
||
### Community 0 - "Community 0"
|
||
Cohesion: 0.01
|
||
Nodes (954): attachment_download_url(), AttachmentDownloadUrlBody, create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu() (+946 more)
|
||
|
||
### Community 1 - "Community 1"
|
||
Cohesion: 0.01
|
||
Nodes (656): generate_uuid(), CRUDBase, allocate_next_biz_no(), _format_biz_no(), _prefix_for(), 业务协议号自动生成：XBCC / JZCC + YYYYMMDD + 6 位序号, 原子分配下一个业务协议号。 须在 create 事务内调用；使用 MySQL LAST_INSERT_ID 保证并发安全。, create_cell_sample_type() (+648 more)
|
||
|
||
### Community 2 - "Community 2"
|
||
Cohesion: 0.01
|
||
Nodes (625): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegionCreateBody, CollectionRegionUpdateBody, CustomerCreateBody, CustomerUpdateBody, HospitalCreateBody, HospitalUpdateBody (+617 more)
|
||
|
||
### Community 3 - "Community 3"
|
||
Cohesion: 0.06
|
||
Nodes (569): BatchRefundFinanceSubmitBody, 细胞存储 — 采集协议单 / 审核 / 财务确认 / 分期预警 API, 持久化协议子资源。 缴费（含明细校验）须在样本之前：明细校验失败时不得已占用样本编码。 各子表 CRUD 内部仍可能分段 commit，创建接, 与列表接口一致：按租户 + 角色数据权限判断是否可访问该协议单。, If mother info exists but no customerId, create a customer record and link it., RefundFinanceSubmitBody, Base, 细胞产品 CRUD（biz_cell_product） (+561 more)
|
||
|
||
### Community 4 - "Community 4"
|
||
Cohesion: 0.01
|
||
Nodes (313): _normalize_date_bound(), _persist_protocol_sub_resources(), list_ethnics_for_select(), apply_data_scope(), _get_child_dept_ids(), get_user_dept_id(), _resolve_user_role_scopes(), generate_id() (+305 more)
|
||
|
||
### Community 5 - "Community 5"
|
||
Cohesion: 0.02
|
||
Nodes (231): ApiRequestLogCRUD, delete(), get_multi_with_filters(), batch_options(), _batch_row_to_dict(), _fmt_date(), list_batches(), _batch_line_to_dict() (+223 more)
|
||
|
||
### Community 6 - "Community 6"
|
||
Cohesion: 0.02
|
||
Nodes (187): 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() (+179 more)
|
||
|
||
### Community 7 - "Community 7"
|
||
Cohesion: 0.02
|
||
Nodes (111): get_designer_data(), _error_json(), 数据库异常：返回 JSON 并保留 CORS 头，避免浏览器只报跨域错误, 未捕获异常：统一 JSON 500，确保跨域场景下仍有 Access-Control-Allow-Origin, sqlalchemy_exception_handler(), unhandled_exception_handler(), BaseHTTPMiddleware, ApiCryptoError (+103 more)
|
||
|
||
### Community 8 - "Community 8"
|
||
Cohesion: 0.02
|
||
Nodes (159): format_date(), join_equipment_ids(), parse_equipment_ids(), 工艺/步骤设备多选：逗号分隔 ID 与名称快照解析, 校验设备列表，返回 (equipment_ids 逗号串, equipment_name 逗号串快照)。, resolve_equipment_list_snapshot(), _fmt_dt(), get_handover_by_schedule() (+151 more)
|
||
|
||
### Community 9 - "Community 9"
|
||
Cohesion: 0.04
|
||
Nodes (97): 发起前预览审批链（条件齐后解析最终路径与审批人）。, 兼容旧 GET：无 formData，含条件分支时多为待确定占位。, _find_latest_published(), list_oa_role_user_ids(), _active_user_id(), OA 审批人解析（不读 sys_role）, 按节点 approverConfig 解析处理人。 assigneeType: users | oa_roles | dept_leader | dir, resolve_assignees() (+89 more)
|
||
|
||
### Community 10 - "Community 10"
|
||
Cohesion: 0.05
|
||
Nodes (104): AccessLogCreateBody, AccessLogUpdateBody, CleanRoomCreateBody, CleanRoomUpdateBody, ExhibitionAppointmentCreateBody, ExhibitionAppointmentUpdateBody, list_storage_slot_stats(), OccupancyCreateBody (+96 more)
|
||
|
||
### Community 11 - "Community 11"
|
||
Cohesion: 0.05
|
||
Nodes (71): _avatar_url_field(), _build_current_user_payload(), _build_user_info_payload(), get_current_user_profile(), _jwt_user_payload(), logout(), 公共接口（Web 登录、刷新 Token、登出；用户模型对齐 docs/sql/zkxw.sql 基线）, Web 端登录用 RSA 公钥（PKCS#1 v1.5，与 JSEncrypt 一致） (+63 more)
|
||
|
||
### Community 12 - "Community 12"
|
||
Cohesion: 0.06
|
||
Nodes (70): 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() (+62 more)
|
||
|
||
### Community 13 - "Community 13"
|
||
Cohesion: 0.08
|
||
Nodes (51): auto_create_payment(), complete_application(), create_basic_experiment_sale_schedules(), create_infusion_plan(), create_schedule(), _create_schedule_products(), _format_yyyy_mm_dd(), _generate_application_no() (+43 more)
|
||
|
||
### Community 14 - "Community 14"
|
||
Cohesion: 0.11
|
||
Nodes (39): _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() (+31 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.16
|
||
Nodes (22): _code_exists(), create_material(), _dec(), _fmt_dt(), get_material(), get_material_entity(), get_my_usages(), _is_enabled_status() (+14 more)
|
||
|
||
### Community 17 - "Community 17"
|
||
Cohesion: 0.21
|
||
Nodes (20): _body_to_payload(), _get_current_user_id(), get_production_reception_detail(), _get_tenant_no(), post_production_reception(), put_production_reception(), _resolve_reception_id(), _apply_payload_to_row() (+12 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.25
|
||
Nodes (18): _amount_for_row(), _batch_map(), _display_remark(), _fmt_date_val(), list_stock_check_requisitions(), list_usages(), _list_usages_query(), mark_requisition_fully_used() (+10 more)
|
||
|
||
### Community 20 - "Community 20"
|
||
Cohesion: 0.24
|
||
Nodes (16): count_fillable_fields(), _extract_rules(), index_condition_fields(), _node_type(), normalize_use_in_condition_required(), publish_app(), field -> rule（仅 useInCondition 且 type 合格）, 就地/深拷贝皆可：打标字段强制 required/$required。发布前调用。 (+8 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.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 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.27
|
||
Nodes (11): _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), create_dept(), get_dept(), list_depts(), list_depts_tree(), 保留匹配节点及其全部上级，供关键词检索后仍能正确组树。 (+3 more)
|
||
|
||
### Community 26 - "Community 26"
|
||
Cohesion: 0.29
|
||
Nodes (2): BaseModel, SoftDeleteModel
|
||
|
||
### Community 27 - "Community 27"
|
||
Cohesion: 0.38
|
||
Nodes (6): derive_legacy_status_from_three(), derive_three_status_from_legacy(), 阶段A兼容：从旧 status 推导三字段。 约束：旧 status 本身混合了支付/配送/订单生命周期，因此只能尽力推断； 若业务侧已有更精确, 阶段A兼容：从三字段反推旧 status（用于旧前端/旧筛选参数兼容）。, ThreeStatus, _to_decimal()
|
||
|
||
### Community 28 - "Community 28"
|
||
Cohesion: 0.5
|
||
Nodes (3): BaseSettings, Config, Settings
|
||
|
||
### Community 29 - "Community 29"
|
||
Cohesion: 0.5
|
||
Nodes (2): _auto_fill_create_dept_id(), ORM before_insert 钩子：当 create_dept_id 为空时，自动从请求上下文填充当前用户部门 ID
|
||
|
||
### Community 30 - "Community 30"
|
||
Cohesion: 0.67
|
||
Nodes (2): get_menu_list(), 运营端菜单接口（与 web-admin 前端静态路由 sqxp.ts 对齐，5 个一级菜单分组）
|
||
|
||
### 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
|
||
- **137 isolated node(s):** `刷新会话 TTL（refreshToken 续期；已登录用户每次 API 校验通过后滑动续期）`, `写入 refreshToken（用于 one-time 使用/吊销）`, `根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）`, `登录凭据 RSA 解密（与前端 JSEncrypt PKCS#1 v1.5 兼容）。`, `加载 RSA 密钥对：优先环境变量，否则使用内置固定默认密钥。` (+132 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 29`** (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 30`** (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 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 5`, `Community 6`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 14`, `Community 16`, `Community 19`, `Community 23`, `Community 24`?**
|
||
_High betweenness centrality (0.122) - this node is a cross-community bridge._
|
||
- **Why does `success_response()` connect `Community 0` to `Community 2`, `Community 4`, `Community 7`, `Community 10`, `Community 11`, `Community 12`, `Community 17`, `Community 30`?**
|
||
_High betweenness centrality (0.053) - this node is a cross-community bridge._
|
||
- **Why does `generate_uuid()` connect `Community 1` to `Community 0`, `Community 2`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 7`, `Community 8`, `Community 9`, `Community 10`, `Community 11`, `Community 12`, `Community 14`, `Community 16`, `Community 17`, `Community 18`, `Community 23`, `Community 24`, `Community 25`?**
|
||
_High betweenness centrality (0.044) - this node is a cross-community bridge._
|
||
- **Are the 793 inferred relationships involving `str` (e.g. with `unhandled_exception_handler()` and `get_current_user_by_token()`) actually correct?**
|
||
_`str` has 793 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 714 inferred relationships involving `success_response()` (e.g. with `list_storage_release_reviews()` and `get_storage_release_review_detail()`) actually correct?**
|
||
_`success_response()` has 714 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 591 inferred relationships involving `error_response()` (e.g. with `_json_error_response()` and `list_storage_release_reviews()`) actually correct?**
|
||
_`error_response()` has 591 INFERRED edges - model-reasoned connections that need verification._
|
||
- **Are the 557 inferred relationships involving `SysUser` (e.g. with `数据权限过滤（V0.3：基于角色 data_scope 的查询级行级过滤） data_scope 值： 1 = 全部数据 2 = 本部门数据 3` and `从 SysUser 读取用户的 dept_id。`) actually correct?**
|
||
_`SysUser` has 557 INFERRED edges - model-reasoned connections that need verification._ |