@tbox.cn/app-module-member 0.1.0 → 0.2.0

package/src/client/cards/index.tsx

@@ -0,0 +1,135 @@
+/**
+ * module-member 客户端卡片渲染（011 K2：7 卡）。
+ * 只消费 SDK 基元（CardFrame/ValueText/StatusPill）+ `--tbox-*` tokens。
+ */
+import React from 'react';
+import { CardFrame, ValueText, StatusPill } from '@tbox.cn/app-sdk/client';
+import type {
+  MemberInfoCardData,
+  MemberCardSummaryCardData,
+  MemberCouponListCardData,
+  MemberCouponDetailCardData,
+  MemberPointUsageListCardData,
+  MemberEnrollmentFormCardData,
+  MemberEnrollmentStatusCardData,
+} from '@tbox.cn/app-contracts-mall';
+
+const itemStyle: React.CSSProperties = {
+  padding: '8px 0',
+  borderBottom: '1px solid var(--tbox-divider, #f0f0f0)',
+};
+
+export function MemberInfoCard(props: { data: MemberInfoCardData }) {
+  const { data } = props;
+  return (
+    <CardFrame title="会员信息">
+      <StatusPill tone={data.state === 'active' ? 'success' : 'neutral'} text={data.state === 'active' ? '已入会' : '未入会'} />
+      {data.displayName && <ValueText label="昵称" value={data.displayName} />}
+      {data.contactDisplay && <ValueText label="联系方式" value={data.contactDisplay} />}
+      {data.memberRef && <ValueText label="会员编号" value={data.memberRef} />}
+      {data.labels.length > 0 && <ValueText label="标签" value={data.labels.map((l) => l.name).join(' / ')} />}
+    </CardFrame>
+  );
+}
+
+export function MemberCardSummaryCard(props: { data: MemberCardSummaryCardData }) {
+  const { data } = props;
+  return (
+    <CardFrame title={data.cardDisplay}>
+      <StatusPill tone={data.status === 'active' ? 'success' : 'warning'} text={data.status === 'active' ? '正常' : data.status} />
+      {data.levelName && <ValueText label="等级" value={data.levelName} />}
+      <ValueText label="可用积分" value={String(data.availablePoints)} />
+    </CardFrame>
+  );
+}
+
+export function MemberCouponListCard(props: { data: MemberCouponListCardData }) {
+  const { data } = props;
+  if (data.items.length === 0) return <CardFrame title="优惠券">暂无优惠券</CardFrame>;
+  return (
+    <CardFrame title="优惠券" subtitle={`共 ${data.total} 张`}>
+      {data.items.map((c) => (
+        <div key={c.couponRef} style={itemStyle}>
+          <div style={{ display: 'flex', justifyContent: 'space-between', gap: 8 }}>
+            <span style={{ fontSize: 14, fontWeight: 600 }}>{c.title}</span>
+            <StatusPill
+              tone={c.status === 'effective' ? 'success' : 'neutral'}
+              text={c.status === 'effective' ? '可使用' : c.status}
+            />
+          </div>
+          {c.benefitText && <div style={{ fontSize: 12, color: 'var(--tbox-primary, #e93b3d)' }}>{c.benefitText}</div>}
+          {c.thresholdText && <div style={{ fontSize: 12, color: 'var(--tbox-text-secondary, #888)' }}>{c.thresholdText}</div>}
+        </div>
+      ))}
+    </CardFrame>
+  );
+}
+
+export function MemberCouponDetailCard(props: { data: MemberCouponDetailCardData }) {
+  const { data } = props;
+  return (
+    <CardFrame title={data.title}>
+      <StatusPill tone={data.status === 'effective' ? 'success' : 'neutral'} text={data.status} />
+      {data.benefitText && <ValueText label="优惠" value={data.benefitText} />}
+      {data.thresholdText && <ValueText label="门槛" value={data.thresholdText} />}
+      {data.description && <div style={{ fontSize: 13, marginTop: 4 }}>{data.description}</div>}
+    </CardFrame>
+  );
+}
+
+export function MemberPointUsageListCard(props: { data: MemberPointUsageListCardData }) {
+  const { data } = props;
+  return (
+    <CardFrame title="积分余额与流水" subtitle={`等级 ${data.level}`}>
+      <ValueText label="当前积分" value={String(data.balance)} />
+      {data.items.length > 0 && (
+        <div style={{ marginTop: 8 }}>
+          {data.items.map((u) => (
+            <div key={u.usageRecordRef} style={{ display: 'flex', justifyContent: 'space-between', padding: '4px 0' }}>
+              <span style={{ fontSize: 13 }}>{u.title}</span>
+              <span
+                style={{
+                  fontSize: 13,
+                  color: u.amount.startsWith('-') ? 'var(--tbox-primary, #e93b3d)' : 'var(--tbox-success, #0f8a5f)',
+                }}
+              >
+                {u.amount}
+              </span>
+            </div>
+          ))}
+        </div>
+      )}
+    </CardFrame>
+  );
+}
+
+export function MemberEnrollmentFormCard(props: { data: MemberEnrollmentFormCardData }) {
+  const { data } = props;
+  if (data.state === 'active') {
+    return (
+      <CardFrame title="入会">
+        <StatusPill tone="success" text="已入会" />
+      </CardFrame>
+    );
+  }
+  return (
+    <CardFrame title="会员入会" subtitle="填写信息成为会员">
+      {/* 011 评审 M1：表单输入为二期；当前最小闭环 = 按钮以会话身份入会（字段仅展示） */}
+      <div style={{ fontSize: 13, color: 'var(--tbox-text-secondary, #888)', marginBottom: 8 }}>
+        入会需要{data.fields.filter((f) => f.required).map((f) => f.label).join('、')}
+        ，当前以会话身份一键入会（表单填写二期开放）。
+      </div>
+    </CardFrame>
+  );
+}
+
+export function MemberEnrollmentStatusCard(props: { data: MemberEnrollmentStatusCardData }) {
+  const { data } = props;
+  return (
+    <CardFrame title="入会结果">
+      <StatusPill tone={data.success ? 'success' : 'warning'} text={data.success ? '入会成功' : '入会失败'} />
+      {data.memberRef && <ValueText label="会员编号" value={data.memberRef} />}
+      {data.message && <div style={{ fontSize: 13, marginTop: 4 }}>{data.message}</div>}
+    </CardFrame>
+  );
+}

