00-day-brief.md

00 — Day brief · 2026-08-25 · LOMO

Decisiones ALS-2 BRIEF

Terna unicidad

R-CL · S-CMD · H-DATA · F-LEAD

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

S-CMD, H-DATA y F-LEAD no están en los últimos 5.

Ground (CRON §5.6)

• Familia: G-STONE
• Hex: #E4E0D6
• Por qué: polvo de caliza en la sala, no papel de cartel (ONDA), no hielo (RAMAL), no tinta de flight case (TEMPLE).

Mood visual (Paper)

• Candidatos: bookish/yeso (primer instinto biblioteca), mineral, chapel, alpine, fog
• Elegido: mineral — no el primer instinto librería cálida. Un lomo se lee bajo la caliza, con metal oxidado.
• Paleta:
  • #E4E0D6 caliza (ground)
  • #1C2B28 tinta de lomo
  • #FFFFFF ficha
  • #3E6B5E cobre oxidado (mark)
  • #5F6B67 mute
  • #9A5340 sello (poco)
• Tipo: Source Serif 4 display · Outfit UI

Alcance L2 must

1. Home datos: métricas de hoy + 4 ejemplares
2. Comando de búsqueda (signatura / título)
3. Ficha de lomo (sala, estado)
4. Pedir reserva de mesa (pedir ≠ préstamo a casa)
5. Login JWT BIBLIO
6. Mesa de hoy (lista + pedidos)
7. Empty / error / loading / mobile data
8. ≥12 UX + ≥10 UI

Microcopy duro

• Reserva de sala ≠ préstamo a casa. No se lleva el libro.
• Lomo ≠ catálogo municipal. No sustituye a Absys ni al distrito.
• Pedir ≠ apuntarse al club. No inscribe al taller.
• LOMO no es la Biblioteca Regional.

Supuestos

• S1: La sala atiende 2–4 ejemplares/día en el slice; demo 4.
• S2: Rafa busca sin cuenta. JWT solo BIBLIO.
• S3: Nora (restauradora) fuera del producto.
• S4: Sin préstamo a domicilio, sin GPS, sin chat. [DECISIÓN]

Hipótesis

00-paper-reference.md

Paper reference · LOMO

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 Mesa datos · UI-02 Mesa mobile · UI-03 Comando · UI-04 Lomo · UI-05 Lomo mobile · UI-06 Pedir · UI-07 Success · UI-08 Login · UI-09 Mesa BIBLIO · UI-10 Empty · UI-11 Error+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 — LOMO

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.
[SUPUESTO de catálogo] Usera / El río Manzanares / Planos de Usera es atrezzo de mercado, no el fondo de una biblioteca municipal real.

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

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] El lector de Usera no necesita Absys ni la Biblioteca Regional: necesita saber si hay mesa para este lomo hoy sin hacer cola en el mostrador. Hoy eso vive en un cartel, una cola y una expectativa de préstamo a casa. La mesa de ocupación se lee como catálogo municipal; pedir mesa se lee como llevarse el libro; el producto se lee como la Regional. [SUPUESTO] Una sala atiende 2–4 ejemplares/día; no opera un préstamo a domicilio ni un club de lectura.

Secundarios

Supuestos (no investigación primaria propia)

• S1: La sala atiende 2–4 ejemplares/día en el slice; demo 4. [SUPUESTO]
• S2: Rafa busca sin cuenta. JWT solo BIBLIO. [SUPUESTO]
• S3: Nora (restauradora) fuera del producto. [SUPUESTO]
• S4: Sin préstamo a domicilio, sin GPS, sin chat. [DECISIÓN]

Hipótesis de producto

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

3. Propuesta de valor

No es LOMO

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L2 archivo / biblioteca de barrio con Ejemplar + pedido + JWT BIBLIO.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable.
• Terna R-CL · S-CMD · H-DATA · F-LEAD frente a ONDA (rail/galería/archivo), RAMAL (split/portada/alta) y PIZARRA (search-first/distrito).
• No encadenar otro L1 tras ONDA. [DECISIÓN]

Usuario

No objetivos v1 (explícitos)

• Préstamo a domicilio, carnet, sanciones, devolución
• Catálogo municipal, Absys, OPAC, fondo completo
• Club de lectura, inscripción, lista de espera de taller
• Chat, kanban, columnas Recibido / En curso
• Cuenta de lector, socio, newsletter
• GPS, mapa de sedes, horario de la Regional
• Multi-sede, multi-bibliotecaria
• App nativa ni notificaciones push
• Rol RESTAURADORA autenticado
• 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: BIBLIO. El lector no es un usuario del sistema: es autor/autora de un pedido. La restauradora no es un rol de sistema el día 1.

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

7. Alcance funcional v1 (L2)

8. Criterios de aceptación de producto

