active-svelte/demos/dating/docs/requisitos.md

Requisitos de Nexo

Roles

Visitante

Usuario no autenticado.

Puede:

• ver la pantalla de entrada;
• registrarse;
• iniciar sesion;
• recuperar acceso;
• cambiar idioma/tema local antes de autenticar.

No puede:

• ver perfiles;
• enviar likes;
• abrir chats;
• acceder a safety center autenticado;
• acceder a moderacion.

Usuario

Usuario autenticado con perfil activo.

Puede:

• completar onboarding;
• editar perfil;
• configurar preferencias de descubrimiento;
• ver perfiles compatibles;
• hacer like/pass;
• chatear con matches;
• bloquear y reportar perfiles;
• gestionar sesion y privacidad.

Usuario limitado

Usuario autenticado con restriccion temporal por moderacion.

Puede:

• ver su perfil;
• gestionar seguridad;
• leer decisiones de moderacion;
• apelar si se implementa el flujo.

No puede:

• enviar likes;
• iniciar conversaciones nuevas;
• aparecer en discover;
• editar campos sensibles si la sancion lo impide.

Moderador

Usuario con permisos de moderacion.

Puede:

• ver reportes;
• revisar contexto limitado;
• ocultar perfiles;
• imponer restricciones;
• resolver reportes;
• dejar notas auditadas.

Admin

Usuario con permisos de administracion.

Puede:

• gestionar roles;
• revisar auditoria;
• cambiar flags de la demo;
• resetear seeds locales;
• abrir devtools completos.

Requisitos funcionales

Autenticacion

• Pagina /dating/login con email, password, recordarme, errores y redireccion.
• Pagina /dating/register con email, password, confirmacion, nombre visible inicial y confirmacion de edad adulta.
• Pagina /dating/reset para recuperacion simulada sin revelar si el email existe.
• Pagina /dating/mfa para challenge MFA simulado.
• Logout desde menu de sesion.
• Sesion persistente.
• Expiracion de sesion y refresh.
• Lista de dispositivos/sesiones activas.

Onboarding

• Flujo por pasos.
• Validacion por schema sium.
• Draft persistente en storage.
• Progreso recuperable tras reload.
• Campos minimos:
  • nombre visible;
  • edad adulta validada;
  • bio;
  • intereses;
  • intencion;
  • ubicacion aproximada;
  • preferencias de descubrimiento;
  • visibilidad del perfil.

Perfil

• Editar datos publicos.
• Subir fotos de perfil a PocketBase desde /dating/profile/photos.
• Gestionar hasta 6 fotos por perfil.
• Reordenar fotos y marcar foto principal.
• Eliminar o reemplazar fotos.
• Validar tipo, tamano y permisos antes de subir.
• Configurar privacidad.
• Configurar idioma, tema, densidad y notificaciones.
• Ver preview publico del perfil.
• Validar cambios antes de guardar.

Discover

• Mostrar perfiles compatibles.
• Filtros por rango de edad, distancia aproximada, intereses e intencion.
• Acciones like/pass.
• Estados empty/loading/error/offline.
• Cache de feed.
• Invalidacion tras like/pass.
• Paginacion o carga incremental.

Matching

• Crear match cuando hay like mutuo.
• Mostrar matches activos, pending, archivados y expirados.
• Expirar matches pendientes mediante timer.
• Emitir eventos de match por bus.
• Orquestar notificacion y cache invalidation con orca.

Chat

• Chat por match.
• Envio online.
• Envio offline con cola local.
• Retry al reconectar.
• Estado de mensaje: pending, sent, delivered, failed.
• Typing indicator simulado.
• Presence simulada.
• Bloqueo corta envio/recepcion.

Safety

• Bloquear usuario.
• Reportar perfil o mensaje.
• Seleccionar motivo.
• Adjuntar contexto fake.
• Confirmacion clara.
• Ocultar perfil reportado/bloqueado.
• Exportacion simulada de datos.
• Borrado de cuenta simulado.

Moderacion

• Bandeja de reportes.
• Filtros por estado, motivo y prioridad.
• Vista de detalle con contexto minimo.
• Acciones: dismiss, warn, restrict, hide profile, ban demo user.
• Notas auditadas.
• Decision visible en audit log.
• Permisos estrictos con perm.

Devtools internos

• Estado de active-app.
• Servicios activos/lazy/disposed.
• Eventos de bus.
• Logs de logger.
• Cache entries.
• Storage namespaces.
• Session state.
• Perm checks recientes.
• Connection state.
• Orca traces.
• Timers activos.

Requisitos no funcionales

• La demo debe funcionar en local sin servicios externos reales.
• Debe tener seed determinista.
• Debe ser testeable con datos estables.
• Debe responder bien en desktop y movil.
• Debe tener estados accesibles para teclado y lector de pantalla.
• Debe evitar datos sensibles reales.
• Debe poder resetearse entre tests.
• Debe evitar coupling entre rutas y componentes publicos.
• Debe trazar errores sin exponer secretos.

Modelo de datos minimo

User

• id
• email
• role
• status
• createdAt
• lastLoginAt

Profile

• id
• userId
• displayName
• age
• bio
• interests
• intent
• approxLocation
• visibility
• photos
• primaryPhoto

Preference

• userId
• ageRange
• distanceKm
• intent
• interests
• theme
• density
• locale
• notifications

Like

• fromUserId
• toUserId
• state
• createdAt

Match

• id
• userIds
• state
• createdAt
• expiresAt

Message

• id
• matchId
• senderId
• body
• state
• createdAt
• clientNonce

Report

• id
• reporterId
• targetUserId
• targetMessageId
• reason
• details
• state
• priority
• createdAt
• resolvedAt
• resolverId

Matriz de permisos inicial

Accion	Visitante	Usuario	Limitado	Moderador	Admin
profile:create	no	si	si	si	si
profile:update:self	no	si	parcial	si	si
profile:photo:add	no	si	no	si	si
profile:photo:delete:self	no	si	parcial	si	si
profile:photo:reorder	no	si	no	si	si
profile:photo:moderate	no	no	no	si	si
discover:view	no	si	no	si	si
match:like	no	si	no	no	si
chat:send	no	si	no	no	si
safety:block	no	si	si	si	si
safety:report	no	si	si	si	si
moderation:view	no	no	no	si	si
moderation:resolve	no	no	no	si	si
admin:roles	no	no	no	no	si
devtools:view	no	limitado	limitado	si	si

Estados de error obligatorios

• Sesion expirada.
• Usuario sin permiso.
• Perfil incompleto.
• Feed sin resultados.
• Cache stale.
• Red offline.
• Reconnect en curso.
• Mensaje pendiente.
• Envio fallido.
• Reporte ya resuelto.
• Usuario bloqueado.
• Servicio lazy fallido.