Administración (solo propietario)
Esta guía es solo para ti si tienes la cuenta de administrador (rol ADMIN). Cubre cómo gestionar dietistas, licencias y ver la salud del negocio.
Si eres dietista, esta sección no aplica — no puedes entrar a /admin.
1. Tu rol como administrador
Tú NO atiendes pacientes desde Nutriapp. Tu trabajo es:
- Dar de alta a los dietistas que van a usar la plataforma.
- Gestionar sus licencias (plan, fecha de vencimiento, número máximo de clientes).
- Suspender o reactivar cuentas cuando alguien deja la consulta.
- Vigilar el negocio: cuántos dietistas activos hay, cuáles tienen licencia por vencer, quiénes son tus mejores clientes.
- Mantener el catálogo de alimentos global que todos los dietistas comparten.
2. La pantalla principal — Dashboard admin
Menú lateral → Administración.
Lo que verás al entrar:
Arriba — 4 métricas básicas
- Dietistas — total de dietistas en la plataforma.
- Clientes — total de pacientes (sumando todos los dietistas).
- Licencias activas — cuántas están vigentes.
- En revisión — cuentas que requieren tu atención (recién creadas sin validar, etc.).
Justo debajo — gráficas de negocio
- Distribución por plan — barras horizontales mostrando cuántos dietistas hay en BASIC, PRO y CLINIC.
- Licencias por vencer (30 días) — listado de licencias que caducan en el próximo mes. Cada una con:
- 🔴 Rojo si vence en menos de 7 días.
- 🟡 Amarillo si vence entre 7 y 30 días.
- 🟢 Verde si tiene más margen.
- Crecimiento mensual — cuántos dietistas nuevos hay este mes vs el anterior y porcentaje de cambio.
- Top 5 dietistas por clientes — quién tiene más pacientes.
- Dietistas inactivos — quién no tiene clientes asignados.
Actividad reciente
Lista cronológica de las últimas 20 acciones administrativas que ocurrieron: nuevo dietista creado, licencia renovada, cuenta suspendida, etc. Sirve como auditoría.
Crear dietista
Botón colapsable arriba. Cuando lo abres, formulario para alta rápida.
Listado de dietistas
Tabla paginada (25 por página) con todos los dietistas. Cada fila enlaza a su ficha individual.
3. Dar de alta un dietista nuevo
- En la cabecera del listado, pulsa + Crear dietista nuevo (se despliega el formulario).
- Rellena:
- Nombre completo.
- Email — debe ser único.
- Clínica (opcional) — nombre de su consulta o sede.
- Teléfono (opcional).
- Estado inicial — déjalo en "Activa" salvo que quieras dejarla en "Revisión" mientras esperas a tener todos sus datos.
- Pulsa Crear dietista.
La contraseña inicial es demo. Pídele al dietista que la cambie en cuanto entre por primera vez. (Hoy no hay UI para cambiarla; tendría que hacerlo el admin manualmente. Esto está en la lista de mejoras.)
Crear un dietista NO le asigna licencia automáticamente. Tienes que crearla en el siguiente paso.
4. Asignar / actualizar licencia
- En el listado, pulsa el nombre del dietista. Entras a su ficha (
/admin/dietistas/[id]). - Baja a la sección Licencia.
- Rellena:
- Plan — BASIC, PRO o CLINIC. (Los nombres son orientativos; los precios y diferencias los gestionas tú externamente — Nutriapp no factura aún.)
- Estado — Activa, Expirada o Cancelada.
- Máximo de clientes — cuántos pacientes puede dar de alta. El dietista NO podrá superar este número.
- Fecha de vencimiento — desde aquí el dietista tendrá restricciones cuando se acerque.
- Pulsa Guardar licencia.
La licencia es una sola por dietista. Si quieres "renovar", solo cambia la fecha de vencimiento al nuevo periodo y guarda.
5. Ficha individual de dietista — /admin/dietistas/[id]
Cuando pulsas el nombre de un dietista en la lista, entras a su ficha completa. Tiene 5 secciones:
Datos
- Nombre, email, clínica, teléfono.
- Botón Editar (despliega formulario inline).
- Badge con su estado de cuenta.
Licencia
- Plan, estado, máximo clientes, fecha vencimiento.
- Indicador de días restantes con color (rojo/amarillo/verde).
- Formulario para actualizar (visto en el paso 4).
Clientes
- Tabla con los pacientes asignados a este dietista.
- Columnas: nombre, objetivo, kcal target, adherencia.
- Empty state si aún no tiene clientes.
Notas internas (privadas)
Tu cuaderno privado sobre este dietista. El dietista NO ve estas notas.
- Campo para escribir una nota nueva ("ha pedido ampliar a 100 clientes, valorar pasarlo a CLINIC").
- Lista de notas existentes con fecha, autor y botón Eliminar.
Historial de actividad
Cronología de todas las acciones administrativas sobre este dietista:
- 🆕 Cuenta creada.
- ✏️ Datos actualizados.
- ⛔ Cuenta suspendida.
- ✅ Cuenta reactivada.
- 💰 Licencia renovada.
- 📝 Nota añadida.
- 🗑️ Nota eliminada.
Cada entrada tiene fecha y autor (qué admin lo hizo). Esto sirve de auditoría legal si alguna vez tienes que demostrar quién hizo qué.
6. Suspender / reactivar un dietista
En la cabecera de su ficha, junto al botón "Volver", verás:
- Suspender (si está activa) → la cuenta se bloquea. El dietista no puede entrar.
- Activar (si está suspendida) → vuelve a poder entrar.
Suspender NO elimina nada. Sus pacientes y dietas siguen ahí. Si reactivas, todo vuelve a funcionar.
7. Filtros y búsqueda en el listado
El listado paginado tiene una barra de filtros combinables:
Búsqueda libre
Campo de texto: busca por nombre, email o clínica a la vez. Insensible a mayúsculas.
Filtros desplegables
- Estado cuenta: Todas / Activas / Suspendidas / En revisión.
- Plan: Todos / BASIC / PRO / CLINIC.
- Estado licencia: Todas / Activa / Expirada / Cancelada.
- Solo licencias por vencer (30 días) — casilla.
Ordenar
- Alfabético.
- Más clientes.
- Próximo a vencer.
- Más recientes.
URL deeplinkable
Los filtros viven en la URL. Si has filtrado "PRO + licencias por vencer ≤30d" y quieres mantener esa vista:
- Guarda la URL como favorito del navegador.
- Cómpartela con otro admin si lo tuvieras.
8. Mantener el catálogo de alimentos
El catálogo de alimentos es global — lo ven todos los dietistas. Tú puedes:
- Menú lateral → Alimentos.
- Crear alimentos nuevos (mismo formulario que los dietistas pero los tuyos quedan visibles para todos).
- Importar alimentos desde Open Food Facts España con los scripts que mantenga el equipo técnico.
- Asignar sección de supermercado y precio €/kg a alimentos clave para que la lista de compra de las dietas sea útil.
9. Lo que NO está en admin (todavía)
Estas funciones están planeadas pero aún no implementadas:
- Renovación masiva de licencias.
- "Iniciar sesión como dietista X" (impersonate) para soporte. Ahora si un dietista te dice "no me funciona", tienes que pedirle captura porque no puedes ver lo mismo que él.
- Email broadcast a todos los dietistas (avisos de mantenimiento, etc.).
- Configurar precios y planes desde la UI (hoy los planes son metadato; la facturación la haces fuera).
- Cambiar contraseña de un dietista desde la UI.
Si necesitas alguna de estas, pídele al equipo técnico que las priorice.
10. Auditoría — quién hizo qué
El sistema registra automáticamente todas las acciones admin importantes en el activity log. Lo ves:
- Global — en el dashboard admin, sección "Actividad reciente" (últimas 20).
- Por dietista — en su ficha individual, sección "Historial de actividad" (todas las acciones sobre ESE dietista).
Si en el futuro tienes que justificar legalmente quién creó/modificó/suspendió una cuenta, el activity log es tu fuente de verdad.
¿Y ahora qué?
- Si quieres entender el negocio de un vistazo cada lunes, revisa el dashboard admin durante 5 minutos.
- Si tienes dudas concretas, mira Preguntas frecuentes.
- Si algo va mal, mira Si algo falla.