金刚后端模块

金刚后端位于 storeapi，基于 FastAPI，业务代码主要在 module_admin/controller 和 module_admin/service。接手时应优先按 controller 定位入口，再进入 service 看业务规则。

模块分组

分组	典型 controller/service	职责
认证与用户	auth_controller、user_controller、internal_login_controller、role_controller、menu_controller	登录、用户、角色、菜单、内部账号和权限。
员工与门店	staff_controller、store_controller、staff_capability_controller、staff_availability_controller、staff_station_contact_controller	员工资料、门店资料、能力、档期、站点联系和服务人员管理。
订单与履约	order_controller、staff_order_controller、standard_staff_dispatch_service、standard_order_operation_service	订单查询、员工订单、标准单派发、履约记录和状态推进。
合同与签约	contract_controller、contract_resign_controller、contract_supply_controller、agreement_signature_controller	合同资料、续签、补充合同、签名和签约记录。
保险	insurance_controller、insurance_payment_controller、picc_insurance_controller、new_employment_insurance_controller	保险购买、支付、保单、到期监听和保险供应商对接。
支付与分账	payment_controller、yeepay_innet_controller、yeepay_plate_controller、yeepay_divide_controller、order_split_record_service	支付、易宝入网、平台账户、分账、结算和回调。
钱包与提现	staff_wallet_controller、withdrawal_account_controller、staff_withdrawal_payout_service	员工钱包、提现账户、提现打款和通知。
阿姨与招聘	aunt_controller、aunt_resume_service、store_recruit_controller、recruit_controller	阿姨档案、简历、招聘、海报和素材。
培训与素材	training_controller、public_training_controller、store_material_controller	培训课程、公开培训和门店素材。
数据与通知	data_dashboard_controller、announcement_controller、webhook_notification_service、wechat_work_notify_service	数据看板、公告、企微和通知。
系统工具	config_controller、dict_controller、file_controller、common_controller、job_controller、log_controller	配置、字典、文件、通用接口、任务和日志。

Controller 到 Service 的阅读方式

1. 先在 server.py 找 controller 是否注册。
2. 打开 controller，看路由前缀、权限、入参和返回结构。
3. 找同名或相近 service，看事务、状态判断、第三方调用和异常处理。
4. 找 entity/do 或 model，看落库字段和状态枚举。
5. 找前端 storeui/src/api，确认页面实际怎么调用。

状态和金额类改动

订单、钱包、分账、提现、保险和合同属于高风险模块。改动时必须确认：

• 是否会重复执行。
• 是否影响历史数据。
• 是否需要人工补偿或对账。
• 是否兼容旧小程序包。
• 是否需要运营或财务同步口径。

不纳入本次交接的链路

小羽佳订单协同链路后续计划删除，不在本页展开。接手人后续如需要恢复或重建，应以新业务方案为准，不沿用旧链路细节。