Skip to content

金刚系统技术模块目录 ​

本页按 storeui 和 storeapi 的真实目录整理金刚系统模块。接手时先按业务域定位,再查对应页面、API、controller、service 和表组。

如果要按角色阅读完整小程序能力,先看:

模块总览 ​

当前代码规模按 2026-07-19 本地扫描记录:

项目规模接手意义
小程序页面路由storeui/src/pages.json 共 181 个页面路由,含 7 个主包页面和 4 个底部 tab;门店端开发单位于首页补充分包,pages/dispatch/index 仅保留为历史普通页和内部回退路径。先按分包定位业务域,不要在全局搜索里直接改同名页面。
小程序 API 封装storeui/src/api 覆盖门店、员工、合同、保险、钱包、积分、易宝、素材、培训等接口域。前端页面通常不直接写完整 URL,先查对应 API 封装。
后端注册路由storeapi/server.py 当前注册 115 个 router。后端 controller 数量大,优先按 tag/前缀定位,再追 service。
核心生产数据公司 662、门店 487、门店账号 739、服务人员 2925、订单 1515、客户 2198、合同 1434、保险记录 1652。门店、员工、合同、保险是已经有生产沉淀的链路,修复前必须只读核验影响范围。
新标准单沉淀staff_service_capability 41 条、staff_platform_product 219643 条、standard_staff_service_region 97 条、standard_staff_score_account 41 条;staff_wallet_account、standard_staff_dispatch_attempt、standard_order_settlement_task、通知 outbox 当前为 0 条。员工能力和产品绑定已有数据,真实派发、通知、结算和员工钱包流水尚未形成生产沉淀,放量时要重点看任务和配置。
业务域小程序入口API 封装后端 controller主要 service主要表组
登录与身份pages/login、pages-login-aux、pages-staff/homeauth.js、staff-auth.js、user.jsauth_controller.py、service_staff_login_controller.py、internal_login_controller.pyauth_service.py、service_staff_login_service.py、internal_user_login_service.pyinternal_user、service_staff、internal_login_record
首页与角色切换pages/home、pages/my、components/role-switchercommon.js、dashboard.js、announcement.jscommon_controller.py、data_dashboard_controller.py、announcement_controller.pycommon_service.py、data_dashboard_service.py、announcement_service.pysys_config、content_banner、store_notice
订单履约pages-dispatch、pages-staff/service/record.vue、pages-common/select-server-personorder.js、staff-order.js、payment.jsorder_controller.py、staff_order_controller.py、payment_controller.py、order_evaluation_controller.pyorder_service.py、staff_order_service.py、payment_service.py、order_evaluation_service.pyorder、order_details、order_logs、order_waiter
全国标准单pages-staff/home/index.vue、pages-staff/availability、pages-staff/capability、pages-staff/walletstaff-availability.js、staff-capability.js、staff-wallet.js、staff-order.jsinternal_standard_order_ops_controller.py、staff_availability_controller.py、staff_capability_controller.py、staff_wallet_controller.pystandard_staff_dispatch_service.py、standard_order_operation_service.py、standard_order_settlement_service.py、standard_order_notification_service.pystandard_staff_*、standard_order_*、staff_wallet_*
员工管理pages/staff、pages-staff/edit.vue、pages-staff/apprentice、pages-staff/station-contactstaff.js、staff-apprentice.js、staff-station-contact.jsstaff_controller.py、staff_apprentice_controller.py、staff_station_contact_controller.pystaff_service.py、staff_management_service.py、staff_apprentice_service.py、staff_station_contact_service.pyservice_staff、service_staff_ext、staff_mentor_*
员工服务能力pages-staff/capability/index.vue、pages-staff/availability/index.vuestaff-capability.js、staff-availability.jsstaff_capability_controller.py、staff_availability_controller.pystaff_capability_service.py、staff_availability_service.py、standard_staff_schedule_service.pystaff_service_capability、standard_staff_service_region、staff_rest_date
员工钱包与提现pages-staff/wallet/index.vue、pages-staff/select-account.vue、pages-staff/yeepay-innetstaff-wallet.js、withdrawal-account.js、yeepay-innet.jsstaff_wallet_controller.py、withdrawal_account_controller.py、yeepay_innet_controller.pystaff_wallet_service.py、staff_withdrawal_payout_service.py、withdrawal_account_service.py、yeepay_innet_service.pystaff_wallet_account、staff_wallet_ledger、staff_withdrawal_application、yeepay_innet_record
门店与公司pages-set/storeManagement、pages-set/staffManagementstore.js、staff.jsstore_controller.py、company_controller.py、internal_user_controller.pystore_service.py、company_service.py、internal_user_service.pystore、store_info、company、internal_user
门店积分pages-home/sign-in、pages-capital-flow 部分入口lead-dispatch-config.js、common.jsstore_score_controller.py、lead_pricing_controller.py、lead_dispatch_appeal_controller.pystore_score_service.py、jiejie_alliance_lead_dispatch_service.py、lead_pricing_service.pystore_score_*、store_lead_dispatch_*
门店钱包与收款pages-capital-flow、pages-other/yeepay-innetpayment.js、withdrawal-account.js、yeepay-innet.jsstore_payment_controller.py、payment_controller.py、yeepay_plate_controller.py、yeepay_divide_controller.pystore_payment_service.py、payment_service.py、store_wallet_service.py、yeepay_split_service.pystore_wallet_*、store_payment_order、company_transaction、yeepay_*
合同pages-agreement、pages-set/contractSetting、pages-sister-business/contract-templatessister-business.js、payment.js、common.jscontract_controller.py、contract_supply_controller.py、contract_resign_controller.py、agreement_signature_controller.pycontract_service.py、contract_supply_service.py、contract_word_export_service.py、agreement_signature_service.pycontract、contract_supply、contract_payment、contract_signature
保险pages-home/insurance、pages-insurance、pages-staff/insurance-purchase.vueinsurance.jsinsurance_controller.py、insurance_payment_controller.py、picc_insurance_controller.py、insurance_surrender_document_controller.pyinsurance_service.py、insurance_payment_service.py、picc_insurance_service.py、insurance_surrender_document_service.pyinsurance_*、contract_insurance、alipay_anxin_*
产品与工种pages-set/serviceProjects、pages-home/product-list.vueproduct.js、skill.jsproduct_controller.py、skill_controller.pyproduct_service.py、platform_product_service.py、staff_skill_service.pyproduct、product_sku、service_skill、platform_product
简历与阿姨资料pages-aunt-resume、pages-staff/resume*、pages-staff/ai-aunt-chat.vueaunt.js、aunt-resume.js、ai-register.jsaunt_controller.py、platform_aunt_controller.py、resume_share_controller.py、public_ai_aunt_controller.pyaunt_service.py、aunt_resume_service.py、resume_share_service.py、public_ai_aunt_match_service.pyaunt、aunt_detail、aunt_certificate、resume_share_validity
培训与内容pages-home/train-online.vue、pages-home/announcementtraining.js、announcement.jstraining_controller.py、public_training_controller.py、announcement_controller.pytraining_service.py、announcement_service.pytraining_*、college_*、content_banner
素材、海报和分享pages-staff/development-poster、pages-other/haibao、pages-sharestore-material.js、platform-share.js、store-channel.jsstore_material_controller.py、store_recruit_controller.py、store_share_controller.py、platform_share_controller.pystore_material_service.py、store_recruit_service.py、store_share_application_service.py、platform_share_service.pystore_material_*、store_recruit_*、platform_share_membership
数据看板与工具pages/data-dashboard、pages-home/assessment-result.vuedashboard.js、customer-insight.jsdata_dashboard_controller.py、customer_insight_controller.py、public_customer_insight_controller.pydata_dashboard_service.py、customer_insight_service.pycustomer_insight、daily_points_grant_record

