docs(仓库): 规划文档改为入库,落盘品牌库/去重库每公司一套二期方案
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
This commit is contained in:
@@ -0,0 +1,277 @@
|
||||
# 品牌库 / 去重库 按公司隔离 · 二期设计方案
|
||||
|
||||
日期:2026-10-04 状态:**待评审,未开工**
|
||||
前置:一期(`company` 表 + `users.company_id`)已上线,见 `company-multi-tenant-design-2026-10-04.md`
|
||||
|
||||
---
|
||||
|
||||
## 0. 一句话
|
||||
|
||||
`biz_invalid_asin_data`(后台「品牌数据库」)与 `biz_dedupe_total_data`(「去重数据汇总」)今天是**全平台共享一套**的规则库:A 公司产生的行会过滤 B 公司的采集结果。本方案把它们改成**每公司一套**,租户键在这两张表上**破例物化为 `company_id`**(推翻一期"业务表零 DDL"口径,由用户 2026-10-04 拍定)。
|
||||
|
||||
分 3 批上,批次 1 对线上行为零变化,且**必须最先做**——它开始记录归属,晚做一天就多一天无法回填的历史。
|
||||
|
||||
---
|
||||
|
||||
## 1. 问题与证据
|
||||
|
||||
### 1.1 品牌库的自动导入行没有任何归属
|
||||
|
||||
| 事实 | 证据 |
|
||||
|---|---|
|
||||
| 批量 INSERT 的列清单只有 `(data_value, brand, record_source)`,没有 `group_id` | `modules/invalidasin/mapper/InvalidAsinDataMapper.java:22-27` |
|
||||
| 写入器 `toEntity` 方法签名不接任何归属参数 | `modules/collectdata/util/CollectDataInvalidAsinBatchWriter.java:65-79` |
|
||||
| 表有 `group_id` 列,但只有手工新增会写 | `db/V86__invalid_asin_data_group_access.sql:11`、`InvalidAsinDataService.java:88` |
|
||||
| 表**连 `user_id` 都没有** ⇒ 按一期口径无法派生公司 | `db/V94__invalid_asin_data_value_brand_unique_key.sql:4-13`(全列) |
|
||||
|
||||
⇒ 后台「分组」列显示"未分组"是这个原因(`InvalidAsinDataService.java:69` 把 `groupId==null` 映射成空串,前端 `admin-frontend-vue/src/pages/asin/AsinInvalidPage.vue:202` 渲染成"未分组")。
|
||||
|
||||
### 1.2 真正的越界在消费侧,且那里根本没有租户上下文
|
||||
|
||||
```
|
||||
CollectDataBatchQuery.java:75-78 select brand from biz_invalid_asin_data where brand in (...) ← 无分组/公司条件
|
||||
CollectDataBatchQuery.java:46 SELECT data_value FROM biz_dedupe_total_data WHERE data_value IN (...) ← 同样无条件
|
||||
```
|
||||
入口签名 `filter(List<CollectDataResultRowVo> rows)`(`:49`)里没有 task / user / company。
|
||||
|
||||
⇒ **A 公司自动导入的品牌,正在把 B 公司采集结果里同品牌的行过滤掉**;去重库同理,B 公司导入过的 ASIN 会让 A 公司的行被丢弃。这才是"数据越界"。
|
||||
|
||||
### 1.3 品牌库的非超管可见性被一条硬条件锁死
|
||||
|
||||
`InvalidAsinDataService.java:53-54`:非超管的列表条件是写死的 `record_source='MANUAL' AND group_id=固定组`。
|
||||
|
||||
⇒ 自动导入行对**所有非超管永久不可见**,与 `group_id` 有没有值无关。只补 `group_id` 不解决任何可见性。
|
||||
(对照:去重库没有这种硬条件,非超管走 `applyGroupScope` = `group_id IN 可访问组 OR (group_id IS NULL AND uploader_user_id IN 可见用户)`,`DedupeTotalDataService.java:1212-1232`。)
|
||||
|
||||
### 1.4 唯一键是全局单列/双列,装不下"每公司一套"
|
||||
|
||||
| 表 | 现唯一键 | 证据 |
|
||||
|---|---|---|
|
||||
| `biz_invalid_asin_data` | `uk_data_value_brand (data_value, brand(191))` | `db/V94:48` |
|
||||
| `biz_dedupe_total_data` | `uk_data_value (data_value)` | `db/V3:6` |
|
||||
|
||||
⇒ 同一个值全库只能存一行,谁先写归谁,后来者被 `INSERT IGNORE` 静默丢弃。**不改唯一键,"每公司一套"就是空话。**
|
||||
|
||||
---
|
||||
|
||||
## 2. 已定口径(用户 2026-10-04 拍定,勿重开)
|
||||
|
||||
1. 两张表都是**每公司一套**(不是全平台共享)。
|
||||
2. 租户键**破例物化为 `company_id` 列**,不用 `uploader_user_id` 派生、不复用店铺分组。
|
||||
—— 这推翻一期"不给业务表加 `company_id` 冗余列"(`db/V143:5-8`)与"不复用店铺分组当租户"两条,仅限这两张表。
|
||||
3. 一期"复用店铺分组当租户"被否掉的理由仍然成立(那 4 段 UNION 覆盖面窄、成员表已判废),所以 `group_id` **保留原语义**(店铺分组 = 操作维度),公司边界一律走新 `company_id`,两者不互相替代。
|
||||
|
||||
---
|
||||
|
||||
## 3. 三条硬前提(其中一条今天无法闭合)
|
||||
|
||||
**① `CompanyScopeSupport` 还不存在。** 一期只落了归属(company 表、`users.company_id`、建号/移人/登录回包/列表公司列),89 处数据出口一处没改——一期"对线上行为是零变化"(一期设计文档 `:19`)。本方案 §6-§8 实际是二期隔离工程的**第一块**,不是收尾。
|
||||
⇒ 落地时**必须一并建** `CompanyScopeSupport`(`currentCompanyId(user)` / `memberUserIds(companyId)` / `assertSameCompany(...)`,`role=super_admin` 按 role 豁免而非按 company_id 判),否则每张表各写一套取公司的逻辑。
|
||||
|
||||
**② 自动导入的归属账号是调用方自报的,阶段B 之前不可信。** 写入触发点 `POST /api/collect-data/tasks/{taskId}/result` 落在 `config/AdminApiGuardFilter.java:77` 的 `USER_TOOL_PREFIXES`,而 `aiimage.security.user-tool-guard-enabled` 默认 `false`(`:128`)。该文件 `:68-74` 的注释原话:「controller 无方法级鉴权(**归属由请求参数 user_id 判定**),匿名可达即越权读写他人数据」「桌面客户端直连这些接口且不带任何认证头」。
|
||||
⇒ 本方案的公司边界建立在 `task.getUserId() → users.company_id` 上,**能防住"诚实的串扰",防不住"伪造 user_id 的越权写入"**。这条只能在阶段B(设备令牌)闭合。不因此停工,但:
|
||||
- 文档与工单里必须写明"这两张表的隔离在阶段B 前是**部分强度**",别把"加了 company_id"当成已隔离;
|
||||
- 阶段B 工单必须把 `/api/collect-data` 收口列为**本方案的完成条件**,否则它会永远停在部分强度。
|
||||
|
||||
**③ 现在只有 1 家公司,改动今天不改变任何一行可见性。** 生产 `company` 表 1 行(id=1 厦门米椿花)、`users` 139 行 0 NULL(10-04 11:0x 实跑核对)。
|
||||
⇒ 好处:批次 1 的回填是确定性操作、零风险。坏处:容易觉得"不急"。**回填窗口是有时限的**——第二家公司开通之后,历史 AUTO 行里"实际由谁产生"已无法追溯(`biz_invalid_asin_data` 没有 uploader 列),只能全表填 1,那就永远分不清了。这是批次 1 必须现在做的唯一理由。
|
||||
|
||||
---
|
||||
|
||||
## 4. 目标数据模型
|
||||
|
||||
两张表各加两列,语义一致:
|
||||
|
||||
| 列 | 类型 | 说明 |
|
||||
|---|---|---|
|
||||
| `company_id` | `BIGINT NOT NULL DEFAULT 1` | 租户硬边界。**DEFAULT 1 是混合版本窗期的必需品**,见 §11.2,且必须被摘掉(§11.4) |
|
||||
| `uploader_user_id` | `BIGINT NULL` | 归属审计锚点,仅品牌库需要(去重库 `V75` 已有且已 NOT NULL) |
|
||||
|
||||
唯一键改为把租户键放进索引:
|
||||
|
||||
| 表 | 现 | 目标 | 索引字节预算(utf8mb4) |
|
||||
|---|---|---|---|
|
||||
| `biz_invalid_asin_data` | `uk_data_value_brand(data_value, brand(191))` | `uk_company_value_brand(company_id, data_value, brand(191))` | 8 + 128×4 + 191×4 = **1284 B** < 3072 ✅ |
|
||||
| `biz_dedupe_total_data` | `uk_data_value(data_value)` | `uk_company_data_value(company_id, data_value)` | 8 + 512×4 = **2056 B** < 3072 ✅ |
|
||||
|
||||
两条约束:
|
||||
- **不许改成前缀索引去迁就长度**。`db/V135:6-9` 已写明:去重库 `data_value` 带唯一索引,改前缀会把"前 N 字符相同"的不同值误判为重复、破坏去重语义。上面的字节数已逐个算过,不需要前缀。
|
||||
- 新唯一键相对旧的是**放宽**(旧键成立 ⇒ 新键必成立),所以"删旧索引 + 建新索引"**不可能因存量数据失败**。这一点要写进迁移用例断言,作为"为什么不需要先清历史冲突行"的依据(对照 `V94:16-25` 当年换键必须先 DELETE 冲突行,这次不需要)。
|
||||
|
||||
---
|
||||
|
||||
## 5. V145 迁移设计
|
||||
|
||||
取号:**V145**(当前 `db/` 最大 `V144`、共 143 个文件;取号规则与幂等要求见 `backend-java/docs/migration-inventory.md`)。
|
||||
|
||||
必须逐条满足(全部来自一期踩过的坑):
|
||||
|
||||
1. **每条语句幂等**:`ADD COLUMN` / `ADD INDEX` 先查 `information_schema` 再 `PREPARE`;`UPDATE` 用 `WHERE company_id IS NULL` 限定;`DROP INDEX` 先判存在。**理由**:`flyway repair` + 重启会让 Flyway 从第一条语句重跑整个文件,而 MySQL 的 DDL 不进事务,裸语句会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库"。
|
||||
2. **加列与建/删索引分条**,不塞进同一条 `ALTER`,以便失败时能判断停在哪一步。
|
||||
3. **回填**:`UPDATE ... SET company_id = 1 WHERE company_id IS NULL`,紧接一条**自检闸门**——用 `MODIFY ... NOT NULL` 之前先 `SIGNAL`/除零式断言残留 NULL 数为 0,让漏回填**报迁移失败**而不是静默通过(照 `V143` 的自检闸门写法)。
|
||||
4. **锁表风险**:`ADD COLUMN` 在 MySQL 8 是 INSTANT;`ADD UNIQUE INDEX` / `DROP INDEX` 是 INPLACE(重建索引,非 COPY 全表)。**行数必须在上线前于生产实查并回填本节**——不要拿后台列表里看到的最大 ID 当行数(`aiimage.sql` 快照的 `AUTO_INCREMENT` 有跳号,ID 上界 ≠ 行数,一期已为此订正过一次)。不碰 `biz_task_file_job` 等锁热点表。
|
||||
5. **验证 SQL 段**放文件末尾,且**上线时必须有人实跑**(一期欠的就是这条,见 §11.5):列存在性与 `COLUMN_DEFAULT`、唯一键字段组合、NULL 残留数、`INSERT IGNORE` 在新键下的幂等复验。
|
||||
6. **回滚不进 Flyway 扫描路径**:写 `docs/rollback-V145-company-scope.sql`,顺序照一期(停两台 → 跑脚本 → 删 `flyway_schema_history` 本版本行 → 回滚 jar → 起应用)。**不许编成 `V146`**。
|
||||
|
||||
---
|
||||
|
||||
## 6. 写入侧改造(逐入口)
|
||||
|
||||
### 6.1 品牌库 `biz_invalid_asin_data`
|
||||
|
||||
| 入口 | 位置 | company_id 从哪来 | uploader_user_id |
|
||||
|---|---|---|---|
|
||||
| 手工新增 | `InvalidAsinDataService.java:80-92` | 超管:请求显式指定并校验;非超管:**锁操作人本公司**(照 `resolveManualWriteGroup:126-135` 的同构规则) | = operatorId |
|
||||
| 编辑 | `:95-117` | **不许跨公司移动**:`company_id` 不出现在更新语句里 | 保留原值 |
|
||||
| 单行删除 | `:120-124` | 加 `assertSameCompany` 前置 | — |
|
||||
| 自动导入(采集回传) | `CollectDataInvalidAsinBatchWriter.java:38,65-79` | **方法签名加租户上下文参数**;由调用点从 `task.getUserId() → users.company_id` 解析 | = `task.getUserId()` |
|
||||
| 自动导入(品牌复检查注入) | `CollectDataBrandRecheckInjector.java:114` | 同上,作用域里已有 `FileTaskEntity task`(`:78`) | 同上 |
|
||||
|
||||
`insertBatchIgnore` 的列清单(`InvalidAsinDataMapper.java:22-27`)补 `company_id, uploader_user_id`。
|
||||
|
||||
### 6.2 去重库 `biz_dedupe_total_data`
|
||||
|
||||
写入口共 4 个,全部已有 `group_id` + `uploader_*`,只需**并排补 `company_id`**:手工新增(`DedupeTotalDataService.java:436-448`)、Excel 导入(`:894-945`,`insertBatchIgnore` 唯一调用点 `:922`)、删除导入(`:1168-1177`)、更新(`:1096-1106`,同样不许跨公司移动)。
|
||||
|
||||
`company_id` 取值规则与 6.1 一致:非超管锁操作人本公司,超管可显式指定。注意 `resolveWritableGroup:1234-1240` 现在对 `groupId<=0` 直接抛"请选择分组"——**公司要加一条同构的 fail-fast**,见 §10。
|
||||
|
||||
### 6.3 一个必须写进代码的约束
|
||||
|
||||
**写入路径不得依赖数据库 `DEFAULT 1` 兜住漏传。** 所有实体在进入 mapper 前 `company_id == null` 就必须抛异常。理由见 §11.2——这条 DEFAULT 在混合窗口里是必需的,但它同时会把"漏传"变成静默落公司 1,只能靠代码出口拦,不能靠 DB。
|
||||
|
||||
---
|
||||
|
||||
## 7. 读取侧改造(后台)
|
||||
|
||||
### 7.1 品牌库 `InvalidAsinDataService.page():34-77`
|
||||
|
||||
非超管条件从
|
||||
```java
|
||||
query.eq(recordSource, MANUAL).eq(groupId, fixedGroupId) // :53-54
|
||||
```
|
||||
改为
|
||||
```java
|
||||
query.eq(companyId, 本公司).eq(groupId, fixedGroupId) // 只去掉 MANUAL 硬条件
|
||||
```
|
||||
|
||||
**分组维度保持 `= 固定组`(`resolveFixedAccessibleGroupId:203-212`),不要顺手放宽成 `IN 可访问组`。** 理由:写侧 `resolveManualWriteGroup:126-135` 非超管只能落到固定组,读侧若用集合就会出现"看得到别人那组、却写不进自己这组"的错配。不变式钉成一条:**能写的那一组 = 能看到的那一组**。
|
||||
|
||||
**这条改动的可见性影响是刻意设计的,且是安全的**:历史自动导入行 `group_id IS NULL` ⇒ 被 `= 固定组` 天然排除,非超管不会一夜之间看到全部历史行;新写入的自动导入行带 `group_id` ⇒ 本组可见。**这正是"补 group_id"和"改读侧条件"必须同批的原因**(§1.3)。
|
||||
|
||||
超管:新增可选 `companyId` 过滤参数(照现有 `groupId` 过滤的写法 `:56-57`),不加默认过滤。
|
||||
|
||||
同时 `ensureRecordAccess:177-193` 里的 `!isManualRecord(entity) → 403` 分支要一并重做:判据从"是不是手工"换成"是不是本公司 + 本组",否则非超管看得到却改不了。
|
||||
|
||||
### 7.2 去重库 `applyGroupScope:1212-1232`
|
||||
|
||||
在现有条件外面**叠一层 `company_id`**,不替换 group 逻辑:
|
||||
- 非超管:`company_id = 本公司 AND (group_id IN 可访问组 OR (group_id IS NULL AND uploader_user_id IN 可见用户))`
|
||||
- 超管:可选 `companyId` 过滤
|
||||
|
||||
列表与导出共用同一个 wrapper(`selectCount` `:193`、`buildExportQuery:404-425`),改一处即覆盖两端——**但要逐条确认导出路径真的经过了 `applyGroupScope`**(`:423` 显示经过)。
|
||||
|
||||
### 7.3 分组删除保护
|
||||
|
||||
`invalidasin/service/GroupDeletionGuard.java:22` 与 `dedupe/service/GroupDeletionGuard.java:21-27` 都按 `group_id` 统计。本方案不改 group 语义 ⇒ 这两个类**不动**,但去重库那个已知的漏判(`group_id IS NULL` 的 uploader 行统计不到)要单独立项,**不在本方案里顺手改**。
|
||||
|
||||
---
|
||||
|
||||
## 8. 消费侧改造(隔离真正生效的地方)
|
||||
|
||||
`selectExistingDataValues` 的裸 SQL 有 **4 个**生产消费方,且存在一份**绕过 service 的平行实现**——这是本方案最容易漏改的地方:
|
||||
|
||||
| # | 位置 | 用途 | 拿得到 company 吗 |
|
||||
|---|---|---|---|
|
||||
| 1 | `CollectDataBatchQuery.java:58` | 采集结果按去重库过滤 | ✅ 调用点 `CollectDataService.java:835`(同方法 `:810` 已有 task)、`CollectDataBrandRecheckInjector.java:125`(`:78` 形参带 task) |
|
||||
| 2 | `CollectDataBatchQuery.java:75-78` | 采集结果按品牌库过滤 | 同上 |
|
||||
| 3 | `DedupeTotalDataService.java:472`(`findExistingComparableValues:457`)← 导入时判重(调用点 `:902`) | 决定哪些行不入库 | ✅ operatorId 在作用域 |
|
||||
| 4 | 同 3 ← `DedupeRunService.java:749` | **去重任务运行时判重,决定哪些行被去掉** | ✅ 任务 `userId`(`:155`) |
|
||||
|
||||
改造:
|
||||
- `CollectDataBatchQuery.filter(rows)` → `filter(rows, Long companyId)`,两条查询各加 `company_id` 条件。`filterByExistingAsin:41` 生产零调用(仅测试)⇒ **直接删**,别留第二个入口。
|
||||
- `findExistingComparableValues(Collection<String>)` → 加 `companyId` 形参,两个调用点各传自己的公司。
|
||||
- 消费侧与 §6 的写侧必须**同一批上线**:只改读不改写 ⇒ 新行 `company_id` 全落 DEFAULT 1,别的公司读不到自己刚写的东西,比现状更糟。
|
||||
|
||||
**业务后果(必须提前告知,不能上线后解释)**:真有多家公司时,每家只按自己的库过滤 ⇒ 被过滤行数下降、交付行数上升、下游 LLM 与代理调用量上升(代理按提取次数计费,见成本基线)。今天只有 1 家公司 ⇒ 上线时零变化,所以**不能拿"上线后没变化"当验收通过**,验收要用 §10 的护栏。
|
||||
|
||||
---
|
||||
|
||||
## 9. 前端(`admin-frontend-vue`,别和用户端 `frontend-vue` 混)
|
||||
|
||||
两页对称处理:`pages/asin/AsinInvalidPage.vue`(品牌数据库)、`pages/asin/DedupeRegistryPage.vue` + `dedupe-total-*.ts`(去重数据汇总)。
|
||||
|
||||
1. 新增「公司」列与筛选下拉,**仅超管可见**,照现有「分组」列的 `v-if="isSuperAdmin"` 模式(`DedupeRegistryPage.vue:335-340,377,390`)。
|
||||
2. 非超管:不显示公司列(它的公司是固定的,显示无意义),**也不许在请求里传 `companyId`** —— 后端一律按会话裁剪,前端传了要忽略。
|
||||
3. 超管的「新增/导入」弹窗要能选公司,且选了公司之后分组下拉要收窄到该公司下的组(否则会出现"公司 A + 只有 B 公司才有的分组"这种组合)。
|
||||
4. 品牌库页的「分组」列在批次 1 之后仍会大量显示"未分组"(历史行),**这是预期的**,文案要写清"未分组 = 该行为历史自动导入数据,无归属",不要让人以为改造没生效。
|
||||
|
||||
---
|
||||
|
||||
## 10. 护栏用例与变异自证
|
||||
|
||||
按"护栏做进代码出口、不写进注释"的既定要求,四支:
|
||||
|
||||
1. **迁移审计用例**(照 `CompanyMigrationV143Test` 12 例惯例):V145 幂等性、回填后 NULL 残留为 0、新唯一键字段组合逐字匹配、旧唯一键确已删除、`DEFAULT` 存在(混合窗口要求)与"摘 DEFAULT 的倒计时哨兵已登记"配对断言。
|
||||
2. **写出口扫描用例**:全仓扫 `INSERT INTO biz_invalid_asin_data` / `INSERT INTO biz_dedupe_total_data` 的 SQL 字面量,列清单**必须含 `company_id`**;扫两个 Entity 的 `setCompanyId` 在每个写方法里都被调用。以后新增写入口漏带归属会红,而不是静默落公司 1。
|
||||
3. **消费侧扫描用例**:`selectExistingDataValues` 的 SQL 必须含 `company_id`;`CollectDataBatchQuery` 的两条查询必须含 `company_id`;并断言 `filterByExistingAsin` 已不存在(防止有人把它当兼容入口复活,造成一条无租户条件的旁路)。
|
||||
4. **读侧用例**:非超管列表条件不得再出现 `record_source='MANUAL'`;`company_id` 过滤在超管/非超管两分支的有无。
|
||||
|
||||
**变异自证**(每条护栏各配注入点,全红才算数):把 §5 的回填 WHERE 去掉 / 从 INSERT 列清单删掉 `company_id` / 把消费查询的租户条件注释掉 / 把 `filterByExistingAsin` 加回来。遵守既有硬规矩:每轮开跑前所有被注入文件写回 pristine(还原只认注入前读进内存的字节,**不许 `git checkout`**)、CRLF 锚串先对齐行尾、分母只认本轮扫描结果。
|
||||
|
||||
---
|
||||
|
||||
## 11. 分批、上线顺序与失败模式
|
||||
|
||||
### 11.1 三批
|
||||
|
||||
| 批 | 内容 | 线上行为 |
|
||||
|---|---|---|
|
||||
| **1** | V145(加列 + 回填 + 唯一键替换)+ 写侧带 `company_id`/`uploader_user_id` + `CompanyScopeSupport` + 护栏 1/2 | **零变化**(1 家公司;唯一键放宽) |
|
||||
| **2** | 消费侧带租户条件(§8,4 个消费方) | 零变化(1 家公司),但这是隔离真正生效的一批 |
|
||||
| **3** | 读侧放开 `MANUAL` 硬条件(§7.1)+ 前端公司列 | 非超管开始看到**本组的新自动导入行** |
|
||||
|
||||
批次 1 单独有价值(开始记归属),可以先到这儿停住等第二家公司。**批次 2、3 不要拆开各自排期**——2 改了读侧不改,会出现"写带公司、读不带"的半套状态。
|
||||
|
||||
### 11.2 混合版本窗口:`DEFAULT 1` 是必需的,且失败很安静
|
||||
|
||||
Flyway 在应用启动期执行 ⇒ 第一台已改表、第二台仍是旧 jar(一期实测该窗口约 15 分钟)。旧 jar 的 `insertBatchIgnore` 列清单不含 `company_id`,若该列 `NOT NULL` 且无默认值,严格模式下报 `Field 'company_id' doesn't have a default value`。
|
||||
|
||||
**这个错误会被吞掉**:`CollectDataInvalidAsinBatchWriter.java:58-60` 对批量写失败只 `catch (RuntimeException) → log.warn` 后跳过整批。⇒ **结果是自动导入静默丢数据,接口仍返回成功**。所以:
|
||||
- V145 必须带 `DEFAULT 1`(与一期 `users.company_id` 同构的理由);
|
||||
- 批次 1 的验收**不能只看"两台没报错"**,必须实查新增行的 `company_id` 与 `uploader_user_id` 非默认、非 NULL(§11.5)。
|
||||
|
||||
### 11.3 发布顺序
|
||||
|
||||
两台 jar 必须同版,且批次 2 含新端点/新参数语义 ⇒ 金丝雀过了立刻补第二台,缩短 §11.2 窗口。逐节点复验**不能打 `0.0.0.0:18080`**(那是 nginx 轮询池),主机 B 的 java 在 `127.0.0.1:19080`。
|
||||
|
||||
### 11.4 摘 `DEFAULT` 的倒计时
|
||||
|
||||
`company_id DEFAULT 1` 的生命周期到**第二家公司开通为止**——此后任何漏传都会静默把数据落到厦门米椿花。到期动作:单独迁移摘掉(照 `V144` 对 `users.company_id` 的做法),并在 §10 护栏 1 里登记成"哨兵 + 倒计时"而不是注释。
|
||||
|
||||
### 11.5 上线时必须人工实跑的清单
|
||||
|
||||
1. 生产两表**行数**(回填耗时与锁风险评估输入,§5.4 现在还是空的);
|
||||
2. V145 末尾验证 SQL 全跑一遍;
|
||||
3. 批次 1 后 30 分钟内新增的品牌库行:`uploader_user_id IS NOT NULL` 且**等于产生它的那个 task 的 `user_id`**(该列无 DEFAULT,NULL 就直接证明写侧没传)。
|
||||
**一条必须承认的盲区**:`company_id` 这一列在只有 1 家公司时,**无法从数据本身区分"写侧显式传了"还是"被 DEFAULT 1 兜住了"**——两种情况的落库结果逐字节相同。所以不许把"company_id 都有值"当验收通过;这一条只能靠 §10.2 的源码护栏加下面第 4 条的实验来证。
|
||||
4. 批次 2 后:同一 ASIN 用两个不同 `company_id` 各插一次,第二条**必须成功**(证唯一键真的放宽了),验完删掉测试行。
|
||||
|
||||
---
|
||||
|
||||
## 12. 明确不做(YAGNI)
|
||||
|
||||
- 不给其余 55 张业务表加 `company_id`(破例只限这两张)。
|
||||
- 不动 89 处数据出口、不做跨公司汇总/对比报表。
|
||||
- 不改 `group_id` 的语义,不拿它当租户键。
|
||||
- 不顺手修去重库 `GroupDeletionGuard` 的 NULL 行漏判(单独立项)。
|
||||
- 不在本方案里实现阶段B 设备令牌——但它是本方案"隔离完成"的判定条件(§3.2)。
|
||||
- 不给品牌库历史行做"猜测式回填"(没有 uploader 列,猜不出来;全填 1 与今天事实一致)。
|
||||
|
||||
---
|
||||
|
||||
## 13. 待确认(开工前要答复)
|
||||
|
||||
1. **§3.2 的接受度**:确认"阶段B 之前这两张表的隔离是部分强度(防不住伪造 `user_id`)"这个定性可以被接受,且阶段B 工单会把 `/api/collect-data` 收口列为本方案的完成条件。
|
||||
2. **§7.1 的可见性口径**:非超管看得到"本组的自动导入行"、看不到"历史无组行"——这个切法是否就是你要的?(另一种是"本公司全部可见",那会让 15 个 admin 账号立刻看到全部历史自动导入行。)
|
||||
3. **§8 的成本后果**:多家公司后交付行数上升 → LLM/代理费用上升,是否已与业务对齐。
|
||||
4. **批次 1 是否单独排期先上**:它是唯一有时间敏感性的部分(第二家公司一开,归属就永久补不回来了)。
|
||||
Reference in New Issue
Block a user