@tbox.cn/app-provider-mock 0.2.0 → 0.3.0

package/src/server/promotion.ts

@@ -1,7 +1,9 @@
 /**
  * Mock promotion 实现（provider-mock 自持——R3-1 裁决）。演示面最小集：搜索/精查/推荐/
  * 资产列表/活动列表/领取闭环（acquire 恒 SUCCEEDED）。demo ref 恒 `demo:` 前缀，厂商中立。
+ * config 消费：PROMOTION_CFG_DEFAULTS 为契约单源（fail-soft 快照；双锁测试 tests/config-schema.test.ts）。
  */
+import { resolveConfig, type CfgDefaults } from './config';
 import type {
   PromotionOffer,
   PromotionOfferPage,
@@ -27,51 +29,16 @@ export type MockPromotionService = PromotionOfferQueryPort &
 const now = () => new Date().toISOString();
 const inDays = (d: number) => new Date(Date.now() + d * 86400_000).toISOString();
 
-const DEMO_OFFERS: PromotionOffer[] = [
-  {
-    offerRef: 'demo:coupon:1001',
-    offerType: 'COUPON',
-    title: '满 100 减 20 元券',
-    subtitle: '全场通用（mock 演示）',
-    tags: ['通用'],
-    validity: { start: now(), end: inDays(30) },
-    facets: [{ kind: 'COUPON', discountType: 'AMOUNT', value: 2000, thresholdCents: 10000 }],
-    availability: { status: 'AVAILABLE', reasonCodes: [], evaluatedAt: now(), authoritative: false },
-    participation: { mode: 'CLAIM_THEN_PURCHASE', steps: [{ title: '领取', description: '点击领取后自动存入卡包' }] },
-  },
-  {
-    offerRef: 'demo:groupon:2001',
-    offerType: 'GROUPON',
-    title: '餐饮双人套餐 5 折',
-    subtitle: 'mock 演示团购',
-    tags: ['餐饮'],
-    validity: { start: now(), end: inDays(15) },
-    facets: [{ kind: 'GROUPON', requiredParticipants: 2 }],
-    availability: { status: 'AVAILABLE', reasonCodes: [], evaluatedAt: now(), authoritative: false },
-    participation: { mode: 'CLAIM_THEN_PURCHASE', steps: [{ title: '购买', description: '按团购价下单' }] },
-  },
-];
-
-const DEMO_ENTITLEMENTS: PromotionEntitlement[] = [
-  {
-    entitlementRef: 'demo:entitlement:1',
-    offerRef: 'demo:coupon:1001',
-    title: '满 100 减 20 元券',
-    entitlementType: 'COUPON',
-    status: 'EFFECTIVE',
-    codeMasked: 'DEMO-****-1001',
-  },
-];
-
-const DEMO_ACTIVITIES: PromotionActivity[] = [
-  {
-    activityRef: 'demo:activity:3001',
-    title: '示例商场周年庆',
-    subtitle: 'mock 演示活动',
-    registrationRequired: false,
-    offerRefs: ['demo:coupon:1001'],
-  },
-];
+/** config 契约单源（键集/缺省/整数约束；tests/config-schema.test.ts 双锁） */
+export const PROMOTION_CFG_DEFAULTS = {
+  couponTitle: '满 100 减 20 元券',
+  couponValueCents: 2000,
+  couponThresholdCents: 10000,
+  couponValidityDays: 30,
+  grouponEnabled: true,
+  activityTitle: '示例商场周年庆',
+} as const satisfies CfgDefaults;
+export const PROMOTION_CFG_INT_KEYS = ['couponValueCents', 'couponThresholdCents', 'couponValidityDays'];
 
 const emptyPage = (): PromotionOfferPage & PromotionEntitlementPage & PromotionActivityPage => ({
   items: [],
@@ -79,11 +46,65 @@ const emptyPage = (): PromotionOfferPage & PromotionEntitlementPage & PromotionA
 });
 
 export class MockPromotionServiceImpl implements MockPromotionService {
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ PROMOTION_CFG_DEFAULTS） */
+  private readonly cfg: typeof PROMOTION_CFG_DEFAULTS;
+  /** 供/资产/活动三表（构造期按 cfg 构建——请求级实例，成本可忽略） */
+  private readonly offers: PromotionOffer[];
+  private readonly entitlements: PromotionEntitlement[];
+  private readonly activities: PromotionActivity[];
+
+  constructor(config: unknown = {}) {
+    this.cfg = resolveConfig(config, PROMOTION_CFG_DEFAULTS, PROMOTION_CFG_INT_KEYS);
+    const ts = now();
+    const couponOffer: PromotionOffer = {
+      offerRef: 'demo:coupon:1001',
+      offerType: 'COUPON',
+      title: this.cfg.couponTitle,
+      subtitle: '全场通用（mock 演示）',
+      tags: ['通用'],
+      validity: { start: ts, end: inDays(this.cfg.couponValidityDays) },
+      facets: [{ kind: 'COUPON', discountType: 'AMOUNT', value: this.cfg.couponValueCents, thresholdCents: this.cfg.couponThresholdCents }],
+      availability: { status: 'AVAILABLE', reasonCodes: [], evaluatedAt: ts, authoritative: false },
+      participation: { mode: 'CLAIM_THEN_PURCHASE', steps: [{ title: '领取', description: '点击领取后自动存入卡包' }] },
+    };
+    const grouponOffer: PromotionOffer = {
+      offerRef: 'demo:groupon:2001',
+      offerType: 'GROUPON',
+      title: '餐饮双人套餐 5 折',
+      subtitle: 'mock 演示团购',
+      tags: ['餐饮'],
+      validity: { start: ts, end: inDays(15) },
+      facets: [{ kind: 'GROUPON', requiredParticipants: 2 }],
+      availability: { status: 'AVAILABLE', reasonCodes: [], evaluatedAt: ts, authoritative: false },
+      participation: { mode: 'CLAIM_THEN_PURCHASE', steps: [{ title: '购买', description: '按团购价下单' }] },
+    };
+    this.offers = this.cfg.grouponEnabled ? [couponOffer, grouponOffer] : [couponOffer];
+    this.entitlements = [
+      {
+        entitlementRef: 'demo:entitlement:1',
+        offerRef: 'demo:coupon:1001',
+        title: this.cfg.couponTitle,
+        entitlementType: 'COUPON',
+        status: 'EFFECTIVE',
+        codeMasked: 'DEMO-****-1001',
+      },
+    ];
+    this.activities = [
+      {
+        activityRef: 'demo:activity:3001',
+        title: this.cfg.activityTitle,
+        subtitle: 'mock 演示活动',
+        registrationRequired: false,
+        offerRefs: ['demo:coupon:1001'],
+      },
+    ];
+  }
+
   async searchOffers(_q: PromotionQueryContext, input: PromotionSearchInput): Promise<PromotionOfferPage> {
     const keyword = input.keyword?.trim();
     const items = keyword
-      ? DEMO_OFFERS.filter((o) => o.title.includes(keyword) || o.tags.some((t) => t.includes(keyword)))
-      : DEMO_OFFERS;
+      ? this.offers.filter((o) => o.title.includes(keyword) || o.tags.some((t) => t.includes(keyword)))
+      : this.offers;
     return { items, hasMore: false };
   }
 
@@ -91,34 +112,34 @@ export class MockPromotionServiceImpl implements MockPromotionService {
     _q: PromotionQueryContext,
     input: { offerRef?: string; entitlementRef?: string; keyword?: string },
   ): Promise<PromotionOffer | null> {
-    if (input.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === input.offerRef) ?? null;
+    if (input.offerRef) return this.offers.find((o) => o.offerRef === input.offerRef) ?? null;
     if (input.entitlementRef) {
-      const ent = DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === input.entitlementRef);
-      if (ent?.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === ent.offerRef) ?? null;
+      const ent = this.entitlements.find((e) => e.entitlementRef === input.entitlementRef);
+      if (ent?.offerRef) return this.offers.find((o) => o.offerRef === ent.offerRef) ?? null;
       return null;
     }
-    if (input.keyword) return DEMO_OFFERS.find((o) => o.title.includes(input.keyword!)) ?? null;
+    if (input.keyword) return this.offers.find((o) => o.title.includes(input.keyword!)) ?? null;
     return null;
   }
 
   async recommendOffers(): Promise<readonly PromotionOffer[]> {
-    return DEMO_OFFERS;
+    return this.offers;
   }
 
   async listEntitlements(_q: PromotionQueryContext, _input: PromotionSearchInput): Promise<PromotionEntitlementPage> {
-    return { items: DEMO_ENTITLEMENTS, hasMore: false };
+    return { items: this.entitlements, hasMore: false };
   }
 
   async getEntitlementDetail(_q: PromotionQueryContext, entitlementRef: string): Promise<PromotionEntitlement | null> {
-    return DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === entitlementRef) ?? null;
+    return this.entitlements.find((e) => e.entitlementRef === entitlementRef) ?? null;
   }
 
   async listActivities(): Promise<PromotionActivityPage> {
-    return { items: DEMO_ACTIVITIES, hasMore: false };
+    return { items: this.activities, hasMore: false };
   }
 
   async getActivityDetail(_q: PromotionQueryContext, activityRef: string): Promise<PromotionActivityDetail | null> {
-    const activity = DEMO_ACTIVITIES.find((a) => a.activityRef === activityRef);
+    const activity = this.activities.find((a) => a.activityRef === activityRef);
     if (!activity) return null;
     return { ...activity, sessions: [], description: 'mock 演示活动详情' };
   }

