Modo Playa Admin

🌐 English version: README.en.md

Modo Playa Admin es el panel de administración para la gestión operativa de la plataforma Modo Playa. Permite administrar alojamientos, contactos, usuarios y la cuenta del administrador desde una interfaz Ionic/Angular.

Este repositorio contiene el frontend administrativo de la aplicación, desarrollado con Ionic y Angular, pensado para uso web y preparado para evolución mobile con Capacitor.

---

🧩 Arquitectura general

• Framework: Ionic + Angular (standalone)
• Estilos: SCSS
• Routing: Angular Router con feature routes
• Autenticación: flujo de sesión con módulo auth
• Consumo de API: backend propio (Modo Playa API)

---

🛠️ Stack tecnológico

---

📱 Funcionalidades principales

• Dashboard administrativo
• Gestión de alojamientos
• Gestión de contactos
• Gestión de usuarios
• Perfil de usuario (ver, editar, cambio de contraseña)
• Gestión de imágenes delegada al backend de la API sin interacción directa con el bucket
• Pantalla de información de la app
• Páginas legales (Términos y Política de Privacidad)
• Selector de tema (claro, oscuro, sistema)

---

🖼️ Contrato de media vigente

El contrato canónico de media del admin es backend-only.

• El frontend envía multipart/form-data a modo-playa-api.
• El frontend no pide signed URLs, no sube archivos directo al bucket y no confirma uploads contra storage.
• profile usa POST/DELETE auth/me/profile-image.
• lodgings usa draft uploads por POST admin/lodging-image-uploads durante el alta y el subrecurso POST/PATCH/DELETE admin/lodgings/:id/images para la gestión posterior.
• La normalización, validación final, publicación y cleanup de media pertenecen al backend.

👤 Ownership y soporte

• Los flujos normales del admin operan con el ownerId del usuario autenticado.
• SUPERADMIN puede crear recursos en nombre de otro tenant sólo cuando envía targetOwnerId de forma explícita y el backend expone esa capacidad.
• SUPERADMIN no administra profile image mediante auth/me/profile-image.

---

🧑‍💻 Desarrollo

Para instrucciones de instalación y ejecución en entorno local:

👉 DEVELOPMENT.md

Para convenciones técnicas de módulos, ownership, sesión y media:

👉 ARCHITECTURE.es.md