00-day-brief.md

00 — Day brief · 2026-08-19 · MATIZ

Decisiones ALS-2 BRIEF

Terna unicidad

R-HY · S-BOTTOM · H-BENTO · F-EDIT

0 códigos iguales a N−1 (ZAGUÁN: R-IN · S-WIZ · H-WIZARD · F-CMP).
≥2 distintos vs N−2 (MARGEN: R-CL · S-TOP · H-GALLERY · F-STORY) y N−3 (CESTA: R-CL · S-RAIL · H-TABLE · F-LEAD).
Ventana 4: R-IN + R-CL + R-CL + R-HY (hay clásico e innovador).

S-BOTTOM no está en los últimos 5 (S-WIZ, S-TOP, S-RAIL, S-DOCK, S-SPLIT). H-BENTO y F-EDIT tampoco.

Ground (CRON §5.6)

• Familia: G-CHAPEL
• Hex: #E6E4ED
• Por qué: yeso de capilla, no hormigón (ZAGUÁN), no blanco de kiosco (MARGEN), no musgo (CESTA), no cromo (RONDA), no agua (DERIVA). El acento es amatista de vidriera, no óxido ni cadmio.

Mood visual (Paper)

• Candidatos: candlelit (primer instinto salón), chapel, bookish, nocturnal, mineral
• Elegido: chapel — no el primer instinto candlelit (ámbar × oxblood de “spa de lujo”). Un salón de Usera no es un spa; es un oficio con luz de vidriera y pizarra.
• Paleta:
  • #E6E4ED yeso de capilla (ground)
  • #2B2838 pizarra del banco
  • #6B4C9A amatista de vidriera
  • #F7F5FA lino de card
  • #6E6A78 peltre
  • #C4A35A hoja de oro (acento secundario, poco)
• Tipo: Libre Baskerville display · Nunito Sans UI (evita Instrument Serif / Sora / Cormorant / Public Sans / Spectral / Manrope / Zilla / Mulish / Lora / Karla / Newsreader / Outfit)

Alcance L2 must

1. Login JWT COLORISTA (Nora Beltrán, Salón Amparo)
2. Hoy — bento: 3 sillas de hoy + última fórmula + aviso de oxidante
3. Fichas — lista de clientas con último matiz
4. Ficha de clienta + historial de fórmulas
5. Editor de fórmula (must-have inventivo): líneas de color (marca, tono, gramos) + oxidante 10/20/30 vol + tiempo + notas + “guardar ≠ aplicar”
6. Success / empty / error / loading
7. Cuenta (salón, rol, cerrar sesión)
8. ≥12 UX + ≥10 UI

Microcopy duro

• Fórmula ≠ receta comercial. 6/7 + 20 vol no es “el bote de la caja”.
• Ficha ≠ cita. MATIZ no agenda. La silla de hoy es un asiento, no un slot Booksy.
• Guardado ≠ aplicado. Guardar la fórmula no significa que el color esté en el pelo.
• MATIZ no cobra. El ticket lo hace la caja; el producto no es un TPV.

Supuestos

• S1: Un salón de barrio tiene 1–2 coloristas y 40–80 fichas vivas; la demo tiene 1 COLORISTA + 5 clientas + 8 fórmulas.
• S2: La colorista escribe la fórmula en el móvil, junto al lavacabezas, con las manos aún húmedas: bottom tabs, targets grandes, sin wizard.
• S3: No hay reserva online ni pasarela. El “hoy” lo rellena Nora por la mañana (quién viene), no la clienta.
• S4: La dueña (Inma) no usa el producto el día 1; el JWT es solo COLORISTA.

Hipótesis

Anti-patrones evadidos

• AP-12: no hero 2-col + 3 cards + lista badges
• AP-16: ≥10 UI incluyendo cada estado y el editor completo
• AP-20: ground chapel, no beige por inercia
• AP-21: Hoy bento con 3 sillas reales en el fold (nombre, silla, último matiz)

00-paper-reference.md

Paper reference · MATIZ

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 Login · UI-02 Hoy bento · UI-03 Fichas · UI-04 Ficha · UI-05 Editor móvil · UI-06 Editor desktop · UI-07 Success · UI-08 Empty · UI-09 Error · UI-10 Loading · UI-11 Cuenta

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

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

Regla: el núcleo F-EDIT ocupa UI-05 + UI-06. Hoy es H-BENTO denso (AP-21).

1. Mapa de canvas (bandas)

Layout canvas: origen (0,0) · gaps ~100–120px · UX 3×4 · móviles en 2 filas · desktop editor debajo. D-P0-04 / D-P1-04.

2. Mapeo Paper → Angular

01-project-definition.md

01 — Definición de proyecto — MATIZ

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] La colorista de un salón de barrio no necesita otro Booksy: necesita escribir los gramos antes de que se le olvide el tazón. Hoy eso vive en WhatsApp + foto del tazón + una libreta que se moja junto al lavacabezas. La ficha se lee como cita, el guardado se lee como «ya está en el pelo» y el producto se lee como TPV. [SUPUESTO] Un salón de barrio tiene 1–2 coloristas y 40–80 fichas vivas; no opera un PMS de cadena ni una pasarela.

Secundarios

Supuestos (no investigación primaria propia)

• S1: Un salón de barrio tiene 1–2 coloristas y 40–80 fichas vivas; la demo tiene 1 COLORISTA + 5 clientas + 8 fórmulas. [SUPUESTO]
• S2: La colorista escribe la fórmula en el móvil, junto al lavacabezas, con las manos aún húmedas: bottom tabs, targets grandes, sin wizard. [SUPUESTO]
• S3: No hay reserva online ni pasarela. El «hoy» lo rellena Nora por la mañana (quién viene), no la clienta. [SUPUESTO]
• S4: La dueña (Inma) no usa el producto el día 1; el JWT es solo COLORISTA. [SUPUESTO]

Hipótesis de producto

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

3. Propuesta de valor

No es MATIZ

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L2 belleza oficio con Client + Formula + Sitting + JWT COLORISTA.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable.
• Terna R-HY · S-BOTTOM · H-BENTO · F-EDIT frente a ZAGUÁN (wizard/comparador), MARGEN (galería/masthead) y CESTA (tabla/rail).

Usuario

No objetivos v1 (explícitos)

• Reserva, calendario, slot, confirmación de cita
• Cuenta de clienta, recordatorios, WhatsApp outbound
• TPV, ticket, comisión, pasarela
• Multi-colorista, turnos, comisiones por silla
• Recetario de marca (L’Oréal / Wella como catálogo comercial)
• Foto del resultado como UGC de clienta
• App nativa ni notificaciones push
• Rol DUEÑA autenticado (S4)

5. Roles y permisos (resumen)

[DECISIÓN] Un solo rol autenticado: COLORISTA. La dueña no es un rol de sistema el día 1. Las clientas no son usuarias: son filas de clients.

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

7. Alcance funcional v1 (L2)

8. Criterios de aceptación de producto

