Opinión — red social de encuestas

Repositorio del MVP. El desarrollo se reanudó el 26-10-2026 (D-013) y se avanza tarea a tarea según docs/orden-ejecucion.md; Codex /root (opinion_social_media) se encarga de Vercel (D-VERCEL-001). Las tareas se reservan y coordinan en el issue #73 (D-043); sus dependencias y las reservas de otros agentes siguen vigentes.

Cómo trabajamos

Ver el flujo de trabajo completo: tareas, agentes, entornos y publicación →

flowchart TB
    accTitle: Flujo de trabajo de Opinión
    accDescr: Las tareas se reservan antes de desarrollar. Las PR verificadas se integran en main. Sólo una versión autorizada pasa a release y se publica en Vercel.
    subgraph DEV["Desarrollo e integración"]
        direction LR
        A["Issue y reserva<br/>en #73"] --> B["Rama de tarea<br/>TDD"]
        B --> C["PR a main<br/>revisión y CI"]
        C --> D["Integrar en main<br/>cerrar tarea e issue"]
    end
    subgraph PUB["Publicación"]
        direction LR
        E{"Versión validada<br/>y autorizada"} --> F["PR a release<br/>merge autorizado"]
        F --> G["Vercel<br/>producción"]
    end
    DEV --> PUB
    classDef work fill:#F9F9FF,stroke:#354861,color:#161E2E;
    classDef gate fill:#FFE1C2,stroke:#A64B00,color:#161E2E;
    classDef production fill:#161E2E,stroke:#B4C8F5,color:#F9F9FF;
    class A,B,C,D work;
    class E,F gate;
    class G production;
    style DEV fill:#F9F9FF,stroke:#B4C8F5,color:#161E2E;
    style PUB fill:#F9F9FF,stroke:#B4C8F5,color:#161E2E;

Desarrollo en dev; pruebas automáticas en Supabase/PostgreSQL efímeros locales o de CI. main no despliega la web. Vercel sólo publica release; las previews están desactivadas. El registro de tareas y el canal de agentes #73 muestran el trabajo y los bloqueos actuales.

Documentación

• Diagrama y flujo de trabajo
• Índice y forma de trabajar
• Contexto de producto
• Dirección creativa vigente: After Sunset · Sistema de diseño
• Arquitectura y contratos previstos
• Brief de producto consolidado
• Backlog revisado: 53 tareas y criterios de aceptación
• Cobertura de las 27 agrupaciones y 16 casos límite
• Épicas y tareas en GitHub Issues
• Backlog importable JSON · CSV
• Plan de trabajo y estado de las tareas
• Auditoría de cobertura y tareas añadidas · Backlog adicional
• Prioridades, orden recomendado y siguiente tarea
• Accesos, recursos creados y verificaciones
• Supabase: conexión de colaboradores y agentes

Stack y arquitectura

• Next.js 16 (App Router, cacheComponents), React 19 y TypeScript estricto; Tailwind CSS 4. Next 16 cambia APIs respecto a versiones anteriores: leer node_modules/next/dist/docs/ antes de tocar convenciones (p. ej. middleware pasó a proxy).
• Supabase (PostgreSQL, Auth con Google, RLS). La autorización vive en la base de datos: ningún usuario, tampoco el autor, obtiene agregados de una encuesta antes de votar. Contratos en arquitectura y contratos-api; permisos de las RPC en seguridad-rpc.
• Vercel para despliegue; Vitest + Testing Library para pruebas; GitHub Actions como CI.

Flujo de datos: los Server Components y las Server Actions leen y escriben con el cliente de src/lib/supabase/server.ts (sesión en cookies); el navegador usa client.ts. src/proxy.ts renueva la sesión en cada petición, /auth/callback canjea el código de Google y /login ofrece el acceso. Toda la lógica de datos pasa por los adaptadores de src/lib/data/operations.ts, que devuelven Result<T> y nunca lanzan.

Desarrollo local

Requiere Node.js 22 (o ≥ 20.9) y npm. No hace falta Docker salvo para los tests de base de datos, de ataques y E2E (ver más abajo).

cp .env.example .env.local   # y completar la Publishable key de desarrollo (docs/entornos.md)
npm ci                       # instala dependencias exactas del lockfile
npm run check:env            # comprueba que .env.local apunta al Supabase de desarrollo
npm run dev                  # http://localhost:3000
npm run check                # lo que debe pasar antes de subir cambios

Variables de entorno

Sólo hay dos, ambas públicas por diseño (la seguridad la imponen RLS y las RPC):

Variable	Valor
NEXT_PUBLIC_SUPABASE_URL	URL del proyecto Supabase del entorno
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY	Publishable key (sb_publishable_…) del mismo proyecto

Desarrollo local y pruebas manuales alojadas usan opinion-social-media-dev; las suites automáticas usan Supabase/PostgreSQL efímeros en localhost, también en CI. Producción usa opinion-social-media-prod. Preview conserva configuración de dev, pero los despliegues de preview están desactivados. Nunca se guardan en Git claves secretas, service_role ni contraseñas: ver entornos y acceso a Supabase.

This is the beginning of the README. Read the rest at the original. Read the full README ↗