00-day-brief.md

00 — Day brief · 2026-08-29 · TALÓN

Decisiones ALS-2 BRIEF

Terna unicidad

R-IN · S-SIDE · H-TABLE · F-EDIT

0 códigos iguales a N−1 (MANTA: R-CL · S-BOTTOM · H-MAP · F-MKT).
≥2 distintos vs N−2 (PIÑÓN: S-TOP · H-BENTO · F-CMP) y N−3 (BOBINA: S-DOCK · H-FEED · F-STORY).

S-SIDE, H-TABLE y F-EDIT no están en los últimos 5.
R-IN cumple la mezcla de 4 días (MANTA R-CL, PIÑÓN R-HY, BOBINA R-IN — wait BOBINA was R-IN; last 4 have R-IN already). Last 4: MANTA CL, PIÑÓN HY, BOBINA IN, LOMO CL. Mixing: already 1 IN. R-IN still allowed. Prefer R-HY to not stack? Last 4 already have IN. I’ll keep R-IN because the product IS an innovative dense tool vs classic photo landing. Mix rule: at least 1 CL and 1 IN in 4 days — if today is IN, window of 4 = TALÓN IN, MANTA CL, PIÑÓN HY, BOBINA IN → 2 IN + 1 CL + 1 HY. OK.

Fold (CRON §5.9)

• Código: FOLD-TABLE
• Por qué no es hero+panel de N-1 / N-2: MANTA es FOLD-MAP; PIÑÓN es FOLD-BENTO; BOBINA es FOLD-POSTER; LOMO es el FOLD-SPLIT de la ventana. La home es una cinta de líneas a sangre de trabajo. Staff spreadsheet: omite foto-led (D-P1-09). Cuota last 6 ya ≥3.

Ground (CRON §5.6)

• Familia: G-PHOSPHOR
• Hex: #101510
• Por qué: no hueso MANTA, no grafito PIÑÓN, no terciopelo BOBINA, no caliza LOMO, no cartel blanco ONDA. Primer instinto del talonario = papel rosa; un tubo de parada a las 21:00 se lee en fósforo.

Mood visual (Paper)

• Candidatos: bookish talonario crema (primer instinto), phosphor, vehicle dashboard, rusted, signage
• Elegido: phosphor — no el papel carbón. La caja de Maravillas bajo el fluorescente.
• Paleta:
  • #101510 tubo apagado (ground)
  • #D8F0C8 fósforo de lectura (ink)
  • #161C16 tecla (card)
  • #8FD36A fósforo (mark)
  • #7E9174 mute
  • #E24B4B LED anulado (poco)
• Tipo: IBM Plex Mono importes/códigos · Karla UI

Home foto-led (D-P1-09)

No. H-TABLE staff. La cuota last 6 ya está cubierta. UI-01 = cinta densa, no split DERIVA.

Alcance L2 must

1. Home tabla: 4 líneas + 3 métricas (cobrado / pendiente / anulado)
2. Apuntar una línea (concepto, importe, forma)
3. Anular una línea pendiente (F-EDIT)
4. Success con código TAL-XXXX
5. Login JWT TITULAR
6. Cierre del día (mesa) — no kanban
7. Empty / error / loading / mobile
8. ≥12 UX + ≥10 UI

Microcopy duro

• Apuntar ≠ hacer la cuenta en el móvil. No hay Excel en la caja.
• Talón ≠ factura. No es un modelo fiscal.
• Cerrar el día ≠ Hacienda. No se declara cumplimiento.
• TALÓN no es Excel.

Supuestos

• S1: La parada atiende 4–12 líneas/mañana en el slice; demo 4. [SUPUESTO]
• S2: Cualquiera en la parada apunta sin cuenta. JWT solo TITULAR. [SUPUESTO]
• S3: Sin pagos online, sin AEAT, sin TicketBAI, sin SKU, sin stock. [DECISIÓN]
• S4: Tetuán / Maravillas es atrezzo, no una parada real. [SUPUESTO de parada]

Hipótesis

Seed demo

Objetos son catálogo demo. No es una parada real. [SUPUESTO de parada]

Métricas: cobrado 2 · pendiente 1 · anulado 1. Suma cobrada demo: 20,00 €. [SUPUESTO]

JWT

remedios@talon.parada / password123 · rol TITULAR · API :3029

00-paper-reference.md

Paper reference · TALÓN

UX-count: 12 UI-count: 12

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

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

01-project-definition.md

01 — Definición de proyecto — TALÓN

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.
[SUPUESTO de parada] Tetuán / Maravillas / ramo / planta / corona / maceta son atrezzo de mercado, no una parada real ni un acuerdo municipal.

Tras MANTA (L1 merendero, 2026-08-28) el día elige L2 libro de caja, no otro L1 consecutivo. N−1 es MANTA. [DECISIÓN]

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] Quien atiende la parada no necesita un ERP ni un Excel compartido: necesita apuntar lo cobrado y lo pendiente y saber cuánto lleva el día sin abrir el móvil de notas. Hoy eso vive en un talonario de papel, un WhatsApp o una hoja que se pierde al cerrar. Apuntar se lee como «hacer la cuenta en el móvil»; el talón se lee como factura; cerrar el día se lee como declarar a Hacienda; el producto se lee como Excel. [SUPUESTO] Una parada de mercadillo atiende 4–12 líneas/mañana; no opera un SKU ni un TicketBAI.

Secundarios

Supuestos (no investigación primaria propia)

• S1: La parada atiende 4–12 líneas/mañana en el slice; demo 4. [SUPUESTO]
• S2: Cualquiera en la parada apunta sin cuenta. JWT solo TITULAR. [SUPUESTO]
• S3: Sin pagos online, sin AEAT, sin TicketBAI, sin SKU, sin stock. [DECISIÓN]
• S4: Tetuán / Maravillas es atrezzo, no una parada real. [SUPUESTO de parada]

Hipótesis de producto

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

3. Propuesta de valor

No es TALÓN

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L2 libro de caja de parada con Linea + JWT TITULAR.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable (contrato).
• Terna R-IN · S-SIDE · H-TABLE · F-EDIT frente a MANTA (bottom/map/mkt), PIÑÓN (top/bento/cmp) y BOBINA (dock/feed/story).
• No encadenar otro L1 tras MANTA. [DECISIÓN]

Usuario

No objetivos v1 (explícitos)

• Pagos online, pasarela, escrow, TPV
• AEAT, TicketBAI, factura electrónica, IVA automático
• Stock, SKU, inventario, códigos de barras
• Excel export, pivot, multi-hoja
• Cuenta de ayudante, socio, newsletter
• Multi-parada, multi-titular
• App nativa ni notificaciones push
• Rol cliente autenticado
• Trastos, REGIDORA, manta-api (MANTA es otro día)
• Bicis, ganchos, MECANICO, pinon-api (PIÑÓN es otro día)

5. Roles y permisos (resumen)

