How enzob123/senff works
Project Type and Purpose
• This is a full-stack, containerized Laravel web application for task management.
• It uses MVC on the backend (Laravel 12.x, PHP 8.3) with Blade/Tailwind/Alpine.js on the frontend, plus asynchronous job processing (RabbitMQ) for e-mail notifications and report generation.
Main Architectural Components
A. Containers & Runtime
1. Nginx (reverse proxy / HTTP server)
2. PHP-FPM (Laravel application)
3. PostgreSQL (relational data store)
4. Redis (cache & session store)
5. RabbitMQ (message broker / queue)
6. Optional: Mailtrap (external SMTP service for dev)
B. Laravel Application Layers
1. HTTP Layer
• Routes (web.php, api.php) → Controllers (AuthController, TaskController, DashboardController)
• Request Validation (StoreTaskRequest, UpdateTaskRequest)
• Policies (TaskPolicy) for authorization
2. Domain Layer
• Models (User, Task)
• Observers (TaskObserver)
• Exports (TasksExport)
3. Job/Queue Layer
• Jobs enqueued on task creation/update or report request (GenerateTaskReportJob, SendTaskCreatedNotificationJob, etc.)
• Workers consume from RabbitMQ, execute jobs
4. Notification Layer
• Mailable classes (ReportReadyMail, TaskCreatedMail, TaskCompletedMail)
• Mail driver configured for Mailtrap
5. Persistence & Storage
• Database migrations & seeders (Postgres)
• File storage (CSV/XLSX reports in storage/app/reports)
• Cache/sessions (Redis)
Component Interactions & Data Flow
• User browser → Nginx → PHP-FPM → Laravel Controller
• Controller ↔ PostgreSQL for CRUD
• Controller dispatches Jobs → RabbitMQ
• Queue Worker (PHP-FPM) ← RabbitMQ → executes Job →
• writes report file to storage
• sends e-mail via Mailtrap SMTP
• Frontend assets served by Vite (dev) or built CSS/JS (prod)
• Redis handles session persistence & caching reads/writes
Architectural Patterns & Principles
• MVC for web requests
• Policy-based authorization for resource ownership
• Observer pattern on Task model for domain events
• Asynchronous, event-driven architecture for notifications and reports
• Containerization & 12-factor app principles (env config, logs, backing services)
Technologies & Frameworks to Annotate
• Backend: Laravel (Controllers, Requests, Jobs, Models, Policies, Observers)
• Frontend: Blade templates, Tailwind CSS, Alpine.js, Vite
• DB: PostgreSQL 15
• Cache/Session: Redis
• Queue: RabbitMQ (enqueue/laravel-queue)
• Export: maatwebsite/excel
• Containerization: Docker, Docker Compose
• Testing: PHPUnit (Feature & Unit tests)