1. Sin token, / redirige a /login. No hay cara pública de lead.
2. Una COLORISTA puede iniciar sesión y ver Hoy con 3 sillas reales (nombre, silla, último matiz) en el fold.
3. Una COLORISTA puede abrir una ficha, escribir una fórmula (líneas + oxidante + minutos) y guardarla.
4. La UI dice explícitamente que fórmula no es receta comercial, que ficha no es cita, que guardado no es aplicado, que MATIZ no agenda y que MATIZ no cobra.
5. Sin token, GET /api/hoy, /api/clients, POST/PATCH de fórmulas responden 401.
6. Un POST de fórmula crea status=SAVED. Guardar no marca la silla como teñida.
7. /ok/:id muestra «Guardado no es aplicado».
8. La home es el bento de Hoy: no hay hero 2-col + 3 cards como superficie principal.
9. Fotos reales en las 5 fichas (assets del case).
10. El editor muestra marca, tono, gramos por línea + chips 10 / 20 / 30 vol + minutos + notas.
11. Bottom tabs Hoy · Fichas · Cuenta visibles en autenticado.
12. Rutas solo las del doc 03. No existen /cita, /agenda, /cobrar, /tienda.

9. Stack y artefactos

[COMPROBADO] Puerto, Neon, Paper file ID, repo y path de app constan en el encargo.

10. Riesgos y mitigaciones

11. Glosario

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

13. Relación con el día anterior

[COMPROBADO] El brief fija terna R-HY · S-BOTTOM · H-BENTO · F-EDIT. 0 códigos iguales a N−1 (ZAGUÁN). ≥2 distintos vs N−2 (MARGEN) y N−3 (CESTA). Ventana 4 días: R-IN + R-CL + R-CL + R-HY. Ground G-CHAPEL #E6E4ED, no G-CONCRETE.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — MATIZ

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 oficio colorista en salón de barrio (fórmula en gramos, oxidante en volúmenes, tiempo de pose, ficha de clienta).
• Analogía operativa con PWA auth-first + editor + JWT de la serie daily.
• Restricciones ALS-2: no reserva, no TPV, no lookbook editorial, no tabla de necesidades, no parte de obra, no wizard inmobiliario.

Límites éticos de verdad

3. Stakeholders

Mapa de poder (resumen)

• Decisor de adopción: la colorista (quien escribe) y, en difusión, la dueña (quien decide si hay otra app).
• Usuario frecuente de escritura: COLORISTA (Hoy + ficha + editor).
• Usuario frecuente de lectura: COLORISTA (historial de la ficha).
• Riesgo de rechazo: si Hoy parece una agenda; si Guardar parece Aplicar; si hay un CTA de cobro; si Inma exige login el día 1.

4. Personas

P1 — Nora Beltrán · COLORISTA

Escenario: Login → Hoy → silla 1 Marisol → última fórmula honey balayage → Nueva fórmula → 9.3 + 8.3, 20 vol, 25 min → Guardar → «Guardado no es aplicado».

[COMPROBADO] Credencial demo sale del encargo. Nombre, edad y salón son constructo de diseño. [DECISIÓN]

P2 — Inma Soto · DUEÑA

Escenario: No se loguea. Pregunta a Nora «¿está apuntado lo de Marisol?». No encuentra /caja ni /agenda.

[DECISIÓN] Inma no es rol de sistema el día 1 (S4). No hay login DUEÑA en L2.

P3 — Marisol Vega · CLIENTA (no usa la app)

Escenario: Se sienta en la silla 1. Nora abre su ficha. Marisol no ve MATIZ.

[DECISIÓN] Marisol no es rol de sistema. Las cinco clientas son filas, no cuentas.

Clientas / cliente de seed (no personas primarias)

[COMPROBADO] Nombres, edades, matices y slugs salen del encargo.

Anti-personas

5. JTBD y user stories

Job principal (COLORISTA)

Cuando tengo el tazón delante y las manos húmedas,
quiero escribir los gramos, el oxidante y el tiempo,
para no depender de una foto de WhatsApp ni de la memoria de hace 8 semanas.

Job secundario (COLORISTA, lectura)

Cuando se sienta Marisol,
quiero ver qué le hice hace 8 semanas,
para no inventar el honey ni copiar el bote de la caja.

Job de la DUEÑA (fuera de app)

Cuando el salón abre,
quiero que Nora apunte el color y yo siga con el WhatsApp y la caja,
para no meter otra reserva ni otro TPV.

Jobs secundarios

Stories Must (v1)

MoSCoW (v1 L2)

6. Journey (COLORISTA · día de Marisol)

Momentos de verdad

1. 3 sillas en el primer viewport — si hay que «descubrir la marca», se rompe H-BENTO / AP-21. [HIPÓTESIS]
2. Editor sin wizard — si aparecen 4 pasos de «elige el look», F-EDIT falla.
3. Success dice que guardado no es aplicado — evita la mentira del color puesto.
4. Cero CTA de cita o cobro — si aparece «Agendar» o «Cobrar», H2 / microcopy fallan.
5. Tabs abajo, no arriba — S2: manos húmedas, pulgar. [HIPÓTESIS]

7. Service blueprint (resumen)

Fallos de servicio y respuesta de diseño

8. Matriz hallazgo → requisito → feature

9. Preguntas abiertas (no bloquean v1)

10. Plan de research futuro (si hubiera campo real)

Estos métodos no se han ejecutado. No se reportan hallazgos como si lo hubieran sido.

11. Síntesis

MATIZ se diseña como cuaderno de oficio que escribe y guarda, no como Booksy, no como TPV y no como recetario de marca.
La investigación del caso es constructiva y etiquetada: personas, JTBD y journey son artefactos de diseño; las métricas de validación quedan para uso real futuro.

03-information-architecture.md

03 — Arquitectura de información — MATIZ

1. Principios de IA

2. Sitemap

