digital-psychology/.ai/product/feature-spec/image-card.md

Feature Spec: 意象卡片

Status: Active · Map: 2.8 意象卡片 [P2] · Phase: P2 Complete
规范：../feature-design.md · 队列：P2-BACKLOG.md
竞品对照：塔罗体系（能力同构；UI 禁止「塔罗」入口名）

---

1. 功能定义

字段	内容
Name	意象卡片
Purpose	通过抽取 1～3 张意象卡，对当下议题做投射反思，并给出结构化反思题与行动建议
Business Goal	高趣味探索与分享；免费次数 + 深度解读转化

In	Out
场景选题 · 抽卡 · 探索摘要 · 深度组合解读	吉凶判定、神谕、恐吓
卡面内容库（seed）	UI 文案「塔罗」「牌阵占卜」
每日免费次数规则	宿命叙事

---

2. 用户价值

1. 为何需要： 卡住时需要一个轻量的外在意象帮助整理感受。
2. 完成后获得： 卡片意象说明、反思问题、可执行小建议；深度版含组合解读与练习。
3. 为何付费： 多卡组合与完整练习路径。

---

3. 用户角色

Actor	能力
Visitor	每日免费 N 次基础抽卡（N 实现时定数，建议 1～3）
DeepAccess（本结果）/ VIP	深度组合解读
可选挂档案	有档案时文案可轻微个性化（非必须）

---

4. 用户流程

/cards
  ↓
选择场景：情绪整理 / 关系 / 选择 / 自我
  ↓
检查今日免费次数
  ├─ 耗尽 → 引导会员或明日再来（可看历史）
  └─ 有余 → 抽 1 张（免费）或解锁 3 张组合（深度）
        ↓
      展示意象 + 反思题 + 建议
        ↓
      分享（积极、非恐吓视觉）

---

5. 页面设计

路由	页面
/cards	ImageCardPage（P2 draft）
/explore	入口「意象卡片」
/reports/:id 或结果页内	深度结果沉淀（可选）

/cards
├── Scene picker
├── Loading（抽卡动画，克制）
├── Normal（单卡摘要）
├── Locked（组合深度）
├── Quota empty
└── Error

---

6. 页面状态规范

状态	UI
Loading	抽卡中
Normal	意象说明 + 反思
Locked	组合解读墙
Quota empty	次数用尽说明 + 会员 CTA
Error	重试

---

7. Business Rules

ID	Rule
R1	用户可见文案不得出现「塔罗」；用「意象卡片」「探索」「反思」
R2	禁止吉凶、神谕式断言、恐吓（如「大难」）
R3	输出必须含：意象描述 · 至少 1 个反思问题 · 1 条可执行建议
R4	免费：每日有限次单卡摘要；深度：3 卡组合 + 练习（Membership 或单次 DeepAccess）
R5	抽卡随机可接受，但卡面文案来自审核过的内容库（非模型现场胡编吉凶）
R6	分享卡不得含恐吓图文；过 lexicon
R7	次数与权益 Server 判定

---

8. 数据模型影响

项	说明
内容库	image_cards 表或 seed JSON（id, title, image_key, explore_text, prompts[]）
结果	growth_reports.type=image_card 或 scale_results 变体（实现时二选一，写 OpenAPI）
配额	用户日维度计数（表或 Redis）；实现时定

禁止：tarot_* 作用户可见 API 路径名（对内包名用 imagecard）。

---

9. API 需求（草案）

Method	Path	意图
GET	/api/v1/image-cards/scenes	场景列表
POST	/api/v1/image-cards/draw	scene → 抽卡结果（扣免费次）
GET	/api/v1/image-cards/quota	今日剩余
GET	/api/v1/reports/{id}	若沉淀为报告

深度组合可同 draw 参数 depth=true + 权益校验。

---

10. 权限设计

能力	免费额度内	额度外	深度权益
单卡摘要	✓	✗	✓
三卡组合解读	✗	✗	✓

---

11. 埋点

Event	触发
cards_scene_selected	选场景
cards_drawn	抽卡成功
cards_quota_exhausted	次数用尽
deep_access_clicked	surface=cards
cards_share_clicked	分享

---

12. 测试验收标准

Given 有免费次数
When 抽卡
Then 返回意象+反思题+建议；响应与 UI 无「塔罗」「吉凶」

Given 次数为 0
When 再抽
Then 业务错误，不生成假深度

Given 无深度权益
When 请求组合解读
Then Locked / 剥离

---

13. AI 开发前检查

• Spec 齐全 · 禁用塔罗入口已写清
• lexicon ImageCard
• 内容库 seed 与 OpenAPI（编码时）

---

14. Implementation Notes

项	内容
复用	ShareSheet · membership/orders · Explore 入口
工作量	卡面文案/视觉资产最大；宜先 22～78 张小库 MVP
Packages	internal/imagecard · ImageCardPage /cards
实现	scenes/quota/draw API · 报告 type=image_card · 日配额 · ≥78 牌（手写底稿+确定性扩容）· ≥8 场景
Gaps	全手写美术资产；推送
Label	Feature Complete（P2）