不能自关注或自屏蔽	数据库	user_follows / user_blocks CHECK
任一方向屏蔽禁止新增关注	数据库	user_follows_not_blocked
计数非负	数据库	user_social_counters CHECK

Group

聚合根 groups + group_members + group_bans + group_invites + group_join_requests + group_audit_events

群生命周期与权限目录。

领域对象

社交类型与常量 contexts/social/src/domain/social.types.ts

不变量与保证方

至多一个 owner	数据库	group_members_one_owner
建群与转让结束后恰好一个 owner 且匹配 owner_id	SQL	ADR-0235：后续建群 / 转让 batch 契约
邀请码长度与字母表有效、使用不超限	数据库	group_invites CHECK

Channel

聚合根 channels + channel_members

消息正文在 DO，目录、成员与游标在此。

领域对象

社交类型与常量 contexts/social/src/domain/social.types.ts

不变量与保证方

同用户对至多一个私信	数据库	channels_one_dm_per_pair
频道 kind 与 group_id / dm_key 一致	数据库	channels CHECK
每群至多一个默认频道	数据库	channels_one_default_per_group

Activity

聚合根 social_notifications + social_notification_kinds

活动通知与可增长种类目录。

领域对象

社交类型与常量 contexts/social/src/domain/social.types.ts

不变量与保证方

通知种类必须登记

数据库

social_notifications.kind FK

Report

聚合根 content_reports

内容举报治理队列。

领域对象

社交类型与常量 contexts/social/src/domain/social.types.ts

不变量与保证方

target 列与 kind 一致

数据库

content_reports CHECK

保证方：数据库约束 / 索引 / 触发器　SQL 仓储里的条件写 / batch　领域代码 domain 层规则　外部链上等外部权威

写路径矩阵哪个仓储方法写哪几张表

操作	原子性	channel_members	channels	content_reports	group_audit_events	group_bans	group_invites	group_join_requests	group_members	groups	social_notification_kinds	social_notifications	user_blocks	user_follows	user_social_counters
0001 schema 与种类种子 apps/server/migrations/social/0001_social_foundation.sql 本票无运行时仓储或业务写接口，其他表由后续用例实现。	batch										●

跨库 / 链上引用都没有外键，靠应用层维持

