00-day-brief.md

00 — Day brief · 2026-08-26 · BOBINA

Decisiones ALS-2 BRIEF

Terna unicidad

R-IN · S-DOCK · H-FEED · F-STORY

0 códigos iguales a N−1 (LOMO: R-CL · S-CMD · H-DATA · F-LEAD).
≥2 distintos vs N−2 (ONDA: R-HY · S-RAIL · H-GALLERY · F-SEARCH) y N−3 (RAMAL).

S-DOCK, H-FEED y F-STORY no están en los últimos 5.
R-IN cumple la mezcla de 4 días (LOMO R-CL, ONDA R-HY).

Ground (CRON §5.6)

• Familia: G-VELVET
• Hex: #1A1210
• Por qué: terciopelo de butaca a oscuras, no caliza de sala (LOMO), no cinta de portería (ONDA), no hielo de mástil (RAMAL), no tablero de conserje (TEMPLE), no niebla highlighter (PREGÓN).

Mood visual (Paper)

• Candidatos: nocturnal/neón de cine (primer instinto cartelera), chapel, rusted, candlelit, subterranean
• Elegido: candlelit — no el primer instinto neón de multiplex. Un cineclub de barrio se enciende con apliques de latón, no con LED de Cinesa.
• Paleta:
  • #1A1210 terciopelo (ground)
  • #F4EDE4 crema de ficha
  • #241C18 asiento / card
  • #C4A574 latón (mark)
  • #8A7A6E mute
  • #9A3B2F oxblood (sello, poco)
• Tipo: Cormorant Garamond display · Manrope UI

Home foto-led (D-P1-09)

UI-01 = Pliego: still de la sala a sangre (≥40 % del recorte 16/10) + feed de 4 sesiones encima. No tabla. No H-DATA. Cuota ≥3 de últimos 6: DERIVA, PLIEGO, LOMO (retrofit split), BOBINA.

Alcance L1 must

1. Home feed foto-led: 4 sesiones
2. Relato de sesión (noche + película + butacas)
3. Pedir butaca (pedir ≠ entrada Cinesa)
4. Success con copy duro
5. Login JWT PROGRAMADOR
6. Mesa de noches + pedidos
7. Empty / error / loading / mobile feed
8. ≥12 UX + ≥10 UI

Microcopy duro

• Pedir butaca ≠ entrada Cinesa. No se compra un ticket de multiplex.
• Sesión ≠ estreno. No es el circuito comercial.
• Cartelera ≠ Filmin. No hay VOD ni archivo en streaming.
• BOBINA no es los cines del centro.

Supuestos

• S1: El cineclub programa 2–4 noches/semana en el slice; demo 4. [SUPUESTO]
• S2: El vecino pide butaca sin cuenta. JWT solo PROGRAMADOR. [SUPUESTO]
• S3: Proyeccionista y barra fuera del producto. [SUPUESTO]
• S4: Sin taquilla Cinesa, sin Filmin, sin GPS, sin chat. [DECISIÓN]

Hipótesis

Seed demo

Títulos de cine español clásico son catálogo demo. No es una programación real ni un acuerdo con Filmoteca. [SUPUESTO de cartelera]

JWT

marta@bobina.cine / password123 · rol PROGRAMADOR · API :3026

00-paper-reference.md

Paper reference · BOBINA

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 Cartelera feed foto-led · UI-02 Cartelera mobile · UI-03 Sesión · UI-04 Sesión mobile · UI-05 Pedir · UI-06 Success · UI-07 Login · UI-08 Mesa PROGRAMADOR · UI-09 Empty · UI-10 Error+Loading · UI-11 Dock

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 — BOBINA

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.
[SUPUESTO de cartelera] Vallecas / Erice / Saura es atrezzo de mercado, no la programación real de un cineclub municipal.

Tras LOMO (L2 archivo, 2026-08-25) el día elige L1 cineclub, no otro L2 consecutivo. N−1 es LOMO. [DECISIÓN]

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] El vecino de Vallecas no necesita Filmin ni la taquilla del centro: necesita saber qué noche hay butaca sin preguntar por WhatsApp. Hoy eso vive en un grupo, un cartel en el portal y una expectativa de «entrada». La cartelera se lee como Cinesa; pedir butaca se lee como comprar ticket; el producto se lee como los cines del centro. [SUPUESTO] Un cineclub programa 2–4 noches/semana; no opera un VOD ni un estreno comercial.

Secundarios

Supuestos (no investigación primaria propia)

• S1: El cineclub programa 2–4 noches/semana en el slice; demo 4. [SUPUESTO]
• S2: El vecino pide butaca sin cuenta. JWT solo PROGRAMADOR. [SUPUESTO]
• S3: Proyeccionista y barra fuera del producto. [SUPUESTO]
• S4: Sin taquilla Cinesa, sin Filmin, sin GPS, sin chat. [DECISIÓN]

Hipótesis de producto

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

3. Propuesta de valor

No es BOBINA

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L1 cineclub de barrio con Sesión + pedido + JWT PROGRAMADOR.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable.
• Terna R-IN · S-DOCK · H-FEED · F-STORY frente a LOMO (cmd/datos/lead), ONDA (rail/galería/archivo) y RAMAL (split/portada/alta).
• No encadenar otro L2 tras LOMO. [DECISIÓN]

Usuario

No objetivos v1 (explícitos)

• Taquilla, precio, pago, QR de multiplex
• Filmin, VOD, play, archivo en streaming
• Estreno comercial, cartelera de circuito
• Chat, kanban, columnas Recibido / En curso
• Cuenta de vecino, socio, newsletter
• GPS, mapa de salas, horario de Filmoteca
• Multi-sede, multi-programadora
• App nativa ni notificaciones push
• Rol proyeccionista / barra autenticado
• Ejemplares, BIBLIO, comando (LOMO es otro día)
• Programas, repeticiones, CONDUCTOR (ONDA es otro día)
• Nodos, altas, vocal (RAMAL es otro día)

5. Roles y permisos (resumen)

