Appearance
金刚小程序前端模块
金刚小程序前端位于 storeui,基于 uni-app、Vue 2、Vuex 和 uView/uni-ui 组件体系。页面通过 src/pages.json 声明,接口请求集中在 src/api。
2026-07-19 本地核查:pages.json 共 181 个页面路由,其中主包 7 个页面,pages-staff 员工端分包 32 个页面,pages-dispatch 派单分包 15 个页面,pages-capital-flow 资金分包 16 个页面,pages-set 门店设置分包 13 个页面。
主包页面
| 页面 | 角色 | 说明 |
|---|---|---|
pages/home/index | 门店、运营辅助 | 首页入口,聚合常用业务入口、渠道、通知和门店相关能力。 |
pages/login/login | 全部用户 | 登录入口。 |
pages/staff/index | 门店、运营辅助 | 服务人员列表和人员管理入口。 |
pages/data-dashboard/index | 管理角色 | 数据大盘。 |
pages/dispatch/index | 历史业务处理角色 | 标准单历史普通页面和内部回退路径,不再作为底部 tab,也不是门店端开发单入口。 |
pages/sister-business/index | 特定业务角色 | 三嫂业务入口。 |
pages/my/index | 全部用户 | 个人中心、设置和账户相关入口。 |
重要分包
| 分包 | 主要职责 |
|---|---|
pages-staff | 员工端服务首页、我的、设置、服务记录、能力、签约、钱包、可服务时间、站点联系等。 |
pages-set | 门店管理、员工管理、服务项目、合同设置、印章、客服、系统续费和个人设置。 |
pages-home | 首页扩展功能,包括通知公告、签到、保险、体检、家政人广场等。 |
pages-home-sub | 首页补充功能,包括全部功能、开发单统计、素材和派发配置。 |
pages-aunt-resume | 阿姨简历、证件、技能、工作经历、照片、预览和 AI 录入。 |
pages-capital-flow | 资金流水、金币商城等财务或权益相关页面。 |
pages-sister-business | 三嫂业务合同、归属选择、模板和业务协作页面。 |
pages-other | 账户申请、易宝入网、海报等杂项流程。 |
pages-common | WebView、筛选页、地图、选择服务人员等通用页面。 |
同一个小程序同时承载门店端和员工端。门店端主要使用门店 token 和 internal_user 身份,员工端主要使用 staffToken 和 service_staff 身份;角色切换由 staff-auth.js、tokenManager、roleManager 和后端 staff-login 接口共同处理。
API 封装分组
| API 文件 | 业务含义 |
|---|---|
order.js、staff-order.js | 订单、员工订单和服务记录。 |
staff.js、staff-auth.js、staff-capability.js、staff-availability.js | 员工资料、认证、能力和可服务时间。 |
staff-wallet.js、withdrawal-account.js、payment.js | 员工钱包、提现账户和支付。 |
insurance.js、seal.js、contract 相关组件 | 保险、印章、合同签署或合同资料。 |
store-material.js、training.js | 培训素材和课程。 |
store-channel.js、store-share.js、platform-share.js | 门店渠道、分享和推广。 |
aunt-resume.js、aunt.js、ai-register.js | 阿姨档案、简历和 AI 录入。 |
dashboard.js、announcement.js、dict.js、common.js | 数据、公告、字典和通用能力。 |
页面改动注意事项
- 员工端顶部导航有历史安全区规则,不要把所有页面统一套同一套胶囊高度。
- 主包和分包受微信小程序包体、审核、兼容性影响,新增页面前要确认分包归属。
- 旧小程序包可能仍在线,后端接口变更需要保持兼容。
- 页面至少要覆盖加载、空态、错误、成功反馈和无权限状态。