列表接口契约：分页、排序与筛选必须一起设计

分页参数、默认排序、最大 page size、筛选字段和响应总数都应写入 API 契约。对数据量很大的接口，count 可能昂贵，应权衡是否提供估算值或 cursor 分页。

排序字段必须白名单化，不能将客户端传入的字段名直接拼进 SQL。筛选条件也应在查询层验证类型、范围和权限。