Saltar al contenido
Banco de tareas

ARQ-024ArquitecturaImportante

Ordenar Supabase y dibujar el flujo de datos y de agentes

Dificultad
Avanzada
Estimación
2d
Estado
Abierta
Habilidades
postgressupabasearquitectura

Zona sensible. Toca permisos, datos personales, el mapa, secretos o la identidad de marca. Necesita revisión de la titular y conviene haber completado alguna tarea antes.

Contexto

Desde el 6-oct-2026, la app usa un Supabase real en la UE. Las tablas, las funciones y los agentes (dumonde, las especialistas, el vecina paper y el radar) han ido creciendo fase a fase, y no hay ningún dibujo de qué dato va adónde, quién lo toca y cuánto vive. Sin ese mapa es difícil escalar, pasar la revisión de privacidad (DAT-007) o enseñar a una asociación cómo funciona por dentro.

Qué hacer

  1. Inventario: tablas, vistas, funciones y roles por dominio (mapa, buzón, comunidad, perfiles, acampada, parlamento), con quién lee, quién escribe y cuánto tiempo se guarda cada cosa.
  2. Diagrama del flujo: navegador → /api/* → rol dumonde_servidor → Postgres; navegador → PostgREST con anon o con sesión; agentes de IA con su presupuesto compartido (interno.reservar_dumonde).
  3. Separar entornos: un proyecto de Supabase de pruebas además del de producción, con el mismo npm run db:aplicar.
  4. Revisar en el panel de Supabase lo que no está en el código (extensiones, pg_cron, Auth, copias) y documentarlo en docs/guias/desplegar.md.
  5. Lista de mejoras priorizadas como tareas nuevas: índices, purgas, vistas agregadas, cachés y agentes que puedan compartir contexto.

Criterios de aceptación

  • docs/arquitectura/DATOS.md con el inventario y el diagrama (Mermaid).

  • Cada tabla tiene responsable, finalidad y plazo de conservación.

  • Existe un proyecto de pruebas y está documentado cómo se usa.

  • Las mejoras detectadas están en el banco de tareas.

Archivos

¿Te la quedas?

  1. 1. Haz un fork y crea la rama tarea/ARQ-024-ordenar-supabase-y-dibujar-el-flujo-de-d.
  2. 2. En tareas/arquitectura/ARQ-024-ordenar-supabase-y-dibujar-el-flujo-de-datos-y-ag.md, cambia la cabecera:
    estado: reservada
    asignada: tu_usuario_de_github
  3. 3. Abre un PR con ese cambio (commit firmado: git commit -s). Al fusionarse, es tuya durante 14 días.

Todo lo demás