# 数据库设计 | 关系 | 关键约束与职责 | |---|---| | users | UUID 主键,规范化用户名唯一,密码保存 Argon2id PHC,记录创建时间 | | devices | UUID 主键,用户外键,用户内公钥唯一,记录平台、首次和最近活动时间、撤销时间 | | sessions | 高熵令牌的 SHA-256 摘要为主键,关联设备,包含到期时间 | | contact_relationships、contact_blocks、contact_preferences | 关系按账号对去重,拉黑有方向,私有备注按拥有者授权 | | conversations、memberships | 会话与成员关系,记录角色和生效世代 | | device_credentials、key_packages | 公开凭据及一次性密钥包,事务领取,撤销后停止发放 | | envelopes、deliveries | 二进制协议密文、投递游标和目标设备,按客户端消息 ID 幂等 | | attachments、backups | 对象存储标识、密文尺寸、配额和版本,密钥由端侧传递 | | calls、call_participants | 通话状态、参与设备和时间,不存媒体 | | posts、post_audiences、reactions | 私人动态正文为密文,受众变更触发重新分发或换钥 | | admin_audit | 管理员、行为、目标标识、时间和结果 | 迁移 001 创建身份相关表。迁移 002 添加联系人关系、黑名单和备注。设备撤销和会话清除在同一个事务内处理。阶段二以事务分配单调投递游标,连接恢复后从持久层补拉。消息保留和附件清理分别由后台作业处理,下载授权按目标设备和对象关联重新检查。