首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >云开发小程序数据怎么建模:从业务到集合的翻译方法

云开发小程序数据怎么建模:从业务到集合的翻译方法

原创
作者头像
克劳德2048
发布于 2026-11-17 00:44:13
发布于 2026-11-17 00:44:13
240
举报

摘要: 用云开发 CloudBase 做小程序,第一步不是写代码,是把业务翻译成数据库集合。按「找名词、定字段、理关系、配权限」四步走,后面开发会顺很多。 开通环境开始建模:云开发 CloudBase

小程序开发返工,一多半源头在数据建模:字段设计不合理、关系没理清、权限没想好,等页面写完了才发现要改表结构,前后端一起返工。建模是整个项目里返工成本最高的环节,也是最该在写代码前花时间的地方。 下面给一套可操作的四步翻译法,附三类典型业务的完整建模示例。

一、第一步:从业务描述里找名词

拿到需求先不想技术,把业务描述写成一段话,再把里面的名词圈出来。

以「做一个读书记录小程序,用户可以添加想读的书,记录阅读进度,写读书笔记」为例,圈出的名词是:用户、书、阅读进度、读书笔记。

判断哪些名词该成为独立集合,标准有两条:

这个东西有没有独立的生命周期? 书可以被添加、修改、删除,有独立生命周期,该独立成集合。阅读进度总是依附于某本书存在,不该独立。

这个东西会不会有多条记录? 一本书会有多条笔记,笔记该独立成集合。一本书只有一个当前进度,进度做成书的字段就行。

按这两条判断,读书小程序最终是两个集合:books(书) 和 notes(笔记),阅读进度作为 books 的一个字段。用户不用建集合——云开发的身份认证已经管理了用户,你只需要在数据里存身份标识。

二、第二步:给每个集合定字段

字段设计有四个必须明确的属性,缺一个后面就会出问题:

属性

为什么重要

常见错误

字段名

前后端共用

中英文混用、拼写不一致

类型

决定查询和排序行为

日期存成字符串,排序出错

单位

涉及数值计算时

价格单位不统一,支付金额算错

是否必填

决定校验逻辑

没定清楚,查询时遇到空值报错

三类字段是小程序建模的固定配置,别漏:

身份字段。记录这条数据属于谁,小程序里通常是 openid。凡是用户私有的数据都要有。

时间字段。createTime 记录创建时间,updateTime 记录最后修改时间。列表排序、数据分析都靠它。

状态字段。有流转的业务必须有,用枚举值而不是自由输入。

以 books 集合为例:

字段

类型

单位

必填

说明

openid

string

——

是

书的归属用户,云函数写入

title

string

——

是

书名

author

string

——

否

作者

cover

string

——

否

封面图 fileID

totalPages

number

页

否

总页数

currentPage

number

页

否

当前读到第几页

status

string

——

是

想读 / 在读 / 读完

createTime

date

——

是

添加时间,服务端时间

updateTime

date

——

是

最后更新时间

