feat(公司tab): 批次 2/3/4 再接 8 页,注册表收到 16 页——用户页回流 company_id 按新边界改写反向钉
「切 tab 数据还一样」的根因一直是分母小于现实:批次 1 只登记 8 页,本轮按控制方 三次点名扩到 16 页(company-scope.ts 是唯一清单,routes.ts 的 companyScoped 逐页对平)。 批次 2(五页 ASIN 中心):去重总数据 / 不符合ASIN / 查询ASIN / 最低价ASIN / 商品类目。 批次 3(两页店铺中心):撞款监控、店铺数据记录。这两页没有归属列可筛,归属口径是 「本公司账号名下的店铺」——后端由 DataReadScope 推公司 → 成员账号 → biz_shop_manage. created_by_id,前端只把 activeId 当 company_id 送下去。空成员集必须交空集合,绝不能 退化成 null(null 在这里=全量,那样第二家会看到全部数据)。 批次 4(用户管理):后端早就认 company_id(只对站点超管生效,公司超管恒锁本公司), 断的是前端——UserListQuery 里连这个字段都没有,三家 tab 看的是同一份全量列表。 三处口径改动,逐条说明: 1)company-user-list.test.ts 的反向钉被改写。2026-10-04 定案把公司维度从用户页整体摘掉, 那条钉的原文是「列表查询/筛选/行渲染不允许出现公司维度」。控制方 2026-10-05 明确要 用户管理区分公司 tab,所以钉的边界收窄成两半:渲染层(行级公司列、「所属公司」标签、 筛选状态、顶栏公司名)仍不得回流;请求层的 company_id 是这次加回来的,尺子换成 「取值口唯一」——页面每处 companyId 都必须等于 companyTab.requestCompanyId,且 normalizeUserPageParams/toUserListQuery 两只白名单构造器体内不许出现公司值。 新增一支行为钉:往归一化里传 companyId 必须被丢掉,这是 users.ts 读原始入参的全部理由 (写成 normalized.companyId 时 TS 照样绿、运行时恒 undefined)。 2)align-dup-console 那条 watch 看守的 token 扩到含 reload。变异自证里「删掉 void loadConsole()」当场全绿:体里的清筛选项守住了,重新取数那半没人守。批次 3/4 三对 token 一起写到 reload 为止(批次 1/2 的老条目不动)。 3)公司管理页补正/反向两把尺子:company-config-entry-super-only 新增「吃公司 tab 的页面 集合恰好等于 COMPANY_SCOPED_PAGES 的 pageFiles」——按代码真值比,不按清单比,所以 清单不改一字而往 CompaniesPage.vue 里塞 store 也会红。谓词带括号,否则 import 行也算消费者。 菜单权限(admin_columns)本轮不动:MenusPage 只消费 /api/admin/permission-menus 这一份全局 菜单字典,切 tab 一样是数据本身全局,不是筛选坏了。真问题在写侧——PermissionMenuService create/update/delete 只有 ensureAdminOperatorIfPresent(isAdmin 即放行),公司管理员改的是 全平台的菜单行。收窄为仅站点超管 vs 给 permission_menu 加归属列,两种改法代价差一个量级, 留给控制方定档。 护栏:G1 发送口 22 个 / 页面分组 17、watch 体看守 10 对、operation-guide 的 tab 文案 15 页 (撞款监控是显式豁免,另有一条自检盯「豁免落空」)。 变异自证 12/12 全杀(前端 10 + 公司管理反向钉 2),分母钉死在 27 例。 门禁:后端全量 3823 例 / 0 失败 / 0 错误 / 7 skipped,BUILD SUCCESS;admin-frontend-vue 1741 例 / 0 红;vue-tsc rc=0。首轮后端 4 红是另一路 task_partial 改动与本轮编译抢跑, 单跑 13 例已绿,本笔不含他们的任何文件。 未上线:jar 与 admin-vue 都没出包,V147 未在生产执行。
This commit is contained in:
@@ -0,0 +1,129 @@
|
||||
-- =============================================================
|
||||
-- 迁移 V147__product_category_company_scope
|
||||
-- 模板:docs/flyway-migration-template.md
|
||||
-- 设计:crawler-plugin/docs/ops/brand-dedupe-company-isolation-design-2026-10-04.md §2.2(规则库每公司一套)
|
||||
-- 需求:2026-10-05「商品类目也要区分公司,切换 tab 数据显示还一样」
|
||||
--
|
||||
-- 1. 变更目的:把「商品类目」biz_product_category 从"全平台一棵树"改成"内置节点共享 + 每公司自己的自定义节点"。
|
||||
-- 现状是这张表一个归属列都没有(2026-10-05 22:29 主机A 只读实查,列清单为
|
||||
-- id/parent_id/name/category_key/sort_order/description/is_builtin/created_at/updated_at,共 9 列),
|
||||
-- 所以后台的公司 tab 在这一页是纯装饰:切到哪一家都是同一棵 412 行的树。
|
||||
-- 同时 uk_product_category_key(category_key) 是【全平台】唯一键——第 2 家公司在第 1 家建过的
|
||||
-- 父级下重名建类时,generateCategoryKey(parentId, name) 会算出同一个 sha1 前缀而撞键,
|
||||
-- 这不是"看不到",是"根本建不出来"。company_id 打头的新唯一键解掉它。
|
||||
--
|
||||
-- 2. 口径:内置节点取哨兵公司 0,自定义节点归建号那一家。
|
||||
-- 【为什么是 0 而不是把 18 行内置节点按公司复制一份】
|
||||
-- - company.id 是 AUTO_INCREMENT,最小值 1,0 永远不会撞上真实公司;
|
||||
-- CompanyScopeSupport.requireCompanyId 对 <= 0 直接抛 ⇒ 没有任何账号能被登记成公司 0。
|
||||
-- - 货源/外观的类目归类读的是【全局】那一棵树(SimilarAsinLlmService:215 调 list() 无参重载),
|
||||
-- 复制成每公司一份会让同一个"面霜"有 N 个 category_key,LLM 的分类结果从此按公司分叉、
|
||||
-- 并且每一次归类候选都变多——这是成本,不只是口径。
|
||||
-- - 复制还要回填 394 行自定义节点的父子指向,而 parent_id 是全表 id,改不动。
|
||||
-- 【代价,必须写明】第 2 家公司的 tab 里只看得见 18 个内置节点,自建节点从 0 开始长;
|
||||
-- 而 394 行自定义节点全部回填成公司 1——这不是猜:这些行是"手工建的类目",
|
||||
-- 今天能建类目的只有第 1 家的账号(第 2 家 10-04 14:55 才开通、名下 0 个任务),
|
||||
-- 且这张表【没有】任何账号列,事后无法反推。所以这一页的写侧必须从本版本起显式落公司
|
||||
-- (见下方 DEFAULT 的临时性),否则新行又要靠默认值兜、下一次就彻底分不开了。
|
||||
--
|
||||
-- 3. 影响表与数据量(2026-10-05 22:29 主机A 业务库只读实查,不是估的):
|
||||
-- biz_product_category = 412 行(内置 18、自定义 394;parent_id IS NULL 26,其中自定义根 22;MAX(id)=600)
|
||||
-- 同一 (parent_id, name) 的重复组合 = 0 组 ⇒ 加列与换键都不会撞新唯一键。
|
||||
-- company / columns / users 与其余业务表一律不动。
|
||||
--
|
||||
-- 4. 锁表风险:低。412 行的表,任何形态的 DDL 都在毫秒级。
|
||||
-- 仍然按 V145 的规矩写:ADD COLUMN 走 ALGORITHM = INSTANT(前提不成立时 MySQL 直接报 1846,
|
||||
-- 而不是悄悄退化成 COPY——宁可迁移失败走 repair 重跑,也不要一次没人预期的重建);
|
||||
-- 两条索引操作钉 ALGORITHM = INPLACE, LOCK = NONE。
|
||||
-- 只有一条 UPDATE:驱动条件是 is_builtin = 1(18 行),不依赖别的表,不碰锁热点表。
|
||||
-- 索引字节预算(utf8mb4 + DYNAMIC,上限 3072):uk_company_category_key = 8 + 128*4 = 520。
|
||||
-- 【不加 idx_product_category_company】新唯一键的最左前缀就是 company_id,412 行的
|
||||
-- WHERE company_id IN (0, ?) 走它或走全表扫描都在同一量级;再单开一个列索引就是 V139 那轮
|
||||
-- 清理掉的冗余索引形状。
|
||||
--
|
||||
-- 5. 回滚步骤:人工补丁 backend-java/docs/rollback-V147-product-category-company.sql(在 Flyway 扫描路径之外,
|
||||
-- 不写成 V148——版本化回滚等于让"决定回滚"这件事在没有人工执行的情况下自己发生)。
|
||||
-- 顺序:停两台应用 → 跑脚本 → 删 flyway_schema_history 的 version=147 行 → 回滚 jar → 起应用。
|
||||
--
|
||||
-- 6. 上线窗口:随 jar 双节点同窗口发布,金丝雀过了立刻补第二台,把混合版本窗口压到分钟级。
|
||||
-- DEFAULT 1 是【临时】的,唯一存在理由是同批的旧 jar:它的 ProductCategoryEntity 没有
|
||||
-- companyId 字段,MyBatis-Plus 的 insert 会整列跳过,严格模式下报 1364。
|
||||
-- 和 V145 那张 50.7 万行的表不同,本表的历史值是由第 2 段【显式 UPDATE】写进去的,
|
||||
-- 所以摘 DEFAULT 不需要回填:下一版迁移只需一条元数据操作
|
||||
-- ALTER TABLE biz_product_category ALTER COLUMN company_id DROP DEFAULT;
|
||||
-- (禁止写成 MODIFY COLUMN ... NOT NULL——那会重建表,而重建按"当时的列默认值"物化历史行。)
|
||||
-- 在摘掉之前,启动期 CompanyDefaultGuard 会把本表一并盯住(WATCHED_TABLES 已加入
|
||||
-- biz_product_category),公司数 > 1 且本列还带 DEFAULT 就打 COMPANY_DEFAULT_STILL_PRESENT,
|
||||
-- 巡检按这条 ASCII 签名 grep——"漏摘"由代码喊,不靠人记得。
|
||||
--
|
||||
-- 【可重跑性】MySQL 的 DDL 不进事务。本迁移若在换键段失败,前面的加列与回填已落库;
|
||||
-- 按「补数据 → flyway repair → 重启」恢复时 Flyway 从第一条语句重跑整个文件,所以两条 DDL
|
||||
-- 都先查 information_schema 再 PREPARE,那条 UPDATE 自带 company_id = 1 限定(重跑是 no-op)。
|
||||
-- 写法首例见 V143 全文件、V145 的加列/换键段。
|
||||
-- =============================================================
|
||||
|
||||
SET @db_name = DATABASE();
|
||||
|
||||
-- ---------- 1. 加列(末位 + INSTANT) ----------
|
||||
|
||||
SET @col_exists := (SELECT COUNT(*) FROM information_schema.COLUMNS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_product_category' AND COLUMN_NAME = 'company_id');
|
||||
SET @sql := IF(@col_exists = 0,
|
||||
'ALTER TABLE `biz_product_category` ADD COLUMN `company_id` bigint NOT NULL DEFAULT 1 COMMENT ''归属公司(company.id):0 = 平台内置共享节点,> 0 = 该公司自建;V147'', ALGORITHM = INSTANT',
|
||||
'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
-- ---------- 2. 内置节点改挂哨兵公司 0 ----------
|
||||
-- 18 行,走 is_builtin 条件而不是 category_key 白名单:V50 的种子后来被删过(种子 24 行、
|
||||
-- 今天 18 行),按标志位才不会漏也不会多。带 company_id = 1 限定 ⇒ 重跑是 no-op。
|
||||
|
||||
UPDATE `biz_product_category`
|
||||
SET `company_id` = 0
|
||||
WHERE `is_builtin` = 1
|
||||
AND `company_id` = 1;
|
||||
|
||||
-- ---------- 3. 唯一键按公司放宽(先 ADD 后 DROP:中间任一步失败都至少还有一个唯一键在守并发) ----------
|
||||
-- 新键是旧键的严格放宽(旧键全平台唯一 ⇒ 新键必唯一),所以这一步不可能因重复而失败。
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_product_category' AND INDEX_NAME = 'uk_company_category_key');
|
||||
SET @sql := IF(@idx_exists = 0,
|
||||
'ALTER TABLE `biz_product_category` ADD UNIQUE KEY `uk_company_category_key` (`company_id`, `category_key`), ALGORITHM = INPLACE, LOCK = NONE',
|
||||
'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
SET @idx_exists := (SELECT COUNT(DISTINCT INDEX_NAME) FROM information_schema.STATISTICS
|
||||
WHERE TABLE_SCHEMA = @db_name AND TABLE_NAME = 'biz_product_category' AND INDEX_NAME = 'uk_product_category_key');
|
||||
SET @sql := IF(@idx_exists > 0,
|
||||
'ALTER TABLE `biz_product_category` DROP INDEX `uk_product_category_key`, ALGORITHM = INPLACE, LOCK = NONE',
|
||||
'SELECT 1');
|
||||
PREPARE stmt FROM @sql;
|
||||
EXECUTE stmt;
|
||||
DEALLOCATE PREPARE stmt;
|
||||
|
||||
-- =============================================================
|
||||
-- 验证 SQL(迁移后在库上执行)
|
||||
-- SELECT COUNT(*) AS total, SUM(company_id = 0) AS builtin_shared,
|
||||
-- SUM(company_id = 1) AS company_1, SUM(company_id NOT IN (0, 1)) AS other_company
|
||||
-- FROM `biz_product_category`;
|
||||
-- -> 期望 412 / 18 / 394 / 0。builtin_shared 必须等于 SUM(is_builtin = 1):
|
||||
-- 不等就是回填漏了行,而漏掉的内置节点会从第 2 家的类目树里静默消失。
|
||||
-- SELECT SUM(is_builtin = 1 AND company_id <> 0) AS bad_builtin,
|
||||
-- SUM(is_builtin = 0 AND company_id = 0) AS bad_custom
|
||||
-- FROM `biz_product_category`;
|
||||
-- -> 期望 0 / 0(哨兵值只给内置行用)
|
||||
-- SHOW INDEX FROM `biz_product_category`;
|
||||
-- -> 期望有 uk_company_category_key(company_id, category_key) 且【没有】uk_product_category_key
|
||||
-- SELECT company_id, category_key, COUNT(*) c FROM `biz_product_category`
|
||||
-- GROUP BY company_id, category_key HAVING c > 1;
|
||||
-- -> 期望 0 行(新键能建起来的前提)
|
||||
-- SELECT COUNT(*) FROM information_schema.COLUMNS
|
||||
-- WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'biz_product_category'
|
||||
-- AND COLUMN_NAME = 'company_id' AND COLUMN_DEFAULT IS NOT NULL;
|
||||
-- -> 本版本发布后期望 1(DEFAULT 1 还在,由 CompanyDefaultGuard 喊);
|
||||
-- 摘 DEFAULT 的那一版之后必须变 0
|
||||
-- =============================================================
|
||||
Reference in New Issue
Block a user