[DECISIÓN] Un solo rol autenticado: TITULAR. Quien apunta no es un usuario del sistema: es autora de una linea. La lectora mayor 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 cinta H-TABLE (tabla a muro + 3 métricas + 4 líneas). No pide cuenta. No es un hero+panel split (AP-25). No es un feed. No es un plano foto-led. No es un bento.
2. Quien apunta puede ver 4 líneas, apuntar una y obtener success en /ok/TAL-XXXX, o anular una PENDIENTE.
3. /ok/:code dice explícitamente que apuntar no es hacer la cuenta en el móvil y que talón no es factura.
4. La UI dice explícitamente que cerrar el día no es Hacienda y que TALÓN no es Excel.
5. Sin token, GET /api/mesa responde 401. POST /api/lineas, POST /api/lineas/anular y GET /api/lineas son públicos.
6. Un POST de apuntar no crea user, no cobra online, no abre factura, no mueve kanban, no declara a AEAT.
7. Un POST de anular sobre no-PENDIENTE responde 409. Una línea. Sin bulk.
8. Una TITULAR inicia sesión y ve 4 líneas (2 COBRADO, 1 PENDIENTE, 1 ANULADO) en el seed.
9. El tablero autenticado es un cierre del día. No es un kanban de 3 columnas. No es un split lista | ficha foto.
10. Chrome S-SIDE: Hoy · Apuntar · Cierre. Home sin bottom de merendero y sin top de taller.
11. Rutas solo las del doc 03. No existen /excel, /factura, /aeat, /stock.
12. GET /api/health devuelve service: "talon-api" (no manta-api, no pinon-api).
13. TAL-2901 y TAL-2902 aparecen COBRADO; TAL-2903 PENDIENTE; TAL-2904 ANULADO; suma cobrada demo 20,00 €.
14. Staff FOLD-TABLE omite foto-led (D-P1-09). No se diseña hero+panel (AP-25).

9. Stack y artefactos

[COMPROBADO] Puerto, Paper file ID, path de app, Neon y GH constan en el encargo.
El código vive (o vivirá) en talon-app con este contrato. Este doc es la fuente de verdad del slice L2. La app puede no existir aún; el contrato no se finge como runtime verde. [DECISIÓN]

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-SIDE · H-TABLE · F-EDIT. 0 códigos iguales a N−1 (MANTA). ≥2 distintos vs N−2 (PIÑÓN) y N−3 (BOBINA). S-SIDE, H-TABLE y F-EDIT no están en los últimos 5. Ground G-PHOSPHOR #101510, no G-BONE ni papel rosa carbón.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — TALÓN

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 paradas de mercadillo (talonario, efectivo/bizum, cierre de mañana, 4–12 líneas, iPad o móvil en la caja).
• Analogía operativa con superficie pública + panel JWT de la serie daily.
• Restricciones ALS-2: no Excel, no factura, no Hacienda, no merendero, no taller de bicis, no foto-led staff (D-P1-09).

Límites éticos de verdad

3. Stakeholders

Mapa de poder (resumen)

• Decisor de adopción: la titular de la parada (Remedios) y, en uso diario, quien mira el cierre.
• Usuario frecuente de apuntar/anular: AYUDANTE (cinta + form, sin cuenta).
• Usuario frecuente de oficio: TITULAR (cierre /cierre).
• Riesgo de rechazo: si el success parece una factura; si la cinta parece Excel; si hay que crear cuenta; si el cierre parece Hacienda o kanban; si anular borra sin rastro.

4. Personas

P1 — Remedios Gil · TITULAR

Escenario: Entra a /login, abre /cierre, lee TAL-2901 Ramo COBRADO, ve métricas. El copy dice que cerrar el día no es Hacienda.

[COMPROBADO] Nombre de cuenta, email demo y rol salen del encargo. Edad es constructo de diseño. [DECISIÓN]

P2 — Ayudante de parada · AYUDANTE

Escenario: Abre / en el iPad, ve 4 líneas, toca Apuntar, escribe concepto e importe, lee «apuntar ≠ cuenta en el móvil» y el código TAL-XXXX.

[COMPROBADO] El gesto (apuntar sin cuenta) sale del encargo. Nombre del ayudante es constructo. Edad es constructo. [DECISIÓN]
Lucia no tiene fila en users. [DECISIÓN]

P3 — Lectora mayor · a11y (docs)

[DECISIÓN] no hay cuenta de lectora mayor en v1; a11y la contempla en docs 10. Edad = constructo de diseño.

5. JTBD

Job principal (ayudante)

Cuando entra un cobro o un pendiente en la parada, quiero apuntarlo en la cinta sin abrir el móvil de notas, para que Remedios lo vea al cierre sin que eso signifique factura, Excel, cuenta ni Hacienda.

Job principal (titular)

Cuando hay líneas nuevas y hay que cerrar, quiero ver cobrado / pendiente / anulado, para cerrar el día sin un kanban ni un modelo fiscal.

Jobs que TALÓN no hace

6. Stories Must (v1)

Could (fuera de L2 Must, solo L3/otro brief): pagos online, AEAT, login de lectora, export Excel, stock.

7. Journey (resumen)

1. Lucia abre /. Ve cinta a muro + 3 datos (cobrado / pendiente / anulado) + 4 líneas. TAL-2901 COBRADO; TAL-2903 PENDIENTE. [H1]
2. Toca Apuntar → /apuntar. Concepto, importe, forma. POST /api/lineas → /ok/TAL-2905. Lee las cuatro oposiciones. [H3]
3. Alternativa: toca anular sobre TAL-2903 → sheet anular (UI-10). POST /api/lineas/anular → ANULADO. [H2]
4. Intento de anular TAL-2901 COBRADO → 409 «Esa línea no se puede anular.»
5. Remedios entra a /login → /cierre. Líneas por estado + métricas.
6. Lee suma cobrada y copy: cerrar el día ≠ Hacienda.

Backstage: Nest + Neon + JWT. Contable y AEAT no entran. No hay Excel. No hay factura.

8. Blueprint (resumen)

9. Matriz hallazgo → requisito → feature

10. Preguntas que este case no responde

• ¿Cuántas líneas reales se apuntan en Maravillas en 2026?
• ¿Qué asociación de mercadillo opera un talón oficial?
• ¿Lucia preferiría el móvil de notas?
• ¿Remedios cerraría antes de las 14:00 de verdad?
• ¿Hace falta export a Excel para el contable?

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 — TALÓN

1. Principios de IA

2. Sitemap

/                                      Hoy cinta pública (FOLD-TABLE)                 H-TABLE
                                       + sheet anular (UI-10)                         F-EDIT · público
