00-day-brief.md

00 — Day brief · 2026-08-23 · ONDA

Sustituye a RELEVO (retirado: no gustó el feed de recogidas).

Decisiones ALS-2 BRIEF

Terna unicidad

R-HY · S-RAIL · H-GALLERY · F-SEARCH

0 códigos iguales a N−1 (RAMAL: R-CL · S-SPLIT · H-FULL · F-ONB).
≥2 distintos vs N−2 (TEMPLE) y N−3 (PREGÓN).

S-RAIL, H-GALLERY y F-SEARCH no están en los últimos 5.

Ground (CRON §5.6)

• Familia: G-SIGN (papel de cartel, no hielo, no asfalto)
• Hex: #FFFFFF
• Por qué: la radio de barrio se lee como un cartel en la portería. El acento es amarillo de cinta aislante, no el fondo.

Mood visual (Paper)

• Candidatos: nocturnal/phosphor (primer instinto radio), signage, rusted, mineral, chapel
• Elegido: signage — no el primer instinto estudio negro. Una onda se pega en el cristal con cinta amarilla.
• Paleta:
  • #FFFFFF papel de cartel (ground)
  • #111111 tinta de rotulador
  • #E6C200 cinta aislante / chrome yellow (mark, poco)
  • #5C5C5C mute
  • #C41E3A sello de «en antena» (poco)
  • #F3F3F3 rail
• Tipo: DM Serif Display · IBM Plex Sans

Alcance L1 must

1. Home galería: 4 programas (lead + 3 visibles)
2. Buscar en archivo (query + resultados)
3. Ficha de programa (título, hora, estado)
4. Pedir repetición (pedir ≠ reservar estudio)
5. Login JWT CONDUCTOR
6. Mesa de hoy (lista, no kanban)
7. Empty / error / loading / mobile gallery
8. ≥12 UX + ≥10 UI

Microcopy duro

• Onda ≠ playlist. No hay cola de Spotify.
• Pedir repetición ≠ reservar estudio. No se apunta un slot de grabación.
• ONDA no es la SER. No sustituye a una emisora nacional.
• Escuchar ≠ suscribirse. Pedir no crea una cuenta de oyente.

Supuestos

• S1: Una emisora atiende 2–4 programas/día; la demo tiene 4 (1 EN_ANTENA, 1 PROGRAMADO, 2 ARCHIVO).
• S2: Iker busca «patio» sin cuenta. JWT solo para la mesa.
• S3: Nerea conduce. Pilar (técnica de antena) está fuera del producto.
• S4: Sin streaming embebido, sin chat, sin calendario semanal. [DECISIÓN]

Hipótesis

00-paper-reference.md

Paper reference · ONDA

UX-count: 12 UI-count: 12

UX-00 Cover · UX-01 Stakeholders · UX-02 Personas · UX-03 JTBD · UX-04 Stories · UX-05 Journey · UX-06 Blueprint · UX-07 Site map · UX-08 Flujos · UX-09 Datos+permisos · UX-10 Métricas · UX-11 Research UI-00 Tokens · UI-01 Gallery · UI-02 Gallery mobile · UI-03 Search · UI-04 Programa · UI-05 Programa mobile · UI-06 Success · UI-07 Login · UI-08 Mesa hoy · UI-09 Empty · UI-10 Error · UI-11 Loading

UX process (prefijo UX- · mínimo 12)

UI producto (prefijo UI- · mínimo 10)

Mapeo Paper → Angular

01-project-definition.md

01 — Definición de proyecto — ONDA

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.
[SUPUESTO de catálogo] Carabanchel / Patio 17 / Mercado Usera es atrezzo de mercado, no la parrilla de una emisora real.

Este case sustituye a RELEVO (retirado: no gustó el feed de recogidas). RELEVO no es N−1: N−1 es RAMAL. RELEVO se cita solo como anti-patrón. [DECISIÓN]

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] El oyente de Carabanchel no necesita una app de streaming: necesita saber qué suena hoy y pedir que se repita un programa sin el grupo de WhatsApp. Hoy eso vive en un cartel de portería, un audio de voz y una expectativa de playlist. La galería se lee como Spotify; pedir repetición se lee como reservar el estudio; el producto se lee como la SER. [SUPUESTO] Una emisora atiende 2–4 programas/día; no opera un streaming embebido ni un chat de oyentes.

Secundarios

Supuestos (no investigación primaria propia)

• S1: Una emisora atiende 2–4 programas/día; la demo tiene 4 (1 EN_ANTENA, 1 PROGRAMADO, 2 ARCHIVO). [SUPUESTO]
• S2: Iker busca «patio» sin cuenta. JWT solo para la mesa. [SUPUESTO]
• S3: Nerea conduce. Pilar (técnica de antena) está fuera del producto. [SUPUESTO]
• S4: Sin streaming embebido, sin chat, sin calendario semanal. [DECISIÓN]

Hipótesis de producto

No se afirman estadísticas de radio comunitaria inventadas. Todo lo anterior es razonamiento de diseño etiquetado.

3. Propuesta de valor

No es ONDA

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L1 radio comunitaria / archivo con Programa + repetición + JWT CONDUCTOR.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable.
• Terna R-HY · S-RAIL · H-GALLERY · F-SEARCH frente a RAMAL (split/portada/alta), TEMPLE (kiosk/horas) y RELEVO retirado (dock/feed/relato).
• Sustituir RELEVO en el mismo día: el contrato vivo es ONDA, no un leftover de recogidas.

Usuario

No objetivos v1 (explícitos)

• Streaming, player, podcast embed, radio en vivo embebida
• Playlist, cola, shuffle, suscripción de oyente
• Reserva de estudio, slot de grabación, cuadrante de Pilar
• Chat, kanban, columnas Recibido / En curso
• Cuenta de oyente, seguimiento con login, push
• Parrilla semanal, EPG, calendario
• Multi-emisora, multi-conductor
• App nativa ni notificaciones push
• Rol TÉCNICA autenticado
• Feed de recogidas, familias, cole (RELEVO retirado)
• Nodos, altas, vocal (RAMAL es otro día)

5. Roles y permisos (resumen)

[DECISIÓN] Un solo rol autenticado: CONDUCTOR. El oyente no es un usuario del sistema: es autor/autora de una repeticion. La técnica no es un rol de sistema el día 1.

6. Métricas (modelo, no instrumentadas en v1 salvo base)

7. Alcance funcional v1 (L1)

8. Criterios de aceptación de producto

