wanglei/EchoChat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(im): Task 0 - IM 模型定义 + 数据库表迁移 + 常量定义

Browse Source 
- 新增 3 个 GORM 模型：Conversation / ConversationMember / Message
- 新增 IM 常量：会话类型、消息类型、消息状态、撤回时限
- main.go 添加 IM 表 AutoMigrate
- init.sql 追加 IM 模块 DDL（含索引和全文搜索 GIN 索引）

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-03-03 10:41:42 +08:00
parent 1f390fce56
commit 6ab04fb902
6 changed files with 227 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

96
deploy/docker/postgres/init.sql
View File

@@ -1,6 +1,6 @@
-- ============================================================
-- EchoChat 数据库初始化脚本
-- 包含模块：auth（用户认证）、contact（联系人）
-- 包含模块：auth（用户认证）、contact（联系人）、im（即时通讯）
-- ============================================================
-- ============================================================
@@ -143,3 +143,97 @@ COMMENT ON COLUMN contact_groups.sort_order IS '排序权重，数值越小越
COMMENT ON COLUMN contact_groups.created_at IS '创建时间';
CREATE INDEX idx_contact_groups_user ON contact_groups (user_id);
-- ============================================================
-- im_conversations: 会话表
-- 存储单聊（type=1）和群聊（type=2，预留）会话
-- 冗余 last_msg_* 字段以避免会话列表查询时 JOIN 消息表
-- ============================================================
CREATE TABLE im_conversations (
id BIGSERIAL PRIMARY KEY,
type SMALLINT NOT NULL DEFAULT 1,
creator_id BIGINT NOT NULL,
last_message_id BIGINT DEFAULT NULL,
last_msg_content TEXT DEFAULT '',
last_msg_time TIMESTAMP(0) DEFAULT NULL,
last_msg_sender_id BIGINT DEFAULT NULL,
created_at TIMESTAMP(0) NOT NULL DEFAULT NOW(),
updated_at TIMESTAMP(0) NOT NULL DEFAULT NOW()
);
COMMENT ON TABLE im_conversations IS '会话表，支持单聊（type=1）和群聊（type=2，预留）';
COMMENT ON COLUMN im_conversations.id IS '会话唯一标识，自增主键';
COMMENT ON COLUMN im_conversations.type IS '会话类型：1=单聊，2=群聊（预留）';
COMMENT ON COLUMN im_conversations.creator_id IS '会话创建者用户 ID';
COMMENT ON COLUMN im_conversations.last_message_id IS '最后一条消息 ID，用于快速定位';
COMMENT ON COLUMN im_conversations.last_msg_content IS '最后消息预览文本，用于会话列表展示';
COMMENT ON COLUMN im_conversations.last_msg_time IS '最后消息时间，用于会话列表排序';
COMMENT ON COLUMN im_conversations.last_msg_sender_id IS '最后消息发送者 ID';
COMMENT ON COLUMN im_conversations.created_at IS '会话创建时间';
COMMENT ON COLUMN im_conversations.updated_at IS '会话信息更新时间';
CREATE INDEX idx_im_conversations_updated ON im_conversations (updated_at DESC);
-- ============================================================
-- im_conversation_members: 会话成员表
-- 每个会话的每个成员一条记录，存储个人视图（置顶/未读/软删除）
-- 单聊两条记录，群聊 N 条记录
-- ============================================================
CREATE TABLE im_conversation_members (
id BIGSERIAL PRIMARY KEY,
conversation_id BIGINT NOT NULL REFERENCES im_conversations(id),
user_id BIGINT NOT NULL,
is_pinned BOOLEAN DEFAULT FALSE,
is_deleted BOOLEAN DEFAULT FALSE,
unread_count INT DEFAULT 0,
last_read_msg_id BIGINT DEFAULT 0,
created_at TIMESTAMP(0) NOT NULL DEFAULT NOW(),
updated_at TIMESTAMP(0) NOT NULL DEFAULT NOW(),
UNIQUE (conversation_id, user_id)
);
COMMENT ON TABLE im_conversation_members IS '会话成员表，存储每个成员对会话的个人视图';
COMMENT ON COLUMN im_conversation_members.id IS '记录唯一标识';
COMMENT ON COLUMN im_conversation_members.conversation_id IS '所属会话 ID';
COMMENT ON COLUMN im_conversation_members.user_id IS '成员用户 ID';
COMMENT ON COLUMN im_conversation_members.is_pinned IS '是否置顶该会话';
COMMENT ON COLUMN im_conversation_members.is_deleted IS '是否删除该会话（软删除，不影响对方视图）';
COMMENT ON COLUMN im_conversation_members.unread_count IS '该成员在此会话中的未读消息数';
COMMENT ON COLUMN im_conversation_members.last_read_msg_id IS '该成员最后已读消息 ID';
COMMENT ON COLUMN im_conversation_members.created_at IS '加入会话时间';
COMMENT ON COLUMN im_conversation_members.updated_at IS '最后更新时间';
CREATE INDEX idx_im_conv_members_user ON im_conversation_members (user_id, is_deleted);
CREATE INDEX idx_im_conv_members_conv ON im_conversation_members (conversation_id);
-- ============================================================
-- im_messages: 消息表
-- 存储所有聊天消息，通过 conversation_id 关联会话
-- 游标分页查询核心索引：(conversation_id, created_at DESC)
-- ============================================================
CREATE TABLE im_messages (
id BIGSERIAL PRIMARY KEY,
conversation_id BIGINT NOT NULL REFERENCES im_conversations(id),
sender_id BIGINT NOT NULL,
type SMALLINT NOT NULL DEFAULT 1,
content TEXT NOT NULL,
extra JSONB DEFAULT NULL,
status SMALLINT NOT NULL DEFAULT 1,
client_msg_id VARCHAR(64) DEFAULT '',
created_at TIMESTAMP(0) NOT NULL DEFAULT NOW()
);
COMMENT ON TABLE im_messages IS '聊天消息表，存储所有消息内容';
COMMENT ON COLUMN im_messages.id IS '消息唯一标识，自增主键';
COMMENT ON COLUMN im_messages.conversation_id IS '所属会话 ID';
COMMENT ON COLUMN im_messages.sender_id IS '发送者用户 ID';
COMMENT ON COLUMN im_messages.type IS '消息类型：1=文本，2=图片（预留），3=语音（预留），4=视频（预留），5=文件（预留）';
COMMENT ON COLUMN im_messages.content IS '消息内容（文本消息为纯文本，其他类型为 URL 或描述）';
COMMENT ON COLUMN im_messages.extra IS '扩展数据（JSON 格式），预留图片尺寸、语音时长等元信息';
COMMENT ON COLUMN im_messages.status IS '消息状态：1=正常，2=已撤回，3=已删除';
COMMENT ON COLUMN im_messages.client_msg_id IS '客户端消息唯一 ID，用于幂等去重防止网络重试重复发送';
COMMENT ON COLUMN im_messages.created_at IS '消息发送时间';
CREATE INDEX idx_im_messages_conv_time ON im_messages (conversation_id, created_at DESC);
CREATE INDEX idx_im_messages_conv_id ON im_messages (conversation_id, id DESC);
CREATE INDEX idx_im_messages_content_search ON im_messages USING gin(to_tsvector('simple', content));