메뉴
MallBase 数据库变更同时维护 schema 真相源与 git-ignored 幂等增量升级 SQL；新增/修改表、字段、初始数据时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
MallBase 扩展槽边界规范；涉及会员、积分、分销、余额、优惠等权益扩展接入订单、商品编辑或 UniApp 展示时使用。
MallBase ThinkPHP 后端规则索引；仅在需要浏览或选择后端规则、且无法确定具体 ThinkPHP skill 时使用。
MallBase 已有库升级 SQL 边界规则；只有用户明确要求考虑已有库升级、测试服/线上升级或 upgrade SQL 时使用。
MallBase ThinkPHP 模型字段访问器与素材回显规则；在 Model 字段读写、访问器、修改器、with 关联、素材 ID 回显或 Service 字段组装优化时使用。
MallBase preview 演示站分支边界规则；涉及 preview 分支、演示站专用功能、main 与 preview 合并、反向合并、演示站部署或公开演示能力修改时使用。
MallBase 支付回调（notify）验签、幂等、防重放与金额校验规则；处理任意支付渠道（微信 / 支付宝 / 银联）回调链路时使用。
| name | dev-schema-upgrade-sql |
| description | MallBase schema 真相源与幂等升级 SQL 规则；升级 SQL 仅在用户明确要求已有库升级时使用。 |
deploy/install/data/schema/*.sql 增加/修改字段、表、初始数据deploy/install/data/demo/*.sql 增加/修改演示数据mb_setting / mb_goods / mb_user 等表的 seed 调整已有库升级 SQL 只有在用户明确要求考虑“已有库升级”“升级 SQL”
“测试服/线上升级”或等价场景时才纳入任务。未明确要求时，
不要主动规划、创建或提醒 deploy/install/data/upgrade/ / backend/install/data/upgrade/
升级 SQL；先按当前任务真相源收口。
如需判断是否应该考虑升级 SQL，先读取并遵循
thinkPHP/upgrade-sql-explicit-request。
全新安装会按顺序执行 schema/*.sql。但已部署环境（测试服 / 线上）不会重装，
新增的 schema 文件不会自动补到这些库上 —— 典型故障：代码引用了新表，
线上报 Base table or view not found。但这类已有库升级只在用户明确要求时纳入任务。
deploy/install/data/schema/*.sql，保证全新安装即正确。deploy/install/data/upgrade/ 下新增一个对应的增量文件，
命名 YYYY_MM_DD_<简述>.sql（如 2026_05_20_payment_log.sql）。CREATE TABLE IF NOT EXISTS，禁止 DROP TABLE。ALTER，或用等效幂等写法。INSERT ... ON DUPLICATE KEY UPDATE 或先 DELETE 再 INSERT。deploy/install/data/upgrade/ 已在 .gitignore，
增量 SQL 属于按环境手动执行的运维产物，不提交 git。mb_schema_upgrade 之类的记录表。deploy/install/data/schema/<对应>.sql（真相源）。deploy/install/data/upgrade/ 新增幂等的 YYYY_MM_DD_<简述>.sql。mysql -h<HOST> -u<USER> -p <DB> < deploy/install/data/upgrade/<文件>.sql❌ 用户明确要求已有库升级时，只改 schema/10_xxx.sql，不补 upgrade 增量
❌ upgrade 文件里写 DROP TABLE ← 重复执行会丢数据，非幂等
❌ 把 deploy/install/data/upgrade/*.sql 提交 git ← 属于运维产物，不入库
✅ schema/10_mb_payment_log.sql + upgrade/2026_05_20_payment_log.sql（CREATE TABLE IF NOT EXISTS）