# Y. E. Transport & Contructors — Web Platform

Full platform package: public website + Laravel API/admin foundation + database migrations/seeds + installer + storage/media architecture.

Brand is intentionally spelled exactly: **Y. E. Transport & Contructors**.

## First install
1. Configure PHP 8.3+, PostgreSQL, Redis/Valkey and Composer.
2. Copy `.env.example` to `.env`.
3. Set DB credentials.
4. Run `composer install`.
5. Point the web server document root to `public/`.
6. Visit the domain. If the platform is not installed, the application redirects automatically to `/install`.
7. Complete `/install`; it runs migrations/seeds and creates the first Super Admin.
8. `/install` is locked after installation.

There is intentionally NO install.php.

## Included
- ES/EN locale gateway and SEO metadata
- Transport/equipment rental
- Construction requests/estimates
- Quote and appointment engine
- Careers/applications -> employee conversion model
- HRMS/workforce/attendance/QR anti-replay data model
- Project management and supervisor media/report model
- Notifications/emergency acknowledgements
- AI Gateway tool boundary
- RBAC/granular permissions
- Immutable audit events
- secure device authorization/revocation
- payroll export model
- secure connector architecture
- legal/resource/content model