# LavanderOS

SaaS multi-tenant para la operación de lavanderías, construido con Yii2, PHP 8 y MySQL/MariaDB.

El proyecto parte de una implementación nueva. Las reglas funcionales provienen de la documentación validada de `LAVANDERIA`, mientras que la administración RBAC, los patrones de catálogos y el diseño toman como referencia selectiva `saas-compraventa`.

Consulta [docs/ARQUITECTURA_INICIAL.md](docs/ARQUITECTURA_INICIAL.md) para conocer el alcance, [docs/PROGRESO.md](docs/PROGRESO.md) para retomar el desarrollo y [docs/DESPLIEGUE_DOMINIO_TEMPORAL.md](docs/DESPLIEGUE_DOMINIO_TEMPORAL.md) para preparar una instancia HTTPS de prueba.

## Estado

- Yii2 Advanced y plantilla administrativa instalados.
- Autenticación, activación, perfil y administración de usuarios disponibles.
- RBAC con roles `super_admin`, `owner`, `cashier` y `operator` inicializado.
- Menús administrativos persistidos y filtrados por permisos.
- Base MySQL local `lavansys` migrada.
- Próxima fase: tenants, sucursales y membresías.

No se deben versionar credenciales, archivos `.env`, runtimes ni datos provenientes de los proyectos de referencia.

## Acceso local

`http://localhost/SASS-COMPRAVENTA/lavansys/backend/web/index.php`

## Instalación

1. Ejecutar `composer install`.
2. Ejecutar `php init --env=Development --overwrite=All`.
3. Copiar `.env.example` a `.env` y completar los secretos.
4. Crear la base `lavansys` con `utf8mb4`.
5. Ejecutar `php yii migrate --migrationPath=@yii/rbac/migrations --interactive=0`.
6. Ejecutar `php yii migrate --interactive=0`.
7. Ejecutar `php yii rbac/init`.
8. Crear el primer administrador con `php yii user/create-admin`.