从前言来看，一个「生活痛点」催生的 Side Project

带娃之后家里最高频的三个问题不是「宝宝乖不乖」。而是：

• 上次几点喂的？
• 喝了多少？按理说，
• 现在该不该喂？

这些看似简单的疑问。却是真实的使用者痛点——记录容易忘、统计困难、信息共享不便，甚至换手机数据全丢。不过，

备忘录、家庭群、小本子都试过——能记。但不好统计、不好协作、换机就丢。怎么说呢，

作为开发者。很自然想到：不如自己写一个小程序。

于是有了 喂宝助手面向 ～ 岁宝宝家庭的喂养记录工具，支持记奶、统计、成长曲线、微信提醒和家人共享。

再看体验入口。微信搜索小程序「喂宝助手」

下面从工程视角，聊聊这个项目是怎么搭起来的。

一、产品要做什么

C 端：记数据 B 端：看运营 S 端：统一鉴权与同步。

二、技术栈选型

整体架构

MilkTime/
├── WX/ # UniApp 微信小程序
├── SERVER/ # Node.js Express API
├── ADMIN/ # Vue3 管理后台
└── docs/ # 设计 & API 文档

┌─────────────┐ POST /v1/h5/* ┌─────────────┐
│ UniApp WX │ ─────────────────────▶ │ Express │
└─────────────┘ └──────┬──────┘
│
POST /v1/admin/* │
┌─────────────────────┐│
│ Vue3 ADMIN │◀─
└─────────────────────┘│
▼
MongoDB Redis BullMQ

各端技术栈对比表

# 为什么用 UniApp？

三、后端分层设计

SERVER 使用约定式路由＋三层结构：

routes/v1/h5/*.js // 路由入口
↓controllers/v1/h5/*Controller.js // 参数校验 + 鉴权
↓services/v1/h5/*Service.js // 业务逻辑
↓models/v1/mapping/*Model.js // Mongoose Schema

C 端接口统一前缀：/v1/h5/...  管理端接口：/v1/admin/...

示例这方面。喂养记录创建链路

// Controller：鉴权 + 校验
exports.create =,async => {
const data = await FeedingsService.create
return apiResponse.successResponseWithData
},]

设计原则：

• Controller 不写复杂业务；
• Service 完成权限校验；怎么说呢，
• Model 一表一文件；
• 列表类接口走 Redis 缓存。怎么说呢，

四、小程序端关键实现细节

全局页面埋点

Main.js 使用 Vue.mixin 注入 onShow 统一上报访客：

Vue.mixin({
onShow {
trackCurrentPageVisit
}。})

S​erver 按 "visitorId+visitDate" 去重，同一天只记录一条，提高 DAU 精度。

家人共享 Deep Link 实现流程

• 分享链接带邀请码参数，例如： /subpackage/my/family?code=XXXXXX&name=家庭名)
• 打开后若未登录 → 跳转登录页并保留 `redirect`** 参数回跳。
• 已登录 → 自动弹窗选择角色。
• 确认后将邀请码写入云端并完成成员绑定。

微信订阅消息调用规范

`wx.requestSubscribeMessage` 必须在使用者交互链路里同步调用，否则会触发 TAP gesture 错误。实现思路这方面，

1. App 启动或页面 onShow 时预取模板 ID 并缓存。
2. 使用者点击「开启提醒」→ 从缓存直接调用 `requestSubscribeMessage`。话说回来，
3. 授权成功后异步上报至后端。
4. 服务端发送前 校验模板 ID 与公众号「我的模板」匹配。

五、微信喂养提醒：队列 + 定时扫描方案

PUSH 流程概览：

• 使用者授权订阅消息 → 写入 `wx_subscribes` 表。
• 使用者设置提醒间隔 → 写入 `reminders` 表。
• 定时任务每分钟扫描到达时间 → 将任务推入 BullMQ 队列。
• Worker 消费队列 → 调用 微信 subscribe/send API 并写日志。.
• scheduler/task/feedRemindScanTask.js — 每分钟扫描兜底；

六

七

八

---