perf(public): 公开读路径进程内分域缓存——meta/goods/matrix 版本域 + TTL 兜底 + in-flight 合并

- PublicCacheService：分域版本号失效（bump 即作废，不等 TTL）、loader 期间
  bump 的竞态防护（返回但不回写）、并发 miss 单飞、PUBLIC_CACHE_DISABLED
  /TTL_MS/MAX_ENTRIES 应急开关；@Global 模块
- PublicService 六端点接缓存：列表缓存全量物化（分页切片在缓存外按请求执行，
  修复'所有页返回第一页'的切片缓存错误）、详情/首页/树/标签组/树序元数据/
  族最低价聚合各按依赖域缓存
- 全写路径挂钩 bump：admin CRUD（goods/categories/countries/tags/tag-groups/
  positions/origin-goods 标签）、sync 三同步、族重算、整理全家桶——
  事务提交成功后失效对应域，product-families 经 recompute 天然覆盖
- 测试：PublicCacheService 单测 13 例 + 失效链路集成 8 例（读命中/写后立即可见
  端到端/每条写路径域断言）；既有两套件测数据语义改为显式禁缓存

apps/api/src/origin-goods/origin-goods.service.spec.ts

@@ -1,3 +1,4 @@
+import { PublicCacheService } from '../public/public-cache.service';
 import { Test } from '@nestjs/testing';
 import { OriginGoodsService } from './origin-goods.service';
 import { FamilyRecomputeService } from '../product-families/family-recompute.service';
@@ -15,7 +16,7 @@ describe('OriginGoodsService', () => {
 
   beforeAll(async () => {
     const moduleRef = await Test.createTestingModule({
-      providers: [OriginGoodsService, FamilyRecomputeService, ProductFamiliesService, OrganizeService, PrismaService],
+      providers: [OriginGoodsService, FamilyRecomputeService, ProductFamiliesService, OrganizeService, PrismaService, PublicCacheService],
     }).compile();
     service = moduleRef.get(OriginGoodsService);
     organize = moduleRef.get(OrganizeService);

apps/api/src/origin-goods/origin-goods.service.ts

@@ -8,6 +8,7 @@ import { PrismaService } from '../prisma/prisma.service';
 import { FamilyRecomputeService } from '../product-families/family-recompute.service';
 import { OrganizeService } from '../product-families/organize.service';
 import { ProductFamiliesService } from '../product-families/product-families.service';
+import { PublicCacheService } from '../public/public-cache.service';
 import { QueryOriginGoodDto } from './dto/query-origin-good.dto';
 
 /** 链接标签（origin_good_tags 行，含人工/派生标记） */
@@ -97,6 +98,7 @@ export class OriginGoodsService {
     private readonly familyRecompute: FamilyRecomputeService,
     private readonly organize: OrganizeService,
     private readonly families: ProductFamiliesService,
+    private readonly publicCache: PublicCacheService,
   ) {}
 
   /** 链接当前标签（含 manual 标记） */
@@ -171,6 +173,9 @@ export class OriginGoodsService {
       this.prisma.originGood.update({ where: { id }, data: { tagsManual: true } }),
     ]);
     await this.familyRecompute.mirrorLinkTagsToGoods(id);
+    // 标签镜像改变 good_tags（meta 域的标签组过滤）；无族链接挂靠失败时
+    // 后续 recompute 不会执行，此处显式 bump 兜住全部路径（含 matrix 归因）
+    this.publicCache.bump('meta', 'goods', 'matrix');
     // 人工改标签 → 归因维度可能变化，自动重算族矩阵（有族才重算）
     const ogFull = await this.prisma.originGood.findUnique({
       where: { id },
@@ -205,6 +210,7 @@ export class OriginGoodsService {
     ]);
     // 派生集中在整理服务（解析去运行时化）；「恢复自动」本身是显式人工动作
     await this.organize.deriveTagsForOg(id);
+    this.publicCache.bump('meta', 'goods', 'matrix');
     if (og.familyId) await this.familyRecompute.recomputeFamily(og.familyId);
     return this.getTags(id);
   }