jackyu66gitandCursor
2fb1dfee14
Archive the differentiated YuXinGu product docs, AI engineering system, design contract, and Go/Vue scaffold. Next execution prioritizes Cece-parity over early innovation (see .ai/product/STRATEGY.md). Co-authored-by: Cursor <cursoragent@cursor.com>
184 lines
6.2 KiB
Markdown
184 lines
6.2 KiB
Markdown
# Domain Map — 愈心谷（DDD 视角）
|
||
|
||
给后端 / DB / OpenAPI / SDK 用的**能力域与实体图**。
|
||
词汇以 [../domain.md](../domain.md) 为准；产品范围以 [../product/feature-map.md](../product/feature-map.md) 为准。
|
||
竞品能力对照：[../product/cece-feature-map.md](../product/cece-feature-map.md)。
|
||
|
||
AI 生成表结构或 API 时：先落本图中的 Context / Aggregate，再写 migration；禁止发明未列出的聚合根名。
|
||
|
||
---
|
||
|
||
## 1. Bounded Contexts
|
||
|
||
```
|
||
┌─────────────┐ ┌──────────────┐ ┌─────────────┐
|
||
│ Identity │──▶│ Profile │──▶│ Discovery │
|
||
│ (User) │ │ Life Archive│ │ Decode/Scale│
|
||
└─────────────┘ └──────┬───────┘ └──────┬──────┘
|
||
│ │
|
||
▼ ▼
|
||
┌──────────────┐ ┌─────────────┐
|
||
│ Relationship │ │ Ask │
|
||
│ Match │ │ Companion │
|
||
└──────┬───────┘ └──────┬──────┘
|
||
│ │
|
||
▼ ▼
|
||
┌─────────────────────────────────┐
|
||
│ Commerce │
|
||
│ Subscription / Order / Unlock │
|
||
└─────────────────────────────────┘
|
||
│
|
||
┌──────────────┼──────────────┐
|
||
▼ ▼ ▼
|
||
ContentFeed GrowthShare Consult(*)
|
||
(* later)
|
||
```
|
||
|
||
| Context | 职责 | MVP |
|
||
|---|---|---|
|
||
| **Identity** | Visitor/User/Session | Yes |
|
||
| **Profile** | Self/Other 生命档案 | Yes |
|
||
| **Discovery** | Decode、Scale、Report 生成 | Yes |
|
||
| **Relationship** | Match | Yes |
|
||
| **Ask** | 档案上下文对话、额度 | Skeleton |
|
||
| **Companion** | SolarTerm、Mood | Skeleton |
|
||
| **Commerce** | Subscription、Membership、Order、Unlock、Payment | Yes (mock) |
|
||
| **Content** | Feed 配置 | Static OK |
|
||
| **Growth** | Share 卡片元数据 | Minimal |
|
||
| **Consult** | 真人顾问 Marketplace | No |
|
||
| **Recommendation** | 推荐 | V1 rules |
|
||
|
||
---
|
||
|
||
## 2. Aggregates & Entities（命名强制）
|
||
|
||
### Identity
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **User** | 注册主体 |
|
||
| Entity | Session | token 会话 |
|
||
| Entity | DeviceIdentity | Visitor 匿名 |
|
||
|
||
### Profile（生命档案）
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **Profile** | `relation`: self \| other |
|
||
| VO | BirthInput | date；time/place optional later |
|
||
| VO | RelationType | partner/family/friend/… |
|
||
|
||
### Discovery
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **Report** | type: decode \| match \| … |
|
||
| Domain Svc | DecodeEngine | 可复算；结果入 Report |
|
||
| Aggregate | **Scale** | 量表定义 |
|
||
| Entity | ScaleQuestion | |
|
||
| Aggregate | **ScaleResult** | 作答 + 计分 |
|
||
|
||
### Relationship
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **Match** | 引用两个 Profile；产出 Report 或嵌入 |
|
||
|
||
### Ask / Companion
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **AskThread** | 挂 profile_id |
|
||
| Entity | AskMessage | role user/assistant |
|
||
| Entity | AskQuota | 与 Membership 联动 |
|
||
| Aggregate | **Mood** | 日维度打卡 |
|
||
| Read Model | **SolarTerm** | 日历内容；可配置表 |
|
||
|
||
### Commerce
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | **Subscription** | 计划 SKU |
|
||
| Aggregate | **Membership** | 用户权益状态 |
|
||
| Aggregate | **Order** | 订阅或 Unlock |
|
||
| Entity | Payment | mock / 渠道 |
|
||
| Entity | Unlock | order → report 解锁 |
|
||
|
||
### Content / Growth（薄）
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Entity | FeedItem | 运营配置 |
|
||
| VO | SharePayload | 分享卡字段 |
|
||
|
||
### Consult（Later）
|
||
|
||
| Type | Name | Notes |
|
||
|---|---|---|
|
||
| Aggregate | Consultant | |
|
||
| Aggregate | ConsultOrder | |
|
||
| Entity | ConsultSession | |
|
||
|
||
---
|
||
|
||
## 3. 关键关系（ER 草图）
|
||
|
||
```
|
||
User 1──* Profile
|
||
Profile 1──* Report
|
||
Profile 1──* AskThread
|
||
User 1──* ScaleResult
|
||
User 1──0..1 Membership
|
||
User 1──* Order
|
||
Order 0..1── Unlock ──▶ Report
|
||
Profile ── Match ── Profile
|
||
User 1──* Mood
|
||
```
|
||
|
||
权益规则：**Membership / Unlock 只由服务端判定**；客户端不可信任。
|
||
|
||
---
|
||
|
||
## 4. Context → 代码落点
|
||
|
||
| Context | Go | H5 |
|
||
|---|---|---|
|
||
| Identity | `internal/service/user` | login / mine |
|
||
| Profile | `service/profile` | decode form, mine |
|
||
| Discovery | `service/report`, `service/scale` | decode, explore, report |
|
||
| Relationship | `service/match` | match |
|
||
| Ask | `service/ask` | ask tab |
|
||
| Companion | `service/companion` | companion tab |
|
||
| Commerce | `service/order`, `membership` | paywall, mine |
|
||
|
||
包名只用 `domain.md` 词汇：`user` `profile` `report` `order` `membership` `scale` `ask` `mood`。
|
||
|
||
---
|
||
|
||
## 5. 测测域 → 愈心谷域 映射
|
||
|
||
| 测测概念 | 愈心谷 |
|
||
|---|---|
|
||
| 星盘档案 | **Profile**（生日+体质相关输入） |
|
||
| 测测 AI | **Ask** |
|
||
| 真人 1v1 | **Consult**（后置） |
|
||
| MBTI 等 | **Scale** |
|
||
| 缘分合盘 | **Match**（合规叙事） |
|
||
| 今日运势 | **SolarTerm** + 生活建议（替换） |
|
||
| 会员 | **Subscription / Membership** |
|
||
| AI 玩法广场 | **[No] MVP** |
|
||
| 心情打卡 | **Mood** |
|
||
| 沙盘/心情小镇 | **[No]** |
|
||
|
||
---
|
||
|
||
## 6. 生成顺序（给 AI）
|
||
|
||
1. 改范围 → 更新 `product/feature-map.md` MVP 标记
|
||
2. 新实体 → 本文件 + `domain.md` 词条（若新词）
|
||
3. migration → `playbooks/new-table.md`
|
||
4. API → `playbooks/add-api.md` + OpenAPI
|
||
5. 页面 → `playbooks/new-page.md` + design contract
|
||
|
||
下一步可选：单独 `apps/docs/erd.md` 或 migrations 初稿（本任务不强制）。
|