MarinaOS — Onboarding & Demo

🔑 Cómo loguearte (tenés todos los permisos)

Rol dueño = acceso total. Verificado con login real contra producción (HTTP 200).

El campo "Marina (tenant ID)" del login lo podés dejar vacío — solo hay una marina, entra directo con email + contraseña.

👥 Diferencia: vos (dueño) vs admin vs cliente

Punto clave: el cliente NO es un usuario del panel. El cliente (dueño de un barco) entra por un Portal aparte con código OTP (email/WhatsApp), y ve SOLO lo suyo: sus reservas, sus facturas, chat con la marina y pagar. Nunca ve el panel de administración.

Quién	Qué puede
VOS — Dueño `dueno`	TODO el panel: las 20 secciones, gestión de usuarios, configuración, facturación, cobros, borrar. Cima de la jerarquía.
Admin `admin`	Prácticamente lo mismo que vos a nivel permisos (gestiona usuarios y config). La diferencia dueño↔admin es solo semántica: hoy ningún endpoint distingue uno de otro. Es el administrador operativo de la marina.
Cliente (portal) `owner`	NO entra al panel. Portal self-service: ver disponibilidad, reservar, ver SUS facturas, pagar, chatear con la marina. Login por OTP, no por contraseña.

🎚️ Los 9 roles de staff (jerarquía completa)

Además de dueño/admin, el sistema tiene roles acotados para el equipo. Cada uno ve solo lo que le toca:

Rol	Alcance
DUEÑO (vos) `dueno`	Acceso total a TODO el tenant. Es tu rol hoy. Puede gestionar usuarios, config, facturación, cobros, borrar, y todo lo operativo. Es la cima de la jerarquía.
Gerente `gerente`	Igual que dueño a nivel permisos (también admin pleno). Diferencia solo semántica/organizativa — para el gerente de la marina.
Admin `admin`	Administrador con permisos plenos (gestiona usuarios y settings). A nivel API es equivalente a dueño/gerente.
Recepción `recepcion`	Operativo: clientes, barcos, reservas, check-in, servicios, mensajes. NO gestiona usuarios ni config del tenant.
Capitanía `capitania`	Check-in/out, despachos de salida, regulatorio, seguridad. Enfocado en operación náutica.
Contador `contador`	Facturación, cobros, tesorería, reportes. No toca operación de amarres ni usuarios.
Mantenimiento `mantenimiento`	Tickets, órdenes de trabajo, repuestos, mantenimiento preventivo. Sin acceso a facturación/usuarios.
Marinero `marinero`	Operativo básico de piso (algunas escrituras acotadas). Sin admin.
Lectura `lectura`	Solo ver. No modifica nada. Para auditoría o consulta.

Solo dueño/gerente/admin pueden crear usuarios y cambiar la configuración del tenant. El resto son operativos.

🧭 Las 20 funciones (con captura real de cada una)

Capturas reales del sistema en producción, logueado como vos, con los datos seed cargados.

📊

1. Dashboard

Todos (lectura ve solo)

Pantalla de inicio con KPIs en vivo: muelles totales (143), disponibles, ocupados/reservados, en mantenimiento, clientes (11), embarcaciones (14), reservas activas y % de ocupación. Es tu foto instantánea de la marina.

🗺️

2. Mapa

Todos

Mapa interactivo de Marina Puerto Aventuras con los amarres georreferenciados sobre el plano real. Cada muelle cambia de color según estado (libre / ocupado / reservado / mantenimiento). Click en un amarre → detalle y acciones.

⚓

3. Muelles

dueno, gerente, admin, recepcion

Los 143 amarres: tipo (vela, motor, mega-yate, catamarán), eslora/manga/calado máximos, tarifa, categoría y estado. Alta/baja/edición de amarres y bloqueos temporales.

👤

4. Clientes

dueno, gerente, admin, recepcion

Los dueños de barco (owners) — 11 cargados. Datos de contacto, documentos (INE, matrícula), vínculo a Telegram/WhatsApp para el portal. Alta y edición.

⛵

5. Barcos

dueno, gerente, admin, recepcion

Embarcaciones (14) — eslora, tipo, bandera, matrícula, dueño asociado. Se autocompleta desde la BD Mundial al cargar por nombre/IMO.

🌍

6. BD Mundial

Todos (consulta)

Base mundial de 98.620 barcos para autocompletar altas (nombre, IMO, eslora, bandera). Buscás el barco y trae los datos — no los tipeás a mano.

📅

7. Reservas

dueno, gerente, admin, recepcion

Reservas de amarre (15) — rango de fechas, amarre asignado, estado (hold / confirmada / cancelada). Motor de disponibilidad que filtra por eslora. Crear, confirmar, cancelar.

🛂

8. Check-in

dueno, gerente, admin, recepcion, capitania

Check-in / check-out de embarcaciones a su llegada y salida, con despacho de salida (capitanía). Registra entrada/salida real vs reserva.

📜