/login                                 Login JWT COLORISTA                         público
/                                      Hoy bento (auth)                            H-BENTO
/fichas                                Lista de clientas (auth)
/fichas/:slug                          Ficha + historial (auth)
/fichas/:slug/formula                  Editor de fórmula (auth)                    F-EDIT
/ok/:id                                Success post-guardado (auth)
/cuenta                                Salón, rol, salir (auth)
/**                                    → redirect /  (si hay token) o /login

Árbol por audiencia

[COMPROBADO] Siete rutas del encargo L2. No se inventan /cita, /agenda, /cobrar, /tienda, /aplicar.

3. Navegación

Bottom tabs (S-BOTTOM)

[DECISIÓN] El bottom tab es la única navegación primaria autenticada. Encaja L2 PWA. No hay masthead (MARGEN), no rail (CESTA), no chrome de pasos (ZAGUÁN).

Desktop ≥960px: tabs pueden subir a una barra inferior fija de 64px o a un rail corto inferior centrado; no se convierten en top-nav de marketing.
Mobile ~390px: tabs 56–64px + safe-area; labels Hoy / Fichas / Cuenta siempre visibles. [DECISIÓN] En 390 no se introduce hamburger.

El editor y el success conservan los tabs (la colorista no se pierde). Un «atrás» contextual vive en el header de la pantalla, no sustituye al tab.

Header contextual (no es nav primaria)

[DECISIÓN] El wordmark en autenticado lleva a / (Hoy), no reinicia un wizard (no hay wizard).

Login (único público)

[DECISIÓN] No hay /registro. No hay «Soy clienta». No hay «Pedir cita».

4. Inventario de contenido

5. Taxonomía

Role

[DECISIÓN] No hay DUENA / CAJA / CLIENTA.

FormulaStatus

Orden de historial: createdAt descendente (lo último escrito primero).
[DECISIÓN] No hay APPLIED / MIXED / BILLED: S4 + microcopy.

Oxidant

Clients (líneas seed)

[COMPROBADO] Cinco fichas con slugs del encargo. [DECISIÓN]

Sittings (hoy)

[COMPROBADO] Encargo: silla 1 Marisol, 2 Amina, 3 Pilar.

6. Modelo mental vs UI

7. Query string y estado

[DECISIÓN] Sin búsqueda facetada en v1. 5 fichas se recorren a ojo. L+1: filtro por matiz.

El editor no persiste borrador en sessionStorage como Must. Si se sale sin guardar, se pierde. Could L+1: draft local.

8. Rutas API alineadas a IA

[COMPROBADO] Contrato del encargo. No se documentan citas, cobros ni POST /api/appointments como Must.

9. Decisiones de IA descartadas

04-user-flows.md

04 — Flujos de usuario — MATIZ

Convenciones

• Actor: Guest (anónimo) | COLORISTA
• Éxito: resultado observable
• Errores: UI + código HTTP cuando aplica
• Flujo canónico: F-EDIT (ficha → editor → POST fórmula → ok)
• Flujo de escritorio: F-DESK (login → Hoy)
• Dueña / clienta: no tienen flujo de sistema

F0 — Entrada anónima (Guest)

cualquier ruta auth  →  sin token  →  /login?next=<path sanitizado>
/login               →  si hay token válido  →  /  (o next)

Éxito: cero cara pública.
AC: no hay landing, hero ni lead. Auth-first.

F1 — Login JWT (COLORISTA)

/login → POST /api/auth/login { email, password }
      → 200 { accessToken, user } → localStorage → /  (o ?next sanitizado)
      → 401 → mensaje error en form

Éxito: token guardado; user role=COLORISTA, nombre Nora Beltrán.
Credencial demo: nora@matiz.salon / password123.

[COMPROBADO] Credencial del encargo.

F2 — Hoy bento (COLORISTA)

/ (token)
  → GET /api/hoy
  → { sittings[3], lastFormula, oxidantWarning }
  → 3 tiles + última fórmula + aviso  |  empty  |  error  |  skeleton
  → tap silla → /fichas/:slug
  → tap última fórmula → /fichas/:slug  (de esa fórmula)

Éxito: 3 sillas reales en el fold, o empty accionable.
AC tiles: cada una muestra nombre, silla, último matiz. Cero botones Agendar / Cobrar.

Guión Nora (demo): silla 1 Marisol (honey balayage) · silla 2 Amina (copper) · silla 3 Pilar (silver). Última fórmula: Diego, ashy brown, 2026-08-01. Aviso: Amina trae 30 vol. [SUPUESTO de catálogo] alineado al seed de doc 05.

Errores / estados

[DECISIÓN] GET /api/hoy es el Must de producto. No hay POST de silla en v1 (S3).

F3 — Lista de fichas (COLORISTA)

/fichas → GET /api/clients
        → filas: foto, nombre, último matiz, fecha
        → tap fila → /fichas/:slug

Orden: updatedAt de última fórmula desc; quien no tiene fórmula, al final. [DECISIÓN]

Seed: marisol, lucia, amina, pilar, diego.

F4 — Ficha de clienta (COLORISTA)

/fichas/:slug → GET /api/clients/:slug
              → foto, nombre, matiz, historial de fórmulas
              → “La ficha no es una cita. MATIZ no agenda.”
              → CTA Nueva fórmula → /fichas/:slug/formula
              → tap fórmula → /fichas/:slug/formula?id=  (Could) o solo lectura en la misma ficha
              → 404 slug inexistente → mensaje + volver a /fichas

Éxito: ficha leíble; disclaimer visible; no hay hora, slot ni cobro.
Error: 404 si slug inexistente.

AC ficha

[DECISIÓN] v1 no tiene /fichas/:slug/formula/:id de detalle. El historial se lee en la ficha; el editor crea nueva. PATCH vive si se reabre Could con ?id=; Must = POST nueva.

F5 — Editor de fórmula (COLORISTA) · F-EDIT

/fichas/:slug/formula
  → si slug 404 → volver a /fichas
  → líneas [ { brand, tone, grams } ]  (mín. 1)
  → oxidante 10 | 20 | 30
  → minutes
  → notes
  → disclaimer “Esto es una fórmula, no la receta de la caja.”
  → disclaimer “Guardar no es aplicar.”
  → POST /api/clients/:slug/formulas
  → 201 Formula { id, status: SAVED, ... }
  → /ok/:id

Éxito: registro status=SAVED + pantalla success.
No hay «Aplicar» ni «Cobrar» en v1.

Errores

[DECISIÓN] Crear siempre como SAVED. No existe transición a APPLIED.

[COMPROBADO] Entidad Formula según encargo (lines JSON, oxidant 10|20|30, minutes, notes, status SAVED).

Variante desktop (UI-06)

Misma ruta /fichas/:slug/formula a 1440. El editor ocupa una columna ~720 + staff de ficha a la derecha (nombre, último matiz, disclaimer). No es otra app. [DECISIÓN]

F6 — Success de guardado (COLORISTA)

/ok/:id → GET /api/formulas/:id
        → copy de acuse + clientName / id
        → “Guardado no es aplicado. El color aún no está en el pelo.”
        → CTA ver ficha / volver a Hoy

AC: el disclaimer es visible sin scroll en desktop.
Si se entra a /ok/algo-que-no-existe: mensaje genérico + volver a Hoy; no se inventa un registro. [DECISIÓN]

F7 — Editar fórmula (COLORISTA) · PATCH

Desde ficha (Could: «corregir»)
  → GET /api/formulas/:id
  → mismos campos que F5
  → PATCH /api/formulas/:id { lines?, oxidant?, minutes?, notes? }
  → 200 Formula
  → /ok/:id  o vuelta a la ficha

[DECISIÓN] PATCH no acepta { status: "APPLIED" }. Status permanece SAVED. Corregir gramos no es aplicar.

Must de producto = POST nueva. PATCH es Should (el contrato API existe).

F8 — Cuenta y logout (COLORISTA)

/cuenta → GET /api/me
        → Salón Amparo · Calle Amparo 22, Usera · COLORISTA · Nora Beltrán
        → “MATIZ no agenda. MATIZ no cobra.”
        → Salir → limpia localStorage → /login

F9 — Health (ops)

GET /api/health → 200 { ok: true }  (o { status: 'ok' })

Sin auth. No es una pantalla. Smoke de arranque.

Matriz de errores global

Flujos fuera de alcance v1

• Registro / recuperación de password de COLORISTA
• Cuenta de clienta / «mi cita» / recordatorios
• Reserva o confirmación de hora
• Cobro / ticket / TPV
• Alta de ficha nueva (seed fijo; Could L+1)
• Alta de silla de mañana (agenda)
• Aplicar / marcar puesta
• Notificación push «Marisol en 10 min»
• Multi-colorista / turnos

05-data-model.md

05 — Modelo de datos — MATIZ

1. Visión general

Dominio L2 de oficio colorista + cuaderno autenticado:

Base: PostgreSQL (Neon project mute-wave-74707210) · IDs: cuid() o texto estable (usr_nora, cli_marisol).
[DECISIÓN] ensureSchema o Prisma son válidos si el contrato de tablas se cumple; el brief de stack no exige Prisma.

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

Role

FormulaStatus

Oxidant

10 | 20 | 30

3. Diagrama ER (texto)

users
  id, email, password_hash, name, role(COLORISTA)
  salon_name, salon_address
  created_at, updated_at
  1 ──< sessions
  1 ──< formulas          -- author
  1 ──< sittings          -- who wrote today's chairs (Could)

sessions
  id, user_id → users
  token_hash, expires_at
  created_at

clients
  id, slug (unique)
  name, age, shade          -- shade = último matiz memorable
  cover                     -- filename
  created_at, updated_at
  1 ──< formulas
  1 ──< sittings

formulas
  id
  client_id → clients
  author_id → users
  lines (JSONB)             -- [{ brand, tone, grams }]
  oxidant (10|20|30)
  minutes
  notes
  status (SAVED)
  created_at, updated_at

sittings
  id
  client_id → clients
  chair (1|2|3)
  day (DATE)                -- Europe/Madrid
  created_at

v1: una sola COLORISTA opera sobre el conjunto global.
No hay FK de clienta-usuaria: la clienta no se loguea.

4. Tablas

users

sessions

[DECISIÓN] El JWT viaja en Authorization: Bearer. sessions permite invalidar (logout) sin esperar expiración. Si el slice usa JWT stateless, documentar el hueco; D-P1-05 se cumple igual con guard.

clients

formulas

Validación de lines: cada ítem tiene brand (min 2), tone (min 1), grams (> 0, número). [DECISIÓN] JSONB, no tabla formula_lines en v1.

sittings

[DECISIÓN] Unique (day, chair) y unique (day, client_id): una silla, una persona; una persona, una silla ese día.

5. Reglas de integridad y negocio

6. Contratos API (resumen)

JSON camelCase hacia el web. [DECISIÓN]

POST /api/auth/login

Body: { email, password }
Response 200: { accessToken, user: { id, email, name, role, salonName, salonAddress } }
401 credenciales inválidas. Response sin hash.

GET /api/me (JWT)

Response 200: { id, email, name, role, salonName, salonAddress }
Sin token → 401.

GET /api/hoy (JWT)

Response 200

{
  "day": "2026-08-19",
  "sittings": [
    {
      "id": "sit_1",
      "chair": 1,
      "client": {
        "id": "cli_marisol",
        "slug": "marisol",
        "name": "Marisol Vega",
        "age": 47,
        "shade": "honey balayage",
        "cover": "marisol.jpg"
      },
      "lastFormula": {
        "id": "frm_marisol_2",
        "oxidant": 20,
        "minutes": 25,
        "status": "SAVED",
        "createdAt": "2026-06-24T10:00:00.000Z",
        "lines": [
          { "brand": "L'Oréal Dia Light", "tone": "9.3", "grams": 20 },
          { "brand": "L'Oréal Dia Light", "tone": "8.3", "grams": 20 }
        ]
      }
    }
  ],
  "lastFormula": {
    "id": "frm_diego_1",
    "clientSlug": "diego",
    "clientName": "Diego Rivas",
    "oxidant": 20,
    "minutes": 30,
    "status": "SAVED",
    "createdAt": "2026-08-01T11:00:00.000Z",
    "lines": [
      { "brand": "L'Oréal Majirel", "tone": "6.1", "grams": 20 },
      { "brand": "L'Oréal Majirel", "tone": "7.1", "grams": 20 }
    ]
  },
  "oxidantWarning": {
    "active": true,
    "chair": 2,
    "clientSlug": "amina",
    "oxidant": 30,
    "message": "Revisa el oxidante: Amina trae 30 vol. 30 no es 20."
  }
}

Si 0 sittings: { day, sittings: [], lastFormula, oxidantWarning: { active: false } } + empty UI-08.
lastFormula puede ser null si no hay ninguna.
Sin token → 401.

GET /api/clients (JWT)

Response 200: ClientCard[]

[
  {
    "id": "cli_marisol",
    "slug": "marisol",
    "name": "Marisol Vega",
    "age": 47,
    "shade": "honey balayage",
    "cover": "marisol.jpg",
    "lastFormulaAt": "2026-06-24T10:00:00.000Z",
    "lastOxidant": 20
  }
]

GET /api/clients/:slug (JWT)

Client + formulas[] (historial completo, createdAt desc) o 404.

{
  "id": "cli_marisol",
  "slug": "marisol",
  "name": "Marisol Vega",
  "age": 47,
  "shade": "honey balayage",
  "cover": "marisol.jpg",
  "formulas": [
    {
      "id": "frm_marisol_2",
      "lines": [
        { "brand": "L'Oréal Dia Light", "tone": "9.3", "grams": 20 },
        { "brand": "L'Oréal Dia Light", "tone": "8.3", "grams": 20 }
      ],
      "oxidant": 20,
      "minutes": 25,
      "notes": "Balayage miel. No bajar del 8.",
      "status": "SAVED",
      "createdAt": "2026-06-24T10:00:00.000Z"
    }
  ]
}

POST /api/clients/:slug/formulas (JWT)

Body

Response 201: Formula + id + status: "SAVED" + clientSlug.
Slug inexistente → 404. Sin token → 401. DTO inválido → 400.

GET /api/formulas/:id (JWT)

Formula completa o 404.

PATCH /api/formulas/:id (JWT)

Body: { lines?, oxidant?, minutes?, notes? }
No acepta status.
Response 200: Formula actualizada. Sin token → 401.

[COMPROBADO] PATCH sobre :id. [DECISIÓN] sin transición de status.

GET /api/health

Response 200: { ok: true }

7. Seed de referencia (2026-08-19)

COLORISTA

[COMPROBADO] Credencial del encargo. Nombre de pila es constructo de diseño.

Clients

[COMPROBADO] Slugs, nombres, edades y matices del encargo. Fotos en el case.

Formulas (8 · todas SAVED)

Las marcas, tonos y gramos son catálogo demo, no recetas oficiales de fabricante ni historial clínico real. [SUPUESTO de catálogo]

lastFormula de Hoy = frm_diego_1 (la más reciente).
oxidantWarning = Amina silla 2, frm_amina_2, 30 vol.

Sittings (hoy = 2026-08-19)

Lucía y Diego no tienen sitting hoy.

Las cinco fichas, las ocho fórmulas y las tres sillas son seed de producto. No se presentan como clientela real de un salón de Usera. [SUPUESTO de catálogo]

8. Evolución posible (no implementada)

06-tech-stack.md

06 — Stack tecnológico — MATIZ

1. Visión

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

2. Estructura

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

D-P1-03: npm --prefix o 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 API del encargo. No se añaden Must extra (/appointments, /payments, /sittings POST).

4. Justificación

5. Variables

.env local (nunca git):

.env.example solo placeholders.
Web: URL de API en ApiService (default http://localhost:3019/api).

6. Dependencias de producto (mínimas)

API

• @nestjs/common / core / platform-express
• @nestjs/jwt (o verificación manual)
• bcrypt (o bcryptjs)
• cliente Postgres (pg) o Prisma
• class-validator + class-transformer

Web

• Angular standalone
• Tailwind 3
• fuentes: Libre Baskerville + Nunito Sans (Google Fonts o self-host)

7. Arranque (contrato)

cd /Users/cristian/orca/matiz-app
# instalar apps independientes (npm --prefix o pnpm --filter)
# apps/api/.env → DATABASE_URL + JWT_SECRET + PORT=3019
# migrate / ensureSchema + seed
# api → http://localhost:3019
# web → http://localhost:4200

8. Lo que este stack no es

9. Nota sobre el repo existente

[COMPROBADO] Existe /Users/cristian/orca/matiz-app y el remoto previsto Criscode2022/matiz-app.
El scaffold contiene leftover de ZAGUÁN (listings, compare, mesa, modelos listing.ts, páginas wizard / comparar / finca). Esta suite define el contrato MATIZ; el código debe alinearse a las rutas y API de los docs 03–05, no al leftover. [DECISIÓN]

07-creative-direction.md

07 — Dirección creativa — MATIZ

1. Concepto

MATIZ es un cuaderno de capilla en pantalla: se entra a escribir un matiz y se sale con una fórmula, no una landing de «salón digital». El ground es yeso de capilla. Las sillas se apoyan como bancos. La amatista es vidriera, no un botón de marketing.

Mood elegido: chapel.
Primer instinto descartado: candlelit (ámbar × oxblood de «spa de lujo»). Un salón de Usera no es un spa; es un oficio con luz de vidriera y pizarra.

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

2. Territorio visual

3. Paleta

Jerarquía de color: el yeso carga; la amatista puntúa; el lino encuadra la ficha. Si la amatista pinta fondos enteros, deja de ser vidriera y se vuelve «brand purple». El oro no decora el header: solo puntual. [DECISIÓN]

4. Tipografía

Prohibido: Libre Baskerville por debajo de 20px (se rompe). Nunito Sans en el wordmark (se vuelve startup).

Fuentes vetadas de la serie: Instrument Serif / Sora / Cormorant / Public Sans / Spectral / Manrope / Zilla / Mulish / Newsreader / Outfit / Lora / Karla.

5. Fotografía

Las imágenes del case son el sistema, no un moodboard:

Crop: fichas y tiles en 1:1 (retrato). No recorte 16:10 editorial ni 4:3 de fachada. [DECISIÓN] 1:1 de oficio, distinto del 4:3 de ZAGUÁN y del 16:10 de MARGEN.

Tratamiento: saturación real, sin LUT «salon gold», sin piel HDR. La amatista no se superpone como filtro: vive en UI.

Swatches del bento (H-BENTO): círculos 24–32px con hex aproximados de oficio (miel, cobre, plata), no fotografías recortadas en círculo. [DECISIÓN]

6. Layout

Bottom tabs (S-BOTTOM)

┌─────────────────────────────────┐
│  (contenido · yeso)             │
├─────────────────────────────────┤
│  Hoy      Fichas      Cuenta    │  56–64px + safe-area
└─────────────────────────────────┘

Tab activo: Nunito 12 amatista + filete 2px amatista arriba del ítem.
Idle: peltre. Sin iconos outline de tijera si el label basta; si hay icono, trazo 1.5 pizarra/amatista.

Home (H-BENTO)

1. Wordmark + fecha civil («Miércoles 19»).
2. Lead en el fold: 3 tiles de silla (nombre Libre, silla meta, matiz peltre, swatch).
3. Tile de última fórmula (Diego · 6.1 + 7.1 · 20 vol).
4. Aviso oxidante si aplica (Amina, 30 vol).

No hay portada fotográfica a 60vh. hero.jpg vive en UX-00 Cover, no como hero de producto. [DECISIÓN] AP-21: 3 sillas reales en el fold.

Editor (F-EDIT)

Una columna. Líneas apiladas (marca · tono · gramos). Chips de oxidante. Minutos. Notas. CTA amatista Guardar. Disclaimers encima del CTA.

Desktop 1440: editor + staff de ficha. Misma receta, no otro producto.

Ficha

Retrato 1:1 a ~160–200px, no full-bleed. Nombre → matiz → historial. Blancos de capilla, no de landing.

Cuenta

Lista densa sobre yeso. No imita el bento. Es trastienda: salón, rol, salir.

7. Motion

Prohibido: parallax de vidriera, scroll-jacking, page transitions de 400ms, sticker de «NUEVO» parpadeante, animación de mechas.

8. Anti-clichés (serie ALS-2)

9. Tono de marca (visual + verbal, puente a doc 09)

Cercano de oficio y de lavacabezas. Tuteo. Segunda persona cuando habla la UI. Tercera cuando habla la ficha.

El producto se escribe y se guarda. No agenda, no cobra, no vende el bote de la caja.

10. Criterios de aceptación creativos

1. Ground de página = #E6E4ED. Cards = #F7F5FA. Nunca al revés.
2. Amatista en el tab activo y en el CTA, no un header púrpura lleno.
3. 3 sillas visibles en el primer viewport mobile (tras el wordmark).
4. Ninguna fuente de la lista vetada.
5. Home reconocible como bento de Hoy, no como hero 2-col de startup.
6. Success no celebra un «color aplicado» ni un cobro.
7. Oro solo en badge / filete de success, no en el chrome.

08-design-system.md

08 — Design system — MATIZ

1. Tokens

--color-chapel:   #E6E4ED;   /* G-CHAPEL ground */
--color-slate:    #2B2838;
--color-amethyst: #6B4C9A;
--color-linen:    #F7F5FA;   /* cards only — lino */
--color-pewter:   #6E6A78;
--color-gold:     #C4A35A;   /* acento secundario */
--color-saved:    #C4A35A;   /* badge SAVED */

