Files
XHChat/docs/database.md
T

2.0 KiB

数据库设计

关系 关键约束与职责
users UUID 主键,规范化用户名唯一,密码保存 Argon2id PHC,记录创建时间
devices UUID 主键,用户外键,用户内公钥唯一,记录平台、首次和最近活动时间、撤销时间
sessions 高熵令牌的 SHA-256 摘要为主键,关联设备,包含到期时间
contact_relationships、contact_blocks、contact_preferences 关系按账号对去重,拉黑有方向,私有备注按拥有者授权
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 创建群附件表并为现有群消息追加可空附件引用。下载在同一次查询中验证附件已发布、设备属于原会话名单、当前群成员资格和设备撤销状态。