How drop-oss/drop works
Main System Components
a) Frontend Layer:
• Vue.js/Nuxt.js application components (from /components directory)
• Client-side routes (from /pages directory)
• User interface elements (admin panel, store, authentication flows)
b) Backend Layer:
• API Routes (/server/api/v1)
• Internal Services (/server/internal)
• Authentication/Security
• Library Management
• Metadata Services
• Object Storage
• Task Management
• Notification System
• Client Management
c) Data Layer:
• PostgreSQL Database (via Prisma)
• File Storage System (for game files)
Key Interactions to Highlight
• Authentication flows (both admin and user)
• Game distribution pipeline
• Metadata synchronization
• Client-server communication
• WebSocket notifications
• File upload/download processes
Specific Implementation Details
• Blue: Core application services
• Green: External integrations (GiantBomb API)
• Orange: Security components
• Purple: Storage systems
• Gray: Supporting services
Component Breakdown
┌─ Frontend Layer ─────────────────────┐
• Admin Interface │
• Store Interface │
• User Dashboard │
• Documentation System │
• ┘
┌─ API Layer ────────────────────────┐
• Admin API │
• Client API │
• Store API │
• Authentication API │
• ┘
┌─ Service Layer ──────────────────────┐
• Library Management │
• Metadata Service │
• Object Storage │
• Task Coordinator │
• Notification System │
• ┘
┌─ Data Layer ───────────────────────┐
• PostgreSQL Database │
• File Storage │
• ┘
Integration Points
External connections:
• GiantBomb API integration
• Client application connections
• Authentication providers
• File storage backends
Deployment Context
Containerization boundary:
• Docker container scope
• Volume mounts for game storage
• Network interfaces