--font-display: "Libre Baskerville", "Iowan Old Style", serif;
--font-ui:      "Nunito Sans", system-ui, sans-serif;

--radius-card: 4px;          /* lino de ficha, no pill */
--radius-cta:  4px;
--rule-tab:    2px solid var(--color-amethyst);
--space:       4 / 8 / 12 / 16 / 24 / 32 / 48 / 64;

Tailwind (referencia):

[COMPROBADO] Hex y tipo = brief.

2. Escala tipográfica

3. Componentes

Bottom tabs (S-BOTTOM)

Slots: Hoy / · Fichas /fichas · Cuenta /cuenta.
Login no lleva tabs.

Tile de silla (Hoy)

┌─────────────────────────────┐
│ ①  Marisol Vega             │  nº silla meta + nombre Libre
│ honey balayage        ●     │  matiz peltre + swatch
└─────────────────────────────┘

• Fondo lino, sin sombra.
• Toda la tile es un <a> a /fichas/:slug.
• Hover: rule 1px pizarra. Sin lift.
• Swatch 24px, aria-hidden (el matiz ya está en texto).

Tile última fórmula

Mismas reglas. Muestra clienta, resumen de líneas (6.1 + 7.1), oxidante, fecha. Enlace a /fichas/:slug.

Aviso oxidante

