How ikraamdaanis/discourse works
Main Components
A. Client-Side (Next.js Application):
• Authentication Layer (Clerk)
• Real-time Communication Layer (WebSocket)
• Feature Modules:
• Chat System
• Server Management
• Channel Management
• Voice/Video Call System (LiveKit)
• User Profile Management
B. Server-Side:
• WebSocket Server
• API Routes
• Controllers Layer
• Database Layer (MySQL/PlanetScale)
Key Relationships to Highlight
a) Client-Server Communication:
• REST API calls
• WebSocket connections
• Real-time event handling
b) Data Flow:
• Authentication flow
• Message handling
• Server/Channel management
• Media handling (voice/video)
Specific Implementation Details
Client Layer:
┌─────────────────────────────────────────────┐
• UI Components (React/Next.js) │
• Navigation │
• Chat Features │
• Server Management │
• Profile Management │
• ┘
• ↕️
Middleware Layer:
┌─────────────────────────────────────────────┐
• Authentication (Clerk) │
• API Routes │
• WebSocket Handlers │
• ┘
• ↕️
Server Layer:
┌─────────────────────────────────────────────┐
• Controllers │
• WebSocket Server │
• Database (Prisma/MySQL) │
• ┘
Important Elements
a) External Services Integration:
• Clerk Authentication
• LiveKit for voice/video
• UploadThing for file uploads
• PlanetScale database
b) Internal Systems:
• Server management system
• Channel management system
• Direct messaging system
• Real-time chat system
• Voice/Video call system
Data Flow Indicators
• User authentication flow
• Message flow (both real-time and REST)
• Media streaming direction
• Database queries and responses