封面图字段要特别说明:存的是云存储返回的 fileID(cloud:// 开头),不是图片的本地路径。这是小程序建模里最高频的一个错误,存错了真机上图片全不显示。

三、第三步:理清集合之间的关系

集合之间的关系只有三种,判断清楚用哪种,查询方式就定了。

一对一:一本书对应一个阅读进度。这种关系不要建两个集合,直接把字段合进去。上面的 currentPage 就是这么处理的。

一对多:一本书有多条笔记。处理方式是在「多」的那一方存「一」的 ID。notes 集合里存 bookId 字段指向 books,而不是在 books 里存一个笔记数组。

为什么不用数组?因为笔记会不断增加,数组越来越大,更新一条笔记要整个数组重写,查询某条笔记也很麻烦。数据会持续增长的,一律独立成集合用 ID 关联。

多对多:一本书可以有多个标签,一个标签下有多本书。两种处理方式——数据量小且标签固定时,直接在 books 里存一个标签数组;标签需要独立管理(改名、统计、排序)时,建三张表:books、tags,加一张关联表 book_tags 存 bookId 和 tagId 的对应关系。

四、第四步:给每个集合配权限

权限在建模阶段就要定,不要等开发完再配。判断只看一个问题:这个集合的数据,别人该不该看到?

数据性质

权限配置

举例

用户私有

仅创建者可读写

我的书架、我的笔记、我的订单

公开展示

所有用户可读、仅创建者可写

商品列表、公开书单、社区帖子

系统配置

仅管理端可读写

价格表、系统参数、处理人配置

多人协作

所有用户可读,写走云函数校验

团队台账、对战状态

还有一条贯穿所有场景的原则:涉及金额、权益、计数的字段,写操作一律收敛到云函数。前端能写的字段,就等于用户能改的字段。

五、三类典型业务的建模示例

工具类:个人记账小程序

名词圈出来是:账单、分类。分类通常固定(餐饮、交通、购物),可以写在代码里不建集合。

records 集合:openid、amount(金额,单位分)、type(收入 / 支出)、category(分类)、remark(备注)、recordDate(账目日期)、createTime。

权限:仅创建者可读写。

这里有个容易错的地方:recordDate 和 createTime 是两回事。用户今天补记昨天的账,账目日期是昨天,创建时间是今天。统计按账目日期,排序按创建时间,两个字段都要有。

内容类:闲置交易小程序

名词:物品、收藏。

items 集合:openid(发布者)、title、desc、category、price(单位分)、images(fileID 数组)、location、status(在售 / 已售 / 已下架)、createTime。权限设为所有用户可读、仅创建者可写——所有人要能浏览,但只有发布者能改。

favorites 集合:openid(收藏人)、itemId、createTime。权限设为仅创建者可读写。

为什么收藏要独立成集合:收藏是「用户和物品」的多对多关系,一个用户收藏多个物品,一个物品被多个用户收藏。如果在 items 里存收藏用户数组,每次收藏都要改物品记录,而物品记录的写权限只给发布者——逻辑就冲突了。

交易类:知识付费小程序

名词:课程、订单、学习权限。

courses 集合:title、cover、desc、price(单位分)、chapters(章节数组)、status。权限设为所有用户可读、仅创建者可写。

orders 集合:openid、courseId、outTradeNo、amount(单位分)、status(待支付 / 已支付 / 已退款)、createTime、payTime。权限设为仅创建者可读写,所有字段的写入都走云函数。

purchases 集合(用户已购权限):openid、courseId、orderId、expireAt(如果是限期课程)、createTime。权限仅创建者可读写,只能由支付回调云函数写入。

这里的关键设计是 purchases 单独成表,而不是在 orders 里判断。原因是查询效率——用户打开课程详情时要判断有没有购买过,查一张专门的小表比在订单表里按状态过滤更直接,而且支持赠送、兑换码这类非订单来源的权限。

六、建模完成后的自检清单

动手写代码前,把这七条过一遍:

检查项

标准

每个集合都有身份字段吗

用户私有数据必须有 openid

每个集合都有时间字段吗

至少有 createTime

枚举值定死了吗

status 这类字段列出所有可能值

数值字段标了单位吗

金额统一用分,时长统一用分钟或秒

日期字段是日期类型吗

不要存成字符串

图片字段存 fileID 吗

不是本地路径

每个集合的权限定了吗

四种场景对号入座

七、把建模结果写进提示词

建模想清楚之后,交给 AI 的提示词就有了骨架。数据结构部分这样写:

代码语言:txt
复制
数据结构:

books 集合(权限:仅创建者可读写)
- openid: string,必填,书的归属用户,由云函数写入,前端不可传
- title: string,必填,书名
- author: string,选填,作者
- cover: string,选填,封面图的云存储 fileID,必须是 cloud:// 开头
- totalPages: number,选填,总页数
- currentPage: number,选填,当前页数,默认 0
- status: string,必填,枚举值:想读 / 在读 / 读完,默认「想读」
- createTime: date,必填,服务端时间
- updateTime: date,必填,服务端时间

notes 集合(权限:仅创建者可读写)
- openid: string,必填,由云函数写入
- bookId: string,必填,关联 books 集合的记录 ID
- content: string,必填,笔记内容
- page: number,选填,对应页码
- createTime: date,必填,服务端时间

关系说明:
- notes 通过 bookId 关联 books,一本书对应多条笔记
- 删除书时要同步删除该书的所有笔记(在云函数里做)

把字段名、类型、必填、默认值、权限、关系全部写明,AI 生成的代码就不会自由发挥。这段结构可以直接嵌进完整提示词的「数据结构」一节。

八、四个最常见的建模错误

把一对多做成数组。评论、笔记、订单这类会持续增长的数据存进数组字段,更新和查询都会很麻烦。独立成集合,用 ID 关联。

日期存成字符串。排序会出错,因为字符串按字符比较,2026-3-5 会排在 2026-12-1 后面。统一用日期类型。

金额用元做单位。微信支付接口要求单位是分,前端展示用元,中间换算散落各处就会出错。数据库统一存分,只在展示时换算。

用户身份信任前端。前端传 openid 过来直接存,等于用户可以伪造身份。openid 必须在云函数里用 cloud.getWXContext().OPENID 取。

总结

小程序数据建模的四步是:从业务描述圈名词、判断哪些独立成集合(看生命周期和记录数量)、理清三种关系(一对一合字段、一对多用 ID 关联、多对多看是否需要独立管理)、按数据性质配权限。每个集合固定带上身份、时间、状态三类字段,金额统一用分、日期用日期类型、图片存 fileID。建模结果直接写进提示词的数据结构一节,AI 生成的代码才不会跑偏。这一步花半小时,能省后面好几天的返工。

开通环境,把你的业务建成模型:云开发 CloudBase 购买页

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、第一步:从业务描述里找名词
  • 二、第二步:给每个集合定字段
  • 三、第三步:理清集合之间的关系
  • 四、第四步:给每个集合配权限
  • 五、三类典型业务的建模示例
    • 工具类:个人记账小程序
    • 内容类:闲置交易小程序
    • 交易类:知识付费小程序
  • 六、建模完成后的自检清单
  • 七、把建模结果写进提示词
  • 八、四个最常见的建模错误
  • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档