Banner lino + filete amatista 2px izquierda. Texto Nunito 16. No es alert agresivo; es oficio.

Fila de ficha (lista)

Toda la fila es un <a> a /fichas/:slug.

Ficha de clienta

Editor (F-EDIT)

Desktop 1440: grid 2 col (editor 7 / staff 5). Staff: retrato, nombre, último matiz, disclaimer.

Botones

Pending: disabled + aria-busy. No spinner de marca.

Form

Labels visibles (no placeholder-only). Inputs h-44, radius 4, rule peltre 40%, foco outline 2px amatista offset 2.

Chips de oxidante: <button aria-pressed>. Selected: amatista texto o rule 2px amatista. Idle: lino + rule.

Estados

4. Grid y breakpoints

Padding horizontal: 24 desktop, 16 mobile.
Main autenticado: padding-bottom: calc(64px + env(safe-area-inset-bottom) + 16px) para no tapar el CTA.

5. Iconografía

Mínima. El cuaderno no es un set de iconos outline de tijera.

Si hace falta un icono (salir, error): trazo 1.5, 20px, pizarra. No pack Remix/Lucide a color.

6. Elevación y borde

Cero sombras shadow-lg. La capilla no flota.

7. Mapa componente → ruta

8. Criterios de aceptación DS

1. Tokens Tailwind = hex del brief, sin «casi blanco» #FAFAFA como ground.
2. Cards en lino; página en yeso.
3. Primary CTA nunca en peltre sobre yeso (contraste).
4. Libre Baskerville no aparece en labels de form ni en tabs.
5. Recorte de ficha aspect-square, no 16:10 editorial ni 4:3 de finca.
6. Targets de tabs, chips y CTA ≥44px.
7. Tabs no tapan el CTA Guardar (padding-bottom).

