teamgram-database-schema（teamgram 数据库架构）

数据库 Schema（43 张表）与核心关系

概述

数据库位于 teamgramd/deploy/sql/，基础 schema 在 1_teamgram.sql（38 表），迁移补齐到 43 表。

所有服务共用同一个 MySQL 数据库 teamgram，字符集 utf8mb4。

43 张表完整列表

核心 ER 关系

users (user_id)
  |\
  | \-- auth_users (auth_key_id -> user_id)      # 登录设备/授权关系
  | \-- devices (auth_key_id, user_id)           # push token / device
  | \-- user_presences (user_id)                 # last seen
  | \-- user_profile_photos (user_id -> photo_id)
  | \-- user_settings / user_privacies / user_notify_settings
  |
  \-- dialogs (user_id, peer_type, peer_id)      # 会话列表
        |
        \-- messages (user_id, peer_type, peer_id, dialog_id1/2, dialog_message_id)
              |
              \-- documents/photos/encrypted_files (+ photo_sizes/video_sizes)

chats (chat_id)
  \-- chat_participants (chat_id, user_id)
  \-- chat_invites / chat_invite_participants

关键表结构说明

users 表

• 核心用户信息表
• user_id 为主键（Snowflake ID）
• 包含 phone、first_name、last_name、username 等字段
• deleted 字段标记软删除

messages 表

• 消息存储核心表
• 按 user_id + peer 维度存储（inbox/outbox 双写）
• dialog_id1/dialog_id2 用于双向对话定位
• dialog_message_id 为对话内消息序号（递增）
• message_type 区分文本/媒体/服务消息等

dialogs 表

• 每个用户与每个对等方（私聊/群聊）一行
• peer_type: 1=user, 2=chat, 3=channel
• 包含 unread_count、read_inbox_max_id、read_outbox_max_id
• pinned 字段控制置顶排序

auth_keys / auth_users 表

• auth_keys 存储 MTProto 授权密钥（256字节 auth_key）
• auth_users 维护 auth_key_id → user_id 的绑定
• 一个用户可以有多个 auth_key（多设备登录）
• auth_key_id 是 auth_key 的 SHA1 后 8 字节

chat_participants 表

• chat_id + user_id 复合主键
• participant_type 区分普通成员/管理员/创建者
• inviter_user_id 记录邀请人
• joined_at 记录加入时间

SQL 文件路径

• 基础 schema：teamgramd/deploy/sql/1_teamgram.sql
• 迁移脚本：teamgramd/deploy/sql/ 下的后续编号文件

Source Code References

• Repository: https://github.com/teamgram/teamgram-server (Apache-2.0)