/apuntar                               Apuntar una línea                              público
/ok/:code                              Success post-apuntar o post-anular             público
/login                                 Login JWT TITULAR                              público
/cierre                                Cobrado / pendiente / anulado                  auth
/**                                    → redirect /

Árbol por audiencia

[COMPROBADO] Cinco rutas del encargo L2. No se inventan /excel, /factura, /aeat, /stock, /buscar.

Anular no es ruta extra Must: es el sheet UI-10 sobre / (tap línea PENDIENTE). L2 compacto. [DECISIÓN]
/ok/:code usa el código de línea (TAL-2903 en anular, TAL-2905 en apuntar nuevo). [DECISIÓN]
No hay /buscar: no hay S-CMD. El hallazgo es la cinta. [DECISIÓN]
No hay /linea/:code de ficha pública permanente: el oficio de estado vive en Hoy y en el cierre. Could L3. [DECISIÓN]

3. Navegación

Side (S-SIDE · superficies salvo login/ok pueden mostrarlo)

[DECISIÓN] El side es la navegación primaria. No hay bottom de merendero (MANTA), no hay top de taller (PIÑÓN), no hay dock (BOBINA), no hay comando (LOMO).

Desktop ≥960px: rail izquierdo fósforo; wordmark TALÓN arriba; slots Hoy · Apuntar · Cierre.
Mobile ~390px: rail colapsado a bottom/side compacto Hoy · Apuntar · Cierre; no hamburger. [DECISIÓN] En 390 el chrome no se esconde detrás de un menú. Padding del contenido ≥ altura/ancho del chrome.

Hoy pública (H-TABLE FOLD-TABLE)

[DECISIÓN] Hoy no tiene tabs de marketing, no tiene «Factura / Hacienda / Excel». La cinta basta para hallar.

Chrome de apuntar (/apuntar)

[DECISIÓN] Apuntar no es un modal efímero sin URL. No hay wizard de AEAT.

Chrome de anular (sheet sobre /)

Chrome de cierre (/cierre autenticado)

[DECISIÓN] No hay S-SPLIT foto+rail (AP-25 / LOMO FOLD-SPLIT). No hay kanban (PREGÓN). No hay /cierre/:code: L2 lee el día.

4. Etiquetas de IA (UI)

En docs puede decirse «cinta Hoy» para H-TABLE y «cierre TITULAR» / «mesa» para el oficio JWT (/api/mesa). En UI pública el titular es Hoy. En UI autenticada el titular es Cierre. [DECISIÓN]

5. Contenido de cada nodo de IA

6. Error / empty / loading (sitio)

Viven en las mismas rutas, no en URLs extra. Artboards: UI-06 empty · UI-07 error · UI-08 loading.

7. Profundidad y hallazgo

No hay búsqueda Must: el hallazgo es la cinta de 4 líneas. Introducir /buscar copiaría LOMO y rompería la terna. [DECISIÓN]
Remedios no filtra el cierre con chips en v1: ve el día. Could L3: filtro; no se cuela como deuda del L2.

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 — TALÓN

1. Convenciones

2. F1 — Ayudante apunta una línea (Must · F-EDIT)

/apuntar  →  escribe concepto «Ramo pequeño», importe 10,00, forma efectivo
          →  POST /api/lineas  { concepto, importe, forma }
          →  201 { code: TAL-2905, status: COBRADO|PENDIENTE, apuntado: true }
          →  /ok/TAL-2905

Entrada: form público, sin cuenta.
Salida: código visible + copy «apuntar ≠ cuenta en el móvil».
Errores: red (reintentar), 400 validación, 0 líneas previas (empty de Hoy no bloquea apuntar).

AC

• El form no pide NIF, email, pasarela ni signup.
• POST no cobra online, no crea user, no abre factura, no mueve kanban, no declara AEAT.
• Una línea. Cero bulk. Cero segunda fila en el mismo POST.
• /ok/TAL-2905 muestra las cuatro oposiciones.
• Status inicial demo por defecto: COBRADO si se marca cobrado en form, o PENDIENTE si queda a deber — en v1 el form incluye estado implícito por forma/cobro; seed usa ambos. [DECISIÓN] Form v1: concepto + importe + forma; status por defecto COBRADO salvo toggle «Pendiente de cobro». [DECISIÓN]

3. F2 — Ayudante anula una línea PENDIENTE (Must · F-EDIT)

/  →  GET /api/lineas
   →  ve 3 métricas + 4 líneas
   →  tap TAL-2903 Corona PENDIENTE
   →  sheet anular (UI-10)
   →  confirma
   →  POST /api/lineas/anular  { code: "TAL-2903" }
   →  201 { code: TAL-2903, status: ANULADO, anulado: true }
   →  /ok/TAL-2903  (o feedback en cinta + refresh)

AC

• Solo PENDIENTE. Cero anular COBRADO o ANULADO.
• POST no borra la fila: marca ANULADO y conserva el rastro. [DECISIÓN]
• Copy: no «eliminado» tipo Excel. No «borrado fiscal».

4. F3 — Ayudante intenta anular no-PENDIENTE (Must · 409)

/  →  tap TAL-2901 Ramo COBRADO  (o fuerza POST)
   →  CTA Anular disabled  o  POST /api/lineas/anular
   →  409
   →  copy «Esa línea no se puede anular.»

Mismo resultado si TAL-2904 ANULADO, o si se reintenta TAL-2903 tras un 201.

AC

• 409 si status ≠ PENDIENTE.
• Copy: no «agotado» retail. No «añadir a lista de espera».
• Lucia puede elegir otra PENDIENTE si existe, o apuntar nueva.

5. F4 — Titular entra a cierre (Must)

/login  →  POST /api/auth/login
        →  JWT TITULAR
        →  /cierre
        →  GET /api/mesa

AC

• Sin token, /cierre redirige a /login?next=/cierre.
• GET /api/mesa sin Bearer → 401.
• Día: 4 filas + métricas cobrado / pendiente / anulado + suma. No columnas Recibido / En curso.
• Desktop: rail + panel de cierre. 390: apilado sobre el chrome S-SIDE.
• ANULADO sí aparece (oficio de rastro). [DECISIÓN]

6. F5 — Estados de sistema

7. Flujos que no existen

8. Tiempos de demo (modelo)

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

9. Guión de demo canónico

1. / — cinta a muro + 3 datos (2 cobrado / 1 pendiente / 1 anulado) + 4 líneas. Eslogan. S-SIDE.
2. Lectura rápida: TAL-2901 Ramo mixto 12,00 € efectivo COBRADO; TAL-2902 Planta crasa 8,00 € bizum COBRADO; TAL-2903 Corona blanca 35,00 € efectivo PENDIENTE; TAL-2904 Maceta devuelta -6,00 € efectivo ANULADO.
3. Apuntar — /apuntar · Ramo pequeño · 10,00 · efectivo · /ok/TAL-2905. Copy ×4.
4. Anular — tap corona PENDIENTE · confirma · ANULADO.
5. Reintento corona → 409.
6. /login — remedios@talon.parada / password123.
7. /cierre — métricas + líneas; suma cobrada demo 20,00 € (+ nuevos cobrados si se apuntó).
8. 390: cinta + S-SIDE; no carousel; targets ≥44px.
9. API down: error + Reintentar.

10. Contratos de error de API (flujo)

11. S-SIDE en flujo

[DECISIÓN] El slot Apuntar no abre el sheet de anular; abre el form de apuntar. Anular arranca en la cinta sobre PENDIENTE.

05-data-model.md

05 — Modelo de datos — TALÓN

1. Visión general

Dominio L2 de libro de caja de parada + apuntar + anular autenticable:

Base: PostgreSQL (Neon project cool-cloud-04708830 · DATABASE_URL) · IDs: serial + texto estable (TAL-2901).
[DECISIÓN] ensureSchema es válido si el contrato de tablas se cumple; el brief de stack no exige Prisma.

Contrato de producto: lineas + JWT TITULAR.
No trastos / tratos / bicis / requests / sesiones / ejemplares.

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

Role

LineaStatus

Un POST de apuntar crea la línea en COBRADO (default) o PENDIENTE (toggle). [DECISIÓN]
Un POST de anular sobre PENDIENTE pasa la línea a ANULADO. [DECISIÓN]
Si status ≠ PENDIENTE → 409. [DECISIÓN]
Remedios no hace PATCH libre a AEAT en v1: el cierre es lectura del día. [DECISIÓN]

FormaPago (etiqueta)

[DECISIÓN] Forma es texto controlado; no integra TPV ni API bancaria.

3. Diagrama ER (texto)

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

sessions
  id, user_id → users
  expires_at, revoked_at
  created_at

lineas
  id
  code (unique, TAL-XXXX)
  concepto
  importe (numeric; puede ser negativo en devolución seed)
  forma (efectivo|bizum)
  status (COBRADO|PENDIENTE|ANULADO)
  sort_order
  created_at, updated_at

v1: una sola TITULAR opera sobre el conjunto global del día demo.
No hay FK de ayudante-usuario: quien apunta no se loguea.

4. Tablas

users

sessions

lineas

Sin NIF, sin email de cliente, sin pasarela, sin SKU, sin stock. Talón ≠ factura. [DECISIÓN]

Índices: lineas(code), lineas(status), lineas(sort_order), users(email), lineas(created_at DESC).

5. Seed

TITULAR

remedios@talon.parada / password123 · Remedios Gil · TITULAR
Hash bcrypt: el de implementación (mismo patrón serie; documentar en seed al build). [DECISIÓN]

Líneas

Métricas derivadas del seed: cobrado 2 · pendiente 1 · anulado 1.
Suma cobrada demo (solo COBRADO): 20,00 €. [SUPUESTO]

[SUPUESTO de parada] Conceptos e importes son atrezzo. No es una parada real.
[DECISIÓN] sort_order 1…4 = TAL-2901…2904.

Seed idempotente

El seed idempotente restaura las 4 líneas de catálogo (estados) para que el demo sea repetible. [DECISIÓN]
Re-seed no borra TAL-2905+ salvo flag explícito de demo. [DECISIÓN]

6. JSON (camelCase)

API: sortOrder, createdAt, cobrado, pendiente, anulado, sumaCobrada, status, concepto, importe, forma, code.
SQL: sort_order, created_at.

GET /api/lineas

{
  "metrics": { "cobrado": 2, "pendiente": 1, "anulado": 1, "sumaCobrada": 20.00 },
  "lineas": [
    {
      "code": "TAL-2901",
      "concepto": "Ramo mixto",
      "importe": 12.00,
      "forma": "efectivo",
      "status": "COBRADO",
      "sortOrder": 1
    }
  ]
}

Lista pública: métricas + líneas del día. [DECISIÓN]
Métricas cuentan los tres estados; sumaCobrada suma importes con status COBRADO. [DECISIÓN]

GET /api/lineas/:code [DECISIÓN] soporte de success

Mismo shape de item; 404 si no existe.

POST /api/lineas (apuntar)

Request:

{ "concepto": "Ramo pequeño", "importe": 10.00, "forma": "efectivo", "status": "COBRADO" }

concepto obligatorio, trim, min 2. importe number (permite negativo en devoluciones). forma ∈ {efectivo, bizum}. status opcional ∈ {COBRADO, PENDIENTE}; default COBRADO. [DECISIÓN]

Response 201:

{
  "code": "TAL-2905",
  "concepto": "Ramo pequeño",
  "importe": 10.00,
  "forma": "efectivo",
  "status": "COBRADO",
  "apuntado": true
}

Algoritmo: INSERT linea (code siguiente). Transacción única. [DECISIÓN]

POST /api/lineas/anular (anular)

Request:

{ "code": "TAL-2903" }

Response 201:

{
  "code": "TAL-2903",
  "concepto": "Corona blanca",
  "importe": 35.00,
  "forma": "efectivo",
  "status": "ANULADO",
  "anulado": true
}

Algoritmo: SELECT FOR UPDATE por code; si no existe → 404; si status ≠ PENDIENTE → 409; UPDATE status ANULADO. Transacción única. [DECISIÓN]

GET /api/mesa (JWT)

{
  "metrics": { "cobrado": 2, "pendiente": 1, "anulado": 1, "sumaCobrada": 20.00 },
  "lineas": {
    "COBRADO": [ /* … */ ],
    "PENDIENTE": [ /* … */ ],
    "ANULADO": [ /* … */ ]
  },
  "titular": { "name": "Remedios Gil", "email": "remedios@talon.parada" }
}