后端启动和路由注册 ​

storeapi/server.py 是金刚后端主入口。它负责:

  1. 初始化数据库、Redis、异常处理、CORS 和静态资源。
  2. 注册 module_admin/controller 下的 controller。
  3. 初始化系统调度器。
  4. 在云函数环境中承接小程序、内部任务、第三方回调和公开接口。

所有新增业务接口都应遵循现有结构:

层级规范
controller只负责鉴权、参数接收、调用 service、返回统一响应。
service负责事务、业务规则、第三方调用、状态变更和日志。
dao/entity/vo有现成模型时复用,没有必要时可用 SQLAlchemy text 查询,但必须保持事务边界清楚。
scripts/module_task需要后台补偿、批处理、日结、超时处理时放到任务入口,不依赖请求结束后的后台线程。

小程序页面边界 ​

分区说明
主包 pages/*home 首页、staff 服务人员、data-dashboard 数据大盘、dispatch 历史标准单普通页面、sister-business 三嫂业务、my 我的。
pages-staff员工端核心分包,包含服务首页、我的、接单、服务记录、能力、档期、钱包、签名、入驻、入网、发展海报和队员管理。
pages-set门店设置、门店管理、员工管理、服务项目、合同设置、资质、公章和个人设置。
pages-capital-flow余额、充值、对公充值、提现、提现账户、易宝入网、收款码、积分商城相关页面。
pages-dispatch门店到家订单详情、编辑、新建预约、派工、收服务费、自动化设置、补价和保险入口。
pages-agreement合同列表、新增、编辑、搜索、合同组件。
pages-sister-business三嫂客户、线索、合同、保险、家务清单等旧业务页面;保单入口仍从首页复用,但小羽佳订单协同旧链路不在本次交接展开。
pages-insurance理赔、报案、退保材料。
pages-aunt-resume阿姨简历资料、AI 录入、预览、分享封面。
pages-home / pages-home-sub公告、家政人广场、体检、线上培训、全部功能、开发单统计、派发配置、素材。

身份和入口判定 ​

同一个 storeui 小程序里同时承载门店端和员工端,不是两个独立应用。

判定点门店端员工端
tokentokenstaffToken
当前角色currentRole = storecurrentRole = staff
登录主表internal_userservice_staff
登录校验接口/api/v1/internal-login/getInfo/api/v1/staff-login/getinfo
切换接口/api/v1/staff-login/switch-to-store/api/v1/staff-login/switch-account
入口页面主包 pages/home/index.vue、pages/my/index.vue分包 pages-staff/home/index.vue、pages-staff/home/my.vue

排查登录和入口错乱时,先看 tokenManager.getCurrentRole() 和本地是否同时有门店 token、员工 token。角色切换由 roleManager 调用后端换 token,再清理当前角色缓存;不要只改页面跳转。

核心链路定位 ​

订单履约 ​

  1. 小程序从订单列表、员工服务首页或服务记录页进入。
  2. storeui/src/api/order.js、staff-order.js 调用后端。
  3. order_controller.py、staff_order_controller.py 进入 order_service.py、staff_order_service.py。
  4. 主状态在 order,过程日志在 order_logs,员工关系看 order_waiter 或订单员工字段。
  5. 支付相关同时查 order_payments、store_payment_order、ccuser_transaction。

全国标准单自动交付 ​

  1. 平台标准产品在云平台配置,金刚后端按平台产品、员工能力、区域、档期和积分计算候选。
  2. 待派发订单由 standard_staff_dispatch_pending 任务处理。
  3. 员工确认超时由 standard_staff_dispatch_timeout 任务处理。
  4. 服务完成后由 standard_order_settlement_process 生成服务奖金结算。
  5. 通知由 standard_order_notification_process 消费 outbox。

关键常量和规则:

项值或规则
平台标准单虚拟门店PLATFORM_STANDARD_STORE_UUID = pQrS6tUvwx,名称“金刚到家”。
平台标准单业务模式business_mode = PLATFORM_STANDARD_SOURCE。
历史门店订单业务模式business_mode = LEGACY。
城市口径新标准单统一进入门店端家政广场,不按原员工池城市灰度筛选;厦门订单同样进入广场。
候选范围普通全国派发按区县、城市、省、全国兜底;金刚下单端内部派发只按区县和城市,不自动扩大到省/全国。
候选排序SCORE_WAITING、SCORE_ONLY、RANK_ONLY 三种,默认积分加等待天数。

门店订单和员工履约状态口径 ​

历史订单和标准单状态都落在 order.order_status,但页面和老 DAO 中存在兼容口径。接手时按业务模式判断,不要混用。

状态码标准单/员工端含义备注
10已接单生产库中仍有历史数据。
20派单待确认员工可接单或拒单。
30拒绝接单标准单拒单后会触发候选顺延。
40已派单员工确认后进入待服务。
50执行中员工前往或执行准备中。
60开始服务已上传服务前凭证并开始。
70服务结束兼容旧流程,后续可到完成。
80已完成会触发档期释放、结算任务、开发奖金任务等后续动作。
90已评价/历史完成态生产库中状态名多为“已完成”。
99已取消取消时还要同步支付、需求广场、档期/库存和第三方通知。

真实库里存在少量“状态码和状态名不一致”的历史记录,例如 20/已派单、80/服务结束。排查时以状态码和日志为主,状态名只作展示参考。

合同保险 ​

  1. 合同购买、续费、换人、补充协议都先看 contract_*。
  2. 支付通过 payment_service.py 或合同支付回调处理。
  3. 保险投保记录看 insurance_record,合同和保险关联看 contract_insurance。
  4. 退保材料生成看 insurance_surrender_document 和退保操作日志。

钱包和分账 ​

  1. 门店钱包看 store_wallet_*,员工钱包看 staff_wallet_*。
  2. 易宝入网看 yeepay_innet_record,收款码看 yeepay_plate_qrcode。
  3. 分账、余额和回调失败要查 yeepay_notification_log 和业务流水。

不写入主线的旧模块 ​

仓库中仍存在 xyj_migration_controller.py、旧外部订单协同、colleague_order_*、xyj_order_* 相关代码和表。本次交接不展开这些细节,避免接手人误以为这是未来维护主线。

用于金刚项目内部协作、运营培训和客户说明。