# 数据库设计 | 关系 | 关键约束与职责 | |---|---| | users | UUID 主键,规范化用户名唯一,密码保存 Argon2id PHC,记录创建时间 | | devices | UUID 主键,用户外键,用户内公钥唯一,记录平台、首次和最近活动时间、撤销时间 | | sessions | 高熵令牌的 SHA-256 摘要为主键,关联设备,包含到期时间 | | contact_relationships、contact_blocks、contact_preferences | 关系按账号对去重,拉黑有方向,备注、分组、免打扰和置顶按拥有者授权 | | device_contact_seen | 每个接收设备和发送设备之间的已查看游标,只向前更新 | | login_history | 每个账号最近 50 次成功登录的设备名称、平台和时间 | | conversations、memberships | 会话与成员关系,记录角色和生效世代 | | devices、device_key_packages | 公开设备凭据及签名的一次性密钥包,事务领取,撤销后停止发放 | | device_envelopes | 二进制协议封包、投递游标和目标设备,按发送设备、接收设备和客户端消息 ID 幂等 | | device_attachments | 预览版 8 MiB 附件密文与设备访问范围,按附件 ID 幂等,跟随消息保留期 | | group_attachments | 按群和附件 ID 唯一。记录发送设备、会话和附件密文,群消息可引用同一会话下该设备上传的附件 | | attachments、backups | 对象存储标识、密文尺寸、配额和版本,密钥由端侧传递 | | calls、call_participants | 通话状态、参与设备和时间,不存媒体 | | posts、post_audiences、reactions | 私人动态正文为密文,受众变更触发重新分发或换钥 | | admin_audit | 管理员、行为、目标标识、时间和结果 | 迁移 001 创建身份相关表。迁移 002 添加联系人关系、黑名单和备注。迁移 003 添加设备封包队列。投递事务按固定顺序锁定账号和设备,使同一目标设备的游标按提交顺序可见。设备撤销和会话清除在同一个事务内处理。后台作业清理超出保留期的封包。 迁移 009 创建群附件表并为现有群消息追加可空附件引用。下载在同一次查询中验证附件已发布、设备属于原会话名单、当前群成员资格和设备撤销状态。