Guía de Usuario — FamilyBoard

Documentación para familias que usan FamilyBoard.
Para detalle de cada app o pantalla, consulta las guías enlazadas al final de cada sección.

¿Qué es FamilyBoard?

FamilyBoard es un sistema de información familiar diseñado para mostrar contenido útil de manera permanente dentro del hogar.

A diferencia de una tablet o un teléfono:

El sistema combina:

Desde la web puedes gestionar listas de compras, horarios, eventos, hábitos, mensajes, medicación, imágenes, cumpleaños y más.

Cómo funciona

  1. Editas información desde la web.
  2. FamilyBoard prepara una imagen optimizada para la pantalla del tablero.
  3. El dispositivo se conecta periódicamente.
  4. Descarga la imagen nueva si hay cambios.
  5. Actualiza la pantalla.

La pantalla e-paper solo consume energía al refrescar, no para mantener la imagen visible. Por eso, incluso apagado, el tablero seguirá mostrando la última imagen. Esto es completamente normal.

Los cambios no son instantáneos en el tablero físico: se actualiza en su próximo ciclo de refresco o al despertarlo manualmente (con los botones, si tu modelo los tiene). La vista en vivo, en cambio, refleja los cambios de inmediato.

Conceptos principales

Familia

Representa tu hogar dentro del sistema. Agrupa:

Integrantes

Son las personas —o grupos— asociadas a apps como Horarios, Eventos, Medicación, Hábitos y Estado emocional.

Cada app tiene su propia lista de integrantes. Usar el mismo nombre en varias apps ayuda a reconocer las vistas en el tablero, pero no los sincroniza automáticamente.

→ Guía completa: Integrantes

Aplicaciones

Cada aplicación resuelve una necesidad distinta del hogar:

App Para qué sirve
Compras Listas compartidas de supermercado
Horarios Rutinas semanales por persona
Eventos Recordatorios y fechas importantes
Mensajes Frases visibles para la familia
Imágenes Fotos e ilustraciones en el tablero
Cumpleaños Fechas que se repiten cada año
Medicación Recordatorio de tomas
Hábitos Seguimiento de objetivos
Estado emocional Cómo se siente cada uno

Puedes activar u ocultar apps desde Configuración, sin perder sus datos.

Vistas

Las aplicaciones generan vistas concretas para mostrar en los dispositivos.

Ejemplos:

Cada dispositivo puede mostrar una vista fija o rotar varias en un carrusel.

Dispositivos

FamilyBoard soporta dos tipos:

Dispositivos físicos — tableros e-paper reales conectados por WiFi. Muestran batería, permiten horario de sueño y navegación por botones.

Dispositivos virtuales — pantallas web accesibles desde navegador. Ideales para tablets, televisores o probar configuraciones.

→ Guía completa: Dispositivos

Primer uso

1. Encender el tablero

Conecta el dispositivo y enciéndelo.

La pantalla puede tardar algunos segundos en realizar el primer refresco completo.

2. Configurar WiFi

Si el dispositivo no tiene WiFi configurado, creará una red llamada:

FamilyBoard_Config

Desde tu teléfono o computador:

  1. Conéctate a esa red.
  2. Se abrirá automáticamente el portal de configuración.

Si no aparece, entra manualmente a:

http://192.168.4.1
  1. Selecciona tu red WiFi.
  2. Ingresa la contraseña.
  3. Guarda.

El dispositivo se reiniciará e intentará conectarse a tu red.

3. Activación de la cuenta

Una vez conectado a internet, aparecerá un código de activación en pantalla.

Ejemplo:

FB-9K3P-12XD

Luego, en la web:

  1. Ve a la página de Activar (desde el enlace de bienvenida o la ruta /activate).
  2. Introduce: - el código de activación, - nombre de tu familia, - email, - contraseña.
  3. Finaliza la activación.

Se creará tu cuenta y el dispositivo quedará vinculado a tu familia.

Importante: recibirás un correo para verificar tu email. Debes abrir el enlace del mensaje antes de poder iniciar sesión. Revisa también la carpeta de spam si no lo ves en unos minutos.

Este mismo flujo sirve para el primer tablero físico o para una licencia virtual que hayas recibido al adquirir un dispositivo virtual.

Cuenta y acceso

Verificar tu correo

Tras registrarte en Activar (/activate), FamilyBoard envía un correo con un enlace de verificación.

  1. Abre el mensaje en tu bandeja de entrada (revisa spam si no aparece).
  2. Haz clic en el enlace. Se abrirá la página Verificar correo (/verify-email).
  3. Cuando la verificación sea correcta, ya podrás iniciar sesión.

El enlace expira en 24 horas. Si caducó o no recibiste el correo:

  1. Ve a Iniciar sesión (/login).
  2. Intenta entrar con tu email y contraseña.
  3. Si el correo aún no está verificado, verás un aviso con la opción Reenviar correo de verificación.

Hasta verificar el email no podrás acceder al dashboard ni al resto de la web.

Iniciar sesión

Después de verificar tu correo, entra con tu email y contraseña desde Iniciar sesión (/login).

Vincular más dispositivos

Si ya tienes cuenta y quieres agregar otro tablero:

  1. Ve al Dashboard.
  2. Entra a Dispositivos → Gestionar.
  3. Despliega “Vincular dispositivo…”.
  4. Ingresa el código de activación del nuevo tablero (físico o virtual).
  5. Opcionalmente, asigna un nombre.

No necesitas crear otra cuenta: todos los dispositivos quedan bajo la misma familia.

Recuperar contraseña

