How facubotta/filrouge2024 works
Main System Components
a) Frontend Layer:
• Next.js App Router Structure (evident from the /app directory)
• Client Components (/components directory)
• Theme System (light/dark mode)
• Authentication UI (@auth directory)
• Pages/Routes Structure
b) Backend Layer:
• Server Actions (organized in /actions directory)
• API Routes (/app/api)
• Authentication System (NextAuth.js)
• WebSocket Integration (socket.ts)
c) Database Layer:
• PostgreSQL Database (evident from Prisma schema)
• Prisma ORM
• Migration System
d) External Services:
• Google Calendar Integration
• Google Maps Integration (googleMapsProvider.ts)
• Authentication Providers (Google, Email)
Key Architectural Patterns to Highlight
• Server Components Architecture (Next.js 13+ pattern)
• Feature-based Directory Structure
• Server Actions Pattern
• Real-time Communication (WebSocket)
┌─ Client Layer ─────────────────────┐
• Next.js Pages │
• React Components │
• Theme System │
• ┬────────────────────┘
• ↕
┌─ Server Layer ─────────────────────┐
• ┌─ Next.js App Router ───┐ │
• Server Components │ │
• Server Actions │ │
• ┘ │
• ┌─ API Layer ──────────┐ │
• REST Endpoints │ │
• WebSocket Server │ │
• ┘ │
• ┬────────────────────┘
• ↕
┌─ Data Layer ──────────────────────┐
• Prisma ORM │
• PostgreSQL Database │
• ┬────────────────────┘
• ↕
┌─ External Services ───────────────┐
• Google Calendar API │
• Google Maps API │
• Authentication Providers │
• ┘
Important Flows to Highlight
a) Authentication Flow:
• Path from login UI through NextAuth.js to external providers
• Session management
b) Event Management Flow:
• Event creation/update path
• Calendar synchronization
• Real-time updates
c) Messaging System:
• WebSocket connections
• Message storage and retrieval
• Real-time notifications
Additional Details
• Security boundaries
• Scalable components
• Caching layers where applicable
Specific Features to Emphasize
• Real-time messaging system
• Event management and calendar integration
• User rating and comment system
• Profile management
• Category-based event organization