后台通用数据接口常因 ViewSet 能力边界模糊而出现隐患：轮播与统计接口本应只读，访问记录却需要查询和新增；若再以展示字段作为检索键，路由解析、详情命中和写入控制都会变得不稳定。本文聚焦 CMS 管理系统的general_data通用数据应用，梳理模型、序列化器、ViewSet、DefaultRouter与项目级include的连接关系。读完后可以独立检查三类接口的读写边界、检索字段、搜索字段及路由可达性。文章目录设计与需求后端设计前端设计扩展功能ViewSet 能力边界与检索设计DefaultRouter 注册与项目级挂载Codex开发标准SOP 标准PDD 标准总结设计与需求CMS 管理系统中的通用数据应用用于承载轮播内容、网站访问统计和访问记录三类数据。三类数据虽都由 REST Framework 输出，但业务属性并不相同：轮播与总访问数据偏展示，访问记录则同时承担查询与新增职责。因此，设计重点不在于把模型统一暴露，而在于根据数据用途选择合适的 ViewSet 组合、序列化器绑定方式和路由入口。模块名称业务对象已知能力设计重点风险边界通用数据应用模块图片轮播数据查询可用轮播内容通过筛选后的queryset限定返回范围banner_type不是天然稳定标识时，详情检索可能不稳定通用数据应用模块网站总访问数据查询全部访问统计数据绑定统计模型与对应序列化器total_count属于统计展示值，作为检索键存在命中风险通用数据应用模块访问记录数据查询、搜索与新增使用具备“查、增”能力的自定义 ViewSet 基类