Si olvidaste tu contraseña:

  1. Ve a Iniciar sesión (/login).
  2. Haz clic en ¿Olvidaste tu contraseña? (ruta /forgot-password).
  3. Ingresa el email de tu cuenta y envía el formulario.
  4. Revisa tu correo y abre el enlace de restablecimiento (válido 1 hora).
  5. En Nueva contraseña (/reset-password) elige una contraseña de al menos 8 caracteres.
  6. Vuelve a Iniciar sesión con la contraseña nueva.

Por seguridad, el sistema no indica si un email está registrado o no: siempre verás el mismo mensaje de confirmación al solicitar el enlace.

Si no recibes el correo, comprueba la carpeta de spam o repite el proceso después de unos minutos. Si el enlace expiró, solicita uno nuevo desde /forgot-password.

Dashboard principal

El dashboard es el centro del sistema.

Desde aquí puedes:

→ Guía completa: Dashboard

Configuración global

Ruta: Configuración (⚙)

Aquí puedes modificar:

Nombre de la familia

Nombre visible dentro del sistema.

Zona horaria

Afecta horarios, eventos, medicación y las horas mostradas en el tablero.

Orden y activación de aplicaciones

Ubica primero las apps que más uses y oculta las que no necesites. Desactivar una app no borra sus datos: simplemente deja de aparecer en el dashboard y en la configuración de dispositivos.

Dispositivos

Ruta: Dispositivos → Gestionar

Desde aquí puedes:

→ Guía completa: Dispositivos

Vista en vivo

La vista en vivo muestra en el navegador la misma imagen que el tablero físico: 800×480 y 4 tonos de gris. Los cambios que hagas en la web se reflejan de inmediato (a diferencia del tablero e-paper, que espera su próximo refresco). No aplica el horario de sueño.

Los dispositivos virtuales incluyen un botón para copiar el enlace de visualización. Debes tener sesión iniciada en el navegador donde lo abras.

→ Guía completa: Vista en vivo

Modos de visualización

Vista fija

El dispositivo muestra siempre la misma app o vista.

Ejemplos: Compras, Horario (Todos), un mensaje fijo.

Carrusel automático

El dispositivo rota entre varias vistas con tiempos configurables.

Ideal para living, cocina o espacios comunes donde quieres ver varias apps.

Algunos tableros físicos tienen botones para cambiar de vista manualmente. Puedes configurar qué apps aparecen, en qué orden y cuánto tiempo permanece activa la navegación antes de volver a la vista principal.

Frecuencia de actualización

Define cada cuánto el dispositivo busca cambios:

Horario de sueño

Los tableros físicos pueden suspender actualizaciones automáticas durante ciertas horas (por ejemplo, 23:00 → 07:00). La imagen permanece visible, pero el dispositivo no se conecta hasta que termine el horario o presiones un botón.

Detalle de carrusel, botones, frecuencia y sueño: Guía de dispositivos

Aplicaciones

Cada app tiene su propia guía con instrucciones paso a paso.

Compras

Listas compartidas con historial inteligente, detección de duplicados y organización manual para el recorrido del supermercado.

→ Guía de Compras

Horarios

Rutinas semanales por integrante y vista consolidada del día para espacios comunes.

→ Guía de Horarios

Eventos

Recordatorios familiares con priorización visual automática y lenguaje natural (“hoy”, “mañana”).

→ Guía de Eventos

Mensajes

Mensajes persistentes para toda la familia o mensajes individuales por dispositivo.

→ Guía de Mensajes

Imágenes

Fotos e ilustraciones adaptadas a la pantalla e-paper, con ajuste de encuadre y contraste.

→ Guía de Imágenes

Cumpleaños

Fechas que se repiten cada año, ordenadas por cercanía.

→ Guía de Cumpleaños

Medicación

Tratamientos, horarios de toma y recordatorios visuales en el tablero.

→ Guía de Medicación

Hábitos

Objetivos diarios o semanales con seguimiento visual del progreso.

→ Guía de Hábitos

Estado emocional

Registro simple de cómo se siente cada integrante, pensado para empatía familiar —no como herramienta clínica.

→ Guía de Estado emocional

Filosofía del producto

FamilyBoard está diseñado para:

No intenta reemplazar teléfonos, calendarios complejos ni sistemas de productividad.

Su objetivo es transformar información importante en presencia visible dentro del hogar.

Problemas frecuentes

El tablero no se actualiza

Verifica que tenga WiFi, que no esté en horario de sueño y que hayan pasado unos minutos desde tu último cambio. Los refrescos dependen de la frecuencia configurada en el dispositivo.

No aparece el portal WiFi

Conéctate manualmente a la red FamilyBoard_Config y abre http://192.168.4.1.

El código de activación no funciona

Comprueba que esté escrito exactamente como aparece en pantalla. Si el dispositivo ya fue vinculado a otra familia, necesitarás un código nuevo.

No veo una app en el dashboard

Revisa Configuración y confirma que la app esté activada.

No encuentro la vista de una persona en el dispositivo

Crea primero al integrante en la app correspondiente. Consulta la guía de integrantes.

La vista en vivo no carga

Asegúrate de haber iniciado sesión con la cuenta de tu familia en ese navegador.

No puedo iniciar sesión tras activar el tablero

Comprueba que hayas verificado tu correo con el enlace que recibiste al registrarte. Si no lo encuentras, entra a /login, intenta iniciar sesión y usa Reenviar correo de verificación.

No llega el correo de verificación o de recuperación

Revisa la carpeta de spam y espera unos minutos. Los enlaces de verificación duran 24 horas; los de recuperación de contraseña, 1 hora. Si caducaron, solicita uno nuevo desde /login (verificación) o /forgot-password (contraseña).

El enlace de verificación o de contraseña no funciona

Puede haber expirado o ya haberse usado. Solicita un correo nuevo siguiendo los pasos de la sección Cuenta y acceso.

Más documentación

Índice completo de guías de usuario: docs/README.md