交互与用户体验 / 系统课时
为每种内容类型定义必要字段
为每种内容类型定义必要字段
文章、商品和课程即使共用一个内容后台,也不能只靠“标题+描述”管理。字段过少会让页面展示和筛选缺数据,字段过多又会增加录入负担。下面以这三种类型为例,产出一份包含字段含义、类型、必填阶段和取值约束的字段字典,并用发布场景检验它。
学习目标
- 区分所有内容共用的字段与某种类型独有的字段。
- 为字段明确数据类型、必填条件、取值范围及维护责任。
- 用草稿保存和正式发布的测试案例验证字段规则。
从实际使用动作筛选字段
先列出内容的使用位置,再决定字段是否必要,不要照搬别的系统的字段表。
- 查看列表卡片:需要标题、摘要、内容类型;商品卡片如果展示价格和主图,这两个字段也必须有值。
- 执行筛选或业务操作:文章按分类查找,需要分类引用;商品按 SKU 管理库存或订单,需要唯一 SKU;课程按难度筛选,需要固定的难度选项。
- 保存与发布:创建草稿时允许正文未写完,但必须知道记录属于哪种类型、由谁维护;发布时才执行面向用户的完整性检查。
判断“必填”时要同时写明什么阶段必填。例如,文章 body 在草稿阶段可以为空,在发布阶段不能为空;课程不应被要求填写商品的 sku。
统一定义共享字段
以下是一份示例字段字典。字段名是供产品与开发约定的内部标识,取值规则是本案例拟定的业务规范,并非所有内容平台的通用限制。
| 字段及含义 | 数据类型 | 必填阶段 | 约束 |
|---|---|---|---|
content_id 内容标识 |
string | 创建 | 系统生成,全局唯一且不可修改 |
content_type 内容类型 |
enum | 创建 | 只允许 article、product、course |
status 发布状态 |
enum | 创建 | draft、published、archived,默认 draft |
owner_id 维护负责人 |
string | 创建 | 必须引用有效的人员记录 |
title 展示标题 |
string | 发布 | 去除首尾空格后为 2~80 个字符 |
summary 列表摘要 |
string | 发布 | 去除首尾空格后为 20~160 个字符 |
updated_at 最后更新时间 |
datetime | 创建 | 系统维护,使用带时区的 ISO 8601 时间 |
content_id 和 updated_at 由系统写入,不要求编辑手填。status 由 draft 改为 published 前必须运行完整校验;“数据库列允许空值”与“业务发布允许空值”应分别记录,不要混成一条规则。
为不同内容类型补充专属字段
| 内容类型 | 字段及含义 | 数据类型 | 发布约束 |
|---|---|---|---|
| 文章 | body 正文 |
richtext | 至少包含一个可见的非空内容块 |
| 文章 | category_id 主分类 |
string | 引用现存且可用的分类 |
| 商品 | sku 商品编码 |
string | 1~32 个字符,同一商品库中唯一 |
| 商品 | price_minor 最小货币单位价格 |
integer | 不小于 0;不接受小数 |
| 商品 | currency 货币代码 |
enum | 本例只允许 CNY、USD |
| 商品 | primary_image 列表主图 |
media reference | 引用一张可访问的已上传图片 |
| 课程 | outline 章节提纲 |
array | 至少一个非空章节 |
| 课程 | level 课程难度 |
enum | beginner、intermediate、advanced |
| 课程 | estimated_minutes 预计学习时长 |
integer | 大于或等于 1,单位为分钟 |
这里用整数表示价格,避免将 199.00 存为浮点数造成精度问题:currency=CNY 且 price_minor=19900 表示人民币 199 元。将“约两小时”直接存入 estimated_minutes 是错误做法,应存整数 120,展示层再转换为文字。

用草稿与发布案例验收规则
假设某商品已填写标题“轻量防水背包”、30 字的摘要、有效负责人、sku=BAG-0082、price_minor=19900、currency=CNY,并上传了主图。只要 SKU 没有重复,且其余共享字段合法,就可以从草稿发布。
| 测试输入 | 保存草稿 | 正式发布 |
|---|---|---|
| 文章摘要为空,正文未完成 | 允许 | 拒绝:摘要及正文不符合要求 |
商品价格 price_minor=-50 |
允许暂存 | 拒绝:价格不能为负数 |
商品 sku 与已有商品重复 |
允许暂存 | 拒绝:编码必须唯一 |
课程 outline 为空数组 |
允许暂存 | 拒绝:至少填写一个章节 |
| 所有共享与专属字段均合法 | 允许 | 允许,状态改为 published |
这些用例假设草稿容许暂存不完整业务字段,但 content_type、owner_id 等创建必填项仍须有效。最终交付的字段字典还应为每个字段补充示例值、录入者、是否由系统派生、校验失败文案;例如 sku 重复时提示“商品编码已存在”,让内容编辑知道该改什么。