package/src/client/index.ts

@@ -1,13 +1,28 @@
+/**
+ * module-member 客户端入口（与服务端 serverModule 对称）。
+ */
 import type { CardComponent } from '@tbox.cn/app-contracts';
 import type { ClientContext, ClientModule } from '@tbox.cn/app-sdk/client';
-import { PointsCard } from './cards/points';
+import {
+  MemberInfoCard,
+  MemberCardSummaryCard,
+  MemberCouponListCard,
+  MemberCouponDetailCard,
+  MemberPointUsageListCard,
+  MemberEnrollmentFormCard,
+  MemberEnrollmentStatusCard,
+} from './cards';
 
-/** 客户端卡片组件 map（key 约定 = cardType；CLI sync 装配读取） */
 const cards = {
-  points: PointsCard as CardComponent,
+  'member-info': MemberInfoCard as CardComponent,
+  'member-card-summary': MemberCardSummaryCard as CardComponent,
+  'member-coupon-list': MemberCouponListCard as CardComponent,
+  'member-coupon-detail': MemberCouponDetailCard as CardComponent,
+  'member-point-usage-list': MemberPointUsageListCard as CardComponent,
+  'member-enrollment-form': MemberEnrollmentFormCard as CardComponent,
+  'member-enrollment-status': MemberEnrollmentStatusCard as CardComponent,
 } as const;
 
