摘要
FR-3.6-04（溯源 AI-3.6-04，Could · P2 后段）要求建设线下 AI 新零售广场：智能接待区、AI 产品展示区、商务交流区、线上结算引导区、智能码服务；线下人员绑定线上数字员工身份，扫码承接持续服务；线下交易统一走线上标准化流程。PRD 验收要点原文：「线下扫码承接闭环可追踪；线下交易 100% 走线上标准化流程」。现状判定：广场/展位/活动实体零实现（backend/src 检索 0 业务命中），但三块衔接件在位——物理点位模型雏形（H2B 仓收点）、QR 生成+lead 归因闭环、线下签署记录（cooperation-agreement 双轴）。
本卡为概念级承接系统架构 TDD（降级承诺：强外部依赖 X-venue-resources 线下场地资源+活动运营模式未定，且依赖数字员工落地形态 DEP-3.6-03——仅做承接系统架构级设计，字段级显式推迟，不承诺字段级完整度）。设计四块：①实体架构（plaza/booth/activity+五大功能区映射）②扫码三级归因扩展（店铺级/员工级/活动级）③线下交易线上化约束 ④广场合作协议挂点。线上化约束为本卡核心「不做」清单：不建线下第二交易链路，结算引导区唯一职能是引导扫码进入三前台既有下单/支付链路。
验收要点
2 条
扫码承接闭环可追踪（三级归因+lead 闭环全链路可查）/ 线下交易 100% 线上标准化（负向验收：无线下交易入口）
从零新建
3 类实体
plaza / booth / activity + 五大功能区映射 + 数字员工绑定槽位（DEP-3.6-03 后落地）+ 协议挂点 + 功能聚合开关
前置 blocker
2 个
X-venue-resources（外部场地资源/运营模式）· DEP-3.6-03（数字员工底座，阻塞员工级归因落地）
负证据（本 run 复核）
0 业务命中
rg -i "plaza|booth|exhibition|展位|广场|快闪" backend/src 0 业务命中——三类实体从零新建关键概念
复用范式而非复用实体
本卡硬约束（要素 4，逐字声明）：
h2b-receiving-location 是 H2B 仓收点（语义=平台收货位置），非展位——展位/活动为新实体，仅参照其字段范式（唯一码/地理坐标/服务区域/启停/排序），实体本体、模块、数据均不复用不迁移。五大功能区 → booth_type
PRD 需求描述原文五区映射为展位类型枚举：智能接待区=
reception（数字员工承接）、AI 产品展示区=display、商务交流区=business、线上结算引导区=checkout、智能码服务=smart_code——实体类型映射的唯一合法来源。三级归因
店铺级（distribution-lead.store_id/seller_id 显式化）/ 员工级（booth.digital_employee_id 绑定槽位→lead.metadata，DEP-3.6-03 后落地）/ 活动级（activity/booth id→lead.metadata.plaza_ctx）——QR 参数化封装，参数仅承载标识 id 不承载个人信息。
线上化约束
「线下交易 100% 走线上标准化流程」的技术落法是一组「不做」约束：不建线下第二交易链路（无线下 POS/现金记账/场外订单）；结算引导区唯一职能=引导扫码进入三前台既有下单/支付链路；验收=广场场景订单 100% 有线上单据可归因。
lead 归因闭环（复用）
distribution-lead 既有状态机 pending→contacted→converted/expired；
convert-distribution-lead.ts 置 converted+关联 order_id/order_total 落 metadata，幂等（同单重入无变更）+补偿恢复旧状态——广场订单归因沿用，零新增 Workflow。X-venue-resources
线下场地资源与活动运营模式（外部前置，findings blockers 原文 blocks「AI-3.6-04 完整设计」）。广场 venue_ref 为弱关联占位——平台不建场地资产库，场地主数据归运营侧/外部；活动运营模式（内容/权益）属其域，本卡只建归因挂点。
DEP-3.6-03
数字员工对话底座依赖（AI-3.6-03 owns）：阻塞员工级归因落地（digital_employee_id 绑定本体与身份形态未定）；不阻塞店铺级/活动级归因与其余架构——绑定槽位可空字段先行。
降级范式（NFR-3.8-01）
数字员工未配置/未绑定时扫码降级静态直达：QR 直达店铺/商品页（FR-3.6-05 既有能力=兜底路径），lead 归因照常（店铺/活动级）——「未配置/故障即跳过不阻断主业务」，主业务=线下引流线上承接，AI 接待为增强层。
双轴协议范式（复用）
cooperation-agreement「审批轴（status 3 态）+签署轴（signing_status 4 态 not_signed/offline_pending/offline_signed/terminated）」——线下签署留痕（signed_at）既有，广场入驻/展位租用协议直接挂此模式，经 agreement_type 新值候选扩展（不改既有协议语义）。
方案设计
架构总览与红线声明
flowchart TB
V["线下场地（X-venue-resources 外部前置：场地/档期/运营模式）"]
P["广场 plaza"]
B["展位 booth（五大功能区类型）"]
A["活动 activity"]
DE["员工级承接：digital_employee_id 绑定槽位（DEP-3.6-03）"]
QR["三级归因 QR（店铺级/员工级/活动级，参数化封装）"]
LEAD["lead 归因闭环（distribution-lead 复用：pending 到 converted 幂等）"]
SESS["承接：数字员工会话（AI-3.6-03 引用）/ 店铺商品页直达（FR-3.6-05 兜底）"]
ORDER["成交：三前台既有下单/支付链路（零新增交易链路）"]
V --> P
P --> B
B --> A
B --> DE
P --> QR
B --> QR
A --> QR
QR -->|扫码| LEAD
LEAD --> SESS
SESS --> ORDER
设计红线（AGENTS.md §0.1，逐条对照）
- Workflow 承载业务逻辑：plaza/booth/activity 全部状态变更走 Workflow step（架构级声明，steps 链字段级推迟）；归因写入复用 distribution-lead 既有 Workflow 链；
- 不修改上游源码：
@medusajs/*/@mercurjs/*零触碰；distribution-lead/cooperation-agreement/share-qr-code 均为本地资产，扩展经新模块+官方扩展点； - 后端单一数据源：广场实体/归因/协议状态以后端为准，三前台/vendor-panel 仅消费；
- 参数化 SQL：归因统计聚合查询参数化绑定（沿 products route q 分支正面范式）。
实体架构：plaza / booth / activity（架构级，复用范式声明）
复用范式声明（要素 4 硬约束，逐字声明）
本卡复用范式而非复用实体——h2b-receiving-location（models/h2b-receiving-location.ts:3-19，复核 :4-20）是 H2B 仓收点（语义=平台收货位置，contact/address/service_regions 服务收货调度），非展位；展位/活动为新实体，仅参照其字段范式（唯一码/地理坐标/服务区域/启停/排序），实体本体、模块、数据均不复用不迁移。
erDiagram
PLAZA {
text id PK "prefix plaza"
text name "一场一档"
text venue_ref "场地资源引用，X-venue-resources 未落前占位"
text address_geo "address/city/lat-lng（参照 receiving-location 范式）"
text period "档期"
text status "draft active ended"
jsonb metadata
}
BOOTH {
text id PK "prefix booth"
text plaza_id FK "归属广场"
text code "展位唯一码（参照 code unique 范式）"
text name
text booth_type "reception display business checkout smart_code"
text seller_id "入驻商家，弱关联（可空）"
text digital_employee_id "员工级承接绑定槽位（DEP-3.6-03，可空）"
text location_desc
jsonb metadata
}
ACTIVITY {
text id PK "prefix actv"
text plaza_id "可空"
text booth_id "可空"
text name
text activity_type
text qr_target "扫码承接目标：店铺/商品/会话路由参数"
text period
text status
jsonb metadata
}
PLAZA ||--o{ BOOTH : "归属"
PLAZA ||--o{ ACTIVITY : "归属（可空）"
BOOTH |o--o{ ACTIVITY : "展位内活动（可空）"
BOOTH }o--o| DIGITAL_EMPLOYEE : "digital_employee_id 绑定槽位（DEP-3.6-03 后启用，本卡 owns 槽位定义）"
五大功能区映射（PRD 需求描述原文五区 → booth_type 枚举）：
| 功能区（PRD 原文） | booth_type | 承载设计 |
|---|---|---|
| 智能接待区 | reception | 智能接待由数字员工承接（引用 AI-3.6-03 对话底座——禁第二 AI 通路）；booth 绑定 digital_employee_id 即接待入口 |
| AI 产品展示区 | display | 商品陈列=既有商品库引用（选品联动：FR-3.4-02 建档/FR-3.4-03 选品规划注记，非本卡范围） |
| 商务交流区 | business | 洽谈承接+合作协议签署挂点（cooperation-agreement，见协议挂点一节） |
| 线上结算引导区 | checkout | 扫码下单链路=三前台既有下单/支付（线上化约束——引导下单，无独立收银） |
| 智能码服务 | smart_code | 三级归因 QR 的物料服务点 |
扫码三级归因扩展（与既有闭环兼容设计）
现状边界（缺口⑤探索复核）：share-qr-code.tsx:34 注释明示 QR「Encodes the given url directly (no affiliate / referral wrapping)」——QR 本体无来源参数封装；现有归因靠 distribution-qr-dialog 分销链路单独实现（lead_type=qrcode，product 级）。三级归因需在 QR 承接层统一参数化封装，而非各对话框零散拼装。
| 维度 | 归因载体 | 现状 | 扩展设计（架构级） |
|---|---|---|---|
| 店铺级 | distribution-lead.store_id（:23）+seller_id（:24） | 字段在，承接口径随商品 QR 隐式 | 显式化：广场场景 QR 携店铺标识参数，lead 创建必落 store_id |
| 员工级 | 无字段（绑定槽位新建） | 无 | booth.digital_employee_id 槽位→QR 携员工标识→lead.metadata 记录 digital_employee_id——DEP-3.6-03 阻塞落地（数字员工实体与身份绑定形态未定，本卡只定义槽位关系） |
| 活动级 | 无字段 | 无 | activity/booth id→QR 携活动/展位标识→lead.metadata 记录 plaza_ctx（{booth_id, activity_id}） |
payload 兼容设计：①QR url 参数化封装（如 ?plaza_ctx=… UTM-like 结构化参数——编码格式随实现定稿，架构级约定：参数仅承载标识 id，不承载个人信息，NFR-3.9-01 最小化）；②归因落库复用 distribution-lead.metadata jsonb（:31 既有扩展位）——plaza_ctx 对象承载三级维度，零 lead 表结构变更起步（lead_type 新增 plaza_qr 枚举值为候选扩展，经迁移，字段级推迟）；③转化闭环复用 convert-distribution-lead.ts 幂等范式（:30-35「Idempotent」+补偿恢复）——广场订单归因沿用 order_id 关联+metadata 扩展，闭环语义与既有分销归因同构。
sequenceDiagram
autonumber
participant U as 到场客户（扫码）
participant Q as 三级归因 QR（plaza_ctx 参数化 url）
participant L as lead 创建（distribution-lead 复用）
participant S as 承接层
participant O as 三前台下单/支付（既有链路）
participant C as convert-distribution-lead（幂等）
U->>Q: 扫码
Q->>L: 参数解析（仅标识 id）→ lead 创建 pending
alt 数字员工已绑定（DEP-3.6-03 解除后）
L->>S: 数字员工会话承接（AI-3.6-03 底座引用）
else 未绑定/未配置（降级）
L->>S: 静态直达店铺/商品页（FR-3.6-05 兜底）
end
S->>O: 引导扫码下单（零新增交易链路）
O->>C: 订单归因（order_id 关联 + metadata.plaza_ctx）
C->>L: lead 置 converted（幂等：同单重入无变更，补偿恢复旧状态）
stateDiagram-v2
state "pending（已留资）" as P
state "contacted（已触达）" as C
state "converted（已转化，关联订单）" as V
state "expired（已过期）" as E
[*] --> P: 扫码创建 lead（plaza_ctx 落 metadata）
P --> C: 承接触达（数字员工会话/静态直达）
C --> V: 下单支付后归因（幂等：同单重入无变更）
P --> E: 过期
C --> E: 过期
note right of V: converted 由 convert-distribution-lead step 置入并关联 order_id/order_total——闭环可追踪（验收 A1），复用既有状态机零新增
线上结算引导与线下交易线上化约束（约束声明型设计）
约束声明（PRD 验收要点硬口径，本卡核心「不做」清单）
- 不建线下第二交易链路——无线下 POS/现金记账/场外订单承载设计（代码面负向验收：广场域无新增交易入口，A2）；
- 结算引导区（booth_type=checkout）的唯一职能=引导扫码进入三前台既有下单/支付链路（storefront/b2b/h2b 零新增交易代码——复用声明）；
- 渠道冠名商家场景交易沿用 FR-3.6-02 既有收款结算（渠道商收款→上游供应商直发，零库存直发链路对账一致为既有验收）；
- 合规联动：面向消费者页面《特定商取引法》法定表示沿 FR-3.6-01 合规提示（引用不展开）。
协议联动：广场合作协议挂点（复用声明）
cooperation-agreement 模式复用（models/cooperation-agreement.ts:14-38 复核精确）：广场入驻协议/展位租用协议挂「审批轴（status 3 态 :5-9/:30）+签署轴（signing_status 4 态 :20-22）」双轴范式——线下签署走 offline_pending→offline_signed（signed_at :25 留痕既有）；广场场景扩展经 agreement_type 新值候选（plaza_booth 类，:19 default "standard_distribution" 的枚举扩展——架构级注记，不改既有协议语义，字段级随实装定稿）。compensation/Saga 不涉及（协议审批为既有人工流，非本卡新建）。
降级与跳过路径（NFR-3.8-01 强制范式）
| 故障场景 | 行为 |
|---|---|
| 数字员工未配置/未绑定（DEP-3.6-03 未解除） | 扫码降级静态直达：QR 直达店铺/商品页（FR-3.6-05 既有能力=兜底路径），lead 归因照常（店铺/活动级）——范式句：「未配置/故障即跳过不阻断主业务」（主业务=线下引流线上承接，AI 接待为增强层） |
| 归因参数异常（QR 参数缺失/伪造） | lead 按 lead_type=other 兜底创建或不建（参数校验拒绝），扫码直达零阻断（参数解析失败不影响页面访问） |
| 广场功能 flag 关闭 | 全部广场入口/页面不可见，既有 QR/lead 闭环零影响 |
跳过路径测试点（要素 8 必含）：①digital_employee 绑定缺失→扫码静态直达成功+店铺/活动级 lead 正常；②QR 参数伪造→归因拒绝+直达成功；③flag 关闭→广场入口不可见+既有 QR 链路回归通过。
合规挂钩
| NFR / 评估项 | 影响判定 | 本卡动作 |
|---|---|---|
| NFR-3.9-01（APPI 数据最小化） | 扫码留资场景：广场 QR 落地/承接过程采集来访人信息（留资表单/会话身份）——收集字段须最小必要 | 约束声明：①QR 归因参数仅承载标识 id 不承载个人信息；②留资表单字段清单随期 1 功能设计+合规评估定稿（本卡不预设）；③画像级个性化承接（期 3）前置 C6 评估域（引用注记） |
| NFR-3.9-04（面向公众 AI 输出巡检） | 活动运营话术/展位介绍若经 AI 生成——属面向公众 AI 话术 | 引用 AI-3.9-04 巡检机制（ai_patrol_task/ai_patrol_record，scope=活动话术/展位内容）——引用不设计，巡检挂接随 AI 话术生产落地启用 |
| AI 身份明示 | 智能接待区数字员工互动须向用户明示 AI 身份（不得伪装自然人——AI-3.6-03 合规挂钩①原文） | 引用声明：明示三通道（开场明示/持续标识/prompt 约束）归 AI-3.6-03，本卡展位绑定槽位不改变其明示义务 |
| NFR-3.8-01 | AI 增强不阻断主业务 | 降级三态+测试点 |
| 特商法（引用） | 面向消费者法定表示沿 FR-3.6-01 合规提示 | 线上化约束④引用 |
| 外部决策点引用规范 | 数值（闭环转化率目标/留资保存期限等）基线立项定（DEC-5）；X-venue-resources 仅引用不预设运营模式 | 全文执行 |
Workflow 与 API 契约（架构级）
upsert-plaza / transition-plaza（draft→active→ended 白名单，守卫在 step）
upsert-booth / transition-booth（含 digital_employee_id 绑定校验——DEP-3.6-03 后启用）
upsert-activity / transition-activity
assign-plaza-agreement（协议挂点：agreement_type 扩展值创建→cooperation-agreement 既有审批/签署流承接）steps 细节与补偿逻辑=字段级推迟项（RK-13 降级承诺）；lead 归因链路零新增 Workflow（复用 distribution-lead 既有链）。
| 路由（规划名） | 方法 | 权限域 | 契约要点 |
|---|---|---|---|
/admin/plazas、/[id] | GET/POST/POST | admin | 广场 CRUD+状态流转（入 Workflow；venue_ref 占位） |
/admin/plazas/[id]/booths | GET/POST/POST | admin | 展位 CRUD+booth_type 枚举+digital_employee_id 绑定（DEP-3.6-03 后开放） |
/admin/activities | GET/POST/POST | admin | 活动 CRUD+qr_target 配置 |
/vendor/plaza-booths（或既有 vendor API 域内） | GET | vendor | 入驻商家查看自家展位与归因统计（三级维度报表） |
| QR 承接 | — | public | 三级归因参数化 url——落点为既有店铺/商品页+lead 创建链路，无新增公开交易面 |
错误码统一：400/404/409（非法状态迁移）。字段级 request/response schema 显式推迟（X-venue-resources/DEP-3.6-03 双前置，字段级 TDD 增量随期 1 立项）。
分期路线、迁移与回滚
| 分期 | 内容 | 波次/时点 | 前置 |
|---|---|---|---|
| 期 1 | 实体+店铺级/活动级归因+线上化约束（无数字员工依赖部分） | p2-c 架构本卡；期 1 字段级实施随场地资源落地立项 | X-venue-resources（部分——venue_ref 占位不阻架构） |
| 期 2 | 员工级归因绑定落地 | DEP-3.6-03 解除后（AI-3.6-03 Phase 2 个人级分身定稿） | DEP-3.6-03 |
| 期 3 | AI 个性化承接（扫码识别来源与偏好/智能落地页——FR-3.6-05 差距栏「后续增强项」） | 随 C6 评估域与画像能力规划（AI-3.7-02 联动域，本卡仅留 qr_target 扩展位） | C6 评估+画像能力 |
Migration（medusa db:generate 规范）
期 1 实施时 schema（plaza/booth/activity 三表）经 medusa db:generate 生成（新模块独立 migration，规划模块名 offline-plaza，命名避让 employee/company 域）——本卡架构阶段零 migration 承诺（不做无实现支撑的表结构臆造，字段级推迟的一致性落位）；lead 表零 schema 变更起步（plaza_ctx 落 metadata jsonb 既有扩展位；lead_type 枚举扩展为候选，经迁移评估）；seed 兼容：不改 pnpm db:reset / db:reset:demo——种子不含广场数据；功能 flag 默认关=现状行为，种子链路零依赖零破坏。
| 变更 | 回滚路径 |
|---|---|
| 广场功能整体 | feature flag 关闭（规划 featureFlags.offline_plaza，medusa-config featureFlags 区同位范式 medusa-config.ts:55-56 复核，默认 false）→ 广场入口整体不可见；既有 QR/lead 闭环零影响（独立开关设计——关闭不影响 FR-3.6-05 既有承接） |
| 归因扩展 | QR 参数解析为加法逻辑（无参数=现状行为逐字节等价）；lead.metadata.plaza_ctx 为附加数据（可废弃不回滚） |
| 协议挂点 | agreement_type 扩展值停用即回退（既有协议类型语义零改动） |
| 实体数据 | 状态 ended/disabled 即业务下线；物理回滚仅限 migration down（新表无历史包袱） |
上线顺序：期 1（flag 开启→实体+归因+结算引导）→ 期 2（DEP-3.6-03 后员工级绑定，独立子开关）→ 期 3（C6 域评估后 AI 个性化承接）。全卡不改动既有 QR/lead/协议/交易链路语义。
前端改动面与 i18n
前端触点（逐端，架构级）
| 端 | 改动 |
|---|---|
| admin-panel | 新增广场管理页（plaza/booth/activity 三级列表+五大功能区筛选——套既有列表页范式 cooperation-agreements/page.tsx:9-65 模式引用）；归因统计报表入口 |
| vendor-panel | 入驻商家展位视图+归因统计（自家数据）；share-qr-code 组件复用（QR 生成零改动，承接 url 由广场场景参数化——组件注释 :34 的「no wrapping」现状由上层 url 组装解决，组件本体不动） |
| storefront ×3 | 零新增交易面（线上化约束——扫码落点=既有店铺/商品页；承接归因参数解析为轻量中间层，不改下单支付代码） |
| b2b/h2b storefront | 无改动（期 1） |
i18n 规划
admin-panel i18n/translations/{en,zhCN,ja}.json 新增 plaza.* 命名空间：五大功能区枚举名 plaza.boothType.reception | display | business | checkout | smartCode、状态/归因维度列头。三语值随实现提交；vendor-panel 同步其既有 i18n 机制。
验收与测试
验收标准（PRD 要点+技术口径——架构级承诺边界）
| # | 验收标准 | 映射 |
|---|---|---|
| A1 | 线下扫码承接闭环可追踪（PRD 原文）：每枚广场 QR 扫码→lead 记录→承接→转化全链路状态可查（复用 distribution-lead 状态机）；三级归因维度（店铺级/员工级/活动级）可区分统计（员工级随 DEP-3.6-03 解除）；闭环转化率指标名 plaza_qr_conversion_rate，数值基线立项定（DEC-5） | 三级归因 / 测试策略 |
| A2 | 线下交易 100% 走线上标准化流程（PRD 原文）：广场场景产生订单 100% 有线上单据（order↔lead 归因关联可查）；负向验收：代码面无线下交易入口（无场外交易承载设计） | 线上化约束 |
| A3 | 五大功能区数字化映射：五功能区 booth_type 枚举齐备且与 PRD 需求描述原文一一对应 | 实体架构 |
| A4 | 复用范式声明落地：展位/活动为新实体（h2b-receiving-location 实体本体零改动——回归守卫）；cooperation-agreement 既有语义零破坏（既有协议类型回归通过） | 实体架构 / 协议挂点 |
| A5 | 降级路径（AI 未配置/未绑定零阻断）：数字员工缺失→扫码静态直达成功+归因照常；QR 参数异常→直达成功（三测试点） | 降级路径 / NFR-3.8-01 |
| A6 | L0 门禁：本文档十要素齐备+关键锚点可 rg（h2b-receiving-location / share-qr-code / convert-distribution-lead / cooperation-agreement / X-venue-resources / DEP-3.6-03 / AI-3.6-03-digital-employee.md / 复用范式而非复用实体 / 线下交易线上化 / 店铺级·员工级·活动级 / DEC-5） | 模板 |
| A7 | 分期与推迟声明：字段级设计显式标注推迟（X-venue-resources/DEP-3.6-03 解除后立项），无虚假完整度承诺 | depth_baseline / RK-13 缓解 |
测试策略（分层）与 L0 门禁
架构级 TDD 的测试承诺边界
本卡交付时无实现可测——测试设计为期 1/2 实施时的用例框架（在此声明防止验收空转）。
| 层 | 期 1/2 用例框架（本卡定义形态，实现期填充） |
|---|---|
| 单测（实体+Workflow） | plaza/booth/activity 状态白名单矩阵；booth_type 五枚举校验；digital_employee_id 绑定校验（期 2，绑定缺失降级分支） |
| 单测（归因） | QR 参数解析（正常/缺失/伪造三态）；lead plaza_ctx 落库；convert-distribution-lead 幂等复用回归（既有单测形态参照） |
| 单测（降级） | A5 三测试点（绑定缺失直达/参数伪造/flag 关闭） |
| integration（API） | admin 广场管理 CRUD+归因统计三维度口径；协议挂点创建（agreement_type 扩展值） |
| 既有回归 | distribution-lead 闭环/cooperation-agreement 既有流/share-qr-code 组件行为（QR 生成语义零改动）回归守卫 |
量化指标占位口径
plaza_qr_conversion_rate（闭环转化率，数据源：lead 状态聚合）、留资转化率、活动参与统计口径、留资信息保存期限＝全部基线立项定（DEC-5）。
风险与开放问题
已识别风险
blocker
X-venue-resources 未定：线下场地资源与活动运营模式阻塞完整设计与落地
findings blockers 原文 blocks「AI-3.6-04 完整设计」；PRD 现状说明原文「建设节奏依赖线下场地资源」。阻塞广场实体字段级定稿（venue_ref/档期/场地主数据形态）、活动运营模式（活动类型/权益/话术）、期 1 生产上线排期。缓解：venue_ref 占位承载、场地信息后填——实体架构/归因扩展/线上化约束三块架构级设计先行（架构级交付即本卡），期 1 字段级 TDD 增量随场地资源落地立项。
blocker
DEP-3.6-03：数字员工底座未定，员工级归因无法落地
findings blockers 原文 blocks「AI-3.6-04 扫码承接升级」——digital_employee_id 绑定本体与身份形态未定（AI-3.6-03 owner_type 两步走 Phase 2 个人级分身未定稿）。缓解：绑定槽位可空字段先行；店铺级/活动级归因+QR 参数化封装+闭环兼容设计全量推进；数字员工评估输入（广场接待数据流描述）可由本卡供给其卡合规评估。
中
QR 参数封装被绕过或伪造：归因数据失真
QR 参数解析为加法逻辑，参数可被人为篡改（plaza_ctx 伪造）。缓解：参数校验拒绝（lead 不建或按 lead_type=other 兜底）；参数仅承载标识 id 不承载个人信息（最小化，降低伪造收益）；扫码直达零阻断（参数解析失败不影响页面访问）。
低
概念级交付易被误期待字段级完整度
降级承诺（RK-13）下本卡不承诺字段级设计。缓解：全文显式标注「字段级推迟」与双 blocker 解除条件；A7 验收项专设「无虚假完整度承诺」核对。
前提与假设
假设
- 设计归属总口径（承任务卡 design_ownership，不得越界）：本卡 owns 承接系统架构（实体架构+五大功能区映射）/扫码三级归因扩展/线上化约束/协议挂点；数字员工实体与身份绑定（AI-3.6-03 owns）、既有 QR/lead 闭环与下单支付链路（复用不重设计）、场地资源与活动运营模式（X-venue-resources）均 references_only；
- 三类实体架构级字段域为架构示意，非冻结——字段级随 X-venue-resources 落地后立项；
- 负证据（plaza|booth|exhibition|展位|广场|快闪 0 业务命中）为本 run rg 复核结论；QR 无参数封装（share-qr-code.tsx:34 注释）为探索复核新发现（缺口⑤）；漂移双写共 2 处（h2b-receiving-location.ts、share-qr-code.tsx）；
- 本 TDD 为设计文档，不改任何源代码/迁移/配置（执行契约约束）。
开放问题
- X-venue-resources：线下场地资源与活动运营模式（活动类型/权益/话术）确定时点——阻塞期 1 字段级立项与生产排期。
- DEP-3.6-03：数字员工 Phase 2 个人级分身定稿时点——决定期 2 员工级归因绑定解锁。
- DEC-5：闭环转化率
plaza_qr_conversion_rate目标、留资转化率、留资信息保存期限等数值定档。 - 期 3 AI 个性化承接随 C6 评估域与画像能力规划的立项时点（AI-3.7-02 联动域）。
前置决策点
Blocker 二分表（要素 7 承担主要约束表达——conceptual 级硬要求）
| Blocker | 类型 | 阻塞什么 | 可并行做什么 |
|---|---|---|---|
| blocker X-venue-resources（线下场地资源与活动运营模式未定——findings blockers 原文；PRD FR-3.6-04 现状说明原文「建设节奏依赖线下场地资源」） | external_resource | 阻塞完整设计与落地：广场实体字段级定稿（venue_ref/档期/场地主数据形态）、活动运营模式（活动类型/权益/话术）、期 1 生产上线排期；不阻塞承接系统架构三块（实体架构/归因扩展/线上化约束的架构级设计与开发——venue_ref 占位承载，场地信息后填） | 实体架构+归因扩展+线上化约束全量可先行（架构级交付即本卡）；lead metadata 扩展位先行（零 schema 变更起步）；归因统计口径先行定义；期 1 字段级 TDD 增量随场地资源落地立项 |
| blocker DEP-3.6-03（数字员工对话底座——findings blockers 原文 blocks：「AI-3.6-04 扫码承接升级」） | internal_dependency | 阻塞员工级归因落地（digital_employee_id 绑定本体与身份形态未定——AI-3.6-03 owner_type 两步走 Phase 2 个人级分身未定稿）；不阻塞店铺级/活动级归因与其余架构（绑定槽位可空字段先行，绑定校验逻辑随其卡解锁） | 店铺级/活动级归因+QR 参数化封装+闭环兼容设计全量推进；员工级仅定义槽位关系，绑定实施期 2（DEP-3.6-03 解除后）；数字员工评估输入（广场接待数据流描述）可由本卡供给其卡合规评估 |
内部依赖与交叉引用
| 方向 | 条目 | 关系 |
|---|---|---|
| 上游 | AI-3.6-03-digital-employee.md（p2-b） | 依赖链声明：AI-3.6-03→本条（DEP-3.6-03）；数字员工实体形态与身份绑定=员工级归因槽位来源（references_only）；AI 身份明示/对话底座全量引用 |
| 复用 | FR-3.6-05（已实现） | QR 生成+静态直达=兜底路径与升级基座（复用不重设计） |
| 复用 | FR-3.6-02 / FR-3.6-01（已实现） | 冠名店铺结算+三前台交易链路=线上化约束承载面（复用声明） |
| 复用 | cooperation-agreement（已实现） | 广场合作协议挂点（双轴范式） |
| 同波 | AI-3.7-02-personal-digital-avatar.md（C 波） | 期 3 AI 个性化承接的画像能力远期联动（引用注记，无设计耦合——同波异域无文件冲突） |
| 决策点 | DEC-5 | 闭环转化率/留资字段保存期限等数值占位 |
待决问题清单
- 前置决策 X-venue-resources：场地资源方与活动运营模式确定（外部资源）——决定期 1 字段级立项与生产排期。
- 前置决策 DEP-3.6-03：AI-3.6-03 Phase 2 个人级分身定稿——决定期 2 员工级绑定解锁时点。
- 前置决策 DEC-5：闭环转化率目标/留资转化率/保存期限等数值——基线立项时定档。
- 前置决策 lead_type 枚举扩展（plaza_qr 候选值）：经迁移评估后定稿（字段级推迟项）。
附录：溯源对照
本文档由 docs/reports/ai-module-prd/tdd/AI-3.6-04-offline-retail-plaza.md（文档版本 v1.0，2026-10-26）转换生成。输出章节与源章节映射如下（Preserved = 保留原文内容；Summarized = 摘要化重组；Inferred = 转换侧推断标注）：
| 本文档章节 | 源章节 | 处理方式 |
|---|---|---|
| 摘要 | 元数据表 + §1.1 PRD 溯源 + §1.3 现状三态判定 + §4.0 降级承诺声明 | Summarized |
| 关键概念 | 文首口径声明 + §1.2 关联映射 + §4.1/§4.2/§4.3/§4.4/§5.2 术语 | Summarized |
| 方案设计 · 架构总览与红线声明 | §4.0（含 AGENTS.md 红线逐条对照） | Preserved |
| 方案设计 · 实体架构与五大功能区映射 | §4.1（复用范式声明+三类实体字段域+五区映射表+分期路线） | Preserved（复用范式声明逐字保留） |
| 方案设计 · 扫码三级归因扩展 | §4.2（现状边界缺口⑤+三级维度表+payload 兼容设计）+ §2.1②③ 锚点 | Preserved（share-qr-code.tsx:34 注释引文逐字保留） |
| 方案设计 · 线上化约束与结算引导 | §4.3（约束声明四条+承接链路） | Preserved |
| 方案设计 · 协议挂点 | §4.4（cooperation-agreement 复用声明） | Preserved |
| 方案设计 · 降级与跳过路径 | §5.1 无直接调用声明 + §5.2 降级三态与测试点 | Preserved（范式句逐字保留） |
| 方案设计 · 合规挂钩 | §6（六项挂钩表） | Preserved |
| 方案设计 · Workflow 与 API | §4.5 API 契约 + §4.6 Workflow 设计 | Preserved |
| 方案设计 · 分期路线与迁移回滚 | §9 分期与波次映射 + §10 Migration/回滚/feature flag | Preserved |
| 前端改动面与 i18n | §4.7（逐端触点+i18n 规划） | Preserved |
| 验收与测试 | §8.1 验收标准 A1-A7 + §8.2 测试策略与量化占位 | Preserved |
| 风险与开放问题 | §3.2 缺口清单 + §7.1 blocker 表（风险分级为转换侧判定，与 blocker 标注对齐） | Inferred |
| 前置决策点 | §7.1 Blocker 二分表 + §7.2 内部依赖与交叉引用 | Preserved |
| 图1 / 图2 / 图3 / 图4 | §4.0 架构总览 / §4.1 实体字段域 / §4.2+§4.3 承接链路 / §2.1③+§4.2 lead 状态机 | Inferred（依源文字与 ASCII 图示绘制的可视化视图） |
溯源说明
源文档全部锚点在执行 run 以 rg/sed 逐条复核；漂移双写共 2 处（h2b-receiving-location.ts 卡内 :3-19 → 字段区 :4-20、share-qr-code.tsx 卡内 :41-56 → forwardRef :41/QR 渲染 :67），convert-distribution-lead.ts:10-16/:30-35、cooperation-agreement.ts:14-38、distribution-lead.ts:21-31 复核精确无漂移；负证据（plaza|booth|exhibition|展位|广场|快闪 0 业务命中）经复核成立；QR 无参数封装（share-qr-code.tsx:34 注释）为探索复核新发现。内部流程标识（session/run 编号、TASK 编号、findings 引用）属过程元数据，不影响契约性内容（约束声明、归因设计、API 路由规划、验收标准均完整保留）。