@tbox.cn/app-provider-mock 0.2.0

package/src/server/promotion.ts

@@ -0,0 +1,148 @@
+/**
+ * Mock promotion 实现（provider-mock 自持——R3-1 裁决）。演示面最小集：搜索/精查/推荐/
+ * 资产列表/活动列表/领取闭环（acquire 恒 SUCCEEDED）。demo ref 恒 `demo:` 前缀，厂商中立。
+ */
+import type {
+  PromotionOffer,
+  PromotionOfferPage,
+  PromotionEntitlement,
+  PromotionEntitlementPage,
+  PromotionActivity,
+  PromotionActivityPage,
+  PromotionActivityDetail,
+  PromotionOperation,
+  PromotionQueryContext,
+  PromotionSearchInput,
+  PromotionAcquisitionPort,
+  PromotionActivityPort,
+  PromotionEntitlementPort,
+  PromotionOfferQueryPort,
+} from '@tbox.cn/app-contracts-mall';
+
+export type MockPromotionService = PromotionOfferQueryPort &
+  PromotionEntitlementPort &
+  PromotionActivityPort &
+  PromotionAcquisitionPort;
+
+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'],
+  },
+];
+
+const emptyPage = (): PromotionOfferPage & PromotionEntitlementPage & PromotionActivityPage => ({
+  items: [],
+  hasMore: false,
+});
+
+export class MockPromotionServiceImpl implements MockPromotionService {
+  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;
+    return { items, hasMore: false };
+  }
+
+  async getOfferDetail(
+    _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.entitlementRef) {
+      const ent = DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === input.entitlementRef);
+      if (ent?.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === ent.offerRef) ?? null;
+      return null;
+    }
+    if (input.keyword) return DEMO_OFFERS.find((o) => o.title.includes(input.keyword!)) ?? null;
+    return null;
+  }
+
+  async recommendOffers(): Promise<readonly PromotionOffer[]> {
+    return DEMO_OFFERS;
+  }
+
+  async listEntitlements(_q: PromotionQueryContext, _input: PromotionSearchInput): Promise<PromotionEntitlementPage> {
+    return { items: DEMO_ENTITLEMENTS, hasMore: false };
+  }
+
+  async getEntitlementDetail(_q: PromotionQueryContext, entitlementRef: string): Promise<PromotionEntitlement | null> {
+    return DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === entitlementRef) ?? null;
+  }
+
+  async listActivities(): Promise<PromotionActivityPage> {
+    return { items: DEMO_ACTIVITIES, hasMore: false };
+  }
+
+  async getActivityDetail(_q: PromotionQueryContext, activityRef: string): Promise<PromotionActivityDetail | null> {
+    const activity = DEMO_ACTIVITIES.find((a) => a.activityRef === activityRef);
+    if (!activity) return null;
+    return { ...activity, sessions: [], description: 'mock 演示活动详情' };
+  }
+
+  async listActivityCategories() {
+    return [{ categoryId: 'demo:category:1', name: '全部' }];
+  }
+
+  async acquire(
+    _q: PromotionQueryContext,
+    input: { offerRef: string; externalMemberRef: string; idempotencyKey: string },
+  ): Promise<PromotionOperation> {
+    return {
+      operationRef: `demo:operation:${input.offerRef}`,
+      status: 'SUCCEEDED',
+      offerRef: input.offerRef,
+      codeMasked: 'DEMO-****-0001',
+      observedAt: now(),
+    };
+  }
+
+  async getOperation(_q: PromotionQueryContext, operationRef: string): Promise<PromotionOperation | null> {
+    return { operationRef, status: 'SUCCEEDED', offerRef: 'demo:coupon:1001', observedAt: now() };
+  }
+}
+
+export { emptyPage };

package/src/server/shopping.ts

