Files

qiaoxinjiu 3f7f88cf91 docs: update WishFulfilled knowledge base

2026-05-29 14:33:56 +08:00

21 KiB

Raw Permalink Blame History

identity 子系统 — doris数据库相关表与关联关系（供参考）

1. 数据库全景

数据库	说明	与 identity 的关系
`ods_app_base_data`	APP基础数据（用户、设备、好友、产品）	核心 — 用户身份主数据
`ods_app_app_community`	社区数据（帖子、评论、关注）	行为数据，辅助归并
`ods_app_jh_data`	JOYHUB事件数据	行为数据，辅助归并
`ods_oa_oaaftersales`	OA售后系统（客户、订单、测评）	核心 — 非APP用户身份线索
`app_tag_data`	标签数据	关键 — 已有 OneID 归并表

2. 核心发现：已存在的 OneID 归并表

`app_tag_data.user_oneid` — 用户唯一标识归并表（6 字段，已有数据）

这是 identity 子系统 M2（归并引擎）的核心参考，已实现 uuid → one_id 的归并逻辑

字段	类型	键	说明
`uuid`	VARCHAR(64)	UNI, NOT NULL	原始客户唯一标识符
`one_id`	VARCHAR(64)	NOT NULL	用户唯一标识（归并后的ID）
`bridge_uuid`	STRING		当前 uuid 对应的非当前桥接 uuid
`association_fields`	STRING		关联字段
`detail`	STRING		uuid 指向 one_id 的证据说明（JSON）
`update_time`	DATETIME(3)		同步更新时间

关键设计点：

uuid → one_id 是多对一关系（多个 uuid 可归并到同一个 one_id）
bridge_uuid 记录桥接关联，用于跨系统身份串联
detail 字段存储归并证据（JSON），与设计文档中 person_profiles.merge_evidence 概念一致
association_fields 记录关联字段，对应设计文档中的线索类型

3. 核心表状态

设计文档定义的 4 张核心表 尚未在数据库中创建：

表名	设计文档定义	数据库状态	与现有表的关系
`person_profiles`	真实人主表	不存在	可参考 `app_tag_data.user_oneid`（one_id）
`person_identity_links`	身份线索关联表	不存在	可参考 `ods_oa_oaaftersales.customer_platform_info`（type映射线索类型）
`contact_context_snapshots`	上下文快照	不存在	需聚合多表新建
`device_records`	设备变化记录	不存在	可参考 `user_device_token_log`（已有252万条记录）

4. 已存在的数据源表

4.1 用户与身份核心表

`ods_app_base_data.users` — 用户主表（36 字段）

identity 子系统的核心用户数据源，提供 JOYHUB ID、邮箱、设备号等身份线索

字段	类型	键	说明
`id`	BIGINT	UNI	用户ID（JOYHUB ID）
`userName`	STRING		用户名
`email`	STRING		邮箱
`deviceToken`	VARCHAR(300)		设备推送令牌
`IMEI`	STRING		设备IMEI
`sysType`	VARCHAR(765)		系统类型（安卓/IOS/Windows Phone）
`deviceId`	STRING		设备ID
`appVersion`	VARCHAR(90)		APP版本
`contact_information`	VARCHAR(765)		联系方式（电话号码）
`mobile`	STRING		手机号
`area_code`	BIGINT		区域代码（美国1，中国86）
`status`	TINYINT		1活跃/2封禁/3注销
`sysTime`	DATETIME		系统时间（注册时间）
`created_at`	DATETIME		创建时间

`ods_app_base_data.user_login_last` — 最近登录信息（21 字段）

提供设备型号、系统版本、APP版本、国家等信息，是设备变化识别（M4）的重要数据源

字段	类型	键	说明
`UserId`	BIGINT	UNI	用户ID → 关联 `users.id`
`deviceId`	STRING		设备ID
`deviceModel`	VARCHAR(150)		手机型号
`device`	VARCHAR(150)		手机系统
`sysType`	VARCHAR(150)		系统设备信息与版本
`appVersion`	VARCHAR(45)		APP版本号
`appChannel`	INT		渠道
`countryName`	VARCHAR(600)		国家名称
`countryCode`	VARCHAR(30)		国家缩写
`Time`	DATETIME		登录时间
`Ip`	STRING		IP地址

`ods_app_base_data.user_device_token_log` — 设备令牌变更日志（7 字段，252万行）

