feat: add group chat functionality with message handling and UI integration

- Introduced GroupChatMessage model in Prisma schema for storing chat messages.
- Created GroupChat module, controller, service, and gateway for handling chat logic and WebSocket connections.
- Implemented GroupChat component in frontend for real-time messaging, file attachments, and message display.
- Updated ProjectManagement component to include GroupChat view mode and navigation.
- Enhanced Sidebar with Group Chat menu option for easy access.

Author: ryanauf6661

backend/prisma/schema.prisma

@@ -187,6 +187,21 @@ model Invite {
   updatedAt   DateTime?
 }
 
+model GroupChatMessage {
+  id          String   @id @default(cuid())
+  workspaceId String
+  memberId    String
+  memberName  String
+  memberPhoto String?
+  content     String   @db.Text
+  attachments Json?
+  replyTo     Json?
+  createdAt   DateTime @default(now())
+
+  @@index([workspaceId, createdAt])
+  @@map("group_chat_message")
+}
+
 enum Role {
   USER
   ADMIN

backend/src/app.module.ts

@@ -16,6 +16,7 @@ import { SharedModule } from "./common/shared.module";
 import { UploadModule } from "./upload/upload.module";
 import { ProjectManagementModule } from "./project-management/project-management.module";
 import { EmailModule } from "./email/email.module";
+import { GroupChatModule } from "./group-chat/group-chat.module";
 import { APP_GUARD } from "@nestjs/core";
 
 @Module({
@@ -35,6 +36,7 @@ import { APP_GUARD } from "@nestjs/core";
     UploadModule,
     ProjectManagementModule,
     EmailModule,
+    GroupChatModule,
   ],
   controllers: [AppController, AskController],
   providers: [

backend/src/group-chat/group-chat.controller.ts

@@ -0,0 +1,22 @@
+import {
+  Controller,
+  Get,
+  Query,
+  DefaultValuePipe,
+  ParseIntPipe,
+} from "@nestjs/common";
+import { GroupChatService } from "./group-chat.service";
+
+@Controller("api/group-chat")
+export class GroupChatController {
+  constructor(private readonly chatService: GroupChatService) {}
+
+  /** GET /api/group-chat/messages?workspaceId=xxx&limit=60 */
+  @Get("messages")
+  getMessages(
+    @Query("workspaceId") workspaceId: string,
+    @Query("limit", new DefaultValuePipe(60), ParseIntPipe) limit: number,
+  ) {
+    return this.chatService.getMessages(workspaceId, Math.min(limit, 200));
+  }
+}

backend/src/group-chat/group-chat.gateway.ts

@@ -0,0 +1,107 @@
+import {
+  WebSocketGateway,
+  WebSocketServer,
+  SubscribeMessage,
+  MessageBody,
+  ConnectedSocket,
+  OnGatewayInit,
+  OnGatewayConnection,
+  OnGatewayDisconnect,
+} from "@nestjs/websockets";
+import { Server, Socket } from "socket.io";
+import { Logger } from "@nestjs/common";
+import { GroupChatService } from "./group-chat.service";
+
+@WebSocketGateway({ cors: { origin: "*" } })
+export class GroupChatGateway
+  implements OnGatewayInit, OnGatewayConnection, OnGatewayDisconnect
+{
+  @WebSocketServer()
+  server: Server;
+
+  private readonly logger = new Logger(GroupChatGateway.name);
+
+  constructor(private readonly chatService: GroupChatService) {}
+
+  afterInit() {
+    this.logger.log("GroupChatGateway initialised");
+  }
+
+  handleConnection(client: Socket) {
+    this.logger.debug(`Client connected: ${client.id}`);
+  }
+
+  handleDisconnect(client: Socket) {
+    this.logger.debug(`Client disconnected: ${client.id}`);
+  }
+
+  /** Client joins a workspace room */
+  @SubscribeMessage("group-chat:join")
+  handleJoin(
+    @MessageBody() data: { workspaceId: string },
+    @ConnectedSocket() client: Socket,
+  ) {
+    if (!data?.workspaceId) return;
+    client.join(`ws:${data.workspaceId}`);
+    this.logger.debug(`${client.id} joined room ws:${data.workspaceId}`);
+  }
+
+  /** Client leaves a workspace room */
+  @SubscribeMessage("group-chat:leave")
+  handleLeave(
+    @MessageBody() data: { workspaceId: string },
+    @ConnectedSocket() client: Socket,
+  ) {
+    if (!data?.workspaceId) return;
+    client.leave(`ws:${data.workspaceId}`);
+  }
+
+  /** Client sends a message (content and/or attachments) */
+  @SubscribeMessage("group-chat:send")
+  async handleSend(
+    @MessageBody()
+    data: {
+      workspaceId: string;
+      memberId: string;
+      memberName: string;
+      memberPhoto?: string;
+      content: string;
+      attachments?: Array<{
+        url: string;
+        name: string;
+        type: string;
+        size: number;
+      }>;
+      replyTo?: {
+        id: string;
+        memberName: string;
+        content: string;
+        attachments?: Array<{
+          url: string;
+          name: string;
+          type: string;
+          size: number;
+        }> | null;
+      };
+    },
+    @ConnectedSocket() client: Socket,
+  ) {
+    const hasContent = data?.content?.trim();
+    const hasAttachments =
+      Array.isArray(data?.attachments) && data.attachments.length > 0;
+    if (!data?.workspaceId || (!hasContent && !hasAttachments)) return;
+
+    const saved = await this.chatService.saveMessage({
+      workspaceId: data.workspaceId,
+      memberId: data.memberId,
+      memberName: data.memberName,
+      memberPhoto: data.memberPhoto ?? null,
+      content: data.content?.trim() ?? "",
+      attachments: hasAttachments ? data.attachments : undefined,
+      replyTo: data.replyTo ?? undefined,
+    });
+
+    // broadcast to everyone in the room (including sender)
+    this.server.to(`ws:${data.workspaceId}`).emit("group-chat:message", saved);
+  }
+}

backend/src/group-chat/group-chat.module.ts

@@ -0,0 +1,18 @@
+import { Module } from "@nestjs/common";
+import { GroupChatController } from "./group-chat.controller";
+import { GroupChatService } from "./group-chat.service";
+import { GroupChatGateway } from "./group-chat.gateway";
+import { PrismaClient } from "@prisma/client";
+
+@Module({
+  controllers: [GroupChatController],
+  providers: [
+    GroupChatService,
+    GroupChatGateway,
+    {
+      provide: PrismaClient,
+      useValue: new PrismaClient(),
+    },
+  ],
+})
+export class GroupChatModule {}

backend/src/group-chat/group-chat.service.ts

@@ -0,0 +1,29 @@
+import { Injectable } from "@nestjs/common";
+import { PrismaClient } from "@prisma/client";
+
+@Injectable()
+export class GroupChatService {
+  constructor(private readonly prisma: PrismaClient) {}
+
+  async getMessages(workspaceId: string, limit = 60) {
+    const rows = await this.prisma.groupChatMessage.findMany({
+      where: { workspaceId },
+      orderBy: { createdAt: "desc" },
+      take: limit,
+    });
+    // return in chronological order for the client
+    return rows.reverse();
+  }
+
+  async saveMessage(data: {
+    workspaceId: string;
+    memberId: string;
+    memberName: string;
+    memberPhoto?: string | null;
+    content: string;
+    attachments?: any;
+    replyTo?: any;
+  }) {
+    return this.prisma.groupChatMessage.create({ data });
+  }
+}