12 KiB
12 KiB
PRD: 订阅与每日运势推送功能
1. 概述
1.1 产品名称
万事宜 — 订阅与每日运势推送
1.2 目标用户
已输入生辰信息并使用紫微斗数运势功能的微信小程序用户
1.3 核心价值
用户无需手动打开小程序，每日自动收到个性化运势推送，提升日活与用户粘性
1.4 约束条件
- 仅限微信小程序平台
- 依赖微信云开发（CloudBase）作为轻量后端
- 推送内容由现有算法本地/云端生成，无需外部数据源
2. 功能范围
2.1 范围内（MVP）
| 功能 | 说明 |
|---|---|
| F1: 订阅入口 | 在运势页面提供订阅入口，引导用户订阅每日推送 |
| F2: 微信订阅消息授权 | 调用 wx.requestSubscribeMessage 获取用户授权 |
| F3: 生辰信息上传 | 将用户生辰信息上传至云数据库，用于云端生成运势 |
| F4: 每日定时推送 | 云函数定时触发器每日 07:00 执行推送 |
| F5: 推送内容生成 | 云函数调用共享算法包生成当日运势 |
| F6: 推送时间配置 | 用户可自定义推送时间（默认 07:00） |
| F7: 取消订阅 | 用户可随时取消推送，清理云数据库订阅记录 |
| F8: 共享算法包抽取 | 将运势算法纯函数层抽取为独立 npm 包 |
2.2 范围外（后续迭代）
| 功能 | 说明 |
|---|---|
| 黄历每日推送 | 未来可扩展为推送当日宜忌 |
| 多模板推送 | 支持不同模板（运势、黄历、提醒等） |
| 多平台推送 | H5 浏览器推送、App 原生推送 |
| 推送统计 | 推送到达率、点击率分析 |
3. 用户故事
US-01: 订阅推送
作为已设置生辰信息的用户，我希望在运势页面看到订阅入口，一键订阅每日运势推送，从而每天自动收到我的运势信息。
验收标准：
- 用户进入运势页面时，显示订阅入口（仅未订阅时）
- 点击订阅后，弹出微信订阅消息授权弹窗
- 用户授权后，生辰信息上传至云数据库
- 订阅成功后显示"已订阅"状态和每日推送时间
- 未输入生辰信息的用户提示先设置生辰信息
US-02: 每日推送接收
作为已订阅用户，我希望每天在固定时间收到服务通知，查看当日的综合运势、各维度运势和幸运信息。
验收标准：
- 每日在用户配置的时间（默认 07:00）收到服务通知
- 推送内容包含：日期、综合运势评分+等级、各维度运势、幸运色+数字
- 推送内容与小程序内当日运势一致
- 同一用户每日不会收到重复推送
US-03: 推送时间配置
作为已订阅用户，我希望在订阅管理页面修改推送时间，从而适配我的作息习惯。
验收标准：
- 订阅管理页面显示当前推送时间
- 用户可修改推送时间（步长 30 分钟）
- 修改后云端同步更新
- 修改后下一次推送按新时间执行
US-04: 取消订阅
作为已订阅用户，我希望在订阅管理页面一键取消订阅，从而不再收到每日推送。
验收标准：
- 订阅管理页面提供"取消订阅"按钮
- 取消后删除云端订阅记录
- 取消后不再收到推送
- 取消后订阅入口重新显示
4. 架构与数据流
4.1 系统架构
┌──────────────────────────────────────────────────────┐
│ 微信小程序 │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────┐ │
│ │ 运势页面 │ │ 订阅管理页面 │ │ 共享算法包 │ │
│ │ (订阅入口) │ │ (时间/取消) │ │ (本地使用) │ │
│ └──────┬───────┘ └──────┬───────┘ └───────────┘ │
│ │ │ │
│ └────────┬────────┘ │
│ │ │
│ wx.cloud.callFunction │
└──────────────────┼─────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────┐
│ 微信云开发 (CloudBase) │
│ ┌────────────────────┐ ┌────────────────────────┐ │
│ │ 云函数: subscribe │ │ 云函数: dailyPush │ │
│ │ - 存储订阅关系 │ │ - 定时触发器 07:00 │ │
│ │ - 存储生辰信息 │ │ - 调用共享算法包 │ │
│ │ - 更新推送时间 │ │ - 生成运势内容 │ │
│ │ - 取消订阅 │ │ - 调用 subscribe.send │ │
│ └────────────────────┘ └────────────────────────┘ │
│ ┌────────────────────────┐ │
│ │ 云函数: unsubscribe │ │
│ │ - 删除订阅记录 │ │
│ └────────────────────────┘ │
│ ┌────────────────────────────────────────────────┐ │
│ │ 云数据库: subscriptions 集合 │ │
│ │ { openid, templateId, birthInfo, pushTime, │ │
│ │ pushEnabled, subscribedAt, lastPushDate } │ │
│ └────────────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────────────┐ │
│ │ 共享算法包 @everything-suitable/algorithm │ │
│ │ (云函数依赖，纯 TypeScript 计算) │ │
│ └────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
4.2 数据流
订阅流程：
1. 用户点击"订阅每日推送"
2. 小程序检查用户是否已输入生辰信息
3. 调用 wx.requestSubscribeMessage 请求授权
4. 用户授权 → 小程序调用云函数 subscribe
5. 云函数将 { openid, birthInfo, templateId, pushTime } 写入云数据库
6. 返回成功 → 小程序 UI 更新为"已订阅"
每日推送流程：
1. 云函数定时触发器 (dailyPush) 在每日 07:00 触发
2. 查询云数据库 subscriptions 中 pushEnabled=true 且 lastPushDate != today 的记录
3. 对每条记录：
a. 使用 birthInfo 计算 ZiweiChart（本地算法）
b. 使用 chart + today 调用 generateDailyFortune
c. 格式化推送内容（模板字段绑定）
d. 调用 wx.subscribeMessage.send 发送
e. 更新 lastPushDate = today
5. 共享算法包定义
5.1 包结构
packages/algorithm/
├── package.json
├── tsconfig.json
├── src/
│ ├── index.ts # 导出入口
│ ├── fortuneStrategy.ts # 运势生成策略
│ ├── fortune.ts # 综合运势生成
│ ├── ziweiAlgorithm.ts # 紫微算法基础
│ ├── types.ts # 类型定义
│ ├── enums.ts # 枚举定义
│ └── __tests__/ # 算法测试
│ └── fortuneStrategy.test.ts
└── README.md
5.2 导出接口
// 核心导出
export { generateDailyFortune } from './fortuneStrategy'
export { generateComprehensiveFortune } from './fortune'
export { calculateLuckyColor, calculateLuckyNumber, calculateLuckyDirection } from './ziweiAlgorithm'
export { determineLuckLevel, calculatePalaceScore } from './ziweiAlgorithm'
export type { DailyFortune, ZiweiChart, PalaceFortune } from './types'
6. 微信订阅消息模板
6.1 模板申请
在微信小程序管理后台 → 功能 → 订阅消息 → 公共模板库，搜索并选用合适的模板。
6.2 推荐模板字段映射
| 模板参数 | 值 | 说明 |
|---|---|---|
date1 |
{{data.date1}} |
日期，格式：2026年8月14日 |
thing2 |
{{data.thing2}} |
综合运势，格式：综合评分85分，等级：吉 |
thing3 |
{{data.thing3}} |
各维度运势摘要 |
thing4 |
{{data.thing4}} |
幸运信息，格式：幸运色红色 幸运数字7 |
6.3 推送内容示例
📅 2026年8月14日
🌟 综合运势：85分（吉）
📊 事业：今日事业运势吉显，适合处理重要工作事务
财运：财运亨通，可进行投资理财
感情：感情运势良好，适合表达爱意
健康：身体状况良好，精力充沛
🍀 幸运色：红色 幸运数字：7
7. 阶段与里程碑
| 阶段 | 内容 | 预估工时 | 依赖 |
|---|---|---|---|
| M1: 共享算法包 | 抽取算法为独立包，确保云函数可调用 | 2d | 无 |
| M2: 云开发环境 | 开通微信云开发，创建数据库、云函数、定时触发器 | 1d | M1 |
| M3: 订阅功能 | 小程序端订阅入口 + 订阅管理页面 + 云函数 | 2d | M2 |
| M4: 每日推送 | 云函数 dailyPush 实现 + 定时触发器配置 | 1.5d | M2+M3 |
| M5: 测试与验收 | 集成测试 + 推送验证 + 异常处理 | 1.5d | M4 |
8. 验收标准
8.1 功能验收
| # | 验收项 | 预期结果 |
|---|---|---|
| 1 | 未输入生辰信息时订阅 | 提示用户先设置生辰信息 |
| 2 | 首次订阅流程 | 微信授权弹窗 → 生辰信息上传 → 订阅成功 |
| 3 | 每日推送触发 | 用户在配置时间收到服务通知 |
| 4 | 推送内容正确性 | 推送内容与小程序内当日运势一致 |
| 5 | 推送时间修改 | 修改后下次推送按新时间执行 |
| 6 | 取消订阅 | 删除云端记录，不再收到推送 |
| 7 | 重复推送防护 | 同一用户每日仅收到一次推送 |
| 8 | 订阅消息过期 | 用户重新订阅后恢复正常推送 |
8.2 非功能验收
| # | 验收项 | 预期结果 |
|---|---|---|
| 1 | 云函数执行时间 | < 3s/用户（含算法计算） |
| 2 | 订阅消息到达率 | 微信官方保障，不做额外要求 |
| 3 | 用户数据安全 | 生辰信息仅用于推送计算，不另作他用 |
9. 术语表
| 术语 | 定义 |
|---|---|
| 微信订阅消息 | 微信小程序提供的消息推送能力，用户订阅后可在"服务通知"中收到消息 |
| 微信云开发 | 微信生态内的 Serverless 云服务，提供云函数、云数据库、存储等 |
| 云函数 | 运行在微信云端的 Node.js 函数 |
| 定时触发器 | 云函数的 cron 触发机制 |
| 共享算法包 | 从应用中抽取的纯算法模块 |
| 服务通知 | 微信内用户接收订阅消息的入口 |