7. Reglas de integridad

8. Fuera del modelo v1

9. Naming vs leftover

06-tech-stack.md

06 — Stack técnico — TALÓN

1. Resumen

[COMPROBADO] Angular + NestJS + Neon + Tailwind, puerto API 3029, Paper file ID, Neon y path de app salen del encargo.
La app puede no existir aún; este doc fija el contrato, no un runtime fingido. [DECISIÓN]

2. Por qué este stack

3. Puertos y health

Leftover manta-api / puerto 3028 / pinon-api no son el producto. [DECISIÓN]

4. Estructura de repo (contrato)

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

Proxy web → API en dev (/api → http://localhost:3029). [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: remedios@talon.parada / password123.

7. Endpoints (contrato)

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

8. Frontend — rutas y componentes

Chrome: SideNavComponent (S-SIDE). Tokens Tailwind: ground, ink, card, mark, mute, sello.

9. Assets

Staff FOLD-TABLE omite foto-led; no hay obligación de covers de producto tipo MANTA. [DECISIÓN D-P1-09]

10. Calidad y toolchains

11. Anti-stack (no introducir)

12. Criterios de aceptación técnicos

1. GET /api/health → service: "talon-api".
2. Seed idempotente: 1 TITULAR + 4 líneas.
3. POST apuntar crea línea y devuelve TAL-XXXX.
4. POST anular sobre PENDIENTE → 201 ANULADO; sobre no-PENDIENTE → 409.
5. GET mesa sin token → 401.
6. Web en 4200 consume API 3029 sin mixed-content local.
7. 0 referencias de producto a trastos, REGIDORA, manta-api, bicis, MECANICO, ganchos en runtime.

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

07-creative-direction.md

07 — Dirección creativa — TALÓN

1. Concepto

TALÓN es una caja de Maravillas bajo el fluorescente a las 21:00: se entra a una cinta de líneas a muro con tres números y cuatro filas, y se sale habiendo apuntado o anulado una línea, no una landing de «tu ERP». El ground es tubo apagado. El fósforo puntúa. El sello rojo, poco.

Mood elegido: phosphor.
Primer instinto descartado: bookish talonario crema / papel rosa carbón. Un tubo de parada a las 21:00 se lee en fósforo, no en papel de talonario nostálgico.

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

2. Territorio visual

3. Paleta

Jerarquía de color: el tubo carga; el mark puntúa; el sello filetea el conflicto (anulado / error). Si el sello pinta fondos enteros, deja de ser LED y se vuelve alarma retail. El texto sobre ground es ink; nunca mute como párrafo largo. Ink sobre ground debe pasar contraste WCAG 2.2 AA. [DECISIÓN]

Candidatos de mood descartados: bookish talonario crema (primer instinto), vehicle dashboard, rusted, signage.

4. Tipografía

Prohibido: IBM Plex Mono por debajo de 14px en párrafos largos. Karla en importes (se vuelve SaaS blando). Sello como color de texto de párrafo largo (contraste).

Fuentes vetadas de la serie reciente cuando el brief fija otras: Libre Baskerville / Nunito Sans (MANTA), Spectral / Sora (PIÑÓN), Cormorant / Manrope (BOBINA), Source Serif 4 / Outfit (LOMO). IBM Plex Mono + Karla sí entran: el brief los fija. [COMPROBADO]

5. Fotografía

Staff spreadsheet omite foto-led (D-P1-09). La densidad vive en la cinta. [DECISIÓN]

Alt: concepto + importe cuando haya imagen; no «imagen1». Ver doc 09.

6. Registro R-IN

Innovador denso: herramienta de caja, wordmark Karla, importes Mono, side rail de oficio. No es un dashboard de seguros. No es un kiosk de horas. No es una landing de barrio. No es papel rosa «cool».

La innovación de terna está en H-TABLE FOLD-TABLE + S-SIDE + F-EDIT, no en un look «talonario vintage». [DECISIÓN]

7. Anti-moods

8. Densidad (AP-21 / FOLD-TABLE)

En el recorte: eslogan + 3 datos (cobrado / pendiente / anulado) + 4 filas con código, concepto, importe, forma y estado visibles sin hover. Headline huérfano + vacío = card hueca. [COMPROBADO] CRON FOLD-TABLE · D-P1-09 omite foto-led.

No hero+panel (AP-25). La cinta es el oficio. [DECISIÓN]

9. Motion

10. Voice visual ↔ copy

El mood phosphor refuerza el microcopy: talón de caja, no Excel. Si la UI parece ERP (grid Excel, export, NIF) o factura (QR fiscal, IVA) o Hacienda (AEAT), el copy irrenunciable pierde fuerza. [DECISIÓN]

08-design-system.md

08 — Sistema de diseño — TALÓN

1. Tokens

Tailwind: bg-ground, text-ink, bg-card, bg-mark, text-mute, text-sello, font-mono, font-sans.
La fila vive sobre --card; el ground es tubo alrededor. [DECISIÓN]

2. Contraste (obligatorio)

[DECISIÓN] Sello nunca como color de párrafo. Mute nunca como único color de disclaimer largo.
CTA mark: texto #101510 sobre #8FD36A — verificar AA en implementación. [HIPÓTESIS operativa]

3. Escala de tipo

4. Componentes

Fila de línea (cinta)

Código Mono · concepto Karla · importe Mono · forma · status. Tap PENDIENTE abre sheet anular. Orden por sort_order.

Cinta FOLD-TABLE (UI-01)

Tabla a muro; wordmark + eslogan + 3 datos (cobrado / pendiente / anulado). Sin tile foto-led. Sin hero+panel.

Dato (métrica)

Número ink grande + label mute («cobrado», «pendiente», «anulado»). Tres en fila desktop; wrap en 390. No es un sparkline ni una mesa de datos de archivo.

Form apuntar (UI-02)

Concepto, importe, forma, toggle pendiente opcional, disclaimer, submit mark.

Sheet anular (UI-10)

Código + concepto + importe en solo lectura, confirmación, submit sello/mark. Si no PENDIENTE: sello + «Esa línea no se puede anular.»

Success (UI-03)

Código Mono enorme + bloque card con concepto e importe + 4 oposiciones en ink/mute.

Cierre TITULAR (UI-05)

Grupos COBRADO / PENDIENTE / ANULADO + métricas + suma. Fila: código · concepto · importe · forma · status. Sin acciones PATCH fiscales en v1.

Login (UI-04)

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

Side nav (S-SIDE)

Tres slots: Hoy · Apuntar · Cierre. Activo: mark. Idle: mute. Fondo card/ground. Targets ≥44px.

Skeleton (UI-08)

animate-pulse bg-card o mute/20. aria-busy.

Error (UI-07)

Titular + cuerpo ink/mute + Reintentar mark. 409 usa sello en LED, no en párrafo.

Empty (UI-06)

Titular Karla + mute. Sin CTA de Excel ni de Hacienda.

Sello COBRADO / PENDIENTE / ANULADO

Texto «Cobrado» / «Pendiente» / «Anulado» + mark o mute o sello. Nunca solo el color. Poco: un sello por fila.

5. Layouts

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

6. Estados de control

7. Iconografía

S-SIDE: pictogramas simples (cinta / más / cierre). Stroke 1.5–2px. No icon packs «Excel», «factura», «trasto», «bici». [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 — TALÓN

1. Voz

TALÓN habla como caja de parada, no como ERP ni como Hacienda.

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

2. Microcopy irrenunciable

Presente en Hoy (pie o banner), apuntar, anular, success y pie de cierre:

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

3. Glosario UI

4. Pantalla a pantalla

Hoy /

Apuntar /apuntar (UI-02)

Anular sheet (UI-10)

Success /ok/:code

Login /login

Cierre /cierre

5. Alt text de imágenes

Evitar «imagen1», copy de factura con NIF. [DECISIÓN]

6. Líneas seed (atrezzo)

Ramo / planta / corona / maceta son catálogo demo. En UI no se afirma «parada municipal de Maravillas». Los blurbs pueden recordar talón ≠ factura. [SUPUESTO de parada]

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 Hoy o apuntar/anular.
2. Ningún CTA dice Facturar / Exportar a Excel / Declarar / Borrar.
3. COBRADO se etiqueta «Cobrado», no «Facturado».
4. Códigos se muestran como TAL-XXXX en versales.
5. Docs y UI no inventan KPIs numéricos de Tetuán como hecho.

10-accessibility.md

10 — Accesibilidad — TALÓN

1. Objetivo

Cumplir WCAG 2.2 AA en el vertical slice L2. Ground oscuro (tubo): el par ink sobre ground es el contrato de legibilidad. La lectora mayor (68) es persona de diseño que fuerza contraste, tamaño y targets; no tiene login. [COMPROBADO] requisito del encargo · [DECISIÓN] persona a11y en docs.

2. Contraste

[DECISIÓN] Si mute falla AA en párrafo, se asciende a ink. Sello no escribe disclaimers. Mark no escribe disclaimers largos.

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

3. Tipografía y lectura

4. Targets y pointer

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

5. Teclado y foco

Sin keyboard traps. Sheet: foco inicial en confirmación; retorno a la fila al cerrar. [DECISIÓN]

6. Semántica y nombres

7. Imágenes

8. Motion

9. Estados y color

COBRADO / PENDIENTE / ANULADO / error nunca se comunican solo con color: texto + sello. Mark y sello refuerzan, no sustituyen. [DECISIÓN]

10. Auth y a11y

• Login solo TITULAR; lectora mayor no necesita cuenta para leer Hoy ni apuntar.
• Mensajes de error de login claros, sin enumerar si el email existe.
• /cierre redirige a login con foco en email.

11. Mobile 390

• S-SIDE / chrome compacto no tapa el CTA final: padding del contenido ≥ chrome + safe-area.
• Sheet anular; submit visible.
• Formularios: autocomplete on; importe inputmode="decimal"; password current-password.
• Viewport meta; sin zoom bloqueado. [DECISIÓN]
• UI-11 Hoy y UI-12 apuntar cubren el recorte 390. No carousel.

12. Criterios de aceptación a11y

1. Ink sobre ground usado en cuerpo; mute limitado a meta.
2. Targets S-SIDE y CTA ≥ 44×44.
3. Focus visible mark en todos los interactivos.
4. Status y métricas con texto, no solo color o número huérfano.
5. Reduced motion respetado.
6. Form con labels y errores anunciables.
7. Ningún toast único sin pantalla como único success (hay /ok/:code).
8. Sheet anular es dialog alcanzable con teclado.

13. Fuera de v1 (L3, no deuda)

• Modo tipográfico «letra grande» persistente.
• App nativa con VoiceOver de caja física.
• ATAG de CMS (no hay CMS).

11-privacy-security.md

11 — Privacidad y seguridad — TALÓN

1. Principios

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

2. Datos tratados

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

[SUPUESTO] La parada demo opera en España; el slice no implementa un RGPD completo de empresa real.

3. Superficies públicas vs privadas

[DECISIÓN] El cierre JWT no expone datos fiscales de terceros; expone el día de la parada demo.

4. AuthN / AuthZ

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

5. Amenazas y mitigaciones L2

6. Contenido de importe y concepto

importe es oficio de caja, no tracking. Puede ser negativo (devolución seed). [DECISIÓN]
No se pide NIF, dirección ni datos de terceros sensibles en el form.
concepto es texto libre corto (min 2, max 120).

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. POST lineas/anular no exige auth ni pago ni NIF.
3. Password solo como hash bcrypt.
4. .env no versionado con secretos reales.
5. Copy de success no implica factura ni declaración a Hacienda.
6. Segundo POST anular sobre el mismo code ya ANULADO → 409.
7. Anular COBRADO → 409.

10. Fuera de v1 (L3 / org real, no deuda)

DPO, ROPA formal, exportaciones ARCO automatizadas, SSO, 2FA, WAF, pasarela, TicketBAI. Roadmap L3 si la parada deja de ser demo.

12-analytics.md

12 — Analytics y métricas — TALÓN

1. Norte

[COMPROBADO] North star alineada a H1 del day brief.
[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

El móvil de notas de «¿cuánto llevamos?» es el recado que la cinta y el cierre pretenden absorber. [SUPUESTO] operativo de diseño, no dato de campo.

3. Métricas de soporte (modelo)

4. Eventos (contrato si se instrumenta en un L3)

[DECISIÓN] Nunca enviar passwords ni JWT a analytics.
Instrumentar eventos no es un hueco del L2: el slice cierra sin tracker. [DECISIÓN]

5. Cálculo north star (modelo)

visitas_hoy = sesiones en /
resuelto_sin_notas =
  (no medible en v1: no hay canal de notas en producto)
proxy de diseño = visitas a / o /cierre que cubren cobrado/pendiente/anulado
                   frente a recados paralelos (cualitativo)

[DECISIÓN] v1 no persiste un flag notas_asked. El north star queda como modelo de oficio, no como SQL fingido.

Timezone: Europe/Madrid. [DECISIÓN]

6. Integridad de expectativa (cualitativa)

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

• «¿Dónde exporto a Excel?»
• «¿Esto es una factura?»
• «¿Lo mando a Hacienda?»
• «¿Dónde está la pasarela?»
• «¿Esto es la manta de Usera?»
• «¿Esto es el taller de bicis?»

Mitigación: microcopy irrenunciable (doc 09). [HIPÓTESIS H1/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 a H1.
3. Si hay eventos en un L3, sin secretos ni PII innecesaria.
4. Health, 401 mesa y 409 anular son checks de integridad, no vanidad.

9. Relación con seed

Seed tiene 2 COBRADO + 1 PENDIENTE + 1 ANULADO · suma cobrada 20,00 €. Un guión con POST apuntar TAL-2905 y POST anular TAL-2903 es el ejemplo narrativo de activación; no es un dato de mercado. [SUPUESTO de demo]

13-qa-test-plan.md

13 — Plan de QA — TALÓN

1. Alcance

Smoke y regresión del vertical slice L2: cinta, apuntar, anular, 409, success, login, cierre, empty/error/loading, mobile 390, contraste ink/ground.
No incluye campo real de Maravillas ni load test de ERP.

[DECISIÓN] Mientras talon-app no tenga runtime, este plan es contrato. No se finge smoke verde. Completeness (doc 18) puede dejar código E2E como contrato hasta smoke real.

2. Entornos

3. Smoke crítico (Must pasar cuando haya runtime)

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 las 4 de catálogo. [DECISIÓN]

10. Criterio de salida

Smoke S01–S12 en verde cuando exista runtime. Sin P0 (health mal, apuntar/anular rotos, 409 ausente, cierre abierto sin auth, copy Excel ausente en success).
Hasta entonces: contrato documentado; no fake PASS. [DECISIÓN]

11. Fuera de alcance QA v1

Penetration test, auditoría RGPD formal, pasarela, TicketBAI, compatibilidad IE, métricas reales de north star instrumentadas. Eso es L3 u org real, no un agujero de este slice.

14-dev-handoff.md

14 — Handoff a desarrollo — TALÓN

1. Contrato vivo

Si código y docs divergen, alinear ambos; no silenciar leftover MANTA/PIÑÓN como producto. [DECISIÓN]
La app puede no existir aún: el handoff es el contrato. [DECISIÓN]

2. Definition of Done (DoD) L2

El DoD cubre todo el slice. No queda producto in-scope como «siguiente sprint». [DECISIÓN]

3. Mapa Paper → Angular

4. API checklist

Body apuntar: { concepto: string, importe: number, forma: "efectivo"|"bizum", status?: "COBRADO"|"PENDIENTE" }.
Body anular: { code: string }.
Ver algoritmos en doc 05 / 20. [DECISIÓN]

5. Seed y credenciales

6. Anti-patrones de implementación

7. Assets

Case assets/ puede estar vacío al inicio (staff omite foto-led). Cover UX opcional. [DECISIÓN]

8. QA mínimo antes de merge

Ejecutar smoke S01–S12 (doc 13) cuando haya runtime. Verificar copy irrenunciable en /ok/:code. Verificar 409 sobre TAL-2901.

9. Open questions (no reabren L2)

10. Contacto de diseño

Paper file + docs 07–09. No reinventar hueso botanical ni grafito de taller. Mood phosphor. Ground #101510. Mark #8FD36A. Sello #E24B4B poco.

15-roadmap.md

15 — Roadmap — TALÓN

1. Horizonte

[DECISIÓN] El L2 no deja producto ni código in-scope como «próximos pasos». Este roadmap no es un cajón de deuda. Empty, error, loading, 409, mobile, auth, seed, copy y API están en el slice de hoy (como contrato).

2. Hecho en L2 (Must · cerrado en suite)

Nada de la tabla se reabre como backlog de «el código ya vendrá» como deuda de producto: el case L2 docs cierra; el build sigue el contrato (doc 20). [DECISIÓN]

3. L3 only (nice-to-have · otro brief)

Estas ideas no completan TALÓN. Completarían otro producto. [DECISIÓN]

4. Anti-roadmap (no disfrazar)

5. Dependencias del slice cerrado

6. Criterios para abrir un L3

1. Smoke L2 en verde (doc 13) cuando haya runtime.
2. Copy irrenunciable intacto.
3. El brief L3 nombra pagos / AEAT / stock sin reabrir cinta, F-EDIT de una línea ni cierre.
4. North star sigue siendo modelo o se instrumenta sin PII innecesaria.

7. Cierre

L2 docs/contrato está completo en una iteración. El roadmap es un muro contra Excel, factura y Hacienda, no una lista de lo que «faltó». [DECISIÓN]

16-interaction-specs.md

16 — Especificación de interacción — TALÓN

1. Convenciones

Loading, empty y error viven con los gestos (UI-06 / UI-07 / UI-08). [DECISIÓN]

2. Hoy cinta (UI-01) + mobile (UI-11) · H-TABLE FOLD-TABLE

AC: código, concepto, importe, forma y estado visibles sin hover. Sin foto-led (D-P1-09). Sin hero+panel (AP-25). Tres datos con texto («2 cobrado»), no solo cifra. Cero botones Facturar / Exportar / Declarar.

El aviso «TALÓN no es Excel» es texto, no un CTA de hoja. [DECISIÓN]

390: mismas 4 filas apiladas. No carousel. S-SIDE/chrome visible. [DECISIÓN]

3. Apuntar (UI-02) + mobile apuntar (UI-12)

AC: no NIF, no email, no pasarela, no stock. Apuntar ≠ cuenta en el móvil visible.

4. Anular (UI-10) · F-EDIT

AC: una sola línea. Cero bulk. Cero borrar sin rastro. Cero anular COBRADO.

5. Success (UI-03)

AC: las cuatro oposiciones están. No QR fiscal. No «factura emitida». No AEAT.

6. Login (UI-04)

AC: sin signup. Solo TITULAR.

7. Cierre (UI-05)

AC: no kanban. No columnas Recibido / En curso. No split foto+panel. Copy pie: Cerrar el día ≠ Hacienda.

8. Empty / Error / Loading (UI-06 / 07 / 08)

9. Tokens (UI-09)

Artboard de referencia: ground / ink / card / mark / mute / sello + pares tipográficos. No es ruta de producto.

10. Criterios de aceptación de interacción

1. FOLD-TABLE sin foto-led ni hero+panel.
2. Anular solo desde PENDIENTE; 409 en resto.
3. Reduced motion respetado.
4. Targets ≥44.
5. Success siempre con las cuatro oposiciones.

17-prototype-map.md

17 — Mapa de prototipo — TALÓN

1. Fuentes

[COMPROBADO] conteos y file ID en docs/00-paper-reference.md.
[SUPUESTO] densificación de artboards = gate Paper del mismo día (placeholder en 00 hasta gate).

2. UX process → docs

3. UI producto → rutas / componentes

4. Flujo prototipo clickable (orden demo)

UI-01 Hoy
  ├─→ UI-10 Anular (TAL-2903 PENDIENTE)
  │     └─→ UI-03 Success (Anulado)
  ├─→ UI-02 Apuntar
  │     └─→ UI-03 Success (Apuntado)
  ├─→ UI-11 (mismo /, viewport 390)
  ├─→ UI-12 (mismo /apuntar, viewport 390)
  └─→ S-SIDE Cierre → UI-04 Login → UI-05 Cierre

Estados: UI-06 empty · UI-07 error/409 · UI-08 loading se prueban desconectando API, seed vacío o POST anular sobre COBRADO.
Tokens: UI-09.

5. Datos de prototipo = seed

Labels Paper deben usar estos códigos si muestran URL. [DECISIÓN]
POST anular demo → TAL-2903.
POST apuntar demo → TAL-2905 (Ramo pequeño, 10,00, efectivo).

6. Breakpoints de artboard

7. Terna visible en prototipo

8. Gaps conscientes

Ningún gap es producto in-scope aplazado. [DECISIÓN]

9. Criterios de aceptación del mapa

1. Cada UI-01…12 tiene fila en esta tabla.
2. Cada ruta Must tiene artboard.
3. No hay artboard de /excel, /factura, /aeat, stock o merendero.
4. Mobile 390 cubierto (UI-11, UI-12).
5. UX-00…11 cubiertos.

18-completeness-audit.md

18 — Auditoría de cierre — TALÓN

1. Alcance L2 · una iteración

El vertical slice cierra en esta iteración a nivel de suite docs + contrato. Empty, error, loading, 409, mobile, auth, seed, copy y contrato de código forman parte del cierre, no de un roadmap.

2. Terna y diversidad

3. Copy irrenunciable

Presente en Hoy, apuntar, anular, success, pie de cierre. Ver doc 09.

• Apuntar ≠ hacer la cuenta en el móvil
• Talón ≠ factura
• Cerrar el día ≠ Hacienda
• TALÓN no es Excel

4. Anti-patrones vigilados

5. Seed

4 líneas · 2 COBRADO · 1 PENDIENTE · 1 ANULADO · Remedios TITULAR · Lucia sin cuenta · lectora mayor fuera de login.

Métricas: cobrado 2 · pendiente 1 · anulado 1 · suma cobrada 20,00 €.

6. Assets

No se exige hero+covers tipo MANTA. [DECISIÓN]

7. Huecos conscientes (fuera · L3)

Pagos online, AEAT/TicketBAI, stock, export Excel. Nada más se etiqueta como «faltó del L2».

Login lectora, email transaccional, instrumentación analytics, PATCH fiscal, ficha /cierre/:code, ruta /anular no son deuda: son decisiones de corte (S2, S3, D13, D14).

Densificación Paper = gate del mismo día, no backlog de producto. [DECISIÓN]
Runtime app = contrato hasta smoke; no fake PASS. [DECISIÓN]

8. Checklist archivos suite

9. Veredicto

Slice L2 cerrado en una iteración a nivel docs/contrato. El contrato de talon-app (docs 14 y 20) no se lista como próximo paso de producto inventado: es el mismo alcance. Paper file 01M165CVX37R8QSKBG37N0QRS4. Si el repo diverge (leftover MANTA), gana docs 05 + 20 tras alinear ambos.

Cierre: Must cubierto en suite. Roadmap = L3 pagos / AEAT / stock únicamente.

10. SCORE ALS-2 (cierre de suite docs)

Gate esperado: node scripts/check-paper-reference.mjs 2026-08-29-talon → UX=12 UI=12.

Smoke: no fingido. Cuando exista runtime: health talon-api; GET /api/lineas 4; POST anular 201/409; login remedios@talon.parada; kill API/web (D-P1-06).

19-backlog-completo.md

19 — Backlog completo — TALÓN

1. Leyenda

No hay columna «Must (después)». El slice no deja producto in-scope a medias. [DECISIÓN]

2. Épica A — Hoy H-TABLE FOLD-TABLE

3. Épica B — Apuntar

4. Épica C — Anular F-EDIT

5. Épica D — Cierre TITULAR

6. Épica E — Chrome S-SIDE

7. Épica F — Design system & a11y

8. Épica G — Plataforma

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

10. Orden de build (mismo alcance, no roadmap)

1. Schema + seed + health
2. GET lineas + HoyPage FOLD-TABLE
3. ApuntarPage + POST lineas
4. AnularSheet + POST anular + 409
5. OkPage copy
6. Auth + CierrePage
7. S-SIDE + 390 + empty/error/loading
8. Pulido tokens / a11y / smoke S01–S12

Ese orden no es «próximos pasos de producto»: es la receta del mismo L2 ya cerrado en docs. [DECISIÓN]

11. Contadores

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

20-implementation.md

20 — Implementación — TALÓN

1. Resumen ejecutivo técnico

Este documento es la especificación de build del L2. No es un roadmap de producto: si el repo no existe aún o diverge, gana el contrato de docs 05 + este archivo tras actualizar ambos. No se finge runtime verde. [DECISIÓN]

Contrato: lineas + JWT TITULAR. Puerto 3029. Health talon-api.

[COMPROBADO] Path, puerto, Neon, GH y Paper salen del encargo.

El repo no debe contener leftover MANTA (trastos, tratos, REGIDORA, manta-api, puerto 3028) ni leftover PIÑÓN (bicis, MECANICO, ganchos, pinon-api). Eso no es TALÓN.

2. Cómo arrancar

cd /Users/cristian/orca/talon-app
# instalar dependencias por app (pnpm --filter; no npm workspaces)
# (el repo puede no existir aún — crear desde este contrato)

# apps/api/.env
#   DATABASE_URL=<neon cool-cloud-04708830>
#   JWT_SECRET=<secret>
#   PORT=3029

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

Credenciales

Ayudante / lectora mayor: sin cuenta. Lucia apunta en /apuntar o anula desde /.

3. Schema

Al boot o vía migrate:

1. CREATE TABLE de users, sessions, lineas (doc 05).
2. Índices: lineas(code), lineas(status), lineas(sort_order), users(email), lineas(created_at DESC).
3. Seed idempotente:
   • upsert TITULAR remedios@talon.parada (hash bcrypt)
   • upsert lineas por code (TAL-2901…TAL-2904) restaurando status, concepto, importe, forma
4. Dominio: solo lineas + users + sessions. [DECISIÓN]

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

POST de apuntar sí genera código nuevo (TAL-2905+). POST de anular reutiliza el code de la línea.

Tablas (recordatorio)

DROP leftover trastos, tratos, bicis, requests si existen en el mismo Neon. [DECISIÓN] El project es de TALÓN.

Seed SQL (modelo)

[SUPUESTO de parada] Objetos demo. Suma cobrada = 20.00.

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 === TITULAR protege /api/mesa.
• Públicos: health, lineas, lineas/:code, POST lineas, POST lineas/anular, login.

Oficio

Health (referencia de implementación)

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

Cualquier leftover "manta-api" o "pinon-api" falla el DoD.

POST lineas (apuntar) — algoritmo

1. Validar body.concepto (trim, length >= 2) else 400
2. Validar body.importe (number, finito) else 400
3. Validar body.forma ∈ {efectivo, bizum} else 400
4. status = body.status ∈ {COBRADO, PENDIENTE} ? body.status : COBRADO
5. code = siguiente TAL-XXXX (max existente + 1, piso TAL-2905)
6. INSERT lineas (code, concepto, importe, forma, status)
7. 201 { code, concepto, importe, forma, status, apuntado: true }

Transacción única. [DECISIÓN]

POST lineas/anular — algoritmo

1. Validar body.code presente else 400
2. SELECT FOR UPDATE lineas WHERE code = body.code
3. Si no hay fila → 404
4. Si status ≠ PENDIENTE → 409 { error: "NOT_PENDIENTE", code }
5. UPDATE lineas SET status = ANULADO
6. 201 { code, concepto, importe, forma, status: ANULADO, anulado: true }

Transacción única. El segundo concurrente sobre ya ANULADO recibe 409. [DECISIÓN]

GET lineas — shape

Ver doc 05. Métricas: cobrado, pendiente, anulado, sumaCobrada (Σ importe donde status = COBRADO).

GET mesa — shape

Ver doc 05. Exige Bearer TITULAR.

5. Frontend — implementación

Componentes Must

HoyPage, ApuntarPage, AnularSheet, OkPage, LoginPage, CierrePage, SideNavComponent.

6. Criterios de aceptación de build

1. Health talon-api en :3029.
2. Seed 4 líneas con métricas 2/1/1 y suma 20.00.
3. POST apuntar → 201 TAL-XXXX.
4. POST anular PENDIENTE → 201 ANULADO; COBRADO → 409.
5. GET mesa sin token → 401.
6. UI muestra las cuatro oposiciones en success.
7. 0 leftover MANTA/PIÑÓN en strings de producto.
8. Smoke S01–S12 (doc 13) cuando el runtime exista — no fake.

7. Orden de implementación

1. Monorepo pnpm + Nest health
2. Schema + seed Neon
3. GET/POST lineas + anular
4. Auth + mesa
5. Angular shell S-SIDE + HoyPage
6. Apuntar + Ok
7. AnularSheet + 409
8. Login + Cierre
9. Empty/error/loading + 390
10. Smoke + kill procesos (D-P1-06)

8. Anti-implementación

9. Cierre

Este doc es la fuente de verdad del build L2. La ausencia temporal del repo no se reporta como PASS de smoke. [DECISIÓN]