# BeAuthentic — agent guidelines

Laravel 13 + Livewire 4 + Tailwind 4 commerce platform that must deploy on cPanel (no Redis/Docker/Node in production). Read ARCHITECTURE.md first.

- Business logic in `app/Services` / `app/Actions`; controllers and Livewire components stay thin.
- Money is integer kobo via `App\Support\ValueObjects\Money`. Never floats.
- Change stock only through `InventoryService`; prices only through `PriceManager`; read prices through `PriceResolver`.
- Never hard-code colours, prices or product IDs — they are data.
- Livewire actions re-check authorisation (`$this->authorize(...)`).
- Cache arrays/scalars only (Laravel 13 refuses to unserialise cached objects).
- UI uses the v2 retail design system in `resources/css/beauthentic.css` and `resources/views/components/ui` (Figtree, white background, bold uppercase headings, black rectangular buttons). `design/` is the superseded v1 direction.
- Run `php artisan test` and `./vendor/bin/pint` before finishing a change.