[DECISIÓN] Un solo rol autenticado: PROGRAMADOR. El vecino no es un usuario del sistema: es autor/autora de un pedido. Inma 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 el feed foto-led Pliego (still a sangre + 4 noches). No pide cuenta. No es un hero 2-col + 3 cards. No es una mesa de datos.
2. Un vecino puede ver 4 sesiones, tocar El sur, pedir butaca y obtener success en /ok/BOB-2604.
3. /ok/:code dice explícitamente que pedir butaca no es entrada Cinesa y que sesión no es estreno.
4. La UI dice explícitamente que cartelera no es Filmin y que BOBINA no es los cines del centro.
5. Sin token, GET /api/mesa responde 401. POST /api/sesiones/:code/pedir y GET /api/sesiones son públicos.
6. Un POST de pedir no crea user, no cobra, no abre Filmin, no mueve kanban.
7. Un PROGRAMADOR inicia sesión y ve 4 sesiones (3 ABIERTA, 1 COMPLETA) en el seed.
8. El tablero autenticado es una mesa de lista + pedidos. No es un kanban de 3 columnas. No es un split lista | ficha.
9. Fotos reales en las cubiertas seed (assets sesiones/*).
10. Chrome S-DOCK: Cartelera · Pedir · Mesa. Feed sin top-nav de marketing y sin comando de archivo.
11. Rutas solo las del doc 03. No existen /buscar, /lomo, /programa, /hoy JWT de ONDA, /nodos, /alta.
12. GET /api/health devuelve service: "bobina-api" (no lomo-api, no onda-api).
13. El feed público no muestra nombres de otros vecinos; la mesa PROGRAMADOR sí muestra pedidos con nombre.
14. Cría cuervos (BOB-2603) aparece COMPLETA con 0 butacas; no se puede pedir.

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-IN · S-DOCK · H-FEED · F-STORY. 0 códigos iguales a N−1 (LOMO). ≥2 distintos vs N−2 (ONDA) y N−3 (RAMAL). S-DOCK, H-FEED y F-STORY no están en los últimos 5. Ground G-VELVET #1A1210, no G-STONE ni G-SIGN.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — BOBINA

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 cineclubs de barrio (cartel en el portal, grupo de WhatsApp, butacas limitadas, programadora que elige 2–4 noches, proyección fuera del producto día 1).
• Analogía operativa con superficie pública + panel JWT de la serie daily.
• Restricciones ALS-2: no taquilla Cinesa, no Filmin, no estreno comercial, no archivo de lomos, no radio, no nodos/altas, no kiosk de horas.

Límites éticos de verdad

3. Stakeholders

Mapa de poder (resumen)

• Decisor de adopción: la asociación (quién pone las noches) y, en uso diario, Marta (quien mira pedidos).
• Usuario frecuente de pedir butaca: VECINO (feed + relato + form, sin cuenta).
• Usuario frecuente de oficio: PROGRAMADOR (mesa /mesa).
• Riesgo de rechazo: si el success parece un ticket; si la tarjeta parece un título de Filmin; si hay que crear cuenta; si la mesa parece un kanban; si el feed parece un estreno comercial.

4. Personas

P1 — Marta Ruiz · PROGRAMADOR

Escenario: Entra a /login, abre /mesa, lee BOB-2604 El sur ABIERTA, ve los pedidos. El copy dice que pedir butaca no es entrada Cinesa.

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

P2 — Luis Navarro · VECINO

Escenario: Abre / en el móvil, ve Cría cuervos COMPLETA, toca El sur ABIERTA, pide butaca, lee «pedir butaca ≠ entrada Cinesa» y el código BOB-2604.

[COMPROBADO] Nombre, edad y gesto (vecino, 34, pide sin cuenta) salen del encargo. Es constructo de diseño, no entrevistado. [DECISIÓN]
Luis no tiene fila en users. [DECISIÓN]

P3 — Inma Peña · VECINA MAYOR (docs / a11y)

[COMPROBADO] Nombre, edad y exclusión de login salen del encargo. [DECISIÓN] no hay cuenta de Inma en v1; a11y la contempla en docs 10.

5. JTBD

Job principal (vecino)

Cuando quiero saber qué noche hay butaca, quiero ver la cartelera y pedir plaza sin preguntar por WhatsApp, para dejar constancia en la asociación sin que eso signifique ticket, cuenta ni Filmin.

Job principal (programadora)

Cuando hay noches abiertas y pedidos nuevos, quiero ver la lista de noches y los pedidos, para mover el oficio del cineclub sin un kanban ni una taquilla.

Jobs que BOBINA no hace

6. Stories Must (v1)

Could (fuera de L1): login de Inma, pago, VOD, chat, cuenta de vecino, Filmoteca.

7. Journey (resumen)

1. Luis abre /. Ve still a sangre + feed de 4 noches. Cría cuervos COMPLETA; El sur ABIERTA. [H1]
2. Toca Cría cuervos → /sesion/BOB-2603. Lee 0 butacas, COMPLETA. CTA disabled.
3. Vuelve / toca El sur → /sesion/BOB-2604. Lee 14 butacas, ABIERTA. Copy irrenunciable.
4. Toca Pedir butaca → /pedir/BOB-2604. Escribe su nombre. POST → /ok/BOB-2604. Lee las cuatro oposiciones.
5. Marta entra a /login → /mesa. Lista + pedidos.
6. Lee BOB-2604 y el pedido de Luis. Copy: butaca no es entrada Cinesa.

Backstage: Nest + Neon + JWT. Proyeccionista y barra no entran. No hay Filmin. No hay Cinesa.

8. Blueprint (resumen)

9. Matriz hallazgo → requisito → feature

10. Preguntas que este case no responde

• ¿Cuántas butacas reales se piden en Vallecas en 2026?
• ¿Qué cineclub opera El espíritu de la colmena?
• ¿Luis preferiría el WhatsApp?
• ¿Inma necesita un modo tipográfico mayor permanente?
• ¿Marta confirmaría pedidos antes de las 18:00 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.
Paper UX-00…11 documenta el mismo arco. [COMPROBADO] inventario en 00-paper-reference.md.

03-information-architecture.md

03 — Arquitectura de información — BOBINA

1. Principios de IA

2. Sitemap

/                                      Cartelera feed pública (Pliego)                 H-FEED
/sesion/:code                          Relato de sesión                                F-STORY · público
/pedir/:code                           Form pedir butaca                               público
/ok/:code                              Success post-pedido                             público
/login                                 Login JWT PROGRAMADOR                           público
/mesa                                  Lista + pedidos                                 auth
/**                                    → redirect /

Árbol por audiencia

[COMPROBADO] Seis rutas del encargo L1. No se inventan /buscar, /lomo, /programa, /hoy (JWT ONDA), /nodos, /alta, /playlist, /taquilla.

El relato sí es ruta (/sesion/:code): F-STORY necesita URL compartible y un paso antes del form. [DECISIÓN]
El form sí es ruta (/pedir/:code): pedir es un paso, no un POST oculto en el feed. [DECISIÓN]
/ok/:code usa el código de sesión (BOB-2604), no un código de petición distinto. L1 compacto. [DECISIÓN]
No hay /buscar: no hay S-CMD. El hallazgo es el feed. [DECISIÓN]

3. Navegación

Dock (S-DOCK · todas las superficies salvo login/ok pueden mostrarlo)

[DECISIÓN] El dock es la navegación primaria. No hay comando (LOMO), no hay rail Estudio/Buscar/Hoy (ONDA), no hay split (RAMAL), no hay kiosk mínimo (TEMPLE).

Desktop ≥960px: dock flotante inferior o anclado; feed full-bleed con overlay.
Mobile ~390px: dock fijo inferior Cartelera · Pedir · Mesa. [DECISIÓN] En 390 el dock no compite con un hamburger.

Cartelera pública (H-FEED Pliego)

[DECISIÓN] La cartelera no tiene tabs de marketing, no tiene «Taquilla / Filmin / Estrenos». El feed basta para hallar.

Chrome de relato y pedir (F-STORY)

Chrome de mesa (/mesa autenticado)

[DECISIÓN] No hay S-SPLIT (RAMAL). No hay kanban (PREGÓN). No hay /mesa/:code: L1 lee lista + pedidos. Could L+1: ficha de pedido.

4. Etiquetas de IA (UI)

En docs puede decirse «cartelera feed» para H-FEED y «mesa PROGRAMADOR» para el oficio JWT. En UI pública el titular es Cartelera. En UI autenticada el titular es Mesa. [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 hallazgo

No hay búsqueda Must: el hallazgo es el feed de 4 noches. Introducir /buscar copiaría LOMO/PIZARRA y rompería la terna. [DECISIÓN]
Marta no filtra la mesa en v1: ve la semana entera + pedidos. Could L+1: filtro por estado ABIERTA/COMPLETA.

8. Códigos y URLs

9. Mapa Paper → rutas

[COMPROBADO] Mapeo alineado a docs/00-paper-reference.md.

04-user-flows.md

04 — Flujos de usuario — BOBINA

1. Convenciones

2. F1 — Vecino pide butaca desde el feed (Must)

/  →  GET /api/sesiones
   →  ve Cría cuervos COMPLETA (contexto)
   →  tap El sur  →  /sesion/BOB-2604
   →  GET /api/sesiones/BOB-2604
   →  tap Pedir butaca  →  /pedir/BOB-2604
   →  escribe nombre «Luis Navarro»
   →  POST /api/sesiones/BOB-2604/pedir  { nombre, note? }
   →  201 { code: BOB-2604, title, status, remaining, pedida: true }
   →  /ok/BOB-2604

Entrada: cartelera feed, sin cuenta.
Salida: código visible + copy «pedir butaca ≠ entrada Cinesa».
Errores: red (reintentar), 404 sesión, 409 completa, 0 sesiones (empty).

AC

• El form no pide email, DNI, pago ni signup.
• POST no cobra, no crea user, no abre Filmin, no mueve kanban.
• /ok/BOB-2604 muestra las cuatro oposiciones.
• El paso /sesion/:code existe: F-STORY no es un POST oculto en el feed. [DECISIÓN]
• El paso /pedir/:code existe: pedir no es un modal efímero sin URL. [DECISIÓN]

3. F2 — Vecino abre sesión COMPLETA (Must · estado)

/  →  tap Cría cuervos  →  /sesion/BOB-2603
   →  GET /api/sesiones/BOB-2603
   →  remaining 0 · status COMPLETA
   →  CTA Pedir butaca disabled

AC

• No se permite POST sobre COMPLETA (409 si se fuerza).
• Copy: «Completa. Sin butacas.» No «agotado tipo Cinesa» ni «comprar otra sesión».
• Luis puede volver al feed y elegir El sur.

4. F3 — Programadora entra a mesa (Must)

/login  →  POST /api/auth/login
        →  JWT PROGRAMADOR
        →  /mesa
        →  GET /api/mesa

AC

• Sin token, /mesa redirige a /login?next=/mesa.
• GET /api/mesa sin Bearer → 401.
• Lista de la semana: 4 filas + pedidos. No columnas Recibido / En curso.
• Desktop: lista + pedidos en el panel. 390: apilado sobre el dock.

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. / — still a sangre + 4 noches. Cría cuervos COMPLETA. El sur ABIERTA. Eslogan. Dock.
2. Tap Cría cuervos — relato COMPLETA · 0 butacas · CTA disabled.
3. Tap El sur — relato ABIERTA · 14 butacas · director Erice.
4. Pedir butaca — /pedir/BOB-2604 · nombre Luis Navarro · note opcional.
5. Enviar — /ok/BOB-2604. Copy ×4.
6. /login — marta@bobina.cine / password123.
7. /mesa — lista + pedidos; BOB-2604; pedido de Luis si se hizo el POST.
8. 390: feed + dock; no carousel; targets ≥44px.
9. API down: error + Reintentar.

9. Contratos de error de API (flujo)

10. Dock en flujo

[DECISIÓN] El slot Pedir del dock no inventa una quinta sesión; reutiliza contexto de ruta o el primer ABIERTA del feed.

05-data-model.md

05 — Modelo de datos — BOBINA

1. Visión general

Dominio L1 de cartelera de sesiones + relato + pedir autenticable:

Base: PostgreSQL (Neon project tiny-feather-31905339) · IDs: serial + texto estable (BOB-2601).
[DECISIÓN] ensureSchema es válido si el contrato de tablas se cumple; el brief de stack no exige Prisma.

Contrato de producto: sesiones + pedidos + JWT PROGRAMADOR.
No ejemplares / programas / repeticiones / nodes / altas / rooms / bookings.

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

Role

SesionStatus

Pedir butaca solo está permitido en ABIERTA con remaining > 0. COMPLETA responde 409. [DECISIÓN]

Tras un POST exitoso: remaining = remaining - 1; si llega a 0 → status = COMPLETA. [DECISIÓN]

3. Diagrama ER (texto)

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

sessions
  id, user_id → users
  expires_at, revoked_at
  created_at

sesiones
  id
  code (unique, BOB-XXXX)
  title, director, when_label
  seats, remaining
  status (ABIERTA|COMPLETA)
  cover, blurb
  sort_order
  created_at, updated_at
  1 ──< pedidos

pedidos
  id
  sesion_id → sesiones
  code (denorm BOB-XXXX, opcional)
  name
  note
  created_at

v1: una sola PROGRAMADOR opera sobre el conjunto global.
No hay FK de vecino-usuario: el vecino no se loguea.
pedidos.name es el nombre de sala (oral), no una cuenta.
pedidos.note es texto libre opcional («voy con Inma»).

4. Tablas

users

sessions

sesiones

pedidos

Sin email, sin teléfono, sin DNI, sin pago. Pedir butaca ≠ entrada Cinesa. [DECISIÓN]

Índices: sesiones(code), sesiones(status), sesiones(sort_order), users(email), pedidos(sesion_id), pedidos(created_at DESC).

5. Seed

PROGRAMADOR

marta@bobina.cine / password123 · Marta Ruiz · PROGRAMADOR
Hash bcrypt fijo: $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m

Sesiones

[SUPUESTO de cartelera] Títulos, blurbs y butacas son atrezzo. No es una programación oficial.
[DECISIÓN] BOB-2603 usa seats=12 demo con remaining=0 para mostrar COMPLETA; el encargo lista 0 butacas = remaining.

Pedidos

Seed opcional vacío o una fila demo sobre BOB-2603 (ya COMPLETA) no es necesaria.
El POST de smoke crea la de Luis sobre BOB-2604.
Marta puede ver 0 pedidos al entrar en frío y ≥1 tras el guión.

El seed idempotente restaura los 4 estados de catálogo (3 ABIERTA, 1 COMPLETA) y los remaining de catálogo para que el demo sea repetible. [DECISIÓN]

6. JSON (camelCase)

API: sortOrder, createdAt, pedidoCount, whenLabel, cover, status, title, director, code, blurb, seats, remaining, name, note.
SQL: sort_order, created_at, when_label, pedido_count derivado.

GET /api/sesiones (item)

{
  "code": "BOB-2604",
  "title": "El sur",
  "director": "Víctor Erice",
  "whenLabel": "dom 30 ago 18:00",
  "seats": 14,
  "remaining": 14,
  "status": "ABIERTA",
  "cover": "/assets/sesiones/sur.jpg",
  "blurb": "El sur al atardecer. Dom 18:00. Sesión ≠ estreno.",
  "sortOrder": 4
}

Lista pública: no incluye name de pedidos (evita enumerar vecinos). [DECISIÓN]

GET /api/sesiones/:code

Mismo shape; puede incluir campos de relato ya presentes (blurb, director).

POST /api/sesiones/:code/pedir

Request:

{ "name": "Luis Navarro", "note": "Voy con Inma" }

note opcional. name obligatorio, trim, min 2 caracteres. [DECISIÓN]

Response 201:

{
  "code": "BOB-2604",
  "title": "El sur",
  "status": "ABIERTA",
  "remaining": 13,
  "pedida": true
}

GET /api/mesa (JWT)

{
  "sesiones": [ /* 4 items + pedidoCount */ ],
  "pedidos": [
    {
      "id": 1,
      "code": "BOB-2604",
      "name": "Luis Navarro",
      "note": "Voy con Inma",
      "createdAt": "2026-08-26T16:12:00.000Z"
    }
  ]
}