09-content-guide.md

09 — Guía de contenido — MATIZ

1. Voz

Cercana de oficio y de lavacabezas. Tuteo en UI. Segunda persona cuando la interfaz habla. Tercera cuando habla la ficha.

Sin jerga de spa («experiencia cromática», «tu mejor versión», «no te lo pierdas»). Sin sede electrónica. Sin «reserva tu slot».

El producto se escribe y se guarda. No agenda, no cobra, no vende el bote de la caja.

2. Palabras permitidas / prohibidas

3. Microcopy duro (literales irrenunciables)

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

[DECISIÓN] Los cinco textos son obligatorios en UI. No se diluyen a un tooltip.

4. Microcopy por superficie

5. Fichas seed (tono)

Las fichas demo se escriben como nota de oficio, no como folleto de marca ni como crónica de lookbook.

No inventar declaraciones de clientas reales. Si hay una voz, es de la nota (neutra) o de persona de diseño etiquetada.

6. Nombres propios del seed

No inventar CIF, número de colegiada, ni precios de servicio. [SUPUESTO de catálogo demo]
Marcas seed (Dia Light, Majirel, Koleston, Igora, Illumina) son nombres de oficio reconocibles, no recetas oficiales ni partnership. No se afirman como ficha real 2026.

7. Tono por estado

La app no envía esos mensajes en v1. El copy solo prepara el habla.

8. Capitalización y números

• Wordmark: MATIZ en versales Libre Baskerville.
• Nombres: Marisol Vega, Amina El Idrissi (respetar partículas).
• Gramos: 20 g (espacio).
• Oxidante: 20 vol (no «20 volúmenes» en chip; sí en aviso largo).
• Minutos: 25 min.
• Edad: 47 junto al matiz, no «47 años de edad».
• Silla: Silla 1 (mayúscula S).
• Fecha: 24 jun en lista; miércoles 19 de agosto en Hoy.
• No mezclar «20vol» pegado ni «g.» con punto.

9. Idioma

es-ES. Fácil lectura. EN no en v1.
No mezclar «formula» en UI. En API sí: formulas, oxidant, shade.

«Clienta» en UI cuando el seed es mujer; «cliente» para Diego; «fichas» para el conjunto. [DECISIÓN]

10. Accesibilidad de copy

• No transmitir estado solo con color («la amatista significa 30 vol»).
• Badge lleva texto: Guardada.
• Aviso de oxidante lleva nombre y número, no solo el banner púrpura.
• Alt de fotos: nombre + matiz, no «imagen1».
  • hero: «Luz de capilla y pizarra; oficio de color, no spa.»
  • marisol: «Marisol Vega, ficha honey balayage.»
  • lucia: «Lucía Campos, ficha blue-black.»
  • amina: «Amina El Idrissi, ficha copper.»
  • pilar: «Pilar Núñez, ficha silver.»
  • diego: «Diego Rivas, ficha ashy brown.»

11. Piezas que no se escriben

10-accessibility.md

10 — Accesibilidad — MATIZ

Objetivo: WCAG 2.2 AA. No se declara conformidad legal certificada.
Este documento cubre la UI (login, Hoy, fichas, editor, cuenta). No audita la accesibilidad física del Salón Amparo (lavacabezas, umbral, silla). [SUPUESTO]

1. Decisiones

2. Contraste (comprobación de diseño)

3. Teclado

• Enter en tile = navegar a ficha.
• Enter en chip oxidante = selecciona (aria-pressed).
• Escape no cierra el editor (no es modal). Confirm de descarte no es Must.
• Focus trap: no hay modal Must.

4. Semántica

5. Lector de pantalla — copy

6. Producto vs salón físico

[DECISIÓN] v1 no incluye auditoría a11y de sede. El campo age es dato de ficha demo, no un certificado.

7. Riesgos

8. QA a11y (mínimo)

9. Criterios de aceptación

1. Ningún control de tab, chip o CTA mide menos de 44×44 CSS px.
2. El disclaimer no depende del color amatista para ser entendido.
3. Las 5 fotos seed + hero tienen alt no vacío y no genérico.
4. El foco no se pierde al reintentar un error de red.
5. En 390 el CTA Guardar queda por encima de los tabs.
6. Una ficha no se anuncia en Hoy sin token (no hay HTML público de clientas).

11-privacy-security.md

11 — Privacidad y seguridad — MATIZ

1. Datos que existen

No se pide cuenta a la clienta. No hay teléfono, email ni DNI de Marisol en producto. No hay tracking de menores. Las fotos seed no se presentan como clientela real.

