@tbox.cn/app-contracts-mall 0.9.0 → 0.10.0

package/dist/assembly.d.ts

@@ -10,7 +10,7 @@
  * 均支持动态 mallId 会话；实例集限制是 provider 业务限制的表达位（槽 instances 激活表
  * 显式键集 → 数据面 INSTANCE_NOT_FOUND），非框架限制。WS/HTTP 两形态共享单一形状守卫核。
  */
-import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { RequestContext, ScopeAssemblyContract } from '@tbox.cn/app-contracts';
 import type { MallDeploymentControlPlane } from './deployment';
 import { type MallScope } from './scope';
 /**
@@ -18,6 +18,37 @@ import { type MallScope } from './scope';
  * provider 包与模板装配点经本常量收敛，禁止各处拼写 'auth.alipay-login' 字面量）。
  */
 export declare const AUTH_LOGIN_SERVICE = "auth.alipay-login";
+/**
+ * mall 域装配形状（TIER0 ScopeAssemblyContract 的 TIER1 具体化；W3-3 自 module-mall-core 下沉）：
+ * module-mall-core register 期注册于 ctx.domainAssemblies（SCOPE_ASSEMBLY_KIND），
+ * 消费方（模板装配点/module-mall-home/SDK）按本类型泛型断言查表——域模块间零包依赖
+ * （workspace-dag 铁律：跨模块走注册表 + 契约类型）。
+ * 成员 = 模板装配点（validateContext/scopeSessions/start 装点/WS 双钩）最小必要性合集。
+ */
+export interface MallScopeAssembly extends ScopeAssemblyContract {
+    /** 控制平面（只读快照；纯元数据参考表——展示/目录/默认解析消费，非闸门） */
+    readonly controlPlane: Readonly<MallDeploymentControlPlane>;
+    /** root config.miniAppId（登录槽 code2Session 入参真源；enhance 回填 + default 兜底共用） */
+    readonly rootMiniAppId: string | undefined;
+    /** scope 键提取（SDK ScopeSessionRegistry 注入点） */
+    extractScopeKey(ctx: RequestContext): string;
+    /** scope 形状校验（SDK ScopeSessionRegistry 注入点 + HTTP validateContext 同核） */
+    validateScope(attributes: Record<string, unknown>): boolean;
+    /** 提取 MallScope（模块 handler 前置；无 scope → undefined 由调用方降级） */
+    extractMallScope(ctx: RequestContext): MallScope | undefined;
+    /** 领域扁平 scope（原始形态；ActionGrant/memory 隔离等消费） */
+    buildScope(attributes: Record<string, unknown>): Record<string, string>;
+    /** 扁平 scope + mallName 回填（scopeSessions 注入点；三级回退见 withMallName） */
+    buildScopeWithMallName(attributes: Record<string, unknown>): Record<string, string>;
+    /** instanceId 提取（integrations 槽解析轴；SDK 零领域注入点） */
+    instanceIdOf(scope: Record<string, string>): string;
+    /** 域默认值（SDK ctx.scopeDefaults 视图唯一直接消费面） */
+    readonly scopeDefaults: Readonly<Record<string, unknown>> | undefined;
+    /** 016：默认商圈 HELLO context（无 URL 参数访问时的服务端兜底；缺省 defaultMallId → undefined） */
+    defaultMallContext(): Record<string, unknown> | undefined;
+    /** D1：ENHANCE_CTX 双职责（miniAppId 回填 + mall.info 预热；fail-soft——抛错/超时原 context 继续） */
+    enhanceHelloContext(context: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
 /**
  * 形状守卫核（WS/HTTP 两形态共享单一来源）：
  * - mall 键缺席 → true（非 mall 部署/无 context 放行——校验面不因缺 mall 拒绝；
@@ -52,3 +83,13 @@ export declare function createMallRuntimeAssembly(controlPlane: MallDeploymentCo
  * WS 面由 enhanceContext 补——两形态不对称有内在一致性，勿补对称）。
  */
 export declare function createMallContextValidator(): (attributes: Record<string, unknown>) => boolean;
+/**
+ * 014 T1：buildScope 包装——从控制平面参考表回填 mallName（自 mall 模板 deployment.ts
+ * 迁入，单一模板统一化 W1-①）。
+ * scopeFlat（mallId[+miniAppId]）→ HELLO_ACK.mallScope 回显，mallName 为壳品牌区
+ * （ChatHeader）服务端真源。
+ *
+ * 三级回退（动态商场）：参考表命中 → mall.name；未命中 → fallbackName?.(mallId)
+ * （mall.info 槽缓存）→ 双 miss 原样返回（降级）。
+ */
+export declare function withMallName(assembly: MallRuntimeAssembly, controlPlane: MallDeploymentControlPlane, fallbackName?: (mallId: string) => string | undefined): (attributes: Record<string, unknown>) => Record<string, string>;

package/dist/deployment.d.ts

@@ -19,7 +19,7 @@ export interface MallDeploymentMall {
     /** 小程序 appId（可选拓扑值；mall 级共享——HELLO context.mall.miniAppId 的配置承载，供默认商圈拼装） */
     miniAppId?: string;
     /**
-     * 地理坐标（可选；有值时参与 /api/nearby-mall 就近推荐；缺省不参与排序）。
+     * 地理坐标（可选；有值时参与 /api/m/mall-home/nearby-mall 就近推荐；缺省不参与排序）。
      * 坐标系：WGS-84（高德/支付宝 getLocation 默认输出）。
      */
     location?: {

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './scope';
 export * from './query-context';
 export * from './deployment';
 export * from './assembly';
+export * from './mall-scope-url';
 export * from './guard';
 export * from './shopping-guide/cards';
 export * from './shared/cards';

package/dist/mall-scope-url.d.ts

@@ -0,0 +1,13 @@
+/**
+ * mall scope URL 读源（客户端单一真源；自 mall 模板 platform/ 迁入，单一模板统一化 W1-①；
+ * search-only——hash 内参数不读，壳侧 URL 改写层若移参进 hash 则失效，接入契约显式声明）。
+ *
+ * mallId = 契约键（优先）；plazaId = 商场通用别名兜底（壳侧词汇兼容，非 vendor 特判——
+ * 正式小程序壳 webview 传 ?…&plazaId=1105288，本 helper 将其归一为 mallId 读源）。
+ *
+ * 仅客户端消费（浏览器环境）；服务端不调用（本包其余 runtime 同构，本文件为浏览器面例外，
+ * 函数体内联 window 访问——Node 侧调用会抛，属契约外用法）。
+ */
+export declare function readMallIdFromUrl(): string | null;
+/** 小程序 appId 读源（可选；服务端按 root config 回填，客户端缺省不阻塞） */
+export declare function readMiniAppIdFromUrl(): string | null;

package/dist/runtime.d.ts

@@ -6,12 +6,13 @@
  */
 export { MALL_SCOPE_KEY, mallScopeSchema, mallSlot, parseMallScope, extractMallScope, mallScopeOf, readLoginMallId } from './scope';
 export { mallScopeOrEmpty, mallSubjectIdOf, withMallScopeFromQuery, toMallQueryContext } from './query-context';
-export { createMallRuntimeAssembly, createMallContextValidator, AUTH_LOGIN_SERVICE } from './assembly';
-export { MEMBER_ACCOUNT_SERVICE, MEMBER_PROFILE_SERVICE, MEMBER_CARD_SERVICE, MEMBER_BENEFITS_SERVICE, MEMBER_ENROLLMENT_SERVICE, classifyMemberOutcome, externalMemberRefOf, memberGateCardOf, resolveMemberGate, } from './services/member';
-export { PARKING_QUERY_SERVICE, PARKING_PAYMENT_SERVICE, PARKING_VEHICLE_SERVICE } from './services/parking';
+export { createMallRuntimeAssembly, createMallContextValidator, withMallName, AUTH_LOGIN_SERVICE } from './assembly';
+export { readMallIdFromUrl, readMiniAppIdFromUrl } from './mall-scope-url';
+export { MEMBER_ACCOUNT_SERVICE, MEMBER_PROFILE_SERVICE, MEMBER_CARD_SERVICE, MEMBER_BENEFITS_SERVICE, MEMBER_ENROLLMENT_SERVICE, MEMBER_SNAPSHOT_SERVICE, classifyMemberOutcome, externalMemberRefOf, memberGateCardOf, resolveMemberGate, } from './services/member';
+export { PARKING_QUERY_SERVICE, PARKING_PAYMENT_SERVICE, PARKING_VEHICLE_SERVICE, PARKING_SNAPSHOT_SERVICE } from './services/parking';
 export { PROMOTION_OFFERS_SERVICE, PROMOTION_ENTITLEMENTS_SERVICE, PROMOTION_ACTIVITIES_SERVICE, PROMOTION_ACQUISITION_SERVICE, PROMOTION_ACTIVITY_ROUTING_POLICY, } from './services/promotion';
 export { SHOPPING_CATALOG_SERVICE, SHOPPING_SHOPS_SERVICE, SHOPPING_CATEGORIES_SERVICE, SHOPPING_DIRECTORY_SERVICE, } from './services/shopping-guide';
-export { MALL_INFO_SERVICE } from './services/mall-info';
+export { MALL_INFO_SERVICE, MALL_INFO_CACHE_SERVICE } from './services/mall-info';
 export { mallLocationSchema, parseMallLocation, mallUserRefSchema, parseMallUserRef } from './guard';
 export * from './shopping-guide/cards';
 export * from './member/cards';

package/dist/runtime.js

@@ -75,6 +75,27 @@ function createMallRuntimeAssembly(controlPlane) {
 function createMallContextValidator() {
   return isValidMallShape;
 }
+function withMallName(assembly, controlPlane, fallbackName) {
+  return (attributes) => {
+    const scope = assembly.buildScope(attributes);
+    const mallId = parseMallScope(attributes)?.mallId;
+    const mall = mallId ? controlPlane.malls.find((m) => m.mallId === mallId) : void 0;
+    if (mall) return { ...scope, mallName: mall.name };
+    const fallback = mallId ? fallbackName?.(mallId) : void 0;
+    return fallback ? { ...scope, mallName: fallback } : scope;
+  };
+}
+
+// src/mall-scope-url.ts
+function readMallIdFromUrl() {
+  const params = new URLSearchParams(window.location.search);
+  const mallId = params.get("mallId");
+  if (mallId) return mallId;
+  return params.get("plazaId");
+}
+function readMiniAppIdFromUrl() {
+  return new URLSearchParams(window.location.search).get("miniAppId");
+}
 
 // src/services/member.ts
 var MEMBER_ACCOUNT_SERVICE = "member.account";
@@ -140,11 +161,13 @@ async function resolveMemberGate(factory, reqCtx) {
     ...card ? { card } : {}
   };
 }
+var MEMBER_SNAPSHOT_SERVICE = "member.snapshot";
 
 // src/services/parking.ts
 var PARKING_QUERY_SERVICE = "parking.query";
 var PARKING_PAYMENT_SERVICE = "parking.payment";
 var PARKING_VEHICLE_SERVICE = "parking.vehicle";
+var PARKING_SNAPSHOT_SERVICE = "parking.snapshot";
 
 // src/services/promotion.ts
 var PROMOTION_OFFERS_SERVICE = "promotion.offers";
@@ -161,6 +184,7 @@ var SHOPPING_DIRECTORY_SERVICE = "shopping-guide.directory";
 
 // src/services/mall-info.ts
 var MALL_INFO_SERVICE = "mall.info";
+var MALL_INFO_CACHE_SERVICE = "mall.info-cache";
 
 // src/guard.ts
 import { z } from "zod";
@@ -1180,6 +1204,7 @@ var parkingCardDataSchemas = {
 };
 export {
   AUTH_LOGIN_SERVICE,
+  MALL_INFO_CACHE_SERVICE,
   MALL_INFO_SERVICE,
   MALL_SCOPE_KEY,
   MEMBER_ACCOUNT_SERVICE,
@@ -1190,9 +1215,11 @@ export {
   MEMBER_PREFERENCE_RECOMMENDATION_QUERIES,
   MEMBER_PREFERENCE_VALUES,
   MEMBER_PROFILE_SERVICE,
+  MEMBER_SNAPSHOT_SERVICE,
   PARKING_PAYMENT_SERVICE,
   PARKING_PLATE_PATTERN,
   PARKING_QUERY_SERVICE,
+  PARKING_SNAPSHOT_SERVICE,
   PARKING_VEHICLE_SERVICE,
   PROMOTION_ACQUISITION_SERVICE,
   PROMOTION_ACTIVITIES_SERVICE,
@@ -1267,6 +1294,8 @@ export {
   promotionOfferDetailCardDataSchema,
   promotionOfferListCardDataSchema,
   readLoginMallId,
+  readMallIdFromUrl,
+  readMiniAppIdFromUrl,
   reasonItemSchema,
   recommendMerchantsCardDataSchema,
   refinementSchema,
@@ -1277,5 +1306,6 @@ export {
   shopStatusSchema,
   shoppingGuideCardDataSchemas,
   toMallQueryContext,
+  withMallName,
   withMallScopeFromQuery
 };

package/dist/server/index.js

@@ -46,7 +46,7 @@ var mallAttributesSchema = z.strictObject({
   miniAppId: z.string().min(1).optional(),
   /** 客服电话（shopping-guide customer-service-faq 卡 link 拨打条目消费，缺省不渲染） */
   contactPhone: z.string().min(1).optional(),
-  /** 地理坐标（WGS-84；有值时参与 /api/nearby-mall 就近推荐，缺省不参与排序） */
+  /** 地理坐标（WGS-84；有值时参与 /api/m/mall-home/nearby-mall 就近推荐，缺省不参与排序） */
   location: z.object({
     lat: z.number(),
     lon: z.number(),
@@ -65,8 +65,20 @@ function parseMallAttributes(inst) {
   }
   return { mallId: inst.id, name: inst.name, ...result.data };
 }
-function mallControlPlaneOf(config) {
-  const { instances, defaultInstanceId } = normalizeInstances(config);
+function mergeDeclaredInstances(config, declared) {
+  if (!declared) return config;
+  if (config.instances && config.instances.length > 0) return config;
+  if (config.defaultInstanceId !== void 0) return config;
+  const rootProvider = config.provider;
+  if (!rootProvider) return config;
+  const instances = declared[rootProvider];
+  if (!instances || instances.length === 0) return config;
+  return { ...config, instances: [...instances] };
+}
+function mallControlPlaneOf(config, declared) {
+  const { instances, defaultInstanceId } = normalizeInstances(
+    mergeDeclaredInstances(config, declared)
+  );
   const malls = instances.map(parseMallAttributes);
   return { malls, ...defaultInstanceId !== null ? { defaultMallId: defaultInstanceId } : {} };
 }

package/dist/server/mall-control-plane.d.ts

@@ -1,8 +1,10 @@
-import type { IntegrationsConfig } from '@tbox.cn/app-contracts';
+import type { IntegrationsConfig, ProviderInstanceDeclarations } from '@tbox.cn/app-contracts';
 import type { MallDeploymentControlPlane } from '../deployment';
 /**
  * integrations config → mall 控制平面（装配链唯一入口）：
- * - instances 注册表逐条投影（id→mallId、name、attributes 赋义展开）；
+ * - declared = provider 声明快照（缺省关闭——既有调用方零变化；消费方 = mall-core project()）；
+ * - instances 注册表逐条投影（id→mallId、name、attributes 赋义展开——声明实例过同一
+ *   zod strict 校验，坏键 fail-fast 与显式配置同律）；
  * - defaultMallId = normalizeInstances 解析（显式 ?? 单实例唯一解；无 → undefined）。
  */
-export declare function mallControlPlaneOf(config: IntegrationsConfig): MallDeploymentControlPlane;
+export declare function mallControlPlaneOf(config: IntegrationsConfig, declared?: ProviderInstanceDeclarations): MallDeploymentControlPlane;

package/dist/services/mall-info.d.ts

@@ -24,3 +24,16 @@ export interface MallInfoPort {
      */
     getMallInfo(mallId: string): Promise<MallInfo | undefined>;
 }
+/** 跨模块 'mall.info-cache' 词汇（与 service-slots.json 同锁）。 */
+export declare const MALL_INFO_CACHE_SERVICE = "mall.info-cache";
+/**
+ * mall.info 缓存 Port（缓存 → single-flight → mall.info 槽的读面）。
+ * module-mall-core register 期注册（闭包 integrations）；消费方 resolveService 直读。
+ * 缓存纪律（TTL/负缓存/LRU/single-flight/形状守卫）由实现方收口。
+ */
+export interface MallInfoCachePort {
+    /** 缓存名读取（同步回退通道；过期/负缓存 → undefined） */
+    cachedMallName(mallId: string): string | undefined;
+    /** 缓存 → single-flight → mall.info 槽拉取；失败/未知 → undefined（fail-soft） */
+    resolveMallInfo(mallId: string): Promise<MallInfo | undefined>;
+}

package/dist/services/member.d.ts

@@ -251,3 +251,18 @@ export interface MemberGateBlock {
  * 实现方（member.status 工厂）应自收口异常；本函数对抛错实现兜底为软放行（横切面鲁棒性）。
  */
 export declare function resolveMemberGate(factory: MemberStatusFactory | undefined, reqCtx: RequestContext): Promise<MemberGateBlock | undefined>;
+/** 跨模块 'member.snapshot' 词汇（与 service-slots.json 同锁）。 */
+export declare const MEMBER_SNAPSHOT_SERVICE = "member.snapshot";
+/**
+ * 会员快览 Port（linked-panel 消费面：账户/授权三态 + 积分 + 入会引导）。
+ * member 模块 register 期注册工厂（'member.service' 工厂先例）；消费方
+ * resolveService 后 await factory(reqCtx) 取 Port——enrollUrl 随请求态解析。
+ */
+export interface MemberSnapshotPort {
+    getAccount(userId: string): Promise<MemberAccountSnapshot>;
+    queryPoints(userId: string): Promise<Points>;
+    /** 入会引导深链（未入会态引导；enrollment 槽缺席/失败时缺省——fail-soft 不拖垮主面） */
+    readonly enrollUrl?: string;
+}
+/** 跨模块 'member.snapshot' 解析工厂（register 期注册，运行期调用）。 */
+export type MemberSnapshotFactory = (reqCtx: RequestContext) => Promise<MemberSnapshotPort>;

package/dist/services/parking.d.ts

@@ -105,3 +105,14 @@ export interface ParkingVehiclePort {
         vehicleRef?: string;
     }): Promise<void>;
 }
+/** 跨模块 'parking.snapshot' 词汇（与 service-slots.json 同锁）。 */
+export declare const PARKING_SNAPSHOT_SERVICE = "parking.snapshot";
+/**
+ * 停车快览 Port（linked-panel 消费面：绑定车辆列表 + 在场探测）。
+ * Pick 派生 = ParkingQueryPort 方法面（签名即契约，不手抄字段）；可选能力口
+ * （probeParkedVehicles）缺席性随 Pick 保留。parking 模块 register 期注册工厂；
+ * 消费方 resolveService 后 await factory(reqCtx) 取 Port。
+ */
+export type ParkingSnapshotPort = Pick<ParkingQueryPort, 'listVehicles' | 'probeParkedVehicles'>;
+/** 跨模块 'parking.snapshot' 解析工厂（register 期注册，运行期调用）。 */
+export type ParkingSnapshotFactory = (reqCtx: RequestContext) => Promise<ParkingSnapshotPort>;

package/dist/shopping-guide/cards.d.ts

@@ -3251,6 +3251,7 @@ export declare const mallDirectoryCardDataSchema: z.ZodObject<{
     observedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     mallId: string;
+    mallName: string;
     observedAt: string;
     buildings: {
         buildingName: string;
@@ -3272,9 +3273,9 @@ export declare const mallDirectoryCardDataSchema: z.ZodObject<{
             })[] | undefined;
         }[];
     }[];
-    mallName: string;
 }, {
     mallId: string;
+    mallName: string;
     observedAt: string;
     buildings: {
         buildingName: string;
@@ -3296,7 +3297,6 @@ export declare const mallDirectoryCardDataSchema: z.ZodObject<{
             })[] | undefined;
         }[];
     }[];
-    mallName: string;
 }>;
 export type MallDirectoryCardData = z.infer<typeof mallDirectoryCardDataSchema>;
 /** nearby-mall-list */
@@ -6285,6 +6285,7 @@ export declare const shoppingGuideCardDataSchemas: {
         observedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         mallId: string;
+        mallName: string;
         observedAt: string;
         buildings: {
             buildingName: string;
@@ -6306,9 +6307,9 @@ export declare const shoppingGuideCardDataSchemas: {
                 })[] | undefined;
             }[];
         }[];
-        mallName: string;
     }, {
         mallId: string;
+        mallName: string;
         observedAt: string;
         buildings: {
             buildingName: string;
@@ -6330,7 +6331,6 @@ export declare const shoppingGuideCardDataSchemas: {
                 })[] | undefined;
             }[];
         }[];
-        mallName: string;
     }>;
     readonly 'nearby-mall-list': z.ZodObject<{
         query: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-contracts-mall",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "description": "商圈领域契约（TIER1，types + runtime）：Port 接口 + MallEventMap + 领域 DTO + scope/装配器运行时。",
   "exports": {
@@ -29,14 +29,15 @@
     "access": "public"
   },
   "dependencies": {
-    "@tbox.cn/app-contracts": "0.9.0",
+    "@tbox.cn/app-contracts": "0.10.0",
     "zod": "3.25.76"
   },
   "devDependencies": {
-    "@tbox.cn/app-sdk": "0.17.0",
+    "@tbox.cn/app-sdk": "0.19.0",
     "tsup": "8.5.1",
     "typescript": "5.9.3",
-    "vitest": "4.1.10"
+    "vitest": "4.1.10",
+    "happy-dom": "20.11.2"
   },
   "license": "MIT",
   "scripts": {

package/src/assembly.ts

@@ -10,7 +10,7 @@
  * 均支持动态 mallId 会话；实例集限制是 provider 业务限制的表达位（槽 instances 激活表
  * 显式键集 → 数据面 INSTANCE_NOT_FOUND），非框架限制。WS/HTTP 两形态共享单一形状守卫核。
  */
-import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { RequestContext, ScopeAssemblyContract } from '@tbox.cn/app-contracts';
 import type { MallDeploymentControlPlane } from './deployment';
 import {
   extractMallScope,
@@ -25,6 +25,38 @@ import {
  */
 export const AUTH_LOGIN_SERVICE = 'auth.alipay-login';
 
+/**
+ * mall 域装配形状（TIER0 ScopeAssemblyContract 的 TIER1 具体化；W3-3 自 module-mall-core 下沉）：
+ * module-mall-core register 期注册于 ctx.domainAssemblies（SCOPE_ASSEMBLY_KIND），
+ * 消费方（模板装配点/module-mall-home/SDK）按本类型泛型断言查表——域模块间零包依赖
+ * （workspace-dag 铁律：跨模块走注册表 + 契约类型）。
+ * 成员 = 模板装配点（validateContext/scopeSessions/start 装点/WS 双钩）最小必要性合集。
+ */
+export interface MallScopeAssembly extends ScopeAssemblyContract {
+  /** 控制平面（只读快照；纯元数据参考表——展示/目录/默认解析消费，非闸门） */
+  readonly controlPlane: Readonly<MallDeploymentControlPlane>;
+  /** root config.miniAppId（登录槽 code2Session 入参真源；enhance 回填 + default 兜底共用） */
+  readonly rootMiniAppId: string | undefined;
+  /** scope 键提取（SDK ScopeSessionRegistry 注入点） */
+  extractScopeKey(ctx: RequestContext): string;
+  /** scope 形状校验（SDK ScopeSessionRegistry 注入点 + HTTP validateContext 同核） */
+  validateScope(attributes: Record<string, unknown>): boolean;
+  /** 提取 MallScope（模块 handler 前置；无 scope → undefined 由调用方降级） */
+  extractMallScope(ctx: RequestContext): MallScope | undefined;
+  /** 领域扁平 scope（原始形态；ActionGrant/memory 隔离等消费） */
+  buildScope(attributes: Record<string, unknown>): Record<string, string>;
+  /** 扁平 scope + mallName 回填（scopeSessions 注入点；三级回退见 withMallName） */
+  buildScopeWithMallName(attributes: Record<string, unknown>): Record<string, string>;
+  /** instanceId 提取（integrations 槽解析轴；SDK 零领域注入点） */
+  instanceIdOf(scope: Record<string, string>): string;
+  /** 域默认值（SDK ctx.scopeDefaults 视图唯一直接消费面） */
+  readonly scopeDefaults: Readonly<Record<string, unknown>> | undefined;
+  /** 016：默认商圈 HELLO context（无 URL 参数访问时的服务端兜底；缺省 defaultMallId → undefined） */
+  defaultMallContext(): Record<string, unknown> | undefined;
+  /** D1：ENHANCE_CTX 双职责（miniAppId 回填 + mall.info 预热；fail-soft——抛错/超时原 context 继续） */
+  enhanceHelloContext(context: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+
 /**
  * 形状守卫核（WS/HTTP 两形态共享单一来源）：
  * - mall 键缺席 → true（非 mall 部署/无 context 放行——校验面不因缺 mall 拒绝；
@@ -101,3 +133,27 @@ export function createMallRuntimeAssembly(
 export function createMallContextValidator(): (attributes: Record<string, unknown>) => boolean {
   return isValidMallShape;
 }
+
+/**
+ * 014 T1：buildScope 包装——从控制平面参考表回填 mallName（自 mall 模板 deployment.ts
+ * 迁入，单一模板统一化 W1-①）。
+ * scopeFlat（mallId[+miniAppId]）→ HELLO_ACK.mallScope 回显，mallName 为壳品牌区
+ * （ChatHeader）服务端真源。
+ *
+ * 三级回退（动态商场）：参考表命中 → mall.name；未命中 → fallbackName?.(mallId)
+ * （mall.info 槽缓存）→ 双 miss 原样返回（降级）。
+ */
+export function withMallName(
+  assembly: MallRuntimeAssembly,
+  controlPlane: MallDeploymentControlPlane,
+  fallbackName?: (mallId: string) => string | undefined,
+): (attributes: Record<string, unknown>) => Record<string, string> {
+  return (attributes) => {
+    const scope = assembly.buildScope(attributes);
+    const mallId = parseMallScope(attributes)?.mallId;
+    const mall = mallId ? controlPlane.malls.find((m) => m.mallId === mallId) : undefined;
+    if (mall) return { ...scope, mallName: mall.name };
+    const fallback = mallId ? fallbackName?.(mallId) : undefined;
+    return fallback ? { ...scope, mallName: fallback } : scope;
+  };
+}

package/src/deployment.ts

@@ -20,7 +20,7 @@ export interface MallDeploymentMall {
   /** 小程序 appId（可选拓扑值；mall 级共享——HELLO context.mall.miniAppId 的配置承载，供默认商圈拼装） */
   miniAppId?: string;
   /**
-   * 地理坐标（可选；有值时参与 /api/nearby-mall 就近推荐；缺省不参与排序）。
+   * 地理坐标（可选；有值时参与 /api/m/mall-home/nearby-mall 就近推荐；缺省不参与排序）。
    * 坐标系：WGS-84（高德/支付宝 getLocation 默认输出）。
    */
   location?: {

package/src/index.ts

@@ -21,6 +21,7 @@ export * from './scope';
 export * from './query-context';
 export * from './deployment';
 export * from './assembly';
+export * from './mall-scope-url';
 export * from './guard';
 export * from './shopping-guide/cards';
 export * from './shared/cards';

package/src/mall-scope-url.ts

@@ -0,0 +1,21 @@
+/**
+ * mall scope URL 读源（客户端单一真源；自 mall 模板 platform/ 迁入，单一模板统一化 W1-①；
+ * search-only——hash 内参数不读，壳侧 URL 改写层若移参进 hash 则失效，接入契约显式声明）。
+ *
+ * mallId = 契约键（优先）；plazaId = 商场通用别名兜底（壳侧词汇兼容，非 vendor 特判——
+ * 正式小程序壳 webview 传 ?…&plazaId=1105288，本 helper 将其归一为 mallId 读源）。
+ *
+ * 仅客户端消费（浏览器环境）；服务端不调用（本包其余 runtime 同构，本文件为浏览器面例外，
+ * 函数体内联 window 访问——Node 侧调用会抛，属契约外用法）。
+ */
+export function readMallIdFromUrl(): string | null {
+  const params = new URLSearchParams(window.location.search);
+  const mallId = params.get('mallId');
+  if (mallId) return mallId; // 空串视为缺席（?mallId=&plazaId=x → plazaId 生效）
+  return params.get('plazaId');
+}
+
+/** 小程序 appId 读源（可选；服务端按 root config 回填，客户端缺省不阻塞） */
+export function readMiniAppIdFromUrl(): string | null {
+  return new URLSearchParams(window.location.search).get('miniAppId');
+}

package/src/runtime.ts

@@ -6,19 +6,21 @@
  */
 export { MALL_SCOPE_KEY, mallScopeSchema, mallSlot, parseMallScope, extractMallScope, mallScopeOf, readLoginMallId } from './scope';
 export { mallScopeOrEmpty, mallSubjectIdOf, withMallScopeFromQuery, toMallQueryContext } from './query-context';
-export { createMallRuntimeAssembly, createMallContextValidator, AUTH_LOGIN_SERVICE } from './assembly';
+export { createMallRuntimeAssembly, createMallContextValidator, withMallName, AUTH_LOGIN_SERVICE } from './assembly';
+export { readMallIdFromUrl, readMiniAppIdFromUrl } from './mall-scope-url';
 export {
   MEMBER_ACCOUNT_SERVICE,
   MEMBER_PROFILE_SERVICE,
   MEMBER_CARD_SERVICE,
   MEMBER_BENEFITS_SERVICE,
   MEMBER_ENROLLMENT_SERVICE,
+  MEMBER_SNAPSHOT_SERVICE,
   classifyMemberOutcome,
   externalMemberRefOf,
   memberGateCardOf,
   resolveMemberGate,
 } from './services/member';
-export { PARKING_QUERY_SERVICE, PARKING_PAYMENT_SERVICE, PARKING_VEHICLE_SERVICE } from './services/parking';
+export { PARKING_QUERY_SERVICE, PARKING_PAYMENT_SERVICE, PARKING_VEHICLE_SERVICE, PARKING_SNAPSHOT_SERVICE } from './services/parking';
 export {
   PROMOTION_OFFERS_SERVICE,
   PROMOTION_ENTITLEMENTS_SERVICE,
@@ -32,7 +34,7 @@ export {
   SHOPPING_CATEGORIES_SERVICE,
   SHOPPING_DIRECTORY_SERVICE,
 } from './services/shopping-guide';
-export { MALL_INFO_SERVICE } from './services/mall-info';
+export { MALL_INFO_SERVICE, MALL_INFO_CACHE_SERVICE } from './services/mall-info';
 export { mallLocationSchema, parseMallLocation, mallUserRefSchema, parseMallUserRef } from './guard';
 export * from './shopping-guide/cards';
 export * from './member/cards';

package/src/server/mall-control-plane.ts

@@ -4,10 +4,14 @@
  * attributes 赋义 zod 单源（原双模板 deployment.ts 内嵌 zod 上收——消灭 base/mall 双份漂移）：
  * strict 拒拼错键（strip 会让消费点恒 undefined——静默配置失效），错误消息列允许键清单。
  * TIER0 attributes 全程 opaque，域赋义唯一发生地 = 本文件（011 B1 边界保持）。
+ *
+ * 隐式默认单实例融合（provider 声明）：零拓扑 config（无 instances/defaultInstanceId）+
+ * root.provider 命中声明键 → 注入声明实例（default 经 normalizeInstances 单实例唯一解派生
+ * ——零新规则）。显式配置恒赢；规则细节见 mergeDeclaredInstances。
  */
 import { z } from 'zod';
 import { normalizeInstances } from '@tbox.cn/app-contracts';
-import type { DeploymentInstance, IntegrationsConfig } from '@tbox.cn/app-contracts';
+import type { DeploymentInstance, IntegrationsConfig, ProviderInstanceDeclarations } from '@tbox.cn/app-contracts';
 import type { MallDeploymentControlPlane, MallDeploymentMall } from '../deployment';
 
 /** mall 域 attributes 赋义（strict——拼错键 fail-fast，报错附允许键清单） */
@@ -16,7 +20,7 @@ const mallAttributesSchema = z.strictObject({
   miniAppId: z.string().min(1).optional(),
   /** 客服电话（shopping-guide customer-service-faq 卡 link 拨打条目消费，缺省不渲染） */
   contactPhone: z.string().min(1).optional(),
-  /** 地理坐标（WGS-84；有值时参与 /api/nearby-mall 就近推荐，缺省不参与排序） */
+  /** 地理坐标（WGS-84；有值时参与 /api/m/mall-home/nearby-mall 就近推荐，缺省不参与排序） */
   location: z
     .object({
       lat: z.number(),
@@ -44,13 +48,45 @@ function parseMallAttributes(
   return { mallId: inst.id, name: inst.name, ...result.data };
 }
 
+/**
+ * 隐式默认单实例融合（五规则；no-op 分支零分配——原 config 引用返回）：
+ * 1. declared 缺席 → 原样；
+ * 2. config.instances 非空 → 原样（显式表赢）；
+ * 3. config.defaultInstanceId 显式在场（含 null——「显式无默认」即真值）→ 原样；
+ * 4. 零拓扑 + root.provider（root 层恒 string——inline 仅 service 层）命中声明键且声明
+ *    非空 → 注入声明实例（default 走 normalizeInstances 既有唯一解）；
+ * 5. 其余（root.provider 缺席 / 声明无该键 / 空声明数组）→ 原样。
+ * 空声明数组短路守 wire 空表不变量（zod 拒空 instances 数组——「无表 = 键缺席唯一写法」；
+ * 融合发生在加载校验后，注入空表会绕过 zod 制造非法形态）。
+ */
+function mergeDeclaredInstances(
+  config: IntegrationsConfig,
+  declared: ProviderInstanceDeclarations | undefined,
+): IntegrationsConfig {
+  if (!declared) return config;
+  if (config.instances && config.instances.length > 0) return config;
+  if (config.defaultInstanceId !== undefined) return config;
+  const rootProvider = config.provider;
+  if (!rootProvider) return config;
+  const instances = declared[rootProvider];
+  if (!instances || instances.length === 0) return config;
+  return { ...config, instances: [...instances] };
+}
+
 /**
  * integrations config → mall 控制平面（装配链唯一入口）：
- * - instances 注册表逐条投影（id→mallId、name、attributes 赋义展开）；
+ * - declared = provider 声明快照（缺省关闭——既有调用方零变化；消费方 = mall-core project()）；
+ * - instances 注册表逐条投影（id→mallId、name、attributes 赋义展开——声明实例过同一
+ *   zod strict 校验，坏键 fail-fast 与显式配置同律）；
  * - defaultMallId = normalizeInstances 解析（显式 ?? 单实例唯一解；无 → undefined）。
  */
-export function mallControlPlaneOf(config: IntegrationsConfig): MallDeploymentControlPlane {
-  const { instances, defaultInstanceId } = normalizeInstances(config);
+export function mallControlPlaneOf(
+  config: IntegrationsConfig,
+  declared?: ProviderInstanceDeclarations,
+): MallDeploymentControlPlane {
+  const { instances, defaultInstanceId } = normalizeInstances(
+    mergeDeclaredInstances(config, declared),
+  );
   const malls: MallDeploymentMall[] = instances.map(parseMallAttributes);
   return { malls, ...(defaultInstanceId !== null ? { defaultMallId: defaultInstanceId } : {}) };
 }

package/src/service-slots.json

@@ -6,9 +6,11 @@
     "member.card",
     "member.benefits",
     "member.enrollment",
+    "member.snapshot",
     "parking.query",
     "parking.payment",
     "parking.vehicle",
+    "parking.snapshot",
     "promotion.offers",
     "promotion.entitlements",
     "promotion.activities",
@@ -18,6 +20,7 @@
     "shopping-guide.categories",
     "shopping-guide.directory",
     "auth.alipay-login",
-    "mall.info"
+    "mall.info",
+    "mall.info-cache"
   ]
 }

package/src/services/mall-info.ts

@@ -29,3 +29,20 @@ export interface MallInfoPort {
    */
   getMallInfo(mallId: string): Promise<MallInfo | undefined>;
 }
+
+// ===== mall.info 缓存面（W3-3：缓存装饰跨模块暴露） =====
+
+/** 跨模块 'mall.info-cache' 词汇（与 service-slots.json 同锁）。 */
+export const MALL_INFO_CACHE_SERVICE = 'mall.info-cache';
+
+/**
+ * mall.info 缓存 Port（缓存 → single-flight → mall.info 槽的读面）。
+ * module-mall-core register 期注册（闭包 integrations）；消费方 resolveService 直读。
+ * 缓存纪律（TTL/负缓存/LRU/single-flight/形状守卫）由实现方收口。
+ */
+export interface MallInfoCachePort {
+  /** 缓存名读取（同步回退通道；过期/负缓存 → undefined） */
+  cachedMallName(mallId: string): string | undefined;
+  /** 缓存 → single-flight → mall.info 槽拉取；失败/未知 → undefined（fail-soft） */
+  resolveMallInfo(mallId: string): Promise<MallInfo | undefined>;
+}

package/src/services/member.ts

@@ -364,3 +364,23 @@ export async function resolveMemberGate(
     ...(card ? { card } : {}),
   };
 }
+
+// ===== 11. 跨模块会员快览（首页联单面板消费面；W3-3 单一模板统一化） =====
+
+/** 跨模块 'member.snapshot' 词汇（与 service-slots.json 同锁）。 */
+export const MEMBER_SNAPSHOT_SERVICE = 'member.snapshot';
+
+/**
+ * 会员快览 Port（linked-panel 消费面：账户/授权三态 + 积分 + 入会引导）。
+ * member 模块 register 期注册工厂（'member.service' 工厂先例）；消费方
+ * resolveService 后 await factory(reqCtx) 取 Port——enrollUrl 随请求态解析。
+ */
+export interface MemberSnapshotPort {
+  getAccount(userId: string): Promise<MemberAccountSnapshot>;
+  queryPoints(userId: string): Promise<Points>;
+  /** 入会引导深链（未入会态引导；enrollment 槽缺席/失败时缺省——fail-soft 不拖垮主面） */
+  readonly enrollUrl?: string;
+}
+
+/** 跨模块 'member.snapshot' 解析工厂（register 期注册，运行期调用）。 */
+export type MemberSnapshotFactory = (reqCtx: RequestContext) => Promise<MemberSnapshotPort>;

package/src/services/parking.ts

@@ -164,3 +164,19 @@ export interface ParkingVehiclePort {
     input: { plateNo?: string; vehicleRef?: string },
   ): Promise<void>;
 }
+
+// ===== 4. 跨模块停车快览（首页联单面板消费面；W3-3 单一模板统一化） =====
+
+/** 跨模块 'parking.snapshot' 词汇（与 service-slots.json 同锁）。 */
+export const PARKING_SNAPSHOT_SERVICE = 'parking.snapshot';
+
+/**
+ * 停车快览 Port（linked-panel 消费面：绑定车辆列表 + 在场探测）。
+ * Pick 派生 = ParkingQueryPort 方法面（签名即契约，不手抄字段）；可选能力口
+ * （probeParkedVehicles）缺席性随 Pick 保留。parking 模块 register 期注册工厂；
+ * 消费方 resolveService 后 await factory(reqCtx) 取 Port。
+ */
+export type ParkingSnapshotPort = Pick<ParkingQueryPort, 'listVehicles' | 'probeParkedVehicles'>;
+
+/** 跨模块 'parking.snapshot' 解析工厂（register 期注册，运行期调用）。 */
+export type ParkingSnapshotFactory = (reqCtx: RequestContext) => Promise<ParkingSnapshotPort>;

package/tests/mall-control-plane.test.ts

@@ -2,11 +2,12 @@
  * mallControlPlaneOf 投影单测（integrations v4）：
  * root instances 注册表 → MallDeploymentControlPlane。
  * 覆盖：无表 → 空平面 / 全字段投影 / attributes strict 拒拼错键（报允许键）/
- * defaultInstanceId 解析（显式 / 单实例唯一解 / 多实例无默认 → undefined）/ 无表 + 独立默认。
+ * defaultInstanceId 解析（显式 / 单实例唯一解 / 多实例无默认 → undefined）/ 无表 + 独立默认 /
+ * 隐式默认单实例融合（provider 声明——五规则矩阵）。
  */
 import { describe, expect, it } from 'vitest';
 import { mallControlPlaneOf } from '../src/server/mall-control-plane';
-import type { IntegrationsConfig } from '@tbox.cn/app-contracts';
+import type { ProviderInstanceDeclarations, IntegrationsConfig } from '@tbox.cn/app-contracts';
 
 function config(overrides: Partial<IntegrationsConfig> = {}): IntegrationsConfig {
   return { services: {}, ...overrides };
@@ -84,3 +85,85 @@ describe('mallControlPlaneOf：参考表投影', () => {
     expect(cp.defaultMallId).toBeUndefined();
   });
 });
+
+// ── 隐式默认单实例融合（provider 声明——五规则矩阵） ──────────────────────────
+
+type Declared = ProviderInstanceDeclarations;
+
+const DECLARED_MOCK: Declared = {
+  mock: [{ id: 'mall-demo', name: '星河 Mock 小镇', attributes: { miniAppId: 'mock-demo-app' } }],
+};
+
+describe('mallControlPlaneOf：隐式默认单实例融合（provider 声明）', () => {
+  it('declared 缺席 → 原样（零拓扑空平面）', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock' }));
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('显式 instances 赢：声明被忽略', () => {
+    const cp = mallControlPlaneOf(config({
+      provider: 'mock',
+      instances: [{ id: 'mall-real', name: '真实商场' }],
+    }), DECLARED_MOCK);
+    expect(cp.malls.map((m) => m.mallId)).toEqual(['mall-real']);
+    expect(cp.defaultMallId).toBe('mall-real');
+  });
+
+  it('显式 defaultInstanceId（string）赢：声明被忽略（env 注入动态默认形态）', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock', defaultInstanceId: 'env-injected' }), DECLARED_MOCK);
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBe('env-injected');
+  });
+
+  it('显式 defaultInstanceId: null 赢（显式无默认即真值）', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock', defaultInstanceId: null }), DECLARED_MOCK);
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('零拓扑 + root.provider 命中 → 注入声明实例 + 单实例唯一解', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock' }), DECLARED_MOCK);
+    expect(cp.malls).toEqual([
+      { mallId: 'mall-demo', name: '星河 Mock 小镇', miniAppId: 'mock-demo-app' },
+    ]);
+    expect(cp.defaultMallId).toBe('mall-demo');
+  });
+
+  it('零拓扑 + root.provider 缺席 → 原样（异构生成器形态边界）', () => {
+    const cp = mallControlPlaneOf(config(), DECLARED_MOCK);
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('零拓扑 + 声明无该键（其他厂商档）→ 原样', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'globex' }), DECLARED_MOCK);
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('零拓扑 + 空声明数组 → 原样（wire 空表不变量）', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock' }), { mock: [] });
+    expect(cp.malls).toEqual([]);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('多实例声明 → 注入两实例 + defaultMallId undefined（既有唯一解规则不派生）', () => {
+    const cp = mallControlPlaneOf(config({ provider: 'mock' }), {
+      mock: [
+        { id: 'mall-a', name: 'A' },
+        { id: 'mall-b', name: 'B' },
+      ],
+    });
+    expect(cp.malls.map((m) => m.mallId)).toEqual(['mall-a', 'mall-b']);
+    expect(cp.defaultMallId).toBeUndefined();
+  });
+
+  it('声明实例坏 attributes 键 → throw（与显式配置同律）', () => {
+    expect(() =>
+      mallControlPlaneOf(config({ provider: 'mock' }), {
+        mock: [{ id: 'mall-demo', name: 'x', attributes: { miniAppid: 'typo' } }],
+      }),
+    ).toThrow(/miniAppId|contactPhone|location/);
+  });
+});

package/tests/mall-scope-url.test.ts

@@ -0,0 +1,59 @@
+// @vitest-environment happy-dom
+/**
+ * mall scope URL 读源专项（CS-8 读源收敛；自 mall 模板 platform/ 随迁，单一模板统一化 W1-①）：
+ * - mallId 优先 / plazaId 别名兜底 / 空串缺席语义
+ * - search-only：hash 内参数不读（壳 URL 改写层契约）
+ */
+import { describe, expect, it, afterEach } from 'vitest';
+import { readMallIdFromUrl, readMiniAppIdFromUrl } from '../src/mall-scope-url';
+
+const ORIGINAL_URL = window.location.href;
+
+function setSearch(search: string): void {
+  window.history.replaceState({}, '', `${window.location.pathname}${search}`);
+}
+
+afterEach(() => {
+  window.history.replaceState({}, '', ORIGINAL_URL);
+});
+
+describe('readMallIdFromUrl', () => {
+  it('仅 mallId → 取 mallId', () => {
+    setSearch('?mallId=1102588');
+    expect(readMallIdFromUrl()).toBe('1102588');
+  });
+
+  it('仅 plazaId → 取 plazaId（壳侧别名兜底）', () => {
+    setSearch('?container=alipay-miniapp&key=AliAgent&plazaId=1105288');
+    expect(readMallIdFromUrl()).toBe('1105288');
+  });
+
+  it('mallId + plazaId 并存 → mallId 优先', () => {
+    setSearch('?mallId=1102588&plazaId=1105288');
+    expect(readMallIdFromUrl()).toBe('1102588');
+  });
+
+  it('mallId 空串 + plazaId 有值 → plazaId（空串缺席语义）', () => {
+    setSearch('?mallId=&plazaId=1105288');
+    expect(readMallIdFromUrl()).toBe('1105288');
+  });
+
+  it('均缺 → null', () => {
+    setSearch('?container=alipay-miniapp');
+    expect(readMallIdFromUrl()).toBeNull();
+  });
+
+  it('hash 内参数不读（search-only 纪律）', () => {
+    window.history.replaceState({}, '', `${window.location.pathname}?container=x#/?mallId=1102588`);
+    expect(readMallIdFromUrl()).toBeNull();
+  });
+});
+
+describe('readMiniAppIdFromUrl', () => {
+  it('有值 → 取回；缺省 → null', () => {
+    setSearch('?miniAppId=2021002175601342&mallId=1102588');
+    expect(readMiniAppIdFromUrl()).toBe('2021002175601342');
+    setSearch('?mallId=1102588');
+    expect(readMiniAppIdFromUrl()).toBeNull();
+  });
+});

package/tests/service-slots.test.ts

@@ -11,11 +11,13 @@ import {
   MEMBER_CARD_SERVICE,
   MEMBER_BENEFITS_SERVICE,
   MEMBER_ENROLLMENT_SERVICE,
+  MEMBER_SNAPSHOT_SERVICE,
 } from '../src/services/member';
 import {
   PARKING_QUERY_SERVICE,
   PARKING_PAYMENT_SERVICE,
   PARKING_VEHICLE_SERVICE,
+  PARKING_SNAPSHOT_SERVICE,
 } from '../src/services/parking';
 import {
   PROMOTION_OFFERS_SERVICE,
@@ -29,7 +31,7 @@ import {
   SHOPPING_CATEGORIES_SERVICE,
   SHOPPING_DIRECTORY_SERVICE,
 } from '../src/services/shopping-guide';
-import { MALL_INFO_SERVICE } from '../src/services/mall-info';
+import { MALL_INFO_SERVICE, MALL_INFO_CACHE_SERVICE } from '../src/services/mall-info';
 import { AUTH_LOGIN_SERVICE } from '../src/assembly';
 
 const constants = [
@@ -51,19 +53,22 @@ const constants = [
   SHOPPING_DIRECTORY_SERVICE,
   AUTH_LOGIN_SERVICE,
   MALL_INFO_SERVICE,
+  MEMBER_SNAPSHOT_SERVICE,
+  PARKING_SNAPSHOT_SERVICE,
+  MALL_INFO_CACHE_SERVICE,
 ];
 
 describe('service slot 词汇交叉锁（JSON 真源 ↔ TS 共址常量）', () => {
-  it('计数 = 18（auth.alipay-login 与 mall.info 含在内）', () => {
-    expect(slotsJson.slots).toHaveLength(18);
-    expect(constants).toHaveLength(18);
+  it('计数 = 21（auth.alipay-login 与 mall.info 族含在内）', () => {
+    expect(slotsJson.slots).toHaveLength(21);
+    expect(constants).toHaveLength(21);
   });
 
   it('常量并集 ≡ JSON slots（互为子集；无重复无缺漏）', () => {
     const jsonSet = new Set(slotsJson.slots);
     const constSet = new Set(constants);
-    expect(jsonSet.size).toBe(18);
-    expect(constSet.size).toBe(18);
+    expect(jsonSet.size).toBe(21);
+    expect(constSet.size).toBe(21);
     for (const id of jsonSet) expect(constSet.has(id), `常量缺 ${id}`).toBe(true);
     for (const id of constSet) expect(jsonSet.has(id), `JSON 缺 ${id}`).toBe(true);
   });