42 lines
2.8 KiB
Markdown
42 lines
2.8 KiB
Markdown
# 课后评价与成长档案
|
||
|
||
入口：预约详情评价、个人中心「我的成长档案」、管理中心「课后评价」与会员档案「成长档案」。评价归属 booking 模块，档案归属 user 模块。共享契约在 `packages/shared/src/types/member-care.ts`。
|
||
|
||
## 产品口径
|
||
|
||
- 课程变为 COMPLETED 后即可评价，没有 24 小时截止。完成后 24 小时只提醒仍未评价的预约。
|
||
- 同一预约只能评价一次。提醒状态写在 Booking 上，定时任务原子领取；发送结果未知或失败不自动重发。
|
||
- 星级均分与 NPS 分开。NPS 只用可选的 0–10 推荐意愿（9–10 推荐者、0–6 贬损者），按中国自然月聚合并展示样本数。
|
||
- 教练私密笔记只在服务端过滤。课程批注必须属于该学员的已完成预约。
|
||
- 体测允许缺项，缺项不按 0 计算。累计课时含有效补录，里程碑为 10 / 30 / 50 节。
|
||
- 成长照片仅用于学员与馆主之间的档案，不用于公开宣传。学员本人授权或撤回，馆主不能代授权。误传或学员主动删除会同时删除数据库记录和 COS 对象。
|
||
|
||
## 部署配置
|
||
|
||
新增环境变量（见 `packages/server/.env.example`）：
|
||
|
||
| 变量 | 作用 |
|
||
| --- | --- |
|
||
| `WX_SUBSCRIBE_TEMPLATE_CLASS_REVIEW` | 课后评价订阅消息模板 ID |
|
||
|
||
成长照片与馆图共用 `COS_BUCKET`、`COS_SECRET_ID`、`COS_SECRET_KEY`、`COS_REGION`。对象写在 `progress/{userId}/` 下，上传带私有 ACL，读取用约 60 秒签名 URL，不落库公共链接。小程序合法域名沿用现有 COS 域名即可。
|
||
|
||
评价提醒模板字段由服务端按预约填充：`thing1` 课程名称（工作室名）、`thing2` 课程教练（Iris）、`time3` 课程时间、`thing4` 温馨提示。未配置模板 ID 时定时任务不领取预约。
|
||
|
||
回退：先回退应用代码。新增表可保留；`progress/` 下对象不会被旧代码读取。不要在生产直接 `DROP TABLE`。
|
||
|
||
## 迁移
|
||
|
||
目录 `packages/server/prisma/migrations/20260909120000_member_care/migration.sql`。发布时先 `prisma migrate deploy`，再发布后端，最后发布小程序。
|
||
|
||
## 验收清单
|
||
|
||
- 学员在 CONFIRMED 或 COMPLETED 且未评价时都可以订阅提醒；核销后仍能订阅。
|
||
- 完成后可立即评价；重复提交返回已评价。
|
||
- 首页匿名均分不含评论文案；管理端趋势按中国自然月，NPS 与星级分开展示。
|
||
- 私密笔记学员不可见；馆主在学员授权前不能读取照片，授权后可看，撤回后不能再签发。
|
||
- 误传照片可删除，删除后档案和 COS 对象都不再保留。
|
||
- 体测可只填一项，柔韧度允许负值；累计课时含未撤销补录。
|
||
- 未配置评价模板时，定时任务不领取预约。
|
||
- 小程序真机确认可上传、可用签名链接预览成长照片。
|