数据模型

介绍

数据模型是整个数据链路的统一语言。网络、数据库、本地存储、仓库和页面之间的数据都从这里定义，保证字段一致、语义清晰。

目录结构

目录	说明
entity/	领域实体，如 Auth、User、Goods。
request/	请求参数，如 GoodsSearchRequest、PasswordLoginRequest。
network/	通用网络响应与分页模型。
common/	通用基础模型，如 Id、Ids、Any。

实体使用建议

• 实体字段以业务为准，示例内容只做结构参考，项目落地时应以接口字段为准。
• 统一通过构造函数做空值兜底，避免 ViewModel 层做大量判空。
• 数据从网络进入模型后再传递给仓库与页面，避免散落的字段转换。

网络模型

NetworkResponse<T>

网络响应结构需要根据你的接口来调整。当前项目以 code == 1000 视为成功：

• data：真实数据
• code：状态码
• message：错误提示

如果你的项目是 code == 200，或者字段叫 msg，都应在这里统一修改，再影响所有请求。

NetworkPageData<T> / NetworkPageMeta

分页结构也需要按后端返回结构调整，以下是当前项目的约定：

• list：数据列表
• pagination：分页信息（总条数、页码、每页数量）

请求模型

请求参数统一放在 request/ 下，避免 ViewModel 里手写 Map。常见如 GoodsSearchRequest。

使用建议

• 新增实体先定义模型，再配合仓库与数据源使用。
• 网络字段调整只改 network/ 里的模型，统一影响所有请求。