1. / es la mesa de datos de hoy (métricas + 4 filas). No pide cuenta. No es un hero 2-col + 3 cards. No es una galería de cubiertas.
2. Un lector puede ver 4 ejemplares, tocar El río Manzanares, pedir mesa y obtener acuse en /ok/LM-2501.
3. /ok/:code dice explícitamente que reserva de sala no es préstamo a casa y que lomo no es catálogo municipal.
4. La UI dice explícitamente que LOMO no es la Biblioteca Regional y que pedir no es apuntarse al club.
5. Sin token, GET /api/mesa responde 401. POST /api/ejemplares/:code/pedir y GET /api/ejemplares son públicos.
6. Un POST de pedir no crea user, no abre préstamo, no inscribe al club, no mueve kanban.
7. Un BIBLIO inicia sesión y ve 4 ejemplares (2 DISPONIBLE, 1 EN_SALA, 1 PEDIDO) 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 lomos/*).
10. Chrome S-CMD: barra «buscar lomo o signatura». Mesa de datos sin top-nav de marketing y sin rail de radio.
11. Rutas solo las del doc 03. No existen /programa, /hoy JWT de ONDA, /nodos, /alta, /playlist, /prestamo.
12. GET /api/health devuelve service: "lomo-api" (no onda-api, no ramal-api).
13. La mesa pública no muestra nombres de otros lectores; la mesa BIBLIO sí muestra pedidos con nombre.
14. /buscar?q=manzanares devuelve El río Manzanares.

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-CL · S-CMD · H-DATA · F-LEAD. 0 códigos iguales a N−1 (ONDA). ≥2 distintos vs N−2 (RAMAL) y N−3 (TEMPLE). S-CMD, H-DATA y F-LEAD no están en los últimos 5. Ventana 4 días: R-HY (TEMPLE) + R-CL (RAMAL) + R-HY (ONDA) + R-CL. Ground G-STONE #E4E0D6, no G-SIGN ni G-ICE.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — LOMO

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 archivos y salas de lectura de barrio (mostrador, signatura, ejemplar que no sale, restauradora que no entra el día 1, bibliotecaria que lee ocupación no un OPAC).
• Analogía operativa con superficie pública + panel JWT de la serie daily.
• Restricciones ALS-2: no préstamo a casa, no catálogo municipal, no club, 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 sala (quién pone la mesa de hoy) y, en uso diario, Inés (quien mira pedidos).
• Usuario frecuente de pedir mesa: LECTOR (datos + comando + ficha + form, sin cuenta).
• Usuario frecuente de oficio: BIBLIO (mesa /mesa).
• Riesgo de rechazo: si el acuse parece un préstamo; si la fila parece un título de OPAC; si hay que crear cuenta; si la mesa parece un kanban; si el comando parece el buscador del distrito.

4. Personas

P1 — Inés Soto · BIBLIO

Escenario: Entra a /login, abre /mesa, lee LM-2501 El río Manzanares DISPONIBLE, ve los pedidos. El copy dice que una reserva no es préstamo a casa.

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

P2 — Rafa Díez · LECTOR

Escenario: Abre / en el mostrador, ve la fila de El río Manzanares DISPONIBLE, o busca «manzanares» en el comando, toca la ficha, pide mesa, lee «reserva ≠ préstamo a casa» y el código LM-2501.

[COMPROBADO] Nombre, edad y gesto (lector, 63) salen del encargo. Es constructo de diseño, no entrevistado. [DECISIÓN]
Rafa no tiene fila en users. [DECISIÓN]

P3 — Nora Ruiz · RESTAURADORA (docs)

[COMPROBADO] Nombre, edad y exclusión de login salen del encargo. [DECISIÓN] no hay cuenta RESTAURADORA en v1.

5. JTBD

Job principal (lector)

Cuando quiero saber si hay mesa para este lomo hoy, quiero ver la ocupación y pedir reserva de sala sin hacer cola, para dejar constancia en el mostrador sin que eso signifique préstamo, cuenta ni club.

Job principal (bibliotecaria)

Cuando hay ejemplares hoy y pedidos nuevos, quiero ver la lista de hoy y los pedidos, para mover el oficio de la sala sin un kanban ni un OPAC.

Jobs que LOMO no hace

6. Stories Must (v1)

Could (fuera de L2): login de Nora, préstamo, fondo completo, chat, cuenta de lector, Absys.

7. Journey (resumen)

1. Rafa abre /. Ve métricas (2 disponibles, 1 en sala, 1 pedido) y 4 filas. Lead El río Manzanares DISPONIBLE. [H1]
2. Toca El río Manzanares → /lomo/LM-2501. (O busca «manzanares» en /buscar.)
3. Lee sala 2, estado Disponible. Copy irrenunciable.
4. Toca Pedir mesa → /pedir/LM-2501. Escribe su nombre. POST → /ok/LM-2501. Lee las cuatro oposiciones.
5. Inés entra a /login → /mesa. Lista + pedidos.
6. Lee LM-2501 y el pedido de Rafa. Copy: reserva no es préstamo a casa.

Backstage: Nest + Neon + JWT. Nora no entra. El lomo no sale. No hay Absys.

8. Blueprint (resumen)

9. Matriz hallazgo → requisito → feature

10. Preguntas que este case no responde

• ¿Cuántas reservas reales hay en Usera en 2026?
• ¿Qué archivo opera El río Manzanares?
• ¿Rafa preferiría la cola?
• ¿Nora necesita un cuadrante de restauración?
• ¿Inés confirmaría la mesa antes de las 11: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.
Las personas son constructos. Usera / El río Manzanares / Planos de Usera son [SUPUESTO de catálogo].
ONDA no se investiga como producto vivo: es N−1; leftover programas / CONDUCTOR no es LOMO.

03-information-architecture.md

03 — Arquitectura de información — LOMO

1. Principios de IA

2. Sitemap

/                                      Mesa de datos pública (métricas + 4 filas)     H-DATA
/buscar                                Comando · query + resultados                  S-CMD · público
/lomo/:code                            Ficha de lomo                                 público
/pedir/:code                           Form reserva de mesa                          F-LEAD · público
/ok/:code                              Acuse post-pedido                             público
/login                                 Login JWT BIBLIO                              público
/mesa                                  Lista + pedidos                               auth
/**                                    → redirect /

Árbol por audiencia

[COMPROBADO] Siete rutas del encargo L2. No se inventan /programa, /hoy (JWT ONDA), /nodos, /alta, /playlist, /prestamo, /club, /absys.

La búsqueda sí es ruta (/buscar): el comando se demuestra; la home sigue siendo datos. [DECISIÓN]
La ficha sí es ruta (/lomo/:code) porque el comando y la mesa necesitan URL compartible. [DECISIÓN]
El form sí es ruta (/pedir/:code): F-LEAD es un paso, no un POST oculto en la ficha. [DECISIÓN]
/ok/:code usa el código de ejemplar (LM-2501), no un código de petición distinto. L2 compacto. [DECISIÓN]

3. Navegación

Comando (S-CMD · todas las superficies salvo login/ok pueden mostrarlo)

[DECISIÓN] El comando es la navegación primaria de hallazgo. La mesa de datos es la de ocupación. No hay rail Estudio / Buscar / Hoy (eso fue ONDA). No hay split (RAMAL), no dock, no kiosk mínimo (TEMPLE).

Desktop ≥960px: cabecera con wordmark + campo comando (~56px) + panel de datos.
El overlay de comando (UI-03) se abre al foco o al pulsar / · ⌘K. Submit navega a /buscar?q=. [DECISIÓN]
Mobile ~390px: campo de comando bajo el wordmark; la tabla se apila. [DECISIÓN] En 390 el comando no compite con un hamburger.

Mesa pública (H-DATA)

[DECISIÓN] La mesa de datos no tiene tabs de marketing, no tiene «Catálogo / Préstamo / Club». El comando basta para hallar.

Chrome de ficha y lead (F-LEAD)

Chrome de mesa (/mesa autenticado)

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

4. Etiquetas de IA (UI)

En docs puede decirse «mesa de datos» para H-DATA y «mesa BIBLIO» para el oficio JWT. En UI pública el titular es Hoy. 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 búsqueda

La búsqueda sí es Must (S-CMD), pero no es la home (eso rompería H-DATA y copiaría PIZARRA). 4 ejemplares caben en la tabla; el comando se demuestra con q=manzanares → El río Manzanares. [DECISIÓN]
Inés no filtra la mesa en v1: ve el hoy entero + pedidos. Could L+1: filtro por estado.

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

8. Códigos y URLs

API puede normalizar lm-2501 → LM-2501. En UI siempre versales.

9. Lo que no entra en el mapa

/programa, /programa/:code, /hoy (JWT ONDA), /nodos, /alta, /mesa/:code, /playlist, /prestamo, /club, /inbox, /kanban.
Si el rewrite de lomo-app todavía tiene rutas ONDA (/programa, /hoy JWT, GalleryPage), no son el producto. Gana este doc.

04-user-flows.md

04 — Flujos de usuario — LOMO

1. Convenciones

2. F1 — Lector pide mesa desde la ocupación (Must)

/  →  GET /api/ejemplares
   →  tap fila El río Manzanares  →  /lomo/LM-2501
   →  GET /api/ejemplares/LM-2501
   →  tap Pedir mesa  →  /pedir/LM-2501
   →  escribe nombre «Rafa Díez»
   →  POST /api/ejemplares/LM-2501/pedir  { nombre }
   →  201 { code: LM-2501, title, status: PEDIDO, pedida: true }
   →  /ok/LM-2501

Entrada: mesa de datos, sin cuenta.
Salida: código visible + copy «reserva de sala ≠ préstamo a casa».
Errores: red (reintentar), 404 lomo, 409 no disponible, 0 ejemplares (empty).

AC

• El form no pide email, DNI ni signup.
• POST no cobra, no crea user, no abre préstamo, no inscribe al club.
• /ok/LM-2501 muestra las cuatro oposiciones.
• El paso /pedir/:code existe: F-LEAD no es un POST oculto en la ficha. [DECISIÓN]

3. F2 — Lector busca en el comando (Must)

/buscar  →  escribe «manzanares»  →  GET /api/ejemplares?q=manzanares
         →  resultados (El río Manzanares)
         →  tap  →  /lomo/LM-2501
         →  (sigue F1 desde la ficha)

Desde /, el foco en S-CMD abre overlay (UI-03) o navega a /buscar?q=. [DECISIÓN]

Entrada: comando, sin cuenta.
Salida: al menos El río Manzanares para q=manzanares.
Errores: q=zzzz → empty «Sin lomos.»; red → UI-11.

AC

• Home sigue siendo datos. /buscar no redirige a / con un hero ni con H-SEARCH.
• Query visible en el campo. Compartible /buscar?q=manzanares.
• Cero facetas de distrito / precio (eso fue PIZARRA).
• Cero archivo de programas (eso fue ONDA).

4. F3 — Bibliotecaria entra a mesa (Must)

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

AC

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

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. / — métricas + 4 filas. Lead El río Manzanares DISPONIBLE. Eslogan. Comando.
2. Tap El río Manzanares — ficha DISPONIBLE · sala 2.
3. Pedir mesa — /pedir/LM-2501 · nombre Rafa Díez.
4. Enviar — /ok/LM-2501. Copy ×4.
5. /buscar?q=manzanares — un resultado.
6. /login — ines@lomo.barrio / password123.
7. /mesa — lista + pedidos; LM-2501; pedido de Rafa si se hizo el POST.
8. 390: filas apiladas, no carousel; comando visible.
9. API down: error + Reintentar.

9. Contratos de error de API (flujo)

05-data-model.md

05 — Modelo de datos — LOMO

1. Visión general

Dominio L2 de mesa de ejemplares + comando + lead autenticable:

Base: PostgreSQL (Neon project dawn-butterfly-79519092) · IDs: serial + texto estable (LM-2501).
[DECISIÓN] ensureSchema es válido si el contrato de tablas se cumple; el brief de stack no exige Prisma.

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

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

Role

EjemplarStatus

Pedir mesa solo está permitido en DISPONIBLE. EN_SALA y PEDIDO responden 409. [DECISIÓN]

3. Diagrama ER (texto)

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

sessions
  id, user_id → users
  expires_at, revoked_at
  created_at

ejemplares
  id
  code (unique, LM-XXXX)
  title, lead
  status (DISPONIBLE|EN_SALA|PEDIDO)
  sala (INTEGER 1–3)
  cover
  sort_order
  created_at, updated_at
  1 ──< pedidos

pedidos
  id
  ejemplar_id → ejemplares
  nombre
  created_at

v1: una sola BIBLIO opera sobre el conjunto global.
No hay FK de lector-usuario: el lector no se loguea.
pedidos.nombre es el nombre de mostrador (oral), no una cuenta.

4. Tablas

users

sessions

ejemplares

pedidos

Sin email, sin teléfono, sin DNI, sin carnet. Pedir ≠ apuntarse al club. [DECISIÓN]

Índices: ejemplares(code), ejemplares(status), ejemplares(sort_order), users(email), pedidos(ejemplar_id), pedidos(created_at DESC).

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

5. Seed

BIBLIO

ines@lomo.barrio / password123 · Inés Soto · BIBLIO
Hash bcrypt fijo: $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m

Ejemplares

[SUPUESTO de catálogo] Títulos, leads y salas son atrezzo. No es un fondo oficial.

Pedidos

Seed una fila: LM-2503 · nombre Carmen Vidal (constructo de mostrador, no cuenta).
El POST de smoke crea la de Rafa sobre LM-2501.
Inés puede ver 1 pedido al entrar en frío y ≥2 tras el guión.

El seed idempotente restaura los 4 estados de catálogo (2 DISPONIBLE, 1 EN_SALA, 1 PEDIDO) para que el demo sea repetible. [DECISIÓN]

6. JSON (camelCase)

API: sortOrder, createdAt, pedidoCount, cover, sala, status, title, code, lead, nombre.
SQL: sort_order, created_at, pedido_count derivado.

GET /api/ejemplares (item)

{
  "code": "LM-2501",
  "title": "El río Manzanares",
  "lead": "El río que corta Usera. Se lee en sala 2. No se lleva a casa.",
  "status": "DISPONIBLE",
  "sala": 2,
  "cover": "/assets/lomos/estante.jpg",
  "sortOrder": 1
}

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

Métricas de hoy (home puede derivarlas del array):

GET /api/mesa (JWT)

{
  "date": "2026-08-25",
  "ejemplares": [{ code, title, status, sala, cover, pedidoCount, sortOrder }],
  "pedidos": [{ code, title, nombre, createdAt, status }]
}

Orden ejemplares: DISPONIBLE, EN_SALA, PEDIDO, luego sort_order.
Orden pedidos: created_at DESC.

POST /api/ejemplares/:code/pedir → 201

Cuerpo:

{ "nombre": "Rafa Díez" }

Respuesta:

{
  "code": "LM-2501",
  "title": "El río Manzanares",
  "sala": 2,
  "status": "PEDIDO",
  "pedida": true
}

Nombre obligatorio. No email. Si el ejemplar no está DISPONIBLE → 409. Si no existe → 404. Si nombre vacío → 400.

El POST pasa el ejemplar a PEDIDO. [DECISIÓN]

7. Generador de código

Los códigos de ejemplar son de catálogo, no se generan en el POST de pedir. Seed LM-2501…LM-2504. L+1 que añada ejemplares usa LM- + 4 dígitos correlativos; no es Must.

El acuse reutiliza el code del ejemplar. No hay LM-P-…. [DECISIÓN]

8. Qué no se modela

06-tech-stack.md

06 — Stack tecnológico — LOMO

1. Visión

Stack fijo del cron (D-P0-03). No React/Next/Firebase.
[COMPROBADO] Puerto 3025, 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 ONDA (programas, repeticiones, CONDUCTOR, onda-api, puerto 3023) o leftover RAMAL (nodes, altas, VOCAL), no es el estado del producto. Gana el contrato LOMO.

2. Estructura

lomo-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: ejemplares, ?q=, :code, pedir, /mesa JWT. Health y login son el contrato de stack de la serie.
No se añaden Must extra (/programas, /repetir, /nodos, /altas, /prestamo).

Health: leftover onda-api → lomo-api. Puerto leftover de ONDA :3023 no se reutiliza: LOMO usa :3025. [DECISIÓN]

4. Justificación

5. Variables

.env local (nunca git):

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

postgresql://neondb_owner:npg_GDsv4KLefP5d@ep-empty-star-a69kwo3y-pooler.us-west-2.aws.neon.tech/neondb?sslmode=require

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

6. Módulos API

health · auth · users · ejemplares · mesa · database · common.

Health: HealthService.name = 'lomo-api'.
main.ts PORT default 3025.

No módulos programas, hoy (JWT ONDA), repeticiones, nodes, altas. Si el rewrite los encuentra, se borran o se sustituyen. [DECISIÓN]

7. Frontend

Páginas: HoyPage / · BuscarPage /buscar · LomoPage /lomo/:code · PedirPage /pedir/:code · OkPage /ok/:code · LoginPage /login · MesaPage /mesa.

Guard JWT en /mesa. Interceptor Bearer. Token key lomo.accessToken.

8. Lo que el stack no es

No es Absys. No es la Biblioteca Regional. No es un OPAC. No es Prisma obligatorio.
No es un leftover de programas/repeticiones: el contrato es ejemplares + pedidos + BIBLIO.
No es un leftover de radio: health no dice onda-api.

07-creative-direction.md

07 — Dirección creativa — LOMO

1. Concepto

LOMO es una mesa de ocupación bajo caliza: se entra a cuatro filas y se sale habiendo pedido una mesa, no una landing de «tu biblioteca». El ground es polvo de caliza. El cobre oxidado puntúa, poco. El sello terracota marca pedido, poco.

Mood elegido: mineral.
Primer instinto descartado: bookish / yeso (librería cálida). Un lomo se lee bajo la caliza, con metal oxidado, no sobre papel de novela.

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

2. Territorio visual

3. Paleta

Jerarquía de color: la caliza carga; el cobre puntúa; el sello marca pedido. Si el mark pinta fondos enteros, deja de ser óxido y se vuelve «brand verde». El seal no decora la cabecera: solo puntual (PEDIDO, error). El texto sobre mark es card/blanco o ink según contraste; nunca mute. [DECISIÓN]

Candidatos de mood descartados: bookish/yeso (primer instinto biblioteca), chapel, alpine, fog.

4. Tipografía

Prohibido: Source Serif 4 por debajo de 18px (se rompe). Outfit en el wordmark de hoy (se vuelve SaaS). Mark como color de texto de párrafo (contraste).

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

Outfit sí entra: el brief lo fija para UI. No es el Outfit vetado de un cooldown antiguo frente a un brief explícito. [COMPROBADO]

5. Fotografía

Alt: lomo + lugar, no «imagen1». Ver doc 09.

LM-2501 y LM-2504 comparten estante.jpg (disponibles). El lead y el título distinguen. [COMPROBADO] en seed.

6. Registro R-CL

Herramienta de datos de sala de lectura (clásica de archivo) + comando (oficio). No es un dashboard de seguros. No es un kiosk de horas. No es una galería de cubiertas. No es una librería cálida.

La innovación está en H-DATA + S-CMD + F-LEAD, no en un look «bookish». [DECISIÓN]

7. Anti-moods

8. Densidad (AP-21)

En el recorte de mesa de datos: eslogan + 3 métricas (disponibles / en sala / pedidos) + 4 filas con signatura, título, sala y estado visibles sin hover. Headline huérfano + foto = card hueca. [COMPROBADO] CRON §5.8.

08-design-system.md

08 — Sistema de diseño — LOMO

1. Tokens

Tailwind: bg-ground, text-ink, bg-card, bg-mark, text-mute, text-seal, font-display.
La fila vive sobre --card; el ground es caliza alrededor. [DECISIÓN]

2. Escala de tipo

3. Componentes

Fila de ejemplar (mesa de datos)

Thumb 4/3 recortado + signatura · título + sala + estado. Toda la fila es el hit. Destino /lomo/:code. Lead (El río Manzanares) ocupa la primera fila.

Métrica lead

Tres cifras: Disponibles · En sala · Pedidos. Número Source Serif, label Outfit mute. No gráficos.

Resultado de comando (buscar)

Misma anatomía en fila: thumb + título + sala + estado. Hit → ficha.

Overlay de comando (UI-03)

Campo a ancho de cabecera, resultados sobre card, query «manzanares». Esc cierra. Submit → /buscar?q=.

Ficha de lomo

Cubierta, título display, dl sala/estado/signatura, bloque de copy irrenunciable, CTA Pedir mesa (card sobre mark).

Form pedir

Nombre, ejemplar en solo lectura (código, título, sala), disclaimer, submit mark.

Acuse

Código Source Serif enorme + bloque card con título y sala + 4 oposiciones en mute.

Fila de mesa BIBLIO

Código · status · título · sala · recuento. Pedidos debajo: nombre · código · hora. Sin acciones PATCH en v1.

Login

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

Comando (S-CMD)

Campo «buscar lomo o signatura». Activo: filete mark 2px. Fondo card sobre ground.

Skeleton

animate-pulse bg-card. aria-busy.

Error

Titular display + cuerpo mute + Reintentar mark.

Sello PEDIDO / EN_SALA

Texto «Pedido» / «En sala» + seal o mute. Nunca solo el color. Poco: un sello por vista, no un header terracota.

4. Layouts

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

5. Estados de control

6. Iconografía

Cero iconos decorativos de «libro abierto / carnet / antena / play». El oficio es tipográfico + foto + cobre. Comando: lupa mínima, stroke ink, 20px, no pack de color. [DECISIÓN]

7. Motion

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

8. Densidad (AP-21)

En el recorte de mesa: eslogan + 3 métricas + 4 filas con signatura, título, sala y estado. [COMPROBADO] CRON §5.8.

9. Contraste de cobre

#3E6B5E sobre #E4E0D6 no es texto de párrafo. CTA = text-card o text-ink sobre bg-mark según ratio ≥ 4.5:1. Meta = mute o ink sobre ground/card. Seal sobre ground ≥ 4.5:1 para el rótulo «Pedido» (el sello lleva texto, no solo círculo).

09-content-guide.md

09 — Guía de contenido — LOMO

1. Voz

Cercana de mostrador y de sala. Tuteo en UI al lector. Segunda persona cuando la interfaz habla. Tercera cuando habla el hoy (El río Manzanares ocupa…).

Sin jerga de Regional («tu carnet único», «red de Madrid», «préstamo interbibliotecario»). Sin Absys. Sin «apúntate al club». Sin sirena. Sin kanban en UI. Sin antena ni repetición.

El producto se mira y se pide mesa. No vende préstamo, no es la Regional, no inscribe al club, no crea cuenta.

2. Palabras permitidas / prohibidas

«Kanban», «F-LEAD» y «H-DATA» son lenguaje de diseño, no de UI: Rafa no lee «lead pattern»; Inés lee Disponible / En sala / Pedido.

«Mesa» en UI autenticada es el oficio. En pública el titular es Hoy. Si hay ambigüedad en ficha, CTA = Pedir mesa, nunca «Reservar sala de 2 h». [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 hoy puede condensar dos en dos líneas; acuse muestra los cuatro.

4. Microcopy por superficie

5. Ejemplares seed (tono)

Los ejemplares demo se escriben como lomos de sala de barrio, no como ficha de OPAC ni como anuncio de club.

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

En EN_SALA no se reescribe a «prestado hasta el 12». El cierre es el estado. [DECISIÓN]

6. Nombres propios del seed

No inventar CIF de biblioteca, código de sede municipal, ni Absys real como si fuera el producto. [SUPUESTO de catálogo demo]
Usera es topónimo reconocible, no un inventario oficial de una biblioteca 2026.

No usar Nerea, Iker, Pilar, Patio 17, CONDUCTOR, programas. [DECISIÓN] leftover ONDA.

7. Tono por estado

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

8. Capitalización y números

• Wordmark: LOMO en versales Source Serif 4.
• Código: LM-2501 (LM versales, guion, 4 dígitos).
• Nombres: Inés Soto, Rafa Díez, Nora Ruiz.
• Lomos: El río Manzanares (artículo en el título, no el-rio en UI).
• Sala: Sala 2 en UI.
• Fecha: 25 ago si hay línea larga.
• No mezclar lm-2501 en minúsculas en UI. API puede normalizar a versales.

9. Idioma

es-ES. Fácil lectura. EN no en v1.
No mezclar «loan» ni «OPAC» en UI. En API sí: ejemplares, sala, status.

«Lector» en UI cuando hablamos de Rafa; «la bibliotecaria» para Inés; «la restauradora» solo en docs. [DECISIÓN]

10. Accesibilidad de copy

• No transmitir estado solo con color (el seal no «significa» pedido él solo).
• Filas llevan texto: Disponible / En sala / Pedido.
• Aviso de no-préstamo lleva palabras, no solo el cobre.
• Alt de fotos: objeto + lugar, no «imagen1».
  • hero: «Sala de archivo de barrio en Usera; estante, mesa de lectura y caliza.»
  • estante: «Lomos en un estante de sala de lectura. Cubierta de El río Manzanares y Voces del barrio.»
  • mesa: «Mesa de lectura con planos abiertos. Cubierta de Planos de Usera.»
  • silla: «Silla de sala de lectura junto a un lomo. Cubierta de Crónica del mercadillo.»

11. Piezas que no se escriben

10-accessibility.md

10 — Accesibilidad — LOMO

1. Alcance

WCAG 2.2 AA orientada al slice: mesa de datos, comando, ficha, pedir, acuse, login, mesa BIBLIO. No es una auditoría certificada. [DECISIÓN]

2. Contraste

Prohibido: texto mark sobre ground como párrafo (cobre como cuerpo). El cobre es superficie de CTA/foco, no párrafo.

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

3. Teclado y foco

• Orden: wordmark → comando → métricas (no foco si no son controles) → filas → ficha CTA → form pedir → form login → lista mesa.
• Foco visible: ring mark 2px (ink si el fondo ya es mark).
• Filas operables con Enter / Espacio.
• Pedir mesa no se activa al pasar el foco.
• Overlay de comando: ⌘K / / abre; Esc cierra; flechas recorren resultados. [DECISIÓN]

4. Targets

≥44×44 en CTA, filas, campo de comando, link Mesa, submit pedir. Campo de búsqueda altura ≥44px.

5. Nombre accesible

Fotos: alt de doc 09. Decorative? No: las cubiertas de ficha son contenido. Thumbs de fila tienen alt vacío si el título está al lado (alt="" + nombre en el texto). [DECISIÓN]

aria-current="page" no aplica a un rail; el wordmark no se marca current. El campo de comando en /buscar lleva aria-label.

6. Estados no solo por color

Disponible / En sala / Pedido en texto. Pedida: pantalla de acuse, no solo el botón en mark. Error: texto seal + mensaje. Empty búsqueda: «Sin lomos.»

7. Motion

prefers-reduced-motion: sin pulse. Skeletons estáticos. Cero animación de «páginas pasando» decorativa.

8. Mobile 390

Hoy: métricas wrap; filas apiladas. No carousel.
Buscar: campo sticky bajo el wordmark; resultados en columna.
Ficha: una columna; CTA al fondo del fold.
Pedir: form a columna; submit ≥44px.
Mesa: lista + pedidos a pantalla.
Comando: campo visible, no hamburger, no rail inferior de radio.

9. Autocomplete

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

10. Idioma

html lang="es". Números y códigos leídos como texto (LM-2501). Salas «Sala 2», no room 2.

11. Búsqueda

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

12. Tabla de datos

La mesa de hoy es una lista de filas accionables, no una <table> opaca sin caption. Si se usa table: <caption> «Ejemplares de hoy» y encabezados Signatura / Título / Sala / Estado. En 390 las filas se apilan como cards, no se recortan columnas. [DECISIÓN]

11-privacy-security.md

11 — Privacidad y seguridad — LOMO

1. Superficie pública vs cerrada

[DECISIÓN] El acuse no lista otros pedidos. Evita enumerar demanda de la sala.
La mesa pública no muestra nombre.

2. Datos de lector

v1 guarda solo un nombre de mostrador por pedido (pedidos.nombre). No email, no teléfono, no DNI, no carnet.
El lector no tiene fila en users. Pedir ≠ apuntarse al club.

El nombre existe para que Inés llame en sala («Rafa, sala 2»). No es una cuenta. [DECISIÓN]

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 BIBLIO para /mesa. 401 sin token, 403 si no BIBLIO.
• 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 sala en gestionar la ocupación y las reservas de mesa. Minimización: solo nombre de mostrador en v1. Sin cesión a la Regional. Derecho de supresión Could L+1 (Inés no borra en v1).

Nora no tiene acceso. No hay logs de «quién restauró el plano».

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 lector «por si acaso». No carnet municipal.

12-analytics.md

12 — Analítica — LOMO

1. North star

% de reservas de mesa confirmadas antes de las 11:00.

Oficio de sala. No pageviews. No «engagement con el estante». Confirmar = Inés da la mesa (fuera de app en v1; el modelo cuenta el oficio, no un PATCH). [DECISIÓN]

En v1 no hay estado CONFIRMADA: la north star es de producto, no un campo SQL. Could L+1: confirmada_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: prestamo, club_signup, play, repetir_submit, alta_submit.

4. Lo que no medimos

Préstamos a domicilio. Fondos de Absys. Aperturas de WhatsApp (no hay dato). NPS de la Regional. Repeticiones de radio.

5. Salud

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

13-qa-test-plan.md

13 — Plan de QA — LOMO

1. Smoke API (pnpm test:api)

1. GET /api/health → lomo-api (no onda-api, no ramal-api)
2. GET /api/ejemplares → 4 codes LM-2501…LM-2504 + lead + sala + status + cover
3. GET /api/ejemplares/LM-2501 → El río Manzanares · DISPONIBLE · sala 2
4. GET /api/ejemplares?q=manzanares → incluye LM-2501; no exige los 4
5. GET /api/ejemplares?q=zzzz → []
6. POST /api/ejemplares/LM-2501/pedir { nombre: "Rafa Díez" } → 201 pedida: true · status PEDIDO
7. POST /api/ejemplares/LM-2502/pedir { nombre: "Rafa Díez" } → 409 (EN_SALA)
8. POST /api/ejemplares/LM-9999/pedir { nombre: "Rafa Díez" } → 404
9. GET /api/mesa sin JWT → 401
10. POST /api/auth/login Inés → BIBLIO
11. GET /api/mesa → 4 ejemplares; pedidos con nombre; no lista pública de nombres en GET ejemplares

2. Smoke UI

3. Regresión de unicidad

• No copy ONDA (programa, repetición, conductora, ON-, en antena, playlist, Patio 17).
• 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 PIZARRA (taller, plaza, distrito, Absys como producto).
• No préstamo a casa, no club, no Regional como CTA.
• Health no dice onda-api ni ramal-api.
• Puerto 3025.

4. Accesibilidad rápida

Tab por comando y filas. Focus ring mark. Alt de fotos. Status en texto. CTA con contraste sobre mark.

5. Datos

Seed idempotente por email y code. Un POST de smoke sobre LM-2501 no borra el ejemplar. El re-seed restaura DISPONIBLE para repetir el demo.
Playwright futuro: esperar El río Manzanares, ines@lomo.barrio, no Patio 17, no nerea@onda.radio, no RM-2201, no «En antena».

6. Criterio de salida

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

14-dev-handoff.md

14 — Handoff de desarrollo — LOMO

1. DoD del slice

• Health { ok: true, service: "lomo-api" } en :3025
• 4 ejemplares seed con foto, lead, sala, status
• GET /api/ejemplares?q=manzanares → El río Manzanares
• POST pedir público → acuse /ok/:code
• JWT BIBLIO ines@lomo.barrio / password123
• /mesa lista + pedidos · GET JWT · no kanban
• Empty / error / loading en hoy, buscar y mesa
• Copy ×4 visible
• Rutas / /buscar /lomo/:code /pedir/:code /ok/:code /login /mesa
• Páginas HoyPage BuscarPage LomoPage PedirPage OkPage LoginPage MesaPage
• Paper 12 UX + 12 UI mapeados
• Docs 01–20 + README + executive
• 0 leftover programas / repeticiones / CONDUCTOR / onda-api / nodes / altas / VOCAL

2. Contratos

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

POST /api/ejemplares/:code/pedir:

{ "nombre": "Rafa Díez" }

201:

{ code, title, sala, status, pedida: true }

GET /api/mesa (JWT):

{
  date,
  ejemplares: [{ code, title, status, sala, cover, pedidoCount, sortOrder }],
  pedidos: [{ code, title, nombre, createdAt, status }]
}

Login:

{ email: "ines@lomo.barrio", password: "password123" }

3. Mapas de pantalla

4. Tokens en código

tailwind.config.js + styles.scss. Fuentes Google: Source Serif 4 + Outfit.
Colores: ground #E4E0D6 · ink #1C2B28 · card #FFFFFF · mark #3E6B5E · mute #5F6B67 · seal #9A5340.

5. Assets

Copiar 2026-08-25-lomo/assets/lomos/*.jpg y hero.jpg a apps/web/public/assets/.
Cubiertas: lomos/estante.jpg · mesa.jpg · silla.jpg.

6. No hacer

• No reintroducir programas / repeticiones / CONDUCTOR como dominio vivo.
• No dejar HealthService.name = 'onda-api' ni puerto 3023.
• No reintroducir nodes / altas / VOCAL.
• No documentar leftover ONDA como estado actual.
• No añadir signup de lector, préstamo, club, chat, kanban, Absys, fondo completo.

7. Arranque

cd /Users/cristian/orca/lomo-app
# apps/api/.env → DATABASE_URL Neon dawn-butterfly-79519092, JWT_SECRET, PORT=3025
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 — LOMO

Aquí solo viven ideas de L+1 / L4 y pulido posterior.
El slice L2 del día está cerrado: mesa de datos, comando, ficha, pedir, JWT BIBLIO, mesa de pedidos.

1. Hecho (L2)

• Mesa H-DATA · métricas + 4 filas
• Comando S-CMD · q=manzanares
• Ficha · título, sala, estado
• Form F-LEAD /pedir/:code
• Acuse /ok/:code · reserva ≠ préstamo
• Mesa JWT · lista + pedidos, no kanban
• Empty / error / loading · datos 390
• Neon dawn-butterfly-79519092 · API :3025 · lomo-api

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

3. L4 (requiere brief nuevo de diversidad)

• Rol RESTAURADORA (Nora) + cuadrante de conservación
• Préstamo a domicilio / carnet (otro producto; no es LOMO L2)
• Fondo completo / Absys / OPAC
• Multi-sede / multi-bibliotecaria
• Chat / kanban (fue PREGÓN)
• Club de lectura / inscripción (fue PIZARRA)
• Cuenta de lector / socio

4. Fuera para siempre en este nombre

La Biblioteca Regional. Préstamo a casa el día de la petición. Catálogo municipal como producto. Programas y repeticiones (ONDA es otro día). Nodos y altas (RAMAL es otro día).

5. Criterio para abrir L+1 / L4

Solo si un día futuro elige archivo L3+ y la diversidad ALS-2 lo permite. No parche silencioso. No reabrir ONDA dentro de LOMO.

16-interaction-specs.md

16 — Especificación de interacción — LOMO

1. Convenciones

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

2. Mesa de datos (UI-01) + mobile (UI-02) · H-DATA

AC: título, sala y estado visibles sin hover. 3 métricas + 4 filas en el recorte (AP-21). Cero botones Prestar / Inscribirse / Play.

El aviso «Lomo ≠ catálogo municipal» es texto, no un CTA de OPAC. [DECISIÓN]

390: mismas 4 filas apiladas. No carousel. Comando visible. [DECISIÓN]

3. Comando (UI-03) · S-CMD

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

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

AC: una pantalla. Cero préstamo. Cero «Inscribirse». Cero «Pedir repetición».

5. Pedir (UI-06) · F-LEAD

AC: un campo de nombre. Cero email. Cero DNI. Cero carnet.

6. Acuse (UI-07)

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

7. Login (UI-08)

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

8. Mesa BIBLIO (UI-09)

Desktop: lista + pedidos. 390: apilado. [DECISIÓN]
Cero Aceptar / Rechazar (eso fue RAMAL). Cero columnas. Cero En antena.

9. Loading / empty / error (UI-10…11)

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

17-prototype-map.md

17 — Mapa de prototipo — LOMO

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

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 → Hoy (métricas + 4 filas, lead El río Manzanares).
2. Comando «manzanares».
3. Ficha El río Manzanares sala 2 Disponible.
4. Pedir mesa · nombre.
5. Acuse LM-2501 · reserva ≠ préstamo.
6. Login Inés.
7. Mesa BIBLIO · lista + pedidos.
8. Empty / error / loading.
9. Hoy 390 + lomo 390.

No hay artboard de préstamo, club, Absys, galería de radio, kanban ni nodos.

18-completeness-audit.md

18 — Auditoría de cierre — LOMO

1. Alcance L2

2. Terna y diversidad

3. Copy irrenunciable

Presente en hoy, ficha, pedir, acuse, pie de mesa. Ver doc 09.

• Reserva de sala ≠ préstamo a casa
• Lomo ≠ catálogo municipal
• Pedir ≠ apuntarse al club
• LOMO no es la Biblioteca Regional

4. Anti-patrones vigilados

5. Seed

4 ejemplares · 2 DISPONIBLE · 1 EN_SALA · 1 PEDIDO · Inés BIBLIO · Rafa sin cuenta · Nora fuera.

6. Huecos conscientes (fuera)

Préstamo, login Nora, email transaccional, instrumentación analytics, fondo Absys, confirmada_at.

7. Veredicto

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

19-backlog-completo.md

19 — Backlog — LOMO

1. Done (Must L2)

2. Could L+1 (no bloquea cierre)

3. Explícito L4 / otro brief

4. No-backlog (rechazado)

Hero 2-col. Signup lector. leftover ONDA (programas, CONDUCTOR, onda-api) como feature. leftover RAMAL (nodes, altas, VOCAL) como feature. La Regional. Préstamo a casa. «Apúntate al club». Search-first como home.

5. Cómo usar este archivo

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

20-implementation.md

20 — Implementación — LOMO

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: ejemplares + pedidos + JWT BIBLIO. Puerto 3025. Health lomo-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 ONDA (programas, repeticiones, GalleryPage, onda-api, puerto 3023) al inicio del rewrite. Eso no es LOMO. El rewrite borra ese dominio.

2. Cómo arrancar

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

# apps/api/.env
#   DATABASE_URL=postgresql://neondb_owner:npg_GDsv4KLefP5d@ep-empty-star-a69kwo3y-pooler.us-west-2.aws.neon.tech/neondb?sslmode=require
#   JWT_SECRET=
#   PORT=3025

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

Credenciales

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

Lector / restauradora: sin cuenta. Rafa pide en /pedir/:code. Nora no entra.

3. Schema

Al boot o vía migrate:

1. CREATE TABLE de users, sessions, ejemplares, pedidos (doc 05).
2. Índices: ejemplares(code), ejemplares(status), users(email), pedidos(ejemplar_id).
3. Seed idempotente:
   • upsert BIBLIO ines@lomo.barrio (hash bcrypt canónico)
   • upsert ejemplares por code (LM-2501…LM-2504) restaurando status de catálogo
   • upsert pedido seed de LM-2503 · Carmen Vidal
4. Dominio: solo ejemplares + pedidos + users. [DECISIÓN]

No borrar pedidos nuevos de Rafa en cada boot, salvo el re-seed explícito de demo. Upsert de ejemplares por code sí restaura status de catálogo para que el guión sea repetible. [DECISIÓN]

No generar códigos en el POST: el acuse reusa LM-2501.

Tablas (recordatorio)

DROP leftover programas, repeticiones, nodes, altas si existen en el mismo Neon. [DECISIÓN] El project dawn-butterfly-79519092 es de LOMO.

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

Oficio

Health (referencia de implementación)

HealthService.name = 'lomo-api'
main.ts PORT default 3025

Si el rewrite hereda onda-api o puerto 3023, cambiar. El puerto de LOMO es 3025.

Pedir (referencia)

ejemplar = ejemplares.byCode(code) || 404
if status !== DISPONIBLE → 409
if !nombre.trim() → 400
INSERT pedidos (ejemplar_id, nombre)
UPDATE ejemplares SET status = PEDIDO
return { code, title, sala, status: PEDIDO, pedida: true }

POST no cobra, no abre préstamo, no crea user, no inscribe al club, no mueve kanban.

JSON camelCase: sortOrder, createdAt, pedidoCount.
SQL: sort_order, created_at.

Módulos de dominio: ejemplares/, mesa/, auth/, health.
No programas/, hoy/ (JWT ONDA), repeticiones/, nodes/, altas/.

5. Frontend a implementar

Estados: loading / ready / empty / error en hoy, buscar y mesa.
Token key: lomo.accessToken.
Proxy: /api → :3025.

Tokens Tailwind: ground / ink / card / mark / mute / seal. Fuentes Source Serif 4 + Outfit.

Chrome comando: campo «buscar lomo o signatura» → /buscar. Wordmark → /. Mesa → /mesa.

Renombrar leftover GalleryPage / ProgramaPage / HoyPage JWT ONDA / SearchPage → las siete páginas de arriba. [DECISIÓN]
Nota: HoyPage en LOMO es la home pública H-DATA, no la mesa JWT de ONDA.

6. Seed visible en UI

Playwright: esperar El río Manzanares, El lomo, no el prestado., ines@lomo.barrio.
No esperar Patio 17, nerea@onda.radio, ON-2301, En antena, Azotea Palomeras, RM-2201.

7. Smoke

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

Cubre health lomo-api, 4 ejemplares, q=manzanares, POST pedir, 409 EN_SALA, 404 code, 401 mesa, login BIBLIO, lista 4, pedidos con nombre.

8. DoD técnico

Ver doc 14. Este archivo no lista leftover de otro día como estado del producto. El contrato vivo es LOMO. ONDA es N−1, no el dominio de este repo.