按手机号提取 m0 sms_send_record 最近一条验证码(buss_type=验证码+soft_delete=0+id DESC 首条),正则提取 4-8 位数字码,send_state 不过滤并配文案,返回 ageSeconds 供判断 90s redis 有效期。零行级权限,安全模型靠专用 scope 门禁:prod 只绑研发专用 scope 6、dev 只绑 测试专用 scope,显式排除业务 scope(全平台唯一)。王恒拍板 4 决策点全部按建议值执行。 测试:SmsToolsTest 10 例全绿;测试环境冒烟 4/4(有记录提取/无记录 notice/非法入参/ operation scope 拒绝)。
数据库迁移规范
自有库结构由 Flyway 管理,运行时只扫描 src/main/resources/db/migration。
- 已合并的
V<N>__description.sql永不修改、删除或改名;Flyway 与测试都会校验历史 checksum。 - 每次结构或数据变更新增下一个连续版本,并同步新增
sql/rollback/V<N>__description.down.sql。 - Migration 只操作当前 svc schema,禁止包含
CREATE DATABASE、USE和环境专属数据。 - DDL 优先向后兼容;删除字段或表必须先经过废弃版本。大表变更必须给出锁表时间与分批方案。
seed-dev.sql仅用于开发数据,不进入 Flyway。数据库首次创建使用bootstrap/create-database.sql。- 合并前必须运行
./mvnw clean package;部署启动时 Flyway 会再次 validate 并按版本迁移,失败则应用不会启动。
baseline-on-migrate 默认关闭,避免连错非空库时被静默接管。已有 V1 数据库首次接入时,显式设置 SVC_FLYWAY_BASELINE_ON_MIGRATE=true:Flyway 记录 V1 基线并只执行 V2 以后版本;确认生成 flyway_schema_history 后立即恢复为 false。空数据库无需开启,会正常执行全部版本。