7. Reglas de integridad

8. Fuera del modelo v1

9. Naming vs leftover

06-tech-stack.md

06 — Stack técnico — BOBINA

1. Resumen

[COMPROBADO] Angular + NestJS + Neon + Tailwind, puerto API 3026, Neon id y path de app salen del encargo.

2. Por qué este stack

3. Puertos y health

Leftover lomo-api / puerto 3025 / onda-api no son el producto. [DECISIÓN]

4. Estructura de repo (contrato)

bobina-app/
  apps/
    api/          NestJS · PORT=3026
    web/          Angular · 4200
  package.json    pnpm workspaces o filter

Proxy web → API en dev (/api → http://localhost:3026). [DECISIÓN]

5. Variables de entorno (API)

No commitear secretos. .env local; ejemplo en .env.example sin credenciales reales. [DECISIÓN]

6. Auth

[COMPROBADO] Credenciales demo: marta@bobina.cine / password123.

7. Endpoints (contrato)

CORS: origen http://localhost:4200 en dev. [DECISIÓN]

8. Frontend — rutas y componentes

Chrome: DockComponent (S-DOCK). Tokens Tailwind: ground, cream, card, brass, mute, oxblood.

9. Assets

Covers en DB como paths /assets/sesiones/colmena.jpg etc. [DECISIÓN]

10. Calidad y toolchains

11. Anti-stack (no introducir)

12. Criterios de aceptación técnicos

1. GET /api/health → service: "bobina-api".
2. Seed idempotente: 1 PROGRAMADOR + 4 sesiones.
3. POST pedir decrementa remaining y puede pasar a COMPLETA.
4. GET mesa sin token → 401.
5. Web en 4200 consume API 3026 sin mixed-content local.
6. 0 referencias de producto a ejemplares, BIBLIO, lomo-api en runtime.

[COMPROBADO] Contrato alineado a docs 01, 05 y README.

07-creative-direction.md

07 — Dirección creativa — BOBINA

1. Concepto

BOBINA es una sala a oscuras bajo terciopelo: se entra a un still a sangre con cuatro noches encima y se sale habiendo pedido una butaca, no una landing de «tu cine». El ground es velvet. El latón puntúa, poco. El oxblood marca completa / error, poco.

Mood elegido: candlelit.
Primer instinto descartado: nocturnal / neón de cine (multiplex). Un cineclub de barrio se enciende con apliques de latón, no con LED de Cinesa.

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

2. Territorio visual

3. Paleta

Jerarquía de color: el velvet carga; el brass puntúa; el oxblood marca completa. Si el brass pinta fondos enteros, deja de ser latón y se vuelve «brand dorado». El oxblood no decora la cabecera: solo puntual (COMPLETA, error). El texto sobre velvet es cream; nunca mute como párrafo largo. Cream sobre velvet debe pasar contraste WCAG 2.2 AA. [DECISIÓN]

Candidatos de mood descartados: nocturnal/neón (primer instinto multiplex), chapel, rusted, subterranean.

4. Tipografía

Prohibido: Cormorant por debajo de 18px (se rompe). Manrope en el wordmark de cartelera (se vuelve SaaS). Brass como color de texto de párrafo largo (contraste).

Fuentes vetadas de la serie reciente cuando el brief fija otras: Source Serif 4 / Outfit (LOMO), DM Serif Display / IBM Plex Sans, Newsreader / Figtree, Fraunces / Atkinson, etc. Cormorant + Manrope sí entran: el brief los fija. [COMPROBADO]

5. Fotografía

Alt: película + noche, no «imagen1». Ver doc 09.

[COMPROBADO] Los cuatro covers existen en assets/sesiones/.

6. Registro R-IN

Inmersión de sala a oscuras (velvet) + dock flotante + feed sobre foto a sangre. No es un dashboard de seguros. No es un kiosk de horas. No es una mesa de datos de archivo. No es neón de multiplex.

La innovación está en H-FEED Pliego + S-DOCK + F-STORY, no en un look «cine LED». [DECISIÓN]

7. Anti-moods

8. Densidad (AP-21)

En el recorte Pliego: eslogan + still dominante + 4 tarjetas con título, noche, butacas y estado visibles sin hover. Headline huérfano + foto = card hueca. [COMPROBADO] CRON §5.8 / D-P1-09 foto-led.

Still ≥40 % del recorte 16/10. Feed overlay no tapa el oficio de la foto: legible, no sticker. [DECISIÓN]

9. Motion

10. Voice visual ↔ copy

El mood candlelit refuerza el microcopy: butaca de sala, no taquilla. Si la UI parece multiplex (neón, QR, precio), el copy irrenunciable pierde fuerza. [DECISIÓN]

08-design-system.md

08 — Sistema de diseño — BOBINA

1. Tokens

Tailwind: bg-ground, text-cream, bg-card, bg-brass, text-mute, text-oxblood, font-display.
La tarjeta vive sobre --card; el ground es velvet alrededor. [DECISIÓN]

2. Contraste (obligatorio)

[DECISIÓN] Brass nunca como color de párrafo. Mute nunca como único color de disclaimer largo.

3. Escala de tipo

4. Componentes

Tarjeta de sesión (feed)

Cover recorte + título Cormorant · director · when_label · remaining/seats · status. Toda la tarjeta es el hit. Destino /sesion/:code. Orden por sort_order.

Still Pliego (UI-01)

Imagen a sangre ≥40 % del frame 16/10; gradient velvet→transparente para legibilidad del feed; wordmark + eslogan.

Relato de sesión

Cover, título display, dl director / noche / butacas / estado, blurb, bloque de copy irrenunciable, CTA Pedir butaca (cream sobre brass o brass outline según contraste).

Form pedir

Nombre, note opcional, sesión en solo lectura (código, título, noche), disclaimer, submit brass.

Success

Código Cormorant enorme + bloque card con título y noche + 4 oposiciones en cream/mute.

Fila de mesa PROGRAMADOR

Código · status · título · when_label · remaining · pedidoCount. Pedidos debajo: name · code · note · hora. Sin acciones PATCH en v1.

Login

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

Dock (S-DOCK)

Tres slots: Cartelera · Pedir · Mesa. Activo: brass. Idle: mute. Fondo card/velvet con blur ligero opcional. Targets ≥44px.

Skeleton

animate-pulse bg-card. aria-busy.

Error

Titular display + cuerpo cream/mute + Reintentar brass.

Sello COMPLETA / ABIERTA

Texto «Completa» / «Abierta» + oxblood o brass/mute. Nunca solo el color. Poco: un sello por vista, no un header oxblood.

5. Layouts

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

6. Estados de control

7. Iconografía

Dock: pictogramas simples (cartelera / butaca / mesa). Stroke 1.5–2px. No icon packs «ticket multiplex». [DECISIÓN]

8. Elevación y bordes

9. Mapa a Paper UI

[COMPROBADO] Inventario en 00-paper-reference.md.

09-content-guide.md

09 — Guía de contenido — BOBINA

1. Voz

BOBINA habla como sala de cineclub, no como taquilla ni como app de streaming.

[DECISIÓN] Tuteo en UI. Marta en mesa puede verse en usted solo en docs, no en labels.

2. Microcopy irrenunciable

Presente en cartelera (pie o banner), relato, pedir, success y pie de mesa:

No se parafrasean hasta diluirlas. Pueden acortarse en UI estrecha manteniendo ≠. [DECISIÓN]

3. Glosario UI

4. Pantalla a pantalla

Cartelera /

Sesión /sesion/:code

Pedir /pedir/:code

Success /ok/:code

Login /login

Mesa /mesa

5. Alt text de imágenes

Evitar «imagen1», «poster.jpg», spoilers largos. [DECISIÓN]

6. Títulos seed (atrezzo)

Los títulos Erice/Saura son catálogo demo. En UI no se afirma «programación oficial Filmoteca». Blurbs pueden recordar sesión ≠ estreno. [SUPUESTO de cartelera]

7. Tono de error

Sin culpa al usuario. Sin jerga HTTP en UI.

8. Anti-copy (vetado)

9. Criterios de aceptación de contenido

1. Las cuatro oposiciones aparecen al menos en success y en una superficie de cartelera o pedir.
2. Ningún CTA dice Comprar / Play / Entrada.
3. COMPLETA se etiqueta «Completa», no «Agotado» retail.
4. Códigos se muestran como BOB-XXXX en versales.
5. Docs y UI no inventan KPIs numéricos de Vallecas como hecho.

10-accessibility.md

10 — Accesibilidad — BOBINA

1. Objetivo

Cumplir WCAG 2.2 AA en el vertical slice L1. Ground oscuro (velvet): el par cream sobre velvet es el contrato de legibilidad. Inma Peña (68) es persona de diseño que fuerza contraste, tamaño y targets; no tiene login. [COMPROBADO] requisito del encargo · [DECISIÓN] persona Inma en docs.

2. Contraste

[DECISIÓN] Si mute falla AA en párrafo, se asciende a cream. Brass no escribe disclaimers.

Verificación: contraste en tokens al build de UI; no se afirman ratios inventados sin medir en implementación. [HIPÓTESIS operativa] cream/velvet pasa; se valida en QA (doc 13).

3. Tipografía y lectura

4. Targets y pointer

Spacing entre slots del dock ≥ 8px. [DECISIÓN]

5. Teclado y foco

Sin keyboard traps. Esc no es obligatorio en v1 (sin modales Must).

6. Semántica y nombres

7. Imágenes y still

[DECISIÓN] Preferir still con alt útil en cover UX; en producto, si el overlay ya nombra BOBINA y las noches, evitar alt redundante largo.

8. Motion

9. Estados y color

COMPLETA / ABIERTA / error nunca se comunican solo con color: texto + sello. Oxblood refuerza, no sustituye. [DECISIÓN]

10. Auth y a11y

• Login solo PROGRAMADOR; Inma no necesita cuenta para leer cartelera.
• Mensajes de error de login claros, sin enumerar si el email existe (seguridad + claridad).
• /mesa redirige a login con foco en email.

11. Mobile 390

• Dock fijo no tapa el CTA final: padding-bottom ≥ altura dock.
• Formularios: autocomplete name on; password current-password.
• Viewport meta; sin zoom bloqueado. [DECISIÓN]

12. Criterios de aceptación a11y

1. Cream sobre velvet usado en cuerpo; mute limitado a meta.
2. Targets dock y CTA ≥ 44×44.
3. Focus visible brass en todos los interactivos.
4. Status con texto, no solo color.
5. Reduced motion respetado.
6. Form con labels y errores anunciables.
7. Ningún toast único sin pantalla como único success (hay /ok/:code).

13. Fuera de v1 (Could)

• Modo tipográfico «letra grande» persistente para Inma.
• Transcripciones / audiodescripción de películas (fuera de producto L1).
• ATAG de CMS (no hay CMS).

11-privacy-security.md

11 — Privacidad y seguridad — BOBINA

1. Principios

[DECISIÓN] No se inventa un aviso legal largo de Filmoteca; hay disclaimer de producto y minimización real.

2. Datos tratados

No se tratan: pago, tarjeta, geolocalización, ID de dispositivo publicitario, mensajes de chat.

[SUPUESTO] El cineclub demo opera en España; el slice no implementa un RCPD completo de asociación real.

3. Superficies públicas vs privadas

[DECISIÓN] Enumerar vecinos en el feed rompería privacidad de sala; solo Marta ve nombres.

4. AuthN / AuthZ

Credenciales demo en docs: marta@bobina.cine / password123. No reutilizar en producción real. [COMPROBADO] demo · [DECISIÓN] rotar fuera del case.

5. Amenazas y mitigaciones L1

6. Contenido de note

note es texto libre. No se ejecuta. Se muestra a Marta en mesa. Longitud max sugerida 280 caracteres. [DECISIÓN]
No se pide dirección, salud ni datos de terceros sensibles en el form.

7. Cookies y tracking

v1 no incluye analytics de terceros ni banners de cookies de ads. North star es modelo (doc 12). [DECISIÓN]
Token JWT puede vivir en localStorage (XSS risk aceptado en demo) o memory; documentar en handoff.

8. Logs

9. Criterios de aceptación

1. GET mesa sin Bearer → 401.
2. GET sesiones no incluye name de pedidos.
3. POST pedir no exige auth ni pago.
4. Password solo como hash bcrypt.
5. .env no versionado con secretos reales.
6. Copy de success no implica contrato de compra.

10. Fuera de v1

DPO, ROPA formal, exportaciones ARCO automatizadas, SSO, 2FA, WAF. Roadmap L4 si el cineclub deja de ser demo.

12-analytics.md

12 — Analytics y métricas — BOBINA

1. Norte

[COMPROBADO] North star sale del day brief / encargo.
[DECISIÓN] En v1 es modelo: no hay instrumentación obligatoria ni dashboard. No se afirman porcentajes medidos inventados.

2. Por qué esta north star

18:00 es umbral de tarde de barrio antes de la noche de proyección. [SUPUESTO] operativo de diseño, no dato de campo.

3. Métricas de soporte (modelo)

4. Eventos (contrato si se instrumenta L+1)

[DECISIÓN] Nunca enviar name ni note a analytics.

5. Cálculo north star (modelo SQL)

noches_abiertas = sesiones con status ABIERTA en la ventana
noches_con_pedido_pre_18 =
  noches_abiertas donde existe pedido con created_at::time < 18:00
                         (o created_at < día@18:00 local)
ratio = noches_con_pedido_pre_18 / noches_abiertas

Timezone: Europe/Madrid. [DECISIÓN]
v1 puede no persistir confirmada_at; se usa pedidos.created_at. [DECISIÓN]

6. Integridad de expectativa (cualitativa)

Señales a vigilar en demo / soporte (no KPIs inventados):

• «¿Compro la entrada?»
• «¿Dónde está el play?»
• «¿Es el estreno?»
• «¿Es el cine del centro?»

Mitigación: microcopy irrenunciable (doc 09). [HIPÓTESIS H2]

7. Qué no medir en v1

8. Criterios de aceptación

1. Docs y UI no muestran un % inventado como hecho.
2. North star documentada y alineada al brief.
3. Si hay eventos L+1, sin PII de pedidos.
4. Health y 401 mesa son checks de integridad, no vanidad.

9. Relación con seed

Seed tiene 3 ABIERTA + 1 COMPLETA. Un guión con POST sobre BOB-2604 antes de las 18:00 es el ejemplo narrativo del north star; no es un dato de mercado. [SUPUESTO de demo]

13-qa-test-plan.md

13 — Plan de QA — BOBINA

1. Alcance

Smoke y regresión del vertical slice L1: feed, relato, pedir, success, login, mesa, empty/error/loading, mobile 390, contraste cream/velvet.
No incluye campo real de Vallecas ni load test de multiplex.

2. Entornos

3. Smoke crítico (Must pasar)

4. Regresión funcional

5. Accesibilidad (muestra)

6. Contenido

7. Visual / Paper

8. API negativa

9. Datos de prueba

Tras smoke: re-seed para restaurar remaining. [DECISIÓN]

10. Criterio de salida

Smoke S01–S12 en verde. Sin P0 (health mal, pedir roto, mesa abierta sin auth, copy Cinesa ausente en success).
P1 visual puede quedar anotado; no bloquea docs.

11. Fuera de alcance QA v1

Penetration test, auditoría RGPD formal, subtítulos de película, compatibilidad IE, métricas reales de north star instrumentadas.

14-dev-handoff.md

14 — Handoff a desarrollo — BOBINA

1. Contrato vivo

Si código y docs divergen, alinear ambos; no silenciar leftover LOMO como producto. [DECISIÓN]

2. Definition of Done (DoD) L1

3. Mapa Paper → Angular

4. API checklist

Body pedir: { name: string, note?: string }.
Decremento atómico de remaining. [DECISIÓN] ver doc 05.

5. Seed y credenciales

6. Anti-patrones de implementación

7. Assets

Copiar desde case:

• assets/sesiones/colmena.jpg
• assets/sesiones/golfos.jpg
• assets/sesiones/cuervos.jpg
• assets/sesiones/sur.jpg
• assets/hero.jpg (referencia / cover)

[COMPROBADO] existen en el case.

8. QA mínimo antes de merge

Ejecutar smoke S01–S12 (doc 13). Verificar copy irrenunciable en /ok/:code.

9. Open questions (no bloquean L1)

10. Contacto de diseño

Paper file + docs 07–09. No reinventar neón multiplex. Mood candlelit. Ground #1A1210.

15-roadmap.md

15 — Roadmap — BOBINA

1. Horizonte

[DECISIÓN] Este case no implementa L4. El roadmap evita colar VOD/taquilla como «L1 incompleto».

2. Hecho en L1 (Must)

3. L+1 (Could cercano)

Fuera de L+1: pago, Filmin, cuenta de vecino, chat, GPS.

4. L4 (explícitamente otro producto)

5. Anti-roadmap (no disfrazar)

6. Dependencias

7. Criterios para abrir L+1

1. Smoke L1 en verde.
2. Copy irrenunciable intacto.
3. Ningún item L+1 introduce pago/VOD/chat.
4. North star sigue siendo modelo o se instrumenta sin PII.

8. Cierre

L1 está completo en definición. El roadmap no es una lista de deuda disfrazada: es un muro contra el multiplex y el VOD. [DECISIÓN]

16-interaction-specs.md

16 — Especificación de interacción — BOBINA

1. Convenciones

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

2. Cartelera feed (UI-01) + mobile (UI-02) · H-FEED Pliego

AC: título, noche, butacas y estado visibles sin hover. Still ≥40 % del recorte 16/10 (AP-21 / D-P1-09). Cero botones Comprar / Play / Entrada.

El aviso «Cartelera ≠ Filmin» es texto, no un CTA de VOD. [DECISIÓN]

390: mismas 4 tarjetas apiladas. No carousel. Dock visible. [DECISIÓN]

3. Sesión relato (UI-03) + mobile (UI-04) · F-STORY

AC: una pantalla de relato. Cero pago. Cero «Ver en Filmin». Cero «Pedir mesa» (LOMO).

4. Pedir (UI-05)

AC: no email, no DNI, no pago. Pedir butaca ≠ entrada Cinesa visible.

5. Success (UI-06)

AC: las cuatro oposiciones están. No QR. No «ticket listo».

6. Login (UI-07)

AC: sin signup. Ayuda demo mute.

7. Mesa PROGRAMADOR (UI-08)

AC: no columnas Recibido / En curso. No PATCH estado. No split lista|ficha.

8. Dock (UI-11) · S-DOCK

AC: tres slots. No hamburger. Targets ≥44px. Fijo en 390.

9. Empty / Error / Loading (UI-09 / UI-10)

10. Motion

Sin Ken Burns agresivo sobre el Pliego. [DECISIÓN]

11. Guión de interacción demo

1. / loading → 4 noches + still.
2. Hover/tap Cría cuervos → relato COMPLETA → CTA disabled.
3. El sur → Pedir butaca → form Luis → pending → success.
4. Dock Mesa → login → mesa con pedido.
5. 390: dock no tapa CTA; scroll con padding.

12. Criterios de aceptación de interacción

1. F-STORY no salta el relato.
2. COMPLETA no permite POST.
3. Pending no doble-envía.
4. Dock siempre alcanzable en 390.
5. Focus visible en todo el recorrido teclado.

17-prototype-map.md

17 — Mapa de prototipo — BOBINA

1. Fuentes

[COMPROBADO] conteos y file ID en docs/00-paper-reference.md.
Esta entrega de docs no abre Paper ni arranca la app.

2. UX process → docs

3. UI producto → rutas / componentes

4. Flujo prototipo clickable (orden demo)

UI-01 Cartelera
  ├─→ UI-03 Sesión (BOB-2603 COMPLETA)
  │     └─→ (CTA disabled) → back UI-01
  ├─→ UI-03 Sesión (BOB-2604 ABIERTA)
  │     └─→ UI-05 Pedir → UI-06 Success
  ├─→ UI-02 (mismo /, viewport 390)
  └─→ UI-11 Dock → Mesa → UI-07 Login → UI-08 Mesa

Estados: UI-09 empty · UI-10 error/loading se prueban desconectando API o seed vacío.

5. Datos de prototipo = seed

Hotspots Paper deben usar estos códigos en labels si muestran URL. [DECISIÓN]

6. Breakpoints de artboard

7. Terna visible en prototipo

8. Gaps conscientes

9. Criterios de aceptación del mapa

1. Cada UI-00…11 tiene fila en esta tabla.
2. Cada ruta Must tiene artboard.
3. No hay artboard de /buscar, /lomo, taquilla o player.
4. Mobile 390 cubierto (UI-02, UI-04).

18-completeness-audit.md

18 — Auditoría de cierre — BOBINA

1. Alcance L1

2. Terna y diversidad

3. Copy irrenunciable

Presente en cartelera, relato, pedir, success, pie de mesa. Ver doc 09.

• Pedir butaca ≠ entrada Cinesa
• Sesión ≠ estreno
• Cartelera ≠ Filmin
• BOBINA no es los cines del centro

4. Anti-patrones vigilados

5. Seed

4 sesiones · 3 ABIERTA · 1 COMPLETA · Marta PROGRAMADOR · Luis sin cuenta · Inma fuera de login.

6. Assets

7. Huecos conscientes (fuera)

Pago, login Inma, email transaccional, instrumentación analytics, VOD, confirmada_at, player, Filmoteca real.

8. Checklist archivos suite

9. Veredicto

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

19-backlog-completo.md

19 — Backlog completo — BOBINA

1. Leyenda

2. Épica A — Cartelera H-FEED

3. Épica B — Relato F-STORY

4. Épica C — Pedir butaca

5. Épica D — Mesa PROGRAMADOR

6. Épica E — Chrome S-DOCK

7. Épica F — Design system & a11y

8. Épica G — Plataforma

9. Épica H — Documentación & diseño

10. Prioridad de build sugerida

1. Schema + seed + health
2. GET sesiones + CarteleraPage Pliego
3. SesionPage + estados ABIERTA/COMPLETA
4. POST pedir + OkPage copy
5. Auth + MesaPage
6. Dock + 390 + empty/error/loading
7. Pulido tokens / a11y / smoke S01–S12

11. Contadores

No se inventan story points ni velocidades de equipo. [DECISIÓN]

20-implementation.md

20 — Implementación — BOBINA

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: sesiones + pedidos + JWT PROGRAMADOR. Puerto 3026. Health bobina-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 LOMO (ejemplares, BIBLIO, HoyPage, lomo-api, puerto 3025) al inicio del rewrite. Eso no es BOBINA. El rewrite borra ese dominio.

2. Cómo arrancar

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

# apps/api/.env
#   DATABASE_URL=<neon tiny-feather-31905339>
#   JWT_SECRET=<secret>
#   PORT=3026

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

Credenciales

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

Vecino / vecina mayor: sin cuenta. Luis pide en /pedir/:code. Inma no entra por login.

3. Schema

Al boot o vía migrate:

1. CREATE TABLE de users, sessions, sesiones, pedidos (doc 05).
2. Índices: sesiones(code), sesiones(status), sesiones(sort_order), users(email), pedidos(sesion_id), pedidos(created_at DESC).
3. Seed idempotente:
   • upsert PROGRAMADOR marta@bobina.cine (hash bcrypt canónico)
   • upsert sesiones por code (BOB-2601…BOB-2604) restaurando status y remaining de catálogo
   • pedidos: no borrar pedidos de demo recientes salvo re-seed explícito
4. Dominio: solo sesiones + pedidos + users. [DECISIÓN]

Upsert de sesiones por code sí restaura status/remaining de catálogo para que el guión sea repetible. [DECISIÓN]

No generar códigos nuevos en el POST: el success reusa BOB-2604.

Tablas (recordatorio)

DROP leftover ejemplares, programas, repeticiones, nodes, altas si existen en el mismo Neon. [DECISIÓN] El project tiny-feather-31905339 es de BOBINA.

Seed SQL (modelo)

[SUPUESTO de cartelera] Títulos demo.

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 === PROGRAMADOR protege /mesa.
• Públicos: health, sesiones, sesiones/:code, POST pedir, login.

Oficio

Health (referencia de implementación)

{ "ok": true, "service": "bobina-api" }

Cualquier leftover "lomo-api" o "onda-api" falla el DoD.

POST pedir — algoritmo

1. Validar body.name (trim, length >= 2) else 400
2. SELECT sesión FOR UPDATE by code
3. Si no existe → 404
4. Si status != ABIERTA OR remaining <= 0 → 409
5. INSERT pedidos (sesion_id, code, name, note)
6. UPDATE remaining = remaining - 1
7. Si remaining = 0 → status = COMPLETA
8. 201 { code, title, status, remaining, pedida: true }

Transacción única. [DECISIÓN]

GET mesa — shape

{
  "sesiones": [ { ...sesion, "pedidoCount": n } ],
  "pedidos": [ { "id", "code", "name", "note", "createdAt" } ]
}

Orden pedidos: created_at DESC. [DECISIÓN]

5. Frontend Angular

Rutas

Servicios

UI Must

1. CarteleraPage — still + feed overlay (Pliego), no tabla H-DATA.
2. SesionPage — F-STORY.
3. PedirPage — form.
4. OkPage — código + 4 oposiciones.
5. LoginPage / MesaPage.
6. DockComponent — S-DOCK.
7. Estados empty/error/loading.

Tailwind tokens

ground: #1A1210
cream: #F4EDE4
card: #241C18
brass: #C4A574
mute: #8A7A6E
oxblood: #9A3B2F
font-display: Cormorant Garamond
font-sans: Manrope

6. Assets en app

Copiar desde el case a apps/web/public/assets/sesiones/ (o path equivalente servido):

• colmena.jpg
• golfos.jpg
• cuervos.jpg
• sur.jpg

Paths en DB alineados a /assets/sesiones/.... [DECISIÓN]

7. Checklist anti-leftover

8. DoD técnico (merge)

1. Smoke S01–S12 (doc 13) en verde.
2. Health bobina-api.
3. Seed idempotente.
4. Mesa 401 sin token.
5. Success muestra las 4 oposiciones.
6. 390 + dock usable.
7. 0 referencias de producto a ejemplares/BIBLIO/lomo-api.
8. Cream sobre velvet en cuerpo.

9. Fuera de esta especificación

• Deploy Vercel/Netlify (Could).
• CI axe completo (Could L+1).
• Instrumentación analytics (doc 12 modelo).
• Regeneración Paper (fuera de docs-only).

10. Cierre

Implementación = contrato ejecutable. Esta suite de docs es la fuente de verdad del case 2026-08-26-bobina mientras el rewrite corre en paralelo. [COMPROBADO] alcance docs-only del encargo.