yyw-code/MallBase

dev-schema-upgrade-sql

MallBase 数据库真相源、正式字段与升级 SQL 规则；修改 backend/install/data/schema 或 demo seed、新增/改名字段、移除运行时字段探测，或用户明确要求已有库升级、本地 upgrade SQL、发布迁移和 SimpleSqlMigrationService 时使用。

thinkphp

MallBase ThinkPHP 后端规则导航；仅在后端任务涉及多个场景、需要查找项目规则，或无法确定应读取哪个更具体的 ThinkPHP skill 时使用。

docs-linking

MallBase 文档放置与导航规范；新增、移动、删除 docs、模块文档、根 README 或 docs/index.md 导航时使用。

architecture-layering

MallBase ThinkPHP 后端分层、Swoole Service 无状态与 IDE 泛型规则；开发或重构 backend/app 下的 Controller、Service、Model，调整 BaseController/BaseService、service()/model() 调用、构造注入或协程安全状态时使用。

goods-media-contract

MallBase ThinkPHP 商品媒体与主图同步契约；处理 main_image、main_video、images、SKU/规格图片的素材 ID 保存、首图兜底、AssetIdNormalizer、AssetHydrator、full_url 回显或商品媒体字段变更时使用。

goods-sku-unified-sales-unit

MallBase ThinkPHP 商品统一售卖单元规则；处理 spec_type、spec_meta、单规格默认 SKU、多规格组合 SKU、价格库存汇总、SKU 图片、订单销售单元或商品规格兼容时使用。

list-query-sync

MallBase ThinkPHP 列表查询与分页返回规则；实现或调整 Service 的 buildListQuery、分页 list/total、动态筛选、关联查询、统计、导出或 compact('total', 'list') 返回时使用。

mall-base-boundary

MallBase ThinkPHP 框架边界规则；新增或修改 backend/mall_base 基类、驱动、日志、队列、框架服务，判断业务服务放置位置或扩展 DriverManager 驱动时使用。

payment-notify-idempotency

MallBase 支付与退款回调安全规则；修改 backend/route/notify.php、PayNotifyController、NotifyService、WechatPaymentResultService、mb_payment_log，或处理微信/其它渠道 webhook 的验签、解密、防重放、金额校验、幂等、事务与 HTTP 应答时使用。

route-permission-system

MallBase ThinkPHP 后台路由与权限元数据规则；新增或调整 backend/route/api/admin 路由、System 权限码、菜单元数据、/:id 路径参数、共享 _permission 或 sync:permissions 同步时使用。

validate-then-transact

MallBase ThinkPHP 写操作与事务规则；实现或修改 create、update、delete、状态流转、多表写入、余额库存变更、行锁、条件更新或并发一致性校验时使用。

wechat-pay-stateless

MallBase EasyWeChat 6.x 支付 SDK 无状态构造规则；修改 WechatPayFactory、WechatPayClient、支付/退款 Adapter、商户证书、平台公钥、AppID 场景选择，或排查 Swoole 下签名与凭据复用问题时使用。

uniapp

MallBase UniApp 核心规则；修改 frontend/uniapp 的页面、组件、接口、登录态或跨端行为时使用。

admin-theme-consistency

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

backend-driven-routing

MallBase Vben Admin 后端驱动路由与 API 契约规则；新增或调整后台菜单、权限路由、页面路由及前端接口定义时使用。

e2e-webantd-realapi

MallBase Vben Admin 局部格式化与真实后端 E2E 收口规则；修改、测试或回归 web-antd 代码时使用。

goods-spec-toggle-state

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

iconpicker-standard

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

upload-component-first

MallBase Vben Admin 上传组件与字段契约规则；实现图片、视频或文件上传，以及处理 FileInfo 回填和提交值时使用。

extension-slots

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

model-field-accessor-first

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

preview-branch-boundary

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

region-snapshot-invalid-on-change

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