# member_profiles 会员档案/账户信息

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | member_profiles |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/member_profiles.json |
| 说明 | 会员档案/会员账户信息 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | tenant_id | BIGINT | YES | 租户/品牌 ID |
| 2 | register_site_id | BIGINT | YES | 会员的注册门店 ID |
| 3 | site_name | TEXT | YES | 注册门店名称，属于冗余字段，用于直接展示 |
| 4 | id | BIGINT | NO | 这是“租户内会员账户”的主键 ID |
| 5 | system_member_id | BIGINT | YES | 这是“系统级会员 ID”，在全平台唯一，用来把一个会员在不同门店/不同卡类型下的账户统一到一个“人”的维度上 |
| 6 | member_card_grade_code | BIGINT | YES | 这两个字段是成对出现的：一个数值码，一个中文名称 |
| 7 | member_card_grade_name | TEXT | YES | 这是“会员卡种类/等级”的定义字段 |
| 8 | mobile | TEXT | YES | 会员绑定的手机号码 |
| 9 | nickname | TEXT | YES | 会员在当前租户下的显示名称（可以是姓名，也可以是昵称） |
| 10 | point | NUMERIC(18,2) | YES | 当前积分余额（这条会员账户的积分值） |
| 11 | growth_value | NUMERIC(18,2) | YES | 成长值 / 经验值，用于会员等级晋升的累计指标 |
| 12 | referrer_member_id | BIGINT | YES | 推荐人会员 ID，用于记录该会员是由哪位老会员推荐 |
| 13 | status | INTEGER | YES | 帐户状态（偏“卡状态/档案状态”） |
| 14 | user_status | INTEGER | YES | 用户账号状态（偏“用户逻辑”层面的状态） |
| 15 | create_time | TIMESTAMP | YES | 会员账户的创建时间（即这条档案/这张卡在系统中被创建的时间） |
| 16 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 17 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 18 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 19 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 20 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 21 | pay_money_sum | NUMERIC(18,2) | YES | 累计支付金额 |
| 22 | person_tenant_org_id | BIGINT | YES | 人员租户组织ID |
| 23 | person_tenant_org_name | TEXT | YES | 人员租户组织名称 |
| 24 | recharge_money_sum | NUMERIC(18,2) | YES | 累计充值金额 |
| 25 | register_source | TEXT | YES | 注册来源 |

## 使用说明

```sql
-- 查询最新入库的记录
SELECT * FROM ods.member_profiles
ORDER BY fetched_at DESC
LIMIT 10;
```

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.member_profiles
WHERE id = <value>
ORDER BY fetched_at DESC;
```

## ETL 元数据字段

| 字段名 | 类型 | 说明 |
|--------|------|------|
| content_hash | TEXT | 对业务字段计算 SHA256，用于变更检测与去重 |
| source_file | TEXT | 原始导出文件名，用于数据追溯 |
| source_endpoint | TEXT | 采集来源（接口/文件路径），用于数据追溯 |
| fetched_at | TIMESTAMPTZ | 采集/入库时间戳，用于口径对齐与增量处理 |
| payload | JSONB | 完整原始 JSON 记录快照，用于回溯与二次解析 |

## 可回溯性

| 项目 | 说明 |
|------|------|
| 可回溯 | ✅ 完全可回溯（保留 payload 原始 JSON） |
| 数据来源 | export/test-json-doc/member_profiles.json |
