本教程以“配送管理”为例，带您完成从数据建模到前台验证的最小业务闭环。完成后，业务人员可以从应用入口新建和查看配送单，管理员可以控制页面、权限，并按需增加审批或自动化。
[!NOTE]
30 分钟是熟悉管理后台后的参考用时，不包含需求评审、历史数据迁移、复杂流程设计和正式发布。不同版本或租户的菜单名称可能略有差异，请以实际管理后台为准。
您将搭建什么
配送管理应用
└─ 配送单对象
├─ 数据：收货人、电话、地址、状态、签收凭证
├─ 页面：新建编辑页、详情页、列表页
├─ 入口：平台应用或 CRM 应用视图
├─ 权限：管理员、配送人员
└─ 自动化：审批流程或工作流程（可选）
本教程先完成可用原型，再说明上线前需要补充的验证和治理工作。
开始之前
请确认：
- 您拥有对象、界面、权限和流程相关的管理权限。
- 您可以使用一个普通员工测试账号验证前台效果。
- 本次练习不使用真实客户、手机号、地址或附件。
- 如果企业已启用沙盒，请优先在沙盒中完成练习。
先记录本次最小需求：配送人员创建配送单并更新状态；管理员可以查看全部配送单；其他人员不需要访问该应用。
步骤 1：创建配送单对象
- 进入自定义对象管理页面，点击 新建。
- 对象名称填写
配送单，补充对象用途并选择图标。 - 保留系统生成的 API Name；仅在已明确开发或集成规范时调整。
- 保存对象。
[!TIP]
标准业务应优先评估能否复用预设对象。只有现有对象无法准确表达业务语义时，再创建自定义对象。
步骤 2：设置记录名称
主属性用于在列表、详情和关联选择中识别一条记录。配送单通常适合使用自增编号，例如 PS-202608-0001。
- 进入配送单的主属性设置。
- 选择 自增编号，设置前缀、编号规则和起始值。
- 如果业务已经有外部配送单号，也可以选择文本，并将外部编号单独保存为字段。
- 保存设置。
步骤 3：添加最小业务字段
先添加完成配送闭环必需的字段，避免一开始堆积大量暂时不用的信息。
| 字段名称 | 建议类型 | 是否必填 | 用途 |
|---|---|---|---|
| 收货人 | 单行文本 | 是 | 记录收货联系人 |
| 联系电话 | 手机 | 是 | 联系收货人 |
| 配送地址 | 动态地址或多行文本 | 是 | 记录配送地点 |
| 计划配送时间 | 日期时间 | 否 | 安排配送任务 |
| 配送状态 | 单选 | 是 | 建议设置待配送、配送中、已签收、已取消 |
| 签收照片 | 图片 | 否 | 保存签收凭证 |
| 备注 | 多行文本 | 否 | 保存异常或补充信息 |
逐个新增字段并保存。为 配送状态 设置默认值 待配送。
[!IMPORTANT]
必填、唯一性和默认值会影响前台录入、导入和历史数据。正式上线前，应确认存量数据和所有录入入口都能满足这些约束。
步骤 4：配置页面布局
页面布局决定用户在不同场景中看到什么。至少完成以下三类页面：
- 新建编辑页：依次放置收货人、联系电话、配送地址、计划配送时间、配送状态和备注。
- 详情页：突出配送状态、负责人、计划配送时间和签收照片，并保留基础信息。
- 列表页：展示配送单号、收货人、配送状态、计划配送时间和负责人，增加常用状态筛选。
- 将布局分配给本次测试使用的角色或业务类型。
- 保存并预览。
此时先不要添加复杂组件。确保业务人员能够顺利新建、编辑、查看和筛选配送单后，再逐步优化页面。
步骤 5：创建应用入口
对象创建成功不代表业务人员能直接找到它，还需要把对象加入应用、视图或菜单。
- 进入应用管理页面，新建平台应用；应用名称填写
配送管理。 - 配置图标和适用范围，仅选择配送团队及管理员。
- 创建 Web 或移动应用视图，把配送单加入菜单。
- 按需将配送管理加入 Web 主导航或 App 主导航。
- 启用应用或视图。
[!NOTE]
适用范围决定用户能否看到入口，角色权限决定用户能否执行操作，数据权限决定用户最终能访问哪些记录。三者需要同时验证。
步骤 6：配置最小权限
准备两个角色并分配给测试账号：
| 角色 | 功能与对象权限 | 字段权限 | 数据范围 |
|---|---|---|---|
| 配送管理员 | 查看、新建、编辑及业务需要的管理操作 | 可查看和编辑全部业务字段 | 可查看配送业务范围内的全部记录 |
| 配送人员 | 查看、新建、编辑 | 可编辑配送信息和状态，不开放无关敏感字段 | 仅查看本人负责或明确共享的记录 |
配置顺序建议如下：
- 确认角色能看到配送管理入口。
- 授予配送单的对象操作权限。
- 配置字段可见和可编辑范围。
- 按负责人、归属部门或相关团队配置记录级数据权限。
- 仅在确有跨团队协作需求时增加数据共享规则。
遵循最小权限原则，不要为了通过测试直接授予全部权限。
步骤 7：增加自动化（可选）
原型不一定需要流程。如果业务确有自动化需求，可按目标选择：
| 目标 | 选择的能力 | 示例 |
|---|---|---|
| 需要人工核准 | 审批流程 | 特殊配送申请提交主管审批 |
| 字段变化后自动执行动作 | 工作流程 | 状态变为已签收后发送通知 |
| 多人连续处理任务 | 业务流程 | 仓库出库、配送、签收依次办理 |
| 按生命周期推进任务 | 阶段流程 | 待配送、配送中、已签收分阶段管理 |
| 需要变量、分支或复杂数据操作 | 流 | 根据配送区域分配负责人并更新关联数据 |
首次练习可以配置一条简单工作流程：当 配送状态 变为 已签收 时，向配送管理员发送通知。保存并启用后，用测试记录触发一次。
步骤 8：验证完整业务链路
分别使用配送人员和配送管理员账号验证，不要只在管理后台检查配置是否保存成功。
配送人员
- 能看到配送管理入口，但看不到无关管理菜单。
- 能新建配送单，必填和默认值符合预期。
- 能在列表中筛选并打开本人负责的配送单。
- 能更新配送状态和上传签收凭证。
- 无法访问未授权记录和字段。
配送管理员
- 能查看业务范围内的配送单。
- 能查看本次测试需要的全部字段。
- 能处理或监控已配置的流程。
- 能根据负责人、状态和时间定位测试数据。
多端与异常场景
- 分别检查 Web 和移动端布局。
- 尝试遗漏必填字段、录入重复数据和执行未授权操作。
- 检查通知、待办和流程记录是否按预期生成。
- 删除练习数据前，确认它没有被其他测试记录或流程引用。
上线前检查
本教程完成的是最小原型。正式上线前还应完成以下工作：
- 由业务负责人确认字段口径、状态定义、流程边界和验收标准。
- 补充验证规则、查重规则、布局规则及必要的对象关系。
- 评估初始数据导入、数据清洗、历史数据和附件迁移。
- 用各角色的真实权限组合完成业务验收。
- 涉及海外组织时，补充语言、时区、区域、币种和地址配置。
- 涉及打印、邮件、签章或短信时，完成模板与插件联调。
- 对高风险变更，在沙盒中测试并通过更改集校验、部署。
- 记录负责人、发布时间、验证结果和回退方案。