9. Contratos

dueno, gerente, admin

Contratos de amarre con plantillas, extras y servicios asociados, y firma. Genera el contrato del cliente que amarra por temporada/año.

🧾

10. Facturación

dueno, gerente, admin, contador

Facturas (9) con CFDI 4.0 de México vía Facturama (PAC). Genera y timbra el comprobante fiscal, PDF descargable. HOY en modo sandbox (prueba).

💵

11. Cobros

dueno, gerente, admin, contador

Pagos (6) y tesorería: registro de cobros, conciliación bancaria, link de pago (Stripe / Mercado Pago / Conekta). HOY cobro manual — faltan llaves de producción de las pasarelas.

🛠️

12. Servicios

dueno, gerente, admin, recepcion

Catálogo de servicios de la marina (agua, luz, combustible, grúa, pump-out) y su asignación/consumo por embarcación.

🔧

13. Mantenimiento

dueno, gerente, admin, mantenimiento

Tickets de mantenimiento correctivo y preventivo, órdenes de trabajo, repuestos y estados. Para el equipo operativo de la marina.

💬

14. Mensajes

dueno, gerente, admin, recepcion

Chat con clientes integrado al bot de Telegram (activo) y WhatsApp (pausado). Historial de conversación por cliente, inbound y outbound.

🛡️

15. Seguridad

dueno, gerente, admin, recepcion, capitania

Control de visitantes, tarjetas de acceso, cámaras, incidentes y bitácora de seguridad de la marina.

📈

16. Reportes

dueno, gerente, admin, contador

Reportes de ocupación, ingresos y actividad, exportables. Para dirección y contabilidad.

📋

17. Regulatorio

dueno, gerente, admin, capitania, contador

Cumplimiento regulatorio / capitanía de puerto: despachos, avisos de arribo/salida y documentación exigida en MX.

👥

18. Usuarios

dueno, gerente, admin

Gestión del staff de la marina: alta de usuarios, asignación de rol e invitaciones. SOLO roles admin (dueno / gerente / admin) pueden entrar acá.

🔌

19. Plugins

dueno, gerente, admin

Integraciones activables/desactivables por marina (pasarelas de pago, PAC de facturación, canales WhatsApp/Telegram, etc.). Encendés lo que cada tenant usa.

⚙️

20. Configuración

dueno, gerente, admin

Ajustes del tenant: datos de la marina, branding (ancla + timón — íconos canónicos, no tocar), moneda, zona horaria, parámetros de operación.

✅ Qué YA tenés funcionando

Panel completo con 20 módulos + datos seed (143 muelles, 11 clientes, 14 barcos, 15 reservas, 9 facturas, 6 pagos).
BD Mundial de 98.620 barcos para autocompletar.
Multi-tenant + 9 roles + portal de cliente por OTP.
Bot de Telegram activo (canal primario del asistente).
Facturación CFDI vía Facturama (conectado).
Mapa con plano real de Puerto Aventuras.

⚠️ Qué falta agregar (antes de cobrarle a un cliente real)

Tema	Estado	Qué falta
Facturación CFDI	SANDBOX	Hoy timbra contra `apisandbox.facturama.mx` (prueba). Falta credencial de producción para timbrar CFDI reales ante el SAT.
Pagos online	SIN LLAVES	No hay llaves de Stripe / Mercado Pago / Conekta cargadas → el cobro online (link de pago) no opera. Hoy cobro manual. Falta dar de alta las pasarelas.
WhatsApp	PAUSADO	El canal WhatsApp está pausado (dependía de la salida residencial de ZIVON, eliminado). Necesita IP residencial AR nueva. Telegram funciona.
Portal cliente por WA	PARCIAL	El OTP por WhatsApp depende de lo anterior. Por email debería andar; validar SMTP en prod.
Scope del bot agéntico	A DEFINIR	Falta cerrar la lista exacta de operaciones que el asistente puede/no puede ejecutar (milestone abierto en el CLAUDE.md del proyecto).

Para la demo nada de esto molesta: mostrás flujo completo con datos seed. Solo evitá presentar "cobro con tarjeta en vivo" o "CFDI real timbrado".

🎬 Orden sugerido para la demo

Dashboard — arrancás mostrando los KPIs de la marina de un vistazo.
Mapa + Muelles — el plano real, los 143 amarres y sus estados por color. Impacto visual.
Clientes + Barcos + BD Mundial — cargás un barco y mostrás el autocompletado desde los 98.620.
Reservas + Check-in — creás una reserva (motor de disponibilidad por eslora) y hacés el check-in.
Contratos + Facturación — generás el contrato y la factura CFDI (aclarando: modo prueba).
Cobros + Reportes — registrás el cobro y mostrás el reporte de ocupación/ingresos.
Portal del cliente — cerrás mostrando la otra cara: cómo el dueño del barco reserva y paga solo.
Usuarios + Roles — mostrás que podés dar de alta staff con permisos acotados (recepción, contador, etc.).