How dabrovsky/jobfinder-engine works
Main Components
A. API Layer
• JobOffersController as the main endpoint handler
• Error handling middleware (from concerns/api/errors_handler.rb)
B. Core Business Logic Layer
• Command Pattern Implementation
• JobOffers commands (list)
• Providers commands (fetch)
• CommandHandler concern as a shared component
• Query Layer
• JobOffers queries (fetch)
• BaseQuery as the parent
C. Data Layer
• Database component showing JobOffer model
• ApplicationRecord as the base model
D. Background Processing
• Job Queue component (solid_queue.yml indicates background processing)
• FetchRecordsJob as a scheduled task
E. External Services Integration
• Provider APIs component
• NoFluffJobs API integration
• Common API handling layer
Relationships and Data Flow
• External requests → API Layer
• API Layer → Commands
• Commands → Queries → Data Layer
• Background Jobs → Provider APIs → Data Layer
• Serializers handling data transformation (JobOfferSerializer)
Additional Elements
• Notes about scheduled tasks (config/schedule.rb)
• Testing structure parallel to the main components
• Docker containerization boundary