# Domain Language — Ubiquitous Terms

Use ONLY these words in code, API, UI copy (Chinese labels noted).  
Do not invent synonyms (Customer / Client / Account) unless added here via ADR.

**Bounded contexts / aggregates / ER:** [domain/domain-map.md](domain/domain-map.md)  
**Product feature tree:** [product/feature-map.md](product/feature-map.md)

## Identity & access

| Term | Meaning | Not |
|---|---|---|
| **Visitor** | 未登录访客；可有匿名 device id | Guest（勿混用） |
| **User** | 已注册主体（有 user id） | Customer / Client |
| **Member** | 同 User：已注册用户的业务称呼；代码字段优先 `user` | — |
| **VIP** | 付费会员期内的 User（membership active） | Member（勿把所有注册用户叫 VIP） |
| **Session** | 登录态 / token 会话 | — |

## Commerce

| Term | Meaning |
|---|---|
| **Subscription** | 会员订阅计划（月/季/年） |
| **Membership** | 用户当前会员权益状态（是否 VIP、到期时间、额度） |
| **Order** | 支付订单（报告解锁或订阅） |
| **Payment** | 一笔支付尝试 / 渠道回调结果 |
| **Refund** | 退款记录 |
| **Unlock** | 对某 Report 的购买解锁（非 VIP 也可单次解锁） |

## Profile & content

| Term | Meaning |
|---|---|
| **Profile** | 档案：自己或 TA 的生日等输入 |
| **Self Profile** | relation = self |
| **Other Profile** | relation = other（TA） |
| **Decode** | 愈心解码报告（数字性格 + 体质建议） |
| **Report** | 统称：Decode / Match / 尊享报告等可交付物 |
| **Match** | 双人/家庭契合度报告 |
| **Scale** | 心理量表 |
| **ScaleResult** | 量表作答与计分结果 |

## Retention & AI

| Term | Meaning |
|---|---|
| **Companion** | 陪伴域：节气、心情 |
| **SolarTerm** | 二十四节气内容单元 |
| **Mood** | 每日心情打卡 |
| **Ask** | 「问」能力：基于 Profile 的解读对话 |
| **Consult** | 真人顾问咨询（后置） |

## Platform

| Term | Meaning |
|---|---|
| **user-h5** | 用户 H5 客户端 |
| **mini-program** | 微信小程序客户端 |
| **api** | Go 后端唯一服务 |
| **Legacy** | 根目录旧静态原型，只读 |

## Naming in code

- Go packages / JSON: `user`, `profile`, `report`, `order`, `membership`, `scale`
- Never: `customer`, `client` (except HTTP client), `account` (unless wallet later + ADR)