微信小程序体系需求文档

负责人：前端程序员
运行环境：微信小程序（iOS / Android）
文档类型：基础业务需求梳理
适用对象：产品、前端、后端、测试、运营

1. 背景与目标

无人值守连锁健身房的一线业务需要同时覆盖两类移动端角色：

客户端小程序：面向普通会员与潜在用户，承接登录、购卡、录脸、查权益、使用服务等用户链路
店长端小程序：面向店长和值班店员，承接移动巡店、经营数据查看、远程协助开门等门店运营链路

小程序需求拆分为两套独立资料目录，避免用户端和门店运营端能力混写，便于设计、开发和验收。

2. 文档结构

端别	目录	说明
客户端小程序	./mini-program/client/	保留现有会员端能力，承接用户全流程
店长端小程序	./mini-program/manager/	承接店长运营端能力和门店管理动作

3. 客户端小程序范围

客户端小程序继续覆盖以下核心模块：

微信登录与账号初始化
首页、门店浏览、营销活动、动作库
套餐购买、会员权益、订单查询
人脸录入与重录
淋浴服务、外部券码核销、个人中心

详细资料见：

4. 店长端小程序范围

店长端小程序聚焦门店一线移动运营，包含以下能力：

微信登录与店长/店员身份校验
经营数据看板与统计报表分析
远程控制开门与操作留痕

详细资料见：

5. 双端协同原则

5.1 账号与权限

两端均使用微信身份登录
客户端按会员身份访问业务
店长端按员工身份访问业务，并由服务端返回门店权限、角色和可操作范围

5.2 数据口径

用户权益、订单、入场资格、门禁设备状态均以服务端为准
店长端报表默认按“门店维度”统计，支持同一账号切换已授权门店
涉及营收的财务口径以服务端结算结果为准，日报表允许近实时展示、T+1 校正

5.3 设备控制

任一小程序均不直接与门锁硬件通信
所有门禁、淋浴等控制动作均由云端 API 转发给工控机执行
店长端的远程开门必须记录操作人、门店、设备、原因、结果和时间

5.4 范围边界

店长端不承载完整后台配置能力
多门店经营分析以“已授权门店查看”为主，不替代总部管理后台
审批流、排班、消息群发、复杂工单等能力未纳入当前范围