-/** 模块注册入口：自注册闭环（与服务端 serverModule 对称） */
 export const clientModule = {
   cards,
   register(ctx: ClientContext): void {

package/src/server/cards/index.ts

@@ -0,0 +1,31 @@
+/**
+ * 会员 7 卡 meta 聚合导出（每卡一个 meta.ts，doctor AST 约定）。
+ */
+import memberInfoMeta from './member-info/meta';
+import memberCardSummaryMeta from './member-card-summary/meta';
+import memberCouponListMeta from './member-coupon-list/meta';
+import memberCouponDetailMeta from './member-coupon-detail/meta';
+import memberPointUsageListMeta from './member-point-usage-list/meta';
+import memberEnrollmentFormMeta from './member-enrollment-form/meta';
+import memberEnrollmentStatusMeta from './member-enrollment-status/meta';
+
+export {
+  memberInfoMeta,
+  memberCardSummaryMeta,
+  memberCouponListMeta,
+  memberCouponDetailMeta,
+  memberPointUsageListMeta,
+  memberEnrollmentFormMeta,
+  memberEnrollmentStatusMeta,
+};
+
+/** 7 卡 meta map（key 约定 = cardType） */
+export const memberCards = {
+  'member-info': memberInfoMeta,
+  'member-card-summary': memberCardSummaryMeta,
+  'member-coupon-list': memberCouponListMeta,
+  'member-coupon-detail': memberCouponDetailMeta,
+  'member-point-usage-list': memberPointUsageListMeta,
+  'member-enrollment-form': memberEnrollmentFormMeta,
+  'member-enrollment-status': memberEnrollmentStatusMeta,
+} as const;

package/src/server/cards/member-card-summary/meta.ts

@@ -0,0 +1,21 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberCardSummaryCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberCardSummaryCardDataSchema> = {
+  cardType: 'member-card-summary',
+  dataSchema: memberCardSummaryCardDataSchema,
+  allowedTools: ['queryMemberCard'],
+  displayName: '会员卡面',
+  description: '会员卡信息（等级、积分摘要）',
+  sampleData: {
+    userId: 'u_1001',
+    cardRef: 'card:u_1001',
+    cardDisplay: '大悦城会员卡',
+    status: 'active',
+    levelName: 'gold',
+    availablePoints: 860,
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-coupon-detail/meta.ts

@@ -0,0 +1,19 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberCouponDetailCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberCouponDetailCardDataSchema> = {
+  cardType: 'member-coupon-detail',
+  dataSchema: memberCouponDetailCardDataSchema,
+  allowedTools: [],
+  displayName: '优惠券详情',
+  description: '单张优惠券详情（点击列表项查看）',
+  sampleData: {
+    couponRef: 'c1',
+    title: '满 100 减 10',
+    type: 'amount',
+    status: 'effective',
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-coupon-list/meta.ts

@@ -0,0 +1,18 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberCouponListCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberCouponListCardDataSchema> = {
+  cardType: 'member-coupon-list',
+  dataSchema: memberCouponListCardDataSchema,
+  allowedTools: ['queryMemberCoupons'],
+  displayName: '优惠券列表',
+  description: '会员优惠券（状态/面额/门槛）',
+  sampleData: {
+    userId: 'u_1001',
+    items: [{ couponRef: 'c1', title: '满 100 减 10', type: 'amount', status: 'effective' }],
+    total: 1,
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-enrollment-form/meta.ts

@@ -0,0 +1,22 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberEnrollmentFormCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberEnrollmentFormCardDataSchema> = {
+  cardType: 'member-enrollment-form',
+  dataSchema: memberEnrollmentFormCardDataSchema,
+  allowedTools: ['queryEnrollmentForm'],
+  displayName: '入会表单',
+  description: '会员入会表单（写动作 member.enroll，grant 闭环）',
+  sampleData: {
+    userId: 'u_1001',
+    state: 'not_enrolled',
+    fields: [
+      { fieldId: 'name', label: '姓名', required: true },
+      { fieldId: 'phone', label: '手机号', required: true },
+    ],
+    actionId: 'member.enroll',
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-enrollment-status/meta.ts

@@ -0,0 +1,19 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberEnrollmentStatusCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberEnrollmentStatusCardDataSchema> = {
+  cardType: 'member-enrollment-status',
+  dataSchema: memberEnrollmentStatusCardDataSchema,
+  allowedTools: [],
+  displayName: '入会状态',
+  description: '入会结果状态（成功/失败 + 会员编号）',
+  sampleData: {
+    userId: 'u_1001',
+    success: true,
+    memberRef: 'member:u_1001',
+    state: 'active',
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-info/meta.ts

@@ -0,0 +1,19 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberInfoCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberInfoCardDataSchema> = {
+  cardType: 'member-info',
+  dataSchema: memberInfoCardDataSchema,
+  allowedTools: ['queryMemberInfo'],
+  displayName: '会员信息',
+  description: '会员账户状态与个人资料',
+  sampleData: {
+    userId: 'u_1001',
+    state: 'active',
+    displayName: '示例会员',
+    labels: [{ labelRef: 'member', name: '会员' }],
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/cards/member-point-usage-list/meta.ts

@@ -0,0 +1,20 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { memberPointUsageListCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof memberPointUsageListCardDataSchema> = {
+  cardType: 'member-point-usage-list',
+  dataSchema: memberPointUsageListCardDataSchema,
+  allowedTools: ['queryPoints'],
+  displayName: '积分余额与流水',
+  description: '会员积分余额、等级与变动流水（吸收教学 points 卡）',
+  sampleData: {
+    userId: 'u_1001',
+    balance: 860,
+    level: 'gold',
+    items: [{ usageRecordRef: 'r1', title: '消费奖励', amount: '+100', usedAt: '2026-08-13T00:00:00Z' }],
+    total: 1,
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/handler.ts

@@ -1,23 +1,137 @@
-import type { HandlerDefinition } from '@tbox.cn/app-sdk/server';
-import type { MemberQueryPort } from '@tbox.cn/app-contracts-mall';
-import type { ServerContext } from '@tbox.cn/app-sdk/server';
-
 /**
- * member handler：查积分 → 出 points 卡。
- * 由 scenario / intent 路由按需 dispatch；LLM 路径走 queryPoints tool。
+ * member handler + 入会写动作（011 K2：enrollment grant 闭环）。
+ * - 查积分/信息/卡 → 出对应卡（LLM 路径走同名工具）；
+ * - 写：member.enroll CardAction（singleUse grant → dispatcher 授权 → execute → 状态卡）。
+ * - 011 评审 M1 修复：execute 经 ctx.identity 取 userId（componentAction 无表单通道时
+ *   会话身份入会可用），name/phone 读 input（二期表单数据），inputSchema 补齐护栏。
  */
+import type { HandlerDefinition, ServerContext } from '@tbox.cn/app-sdk/server';
+import type { CardActionResult, RequestContext } from '@tbox.cn/app-contracts';
+import type { MemberBenefitsPort, MemberEnrollmentPort } from '@tbox.cn/app-contracts-mall';
+import { z } from 'zod';
+
 export function createMemberHandler(ctx: ServerContext): HandlerDefinition {
   return {
     id: 'member',
-    handle: async (_action, payload) => {
-      const member = ctx.resolveService<MemberQueryPort>('member');
+    handle: async (action, payload) => {
+      const member = ctx.resolveService<MemberBenefitsPort & MemberEnrollmentPort>('member');
       if (!member) return { cards: [], text: '会员服务不可用' };
       const { userId } = (payload ?? {}) as { userId?: string };
-      if (!userId) return { cards: [], text: '缺少 userId' };
+
+      switch (action) {
+        case 'query-points': {
+          if (!userId) return { cards: [], text: '缺少 userId' };
+          const points = await member.queryPoints(userId);
+          const usage = await member.listPointUsage(userId, 1, 10);
+          return {
+            cards: [
+              {
+                cardType: 'member-point-usage-list',
+                data: {
+                  userId,
+                  balance: points.balance,
+                  level: points.level,
+                  items: usage.items,
+                  total: usage.total,
+                } as unknown as Record<string, unknown>,
+              },
+            ],
+            text: `当前积分 ${points.balance}，等级 ${points.level}`,
+          };
+        }
+        default: {
+          if (!userId) return { cards: [], text: '缺少 userId' };
+          const points = await member.queryPoints(userId);
+          return {
+            cards: [
+              {
+                cardType: 'member-point-usage-list',
+                data: {
+                  userId,
+                  balance: points.balance,
+                  level: points.level,
+                  items: [],
+                  total: 0,
+                } as unknown as Record<string, unknown>,
+              },
+            ],
+            text: `当前积分 ${points.balance}，等级 ${points.level}`,
+          };
+        }
+      }
+    },
+  };
+}
+
+/** 入会写动作（011 E1/E4）：声明式 CardAction + singleUse grant。
+ * 011 评审 M1 修复：userId 优先取 ctx.identity（会话身份），input 仅承载二期表单数据；
+ * inputSchema 恒存在（空表单也通过——身份入会为最小闭环）。 */
+export const enrollActionInputSchema = z.object({
+  userId: z.string().optional(),
+  name: z.string().optional(),
+  phone: z.string().optional(),
+});
+
+export function createEnrollAction(
+  getMember: () => (MemberEnrollmentPort & MemberBenefitsPort) | undefined,
+): { actionId: string; componentId: string; cardType: string; label: string; singleUse: boolean; inputSchema: z.ZodTypeAny; execute(input: unknown, ctx: RequestContext): Promise<CardActionResult> } {
+  return {
+    actionId: 'member.enroll',
+    componentId: 'member',
+    cardType: 'member-enrollment-form',
+    label: '提交入会',
+    singleUse: true,
+    inputSchema: enrollActionInputSchema,
+    async execute(input, ctx): Promise<CardActionResult> {
+      // 011 M1：userId 优先会话身份（dispatcher 传入 ctx；表单无输入通道时身份入会仍闭环）
+      const sessionUserId = ctx?.identity?.userId;
+      const { userId: inputUserId, name, phone } = (input ?? {}) as {
+        userId?: string;
+        name?: string;
+        phone?: string;
+      };
+      const userId = sessionUserId ?? inputUserId;
+      const member = getMember();
+      if (!userId) {
+        return {
+          card: {
+            cardType: 'member-enrollment-status',
+            data: { userId: '', success: false, message: '缺少 userId', state: 'not_enrolled' },
+          },
+          text: '入会失败：缺少身份信息',
+        };
+      }
+      if (!member) {
+        return {
+          card: {
+            cardType: 'member-enrollment-status',
+            data: { userId, success: false, message: '会员服务不可用', state: 'not_enrolled' },
+          },
+          text: '入会失败：会员服务不可用',
+        };
+      }
+      const result = await member.enroll({ userId, ...(name ? { name } : {}), ...(phone ? { phone } : {}) });
+      if (!result.success) {
+        return {
+          card: {
+            cardType: 'member-enrollment-status',
+            data: { userId, success: false, message: result.error, state: 'not_enrolled' },
+          },
+          text: `入会失败：${result.error ?? '未知错误'}`,
+        };
+      }
       const points = await member.queryPoints(userId);
       return {
-        cards: [{ cardType: 'points', data: points as unknown as Record<string, unknown> }],
-        text: `当前积分 ${points.balance}，等级 ${points.level}`,
+        card: {
+          cardType: 'member-enrollment-status',
+          data: {
+            userId,
+            success: true,
+            ...(result.memberRef ? { memberRef: result.memberRef } : {}),
+            state: 'active',
+          },
+        },
+        text: `入会成功！当前积分 ${points.balance}，等级 ${points.level}`,
       };
     },
   };

package/src/server/index.ts

@@ -1,33 +1,86 @@
-import type { ServerContext, ServerModule, TypedBus } from '@tbox.cn/app-sdk/server';
+import type { ServerContext, ServerModule, TypedBus, PreToolDef } from '@tbox.cn/app-sdk/server';
+import { definePreTool } from '@tbox.cn/app-sdk/server';
 import type { MallEventMap } from '@tbox.cn/app-contracts-mall';
 import { InMemoryMemberService } from './service';
-import pointsMeta from './cards/points/meta';
-import { createQueryPointsTool } from './tool';
-import { createMemberHandler } from './handler';
+import memberInfoMeta from './cards/member-info/meta';
+import memberCardSummaryMeta from './cards/member-card-summary/meta';
+import memberCouponListMeta from './cards/member-coupon-list/meta';
+import memberCouponDetailMeta from './cards/member-coupon-detail/meta';
+import memberPointUsageListMeta from './cards/member-point-usage-list/meta';
+import memberEnrollmentFormMeta from './cards/member-enrollment-form/meta';
+import memberEnrollmentStatusMeta from './cards/member-enrollment-status/meta';
+import {
+  createQueryPointsTool,
+  createQueryMemberInfoTool,
+  createQueryMemberCardTool,
+  createQueryMemberCouponsTool,
+  createQueryEnrollmentFormTool,
+} from './tool';
+import { createMemberHandler, createEnrollAction } from './handler';
 
 export { InMemoryMemberService } from './service';
 export type { MemberService } from './service';
-export { default as pointsMeta } from './cards/points/meta';
+export { memberCards } from './cards';
 
 /**
  * 模块级单例（B14）：实例在模块包加载时创建，serverModule.register 幂等（重复调用共享状态）。
- * 服务实例生命周期 = 模块包加载期，而非 register 调用次数。
  */
 const member = new InMemoryMemberService({ u_1001: 860, u_1002: 120 });
 
+/** 工具实例顶层创建（010：pre-tool 声明引用工具实例 = 单一真源） */
+const queryPointsTool = createQueryPointsTool(() => member);
+const queryMemberInfoTool = createQueryMemberInfoTool(() => member);
+const queryMemberCardTool = createQueryMemberCardTool(() => member);
+const queryMemberCouponsTool = createQueryMemberCouponsTool(() => member);
+const queryEnrollmentFormTool = createQueryEnrollmentFormTool(() => member);
+
 /** 卡片 meta 声明 map（key 约定 = meta.cardType；数据 + 类型源） */
 const cards = {
-  points: pointsMeta,
+  'member-info': memberInfoMeta,
+  'member-card-summary': memberCardSummaryMeta,
+  'member-coupon-list': memberCouponListMeta,
+  'member-coupon-detail': memberCouponDetailMeta,
+  'member-point-usage-list': memberPointUsageListMeta,
+  'member-enrollment-form': memberEnrollmentFormMeta,
+  'member-enrollment-status': memberEnrollmentStatusMeta,
 } as const;
 
+/** 入会写动作（011 E4：singleUse grant 闭环） */
+const enrollAction = createEnrollAction(() => member);
+
+/**
+ * 前置工具声明（010）：queryPoints 的 userId 可工程化获取（会话身份），
+ * 无需模型抽参——always 必选候选 + 身份可用即预执行。
+ */
+const preTools = {
+  queryPoints: definePreTool(queryPointsTool, {
+    routing: { mode: 'always' },
+    decide: ({ identity }) =>
+      identity && identity.source !== 'anonymous'
+        ? { decision: 'run', args: { userId: identity.userId } }
+        : { decision: 'skip', reason: '匿名身份不预执行' },
+  }),
+} satisfies Record<string, PreToolDef>;
+
 /** 模块注册入口：自注册闭环（与客户端 clientModule 对称） */
 export const serverModule = {
+  declaration: {
+    componentId: 'member',
+    features: ['member-profile', 'member-card', 'member-benefits', 'member-points', 'member-coupons', 'member-enrollment'],
+  },
   cards,
+  preTools,
   register(ctx: ServerContext): void {
     ctx.services.register('member', member);
-    ctx.tools.register(createQueryPointsTool(() => ctx.resolveService('member')));
+    ctx.tools.register(queryPointsTool);
+    ctx.tools.register(queryMemberInfoTool);
+    ctx.tools.register(queryMemberCardTool);
+    ctx.tools.register(queryMemberCouponsTool);
+    ctx.tools.register(queryEnrollmentFormTool);
     ctx.cards.registerMap(cards);
     ctx.handlers.register(createMemberHandler(ctx));
+    // 011 E7：入会写动作声明（装配端 dispatcher 收集 + 出卡时签发 token）
+    ctx.cardActions.register(enrollAction);
 
     // 类型化事件总线：以 MallEventMap 收窄（keyof 约束载荷类型，编译期对齐）
     const mallBus = ctx.bus as unknown as TypedBus<MallEventMap>;
@@ -37,7 +90,7 @@ export const serverModule = {
       await member.awardPoints(userId, Math.floor(amount / 10));
     });
 
-    // 等级变更对外发布（member 发事件，其他模块订阅）；publish 为 async（B1，fire-and-forget）
+    // 等级变更对外发布（member 发事件，其他模块订阅）
     member.onLevelChange(({ userId, newLevel }) => {
       void mallBus.publish('member.level.changed', { userId, newLevel });
     });