2. Minimización

Edad en seed es dato de ficha demo, no un requisito de negocio. L+1 podría omitirla. [DECISIÓN]

3. Seguridad L2

No se declara cumplimiento RGPD definitivo. Sí: minimización, auth-first y derecho a borrar la cuenta de colorista (manual L2). Las fichas seed se tratan como datos de demo, no como encargo de tratamiento de un salón real.

4. Superficies de riesgo

5. Roles y autorización (recordatorio)

Inma, Marisol, Lucía, Amina, Pilar y Diego no tienen fila en users.

6. Criterios de aceptación

1. Response de login no incluye password ni password_hash.
2. GET /api/clients y GET /api/hoy sin Bearer son 401, no 200 [].
3. GET /api/clients/marisol sin Bearer es 401, no 200.
4. No hay formulario público que pida teléfono o email de clienta.
5. / sin token redirige a /login (no renderiza sillas en HTML anónimo).
6. .env no se commitea.

12-analytics.md

12 — Analítica — MATIZ

North star: % de sillas de hoy con fórmula guardada el mismo día (hoy_view con sittings + formula_save ligado a clientSlug de esas sillas).

Instrumentación modelo. No hay proveedor conectado en v1 salvo que el build añada un logger local. [DECISIÓN] No se inventan cifras de conversión.

1. Eventos

2. Qué no se mide

Hipótesis H2: ficha_open sin appointment_click (el CTA no existe). Si en un test de 5 coloristas alguien busca «hora», se anota en research futuro, no como KPI inventado.

3. Funnel modelo (COLORISTA)

colorista_login  →  hoy_view  →  ficha_open  →  editor_open  →  formula_save

Activación = primer formula_save.
Completud del día = formula_save cuyo slug ∈ slugs de hoy_view.sittings / nº de sittings.

North star de sesión de demo: de 3 sillas, cuántas tienen un formula_save con createdAt del mismo día civil Europe/Madrid.

4. Integridad (producto, no vanidad)

5. Privacidad de analítica

Sin PII extra. slug es identificador de seed (marisol), no un email. No se guarda IP como usuario. Ver doc 11.
No se envían notes ni lines completas a un tercero.

6. Criterios de aceptación (si se instrumenta)

1. Los 7 eventos de §1 tienen nombre estable.
2. No se dispara ningún evento de lead / cita / cobro / aplicado.
3. Un bloqueador de cookies no rompe el editor (analítica no es Must de runtime).

13-qa-test-plan.md

13 — Plan de pruebas — MATIZ

1. Smoke obligatorio (D-P1-06)

[COMPROBADO] Smoke = health + login JWT + hoy + clients.

2. Casos funcionales

3. Datos de prueba

4. Regresión de diversidad / craft

5. Hipótesis (no se «prueban» en la demo)

H1, H2, H3 requieren uso real. El QA verifica que existen las superficies que permitirían medirlas (editor, Hoy con 3 sillas, disclaimer de cita, ausencia de signup clienta, 401 público).

6. Criterios de salida QA v1

• Smoke §1 en verde.
• S2, S6, S8, S10, S17, S21, S25 en verde.
• Cero blockers de copy deshonesto (cita / aplicar / receta de caja / cobrar / agendar).
• Sin .env en el repo.

7. Fuera de este plan

Playwright e2e completo, carga, fuzzing, auditoría de un salón real.

14-dev-handoff.md

14 — Handoff desarrollo — MATIZ

1. Arranque

cd /Users/cristian/orca/matiz-app

# apps independientes (npm --prefix o pnpm --filter)
# apps/api/.env
#   DATABASE_URL=  # Neon mute-wave-74707210
#   JWT_SECRET=
#   PORT=3019

# migrate / ensureSchema + seed
# api → http://localhost:3019
# web → http://localhost:4200

Demo: nora@matiz.salon / password123.

2. Paridad Paper

No clonar ZAGUÁN (wizard + comparador), MARGEN (lookbook + masthead), CESTA (tabla + rail), RONDA (feed + dock) ni CANTERA (parte + wizard de oficio).

Paper se construye en paralelo; los nombres de artboard son el inventario planificado (doc 00).

3. Contratos

Campos JSON en camelCase hacia el web aunque SQL sea snake_case. [DECISIÓN]

4. Mapa de rutas web

Guard: si no hay token, /login?next=. La API es la autoridad.

[COMPROBADO] Solo estas rutas. No implementar /cita, /agenda, /cobrar, /comparar, /mesa.

5. Assets

Copiar desde el case:

2026-08-19-matiz/assets/hero.jpg
2026-08-19-matiz/assets/clients/marisol.jpg
2026-08-19-matiz/assets/clients/lucia.jpg
2026-08-19-matiz/assets/clients/amina.jpg
2026-08-19-matiz/assets/clients/pilar.jpg
2026-08-19-matiz/assets/clients/diego.jpg
  → apps/web/public/assets/clients/   (hero a public/assets/)

cover del seed = filename (marisol.jpg, …).

