总览

2022-09-06 12:43:58 星期二## 项目思维导图如下

点击查看幕客设计图

项目简介：

此插件试用于各种以时间占座的店铺，比如自习室、麻将馆、台球厅、ktv等等。因为设计图稿是以自习室而设计的，所以命名为‘自习室在线订座小程序’。如有特殊的要求需要二开，比如占座时更换为台球桌的图标，则就变成了台球厅在线订桌。此插件拥有独立的会员卡商城以及固定规则的占座机制。具体规则如下，已经历过多次测试，已具备上线能力。请放心购买。

店铺设定

1. 此插件可设置多店铺，并可以单独监测当前时间每个店铺入座情况。
UFMuQCcDJTgKWPOt291I/GSyPY1HJDMUUr8Apg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
2. 每个店铺都可设置多个区域，至少设置一个区域，可以设置为“大厅”
cyZCFwnpNmAjghxH5QzaOAY1EMHdOV3dNCIZLA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
3. 所有区域分为自定义座位区域，如果是自定义座位区域，那么就是同一定价。比如都设置成每半小时5储值点。
rVCTHKsyRxPYiuJtM7afnpmWApF8CtN/3aAmTg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
4. 如果是包厢区类型，那么可以设置单独的包厢订价，并可设置假的容纳人数。这种设定，就是为了那种订座一个包厢，实际购买人数就是一人，但是我就是直接占用整个包厢。这个包厢能容纳8人同时进去，这8人就是假的容纳人数。
eEIVxQLUSfvyDtblaoEUz9Q5rFp96QQf2WB4eQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

会员卡规则：

1. 商城有四种会员卡类型：储值卡、周期卡、次卡、小时卡。每种卡各自有独立的会员卡机制。
FIdteaRJkgfMlovcKHZWg6nx8mE/R7dh2Tlg8w==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
2. 储值卡：储值卡存储的值就是储值点，在店铺每个自定义座位区域或包厢区域都可设置每半小时消费储值点。这里注意是每半小时消费的储值点。比如每半小时消费5储值点，从1:00订座2:00就会消耗10储值点。
ajBFruwWsMpXnNeI4IXORMfNT4TyVNSsgNvuCQ==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
3. 周期卡：周期卡就相当于月卡、季卡、年卡。此卡可以规定时间内随意使用，没有储值点限制，但是有同一时间多次订座限制，还有同时订单存在限制。已防止有人给他人订座或恶意订座。
USJZQOqriXYTDhBRY3s0pQ01IpijNwpbGwcUpA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
4. 次卡：次卡好理解，就是购买完卡后里面有次数。比如有100次，订座一次后就削减一次。
sXpZeKnyEWqgSClILReQIUVYF/n92McJycHaww==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
5. 小时卡：小时卡就相当于一个卷，用完即失效，可设置时长，一旦使用即失效。
AJVTqbWeUocFChdw9Ax11sbr08Q1Icc9eBfTgg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
6. 开卡期：所有卡都有开卡期，单位（天），开卡期内未开卡则会员卡失效。如果不需要开卡期，就把开卡期设置成99999。
mOdYtXwzMfAsHPQvPJjct+78n+eAdClujLgd6A==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
7. 有效期：除了小时卡，其他卡都有有效期。有效期就是指的开卡后如果用户未开卡则会员卡失效。如果储值卡如果有100储值点，如果在90天(有效期)内没有使用完，那么在90天后，会员卡就会失效。
lfTxPeoOdguLHaymFrcYPF6kpvN09gBgkeMnCg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
8. 权限：每种卡都可设置权限，此权限为使用权限，是以区域而划分的。如果会员卡没有设置“某某区”的使用权限，那么在“某某区”是使用不了这张卡的。注意：会员卡所有设定必须在用户购买前设定，用户购买完卡后就会自动生成给用户一张会员卡，后期不好更改。
ZaLJVhkwQBHMUlDyiMtdKMLQ6w3mztXnKkMaXg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

订座规则

1. 店铺分为24小时营业和时间段营业，分时间段营业就是比如早7:00至晚8:00，如果是24小时营业制那么就是0:00至23:30
PJAoIUtYXTlSapzuZ34Ksm3+9t7rH/hmFLlv+g==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
2. 订座为预定机制，必须选择整点或整点半，比如2:00、2:30、3:00、3:30，如果有特殊需求请二开。
LnCXycQIxpgPHZztTfTJ5rDjIFR8hY1B7bKsbw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
3. 订座时选择符合要求的会员卡，如果选择的会员卡没有开卡，则会自动开卡。
SrUklLQjThgMIZtJNB1a1Bp3lyL6vw5p1GaATA==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

签到规则

1. 后台设定签到距离，精准定位，用户到达指定范围内打开小程序签到。
jbSUtJHMdZmQKogC8ZWnM5YIUBj1VgHih5HRSg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

定时任务

项目有三个定时任务，需要在服务器上设置定时任务，分别是

测试定时任务 /api/placeholder.crontab/test

更新用户的会员卡 /api/placeholder.crontab/setUserCard

判断入座订单 /api/placeholder.crontab/setUserOrder

测试定时任务仅供测试使用，上线后请勿部署，具体请看接口文档

自动退订和手动退订机制

1. 用户如果未签到，则会自动开始入座，入座后还可以签到。周期卡入座30分钟未签到就会将订单取消，储值卡和次卡入座后60分钟未签到，就会扣除一个小时费用，并且将订单取消。小时卡订座60分钟未签到，也会将订单取消，并且将会将小时卡失效。
YysjNmeSaQJZEIWhbsprr4/WYpTeJmw03dQUBw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
2. 可设置短信通知，情景一：“《座位号》现在可以签到啦。”（注：在后台可设置提前通知时间）。情景二：“《座位号》距离结束时间仅剩10分钟”（注：在后台设置提前通知时间）。情景三：“"限30分钟内签到入座,此订单10分钟后将自动取消'”（注：在后台设置提前通知时间）。情景四：“到达预定时间,订单正常结束!。”
LgWZsuAKtDkIGyVma4mkis0NQEPGFEV7pvdeQg==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。
3. 在订单开始前可手动退订，免费退订的条件是在购买5分钟之内或者入座30分钟之前，满足任一条件即可。储值卡退相应储值点，次卡退回一次，小试卷自动设置成未使用状态。如果不满足条件也可以退，不过就要扣除半小时费用，次卡扣一次，小时卡直接失效无法使用。
JitnWZQvMFyRIlwq0DuhX9LOXolGqXZw0DNXDw==著作权归作者所有，未经许可，禁止转载、复制此文档的任何内容。

提前结账

订单开始后可提前结账走人，不足半小时按半小时结算，如果使用了一小时零15分钟，那么就按一个半小时结算。

此插件所依赖插件