# Almasa CMS — agent notes

- Runtime is Docker/Sail. Run PHP tooling inside the container as the `sail` user:
  `docker compose exec -T -u sail laravel.test <command>` (artisan, composer, pest, pint).
- App: http://localhost:8088 · Mailpit: http://localhost:8025 · MySQL on host port 3307.
- Built in 10 phases (spec §102). Check `git log` for the last completed phase; pause for
  user review after each phase and commit once per phase.
- Business logic lives in `app/Domain/<Module>` (Actions, Policies, Enums). Filament classes
  are UI only and call domain actions.
- Permission names come only from `App\Domain\Authorization\PermissionRegistry`; never check
  role names in authorization code.
- Every user-facing string goes in `lang/ar` AND `lang/en`. Arabic is the default locale.
- `Model::shouldBeStrict()` is on outside production: declare model `$attributes` defaults
  for columns that only have DB defaults, and eager-load relations.
- Never run `migrate:fresh` against anything but local/testing databases (spec §105).
- Before finishing a change: `./vendor/bin/pint` and `./vendor/bin/pest` must be clean.