记录设备令牌的添加和更新，可用于追踪设备变化

字段	类型	键	说明
`id`	INT	UNI	主键
`user_id`	INT		用户ID → 关联 `users.id`
`type`	TINYINT		0添加/1更新
`device_id`	STRING		设备ID
`new_device_token`	VARCHAR(300)		新设备令牌
`created_at`	DATETIME		创建时间
`client_time`	DATETIME		客户端时间

`ods_app_base_data.user_contact_information_history` — 联系方式变更历史（11 字段，20万行）

记录用户手机号等联系方式的变更历史，可用于身份线索追踪

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	主键
`user_id`	BIGINT		用户ID → 关联 `users.id`
`user_type`	VARCHAR(150)		用户角色
`area_code`	BIGINT		区域代码
`mobile`	STRING		手机号
`area_id`	INT		区域ID
`marketing_phone`	TINYINT		营销电话开关
`marketing_sms`	TINYINT		个性化广告开关
`status`	SMALLINT		1生效中/2已过期
`verify_status`	SMALLINT		短信验证状态：1通过/2未通过
`created_at`	BIGINT		创建时间

`ods_app_base_data.banned_device_id` — 设备封禁表（3 字段，6831行）

字段	类型	键	说明
`id`	INT	UNI	主键
`device_id`	VARCHAR(765)		封禁设备ID
`created_at`	INT		创建时间

`ods_app_base_data.blacklist_users_aggregate` — 用户黑名单汇总（8 字段）

按 uid、设备、IP 维度的黑名单，用于风险判断

字段	类型	键	说明
`id`	INT	UNI	主键
`target_id`	INT		1=uid, 2=设备, 3=IP
`target_value`	VARCHAR(1500)		字段值
`category_id`	INT		黑名单类别ID
`describe`	VARCHAR(1500)		加入原因

4.2 OA 售后系统 — 客户身份数据

`ods_oa_oaaftersales.customer` — 客户主表（22 字段，23万行）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	客户ID
`name`	STRING		客户名
`country`	VARCHAR(60)		国家
`is_black`	TINYINT		是否黑名单
`high_risk`	TINYINT		是否高风险
`erp_contact`	STRING		ERP联系方式
`erp_pay_account`	VARCHAR(1500)		ERP付款账号

`ods_oa_oaaftersales.customer_platform_info` — 客户平台信息（8 字段，26万行）

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`type`	TINYINT		1电话/2邮箱/3joyhub_id/4邮箱编码/5twitter/6facebook
`customer_id`	INT		客户ID → 关联 `customer.id`
`account`	STRING		账号值
`is_delete`	TINYINT		是否删除

`ods_oa_oaaftersales.customer_address` — 客户地址（18 字段，5631行）

提供姓名+地址组合，可用于 ORDER_NAME_ADDRESS 线索归并

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`customer_id`	INT		客户ID → 关联 `customer.id`
`recipient_name`	STRING		收件人姓名
`phone`	STRING		电话
`zip_code`	STRING		邮编
`country`	VARCHAR(300)		国家
`city`	STRING		城市
`state`	STRING		州/省
`detail`	VARCHAR(1500)		详细地址

`ods_oa_oaaftersales.customer_payment_account` — 客户付款账号（12 字段，10万行）

提供收款信息（银行卡、PayPal等），可作为身份归并线索

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`ct_id`	INT		客户ID → 关联 `customer.id`
`pay_name`	VARCHAR(150)		支付方式
`account_number`	STRING		账号
`account_name`	STRING		账户名
`card_no`	VARCHAR(300)		卡号

`ods_oa_oaaftersales.customer_bind` — 客户绑定关系（6 字段，4980行）

客户间的绑定关系，已有归并概念

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`customer_ids`	STRING		绑定的客户ID集合
`unbind_time`	DATETIME		解绑时间
`is_deleted`	TINYINT		是否删除

`ods_oa_oaaftersales.customer_bind_log` — 客户绑定日志（6 字段，1.2万行）

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`user_id`	INT		操作人ID
`bind_customer_ids`	STRING		绑定的客户ID
`type`	VARCHAR(765)		操作类型

`ods_oa_oaaftersales.evaluation_order` — 测评订单（55+ 字段，45万行）

包含丰富的身份线索：邮箱、电话、JOYHUB ID、社交媒体账号

