配置一个通用管理列表

有模型之后，把数据做成一个可搜、可看、可操作的管理列表——字段显示、搜索、操作按钮怎么配。

本文说明什么

许多业务系统的主界面是「管理列表」：一张表，支持搜索、分页、详情查看与新增修改。衍数中这类列表大多由配置完成——本文说明列表通常需要配置的几件事。具体入口与菜单以实际实例界面为准。

前提：已有一个数据模型。没有模型，界面无从谈起。

勾选要在列表里显示的字段，并调整顺序与宽度。
一个字段以什么形式呈现，通常由字段类型自动决定，也可显式指定：
- 文本 → 文本；数字/金额 → 数字（平台默认最多显示两位小数）；日期 → 日期。
- 下拉/枚举字段 → 显示成字典值的中文含义（例如状态 pending 显示为「待处理」），而不是英文代码。

当一列引用另一张表的数据（例如「订单」引用「客户」）时，平台负责做「翻译」：界面显示客户的名称，而不是客户的内部 ID。配置时指定该列引用哪张表、显示它的哪个字段即可。

把需要参与筛选的字段放进搜索区（如订单号、状态、日期范围）。搜索条件应与字段类型匹配——日期字段用日期范围，下拉字段用选项，而不是一个通用文本框。

列表上的「新增、编辑、删除、详情」等操作，按角色控制可见与可用。删除类操作建议在配置里就开启二次确认，避免误删。

默认按哪个字段排（如更新时间倒序、最新在前），每页条数等。

列表和模型是强绑定吗？ 模型定义数据本身；视图定义「这堆数据对某个角色长什么样」。同一模型可以配不同视图，服务不同场景（如运营看统计口径、仓库只看待办）。

配置了没生效？ 先确认是否仍停留在草稿/未发布状态——衍数的统一机制是「草稿 → 预览 → 发布」：修改后未生效时处于草稿，预览确认无误后发布方才生效。