1. / es la galería de 4 cubiertas (lead + 3). No pide cuenta. No es un hero 2-col + 3 cards. No es un feed.
2. Un oyente puede ver 4 programas en el recorte 16/10 (lead + 3), tocar Patio 17, pedir repetición y obtener acuse en /ok/ON-2301.
3. /ok/:code dice explícitamente que pedir repetición no es reservar estudio y que Onda no es playlist.
4. La UI dice explícitamente que ONDA no es la SER y que escuchar no es suscribirse.
5. Sin token, GET /api/hoy responde 401. POST /api/programas/:code/repetir y GET /api/programas son públicos.
6. Un POST de repetición no crea user, no reserva un slot, no abre un player.
7. Un CONDUCTOR inicia sesión y ve 4 programas (Patio 17 EN_ANTENA, Voces PROGRAMADO, dos ARCHIVO) en el seed.
8. El tablero es una lista de hoy. No es un kanban de 3 columnas. No es un split lista | ficha.
9. Fotos reales en las cubiertas seed (assets programas/*).
10. Chrome S-RAIL: Estudio / Buscar / Hoy. Galería pública sin top-nav de marketing.
11. Rutas solo las del doc 03. No existen /nodos, /alta, /mesa, /relevo, /recoger, /playlist, /directo.
12. GET /api/health devuelve service: "onda-api" (no relevo-api, no ramal-api).
13. La galería no muestra nombres de otros oyentes; la mesa sí puede mostrar recuento de peticiones.
14. /buscar?q=patio devuelve Patio 17.

9. Stack y artefactos

[COMPROBADO] Puerto, Neon, Paper file ID y path de app constan en el encargo.
El código se escribe en paralelo a esta suite. Este doc es el contrato. No se espera al rewrite.

10. Riesgos y mitigaciones

11. Glosario

12. Decisiones de diseño (cierre de brief)

13. Relación con el día anterior

[COMPROBADO] El brief fija terna R-HY · S-RAIL · H-GALLERY · F-SEARCH. 0 códigos iguales a N−1 (RAMAL). ≥2 distintos vs N−2 (TEMPLE) y N−3 (PREGÓN). S-RAIL, H-GALLERY y F-SEARCH no están en los últimos 5. Ventana 4 días: R-IN (PREGÓN) + R-HY (TEMPLE) + R-CL (RAMAL) + R-HY. Ground G-SIGN #FFFFFF, no G-ICE ni G-WATER.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — ONDA

Importante: este documento contiene artefactos de diseño y razonamiento secundario.
No hay entrevistas de campo primarias ni estadísticas inventadas presentadas como dato medido.
Etiquetas: [COMPROBADO] en producto, [SUPUESTO], [HIPÓTESIS], [DECISIÓN].

1. Objetivos de investigación (del caso)

2. Fuentes y límites

Fuentes admisibles (secundarias / operativas)

• Conocimiento general de radios comunitarias de barrio (cartel en portería, programa de patio, archivo en cinta, conductora que no es una cadena, técnica de antena que no entra el día 1).
• Analogía operativa con superficie pública + panel JWT de la serie daily.
• Restricciones ALS-2: no Spotify, no la SER, no chat, no kanban, no kiosk de horas, no nodos/altas, no feed de recogidas (RELEVO retirado).

Límites éticos de verdad

3. Stakeholders

Mapa de poder (resumen)

• Decisor de adopción: la emisora (quién pone el cartel) y, en uso diario, Nerea (quien mira el hoy).
• Usuario frecuente de pedir repetición: OYENTE (galería + búsqueda + ficha, sin cuenta).
• Usuario frecuente de oficio: CONDUCTOR (mesa /hoy).
• Riesgo de rechazo: si el acuse parece una reserva de estudio; si la cubierta parece un track; si hay que crear cuenta; si la mesa parece un kanban; si el rail parece un dock de recogidas.

4. Personas

P1 — Nerea Gil · CONDUCTOR

Escenario: Entra a /login, abre /hoy, lee ON-2301 Patio 17 EN_ANTENA, ve el recuento de repeticiones. El copy dice que una petición no reserva el estudio.

[COMPROBADO] Nombre, edad, email demo y rol salen del encargo.

P2 — Iker Soto · OYENTE

Escenario: Abre / en el portal, ve la cubierta de Patio 17 EN_ANTENA, o busca «patio» en /buscar, toca la ficha, lee «pedir ≠ reservar estudio» y el código ON-2301.

[COMPROBADO] Nombre, edad y gesto (oyente, 52) salen del encargo. Es constructo de diseño, no entrevistado. [DECISIÓN]
En el seed Iker también aparece como conductor de Mercado Usera (archivo). Eso no le da login: sigue sin fila en users. [DECISIÓN]

P3 — Pilar Ruiz · TÉCNICA (docs)

[COMPROBADO] Nombre, edad y exclusión de login salen del encargo. [DECISIÓN] no hay cuenta TÉCNICA en v1.
En el seed aparece como conductora de Banda municipal con la marca (fuera).

5. JTBD

Job principal (oyente)

Cuando quiero saber qué suena esta tarde, quiero encontrar el programa y pedir la repetición sin el grupo, para dejar constancia en la emisora sin que eso signifique playlist, cuenta ni reserva de estudio.

Job principal (conductora)

Cuando hay programas hoy y peticiones nuevas, quiero ver la lista de hoy, para mover el oficio de la emisora sin un kanban ni un player.

Jobs que ONDA no hace

6. Stories Must (v1)

Could (fuera de L1): login de Pilar, streaming, parrilla semanal, chat, cuenta de oyente, player.

7. Journey (resumen)

1. Iker abre /. Ve 4 cubiertas. Lead Patio 17 EN_ANTENA. [H1]
2. Toca Patio 17 → /programa/ON-2301. (O busca «patio» en /buscar.)
3. Lee hora 17:00, estado En antena, conductora Nerea. Copy irrenunciable.
4. POST repetición → /ok/ON-2301. Lee las cuatro oposiciones.
5. Nerea entra a /login → /hoy. Lista de hoy.
6. Lee ON-2301 EN_ANTENA y el recuento. Copy: pedir no reserva el estudio.

Backstage: Nest + Neon + JWT. Pilar no entra. La antena no se mueve. No hay player.

8. Blueprint (resumen)

9. Matriz hallazgo → requisito → feature

10. Preguntas que este case no responde

• ¿Cuántas repeticiones reales hay en Carabanchel en 2026?
• ¿Qué emisora opera un micro en Patio 17?
• ¿Iker preferiría WhatsApp?
• ¿Pilar necesita un cuadrante de antena?
• ¿Nerea serviría la repetición en 48 h de verdad?

Esas preguntas piden campo. Aquí hay un vertical slice de diseño, no un estudio.

11. Cierre

Investigación = modelado etiquetado + restricciones ALS-2.
No hay entrevistas inventadas.
Las personas son constructos. Carabanchel / Patio 17 / Mercado Usera son [SUPUESTO de catálogo].
RELEVO no se investiga: está retirado.

03-information-architecture.md

03 — Arquitectura de información — ONDA

1. Principios de IA

2. Sitemap

/                                      Galería pública (4 cubiertas)                 H-GALLERY
/buscar                                Archivo · query + resultados                  F-SEARCH · público
/programa/:code                        Ficha de programa                             público
/ok/:code                              Acuse post-repetición                         público
/login                                 Login JWT CONDUCTOR                           público
/hoy                                   Lista de hoy                                  auth
/**                                    → redirect /

Árbol por audiencia

[COMPROBADO] Seis rutas del encargo L1. No se inventan /nodos, /alta, /mesa, /relevo, /recoger, /playlist, /directo, /estudio-reserva.

La búsqueda sí es ruta (/buscar): el archivo se busca; la home sigue siendo galería. [DECISIÓN]
La ficha sí es ruta (/programa/:code) porque F-SEARCH y la galería necesitan URL compartible. [DECISIÓN]
/ok/:code usa el código de programa (ON-2301), no un código de petición distinto. L1 compacto. [DECISIÓN]

3. Navegación

Rail (S-RAIL · todas las superficies salvo login/ok pueden mostrarlo)

[DECISIÓN] El rail es la navegación primaria. Tres destinos: encaja L1 compacto. No hay top-nav de 7 ítems, no dock flotante (RELEVO), no split (RAMAL), no kiosk mínimo (TEMPLE).

Desktop ≥960px: rail vertical izquierdo (~56–72px, ground #F3F3F3) + panel.
Mobile ~390px: rail inferior de tres slots; la galería se apila. [DECISIÓN] En 390 el rail no compite con un hamburger.

Galería pública (H-GALLERY)

[DECISIÓN] La galería no tiene tabs de marketing, no tiene «Directo / Podcasts / Suscríbete». El rail basta.

Chrome de ficha y búsqueda (F-SEARCH)

Chrome de mesa (/hoy autenticado)

[DECISIÓN] No hay S-SPLIT (RAMAL). No hay kanban (PREGÓN). No hay /hoy/:code: L1 lee la lista. Could L+1: ficha de petición.

4. Etiquetas de IA (UI)

En docs puede decirse «mesa» para el oficio JWT. En UI el slot se llama Hoy. [DECISIÓN]

5. Contenido de cada nodo de IA

6. Error / empty / loading (sitio)

Viven en las mismas rutas, no en URLs extra.

7. Profundidad y búsqueda

La búsqueda sí es Must (F-SEARCH). 4 programas caben en galería; el archivo se demuestra con q=patio → Patio 17. [DECISIÓN]
Nerea no filtra la mesa en v1: ve el hoy entero. Could L+1: filtro por estado.

Query: min 1 carácter tras submit o debounce; case-insensitive sobre title, host, code, lead. Vacío en /buscar sin q muestra prompt, no los 4 (eso es la galería). [DECISIÓN]

8. Códigos y URLs

API puede normalizar on-2301 → ON-2301. En UI siempre versales.

9. Lo que no entra en el mapa

/nodos, /alta, /mesa, /mesa/:code, /relevo, /recoger, /playlist, /directo, /epg, /estudio/:slot, /inbox, /kanban.
Si el rewrite de onda-app todavía tiene esas rutas, no son el producto. Gana este doc.

04-user-flows.md

04 — Flujos de usuario — ONDA

1. Convenciones

2. F1 — Oyente pide repetición desde la galería (Must)

/  →  GET /api/programas
   →  tap cubierta Patio 17  →  /programa/ON-2301
   →  GET /api/programas/ON-2301
   →  tap Pedir repetición
   →  POST /api/programas/ON-2301/repetir
   →  201 { code: ON-2301, title, statusPedida: true }
   →  /ok/ON-2301

Entrada: galería, sin cuenta.
Salida: código visible + copy «pedir ≠ reservar estudio».
Errores: red (reintentar), 404 programa, 0 programas (empty).

AC

• El CTA no pide email ni signup.
• POST no cobra, no crea user, no reserva slot, no abre player.
• /ok/ON-2301 muestra las cuatro oposiciones.

3. F2 — Oyente busca en archivo (Must)

/buscar  →  escribe «patio»  →  GET /api/programas?q=patio
         →  resultados (Patio 17)
         →  tap  →  /programa/ON-2301
         →  (sigue F1 desde la ficha)

Entrada: rail Buscar, sin cuenta.
Salida: al menos Patio 17 para q=patio.
Errores: q=zzzz → empty «Sin resultados.»; red → UI-10.

AC

• Home sigue siendo galería. /buscar no redirige a / con un hero.
• Query visible en el campo. Compartible /buscar?q=patio.
• Cero facetas de distrito / precio (eso fue PIZARRA).

4. F3 — Conductora entra a hoy (Must)

/login  →  POST /api/auth/login
        →  JWT CONDUCTOR
        →  /hoy
        →  GET /api/hoy

AC

• Sin token, /hoy redirige a /login?next=/hoy.
• GET /api/hoy sin Bearer → 401.
• Lista de hoy: 4 filas. EN_ANTENA primero. No columnas Recibido / En curso.
• Desktop: lista en el panel del rail. 390: lista a pantalla bajo el rail inferior.

5. F4 — Estados de sistema

6. Flujos que no existen

7. Tiempos de demo (modelo)

No son KPIs medidos. Son techos de diseño para el guión. [HIPÓTESIS]

8. Guión de demo canónico

1. / — lead Patio 17 + 3 cubiertas. Eslogan. Rail.
2. Tap Patio 17 — ficha EN_ANTENA · 17:00 · Nerea.
3. Pedir repetición — /ok/ON-2301. Copy ×4.
4. /buscar?q=patio — un resultado.
5. /login — nerea@onda.radio / password123.
6. /hoy — lista; ON-2301 En antena; recuento ≥1 si se hizo el POST.
7. 390: cubiertas apiladas, no carousel.
8. API down: error + Reintentar.

9. Contratos de error de API (flujo)

05-data-model.md

05 — Modelo de datos — ONDA

1. Visión general

Dominio L1 de galería de programas + archivo + mesa autenticada:

Base: PostgreSQL (Neon project falling-fog-92644546) · IDs: serial + texto estable (ON-2301).
[DECISIÓN] ensureSchema es válido si el contrato de tablas se cumple; el brief de stack no exige Prisma.

Contrato de producto: programas + repeticiones + JWT CONDUCTOR.
No nodes / altas / relevos / rooms / bookings.

2. Enums (aplicación; persistidos como TEXT + check)

Role

ProgramaStatus

Pedir repetición está permitido en los tres estados: «otra vez» no es reserva. [DECISIÓN]

3. Diagrama ER (texto)

users
  id, email, password_hash, name, role(CONDUCTOR)
  created_at
  1 ──< sessions

sessions
  id, user_id → users
  expires_at, revoked_at
  created_at

programas
  id
  code (unique, ON-XXXX)
  title, lead
  status (EN_ANTENA|PROGRAMADO|ARCHIVO)
  hour (TEXT, HH:MM)
  host_name
  cover
  sort_order
  created_at, updated_at
  1 ──< repeticiones

repeticiones
  id
  programa_id → programas
  created_at

v1: una sola CONDUCTOR opera sobre el conjunto global.
No hay FK de oyente-usuario: el oyente no se loguea.
repeticiones no apunta a users: la petición es anónima de cuenta.

4. Tablas

users

sessions

programas

repeticiones

Sin listener_name, sin email, sin teléfono. Escuchar ≠ suscribirse. [DECISIÓN]

Índices: programas(code), programas(status), programas(sort_order), users(email), repeticiones(programa_id), repeticiones(created_at DESC).

Búsqueda q: ILIKE sobre title, host_name, code, lead. Trigram Could L+1; 4 filas no lo necesitan.

5. Seed

CONDUCTOR

nerea@onda.radio / password123 · Nerea Gil · CONDUCTOR
Hash bcrypt fijo: $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m

Programas

[SUPUESTO de catálogo] Títulos, leads y horas son atrezzo. No es una parrilla oficial.

Repeticiones

Seed sin filas de repetición. El POST de smoke crea la primera sobre ON-2301.
Nerea puede ver repeatCount: 0 al entrar en frío y ≥1 tras el guión.

6. JSON (camelCase)

API: hostName, sortOrder, createdAt, repeatCount, cover, hour, status, title, code, lead.
SQL: host_name, sort_order, created_at.

GET /api/programas (item)

{
  "code": "ON-2301",
  "title": "Patio 17",
  "lead": "El patio cuenta lo que el bloque no pone en el tablón.",
  "status": "EN_ANTENA",
  "hour": "17:00",
  "hostName": "Nerea",
  "cover": "/assets/programas/micro.jpg",
  "sortOrder": 1
}

Lista pública: no incluye repeatCount (evita enumerar demanda). [DECISIÓN]

GET /api/hoy (item, JWT)

Igual + "repeatCount": 0. Orden: EN_ANTENA, PROGRAMADO, ARCHIVO, luego hour.

POST /api/programas/:code/repetir → 201

{
  "code": "ON-2301",
  "title": "Patio 17",
  "status": "EN_ANTENA",
  "hour": "17:00",
  "hostName": "Nerea",
  "pedida": true
}

Cuerpo de entrada: {} vacío. No nombre, no email.

7. Generador de código

Los códigos de programa son de catálogo, no se generan en el POST de repetición. Seed ON-2301…ON-2304. L+1 que añada programas usa ON- + 4 dígitos correlativos; no es Must.

El acuse reutiliza el code del programa. No hay ON-R-…. [DECISIÓN]

8. Qué no se modela

06-tech-stack.md

06 — Stack tecnológico — ONDA

1. Visión

Stack fijo del cron (D-P0-03). No React/Next/Firebase.
[COMPROBADO] Puerto 3023, Neon, Paper y path de app constan en el encargo.

El código se escribe en paralelo a esta suite. Si el repo todavía contiene leftover RAMAL (nodes, altas, VOCAL) o leftover RELEVO (relevo-api, TUTOR), no es el estado del producto. Gana el contrato ONDA.

2. Estructura

onda-app/
├── apps/api/     # Nest (paquete independiente)
├── apps/web/     # Angular + Tailwind (paquete independiente)
└── package.json  # scripts api / start · apps independientes

D-P1-03: pnpm --filter. Prohibido npm workspaces que rompen Angular (AP-06).

Scripts raíz esperados:

3. API pública vs JWT

CORS: origen http://localhost:4200 en local.

[COMPROBADO] Superficie de dominio del encargo: programas, ?q=, :code, repetir, /hoy JWT. Health y login son el contrato de stack de la serie.
No se añaden Must extra (/nodos, /altas, /relevos, /directo).

Health: leftover relevo-api → onda-api. Puerto leftover de RELEVO :3023 se reutiliza a propósito (mismo día, producto distinto). [DECISIÓN]

4. Justificación

5. Variables

.env local (nunca git):

URI canónica (demo local, no commitear en frontend):

postgresql://neondb_owner:npg_ZYutTBi1PQW0@ep-lively-bread-avlpx7l2-pooler.c-11.us-east-1.aws.neon.tech/neondb?sslmode=require

Región: c-11.us-east-1 · pooler · sslmode=require.
.env.example solo placeholders.
Web: URL de API en ApiService (default http://localhost:3023/api). Proxy Angular proxy.conf.json → :3023.

6. Módulos API

health · auth · users · programas · hoy · database · common.

Health: HealthService.name = 'onda-api'.
main.ts PORT default 3023.

No módulos nodes, altas, mesa, relevos. Si el rewrite los encuentra, se borran o se sustituyen. [DECISIÓN]

7. Frontend

Páginas: GalleryPage / · SearchPage /buscar · ProgramaPage /programa/:code · OkPage /ok/:code · LoginPage /login · HoyPage /hoy.

Guard JWT en /hoy. Interceptor Bearer. Token key onda.accessToken.

8. Lo que el stack no es

No es un player. No es Spotify. No es la SER. No es Prisma obligatorio.
No es un leftover de nodos/altas: el contrato es programas + repeticiones + CONDUCTOR.
No es un leftover de recogidas: health no dice relevo-api.

07-creative-direction.md

07 — Dirección creativa — ONDA

1. Concepto

ONDA es un cartel de portería con cinta aislante amarilla: se entra a cuatro cubiertas y se sale habiendo pedido una repetición, no una landing de «tu radio». El ground es papel. El amarillo es la cinta, poco. El sello rojo dice en antena, poco.

Mood elegido: signage.
Primer instinto descartado: nocturnal / phosphor (estudio negro). Una onda se pega en el cristal con cinta amarilla, no se ve desde un mixer a oscuras.

[COMPROBADO] Mood, ground y paleta salen de docs/00-day-brief.md.

2. Territorio visual

3. Paleta

Jerarquía de color: el papel carga; la cinta puntúa; el sello marca en antena. Si el mark pinta fondos enteros, deja de ser cinta y se vuelve «brand amarillo». El seal no decora el rail: solo puntual (EN_ANTENA, error). El texto sobre mark es ink, nunca mute. [DECISIÓN]

Candidatos de mood descartados: nocturnal/phosphor (primer instinto radio), rusted, mineral, chapel.

4. Tipografía

Prohibido: DM Serif Display por debajo de 18px (se rompe). IBM Plex Sans en el wordmark de galería (se vuelve SaaS). Mark como color de texto de párrafo (contraste).

Fuentes vetadas de la serie reciente: Newsreader / Figtree / Fraunces / Atkinson Hyperlegible / Ibarra Real Nova / Jost / Libre Baskerville / Nunito / Instrument Serif / Sora / Cormorant / Public Sans / Spectral / Manrope / Zilla / Mulish / Outfit / Lora / Karla.

5. Fotografía

Alt: programa + objeto, no «imagen1». Ver doc 09.

La cubierta de ON-2302 y ON-2304 comparte cinta.jpg (archivo). El lead y el título distinguen. [COMPROBADO] en seed.

6. Registro R-HY

Lookbook de cubiertas (clásico de cartel) + herramienta de archivo (búsqueda y mesa). No es un dashboard de radio. No es un kiosk de horas. No es un feed de recogidas. No es un estudio negro.

La innovación está en H-GALLERY + S-RAIL + F-SEARCH, no en un look «radio phosphor». [DECISIÓN]

7. Anti-moods

8. Densidad (AP-21)

En el recorte 16/10 de galería: eslogan + lead (Patio 17) + 3 cubiertas con hora, host y estado visibles sin hover. Headline huérfano + foto = card hueca. [COMPROBADO] CRON §5.8.

08-design-system.md

08 — Sistema de diseño — ONDA

1. Tokens

Tailwind: bg-ground, text-ink, bg-mark, text-mute, text-seal, bg-rail, font-display.
No hay token --card distinto: la cubierta vive sobre papel; un filete ink/10 o mark basta. Si hace falta superficie de form, bg-ground + borde. [DECISIÓN]

2. Escala de tipo

3. Componentes

Cubierta de programa (galería)

Foto 16/10 recortada + hora · host + título + lead + estado. Toda la card es el hit. Destino /programa/:code. Lead (Patio 17) ocupa el primer slot, más ancha en 1440.

Resultado de archivo (buscar)

Misma anatomía en fila: thumb 16/10 + título + hora + host + estado. Hit → ficha.

Ficha de programa

Cubierta, título display, dl hora/host/estado, bloque de copy irrenunciable, CTA Pedir repetición (ink sobre mark).

Acuse

Código DM Serif enorme + bloque mark con título y hora + 4 oposiciones en mute.

Fila de hoy

Código · status · título · hora · host · recuento. Sin acciones PATCH en v1.

Login

Wordmark + dos inputs + CTA mark. Ayuda mute con demo.

Rail (S-RAIL)

Tres slots: Estudio · Buscar · Hoy. Icono + label. Activo: filete mark 2px. Fondo --rail. Hoy guest → login.

Skeleton

animate-pulse bg-rail. aria-busy.

Error

Titular display + cuerpo mute + Reintentar mark.

Sello EN_ANTENA

Texto «En antena» + seal. Nunca solo el color. Poco: un sello por vista, no un header rojo.

4. Layouts

Max page 1440px. Padding 20 / 40 / 48.

5. Estados de control

6. Iconografía

Cero iconos decorativos de «play / auriculares / antena 5G / mochila escolar». El oficio es tipográfico + foto + cinta. Rail: tres pictogramas mínimos (estudio / lupa / lista), stroke ink, 24px, no pack de color. [DECISIÓN]

7. Motion

120–160ms ease-out. Reduced motion: 0ms. Skeletons pulse; no spinners de cadena ni de player.

8. Densidad (AP-21)

En el recorte 16/10 de galería: eslogan + lead + 3 cubiertas con hora, host y estado. [COMPROBADO] CRON §5.8.

9. Contraste de cinta

#E6C200 sobre #FFFFFF no es texto. CTA = text-ink sobre bg-mark. Meta = mute o ink sobre ground. Seal sobre ground ≥ 4.5:1 para el rótulo «En antena» (el sello lleva texto, no solo círculo).

09-content-guide.md

09 — Guía de contenido — ONDA

1. Voz

Cercana de portería y de mesa. Tuteo en UI al oyente. Segunda persona cuando la interfaz habla. Tercera cuando habla el hoy (Patio 17 ocupa…).

Sin jerga de cadena («tu parrilla», «directo nacional», «suscríbete»). Sin player. Sin «reserva tu slot». Sin sirena. Sin kanban en UI. Sin recogida escolar.

El producto se mira y se pide. No vende playlist, no es la SER, no reserva el estudio, no crea cuenta.

2. Palabras permitidas / prohibidas

«Kanban», «F-SEARCH» y «H-GALLERY» son lenguaje de diseño, no de UI: Iker no lee «search pattern»; Nerea lee En antena / Programado / Archivo.

«Estudio» en el rail es la galería. Si hay ambigüedad en ficha, no usar «estudio» como CTA. [DECISIÓN]

3. Microcopy duro (literales irrenunciables)

El brief fija oposiciones. Aparecen donde el usuario puede confundirse.

[DECISIÓN] Los cuatro textos son obligatorios en UI. No se diluyen a un tooltip.
Pie de galería puede condensar dos en dos líneas; acuse muestra los cuatro.

4. Microcopy por superficie

5. Programas seed (tono)

Los programas demo se escriben como emisiones de barrio, no como ficha de cadena ni como anuncio de Spotify.

No inventar declaraciones de oyentes reales. Si hay una voz, es de persona de diseño etiquetada.

En ARCHIVO no se reescribe a «ya está en Spotify». El cierre es el estado. [DECISIÓN]

6. Nombres propios del seed

No inventar CIF de emisora, frecuencia de dial, ni streaming real como si fuera el producto. [SUPUESTO de catálogo demo]
Carabanchel / Usera son topónimos reconocibles, no un inventario oficial de una radio 2026.

7. Tono por estado

La app no envía esos mensajes al oyente en v1. El copy solo prepara el habla. No hay email de «ya está en el aire».

8. Capitalización y números

• Wordmark: ONDA en versales DM Serif Display.
• Código: ON-2301 (ON versales, guion, 4 dígitos).
• Nombres: Nerea Gil, Iker Soto, Pilar Ruiz.
• Programas: Patio 17 (número en el título, no patio-17 en UI).
• Hora: 17:00 en UI (24 h).
• Fecha: 23 ago si hay línea larga.
• No mezclar on-2301 en minúsculas en UI. API puede normalizar a versales.

9. Idioma

es-ES. Fácil lectura. EN no en v1.
No mezclar «playlist» ni «on air» en UI salvo el sello En antena. En API sí: programas, hostName, status.

«Oyente» en UI cuando hablamos de Iker; «la conductora» para Nerea; «la técnica» solo en docs y en el host «Pilar (fuera)». [DECISIÓN]

10. Accesibilidad de copy

• No transmitir estado solo con color (el seal no «significa» en antena él solo).
• Filas llevan texto: En antena / Programado / Archivo.
• Aviso de no-estudio lleva palabras, no solo la cinta.
• Alt de fotos: objeto + lugar, no «imagen1».
  • hero: «Estudio de radio de barrio en Carabanchel; mesa, micro y cinta amarilla, patio al fondo.»
  • micro: «Micrófono de mano con cinta aislante amarilla; cartel ON AIR al fondo. Cubierta de Patio 17.»
  • cinta: «Cassette y rundown manuscrito de radio comunitaria. Cubierta de archivo.»
  • antena: «Antena en una azotea de barrio al atardecer. Cubierta de Voces del bloque.»

11. Piezas que no se escriben

10-accessibility.md

10 — Accesibilidad — ONDA

1. Alcance

WCAG 2.2 AA orientada al slice: galería, buscar, ficha, acuse, login, lista de hoy, rail. No es una auditoría certificada. [DECISIÓN]

2. Contraste

Prohibido: texto mark sobre ground (cinta como cuerpo). El amarillo es superficie, no párrafo.

Texto sobre foto: gradient from-ink/80 bajo el titular de cubierta. No titular suelto sobre micro claro.

3. Teclado y foco

• Orden: wordmark → rail (Estudio, Buscar, Hoy) → cubiertas / resultados → ficha CTA → form login → lista hoy.
• Foco visible: ring mark 2px (ink si el fondo ya es mark).
• Cubiertas y filas operables con Enter / Espacio.
• Pedir repetición no se activa al pasar el foco.

4. Targets

≥44×44 en CTA, cubiertas, filas de hoy, slots del rail, link Conductora. Campo de búsqueda altura ≥44px.

5. Nombre accesible

Fotos: alt de doc 09. Decorative? No: las cubiertas son contenido.

aria-current="page" en el slot activo del rail.

6. Estados no solo por color

En antena / Programado / Archivo en texto. Pedida: pantalla de acuse, no solo el botón en mark. Error: texto seal + mensaje. Empty búsqueda: «Sin resultados.»

7. Motion

prefers-reduced-motion: sin pulse. Skeletons estáticos. Cero animación de «ondas» decorativas.

8. Mobile 390

Galería: cubiertas apiladas (lead primero). No carousel.
Buscar: campo sticky bajo el wordmark; resultados en columna.
Ficha: una columna; CTA al fondo del fold o sticky inferior por encima del rail.
Hoy: lista a pantalla.
Rail: inferior, tres slots, no hamburger.

9. Autocomplete

Login: username / current-password. Buscar: type="search" · name="q". Sin autocomplete de dirección.

10. Idioma

html lang="es". Números y códigos leídos como texto (ON-2301). Horas 17:00 no se convierten a AM/PM.

11. Búsqueda

El campo tiene label visible o aria-label="Buscar en el archivo". Resultados anuncian recuento (1 programa / Sin resultados) vía texto, no solo el grid vacío.

11-privacy-security.md

11 — Privacidad y seguridad — ONDA

1. Superficie pública vs cerrada

[DECISIÓN] El acuse no lista otras peticiones. Evita enumerar demanda del barrio.

2. Datos de oyente

v1 no guarda nombre, email ni teléfono del oyente. La repetición es un contador por programa.
El oyente no tiene fila en users. Escuchar ≠ suscribirse.

Hosts del catálogo (Nerea, Iker, Pilar) son nombres de oficio en programas.host_name, no cuentas salvo Nerea.

3. Auth

• JWT HS256. Claims: sub userId, sid session, role.
• Password bcrypt 12. Demo password123 solo en seed local. Hash canónico $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m.
• Guard: Bearer + sesión no revocada.
• Role CONDUCTOR para /hoy. 401 sin token, 403 si no CONDUCTOR.
• Rate limit en login.

4. Secretos

DATABASE_URL y JWT_SECRET en apps/api/.env (gitignore). Nunca en Angular.
La URI Neon del encargo es para el rewrite local; no se embebe en el bundle.

5. CORS

Allowlist localhost:4200. Previews Vercel opcionales.

6. Amenazas del slice

7. RGPD (modelo, no dictamen)

Base: interés de la emisora en gestionar el archivo y las peticiones. Minimización: cero PII de oyente en v1. Sin cesión a cadena. Derecho de supresión Could L+1 (Nerea no borra en v1).

Pilar no tiene acceso. No hay logs de «quién subió a la antena».

8. Lo que no hacemos

No OAuth. No cookies de marketing. No analytics de terceros en v1. No cifrado extra más allá de TLS. No cuenta de oyente «por si acaso».

12-analytics.md

12 — Analítica — ONDA

1. North star

% de peticiones de repetición servidas en 48 h.

Oficio de emisora. No pageviews. No «engagement con el micro». Servir = Nerea pone el programa otra vez (fuera de app en v1; el modelo cuenta el oficio, no un PATCH). [DECISIÓN]

En v1 no hay estado SERVIDA: la north star es de producto, no un campo SQL. Could L+1: servida_at.

2. Métricas de producto (modelo)

3. Eventos (si se instrumentara)

No hay tracker en v1. Contrato de nombres por si L+1:

Prohibido: play, subscribe, studio_booked, pickup_done, alta_submit.

4. Lo que no medimos

Minutos de streaming. Tiempo en antena. Aperturas de WhatsApp (no hay dato). NPS de cadena. Recogidas escolares.

5. Salud

GET /api/health → { ok: true, service: "onda-api" }. Error rate 4xx/5xx en programas/repetir/hoy.
Si health dice relevo-api o ramal-api, el slice no está cerrado.

13-qa-test-plan.md

13 — Plan de QA — ONDA

1. Smoke API (pnpm test:api)

1. GET /api/health → onda-api (no relevo-api, no ramal-api)
2. GET /api/programas → 4 codes ON-2301…ON-2304 + lead + hora + host + status + cover
3. GET /api/programas/ON-2301 → Patio 17 · EN_ANTENA · 17:00 · Nerea
4. GET /api/programas?q=patio → incluye ON-2301; no exige los 4
5. GET /api/programas?q=zzzz → []
6. POST /api/programas/ON-2301/repetir → 201 pedida: true
7. POST /api/programas/ON-9999/repetir → 404
8. GET /api/hoy sin JWT → 401
9. POST /api/auth/login Nerea → CONDUCTOR
10. GET /api/hoy → 4 programas; ON-2301 EN_ANTENA; repeatCount ≥ 1 tras el POST

2. Smoke UI

3. Regresión de unicidad

• No copy RAMAL (nodo, alta, vocal, RM-, azotea como producto, cobertura).
• No copy TEMPLE (hora de ensayo, concierto, conserje, turno, TM-).
• No copy PREGÓN (chat, kanban, 112, parte).
• No copy RELEVO (relevo, recoger, cole, tutor, feed de recogidas). Retirado.
• No Spotify, no play, no la SER como CTA.
• Health no dice relevo-api ni ramal-api.
• Puerto 3023.

4. Accesibilidad rápida

Tab por rail y cubiertas. Focus ring mark. Alt de 4 fotos. Status en texto. CTA ink sobre mark.

5. Datos

Seed idempotente por email y code. Un POST de smoke no borra ON-2301 ni cambia su status.
Playwright futuro: esperar Patio 17, nerea@onda.radio, no Inés Soto, no RM-2201, no Lola, no «recoger».

6. Criterio de salida

Smoke API verde + guión UI completo + 0 leftover de dominio anterior en UI (RAMAL o RELEVO).

14-dev-handoff.md

14 — Handoff de desarrollo — ONDA

1. DoD del slice

• Health { ok: true, service: "onda-api" } en :3023
• 4 programas seed con foto, lead, hora, host, status
• GET /api/programas?q=patio → Patio 17
• POST repetición pública → acuse /ok/:code
• JWT CONDUCTOR nerea@onda.radio / password123
• /hoy lista · GET JWT · no kanban
• Empty / error / loading en galería, buscar y hoy
• Copy ×4 visible
• Rutas / /buscar /programa/:code /ok/:code /login /hoy
• Páginas GalleryPage SearchPage ProgramaPage OkPage LoginPage HoyPage
• Paper 12 UX + 12 UI mapeados
• Docs 01–20 + README + executive
• 0 leftover nodes / altas / VOCAL / relevo-api / TUTOR

2. Contratos

Ver docs 05 y 20. JSON camelCase. SQL snake_case.

POST /api/programas/:code/repetir:

{}

201:

{ code, title, status, hour, hostName, pedida: true }

GET /api/hoy (JWT):

{ date, programas: [{ code, title, status, hour, hostName, cover, repeatCount, sortOrder }] }

Login:

{ email: "nerea@onda.radio", password: "password123" }

3. Mapas de pantalla

4. Tokens en código

tailwind.config.js + styles.scss. Fuentes Google: DM Serif Display + IBM Plex Sans.
Colores: ground #FFFFFF · ink #111111 · mark #E6C200 · mute #5C5C5C · seal #C41E3A · rail #F3F3F3.

5. Assets

Copiar 2026-08-23-onda/assets/programas/*.jpg y hero.jpg a apps/web/public/assets/.
Cubiertas: programas/micro.jpg · cinta.jpg · antena.jpg.

6. No hacer

• No reintroducir nodes / altas / VOCAL como dominio vivo.
• No reintroducir relevos, recogidas, TUTOR, cole. RELEVO está retirado.
• No documentar leftover RAMAL o RELEVO como estado actual.
• No añadir signup de oyente, player, chat, kanban, reserva de estudio, parrilla semanal.
• No dejar HealthService.name = 'relevo-api'.

7. Arranque

cd /Users/cristian/orca/onda-app
# apps/api/.env → DATABASE_URL Neon falling-fog-92644546, JWT_SECRET, PORT=3023
pnpm --filter @repo/api start:dev
pnpm --filter @repo/web start

El rewrite corre en paralelo. Este handoff es el contrato; no se espera a Paper ni se arranca aquí.

15-roadmap.md

15 — Roadmap — ONDA

Aquí solo viven ideas de L+1 / L4 y pulido posterior.
El slice L1 del día está cerrado: galería, buscar, ficha, pedir, JWT CONDUCTOR, lista de hoy.

1. Hecho (L1)

• Galería H-GALLERY · 4 cubiertas · lead + 3
• Búsqueda F-SEARCH · q=patio
• Ficha · título, hora, estado
• Acuse /ok/:code · pedir ≠ reservar
• Hoy S-RAIL · lista, no kanban
• Empty / error / loading · galería 390
• Neon falling-fog-92644546 · API :3023 · onda-api

2. L+1 (mismo producto, más oficio)

3. L4 (requiere brief nuevo de diversidad)

• Rol TÉCNICA (Pilar) + cuadrante de antena
• Streaming / player (otro producto; no es ONDA L1)
• Parrilla semanal / EPG
• Multi-emisora / multi-conductor
• Chat / kanban (fue PREGÓN)
• Reserva de estudio (fue TEMPLE)
• Cuenta de oyente / follow

4. Fuera para siempre en este nombre

La SER. Playlist como producto. Reserva de estudio el día de la petición. Feed de recogidas (RELEVO retirado). Nodos y altas (RAMAL es otro día).

5. Criterio para abrir L+1 / L4

Solo si un día futuro elige radio L2+ y la diversidad ALS-2 lo permite. No parche silencioso. No reabrir RELEVO.

16-interaction-specs.md

16 — Especificación de interacción — ONDA

1. Convenciones

Loading (UI-11) y empty (UI-09) / error (UI-10) viven con los gestos. [DECISIÓN]

2. Galería (UI-01) + mobile (UI-02) · H-GALLERY

AC: título, lead y 3 datos visibles sin hover. 4 programas en el recorte 16/10 (AP-21). Cero botones Play / Suscríbete / Reservar.

El aviso «Onda ≠ playlist» es texto, no un CTA de player. [DECISIÓN]

390: mismas 4 cubiertas apiladas. No carousel. Rail inferior. [DECISIÓN]

3. Buscar (UI-03) · F-SEARCH

AC: no facetas de distrito. No H-SEARCH como home.

4. Programa (UI-04) + mobile (UI-05)

AC: una pantalla. Cero player. Cero «Reservar 18:00».

5. Acuse (UI-06)

No GET de lista de peticiones. [DECISIÓN] doc 11.

6. Login (UI-07)

next open-redirect: allowlist /hoy únicamente. [DECISIÓN]

7. Hoy (UI-08)

Desktop: lista en el panel del rail. 390: lista a pantalla. [DECISIÓN]
Cero Aceptar / Rechazar (eso fue RAMAL). Cero columnas.

8. Loading / empty / error (UI-09…11)

Skeletons pulse. Empty usa titular display, no un illustration pack. Error no usa copy de 112 ni de recogida.

17-prototype-map.md

17 — Mapa de prototipo — ONDA

Paper file: 01M0TSYSNQFZ8FVKD38ZGQT8AW
https://app.paper.design/file/01M0TSYSNQFZ8FVKD38ZGQT8AW

Este mapa es el contrato Paper ↔ docs ↔ app. No se arranca Paper desde esta suite. El archivo ya existe.

UX process → docs

UI producto → app

Guión de prototipo

1. Cover → Galería (4 cubiertas, lead Patio 17).
2. Ficha Patio 17 en antena.
3. Acuse ON-2301 · pedir ≠ reservar.
4. Buscar «patio».
5. Login Nerea.
6. Hoy · lista · ON-2301.
7. Empty / error / loading.
8. Galería 390 + ficha 390.

No hay artboard de player, nodos, altas, kiosk de horas, kanban ni feed de recogidas.

18-completeness-audit.md

18 — Auditoría de cierre — ONDA

1. Alcance L1

2. Terna y diversidad

3. Copy irrenunciable

Presente en galería, ficha, acuse, pie de hoy. Ver doc 09.

• Onda ≠ playlist
• Pedir repetición ≠ reservar estudio
• ONDA no es la SER
• Escuchar ≠ suscribirse

4. Anti-patrones vigilados

5. Seed

4 programas · 1 EN_ANTENA · 1 PROGRAMADO · 2 ARCHIVO · Nerea CONDUCTOR · Iker sin cuenta · Pilar fuera.

6. Huecos conscientes (fuera)

Streaming, login Pilar, email transaccional, instrumentación analytics, parrilla semanal, servida_at.

7. Veredicto

Slice L1 cerrado a nivel de case. El código se escribe en paralelo con el mismo contrato. Si el repo diverge (leftover RAMAL o RELEVO), gana docs 05 + 20 tras alinear ambos. Paper no se abre en esta entrega de docs.

19-backlog-completo.md

19 — Backlog — ONDA

1. Done (Must L1)

2. Could L+1 (no bloquea cierre)

3. Explícito L4 / otro brief

4. No-backlog (rechazado)

Hero 2-col. Signup oyente. leftover RAMAL (nodes, altas, VOCAL) como feature. leftover RELEVO (recogida, cole, TUTOR) como feature. RELEVO retirado. La SER. Playlist. «Reservar estudio».

5. Cómo usar este archivo

Done = el día. Could = L+1. E = otro cron. Nada de esta lista es deuda del L1.

20-implementation.md

20 — Implementación — ONDA

1. Resumen ejecutivo técnico

Este documento es la especificación de build alineada al case. No sustituye al código: si el repo diverge, gana el contrato de docs 05 + este archivo tras actualizar ambos.

El código se escribe en paralelo a esta suite. Contrato: programas + repeticiones + JWT CONDUCTOR. Puerto 3023. Health onda-api.

[COMPROBADO] Path, puerto, Neon y Paper salen del encargo.
No se arranca la app ni Paper desde esta entrega de docs.

El repo puede contener leftover RAMAL (nodes, altas, HomePage de nodos) al inicio del rewrite. Eso no es ONDA. El rewrite borra ese dominio.

2. Cómo arrancar

cd /Users/cristian/orca/onda-app
# instalar dependencias por app (pnpm --filter; no npm workspaces)

# apps/api/.env
#   DATABASE_URL=postgresql://neondb_owner:npg_ZYutTBi1PQW0@ep-lively-bread-avlpx7l2-pooler.c-11.us-east-1.aws.neon.tech/neondb?sslmode=require
#   JWT_SECRET=
#   PORT=3023

# schema + seed
# api → http://localhost:3023
# web → http://localhost:4200

Credenciales

Hash seed: $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m

Oyente / técnica: sin cuenta. Iker pide en /programa/:code. Pilar no entra.

3. Schema

Al boot o vía migrate:

1. CREATE TABLE de users, sessions, programas, repeticiones (doc 05).
2. Índices: programas(code), programas(status), users(email), repeticiones(programa_id).
3. Seed idempotente:
   • upsert CONDUCTOR nerea@onda.radio (hash bcrypt canónico)
   • upsert programas por code (ON-2301…ON-2304)
   • no seed de repeticiones (el POST de smoke las crea)
4. Dominio: solo programas + repeticiones + users. [DECISIÓN]

No borrar repeticiones nuevas de Iker en cada boot. Upsert de programas por code no pisa status si un operador futuro lo moviera (v1 no mueve).

No generar códigos en el POST: el acuse reusa ON-2301.

Tablas (recordatorio)

DROP leftover nodes, altas, relevos si existen en el mismo Neon. [DECISIÓN] El project falling-fog-92644546 es de ONDA.

4. Módulos API a implementar

Auth

• POST /api/auth/login
• Valida email/password; compara bcrypt; emite JWT con sub, email, role.
• Guard JWT + role === CONDUCTOR protege /hoy.
• Públicos: health, programas, programas?q=, programas/:code, POST repetir, login.

Oficio

Health (referencia de implementación)

HealthService.name = 'onda-api'
main.ts PORT default 3023

Si el rewrite hereda relevo-api, cambiar el string. El puerto 3023 se queda.

Repetición (referencia)

programa = programas.byCode(code) || 404
INSERT repeticiones (programa_id)
return { code, title, status, hour, hostName, pedida: true }

POST no cobra, no reserva estudio, no crea user, no abre stream, no mueve kanban.

JSON camelCase: hostName, sortOrder, createdAt, repeatCount.
SQL: host_name, sort_order, created_at.

Módulos de dominio: programas/, hoy/, auth/, health.
No nodes/, altas/, mesa/, relevos/.

5. Frontend a implementar

Estados: loading / ready / empty / error en galería, buscar y hoy.
Token key: onda.accessToken.
Proxy: /api → :3023.

Tokens Tailwind: ground / ink / mark / mute / seal / rail. Fuentes DM Serif Display + IBM Plex Sans.

Rail compartido: Estudio / · Buscar /buscar · Hoy /hoy.

Renombrar leftover HomePage / AltaPage / MesaPage → las seis páginas de arriba. [DECISIÓN]

6. Seed visible en UI

Playwright: esperar Patio 17, Hoy suena esto., nerea@onda.radio.
No esperar Inés Soto, Azotea Palomeras, RM-2201, recoger, tutor.

7. Smoke

apps/api/scripts/test-api.mjs · pnpm test:api contra :3023.

Cubre health onda-api, 4 programas, q=patio, POST repetir, 404 code, 401 hoy, login CONDUCTOR, lista 4, repeatCount.

8. DoD técnico

Ver doc 14. Este archivo no lista leftover de otro día como estado del producto. El contrato vivo es ONDA. RELEVO está retirado.