@@ -0,0 +1,222 @@
+/**
+ * Mock shopping 实现（provider-mock 自持——R3-1 裁决：provider 不得依赖业务模块）。
+ * 演示面：门店/类目/楼层目录（remote 检索域四键形状的 catalog/shop/category/directory）。
+ *
+ * 设计决策：
+ * - 单一真源：DEMO_BUILDINGS 楼栋→楼层→门店 seed；类目/楼层业态/计数派生聚合；
+ *   floorCode/buildingCode 派生同值（code=name，消除 mall-context id ↔ search-shops
+ *   过滤键隐式映射）。
+ * - 纯 mock：静态数组 + 内存过滤，零 IO、零外部依赖（不依赖知识库/TBOX_API_KEY/datasetId）。
+ * - merchantId 连字符格式（demo-shop-NNNN）：LLM 从卡片 value 提取友好；getShop 入参 trim。
+ * - catalog 空实现（对齐真实档 C 端）：演示面不覆盖商品目录，门店链路为演示重点。
+ * - 构造器接受 seed（默认 DEMO_BUILDINGS）：测试可注入定制数据。
+ */
+import type {
+  CatalogQueryPort,
+  CategoryRecord,
+  CommercialCategoryQueryPort,
+  MallDirectoryQueryPort,
+  MallDirectoryRecord,
+  BuildingRecord,
+  FloorRecord,
+  ProductFacetsRecord,
+  ProductRecord,
+  ProductSearchCriteria,
+  ShopDirectoryQueryPort,
+  ShopRecord,
+  ShopSearchCriteria,
+  ShoppingPage,
+  ShoppingQueryContext,
+} from '@tbox.cn/app-contracts-mall';
+
+interface ShopSeed {
+  merchantId: string;
+  name: string;
+  brand?: string;
+  businessCategories: string[];
+  unitName: string;
+  status: { code: 'enabled' | 'disabled'; label: string };
+}
+
+interface DemoFloor {
+  floorName: string;
+  shops: ShopSeed[];
+}
+
+interface DemoBuilding {
+  buildingName: string;
+  floors: DemoFloor[];
+}
+
+/** seed 单一真源：1 楼栋 A 栋 / 6 类目 / 12 店（西贝休息中演示营业状态多样性；NIKE 双店支撑快捷命令） */
+const DEMO_BUILDINGS: DemoBuilding[] = [
+  {
+    buildingName: 'A 栋',
+    floors: [
+      {
+        floorName: 'B1',
+        shops: [
+          { merchantId: 'demo-shop-1001', name: '永辉超市', businessCategories: ['超市'], unitName: 'B1-01', status: { code: 'enabled', label: '营业中' } },
+        ],
+      },
+      {
+        floorName: '1 楼',
+        shops: [
+          { merchantId: 'demo-shop-1002', name: '星巴克', businessCategories: ['餐饮'], unitName: '101', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1003', name: '周大福', businessCategories: ['珠宝'], unitName: '102', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1004', name: '屈臣氏', businessCategories: ['美妆'], unitName: '103', status: { code: 'enabled', label: '营业中' } },
+        ],
+      },
+      {
+        floorName: '2 楼',
+        shops: [
+          { merchantId: 'demo-shop-1005', name: '华为', businessCategories: ['数码'], unitName: '201', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1006', name: '小米', businessCategories: ['数码'], unitName: '202', status: { code: 'enabled', label: '营业中' } },
+        ],
+      },
+      {
+        floorName: '3 楼',
+        shops: [
+          { merchantId: 'demo-shop-1007', name: 'NIKE 专卖店', brand: 'NIKE', businessCategories: ['运动服饰'], unitName: '301', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1008', name: 'NIKE 跑步体验店', brand: 'NIKE', businessCategories: ['运动服饰'], unitName: '302', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1009', name: '安踏', businessCategories: ['运动服饰'], unitName: '303', status: { code: 'enabled', label: '营业中' } },
+        ],
+      },
+      {
+        floorName: '4 楼',
+        shops: [
+          { merchantId: 'demo-shop-1010', name: '海底捞', businessCategories: ['餐饮'], unitName: '401', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1011', name: '外婆家', businessCategories: ['餐饮'], unitName: '402', status: { code: 'enabled', label: '营业中' } },
+          { merchantId: 'demo-shop-1012', name: '西贝莜面村', businessCategories: ['餐饮'], unitName: '403', status: { code: 'disabled', label: '休息中' } },
+        ],
+      },
+    ],
+  },
+];
+
+/** seed → 扁平门店（location/status 派生；observedAt 同一时点快照） */
+function flattenShops(buildings: readonly DemoBuilding[]): ShopRecord[] {
+  const ts = new Date().toISOString();
+  return buildings.flatMap((b) =>
+    b.floors.flatMap((f) =>
+      f.shops.map((seed) => ({
+        merchantId: seed.merchantId,
+        name: seed.name,
+        ...(seed.brand ? { brand: seed.brand } : {}),
+        businessCategories: [...seed.businessCategories],
+        location: {
+          displayText: [b.buildingName, f.floorName, seed.unitName].filter(Boolean).join(' '),
+          buildingName: b.buildingName,
+          floorName: f.floorName,
+          unitName: seed.unitName,
+        },
+        status: { code: seed.status.code, label: seed.status.label, observedAt: ts },
+        coverUrls: [],
+        services: [],
+        promotionFacts: [],
+        observedAt: ts,
+      }) satisfies ShopRecord,
+    )),
+  );
+}
+
+/** seed → 类目聚合（code=name；顺序 = 门店遍历首现序） */
+function aggregateCategories(shops: readonly ShopRecord[]): CategoryRecord[] {
+  const counts = new Map<string, number>();
+  for (const s of shops) {
+    for (const c of s.businessCategories) counts.set(c, (counts.get(c) ?? 0) + 1);
+  }
+  return [...counts.entries()].map(([name, merchantCount]) => ({ code: name, name, merchantCount }));
+}
+
+/** seed → 楼层记录（code=name 派生同值；业态/计数从该层门店聚合） */
+function toFloorRecord(floor: DemoFloor): FloorRecord {
+  const cats = [...new Set(floor.shops.flatMap((s) => s.businessCategories))];
+  return { floorCode: floor.floorName, floorName: floor.floorName, businessCategories: cats, merchantCount: floor.shops.length };
+}
+
+export class MockShoppingServiceImpl implements
+  CatalogQueryPort, ShopDirectoryQueryPort, CommercialCategoryQueryPort, MallDirectoryQueryPort {
+  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);
+    this.categories = aggregateCategories(this.shops);
+  }
+
+  // ===== ShopDirectoryQueryPort =====
+
+  async searchShops(criteria: ShopSearchCriteria): Promise<ShoppingPage<ShopRecord>> {
+    const kws = (criteria.keywords ?? (criteria.keyword?.trim() ? [criteria.keyword.trim()] : []))
+      .map((k) => k.trim().toLowerCase())
+      .filter(Boolean);
+    const cat = criteria.businessCategory?.trim();
+    const floor = criteria.floorCode?.trim();
+    const bld = criteria.buildingCode?.trim();
+    const predicates: Array<(s: ShopRecord) => boolean> = [];
+    if (kws.length > 0) {
+      predicates.push((s) =>
+        kws.some((k) =>
+          s.name.toLowerCase().includes(k) ||
+          (s.brand ?? '').toLowerCase().includes(k) ||
+          s.businessCategories.some((c) => c.toLowerCase().includes(k)),
+        ),
+      );
+    }
+    if (cat) predicates.push((s) => s.businessCategories.includes(cat));
+    if (floor) predicates.push((s) => s.location.floorName === floor);
+    if (bld) predicates.push((s) => s.location.buildingName === bld);
+    const matched = predicates.length === 0 ? this.shops : this.shops.filter((s) => predicates.every((p) => p(s)));
+    const start = (criteria.page - 1) * criteria.pageSize;
+    return {
+      items: matched.slice(start, start + criteria.pageSize),
+      page: criteria.page,
+      pageSize: criteria.pageSize,
+      total: matched.length,
+      hasMore: start + criteria.pageSize < matched.length,
+    };
+  }
+
+  async getShop(shopId: string, _ctx: ShoppingQueryContext): Promise<ShopRecord | null> {
+    const id = shopId.trim();
+    return this.shops.find((s) => s.merchantId === id) ?? null;
+  }
+
+  // ===== CommercialCategoryQueryPort =====
+
+  async listCategories(_ctx: ShoppingQueryContext): Promise<readonly CategoryRecord[]> {
+    return this.categories;
+  }
+
+  // ===== MallDirectoryQueryPort =====
+
+  async getDirectory(ctx: ShoppingQueryContext): Promise<MallDirectoryRecord | null> {
+    return {
+      mallId: ctx.scope.mallId ?? 'mall-demo',
+      mallName: '示例商场',
+      buildings: this.buildings.map((b) => ({
+        buildingCode: b.buildingName,
+        buildingName: b.buildingName,
+        floors: b.floors.map(toFloorRecord),
+      }) satisfies BuildingRecord),
+      observedAt: new Date().toISOString(),
+    };
+  }
+
+  // ===== CatalogQueryPort（空实现：演示面不覆盖商品目录，对齐真实档 C 端） =====
+
+  async searchProducts(criteria: ProductSearchCriteria): Promise<ShoppingPage<ProductRecord>> {
+    return { items: [], page: criteria.page, pageSize: criteria.pageSize, total: 0, hasMore: false };
+  }
+
+  async getProduct(_productId: string, _ctx: ShoppingQueryContext): Promise<ProductRecord | null> {
+    return null;
+  }
+
+  async getFacets(_criteria: ProductSearchCriteria): Promise<ProductFacetsRecord> {
+    return { brands: [], categories: [], priceRanges: [], floors: [] };
+  }
+}

