运动打卡与数据记录是产品的核心,记录方式不确定,数据就没人信
项目概览
客户是谁
某运动健身产品项目。
遇到什么问题
这是一套运动健身方向的移动产品,前端包括基于 uni-app 的跨端应用(配套 UI 组件库)与 Objective-C 编写的 iOS 端;后端为 Java,另有 JavaScript 编写的 Node 侧服务。APP 与小程序共用同一份业务接口。
这类产品的核心是打卡与记录,而数据能不能被信任,取决于记录方式本身是否明确:如果打卡时间、来源与规则含糊,数据攒得越多反而越没人看。
另一类麻烦来自端:
- APP 与小程序都要覆盖同一套功能,各写一套的结果就是功能很快分叉——一边上了新功能另一边没有,规则改了一处另一处没跟上;
- iOS 端是较早的技术选型,改动前必须先判断哪些模块能碰;
- 打卡数据的价值是长期的:用户坚持几个月之后回看,如果记录缺了一段、或者时间对不上,产品的说服力就没了。
我们做了什么
- 把打卡口径在动手前定死:记录字段、时间来源与判定规则先确定,再写功能。前期投入更多沟通,换来的是数据后面可以被信任、被使用。
- 让 APP 与小程序共用同一份业务接口:两端只做展示差异,业务规则只有一份。这要求接口设计更克制,换来两端长期一致。
- iOS 端不整端重写,而是在保留既有功能的前提下按模块推进:重写看起来干净,但会引入不可控的回归,对已经在上线的产品代价太高。
- 客户端是 uni-app 跨端应用与 iOS 端;服务层承载运动打卡与记录、好友与圈子互动,以及内容可见范围的权限判断;数据层保存运动记录与互动数据。打卡与互动是两条独立的业务链路,但共用同一份用户数据与关系数据。
难点怎么解决的
- 打卡数据要经得起回看:记录字段、时间来源与判定规则在动手前定死,而不是事后补规则。
- 两端不能各自长出一套功能:业务接口只有一份,APP 与小程序共用,规则改一处两端同时生效。
- iOS 端的历史代码不能大改:保留既有功能、按模块推进,避免重写带来的回归。
- 好友与圈子的可见范围不能放在端上判断:权限在服务端统一处理,不依赖各端自行过滤。
交付了什么
- 运动打卡与数据记录功能;
- 好友关系与圈子互动;
- uni-app 跨端应用(含小程序形态);
- iOS 端(Objective-C);
- 后端服务与 Node 侧接口。
交付范围到记录与互动能力为止:运动数据如果来自可穿戴设备,采集设备与算法由相应方案提供,我们负责接入与记录;产品提供的是记录能力,不提供医疗诊断或健康建议;应用商店的上架与审核由贵方主体提交,我们配合处理技术问题。
现在的状态
代码处于维护状态。
项目信息
某运动健康产品项目
体育与运动科学
未披露
Vue + uni-app(配套 UI 组件库,49 个 Vue 文件)/ Objective-C(iOS 端)/ Java(后端)/ JavaScript(Node 后端)
运动健康移动产品
CHALLENGES
客户当时面对的现实
好友与圈子互动涉及可见范围与关系链,权限规则不清晰会带来真实的隐私问题
APP 与小程序要覆盖同一份业务,如果各自实现一套,功能很快就会不一致
iOS 端积累了历史包袱,改动前必须先判断哪些能碰、哪些不能碰
CAPABILITIES
我们交付的能力
打卡数据能不能被信任,取决于记录方式
运动打卡与记录
运动打卡与数据记录作为核心链路,记录结果可查、可回看。
好友与圈子互动
好友关系与圈子互动功能,内容可见范围按关系与设置区分。
跨端共用接口
APP 与小程序复用同一份业务接口,两端只做展示差异,业务规则只有一份。
iOS 端演进
iOS 端为 Objective-C 实现,在保留既有功能的前提下按模块推进重构。
SCOPE
交付范围
以下范围按本项目实际交付内容与边界整理,不属于这次范围的部分一并列出。
已交付
- 运动打卡与数据记录功能
- 好友关系与圈子互动
- uni-app 跨端应用(含小程序形态)
- iOS 端(Objective-C)
- 后端服务与 Node 侧接口
不在本次范围
- 运动数据采集的设备与算法:如涉及可穿戴设备,由相应方案提供数据
- 健康与医疗建议:产品提供记录能力,不提供医疗诊断或建议
- 应用商店的上架与审核:由贵方主体提交,我们配合处理技术问题
ARCHITECTURE
分层技术架构
公开口径归纳为三层:客户端是 uni-app 跨端应用与 iOS 端;服务层是 Java 后端与 Node 侧接口,承载打卡、关系链与圈子;数据层保存运动记录与互动数据。
客户端
覆盖用户实际的设备与使用入口
服务层
业务规则只有一份,两端共用
数据层
保证记录可查、互动范围可控
DELIVERY
交付过程
分阶段推进,每个阶段都有可验收的产出,客户在早期就能看到实际效果。
打卡口径与规则
确定运动打卡的记录方式、数据字段与可见范围规则。
后端与业务接口
后端服务与接口层建设,收敛打卡、关系链与圈子逻辑。
跨端与 iOS 端落地
uni-app 跨端应用与 iOS 端接入同一份业务接口。
互动能力与端侧整理
好友与圈子互动完善,iOS 端按模块整理历史代码。
FACTS
可核验的交付事实
以下内容来自本项目实际交付物;未经验证的指标不予展示。
APP 与小程序共用同一份业务接口
业务接口只有一份,两端功能不分叉
Objective-C 实现,按模块推进不整端重写
TRANSFER
这套做法适不适合你
案例的用处不是证明"我们做过",而是让你判断"在我们这种条件下能不能做成"。下面三句是我们对这一单的判断,写下来供你对照自己的情况。
适合什么情况
适合同时需要 APP 与小程序形态、且核心功能依赖持续记录的产品。
什么情况下别照搬
若只是单一端、功能以浏览为主,做跨端共用接口与权限模型属于过度设计。
如果要试,第一步做什么
先把打卡的记录口径与可见范围规则定下来,再谈端和界面。
RELATED SERVICES
相关服务
从实际业务问题出发,查看对应服务的适用场景、交付物与不含项;具体范围仍需单独确认。
FAQ
常见问题
以下是同类项目沟通中出现频率最高的问题,答案就是我们实际的做法。
打卡类产品最容易被忽视的是什么?
为什么 APP 和小程序不各做一套?
iOS 端为什么用 Objective-C?
好友和圈子的权限怎么处理?
现在还在维护吗?
本页最后更新:2026年9月28日