Files
XHChat/docs/database.md
T

1.6 KiB

数据库设计

关系 关键约束与职责
users UUID 主键,规范化用户名唯一,密码保存 Argon2id PHC,记录创建时间
devices UUID 主键,用户外键,用户内公钥唯一,记录平台、首次和最近活动时间、撤销时间
sessions 高熵令牌的 SHA-256 摘要为主键,关联设备,包含到期时间
contact_relationships、contact_blocks、contact_preferences 关系按账号对去重,拉黑有方向,私有备注按拥有者授权
conversations、memberships 会话与成员关系,记录角色和生效世代
device_credentials、key_packages 公开凭据及一次性密钥包,事务领取,撤销后停止发放
device_envelopes 二进制协议封包、投递游标和目标设备,按发送设备、接收设备和客户端消息 ID 幂等
attachments、backups 对象存储标识、密文尺寸、配额和版本,密钥由端侧传递
calls、call_participants 通话状态、参与设备和时间,不存媒体
posts、post_audiences、reactions 私人动态正文为密文,受众变更触发重新分发或换钥
admin_audit 管理员、行为、目标标识、时间和结果

迁移 001 创建身份相关表。迁移 002 添加联系人关系、黑名单和备注。迁移 003 添加设备封包队列。投递事务按固定顺序锁定账号和设备,使同一目标设备的游标按提交顺序可见。设备撤销和会话清除在同一个事务内处理。后台作业清理超出保留期的封包。后续的附件下载将按目标设备和对象关联重新检查授权。