package/tbox.module.json

@@ -0,0 +1,149 @@
+{
+  "schemaVersion": 1,
+  "name": "provider-mock",
+  "version": "0.1.0",
+  "kind": "business",
+  "risk": {
+    "level": "low",
+    "writeBoundary": "source"
+  },
+  "distribution": {
+    "defaultMode": "codegen"
+  },
+  "contributes": {
+    "handlers": [],
+    "tools": [],
+    "cards": [],
+    "routes": [],
+    "pages": [],
+    "tabs": [],
+    "providers": {
+      "slots": [
+        {
+          "service": "member.account",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-member@1"
+        },
+        {
+          "service": "member.profile",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-member@1"
+        },
+        {
+          "service": "member.card",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-member@1"
+        },
+        {
+          "service": "member.benefits",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-member@1"
+        },
+        {
+          "service": "member.enrollment",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-member@1"
+        },
+        {
+          "service": "parking.query",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-parking@1"
+        },
+        {
+          "service": "parking.payment",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-parking@1"
+        },
+        {
+          "service": "parking.vehicle",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-parking@1"
+        },
+        {
+          "service": "promotion.offers",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-promotion@1"
+        },
+        {
+          "service": "promotion.entitlements",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-promotion@1"
+        },
+        {
+          "service": "promotion.activities",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-promotion@1"
+        },
+        {
+          "service": "promotion.acquisition",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-promotion@1"
+        },
+        {
+          "service": "shopping-guide.catalog",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-shopping@1"
+        },
+        {
+          "service": "shopping-guide.shops",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-shopping@1"
+        },
+        {
+          "service": "shopping-guide.categories",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-shopping@1"
+        },
+        {
+          "service": "shopping-guide.directory",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-shopping@1"
+        },
+        {
+          "service": "mall.info",
+          "credentialType": "-",
+          "local": true,
+          "provider": "mock",
+          "implementation": "mock-mall-info@1"
+        }
+      ]
+    },
+    "services": []
+  },
+  "dependencies": {
+    "modules": []
+  },
+  "env": []
+}