字段	类型	键	说明
`id`	BIGINT	UNI	订单ID
`ct_id`	INT		客户ID → 关联 `customer.id`
`amazon_order_id`	STRING		亚马逊订单号
`email`	STRING		邮箱
`phone`	STRING		电话
`joyhub_id`	VARCHAR(150)		JOYHUB ID
`twitter`	STRING		Twitter账号
`facebook`	STRING		Facebook账号

`ods_oa_oaaftersales.lingxing_order` — 亚马逊订单（30+ 字段，2142万行）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	订单ID
`amazon_order_id`	VARCHAR(150)		亚马逊订单号
`buyer_name`	VARCHAR(765)		买家姓名
`buyer_email`	VARCHAR(765)		买家邮箱
`phone`	VARCHAR(90)		电话
`postal_code`	VARCHAR(765)		邮编
`address`	VARCHAR(765)		地址

`ods_oa_oaaftersales.phone_records` — 电话记录（30+ 字段，8万行）

字段	类型	键	说明
`id`	BIGINT	UNI	主键
`ct_id`	INT		客户ID → 关联 `customer.id`
`phone`	STRING		电话
`email`	STRING		邮箱
`joyhub_id`	VARCHAR(150)		JOYHUB ID

4.3 社区行为表

`ods_app_app_community.posts` — 帖子表（35 字段）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	帖子ID
`user_id`	INT		用户ID → 关联 `users.id`
`status`	SMALLINT		10待审核/20拒绝/30通过
`deleted_at`	INT		删除时间（0=未删除）

`ods_app_app_community.post_likes` — 点赞表（5 字段）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	主键
`post_id`	BIGINT		帖子ID → 关联 `posts.id`
`user_id`	INT		用户ID → 关联 `users.id`

`ods_app_app_community.comments` — 评论表（14 字段）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	评论ID
`post_id`	DECIMAL(20,0)		帖子ID → 关联 `posts.id`
`user_id`	DECIMAL(20,0)		用户ID → 关联 `users.id`

`ods_app_app_community.follows` — 关注关系表（7 字段）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	主键
`user_id`	INT		关注者ID → 关联 `users.id`
`following_user_id`	INT		被关注者ID → 关联 `users.id`

`ods_app_base_data.friends` — 好友关系表（6 字段）

字段	类型	键	说明
`id`	DECIMAL(20,0)	UNI	主键
`user_id`	DECIMAL(20,0)		用户ID → 关联 `users.id`
`friend_id`	DECIMAL(20,0)		好友ID → 关联 `users.id`

4.4 事件行为表

`ods_app_jh_data.events` — APP事件表（18 字段）

event_type: 13=home, 8=玩具连接, 5=视频等

字段	类型	键	说明
`id`	BIGINT	UNI	事件ID
`add_date`	DATE	UNI	记录日期
`uid`	BIGINT		用户ID → 关联 `users.id`
`event_type`	INT		事件类型
`pid`	BIGINT		产品ID → 关联 `def_product_list.id`

`ods_app_jh_data.remote_events` — 远程连接事件表（15 字段）

字段	类型	键	说明
`id`	BIGINT	UNI	事件ID
`uid`	BIGINT		用户ID → 关联 `users.id`
`call_sn`	VARCHAR(600)		远程序列号（格式：uid1_uid2_uuid）
`mode`	INT		1文字/2语音/3视频

5. 表关联关系图

┌─────────────────────────────────────────────────────────────────────────┐
│                        identity 子系统数据关系                           │
└─────────────────────────────────────────────────────────────────────────┘

                          ┌───────────────────────┐
                          │  app_tag_data         │
                          │    .user_oneid        │
                          │  uuid ──► one_id      │
                          │  (已有归并逻辑)        │
                          └───────────┬───────────┘
                                      │ uuid 可能是 email/phone/device
                                      ▼
