feat(public): family-first contract — goodId=familyId, strict 5-dim price matrix

公开契约族化（前端只需知道款号/族）：
- GET /public/goods 一族一条（goodId=族ID，price=族起价，分页作用于分组后）；
  无族商品（自定义）不进任何公开端点（列表/首页/分类树/标签统计）
- GET /public/goods/:goodId 仅认族 ID；公共字段取代表 Good，变体=全体成员并集，
  尺码表/包装规格=族物化并集；旧 SDS 链接 ID 寻址 404
- priceMatrix 严格五维：尺码×颜色×印花数量×工艺×物流；维度来源改为链接级
  标签（人工接管按人工标签），弃用原始 craftLabel；CUSTOM 成员尊重显式标签
- 名称派生补裸「单面/双面」写法（直喷双面→双面印花+直喷，18 条存量链接修复）
- family_price_overrides 加 print_count 列（五键唯一），PUT/DELETE/校验五键化
- admin 编辑弹窗矩阵消费适配（SKU 列直读 printCount，成员格子三维匹配，
  改价 payload 带 printCount）
- 存量 339 族已全量重算；api 162/162、admin 22/22、双端构建绿

apps/api/src/product-families/product-families.service.ts

@@ -344,6 +344,7 @@ export class ProductFamiliesService {
           (r) =>
             r.sizeId === o.sizeId &&
             r.colorId === o.colorId &&
+            r.printCount === o.printCount &&
             r.craft === o.craft &&
             r.logistics === o.logistics,
         );
@@ -376,6 +377,7 @@ export class ProductFamiliesService {
     const allowed = {
       sizes: new Set((matrix?.sizes ?? []).map((s) => s.key)),
       colors: new Set((matrix?.colors ?? []).map((c) => c.key)),
+      printCounts: new Set(matrix?.printCounts ?? []),
       crafts: new Set(matrix?.crafts ?? []),
       logistics: new Set(matrix?.logistics ?? []),
     };
@@ -383,6 +385,7 @@ export class ProductFamiliesService {
       (i) =>
         !allowed.sizes.has(i.sizeId) ||
         !allowed.colors.has(i.colorId) ||
+        !allowed.printCounts.has(i.printCount) ||
         !allowed.crafts.has(i.craft) ||
         !allowed.logistics.has(i.logistics),
     );
@@ -392,6 +395,7 @@ export class ProductFamiliesService {
         invalidCells: invalid.map((i) => ({
           sizeId: i.sizeId,
           colorId: i.colorId,
+          printCount: i.printCount,
           craft: i.craft,
           logistics: i.logistics,
         })),
@@ -401,10 +405,11 @@ export class ProductFamiliesService {
     for (const item of items) {
       await this.prisma.familyPriceOverride.upsert({
         where: {
-          familyId_sizeId_colorId_craft_logistics: {
+          familyId_sizeId_colorId_printCount_craft_logistics: {
             familyId: id,
             sizeId: item.sizeId,
             colorId: item.colorId,
+            printCount: item.printCount,
             craft: item.craft,
             logistics: item.logistics,
           },
@@ -413,6 +418,7 @@ export class ProductFamiliesService {
           familyId: id,
           sizeId: item.sizeId,
           colorId: item.colorId,
+          printCount: item.printCount,
           craft: item.craft,
           logistics: item.logistics,
           price: new Prisma.Decimal(item.price),
@@ -435,6 +441,7 @@ export class ProductFamiliesService {
           familyId: id,
           sizeId: cell.sizeId,
           colorId: cell.colorId,
+          printCount: cell.printCount,
           craft: cell.craft,
           logistics: cell.logistics,
         },