本库字段	对应	说明
`channel_members.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`channels.created_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`channels.last_sender_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`content_reports.reporter_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`content_reports.target_user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`content_reports.resolved_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_audit_events.actor_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_audit_events.target_user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_bans.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_bans.banned_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_invites.created_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_join_requests.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_join_requests.decided_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_members.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`group_members.invited_by`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`groups.owner_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`social_notifications.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`social_notifications.actor_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`user_blocks.blocker_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`user_blocks.blocked_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`user_follows.follower_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`user_follows.followee_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`user_social_counters.user_id`	USER_DB users.user_id；经 users /server 门批量读	跨库无外键，不在 social 写用户 SQL。
`channels.channel_id`	SocialChannel DO 实例名	消息 seq / version 属 DO；D1 仅目录与摘要，写回实现后续交付。

保留与清理

表	规则
`channel_members`	解散群的成员行 30 天后清理；私信 hidden_at 只隐藏不删。清理 cron / 注销编排归后续票。
`channels`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`content_reports`	已处理后 1 年清理，open 保留。清理 cron / 注销编排归后续票。
`group_audit_events`	动作发生后 1 年清理。清理 cron / 注销编排归后续票。
`group_bans`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`group_invites`	过期或撤销后 7 天清理。清理 cron / 注销编排归后续票。
`group_join_requests`	已决 30 天后清理，pending 保留。清理 cron / 注销编排归后续票。
`group_members`	群解散 30 天后清理成员行。清理 cron / 注销编排归后续票。
`groups`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`social_notification_kinds`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`social_notifications`	创建后 90 天清理。清理 cron / 注销编排归后续票。
`user_blocks`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`user_follows`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。
`user_social_counters`	保持至显式业务移除；本票不自动清理。清理 cron / 注销编排归后续票。

敏感度未列出的字段视为「内部」

字段	级别	说明
`group_invites.invite_code`	机密	持码可申请或加入群，不写普通日志。
`content_reports.detail`	个人数据	只向授权治理人员开放。
`channels.last_message_preview`	个人数据	按频道访问权限读取。

全部字段1 个迁移叠加后的最终结构 · 由迁移自动提取

0003 绿色迁移号表示该字段由后续迁移 ALTER TABLE 加入。点表名展开。

channel_members频道成员8 字段 · 1 索引

每用户每频道的未读游标、通知、置顶与隐藏。加群补全部 public 频道；private 与 dm 按加入插行。

聚合 Channel · 主键 (channel_id, user_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKFKchannel_id	TEXT	PK · FK→channels.channel_id	频道 ID，同时是 SocialChannel DO 的确定性名字。	0001
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
joined_at	TEXT	NOT NULL	加入群或频道的时间，ISO TEXT。	0001
last_read_seq	INTEGER	NOT NULL · DEFAULT 0 · CHECK(last_read_seq >= 0)	已读分界，初始 0；未读 = channels.last_message_seq 减该值，由用例防止超前。	0001
last_read_at	TEXT		最近确认已读时间；从未确认时 NULL。	0001
notify	TEXT	NOT NULL · DEFAULT 'inherit' · CHECK(notify IN ('inherit','all','mentions','none'))	inherit 跟随群，或 all / mentions / none；默认 inherit。	0001
pinned_at	TEXT		本人置顶会话的时间；NULL 表示未置顶。	0001
hidden_at	TEXT		隐藏私信的时刻；NULL 表示未隐藏，不删除会话。	0001

索引 / 唯一约束

channel_members_by_user (user_id, hidden_at, pinned_at DESC)

channels频道目录16 字段 · 3 索引

私信和群频道的目录；消息正文不在 D1。last_message_* 为未来 DO append 后写回的摘要，不是同步时钟。

聚合 Channel · 主键 (channel_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKchannel_id	TEXT	PK	频道 ID，同时是 SocialChannel DO 的确定性名字。	0001
kind	TEXT	NOT NULL · CHECK(kind IN ('dm','group'))	dm 私信 / group 群频道，决定 group_id 和 dm_key 是否为空。	0001
FKgroup_id	TEXT	FK→groups.group_id	群频道所属群；dm 必须为 NULL。	0001
dm_key	TEXT	CHECK(dm_key IS NULL OR ( instr(dm_key, ':') > 1 AND substr(dm_key, 1, instr(dm_key, ':') - 1) < substr(dm_key, instr(dm_key, ':') + 1) AND instr(substr(dm_key, instr(dm_key, ':') + 1), ':') = 0))	dmKeyOf(a,b) 的规范键；群频道必须为 NULL。	0001
name	TEXT	CHECK(name IS NULL OR length(name) BETWEEN 1 AND 40)	群频道名；dm 为 NULL。	0001
topic	TEXT	CHECK(topic IS NULL OR length(topic) BETWEEN 1 AND 200)	可选频道说明；NULL 表示没有说明。	0001
position	INTEGER	NOT NULL · DEFAULT 0	群内频道显示顺序，默认 0。	0001
access	TEXT	NOT NULL · DEFAULT 'public' · CHECK(access IN ('public','private'))	群内 public / private；私信必须 private。	0001
is_default	INTEGER	NOT NULL · DEFAULT 0 · CHECK(is_default IN (0,1))	群的默认频道标记；同群至多一个，dm 必须为 0。	0001
created_by	TEXT	NOT NULL	创建者 user_id。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001
archived_at	TEXT		归档 / 解散时间；NULL 表示仍活动，不立即删除历史。	0001
last_message_seq	INTEGER	NOT NULL · DEFAULT 0 · CHECK(last_message_seq >= 0)	最后插入消息序号，初始 0；DO 写回，编辑不增加它。	0001
last_message_at	TEXT		最后消息时间；未有消息时 NULL。	0001
last_sender_id	TEXT		最后消息发送者真人 ID；未有消息时 NULL。	0001
last_message_preview	TEXT	CHECK(last_message_preview IS NULL OR length(last_message_preview) <= 120)	最多 120 字符的摘要；无消息时 NULL。	0001

表级 CHECK

(kind = 'group') = (group_id IS NOT NULL)

(kind = 'dm') = (dm_key IS NOT NULL)

(kind = 'group') = (name IS NOT NULL)

kind = 'group' OR (access = 'private' AND is_default = 0)

索引 / 唯一约束

channels_group_order (group_id, position)

UNIQUE channels_one_default_per_group (group_id) WHERE is_default = 1

UNIQUE channels_one_dm_per_pair (dm_key) WHERE dm_key IS NOT NULL

content_reports内容举报13 字段 · 1 索引

用户 / 群 / 消息的举报队列，状态与处置时间一致；已处理保留 1 年。

聚合 Report · 主键 (report_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKreport_id	TEXT	PK	举报 ULID。	0001
reporter_id	TEXT	NOT NULL	举报发起用户 ID。	0001
target_kind	TEXT	NOT NULL · CHECK(target_kind IN ('user','group','message'))	user / group / message，决定互斥的 target 列。	0001
target_user_id	TEXT		user 举报目标；其他类型必须 NULL。	0001
target_group_id	TEXT		group 举报目标；其他类型必须 NULL。	0001
target_channel_id	TEXT		message 举报所属频道；其他类型必须 NULL。	0001
target_message_seq	INTEGER	CHECK(target_message_seq IS NULL OR target_message_seq >= 1)	message 举报的消息插入序；其他类型必须 NULL。	0001
reason	TEXT	NOT NULL · CHECK(reason IN ('spam','harassment','scam','illegal','other'))	spam / harassment / scam / illegal / other，封闭集合。	0001
detail	TEXT	CHECK(detail IS NULL OR length(detail) BETWEEN 1 AND 500)	补充说明；NULL 表示未填写。	0001
status	TEXT	NOT NULL · DEFAULT 'open' · CHECK(status IN ('open','resolved','dismissed'))	open 等待处置，resolved 已处理，dismissed 已驳回。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001
resolved_at	TEXT		处置时刻；open 必须 NULL，已处置必须有值。	0001
resolved_by	TEXT		处置人 user_id，与 resolved_at 同时为空或有值。	0001

表级 CHECK

(target_kind = 'user' AND target_user_id IS NOT NULL AND target_group_id IS NULL AND target_channel_id IS NULL AND target_message_seq IS NULL) OR (target_kind = 'group' AND target_group_id IS NOT NULL AND target_user_id IS NULL AND target_channel_id IS NULL AND target_message_seq IS NULL) OR (target_kind = 'message' AND target_channel_id IS NOT NULL AND target_message_seq IS NOT NULL AND target_user_id IS NULL AND target_group_id IS NULL)

(status = 'open') = (resolved_at IS NULL)

(resolved_at IS NULL) = (resolved_by IS NULL)

索引 / 唯一约束

content_reports_queue (status, created_at)

group_audit_events治理审计9 字段 · 1 索引

记录踢人、封禁、改角色、删消息、置顶、归档与转让，保留 1 年。

聚合 Group · 主键 (group_id, seq) · 引入于 0001

字段	类型	约束	含义	迁移
PKFKgroup_id	TEXT	PK · FK→groups.group_id	所属群 ID；组内实体挂 groups 外键。	0001
PKseq	INTEGER	PK · CHECK(seq >= 1)	群内单调序号；同一 D1 写语句选 MAX(seq)+1，复合主键兜底。	0001
actor_id	TEXT	NOT NULL	执行治理动作的真人用户 ID。	0001
action	TEXT	NOT NULL · CHECK(action IN ('kick','ban','unban','role_change','delete_message','pin','unpin','archive_channel','archive_group','transfer_owner'))	封闭的治理动作种类，集合见 social domain。	0001
target_user_id	TEXT		动作涉及的用户；无则 NULL。	0001
channel_id	TEXT		频道 ID，同时是 SocialChannel DO 的确定性名字。	0001
message_seq	INTEGER	CHECK(message_seq IS NULL OR message_seq >= 1)	动作涉及消息的插入序；无则 NULL。	0001
detail	TEXT	CHECK(detail IS NULL OR length(detail) BETWEEN 1 AND 500)	可选审计说明，最多 500 字符，不查询 JSON。	0001
at	TEXT	NOT NULL	治理动作发生时刻，保留期限据此计算。	0001

索引 / 唯一约束

group_audit_events_expiry (at)

group_bans群封禁5 字段

拒绝再次加群的治理记录；踢人 / 封禁与审计由后续用例同 batch 处理。

聚合 Group · 主键 (group_id, user_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKFKgroup_id	TEXT	PK · FK→groups.group_id	所属群 ID；组内实体挂 groups 外键。	0001
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
banned_by	TEXT	NOT NULL	执行封禁的管理员 user_id。	0001
reason	TEXT	CHECK(reason IS NULL OR length(reason) BETWEEN 1 AND 200)	可选封禁理由，NULL 表示未填写。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001

group_invites群邀请8 字段 · 1 索引

10 位 Crockford base32 外部邀请码；消费需条件写同时检查有效期、撤销与次数上限。

聚合 Group · 主键 (invite_code) · 引入于 0001

字段	类型	约束	含义	迁移
PKinvite_code	TEXT	PK · CHECK(length(invite_code) = 10 AND invite_code NOT GLOB '[^0-9A-HJKMNP-TV-Z]')	10 位外部共享代码，不是业务对象 ULID。	0001
FKgroup_id	TEXT	FK→groups.group_id · NOT NULL	所属群 ID；组内实体挂 groups 外键。	0001
created_by	TEXT	NOT NULL	创建邀请的成员 user_id。	0001
expires_at	TEXT		过期时刻；NULL 表示无时间限制。	0001
max_uses	INTEGER	CHECK(max_uses IS NULL OR max_uses > 0)	最多使用次数；NULL 表示不限次数。	0001
use_count	INTEGER	NOT NULL · DEFAULT 0 · CHECK(use_count >= 0 AND (max_uses IS NULL OR use_count <= max_uses))	已消费次数，默认 0，不能超过 max_uses。	0001
revoked_at	TEXT		撤销时刻；NULL 表示未撤销。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001

索引 / 唯一约束

group_invites_group (group_id)

group_join_requests加群申请7 字段 · 1 索引

同群同用户一行；pending 尚未处理，已决申请 30 天后清理。

聚合 Group · 主键 (group_id, user_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKFKgroup_id	TEXT	PK · FK→groups.group_id	所属群 ID；组内实体挂 groups 外键。	0001
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
message	TEXT	CHECK(message IS NULL OR length(message) BETWEEN 1 AND 200)	申请者附言，可空。	0001
status	TEXT	NOT NULL · CHECK(status IN ('pending','approved','rejected'))	pending / approved / rejected，由审批用例条件更新。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001
decided_at	TEXT		审批时刻；pending 必须为 NULL，已决必须有值。	0001
decided_by	TEXT		审批管理员 ID；与 decided_at 同时为空或有值。	0001

表级 CHECK

(status = 'pending') = (decided_at IS NULL)

(decided_at IS NULL) = (decided_by IS NULL)

索引 / 唯一约束

group_join_requests_pending (group_id, created_at) WHERE status = 'pending'

group_members群成员7 字段 · 2 索引

群级权限、通知与置顶。群人数 5000 上限归 domain，用例负责公共频道成员补行。

聚合 Group · 主键 (group_id, user_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKFKgroup_id	TEXT	PK · FK→groups.group_id	所属群 ID；组内实体挂 groups 外键。	0001
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
role	TEXT	NOT NULL · CHECK(role IN ('owner','admin','member'))	owner / admin / member；转让时同 batch 先降旧主再升新主。	0001
joined_at	TEXT	NOT NULL	加入群或频道的时间，ISO TEXT。	0001
invited_by	TEXT		邀请者 user_id；自助加入为 NULL。	0001
notify	TEXT	NOT NULL · DEFAULT 'all' · CHECK(notify IN ('all','mentions','none'))	群级通知 all / mentions / none，默认 all。	0001
pinned_at	TEXT		本人置顶会话的时间；NULL 表示未置顶。	0001

索引 / 唯一约束

group_members_by_user (user_id, pinned_at DESC, joined_at DESC)

UNIQUE group_members_one_owner (group_id) WHERE role = 'owner'

groups群组14 字段 · 1 索引

群与成员、默认 #general 同 batch 创建。库只守至多一个 owner，恰好一个与 owner_id 一致由建群 / 转让用例负责。

聚合 Group · 主键 (group_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKgroup_id	TEXT	PK	所属群 ID；组内实体挂 groups 外键。	0001
name	TEXT	NOT NULL · CHECK(length(name) BETWEEN 1 AND 40)	对外群名，由管理员修改。	0001
description	TEXT	CHECK(description IS NULL OR length(description) BETWEEN 1 AND 300)	可选群说明，NULL 表示未填写。	0001
icon_kind	TEXT	NOT NULL · DEFAULT 'preset' · CHECK(icon_kind IN ('preset','upload'))	preset 预设 / upload R2 上传图标。	0001
icon_key	TEXT	NOT NULL · DEFAULT 'default' · CHECK(length(icon_key) BETWEEN 1 AND 256)	预设 id 或 R2 object key，默认 default。	0001
badge	TEXT	NOT NULL · DEFAULT 'none' · CHECK(badge IN ('none','verified','official'))	认证徽章，首版仅运维直写。	0001
visibility	TEXT	NOT NULL · CHECK(visibility IN ('public','private'))	public 可发现 / private 私密。	0001
join_policy	TEXT	NOT NULL · CHECK(join_policy IN ('open','approval','invite'))	open 直接加入 / approval 审批 / invite 邀请。	0001
channels_enabled	INTEGER	NOT NULL · DEFAULT 0 · CHECK(channels_enabled IN (0,1))	是否向 UI 展示频道列表；0 仍有默认频道。	0001
owner_id	TEXT	NOT NULL	唯一群主 user_id，与 owner 成员行一致由用例保证。	0001
member_count	INTEGER	NOT NULL · DEFAULT 0 · CHECK(member_count >= 0)	群成员数，加入 / 离开同 batch 更新，默认 0。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001
updated_at	TEXT	NOT NULL	服务端最近修改时间，ISO TEXT。	0001
archived_at	TEXT		归档 / 解散时间；NULL 表示仍活动，不立即删除历史。	0001

索引 / 唯一约束

groups_discovery (visibility, member_count DESC)

social_notification_kinds活动通知种类2 字段

可增长的参照表，新增种类用追加 INSERT 迁移；未登记种类被 FK 拒绝。

聚合 Activity · 主键 (kind) · 引入于 0001

字段	类型	约束	含义	迁移
PKkind	TEXT	PK	活动种类的稳定名称。	0001
description	TEXT	NOT NULL	供开发与运维读的种类说明。	0001

social_notifications活动通知9 字段 · 2 索引

用户活动收件箱，保留 90 天；与设备推送各自存储、各自生命周期。

聚合 Activity · 主键 (user_id, notification_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
PKnotification_id	TEXT	PK	通知 ULID，与 user_id 共同作为主键。	0001
FKkind	TEXT	FK→social_notification_kinds.kind · NOT NULL	参照 social_notification_kinds 的活动种类。	0001
actor_id	TEXT		触发活动的用户 ID；无真人触发者时 NULL。	0001
group_id	TEXT		活动关联群；无则 NULL，不设生命周期 FK。	0001
channel_id	TEXT		活动关联频道；无则 NULL，不设生命周期 FK。	0001
message_seq	INTEGER	CHECK(message_seq IS NULL OR message_seq >= 1)	活动关联消息序号；无则 NULL。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001
read_at	TEXT		用户已读时刻；NULL 表示未读。	0001

索引 / 唯一约束

social_notifications_by_user (user_id, created_at DESC)

social_notifications_expiry (created_at)

user_blocks屏蔽3 字段 · 1 索引

拒绝互动的有向关系。删除关注、扣计数和隐藏私信必须由后续屏蔽用例同 batch 完成；本表不会自动执行这些副作用。

聚合 SocialGraph · 主键 (blocker_id, blocked_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKblocker_id	TEXT	PK	屏蔽发起者；私信只对该用户写 hidden_at。	0001
PKblocked_id	TEXT	PK	被屏蔽用户。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001

表级 CHECK

blocker_id <> blocked_id

索引 / 唯一约束

user_blocks_blocked (blocked_id)

user_follows关注3 字段 · 2 索引 · 1 触发器

有向关系；任一方向屏蔽均不能新增关注。双方命名和注销预检经 users 门，后续用例同 batch 更新计数。

聚合 SocialGraph · 主键 (follower_id, followee_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKfollower_id	TEXT	PK	发起关注的用户 ID。	0001
PKfollowee_id	TEXT	PK	被关注的用户 ID。	0001
created_at	TEXT	NOT NULL	由服务端写入的创建时间，ISO TEXT。	0001

表级 CHECK

follower_id <> followee_id

索引 / 唯一约束

user_follows_followers_page (followee_id, created_at DESC, follower_id DESC)

user_follows_following_page (follower_id, created_at DESC, followee_id DESC)

触发器

CREATE TRIGGER user_follows_not_blocked BEFORE INSERT ON user_follows
WHEN EXISTS (
  SELECT 1 FROM user_blocks
  WHERE (blocker_id = NEW.follower_id AND blocked_id = NEW.followee_id)
     OR (blocker_id = NEW.followee_id AND blocked_id = NEW.follower_id)
)
BEGIN
  SELECT RAISE(ABORT, 'user_follows: blocked in either direction');
END

user_social_counters社交计数4 字段

关注和拥有群数量的派生读模型；后续用例同 batch ±1，cron 每日对账。

聚合 SocialGraph · 主键 (user_id) · 引入于 0001

字段	类型	约束	含义	迁移
PKuser_id	TEXT	PK	所属真人用户的稳定 ID；跨库引用 USER_DB，无外键。	0001
followers_count	INTEGER	NOT NULL · DEFAULT 0 · CHECK(followers_count >= 0)	当前粉丝数，默认 0；不允许负值。	0001
following_count	INTEGER	NOT NULL · DEFAULT 0 · CHECK(following_count >= 0)	当前关注数，默认 0；不允许负值。	0001
groups_owned_count	INTEGER	NOT NULL · DEFAULT 0 · CHECK(groups_owned_count >= 0)	当前拥有的群数，默认 0；不允许负值。	0001

由 pnpm schema-docs build social-db 生成 · 结构来源 apps/server/migrations/social · 语义来源 docs/data/social-db/annotations.json · 指纹 sha256:7cfce3ba5b762939

SOCIAL_DB

板块颜色贯穿全文

社交图

群组

会话目录

通知与治理

全库约定

业务流程跟着流程看表怎么变

＋ 建群契约（待用例）

⊘ 屏蔽契约（待用例）

↗ 通知契约（待用例）

设计要点

聚合每张表恰好属于一个聚合；kind=supporting 是辅助表

SocialGraph

Group

Channel

Activity

Report

写路径矩阵哪个仓储方法写哪几张表

跨库 / 链上引用都没有外键，靠应用层维持

保留与清理

敏感度未列出的字段视为「内部」

全部字段1 个迁移叠加后的最终结构 · 由迁移自动提取

关系图实线 = 数据库外键（乌鸦脚在「多」端）· 虚线 = 逻辑关联 / 流程 · 点表框跳到字段

＋建群契约（待用例）