┌──────────────────────────────────────────────────────────────────────┐
│                    ods_app_base_data（APP用户体系）                   │
│                                                                      │
│  users ◄── user_profiles (user_id)                                   │
│    │       user_login_last (UserId) ── deviceId, deviceModel         │
│    │       user_device_token_log (user_id) ── 252万条设备变更记录     │
│    │       user_contact_information_history (user_id) ── 20万条变更   │
│    │       friends (user_id / friend_id)                             │
│    │       banned_device_id (device_id) ── 设备封禁                   │
│    │       blacklist_users_aggregate (target_id+target_value)        │
│    │                                                                 │
│    └── id = JOYHUB_ID                                                │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│                    ods_oa_oaaftersales（OA售后体系）                  │
│                                                                      │
│  customer ◄── customer_platform_info (customer_id)                   │
│    │            type: 1电话/2邮箱/3joyhub_id/5twitter/6facebook       │
│    │         customer_address (customer_id) ── 姓名+地址+电话         │
│    │         customer_payment_account (ct_id) ── 收款账号             │
│    │         customer_bind (customer_ids) ── 客户绑定关系             │
│    │         customer_bind_log ── 绑定操作日志                        │
│    │         evaluation_order (ct_id) ── 邮箱/电话/joyhub_id/社媒     │
│    │         phone_records (ct_id) ── 电话/邮箱/joyhub_id            │
│    │         order_refund (ct_id) ── 返款详情                        │
│    │                                                                 │
│  lingxing_order ── buyer_name + buyer_email + phone + address        │
│    └── lingxing_order_item (amazon_order_id)                         │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│                    社区行为（ods_app_app_community）                  │
│                                                                      │
│  posts ◄── post_likes (post_id, user_id)                             │
│    │       comments (post_id, user_id)                               │
│    └── follows (user_id, following_user_id)                          │
└──────────────────────────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────────────┐
│                     事件行为（ods_app_jh_data）                       |
│                                                                      │
│  events (uid, event_type, pid)                                       │
│  communities (uid, event_type)                                       │
│  remote_events (uid, call_sn ── 含对端uid)                           │
└──────────────────────────────────────────────────────────────────────┘

6. identity 设计表与现有表的字段映射

6.1 person_identity_links（身份线索关联表）— 待建

clue_type	设计文档定义	数据来源表	来源字段	数据量级
JOYHUB_ID	JOYHUB用户ID	`users.id`	id	-
EMAIL	邮箱	`users.email` / `evaluation_order.email` / `lingxing_order.buyer_email` / `edm_contact_user.email` / `customer_platform_info`(type=2)	email	-
PHONE	电话	`users.contact_information` / `users.mobile` / `evaluation_order.phone` / `lingxing_order.phone` / `customer_platform_info`(type=1)	phone	-
DEVICE	设备号	`users.deviceId` / `user_login_last.deviceId` / `user_device_token_log.device_id`	deviceId	252万条日志
ORDER_NAME_ADDRESS	订单姓名+地址	`lingxing_order.buyer_name` + `lingxing_order.address` / `customer_address.recipient_name` + `customer_address.detail`	name+address	5631条地址
SOCIAL_ACCOUNT	社交媒体（扩展）	`evaluation_order.twitter` / `evaluation_order.facebook` / `customer_platform_info`(type=5,6)	twitter/facebook	-
PAYMENT_ACCOUNT	收款账号（扩展）	`customer_payment_account.account_number` / `customer.erp_pay_account`	account	10万条

6.2 device_records（设备变化记录）— 待建

设计字段	数据来源表	来源字段
`joyhub_id`	`users.id`	id
`device_id`	`users.deviceId` / `user_login_last.deviceId` / `user_device_token_log.device_id`	deviceId
`device_model`	`user_login_last.deviceModel`	deviceModel
`os_version`	`user_login_last.device` / `user_login_last.sysType`	device/sysType
`app_version`	`user_login_last.appVersion` / `users.appVersion`	appVersion
`change_type`	`user_device_token_log.type`	0=NEW, 1=UPDATE

6.3 contact_context_snapshots（上下文快照）— 待建

设计字段	数据来源子系统	来源表
`identity_snapshot`	identity	person_profiles + person_identity_links
`transaction_snapshot`	planning	lingxing_order, lingxing_order_item
`service_snapshot`	support	order_refund, evaluation_order, phone_records
`risk_snapshot`	risk	customer.is_black, customer.high_risk, banned_device_id, blacklist_users_aggregate
`device_snapshot`	identity(M4)	device_records, user_login_last
`outreach_snapshot`	outreach	（待确认）

21 KiB Raw Permalink Blame History Unescape Escape

identity 子系统 — doris数据库相关表与关联关系（供参考）

1. 数据库全景

2. 核心发现：已存在的 OneID 归并表

