Appearance
ADR-010 — Laravel 13 as Application Framework
Status: Accepted
Date: 2026-05-21
Decision
Laravel 13 for the Opsome application, with the following companion choices:
| Concern | Choice | Reason |
|---|---|---|
| Framework | Laravel 13 | Founder's strongest stack; fastest path to working software |
| Admin / approval UI | Filament v3 | Approval queue dashboard is almost free to build |
| Queue / async | Laravel Queue + Redis | Agent runs, LLM calls, approval job execution |
| Testing | Pest 4 | Expressive, fast, Laravel plugin available |
| AI context | Laravel Boost | Provides CLAUDE.md / AGENTS.md skills for AI-assisted development |
| Database | PostgreSQL 17 | Shared infra container; JSONB for adapter configs |
| Auth | Laravel Sanctum | API tokens for the buy2give.store internal API |
Consequences
- All generated files use
php artisan make:— no manual class creation - Queue jobs (
ShouldQueue) for all agent runs and approval executions config('x.y')everywhere;env()only in config files- Filament resources for Tenant management and Approval queue UI (M5)