Quitar leftover public/assets/listings/* y páginas wizard / comparar / mesa si siguen en el repo.

6. DoD implementación L2

7. No hacer

8. Contactos de diseño (artefactos)

15-roadmap.md

15 — Roadmap — MATIZ

Este documento no es un cajón de trabajo L2 a medias.
El vertical slice L2 del brief está especificado como done-scope (docs 01, 18, 19).
Aquí solo viven ideas de L+1 / L3 y pulido posterior.

1. Hecho en L2 (esta ejecución documental)

2. Implementación L2 (misma complejidad, código)

Contrato en docs 14 y 20. No es deuda silenciosa del case documental: es el build del repo matiz-app. El alcance L2 ya está cerrado en spec; el código alinea leftover (listings / compare / mesa) al contrato.

Eso no se reabre aquí como «próximo trimestre de producto».

3. L+1 (misma familia, subida de pulido)

Estas son subidas de pulido, no parches del L2 documental.

[DECISIÓN] No dejar backlog del vertical slice como «mañana». Lo de arriba es L+1.

4. L3 (requiere brief nuevo de diversidad)

• Multi-colorista / turnos / comisiones
• Agenda / slots / F-BOOK
• TPV / ticket / pasarela
• Cuenta de clienta y «mi cita»
• Recetario oficial de marca
• Foto del resultado como UGC
• Historial clínico / alergias
• Cadena de salones

5. Explícitamente fuera (no backlog disfrazado)

6. Orden de ataque si hay continuidad de código

1. Contratos 05–06 + seed 05 + smoke 13 (alinear leftover)
2. Web paridad UI-00…11
3. Alta de ficha + PATCH historial (L+1)
4. Rate limit si hay tráfico
5. Evaluar brief L3 (no parche silencioso)

16-interaction-specs.md

16 — Especificación de interacción — MATIZ

1. Convenciones

Loading (skeleton de UI-02 / UI-03) y editor desktop (UI-06) viven en este doc junto a los gestos; el inventario Paper ya reserva UI-06 y UI-10. [DECISIÓN]

2. Bottom tabs (S-BOTTOM)

Estado activo: label amatista + filete 2px amatista arriba.
Estado default: peltre.

390: 56px + env(safe-area-inset-bottom).
Desktop: 64px inferior centrado o full-bleed; no se convierte en top-nav.

Login no muestra tabs.

3. Login (UI-01)

next permitido: paths que empiezan por / y no // ni http. Allowlist: /, /fichas, /fichas/:slug, /fichas/:slug/formula, /ok/:id, /cuenta.

4. Hoy bento (UI-02) + loading

AC: nombre, silla y último matiz visibles en cada tile sin hover. 3 sillas en el fold a 390 (AP-21). Cero botones Agendar / Cobrar.

Aviso 30 vol: visible bajo las tiles; no es dismissible Must (Could: «entendido» solo oculta en sesión).

5. Fichas (UI-03)

Sin swipe-to-archive. Sin búsqueda Must (5 filas).

6. Ficha (UI-04)

Sin «llamar ahora». Sin WhatsApp click-to-chat. Sin «agendar».

7. Editor móvil (UI-05) · F-EDIT

Submit deshabilitado si 0 líneas, grams ≤ 0, oxidant vacío o minutes vacío.

[DECISIÓN] Un solo botón primario: Guardar fórmula. No existe «Aplicar» ni «Guardar y aplicar».

390: CTA full-width h-44 por encima de los tabs (padding-bottom). Teclado iOS no debe tapar el input activo: scroll-margin en campos.

8. Editor desktop (UI-06)

Misma ruta, viewport ≥1200.

No hay atajos de teclado extra Must. Cmd+Enter Could L+1.

9. Success (UI-07)

Sin confetti. Sin «¡ya está en el pelo!». Sin «cobrar».

10. Empty (UI-08) · Error (UI-09) · Loading (UI-10)

11. Cuenta (UI-11)

No hay edición de perfil Must. No hay «cambiar password».

12. Motion

Prohibido: scroll-jacking, page transitions de 400ms, parallax de vidriera, like animation, gotas de tinte, mechas que crecen.

13. Criterios de aceptación de interacción

1. Una COLORISTA en 390px llega de Hoy a guardar una fórmula en ≤ 4 taps (silla → nueva → … → Guardar).
2. Ningún submit permite doble POST.
3. Los tabs no cubren el H1 ni el CTA Guardar (spacer).
4. Reduced-motion elimina stagger y slide.
5. La home no es hero 2-col (AP-12).
6. En 390 las 3 sillas son visibles sin scroll de «marca» (AP-21).
7. / y /fichas/:slug no presentan ningún control de cita ni cobro.
8. El loading de Hoy es skeleton bento, no un logo.
9. El editor muestra «fórmula, no receta» y «guardar no es aplicar» sin scroll en desktop.
10. Manos húmedas: cero gestos que exijan hover o swipe horizontal como único camino.

17-prototype-map.md

17 — Mapa de prototipo — MATIZ

Paper no es clicable vía MCP. El prototipo vivo es la app Angular.
Los artboards de Paper se construyen en paralelo; esta tabla es el contrato de paridad.

Proceso: UX-00…UX-11. Tokens: UI-00.

Empty, error y loading se prototipan como estados / variantes de UI-02 / UI-03 además de sus boards propios. Ver doc 16.

Recorrido demo (guión)

1. Abrir / sin token — redirect /login. Leer eslogan La fórmula, no la cita.
2. Entrar nora@matiz.salon / password123.
3. / — Hoy bento: Silla 1 Marisol honey · Silla 2 Amina copper · Silla 3 Pilar silver. Última fórmula Diego 6.1+7.1 20 vol. Aviso: Amina trae 30 vol.
4. Tocar Marisol Vega — ficha, historial de junio, «La ficha no es una cita.»
5. Nueva fórmula — líneas Dia Light 9.3 20 g + 8.3 20 g, 20 vol, 25 min. Leer «Esto es una fórmula, no la receta de la caja.» y «Guardar no es aplicar.»
6. Guardar fórmula → /ok/:id — «Guardado no es aplicado.»
7. Volver a la ficha: la nueva está SAVED.
8. Tab Fichas — 5 filas. Abrir Diego (no está hoy).
9. Tab Cuenta — Salón Amparo, Calle Amparo 22, COLORISTA. Leer «MATIZ no agenda. MATIZ no cobra.»
10. Comprobar que no hay botón Agendar, Cobrar ni Aplicar.
11. Salir → /login.

Estados en el mismo prototipo

Fuera del prototipo clicable

• Paper artboards son estáticos.
• WhatsApp de Inma (hora) / caja física (ticket).
• El gesto de aplicar el color en el lavacabezas.
• Reserva de cita (no existe).
• TPV / cobro (no existe).
• Cuenta de clienta.
• Recetario oficial de marca.

18-completeness-audit.md

18 — Auditoría de completitud — MATIZ (2026-08-19)

1. Alcance auditado

Vertical slice L2: PWA auth-first de cuaderno de fórmulas + fichas + editor + JWT COLORISTA, con docs, referencia Paper, contratos Angular + Nest + Neon.

Este encargo cubre la suite documental. Paper hi-fi y el repo matiz-app pueden existir en paralelo; la auditoría marca lo que esta suite cierra. El day brief y el paper-reference no se han sobrescrito.

2. Checklist CRON / ALS-2

3. Cobertura funcional

4. Cobertura Paper (literales)

[COMPROBADO] UX-count: 12 y UI-count: 12 literales para el gate check-paper-reference.mjs. Paper hi-fi en construcción paralela; inventario planificado escrito.

5. Rúbrica de calidad (auto SCORE orientativo · docs)

6. Huecos aceptados (no regresiones de cierre documental)

7. Veredicto

COMPLETO para entrega documental del caso 2026-08-19.
La suite define producto L2 usable (tablas, AC, riesgos, contratos) sin presentar investigación de campo como hecho.
Cualquier ampliación agenda / TPV / clienta-login / recetario / lookbook requiere nuevo brief de diversidad, no parche silencioso.

19-backlog-completo.md

19 — Backlog completo — MATIZ

Inventario de ítems. Los del alcance L2 documental del día están Done.
El resto es opcional / siguiente nivel, no deuda oculta del cierre.

1. Done — L2 case documental (2026-08-19)

Los must-have del brief (login, Hoy, fichas, ficha, editor, success, empty/error/loading, cuenta, ≥12 UX + ≥10 UI) están dentro de D01–D24, no como leftover.

2. Backlog L2 implementación (repo matiz-app)

Alineación de código al contrato ya cerrado. No es alcance documental pendiente.

3. Backlog L+1 (polish)

4. Backlog L3 (requiere brief nuevo)

5. Backlog explícitamente fuera

6. Explicitamente no-backlog

7. Orden de ataque recomendado (continuidad de código)

1. I01–I12 (vertical slice runnable, sin leftover)
2. B03 + B04 + B08
3. B01 + B02
4. B06 + B11 si hay campo
5. Evaluar brief L3 — no parche silencioso

8. Trazabilidad