This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-08-10
|
||||
@@ -0,0 +1,40 @@
|
||||
## Context
|
||||
|
||||
见 proposal.md。000178 在版本 140 之后尚未应用于生产库;其迁移前校验和唯一索引均把所有 `iccid_19` 纳入唯一范围,与双列模型中“20 位卡以完整 `iccid_20` 识别”的语义冲突。
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
|
||||
- 在测试环境验证版本 140 生产库所需的 ICCID 索引语义。
|
||||
- 为两种 ICCID 长度分别建立正确的唯一性约束。
|
||||
- 保持查询索引名称与现有代码兼容。
|
||||
|
||||
**Non-Goals:**
|
||||
|
||||
- 不清理、合并或修改现有卡数据。
|
||||
- 不改变 ICCID 查询接口或导入逻辑。
|
||||
|
||||
## Decisions
|
||||
|
||||
### 将 000178 的唯一范围限定为对应原始长度
|
||||
|
||||
`iccid_19` 冲突扫描和唯一索引增加 `length(iccid) = 19`;`iccid_20` 冲突扫描和唯一索引增加 `length(iccid) = 20`。
|
||||
|
||||
直接修正 000178,而不是新增后续迁移:生产库仍位于版本 140,必须能连续执行历史链路;新增迁移无法绕过 000178 的失败。该文件尚未在生产应用,变更需在上线前完成仓库内所有消费方同步。
|
||||
|
||||
### 保留双列格式校验
|
||||
|
||||
保留对 19/20 位原始值与派生列对应关系的校验,避免仅放宽唯一索引而掩盖错误回填。
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [测试库已处于更高迁移版本] → 直接按修正后的 000178 谓词定向重建两个索引并核对结果。
|
||||
- [其他环境已经执行旧版 000178] → 迁移内容不会自动重放;上线前以索引定义核对并按同一谓词重建。
|
||||
- [错误编辑已发布迁移] → 仅限生产首次执行前的本次兼容修正,发布说明记录文件校验值。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
1. 在测试环境停止卡写入后,按修正后的 000178 谓词定向重建两个 ICCID 唯一索引。
|
||||
2. 验证两个索引均为唯一索引且谓词按原始 ICCID 长度限定,并执行 19/20 位重复组检查。
|
||||
3. 测试完成后保留修正后的索引;不对生产库执行迁移或验证操作。
|
||||
@@ -0,0 +1,24 @@
|
||||
## Why
|
||||
|
||||
线上活跃的 20 位 ICCID 可以共享前 19 位,现有 000178 迁移却将全部活跃卡的 `iccid_19` 设为唯一,导致从版本 140 升级时必然中止。
|
||||
|
||||
## What Changes
|
||||
|
||||
- 修正 ICCID 唯一性迁移:仅对原始 ICCID 长度为 19 的活跃卡要求 `iccid_19` 唯一。
|
||||
- 保持原始 ICCID 长度为 20 的活跃卡以 `iccid_20` 为唯一标识,允许其共享 `iccid_19` 前缀。
|
||||
- 同步调整迁移前置校验、索引谓词与索引注释。
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
无。
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- `asset-device`: 明确 19 位与 20 位 ICCID 的有效唯一性边界。
|
||||
|
||||
## Impact
|
||||
|
||||
- `migrations/000178_make_iot_card_iccid_exact_unique.up.sql`
|
||||
- 测试环境中的定向索引修复验证;不改变卡数据或 HTTP API,也不对生产库执行迁移。
|
||||
@@ -0,0 +1,15 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: ICCID 按原始长度精确唯一
|
||||
|
||||
系统 SHALL 将未删除卡的 ICCID 唯一性按原始 ICCID 长度分别约束:原始长度为 19 的卡以 `iccid_19` 唯一;原始长度为 20 的卡以 `iccid_20` 唯一。20 位 ICCID 卡共享相同的前 19 位 SHALL 被视为有效数据。
|
||||
|
||||
#### Scenario: 20 位 ICCID 共享前缀
|
||||
|
||||
- **WHEN** 两张未删除卡具有不同的 20 位完整 ICCID,但其前 19 位相同
|
||||
- **THEN** 数据库接受两张卡,并通过各自的 `iccid_20` 保证完整 ICCID 唯一
|
||||
|
||||
#### Scenario: 19 位 ICCID 重复
|
||||
|
||||
- **WHEN** 两张未删除卡具有相同的 19 位完整 ICCID
|
||||
- **THEN** 数据库拒绝第二张卡的重复值
|
||||
@@ -0,0 +1,10 @@
|
||||
## 1. 迁移修正
|
||||
|
||||
- [x] 1.1 修正 000178 的 19 位冲突扫描和唯一索引谓词,仅覆盖原始长度为 19 的活跃卡。
|
||||
- [x] 1.2 修正 000178 的 20 位冲突扫描、唯一索引谓词和迁移注释,使其仅覆盖原始长度为 20 的活跃卡。
|
||||
|
||||
## 2. 验证
|
||||
|
||||
- [x] 2.1 在测试环境按修正后的 000178 谓词定向重建两个 ICCID 唯一索引。
|
||||
- [x] 2.2 校验两个索引均为唯一索引、谓词按原始 ICCID 长度限定,并核对 19/20 位重复组。
|
||||
- [x] 2.3 运行 OpenSpec 校验并记录测试环境定向修复结果。
|
||||
Reference in New Issue
Block a user