How theihasan/geezap works
Main System Components
a) Client Layer
• Web Interface (Built with Livewire + TailwindCSS)
• Admin Panel (Filament-based)
b) Application Layer
• Authentication System
• Job Management System
• Cover Letter Generation System
• WebSocket System (Laravel Reverb)
• Queue System
c) Integration Layer
• External Job Platforms (LinkedIn, Upwork, Indeed, ZipRecruiter)
• OpenAI API Integration
• Social Auth Providers
• Cloudflare Turnstile
d) Data Layer
• MySQL Database
• Cache System
• File Storage
Component Relationships
a) Frontend to Backend:
• HTTP/HTTPS requests between web clients and controllers
• WebSocket connections for real-time updates
• API endpoints for job data and cover letter generation
b) Internal Services:
• Queue system handling background jobs (GenerateCoverLetterJob, GetJobData)
• Event system managing notifications (CoverLetterGenerated event)
• Service classes managing business logic (AIService, MetaTagGenerator)
c) External Integrations:
• API connections to job platforms
• OpenAI API for cover letter generation
• Social authentication providers
Specific Implementation Details
a) Core Features:
Web Client -> JobController -> JobFilter Pipeline -> External Job APIs
User -> CoverLetterController -> AIService -> OpenAI API
Admin Panel -> Filament Resources -> Database
b) Authentication Flow:
User -> SocialAuthController -> External Providers
User -> AuthenticatedSessionController -> Database
c) Real-time Features:
Client -> Laravel Reverb -> WebSocket Server
Important Architectural Patterns to Highlight
• MVC Pattern (Controllers, Models, Views structure)
• Repository Pattern (Job data handling)
• Observer Pattern (JobListingObserver, UserObserver)
• DTO Pattern (Multiple DTOs for data transfer)
• Queue-based Architecture (Background jobs)
Key Technical Components
Specific elements:
• Filament Admin Panel (/app/Filament)
• Job Management System (/app/Http/Controllers/JobController)
• Cover Letter Generation (/app/Services/AIService)
• Authentication System (/app/Http/Controllers/Auth)
• Queue Workers (/app/Jobs)
• WebSocket Server (Laravel Reverb)
User Request -> Controller -> Service -> External API -> Database
Job Fetch -> Queue -> Job Processing -> Database -> WebSocket -> Client
Cover Letter Request -> Queue -> AI Service -> OpenAI -> Database
Infrastructure Components
Include:
• MySQL Database
• Redis/Cache Server
• Queue Worker Processes
• WebSocket Server
• File Storage System