package/src/server/shopping.ts

@@ -10,7 +10,9 @@
  * - merchantId 连字符格式（demo-shop-NNNN）：LLM 从卡片 value 提取友好；getShop 入参 trim。
  * - catalog 空实现（对齐真实档 C 端）：演示面不覆盖商品目录，门店链路为演示重点。
  * - 构造器接受 seed（默认 DEMO_BUILDINGS）：测试可注入定制数据。
+ * - config 消费：SHOPPING_CFG_DEFAULTS 为契约单源（fail-soft 快照；extraShop* 追加演示门店）。
  */
+import { resolveConfig, type CfgDefaults } from './config';
 import type {
   CatalogQueryPort,
   CategoryRecord,
@@ -48,6 +50,18 @@ interface DemoBuilding {
   floors: DemoFloor[];
 }
 
+/** config 契约单源（键集/缺省/整数约束；tests/config-schema.test.ts 双锁） */
+export const SHOPPING_CFG_DEFAULTS = {
+  extraShopName: '', // '' = 不追加门店（空串 = 缺省/不生效语义）
+  extraShopCategory: '餐饮',
+  extraShopFloor: '3 楼',
+  extraShopUnit: '304',
+  extraShopOpen: true,
+} as const satisfies CfgDefaults;
+export const SHOPPING_CFG_INT_KEYS: readonly string[] = [];
+/** 楼层白名单（消费点守卫 + schema enum 同值——防手编楼层不在目录内） */
+export const SHOPPING_FLOORS = ['B1', '1 楼', '2 楼', '3 楼', '4 楼'] as const;
+
 /** seed 单一真源：1 楼栋 A 栋 / 6 类目 / 12 店（西贝休息中演示营业状态多样性；NIKE 双店支撑快捷命令） */
 const DEMO_BUILDINGS: DemoBuilding[] = [
   {
@@ -137,16 +151,40 @@ function toFloorRecord(floor: DemoFloor): FloorRecord {
 
 export class MockShoppingServiceImpl implements
   CatalogQueryPort, ShopDirectoryQueryPort, CommercialCategoryQueryPort, MallDirectoryQueryPort {
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ SHOPPING_CFG_DEFAULTS） */
+  private readonly cfg: typeof SHOPPING_CFG_DEFAULTS;
   private readonly buildings: readonly DemoBuilding[];
   private readonly shops: ShopRecord[];
   private readonly categories: CategoryRecord[];
 
-  constructor(seed: readonly DemoBuilding[] = DEMO_BUILDINGS) {
-    this.buildings = seed;
-    this.shops = flattenShops(seed);
+  constructor(seed: readonly DemoBuilding[] = DEMO_BUILDINGS, config: unknown = {}) {
+    this.cfg = resolveConfig(config, SHOPPING_CFG_DEFAULTS, SHOPPING_CFG_INT_KEYS);
+    const withExtra = this.withExtraShop(seed);
+    this.buildings = withExtra;
+    this.shops = flattenShops(withExtra);
     this.categories = aggregateCategories(this.shops);
   }
 
+  /** extraShopName 非空 → 指定楼层追加演示门店（名称 trim 判空 + 楼层白名单回退——消费点守卫） */
+  private withExtraShop(seed: readonly DemoBuilding[]): readonly DemoBuilding[] {
+    const name = this.cfg.extraShopName.trim();
+    if (!name) return seed;
+    const floor = (SHOPPING_FLOORS as readonly string[]).includes(this.cfg.extraShopFloor)
+      ? this.cfg.extraShopFloor
+      : '3 楼';
+    const extra: ShopSeed = {
+      merchantId: 'demo-shop-1013',
+      name,
+      businessCategories: [this.cfg.extraShopCategory],
+      unitName: this.cfg.extraShopUnit,
+      status: this.cfg.extraShopOpen ? { code: 'enabled', label: '营业中' } : { code: 'disabled', label: '休息中' },
+    };
+    return seed.map((b) => ({
+      ...b,
+      floors: b.floors.map((f) => (f.floorName === floor ? { ...f, shops: [...f.shops, extra] } : f)),
+    }));
+  }
+
   // ===== ShopDirectoryQueryPort =====
 
   async searchShops(criteria: ShopSearchCriteria): Promise<ShoppingPage<ShopRecord>> {

package/tbox.module.json

@@ -24,119 +24,136 @@
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-member@1"
+          "implementation": "mock-member@1",
+          "configSchema": "schemas/member.config.json"
         },
         {
           "service": "member.profile",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-member@1"
+          "implementation": "mock-member@1",
+          "configSchema": "schemas/member.config.json"
         },
         {
           "service": "member.card",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-member@1"
+          "implementation": "mock-member@1",
+          "configSchema": "schemas/member.config.json"
         },
         {
           "service": "member.benefits",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-member@1"
+          "implementation": "mock-member@1",
+          "configSchema": "schemas/member.config.json"
         },
         {
           "service": "member.enrollment",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-member@1"
+          "implementation": "mock-member@1",
+          "configSchema": "schemas/member.config.json"
         },
         {
           "service": "parking.query",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-parking@1"
+          "implementation": "mock-parking@1",
+          "configSchema": "schemas/parking.config.json"
         },
         {
           "service": "parking.payment",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-parking@1"
+          "implementation": "mock-parking@1",
+          "configSchema": "schemas/parking.config.json"
         },
         {
           "service": "parking.vehicle",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-parking@1"
+          "implementation": "mock-parking@1",
+          "configSchema": "schemas/parking.config.json"
         },
         {
           "service": "promotion.offers",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-promotion@1"
+          "implementation": "mock-promotion@1",
+          "configSchema": "schemas/promotion.config.json"
         },
         {
           "service": "promotion.entitlements",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-promotion@1"
+          "implementation": "mock-promotion@1",
+          "configSchema": "schemas/promotion.config.json"
         },
         {
           "service": "promotion.activities",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-promotion@1"
+          "implementation": "mock-promotion@1",
+          "configSchema": "schemas/promotion.config.json"
         },
         {
           "service": "promotion.acquisition",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-promotion@1"
+          "implementation": "mock-promotion@1",
+          "configSchema": "schemas/promotion.config.json"
         },
         {
           "service": "shopping-guide.catalog",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-shopping@1"
+          "implementation": "mock-shopping@1",
+          "configSchema": "schemas/shopping.config.json"
         },
         {
           "service": "shopping-guide.shops",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-shopping@1"
+          "implementation": "mock-shopping@1",
+          "configSchema": "schemas/shopping.config.json"
         },
         {
           "service": "shopping-guide.categories",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-shopping@1"
+          "implementation": "mock-shopping@1",
+          "configSchema": "schemas/shopping.config.json"
         },
         {
           "service": "shopping-guide.directory",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-shopping@1"
+          "implementation": "mock-shopping@1",
+          "configSchema": "schemas/shopping.config.json"
         },
         {
           "service": "mall.info",
           "credentialType": "-",
           "local": true,
           "provider": "mock",
-          "implementation": "mock-mall-info@1"
+          "implementation": "mock-mall-info@1",
+          "configSchema": "schemas/mall-info.config.json"
         }
       ]
     },

package/tests/config-schema.test.ts

@@ -0,0 +1,92 @@
+/**
+ * config schema 双锁（供给面 ↔ 消费面一致性）：
+ * ① 键集双向锁（schema.properties ≡ DEFAULTS——死字段/漏字段一次全拦）
+ * ② default 漂移锁（schema 表单缺省 ≡ 实现缺省——面板不改动时的运行时真值）
+ * ③ 整数对偶锁（schema type:'integer' ⟺ INT_KEYS——消费点整数守卫与表单引导同源）
+ * ④ manifest 分发面锁（17 槽 configSchema 引用齐全 + 文件随包存在 + 槽→域文件映射）
+ * ⑤ 楼层白名单同值锁（shopping enum ≡ SHOPPING_FLOORS——消费点守卫与引导同源）
+ */
+import { describe, expect, it } from 'vitest';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { MEMBER_CFG_DEFAULTS, MEMBER_CFG_INT_KEYS } from '../src/server/member';
+import { PARKING_CFG_DEFAULTS, PARKING_CFG_INT_KEYS } from '../src/server/parking';
+import { PROMOTION_CFG_DEFAULTS, PROMOTION_CFG_INT_KEYS } from '../src/server/promotion';
+import { SHOPPING_CFG_DEFAULTS, SHOPPING_CFG_INT_KEYS, SHOPPING_FLOORS } from '../src/server/shopping';
+import { MALL_INFO_CFG_DEFAULTS, MALL_INFO_CFG_INT_KEYS } from '../src/server/mall-info';
+
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+interface SchemaProperty { type?: string; default?: unknown; enum?: readonly string[] }
+interface SchemaFile { properties: Record<string, SchemaProperty> }
+
+interface DomainCase {
+  name: string;
+  file: string;
+  defaults: Readonly<Record<string, string | number | boolean>>;
+  intKeys: readonly string[];
+}
+
+const DOMAINS: readonly DomainCase[] = [
+  { name: 'member', file: 'member.config.json', defaults: MEMBER_CFG_DEFAULTS, intKeys: MEMBER_CFG_INT_KEYS },
+  { name: 'parking', file: 'parking.config.json', defaults: PARKING_CFG_DEFAULTS, intKeys: PARKING_CFG_INT_KEYS },
+  { name: 'promotion', file: 'promotion.config.json', defaults: PROMOTION_CFG_DEFAULTS, intKeys: PROMOTION_CFG_INT_KEYS },
+  { name: 'shopping', file: 'shopping.config.json', defaults: SHOPPING_CFG_DEFAULTS, intKeys: SHOPPING_CFG_INT_KEYS },
+  { name: 'mall-info', file: 'mall-info.config.json', defaults: MALL_INFO_CFG_DEFAULTS, intKeys: MALL_INFO_CFG_INT_KEYS },
+];
+
+const readSchema = (file: string): SchemaFile =>
+  JSON.parse(readFileSync(path.join(pkgRoot, 'schemas', file), 'utf8')) as SchemaFile;
+
+describe('provider-mock：config schema 双锁（供给面 ≡ 消费面）', () => {
+  it('① 键集双向锁：schema.properties ≡ DEFAULTS 键集', () => {
+    for (const d of DOMAINS) {
+      const schema = readSchema(d.file);
+      expect(Object.keys(schema.properties).sort(), `${d.name} 键集`).toEqual(Object.keys(d.defaults).sort());
+    }
+  });
+
+  it('② default 漂移锁：schema 缺省 ≡ 实现缺省', () => {
+    for (const d of DOMAINS) {
+      const schema = readSchema(d.file);
+      for (const [key, value] of Object.entries(d.defaults)) {
+        expect(schema.properties[key]?.default, `${d.name}.${key} default 漂移`).toEqual(value);
+      }
+    }
+  });
+
+  it('③ 整数对偶锁：schema type=integer ⟺ INT_KEYS（分式字段不得入 intKeys）', () => {
+    for (const d of DOMAINS) {
+      const schema = readSchema(d.file);
+      for (const [key, prop] of Object.entries(schema.properties)) {
+        expect(prop.type === 'integer', `${d.name}.${key} 整数对偶`).toBe(d.intKeys.includes(key));
+      }
+    }
+  });
+
+  it('④ manifest 分发面锁：17 槽引用齐全 + 槽→域映射 + 文件随包', () => {
+    const manifest = JSON.parse(readFileSync(path.join(pkgRoot, 'tbox.module.json'), 'utf8')) as {
+      contributes: { providers: { slots: Array<{ service: string; configSchema?: string }> } };
+    };
+    const slots = manifest.contributes.providers.slots;
+    expect(slots).toHaveLength(17);
+    const fileOfPrefix: Record<string, string> = {
+      member: 'member.config.json',
+      parking: 'parking.config.json',
+      promotion: 'promotion.config.json',
+      'shopping-guide': 'shopping.config.json',
+      mall: 'mall-info.config.json',
+    };
+    for (const slot of slots) {
+      const prefix = slot.service.slice(0, slot.service.indexOf('.'));
+      expect(slot.configSchema, `${slot.service} configSchema 缺失`).toBe(`schemas/${fileOfPrefix[prefix]}`);
+      expect(existsSync(path.join(pkgRoot, slot.configSchema!)), `${slot.service} schema 文件不存在`).toBe(true);
+    }
+  });
+
+  it('⑤ 楼层 enum ≡ SHOPPING_FLOORS（消费点守卫与表单引导同源）', () => {
+    const schema = readSchema('shopping.config.json');
+    expect(schema.properties.extraShopFloor?.enum).toEqual([...SHOPPING_FLOORS]);
+  });
+});

package/tests/integrations-e2e.test.ts

@@ -7,6 +7,7 @@
 import { beforeEach, describe, expect, it } from 'vitest';
 import { createIntegrationsRegistry, createAuthStrategyRegistry, createEnvironmentSecretProvider, createServerContext } from '@tbox.cn/app-sdk/server';
 import { serverModule, MOCK_SHELL_USER_ID, enrollMockMember, logoutMockMember, __resetMockMemberState } from '../src/server/index';
+import { mallControlPlaneOf } from '@tbox.cn/app-contracts-mall/server';
 import type { IntegrationsConfig } from '@tbox.cn/app-contracts';
 import type { RequestContext } from '@tbox.cn/app-contracts';
 
@@ -54,9 +55,9 @@ function requestContext(mallId = 'mall-demo'): RequestContext {
   };
 }
 
-function fixtureCtx() {
+function fixtureCtx(integrationsOverride?: IntegrationsConfig) {
   const registry = createIntegrationsRegistry({
-    integrations,
+    integrations: integrationsOverride ?? integrations,
     catalog,
     authStrategies: createAuthStrategyRegistry(),
     secretProvider: createEnvironmentSecretProvider({ source: {}, production: false }),
@@ -217,3 +218,117 @@ describe('C5：scoped mock 换码器（入会闭环身份供给）', () => {
     expect(result.credentials?.token).toBe('demo:token:demo-user');
   });
 });
+
+describe('F2 端到端：config 级联（resolveService 全链——五层浅合并消费）', () => {
+  it('槽级 config 流入：parking.query.config.feeCents=200 → 报价同源', async () => {
+    const override: IntegrationsConfig = {
+      ...integrations,
+      services: {
+        ...integrations.services,
+        'parking.query': { ...integrations.services['parking.query'], config: { feeCents: 200 } },
+      },
+    };
+    const { ctx } = fixtureCtx(override);
+    const parking = (await ctx.integrations!.resolveService({
+      service: 'parking.query',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { queryFee(q: unknown, input: { plateNo: string }): Promise<Array<{ totalCents: number; payableCents: number }>> };
+    const quotes = await parking.queryFee({ scope: {} } as never, { plateNo: 'demo-plate' });
+    expect(quotes[0]?.totalCents).toBe(200);
+    expect(quotes[0]?.payableCents).toBe(200);
+  });
+
+  it('root config 级联：根 config.cardName → member 槽实例同源', async () => {
+    const override: IntegrationsConfig = { ...integrations, config: { cardName: 'Root 卡' } };
+    const { ctx } = fixtureCtx(override);
+    const member = (await ctx.integrations!.resolveService({
+      service: 'member.account',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { queryPoints(u: string): Promise<{ membershipLabel: string }> };
+    await expect(member.queryPoints('u1')).resolves.toMatchObject({ membershipLabel: 'Root 卡' });
+  });
+
+  it('浅合并键级覆盖：root 共享键 + slot 差异键并行生效（面板分层配置语义）', async () => {
+    const override: IntegrationsConfig = {
+      ...integrations,
+      config: { parkName: 'RootP' },
+      services: {
+        ...integrations.services,
+        'parking.query': { ...integrations.services['parking.query'], config: { feeCents: 200 } },
+      },
+    };
+    const { ctx } = fixtureCtx(override);
+    const parking = (await ctx.integrations!.resolveService({
+      service: 'parking.query',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as {
+      queryFee(q: unknown, input: { plateNo: string }): Promise<Array<{ totalCents: number }>>;
+      queryParkingInfo(q: unknown, kind: string): Promise<{ title: string }>;
+    };
+    const quotes = await parking.queryFee({ scope: {} } as never, { plateNo: 'demo-plate' });
+    expect(quotes[0]?.totalCents).toBe(200); // slot 差异键
+    const info = await parking.queryParkingInfo({ scope: {} } as never, 'chargeRules');
+    expect(info.title).toBe('RootP'); // root 共享键
+  });
+
+  it('domain 层级联 + slot 胜 domain：域级键流入 + 槽级同名键覆盖（键级层序）', async () => {
+    const override: IntegrationsConfig = {
+      ...integrations,
+      domains: { parking: { config: { parkName: 'DomainP', remainingSpaces: 99 } } },
+      services: {
+        ...integrations.services,
+        'parking.query': { ...integrations.services['parking.query'], config: { feeCents: 250, parkName: 'SlotP' } },
+      },
+    };
+    const { ctx } = fixtureCtx(override);
+    const parking = (await ctx.integrations!.resolveService({
+      service: 'parking.query',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as {
+      queryFee(q: unknown, input: { plateNo: string }): Promise<Array<{ totalCents: number }>>;
+      queryParkingInfo(q: unknown, kind: string): Promise<{ title: string; entries: Array<{ label: string; value: string }> }>;
+    };
+    const quotes = await parking.queryFee({ scope: {} } as never, { plateNo: 'demo-plate' });
+    expect(quotes[0]?.totalCents).toBe(250); // 槽级差异键
+    const info = await parking.queryParkingInfo({ scope: {} } as never, 'chargeRules');
+    expect(info.title).toBe('SlotP'); // slot 胜 domain（同名键）
+    expect(info.entries).toContainEqual({ label: '剩余车位', value: '99' }); // 域级键流入（槽未覆盖）
+  });
+});
+
+// ── 隐式默认单实例声明（零拓扑兜底——provider-mock declareProviderInstances） ──
+
+describe('隐式默认单实例声明（零拓扑兜底）', () => {
+  it('register → 声明快照三键断言（id/name/attributes.miniAppId）', () => {
+    const { registry } = fixtureCtx();
+    expect(registry.providerInstanceDeclarations()['mock']).toEqual([
+      { id: 'mall-demo', name: '星河 Mock 小镇', attributes: { miniAppId: 'mock-demo-app' } },
+    ]);
+  });
+
+  it('零拓扑 config + 声明 → mallControlPlaneOf 融合产出 mall-demo', () => {
+    const { registry } = fixtureCtx();
+    const cp = mallControlPlaneOf(
+      { provider: 'mock', services: {} },
+      registry.providerInstanceDeclarations(),
+    );
+    expect(cp.malls).toEqual([
+      { mallId: 'mall-demo', name: '星河 Mock 小镇', miniAppId: 'mock-demo-app' },
+    ]);
+    expect(cp.defaultMallId).toBe('mall-demo');
+  });
+
+  it('异构形态（无 root.provider 逐槽绑定）→ 不融合（边界锁定）', () => {
+    const { registry } = fixtureCtx();
+    const cp = mallControlPlaneOf(
+      { services: { 'parking.query': { provider: 'mock', implementation: 'mock-parking@1' } } },
+      registry.providerInstanceDeclarations(),
+    );
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+});

package/tests/mall-info.test.ts

@@ -6,12 +6,12 @@
 import { describe, expect, it } from 'vitest';
 import { mockMallInfoFactory, MOCK_MALL_INFO_PROVIDER, MOCK_MALL_INFO_IMPL } from '../src/server/mall-info';
 
-function makePort() {
+function makePort(config: unknown = {}) {
   return mockMallInfoFactory({
     provider: MOCK_MALL_INFO_PROVIDER,
     implementation: MOCK_MALL_INFO_IMPL,
     instanceId: '',
-    config: {},
+    config,
     logger: { info: () => undefined, warn: () => undefined, error: () => undefined },
     service: 'mall.info',
   } as never) as { getMallInfo(mallId: string): Promise<{ mallId: string; name: string } | undefined> };
@@ -44,4 +44,13 @@ describe('mockMallInfoFactory：请求形状守卫', () => {
     expect(MOCK_MALL_INFO_PROVIDER).toBe('mock');
     expect(MOCK_MALL_INFO_IMPL).toBe('mock-mall-info@1');
   });
+
+  it('config 驱动：name 直出 / 空串回退动态别名 / 分式经纬度合法', async () => {
+    const named = makePort({ name: '星河 Mock 小镇' });
+    await expect(named.getMallInfo('1102588')).resolves.toMatchObject({ name: '星河 Mock 小镇' });
+    const fallback = makePort({ name: '', latitude: 31.2304 });
+    const info = await fallback.getMallInfo('1102588');
+    expect(info?.name).toBe('示例商场（1102588）');
+    expect((info as { latitude?: number })?.latitude).toBe(31.2304);
+  });
 });