MallBase

MallBase 扩展槽边界规范；涉及会员、积分、分销、余额、优惠等权益扩展接入订单、商品编辑或 UniApp 展示时使用。

MallBase schema 真相源与幂等升级 SQL 规则；升级 SQL 仅在用户明确要求已有库升级时使用。

MallBase ThinkPHP 后端规则索引；仅在需要浏览或选择后端规则、且无法确定具体 ThinkPHP skill 时使用。

MallBase 已有库升级 SQL 边界规则；只有用户明确要求考虑已有库升级、测试服/线上升级或 upgrade SQL 时使用。

MallBase ThinkPHP 模型字段访问器与素材回显规则；在 Model 字段读写、访问器、修改器、with 关联、素材 ID 回显或 Service 字段组装优化时使用。

MallBase preview 演示站分支边界规则；涉及 preview 分支、演示站专用功能、main 与 preview 合并、反向合并、演示站部署或公开演示能力修改时使用。

MallBase 支付回调（notify）验签、幂等、防重放与金额校验规则；处理任意支付渠道（微信 / 支付宝 / 银联）回调链路时使用。

MallBase 微信支付 SDK 在 Swoole 常驻进程下的无状态构造规则；接入或重构微信支付 / 公众号 / 小程序 SDK 调用时使用。

MallBase 文档链接与放置规范；仅在新增、移动、删除 docs/ 或 README 文档索引时使用。

MallBase 开源项目文案措辞规范；编写提交信息、文档、注释、备注或提示文案时使用。

MallBase ThinkPHP 三层架构边界规则；涉及 backend controller、service、model 分层开发或重构时使用。

MallBase ThinkPHP 后端测试基线；新增、修改或回归后端接口、服务、模型逻辑时使用。

MallBase ThinkPHP 列表查询构建规则；仅在实现或调整 Service::buildListQuery 与分页查询构建封装时使用。

MallBase ThinkPHP 商品主图与轮播图一致性规则；仅在处理商品主图和轮播图同步、保存或回填时使用。

MallBase ThinkPHP 商品媒体字段契约；处理商品主图、轮播图、主视频字段协议和接口契约变更时使用。

MallBase ThinkPHP 商品统一售卖单元规则；处理商品 SKU、规格、价格、库存或销售单元逻辑时使用。

MallBase ThinkPHP IDE 泛型注释规范；新增或调整 Controller、Service 注释与跳转类型时使用。

MallBase ThinkPHP 分页 list 和 total 条件同源规则；实现或修改分页列表、搜索筛选和 total 统计时使用。

MallBase ThinkPHP 分页返回 compact 规范；实现或调整分页接口返回 total 和 list 时使用。

MallBase ThinkPHP 框架边界规则；涉及 mall_base 底层、业务服务放置或跨层职责判断时使用。

MallBase ThinkPHP 地区快照失效规则；处理地区快照、地区变更、地址同步或历史数据一致性时使用。

MallBase ThinkPHP 后台路由与权限元数据规范；新增或调整 System 路由、菜单、权限字段时使用。

MallBase ThinkPHP 正式字段优先规则；仅在字段迁移、Schema 定型、移除过渡兼容或正式字段替换时使用。

MallBase ThinkPHP Swoole Service 无状态规则；实现或重构 Service、协程安全业务逻辑时使用。

MallBase ThinkPHP 先校验再事务规则；处理新增、更新、删除等写操作和事务一致性时使用。

MallBase UniApp 预留接口协议规则；仅在明确修改 frontend/uniapp 接口调用、响应结构或错误码处理时使用。

MallBase UniApp 预留认证规则；仅在明确修改 frontend/uniapp 登录态、Token 存储、刷新或失效处理时使用。

MallBase UniApp 预留模块结构规则；仅在明确新增或调整 frontend/uniapp 页面、组件、接口和业务模块时使用。

MallBase UniApp 预留规则索引；仅在明确涉及 frontend/uniapp 或需要选择移动端规则时使用。

MallBase Vben Admin 主题一致性规则；开发后台页面、组件样式或明暗色适配时使用。

MallBase Vben Admin API 路径参数一致性规则；仅在前端接口方法对接后端 /:id 路径参数时使用。

MallBase Vben Admin 后端驱动路由规则；新增或调整后台菜单、权限路由、页面路由和 System 路由映射时使用。

MallBase Vben Admin 真实后端 E2E 测试规则；执行或编写 web-antd 端到端回归测试时使用。

MallBase Vben Admin 商品规格切换状态规则；处理商品规格、SKU 表单、单规格与多规格切换时使用。

MallBase Vben Admin IconPicker 规范；实现或调整后台图标选择、菜单图标和图标表单字段时使用。

MallBase Vben Admin Modal 表单布局规范；新增或调整后台弹窗表单、字段布局和交互一致性时使用。

MallBase Vben Admin 前端规则索引；仅在需要浏览或选择后台前端规则、且无法确定具体 Vben skill 时使用。

MallBase Vben Admin 上传组件优先规则；仅在实现图片或文件上传 UI 交互并选择上传组件时使用。

MallBase Vben Admin 上传字段规范；仅在处理上传字段回填、FileInfo 转换和提交协议归一化时使用。

修改 frontend/admin/apps/web-antd 代码后使用局部格式化命令整理本次改动文件，避免把整个前端 monorepo 一起格式化。适用于 Vben Admin 页面、组件、API、路由与 composables 代码修改后的收口阶段。