cykj/zkxw

0 Fork 0

Files

T

zlwuandCursor ac8e471aca fix: align sample registration, freight scope, and OA datetime display

Let customer-service quick register write storage, certificate, and insurance separately without extra menu or data-scope checks. List freight by document data scope like the web admin, allow protocol staff outside the collection region, and pad OA datetimes to seconds so PC date pickers can show historical minute values.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-10-20 17:30:30 +08:00

21 KiB

Raw Blame History

Graph Report - app (2026-10-20)

Corpus Check

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

Summary

6373 nodes · 35339 edges · 42 communities detected
Extraction: 32% EXTRACTED · 68% INFERRED · 0% AMBIGUOUS · INFERRED: 24180 edges (avg confidence: 0.6)
Token cost: 0 input · 0 output

God Nodes (most connected - your core abstractions)

success_response() - 830 edges
SysUser - 733 edges
error_response() - 699 edges
BizQcTaskResult - 388 edges
BizProductionMaterial - 372 edges
BizProductionMaterialUsage - 365 edges
BizQcMaterialUsage - 363 edges
BizQcMaterial - 353 edges
BizProductionMaterialStockBatch - 352 edges
BizMaterialUsage - 349 edges

Surprising Connections (you probably didn't know these)

统一记录 API 请求/响应出入参的中间件 --uses--> SysApiRequestLog [INFERRED] core/api_request_log_middleware.py → models/models.py
菜单 code 权限守卫（V0.3：通过 sys_user_role → sys_role_menu → sys_menu.perms） --uses--> SysUser [INFERRED] core/menu_guard.py → models/models.py
运营端角色守卫：admin / super_admin 可访问。 --uses--> SysUser [INFERRED] core/menu_guard.py → models/models.py
读取用户授权的菜单权限标识集合（与前端 meta.menuCode / perms 对齐）。 --uses--> SysUser [INFERRED] core/menu_guard.py → models/models.py
判断用户是否拥有指定权限码（不拦截请求，用于字段/按钮级能力控制）。 --uses--> SysUser [INFERRED] core/menu_guard.py → models/models.py

Communities

Community 0 - "Community 0"

Cohesion: 0.01 Nodes (1187): _assert_user_tenant_access(), attachment_download_url(), create_dept(), create_dict_data(), create_dict_type(), create_express_company(), create_item_unit(), create_menu() (+1179 more)

Community 1 - "Community 1"

Cohesion: 0.01 Nodes (882): validate_ymd(), BaseSettings, Config, secret_key_must_be_strong(), Settings, generate_uuid(), delete(), get_multi_with_filters() (+874 more)

Community 2 - "Community 2"

Cohesion: 0.01 Nodes (607): BatchPaymentIdsBody, BatchSubmitReceiptBody, BatchSubmitRefundBody, ConfirmReceiptBody, ConfirmRefundBody, PaymentIdBody, SubmitReceiptBody, SubmitRefundBody (+599 more)

Community 3 - "Community 3"

Cohesion: 0.05 Nodes (528): 环境检测 — 检测项维护 + 登记管理 API, InsuranceCompanyCreateBody, InsuranceCompanyInvoiceCreateBody, InsuranceCompanyInvoiceUpdateBody, InsuranceCompanyUpdateBody, InsuranceProjectPriceCreateBody, InsuranceProjectPriceUpdateBody, 保险公司及险种价格管理 API（保险公司 + 开票信息 + 险种价格） (+520 more)

Community 4 - "Community 4"

Cohesion: 0.01 Nodes (420): _normalize_date_bound(), _persist_protocol_sub_resources(), assert_protocol_status_transition(), build_void_type_label_map(), format_protocol_status_label(), 状态流转被拒绝时的提示，状态码展示为中文名称。, resolve_void_type_label(), status_transition_denied_message() (+412 more)

Community 5 - "Community 5"

Cohesion: 0.05 Nodes (457): CellSampleTypeCreateBody, CellSampleTypeUpdateBody, CollectionRegionCreateBody, CollectionRegionUpdateBody, CustomerCreateBody, CustomerUpdateBody, HospitalCreateBody, HospitalUpdateBody (+449 more)

Community 6 - "Community 6"

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

Community 7 - "Community 7"

Cohesion: 0.02 Nodes (194): 小程序鉴权：微信登录 / 绑定 openid。, 当前用户是否已绑定微信服务号 openid。, 服务号网页授权 code 绑定当前用户（需 Bearer）。, 微信登录：openid 已绑定时可静默换票；否则须授权手机号且与账号 phone_no 一致。, 密码登录后绑定当前微信 openid（需 Bearer）。, web_qr_confirm(), web_qr_scanned(), 公共接口（Web 登录、刷新 Token、登出；用户模型对齐 docs/sql/zkxw.sql 基线） (+186 more)

Community 8 - "Community 8"

Cohesion: 0.02 Nodes (215): eq_unicode(), like_unicode(), MySQL 字符串比较/模糊匹配时统一排序规则，避免 Illegal mix of collations。, 跨表字符串等值比较（JOIN / WHERE）时统一为 utf8mb4_unicode_ci。, 将列显式设为 utf8mb4_unicode_ci。, unicode_ci(), batch_review(), _dec() (+207 more)

Community 9 - "Community 9"

Cohesion: 0.02 Nodes (184): _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_products_batch() (+176 more)

Community 10 - "Community 10"

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

Community 11 - "Community 11"

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

Community 12 - "Community 12"

Cohesion: 0.03 Nodes (131): list_ethnics_for_select(), _leave_local_callback(), apply_data_scope(), _build_tree(), _cascade_soft_delete(), _collect_with_ancestors(), get_dept(), list_depts() (+123 more)

Community 13 - "Community 13"

Cohesion: 0.04 Nodes (96): 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() (+88 more)

Community 14 - "Community 14"

Cohesion: 0.06 Nodes (72): create_sample_freight(), delete_sample_freight(), _get_current_user_id(), get_sample_freight(), _get_tenant_no(), link_sample_freight(), list_sample_freight_options(), list_sample_freights() (+64 more)

Community 15 - "Community 15"

Cohesion: 0.08 Nodes (56): aggregate_slot_stats_by_facility(), _apply_slot_select_base_filters(), _apply_slot_select_query_filters(), batch_create_facilities(), batch_create_slots(), _build_node_path_cache(), _build_slot_keyword_sql_filters(), collect_descendant_ids() (+48 more)

Community 16 - "Community 16"

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

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

Cohesion: 0.12 Nodes (30): join_equipment_ids(), parse_equipment_ids(), 工艺/步骤设备多选：逗号分隔 ID 与名称快照解析, 校验设备列表，返回 (equipment_ids 逗号串, equipment_name 逗号串快照)。, resolve_equipment_list_snapshot(), add_step(), copy_step(), _create_step_consumable() (+22 more)

Community 19 - "Community 19"

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

Cohesion: 0.14 Nodes (26): _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() (+18 more)

Community 21 - "Community 21"

Cohesion: 0.14 Nodes (11): apply_formulas_and_linkages(), eval_formula(), _extract_rules(), preprocess_formula(), OA 表单公式与数据联动（禁止任意 eval）, 按 schema 中字段 props.formula / props.linkage 回填 form_data。 linkage 示例: { "when, 将 {field} 转为合法标识符引用 field。, _SafeEval (+3 more)

Community 22 - "Community 22"

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

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

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

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

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

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

Cohesion: 0.29 Nodes (2): BaseModel, SoftDeleteModel

Community 29 - "Community 29"

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

Community 30 - "Community 30"

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

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 (1): 转正套件：入职日 + 试用期月数 → 建议转正日（YYYY-MM-DD）。

Community 33 - "Community 33"

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

Community 34 - "Community 34"

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

Community 35 - "Community 35"

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

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 ord

Community 40 - "Community 40"

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

Community 41 - "Community 41"

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

Community 42 - "Community 42"

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

Community 43 - "Community 43"

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

Knowledge Gaps

211 isolated node(s): 刷新会话 TTL（refreshToken 续期；已登录用户每次 API 校验通过后滑动续期）, 写入 refreshToken（用于 one-time 使用/吊销）, 根据 token 获取当前用户（包含 Redis 会话校验；会话滑动续期）, 严格判断当前租户用户是否拥有指定移动市场权限码。, 为移动市场 API 提供租户化、精确匹配的菜单权限依赖。 (+206 more) These have ≤1 connection - possible missing edges or undocumented components.
Thin community Community 28 (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): 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 33 (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 34 (2 nodes): context.py, 请求级别的用户上下文变量通过 contextvars 在请求处理链路中传递当前用户信息，供 SQLAlchemy 事件监听器等底层机制使用，避免逐层手动传 Too small to be a meaningful cluster - may be noise or needs more connections extracted.
Thin community Community 35 (2 nodes): __init__.py, API 路由包（骨架：公共鉴权 + 静态菜单 + 运营端占位） 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 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 task Too small to be a meaningful cluster - may be noise or needs more connections extracted.
Thin community Community 41 (1 nodes): 发送配送时效预警 Args: openid: 配送员openid ta Too small to be a meaningful cluster - may be noise or needs more connections extracted.
Thin community Community 42 (1 nodes): 发送退款结果通知 Args: openid: 用户openid ord Too small to be a meaningful cluster - may be noise or needs more connections extracted.
Thin community Community 43 (1 nodes): 发送催单通知给配送员 Args: deliver_openid: 配送员openid Too small to be a meaningful cluster - may be noise or needs more connections extracted.

21 KiB Raw Blame History Unescape Escape