feat(guild-model): add practical indexes for channel/dm/member queries

Fabric.Backend.Guild/src/entities/channel.entity.ts

@@ -1,10 +1,12 @@
 import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
 
 @Entity('channels')
+@Index(['guildId', 'createdAt'])
 export class Channel {
   @PrimaryGeneratedColumn('uuid')
   id!: string;
 
+  @Index()
   @Column({ type: 'char', length: 36 })
   guildId!: string;
 
@@ -22,5 +24,6 @@ export class Channel {
   lastSeq!: number;
 
   @CreateDateColumn()
+  @Index()
   createdAt!: Date;
 }

Fabric.Backend.Guild/src/entities/dm-conversation.entity.ts

@@ -1,4 +1,4 @@
-import { Column, CreateDateColumn, Entity, PrimaryGeneratedColumn } from 'typeorm';
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
 
 @Entity('dm_conversations')
 export class DmConversation {
@@ -12,5 +12,6 @@ export class DmConversation {
   topic!: string | null;
 
   @CreateDateColumn()
+  @Index()
   createdAt!: Date;
 }

Fabric.Backend.Guild/src/entities/dm-participant.entity.ts

@@ -1,13 +1,16 @@
-import { Column, CreateDateColumn, Entity, PrimaryGeneratedColumn } from 'typeorm';
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
 
 @Entity('dm_participants')
+@Index(['conversationId', 'userId'], { unique: true })
 export class DmParticipant {
   @PrimaryGeneratedColumn('uuid')
   id!: string;
 
+  @Index()
   @Column({ type: 'char', length: 36 })
   conversationId!: string;
 
+  @Index()
   @Column({ type: 'varchar', length: 64 })
   userId!: string;
 
@@ -15,5 +18,6 @@ export class DmParticipant {
   role!: 'member';
 
   @CreateDateColumn()
+  @Index()
   createdAt!: Date;
 }

Fabric.Backend.Guild/src/entities/guild-member.entity.ts

@@ -1,13 +1,17 @@
-import { Column, CreateDateColumn, Entity, PrimaryGeneratedColumn } from 'typeorm';
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
 
 @Entity('guild_members')
+@Index(['guildId', 'userId'], { unique: true })
+@Index(['guildId', 'status'])
 export class GuildMember {
   @PrimaryGeneratedColumn('uuid')
   id!: string;
 
+  @Index()
   @Column({ type: 'char', length: 36 })
   guildId!: string;
 
+  @Index()
   @Column({ type: 'varchar', length: 64 })
   userId!: string;
 
@@ -15,5 +19,6 @@ export class GuildMember {
   status!: 'active' | 'left' | 'blocked';
 
   @CreateDateColumn()
+  @Index()
   createdAt!: Date;
 }

Fabric.Backend.Guild/src/entities/message.entity.ts

@@ -3,6 +3,8 @@ import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from
 @Entity('messages')
 @Index(['channelId', 'seq'], { unique: true })
 @Index(['conversationId', 'seq'], { unique: true })
+@Index(['channelId', 'createdAt'])
+@Index(['conversationId', 'createdAt'])
 export class Message {
   @PrimaryGeneratedColumn('uuid')
   id!: string;
@@ -25,5 +27,6 @@ export class Message {
   content!: string;
 
   @CreateDateColumn()
+  @Index()
   createdAt!: Date;
 }

docs/TODO-backend-center-guild.md

@@ -41,7 +41,7 @@
 ### 2.1 领域模型
 - [x] Guild/Channel/DM 实体补全
 - [x] Member/Role 基础模型（即使 MVP 权限全开，也先留结构）
-- [ ] 索引设计（channel_id + seq, created_at 等）
+- [x] 索引设计（channel_id + seq, created_at 等）
 
 ### 2.2 消息主链路
 - [ ] 发送消息（content/reply/mentions/attachments 元数据）