app_tag_data.user_oneid — 用户唯一标识归并表（6 字段，已有数据）

3. 核心表状态

4. 已存在的数据源表

4.1 用户与身份核心表

ods_app_base_data.users — 用户主表（36 字段）

ods_app_base_data.user_login_last — 最近登录信息（21 字段）

ods_app_base_data.user_device_token_log — 设备令牌变更日志（7 字段，252万行）

ods_app_base_data.user_contact_information_history — 联系方式变更历史（11 字段，20万行）

ods_app_base_data.banned_device_id — 设备封禁表（3 字段，6831行）

ods_app_base_data.blacklist_users_aggregate — 用户黑名单汇总（8 字段）

4.2 OA 售后系统 — 客户身份数据

ods_oa_oaaftersales.customer — 客户主表（22 字段，23万行）

ods_oa_oaaftersales.customer_platform_info — 客户平台信息（8 字段，26万行）

ods_oa_oaaftersales.customer_address — 客户地址（18 字段，5631行）

ods_oa_oaaftersales.customer_payment_account — 客户付款账号（12 字段，10万行）

ods_oa_oaaftersales.customer_bind — 客户绑定关系（6 字段，4980行）

ods_oa_oaaftersales.customer_bind_log — 客户绑定日志（6 字段，1.2万行）

ods_oa_oaaftersales.evaluation_order — 测评订单（55+ 字段，45万行）

ods_oa_oaaftersales.lingxing_order — 亚马逊订单（30+ 字段，2142万行）

ods_oa_oaaftersales.phone_records — 电话记录（30+ 字段，8万行）

4.3 社区行为表

ods_app_app_community.posts — 帖子表（35 字段）

ods_app_app_community.post_likes — 点赞表（5 字段）

ods_app_app_community.comments — 评论表（14 字段）

ods_app_app_community.follows — 关注关系表（7 字段）

ods_app_base_data.friends — 好友关系表（6 字段）

4.4 事件行为表

ods_app_jh_data.events — APP事件表（18 字段）

ods_app_jh_data.remote_events — 远程连接事件表（15 字段）

5. 表关联关系图

6. identity 设计表与现有表的字段映射

6.1 person_identity_links（身份线索关联表）— 待建

6.2 device_records（设备变化记录）— 待建

6.3 contact_context_snapshots（上下文快照）— 待建

21 KiB

Raw Permalink Blame History

`app_tag_data.user_oneid` — 用户唯一标识归并表（6 字段，已有数据）

`ods_app_base_data.users` — 用户主表（36 字段）

`ods_app_base_data.user_login_last` — 最近登录信息（21 字段）

`ods_app_base_data.user_device_token_log` — 设备令牌变更日志（7 字段，252万行）

`ods_app_base_data.user_contact_information_history` — 联系方式变更历史（11 字段，20万行）

`ods_app_base_data.banned_device_id` — 设备封禁表（3 字段，6831行）

`ods_app_base_data.blacklist_users_aggregate` — 用户黑名单汇总（8 字段）

`ods_oa_oaaftersales.customer` — 客户主表（22 字段，23万行）

`ods_oa_oaaftersales.customer_platform_info` — 客户平台信息（8 字段，26万行）

`ods_oa_oaaftersales.customer_address` — 客户地址（18 字段，5631行）

`ods_oa_oaaftersales.customer_payment_account` — 客户付款账号（12 字段，10万行）

`ods_oa_oaaftersales.customer_bind` — 客户绑定关系（6 字段，4980行）

`ods_oa_oaaftersales.customer_bind_log` — 客户绑定日志（6 字段，1.2万行）

`ods_oa_oaaftersales.evaluation_order` — 测评订单（55+ 字段，45万行）

`ods_oa_oaaftersales.lingxing_order` — 亚马逊订单（30+ 字段，2142万行）

`ods_oa_oaaftersales.phone_records` — 电话记录（30+ 字段，8万行）

`ods_app_app_community.posts` — 帖子表（35 字段）

`ods_app_app_community.post_likes` — 点赞表（5 字段）

`ods_app_app_community.comments` — 评论表（14 字段）

`ods_app_app_community.follows` — 关注关系表（7 字段）

`ods_app_base_data.friends` — 好友关系表（6 字段）

`ods_app_jh_data.events` — APP事件表（18 字段）

`ods_app_jh_data.remote_events` — 远程连接事件表（15 字段）