How hackclub/high-seas works
Main Components
a. Frontend Layer:
• Next.js Application (src/app directory structure)
• Marketing Pages (/marketing)
• Harbor Section (main application area)
• UI Components Library (/components)
b. Backend Layer:
• API Routes (/api)
• Authentication System
• Background Jobs System
• External Services Integration
c. Data Storage:
• Redis (indicated by redis-lock.ts)
• Airtable Integration
• Local Storage (for client-side state)
Client-Side Architecture
• Route-based pages using Next.js App Router
• Component hierarchy
• State management
• UI/UX elements (including audio feedback)
Server-Side Architecture
• API endpoints structure
• Cron jobs system
• Background processing
• External integrations
Specific Implementation Details
[Client Layer]
• Marketing Site
• Harbor Dashboard
• Battles System
• Gallery
• Shipyard
• Shop
• Signpost
• UI Components
[Server Layer]
• API Routes
• Admin Controls
• Battle System
• Shop Management
• Stats Generation
• Background Jobs
• Daily Tasks
• Minute-level Tasks
• External Integrations
• Slack
• Airtable
• WakaTime
• Sentry
[Data Layer]
• Redis Cache
• Airtable Database
• Local Storage
Flow Representations
• User authentication flow
• Data flow between frontend and backend
• Integration points with external services
• Background job processing flow
Additional Elements
Include:
• Error handling flow (Sentry integration)
• Authentication boundaries
• Cache layers
• API rate limiting
• Background job scheduling