00-day-brief.md

00 — Day brief · 2026-08-28 · MANTA

Decisiones ALS-2 BRIEF

Terna unicidad

R-CL · S-BOTTOM · H-MAP · F-MKT

0 códigos iguales a N−1 (PIÑÓN: R-HY · S-TOP · H-BENTO · F-CMP).
≥2 distintos vs N−2 (BOBINA: S-DOCK · H-FEED · F-STORY) y N−3 (LOMO: S-CMD · H-DATA · F-LEAD).

S-BOTTOM, H-MAP y F-MKT no están en los últimos 5.
R-CL cumple la mezcla de 4 días (PIÑÓN R-HY, BOBINA R-IN, LOMO R-CL).

Ground (CRON §5.6)

• Familia: G-BONE (botanical)
• Hex: #F4F1E8
• Por qué: no grafito de nave (PIÑÓN), no terciopelo (BOBINA), no caliza (LOMO), no cartel blanco (ONDA), no hielo (RAMAL). El merendero se lee con hueso de plaza y musgo, no con sepia de rastro vintage (primer instinto).

Mood visual (Paper)

• Candidatos: rastro vintage sepia (primer instinto), arid/dust, botanical, rusted, pastoral
• Elegido: botanical — no el primer instinto El Rastro. Un domingo en Usera se lee con geranio, plátano de sombra y hueso de muro, no con sepia de mercadillo “vintage”.
• Paleta:
  • #F4F1E8 hueso de muro (ground)
  • #1A2B1C musgo profundo (ink)
  • #FFFFFF ficha
  • #3F6B4A musgo (mark)
  • #6E7A70 mute
  • #C45C4A geranio (poco)
• Tipo: Libre Baskerville display · Nunito Sans UI

Home foto-led (D-P1-09)

UI-01 = Deriva en plano: tile de la plaza a sangre (≥40 % del recorte 16/10) + lead + 3 datos (libres / pedidos / entregados) + 4 mantas. No tabla H-DATA. Cuota last 6 ya cumple 3; aun así la home pública lleva foto.

Alcance L1 must

1. Home plano foto-led: 4 mantas + 3 métricas
2. Dejar un trasto (nombre, teléfono, qué es, color)
3. Llevarse un trasto (F-MKT, una pieza, sin carrito)
4. Success con código
5. Login JWT REGIDORA
6. Mesa de mantas (LIBRE / PEDIDO / ENTREGADO) — no kanban
7. Empty / error / loading / mobile
8. ≥12 UX + ≥10 UI

Microcopy duro

• Dejar el trasto ≠ vender en Wallapop. No hay puja ni anuncio.
• Trueque ≠ subasta. No se puja.
• Llevarse ≠ reservar IKEA. No hay carrito.
• MANTA no es Wallapop.

Supuestos

• S1: El merendero atiende 4 trastos/mañana en el slice; demo 4. [SUPUESTO]
• S2: El vecino deja o se lleva sin cuenta. JWT solo REGIDORA. [SUPUESTO]
• S3: Sin pagos, sin GPS, sin chat, sin kanban, sin e-commerce. [DECISIÓN]
• S4: Usera / plaza es atrezzo, no un merendero real. [SUPUESTO de plaza]

Hipótesis

Seed demo

Objetos son catálogo demo. No es un merendero real. [SUPUESTO de plaza]

JWT

nines@manta.plaza / password123 · rol REGIDORA · API :3028

00-paper-reference.md

Paper reference · MANTA

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

1. Identidad

[COMPROBADO] Nombre, terna, nivel, sector, ground y paleta salen de docs/00-day-brief.md.
[SUPUESTO de plaza] Usera / plaza / trastos seed son atrezzo de mercado, no un merendero real ni un acuerdo municipal.

Tras PIÑÓN (L2 taller, 2026-08-27) el día elige L1 merendero, no otro L2 consecutivo. N−1 es PIÑÓN. [DECISIÓN]

2. Problema

Principal (hipótesis de diseño)

[HIPÓTESIS] La vecina de Usera no necesita vender en Wallapop ni pujar ni reservar IKEA: necesita dejar un trasto en la manta y saber si la lámpara sigue ahí sin preguntar por WhatsApp. Hoy eso vive en un recado al grupo del portal, una foto borrosa y una expectativa de «tienda». Dejar el trasto se lee como vender; el trueque se lee como subasta; llevarse se lee como reservar; el producto se lee como Wallapop. [SUPUESTO] Un merendero de barrio atiende 4 trastos/mañana; no opera un catálogo ni un GPS.

Secundarios

Supuestos (no investigación primaria propia)

• S1: El merendero atiende 4 trastos/mañana en el slice; demo 4. [SUPUESTO]
• S2: El vecino deja o se lleva sin cuenta. JWT solo REGIDORA. [SUPUESTO]
• S3: Sin pagos, sin GPS, sin chat, sin kanban, sin e-commerce. [DECISIÓN]
• S4: Usera / plaza es atrezzo, no un merendero real. [SUPUESTO de plaza]

Hipótesis de producto

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

3. Propuesta de valor

No es MANTA

4. Objetivos

Negocio / caso de estudio

• Demostrar vertical slice L1 merendero de barrio con Trasto + Trato + JWT REGIDORA.
• Portfolio coherente: Paper (12 UX + 12 UI) + docs + app runnable.
• Terna R-CL · S-BOTTOM · H-MAP · F-MKT frente a PIÑÓN (top/bento/cmp), BOBINA (dock/feed/story) y LOMO (cmd/datos/lead).
• No encadenar otro L2 tras PIÑÓN. [DECISIÓN]

Usuario

No objetivos v1 (explícitos)

• Pagos, precio, pasarela, escrow
• GPS, tracking, mapa GIS de la ciudad
• Subasta, puja, timer
• Carrito, hold IKEA, multi-pieza
• Chat, kanban, columnas Recibido / En curso
• Cuenta de vecino, socio, newsletter
• Multi-plaza, multi-regidora
• App nativa ni notificaciones push
• Rol portera / dueño autenticado extra (Nines es la REGIDORA)
• Bicis, ganchos, MECANICO, pinon-api (PIÑÓN es otro día)
• Sesiones, butacas, PROGRAMADOR (BOBINA es otro día)
• Ejemplares, BIBLIO, comando (LOMO es otro día)

5. Roles y permisos (resumen)

[DECISIÓN] Un solo rol autenticado: REGIDORA. La vecina no es un usuario del sistema: es autora de un trasto (dejar) o de un trato (llevarse). Amparo no es un rol de sistema el día 1.

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

7. Alcance funcional v1 (L1)

8. Criterios de aceptación de producto

1. / es el plano foto-led Deriva (tile de plaza a sangre ≥40 % del recorte 16/10 + lead + 3 datos + 4 mantas). No pide cuenta. No es un hero 2-col + 3 cards. No es un feed. No es una mesa de datos. No es un bento de ganchos.
2. Una vecina puede ver 4 trastos, dejar uno y obtener success en /ok/MNT-XXXX, o llevarse uno LIBRE.
3. /ok/:code dice explícitamente que dejar el trasto no es vender en Wallapop y que trueque no es subasta.
4. La UI dice explícitamente que llevarse no es reservar IKEA y que MANTA no es Wallapop.
5. Sin token, GET /api/mesa responde 401. POST /api/trastos, POST /api/tratos y GET /api/trastos son públicos.
6. Un POST de dejar no crea user, no cobra, no abre anuncio, no mueve kanban, no enciende GPS.
7. Un POST de llevarse sobre no-LIBRE responde 409. Una pieza. Sin carrito.
8. Una REGIDORA inicia sesión y ve 4 trastos (2 LIBRE, 1 PEDIDO, 1 ENTREGADO) en el seed.
9. El tablero autenticado es una mesa de mantas. No es un kanban de 3 columnas. No es un split lista | ficha.
10. Fotos reales en las cubiertas seed (assets trastos/*).
11. Chrome S-BOTTOM: Plaza · Dejar · Mesa. Home sin top de taller y sin dock de cineclub.
12. Rutas solo las del doc 03. No existen /encargo, /buscar, /carrito, /subasta, /gps.
13. GET /api/health devuelve service: "manta-api" (no pinon-api, no bobina-api).
14. El plano público no muestra teléfonos de otras vecinas; la mesa REGIDORA sí muestra dejas y tratos con nombre y teléfono.
15. MNT-2801 y MNT-2803 aparecen LIBRE; MNT-2802 PEDIDO; MNT-2804 ENTREGADO; no se vende ninguno.

9. Stack y artefactos

[COMPROBADO] Puerto, Paper file ID, path de app, Neon y GH constan en el encargo.
El código vive en manta-app con este contrato. Este doc es la fuente de verdad del slice L1.

10. Riesgos y mitigaciones

11. Glosario

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

13. Relación con el día anterior

[COMPROBADO] El brief fija terna R-CL · S-BOTTOM · H-MAP · F-MKT. 0 códigos iguales a N−1 (PIÑÓN). ≥2 distintos vs N−2 (BOBINA) y N−3 (LOMO). S-BOTTOM, H-MAP y F-MKT no están en los últimos 5. Ground G-BONE #F4F1E8, no G-GRAPHITE ni sepia de rastro.

02-ux-research-strategy.md

02 — Estrategia de investigación UX — MANTA

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 merenderos / trueques de barrio (manta en plaza, recado de «¿sigue ahí?», 4 trastos a la mañana, portera que mira, grupo de WhatsApp del portal).
• Analogía operativa con superficie pública + panel JWT de la serie daily.
• Restricciones ALS-2: no Wallapop, no subasta, no reserva IKEA, no taller de bicis, no paseo turístico, no despensa ONG.

Límites éticos de verdad

3. Stakeholders

Mapa de poder (resumen)

• Decisor de adopción: la plaza (quién tiende las mantas) y, en uso diario, Nines (quien mira la mesa).
• Usuario frecuente de dejar/llevarse: VECINA (plano + form, sin cuenta).
• Usuario frecuente de oficio: REGIDORA (mesa /mesa).
• Riesgo de rechazo: si el success parece un ticket de tienda; si el tile parece un anuncio; si hay que crear cuenta; si la mesa parece un kanban; si llevarse abre un carrito.

4. Personas

P1 — Nines Ortega · REGIDORA

Escenario: Entra a /login, abre /mesa, lee MNT-2801 Lámpara LIBRE, ve los tratos. El copy dice que llevarse no es reservar IKEA.

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

P2 — Pilar Ramos · VECINA

Escenario: Abre / en el móvil, ve 4 mantas, toca la lámpara LIBRE o Dejar, escribe nombre y teléfono, lee «dejar el trasto ≠ vender en Wallapop» y el código MNT-XXXX.

[COMPROBADO] El gesto (vecina, deja o se lleva sin cuenta) sale del encargo. Nombre sale del encargo. Edad es constructo. [DECISIÓN]
Pilar no tiene fila en users. [DECISIÓN]

P3 — Amparo · VECINA MAYOR (docs / a11y)

[DECISIÓN] no hay cuenta de Amparo en v1; a11y la contempla en docs 10. Sin apellido inventado más allá del nombre del encargo. Edad = constructo de diseño.

5. JTBD

Job principal (vecina)

Cuando sobra un trasto o falta uno en casa, quiero dejarlo en la manta o llevarme uno que esté libre sin preguntar por WhatsApp, para que Nines lo vea sin que eso signifique venta, cuenta, subasta ni reserva IKEA.

Job principal (regidora)

Cuando hay mantas tendidas y tratos nuevos, quiero ver LIBRE / PEDIDO / ENTREGADO, para mover el oficio de la plaza sin un kanban ni un anuncio.

Jobs que MANTA no hace

6. Stories Must (v1)

Could (fuera de L1, solo L2/L3): pagos, GPS, login de Amparo, chat, cuenta de vecina, carrito.

7. Journey (resumen)

1. Pilar abre /. Ve tile de plaza a sangre + 3 datos (libres / pedidos / entregados) + 4 mantas. MNT-2801 LIBRE; MNT-2802 PEDIDO. [H1]
2. Toca la lámpara LIBRE → sheet llevarse (UI-03). Escribe «Pilar Ramos» y teléfono. POST /api/tratos → /ok/MNT-2801. Lee las cuatro oposiciones. [H2]
3. Alternativa: toca Dejar → /dejar. Nombre, teléfono, qué es, color. POST /api/trastos → /ok/MNT-2805.
4. Intento de silla PEDIDO → 409 «Ese trasto ya no está libre.»
5. Nines entra a /login → /mesa. Mantas por estado + tratos.
6. Lee MNT-2801 PEDIDO (si hubo trato) y MNT-2804 ENTREGADO. Copy: llevarse no es reservar IKEA.

Backstage: Nest + Neon + JWT. Transportista y dueño no entran. No hay Wallapop. No hay GPS.

8. Blueprint (resumen)

9. Matriz hallazgo → requisito → feature

10. Preguntas que este case no responde

• ¿Cuántos trastos reales se dejan en Usera en 2026?
• ¿Qué junta de distrito opera un merendero oficial?
• ¿Pilar preferiría el WhatsApp?
• ¿Amparo necesita un modo tipográfico mayor permanente?
• ¿Nines marcaría ENTREGADO antes de las 14:00 de verdad?

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

11. Cierre

Investigación = modelado etiquetado + restricciones ALS-2.
No hay entrevistas inventadas.
Paper UX-00…11 documenta el mismo arco. [COMPROBADO] inventario en 00-paper-reference.md.

03-information-architecture.md

03 — Arquitectura de información — MANTA

1. Principios de IA

2. Sitemap

/                                      Plaza plano público (Deriva)                    H-MAP
                                       + sheet llevarse (UI-03)                        F-MKT · público
/dejar                                 Dejar un trasto                                 público
/ok/:code                              Success post-dejar o post-trato                 público
/login                                 Login JWT REGIDORA                              público
/mesa                                  Mantas LIBRE / PEDIDO / ENTREGADO               auth
/**                                    → redirect /

Árbol por audiencia

[COMPROBADO] Cinco rutas del encargo L1. No se inventan /encargo, /carrito, /subasta, /gps, /buscar.

Llevarse no es ruta extra: es el sheet UI-03 sobre / (tap manta LIBRE). L1 compacto. [DECISIÓN]
/ok/:code usa el código de trasto (MNT-2801 en trato, MNT-2805 en dejar nuevo). [DECISIÓN]
No hay /buscar: no hay S-CMD. El hallazgo es el plano. [DECISIÓN]
No hay /trasto/:code de ficha pública permanente: el oficio de estado vive en el plano y en la mesa. Could L2. [DECISIÓN]

3. Navegación

Bottom (S-BOTTOM · todas las superficies salvo login/ok pueden mostrarlo)

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

Desktop ≥960px: barra inferior fija hueso; wordmark MANTA a la izquierda o centrado; slots Plaza · Dejar · Mesa.
Mobile ~390px: bottom compacto Plaza · Dejar · Mesa; no hamburger. [DECISIÓN] En 390 el bottom no se esconde detrás de un menú. Padding-bottom del contenido ≥ altura bar.

Plaza pública (H-MAP Deriva)

[DECISIÓN] La plaza no tiene tabs de marketing, no tiene «Vender / Subastar / Reservar». El plano basta para hallar.

Chrome de dejar (/dejar)

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

Chrome de llevarse (sheet sobre /)

Chrome de mesa (/mesa autenticado)

[DECISIÓN] No hay S-SPLIT (RAMAL / DERIVA). No hay kanban (PREGÓN). No hay /mesa/:code: L1 lee mantas + tratos.

4. Etiquetas de IA (UI)

En docs puede decirse «plaza plano» para H-MAP y «mesa REGIDORA» para el oficio JWT. En UI pública el titular es Plaza. En UI autenticada el titular es Mesa. [DECISIÓN]

5. Contenido de cada nodo de IA

6. Error / empty / loading (sitio)

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

7. Profundidad y hallazgo

No hay búsqueda Must: el hallazgo es el plano de 4 mantas. Introducir /buscar copiaría LOMO y rompería la terna. [DECISIÓN]
Nines no filtra la mesa con chips en v1: ve los tres grupos. Could L2: filtro; no se cuela como deuda del L1.

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

1. Convenciones

2. F1 — Vecina se lleva un trasto desde el plano (Must · F-MKT)

/  →  GET /api/trastos
   →  ve 3 métricas (libres / pedidos / entregados) + 4 mantas
   →  tap MNT-2801 Lámpara LIBRE
   →  sheet llevarse (UI-03)
   →  escribe nombre «Pilar Ramos», teléfono
   →  POST /api/tratos  { code: "MNT-2801", name, phone }
   →  201 { code: MNT-2801, status: PEDIDO, trato: true }
   →  /ok/MNT-2801

Entrada: plaza plano, sin cuenta.
Salida: código visible + copy «llevarse ≠ reservar IKEA».
Errores: red (reintentar), 400 validación, 409 si ya no LIBRE, 0 trastos (empty de plaza).

AC

• El form no pide email, DNI, pago ni signup.
• POST no cobra, no crea user, no abre anuncio, no mueve kanban, no enciende GPS.
• Una pieza. Cero carrito. Cero segunda línea.
• /ok/MNT-2801 muestra las cuatro oposiciones.
• El sheet existe: F-MKT no es un POST oculto sin UI. [DECISIÓN]
• Status destino = PEDIDO, no ENTREGADO. [DECISIÓN D20]

3. F2 — Vecina intenta llevarse un trasto no LIBRE (Must · 409)

/  →  tap MNT-2802 Silla PEDIDO
   →  CTA Llevarse disabled  o  POST /api/tratos
   →  409
   →  copy «Ese trasto ya no está libre.»

Mismo resultado si MNT-2804 ENTREGADO, o si Pilar reintenta MNT-2801 tras un 201.

AC

• 409 si status ≠ LIBRE.
• Copy: no «agotado» retail. No «añadir a lista de espera». No «reservar».
• Pilar puede elegir MNT-2803 Cuna (LIBRE) y continuar.

4. F3 — Vecina deja un trasto (Must)

/dejar  →  escribe nombre «Pilar Ramos», teléfono, qué es «Espejo óvalo», color «dorado»
        →  POST /api/trastos  { name, phone, title, color }
        →  201 { code: MNT-2805, status: LIBRE, dejado: true }
        →  /ok/MNT-2805

AC

• El form no pide precio, foto obligatoria, categoría Wallapop ni cuenta.
• POST crea trasto LIBRE + datos de quien deja (no visibles en plano público).
• /ok/MNT-2805 dice «Dejar el trasto ≠ vender en Wallapop».
• CTA Dejar disabled si falta título / nombre / teléfono / color.

5. F4 — Regidora entra a mesa (Must)

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

AC

• Sin token, /mesa redirige a /login?next=/mesa.
• GET /api/mesa sin Bearer → 401.
• Mantas: 4 filas agrupadas LIBRE / PEDIDO / ENTREGADO + tratos (nombre, teléfono, código). No columnas Recibido / En curso.
• Desktop: grupos + tratos en el panel. 390: apilado sobre el S-BOTTOM.
• ENTREGADO sí aparece (oficio de cierre de mañana). [DECISIÓN] distinto de PIÑÓN, donde ENTREGADA se ocultaba.

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. / — tile de plaza a sangre + 3 datos (2 libres / 1 pedido / 1 entregado) + 4 mantas. Eslogan. S-BOTTOM.
2. Lectura rápida: MNT-2801 Lámpara crema LIBRE; MNT-2802 Silla enea PEDIDO; MNT-2803 Cuna crudo LIBRE; MNT-2804 Maleta verde ENTREGADO.
3. Llevarse — tap lámpara · Pilar Ramos · teléfono · POST → /ok/MNT-2801. Copy ×4.
4. Reintento lámpara → 409.
5. Dejar — /dejar · Espejo óvalo · dorado · /ok/MNT-2805.
6. /login — nines@manta.plaza / password123.
7. /mesa — mantas LIBRE / PEDIDO / ENTREGADO; MNT-2801 PEDIDO si se hizo el trato; trato de Pilar visible.
8. 390: plano + S-BOTTOM; no carousel; targets ≥44px.
9. API down: error + Reintentar.

10. Contratos de error de API (flujo)

11. S-BOTTOM en flujo

[DECISIÓN] El slot Dejar no abre el sheet de llevarse; abre el form de dejar. Llevarse arranca en el plano.

05-data-model.md

05 — Modelo de datos — MANTA

1. Visión general

Dominio L1 de mantas de merendero + dejar + llevarse autenticable:

Base: PostgreSQL (Neon project fancy-sun-85815074 · DATABASE_URL) · IDs: serial + texto estable (MNT-2801).
[DECISIÓN] ensureSchema es válido si el contrato de tablas se cumple; el brief de stack no exige Prisma.

Contrato de producto: trastos + tratos + JWT REGIDORA.
No bicis / requests / sesiones / ejemplares / ganchos.

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

Role

TrastoStatus

Un POST de dejar crea el trasto en LIBRE. [DECISIÓN]
Un POST de trato sobre LIBRE pasa el trasto a PEDIDO. [DECISIÓN D20]
Si status ≠ LIBRE → 409. [DECISIÓN]
Nines no hace PATCH de estado en v1: la mesa es lectura de mantas. [DECISIÓN]

3. Diagrama ER (texto)

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

sessions
  id, user_id → users
  expires_at, revoked_at
  created_at

trastos
  id
  code (unique, MNT-XXXX)
  title, color
  status (LIBRE|PEDIDO|ENTREGADO)
  cover
  donor_name, donor_phone
  sort_order
  created_at, updated_at
  1 ──< tratos

tratos
  id
  trasto_id → trastos
  code (denorm MNT-XXXX)
  name
  phone
  created_at

v1: una sola REGIDORA opera sobre el conjunto global.
No hay FK de vecina-usuario: la vecina no se loguea.
trastos.donor_name es quien deja (oral), no una cuenta.
tratos.name es quien se lleva.
Teléfonos no se pintan en el plano público.

4. Tablas

users

sessions

trastos

tratos

Sin email, sin DNI, sin pago, sin GPS, sin precio. Dejar el trasto ≠ vender en Wallapop. [DECISIÓN]

Índices: trastos(code), trastos(status), trastos(sort_order), users(email), tratos(trasto_id), tratos(created_at DESC).
Unicidad operativa: como máximo un trato activo por trasto PEDIDO/ENTREGADO en v1. [DECISIÓN]

5. Seed

REGIDORA

nines@manta.plaza / password123 · Nines Ortega · REGIDORA
Hash bcrypt fijo: $2b$12$OEKcNck63neDJ.CrVP0lNOaXp2NG2zd2aMiGmnYY221h4ZAZ58x1m

Trastos

Métricas derivadas del seed: libres 2 · pedidos 1 · entregados 1.

[SUPUESTO de plaza] Títulos, colores y nombres de donantes son atrezzo. No es un merendero real.
[DECISIÓN] sort_order 1…4 = MNT-2801…2804.
Nombres de donantes seed = constructo de diseño para que la mesa no esté vacía; no son entrevistas. [DECISIÓN]

Tratos seed

LIBRE (2801, 2803) no tienen trato. El POST de smoke de Pilar crea el de MNT-2801.
El seed idempotente restaura los 4 trastos de catálogo (estados) para que el demo sea repetible. [DECISIÓN]
Re-seed no borra MNT-2805+ salvo flag explícito de demo. [DECISIÓN]
Nombres Lola / Toni / Carmen / Diego / Inma / Rafael = constructo de seed, no campo. [DECISIÓN]

6. JSON (camelCase)

API: sortOrder, createdAt, libres, pedidos, entregados, cover, status, title, color, code, name, phone, donorName.
SQL: sort_order, created_at, donor_name, donor_phone.

GET /api/trastos

{
  "metrics": { "libres": 2, "pedidos": 1, "entregados": 1 },
  "trastos": [
    {
      "code": "MNT-2801",
      "title": "Lámpara de pie",
      "color": "crema",
      "status": "LIBRE",
      "cover": "/assets/trastos/lampara.jpg",
      "sortOrder": 1
    }
  ]
}

Lista pública: no incluye name, phone, donorName ni donorPhone. [DECISIÓN]
Métricas cuentan los tres estados. [DECISIÓN]

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

Mismo shape de item público; 404 si no existe.

POST /api/trastos (dejar)

Request:

{ "name": "Pilar Ramos", "phone": "600123123", "title": "Espejo óvalo", "color": "dorado" }

name obligatorio, trim, min 2. phone obligatorio, dígitos ≥ 9. title obligatorio, trim, min 2. color obligatorio, trim, min 3. [DECISIÓN]

Response 201:

{
  "code": "MNT-2805",
  "title": "Espejo óvalo",
  "color": "dorado",
  "status": "LIBRE",
  "dejado": true
}

Algoritmo: INSERT trasto (status LIBRE, code siguiente, donor_name/phone). Transacción única. [DECISIÓN]

POST /api/tratos (llevarse)

Request:

{ "code": "MNT-2801", "name": "Pilar Ramos", "phone": "600123123" }

Response 201:

{
  "code": "MNT-2801",
  "title": "Lámpara de pie",
  "color": "crema",
  "status": "PEDIDO",
  "trato": true
}

Algoritmo: SELECT FOR UPDATE por code; si no existe → 404; si status ≠ LIBRE → 409; validar name/phone; UPDATE status PEDIDO; INSERT trato. Transacción única. [DECISIÓN]

GET /api/mesa (JWT)

{
  "metrics": { "libres": 2, "pedidos": 1, "entregados": 1 },
  "mantas": {
    "LIBRE": [ /* trastos + donorName, donorPhone */ ],
    "PEDIDO": [ /* … */ ],
    "ENTREGADO": [ /* … */ ]
  },
  "tratos": [
    {
      "id": 1,
      "code": "MNT-2802",
      "name": "Lola Méndez",
      "phone": "612440282",
      "status": "PEDIDO",
      "createdAt": "2026-08-28T09:12:00.000Z"
    }
  ]
}

7. Reglas de integridad

8. Fuera del modelo v1

9. Naming vs leftover

06-tech-stack.md

06 — Stack técnico — MANTA

1. Resumen

[COMPROBADO] Angular + NestJS + Neon + Tailwind, puerto API 3028, Paper file ID, Neon y path de app salen del encargo.

2. Por qué este stack

3. Puertos y health

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

4. Estructura de repo (contrato)

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

Proxy web → API en dev (/api → http://localhost:3028). [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: nines@manta.plaza / password123.

7. Endpoints (contrato)

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

8. Frontend — rutas y componentes

Chrome: BottomNavComponent (S-BOTTOM). Tokens Tailwind: ground, ink, card, mark, mute, geranio.

9. Assets

Covers en DB como paths /assets/trastos/lampara.jpg etc. [DECISIÓN]

10. Calidad y toolchains

11. Anti-stack (no introducir)

12. Criterios de aceptación técnicos

1. GET /api/health → service: "manta-api".
2. Seed idempotente: 1 REGIDORA + 4 trastos + 2 tratos seed.
3. POST dejar crea trasto LIBRE y devuelve MNT-XXXX.
4. POST trato sobre LIBRE → 201 PEDIDO; sobre no-LIBRE → 409.
5. GET mesa sin token → 401.
6. Web en 4200 consume API 3028 sin mixed-content local.
7. 0 referencias de producto a bicis, MECANICO, pinon-api, ganchos en runtime.

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

07-creative-direction.md

07 — Dirección creativa — MANTA

1. Concepto

MANTA es un domingo de plaza con geranio y plátano de sombra: se entra a un tile de plaza a sangre con tres números y cuatro mantas, y se sale habiendo dejado o llevado un trasto, no una landing de «tu marketplace». El ground es hueso de muro. El musgo puntúa. El geranio, poco.

Mood elegido: botanical.
Primer instinto descartado: rastro vintage sepia. Un domingo en Usera se lee con geranio, plátano de sombra y hueso de muro, no con sepia de mercadillo «vintage».

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

2. Territorio visual

3. Paleta

Jerarquía de color: el hueso carga; el mark puntúa; el geranio filetea el conflicto (pedido / error). Si el geranio pinta fondos enteros, deja de ser flor y se vuelve «brand rastro». El texto sobre hueso es ink; nunca mute como párrafo largo. Ink sobre hueso debe pasar contraste WCAG 2.2 AA. [DECISIÓN]

Candidatos de mood descartados: rastro vintage sepia (primer instinto), arid/dust, rusted, pastoral.

4. Tipografía

Prohibido: Libre Baskerville por debajo de 18px (se rompe). Nunito Sans en el wordmark de plaza (se vuelve SaaS). Geranio como color de texto de párrafo largo (contraste).

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

5. Fotografía

Alt: título + color, no «imagen1». Ver doc 09.

[COMPROBADO] Los cuatro covers y el hero existen en assets/.

6. Registro R-CL

Clásico: merendero de plaza, wordmark Baskerville, mantas, bottom tabs de oficio. No es un dashboard de seguros. No es un kiosk de horas. No es una mesa de datos de archivo. No es sepia de rastro «cool».

La innovación de terna está en H-MAP Deriva + S-BOTTOM + F-MKT de una pieza, no en un look «vintage market». [DECISIÓN]

7. Anti-moods

8. Densidad (AP-21)

En el recorte Deriva: eslogan + tile de plaza dominante + 3 datos (libres / pedidos / entregados) + 4 mantas con título, color y estado visibles sin hover. Headline huérfano + foto = card hueca. [COMPROBADO] CRON §5.8 / D-P1-09 foto-led.

Tile de plaza ≥40 % del recorte 16/10. Los 3 datos y las 4 mantas no tapan el oficio de la foto: legibles, no sticker. [DECISIÓN]

9. Motion

10. Voice visual ↔ copy

El mood botanical refuerza el microcopy: manta de plaza, no anuncio. Si la UI parece Wallapop (precio, corazón, «subir anuncio») o IKEA (carrito, amarillo) o El Rastro de postal (sepia, filigrana), el copy irrenunciable pierde fuerza. [DECISIÓN]

08-design-system.md

08 — Sistema de diseño — MANTA

1. Tokens

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

2. Contraste (obligatorio)

[DECISIÓN] Geranio nunca como color de párrafo. Mute nunca como único color de disclaimer largo.
CTA mark: texto #F4F1E8 o #FFFFFF sobre #3F6B4A — verificar AA en implementación. [HIPÓTESIS operativa]

3. Escala de tipo

4. Componentes

Ficha de manta (plano)

Cover recorte + título Baskerville · color · status. Tap LIBRE abre sheet llevarse. Orden por sort_order.

Tile Deriva (UI-01)

Imagen de plaza a sangre ≥40 % del frame 16/10; gradient hueso→transparente para legibilidad del plano; wordmark + eslogan + 3 datos (libres / pedidos / entregados). Overlay de 4 mantas como plano, no GIS.

Dato (métrica de manta)

Número ink grande + label mute («libres», «pedidos», «entregados»). Tres en fila desktop; wrap en 390. No es un sparkline ni una tabla H-DATA.

Form dejar (UI-02)

Nombre, teléfono, qué es, color, disclaimer, submit mark.

Sheet llevarse (UI-03)

Código + título en solo lectura, nombre, teléfono, disclaimer, submit mark. Si no LIBRE: geranio + «Ese trasto ya no está libre.»

Success (UI-04)

Código Baskerville enorme + bloque card con título y color + 4 oposiciones en ink/mute.

Fila de mesa REGIDORA (UI-06)

Grupos LIBRE / PEDIDO / ENTREGADO. Fila: código · título · color · status · donor. Tratos debajo: name · phone · code · hora. Sin acciones PATCH en v1.

Login (UI-05)

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

Bottom nav (S-BOTTOM)

Tres slots: Plaza · Dejar · Mesa. Activo: mark. Idle: mute. Fondo card/ground. Targets ≥44px. Safe-area inset.

Skeleton (UI-09)

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

Error (UI-08)

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

Empty (UI-07)

Titular Baskerville + mute. Sin CTA de Wallapop ni de IKEA.

Sello LIBRE / PEDIDO / ENTREGADO

Texto «Libre» / «Pedido» / «Entregado» + mark o geranio o mute. Nunca solo el color. Poco: un sello por ficha.

5. Layouts

Max page 1440px. Padding 20 / 40 / 48. Padding-bottom ≥ 72px donde hay S-BOTTOM.

6. Estados de control

7. Iconografía

S-BOTTOM: pictogramas simples (plaza / manta / mesa). Stroke 1.5–2px. No icon packs «carrito», «corazón Wallapop», «bici», «gancho». [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 — MANTA

1. Voz

MANTA habla como merendero de plaza, no como anuncio ni como lineal.

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

2. Microcopy irrenunciable

Presente en plaza (pie o banner), dejar, llevarse, success y pie de mesa:

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

3. Glosario UI

4. Pantalla a pantalla

Plaza /

Dejar /dejar (UI-02)

Llevarse sheet (UI-03)

Success /ok/:code

Login /login

Mesa /mesa

5. Alt text de imágenes

Evitar «imagen1», «item.jpg», copy de anuncio con precio. [DECISIÓN]

6. Trastos seed (atrezzo)

Lámpara / silla / cuna / maleta son catálogo demo. En UI no se afirma «merendero municipal de Usera». Los blurbs pueden recordar dejar ≠ vender. [SUPUESTO de plaza]

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 plaza o dejar/llevarse.
2. Ningún CTA dice Vender / Reservar / Pujar / Añadir al carrito.
3. LIBRE se etiqueta «Libre», no «Disponible» retail.
4. Códigos se muestran como MNT-XXXX en versales.
5. Docs y UI no inventan KPIs numéricos de Usera como hecho.

10-accessibility.md

10 — Accesibilidad — MANTA

1. Objetivo

Cumplir WCAG 2.2 AA en el vertical slice L1. Ground claro (hueso): el par ink sobre hueso es el contrato de legibilidad. Amparo (71) es persona de diseño que fuerza contraste, tamaño y targets; no tiene login. [COMPROBADO] requisito del encargo · [DECISIÓN] persona Amparo en docs.

2. Contraste

[DECISIÓN] Si mute falla AA en párrafo, se asciende a ink. Geranio 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/hueso pasa; se valida en QA (doc 13).

3. Tipografía y lectura

4. Targets y pointer

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

5. Teclado y foco

Sin keyboard traps. Sheet: foco inicial en nombre; retorno al pin al cerrar. [DECISIÓN]

6. Semántica y nombres

7. Imágenes y tile

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

8. Motion

9. Estados y color

LIBRE / PEDIDO / ENTREGADO / error nunca se comunican solo con color: texto + sello. Mark y geranio refuerzan, no sustituyen. [DECISIÓN]

10. Auth y a11y

• Login solo REGIDORA; Amparo no necesita cuenta para leer la plaza ni dejar/llevarse.
• Mensajes de error de login claros, sin enumerar si el email existe (seguridad + claridad).
• /mesa redirige a login con foco en email.

11. Mobile 390

• S-BOTTOM fijo no tapa el CTA final: padding-bottom del contenido ≥ altura bar + safe-area.
• Sheet llevarse por encima del bottom; submit visible.
• Formularios: autocomplete name on; tel tel; password current-password.
• Viewport meta; sin zoom bloqueado. [DECISIÓN]
• UI-11 plaza y UI-12 dejar cubren el recorte 390. No carousel.

12. Criterios de aceptación a11y

1. Ink sobre hueso usado en cuerpo; mute limitado a meta.
2. Targets S-BOTTOM 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 llevarse es dialog alcanzable con teclado.

13. Fuera de v1 (L2/L3, no deuda)

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

11-privacy-security.md

11 — Privacidad y seguridad — MANTA

1. Principios

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

2. Datos tratados

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

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

3. Superficies públicas vs privadas

[DECISIÓN] Enumerar teléfonos en el plano rompería privacidad de plaza; solo Nines ve recados.

4. AuthN / AuthZ

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

5. Amenazas y mitigaciones L1

6. Contenido de teléfono y nombre

phone es recado, no tracking. Se muestra a Nines en mesa. Formato: dígitos, min 9. [DECISIÓN]
No se pide dirección, salud ni datos de terceros sensibles en el form.
name es texto libre corto (min 2, max 80).

7. Cookies y tracking

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

8. Logs

9. Criterios de aceptación

1. GET mesa sin Bearer → 401.
2. GET trastos no incluye name, phone, donorName ni donorPhone.
3. POST trastos/tratos no exige auth ni pago ni GPS.
4. Password solo como hash bcrypt.
5. .env no versionado con secretos reales.
6. Copy de success no implica contrato de venta ni de reserva.
7. Segundo POST trato sobre el mismo code → 409.

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

DPO, ROPA formal, exportaciones ARCO automatizadas, SSO, 2FA, WAF, geolocalización. Roadmap L2/L3 si la plaza deja de ser demo (pagos, GPS).

12-analytics.md

12 — Analytics y métricas — MANTA

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 WhatsApp de «¿sigue ahí la lámpara?» es el recado que el plano y la mesa 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 L2/L3)

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

5. Cálculo north star (modelo)

visitas_plaza = sesiones en /
resuelto_sin_whatsapp =
  (no medible en v1: no hay canal WhatsApp en producto)
proxy de diseño = visitas a / o /mesa que cubren el estado
                   frente a recados paralelos (cualitativo)

[DECISIÓN] v1 no persiste un flag whatsapp_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):

• «¿Lo vendo en Wallapop?»
• «¿Puedo pujar?»
• «¿Lo reservo como en IKEA?»
• «¿Dónde está el carrito?»
• «¿Dónde está el GPS?»
• «¿Esto es el taller de bicis?»

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

7. Qué no medir en v1

8. Criterios de aceptación

1. Docs y UI no muestran un % inventado como hecho.
2. North star documentada y alineada a H1.
3. Si hay eventos en un L2/L3, sin PII de tratos.
4. Health, 401 mesa y 409 trato son checks de integridad, no vanidad.

9. Relación con seed

Seed tiene 2 LIBRE + 1 PEDIDO + 1 ENTREGADO. Un guión con POST trato sobre MNT-2801 y POST dejar MNT-2805 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 — MANTA

1. Alcance

Smoke y regresión del vertical slice L1: plano, dejar, llevarse, 409, success, login, mesa, empty/error/loading, mobile 390, contraste ink/hueso.
No incluye campo real de Usera ni load test de marketplace.

2. Entornos

3. Smoke crítico (Must pasar)

4. Regresión funcional

5. Accesibilidad (muestra)

6. Contenido

7. Visual / Paper

8. API negativa

9. Datos de prueba

Tras smoke: re-seed para restaurar las 4 de catálogo. [DECISIÓN]

10. Criterio de salida

Smoke S01–S12 en verde. Sin P0 (health mal, dejar/trato rotos, 409 ausente, mesa abierta sin auth, copy Wallapop ausente en success).
P1 visual puede quedar anotado; no reabre el alcance L1.

11. Fuera de alcance QA v1

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

14-dev-handoff.md

14 — Handoff a desarrollo — MANTA

1. Contrato vivo

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

2. Definition of Done (DoD) L1

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

3. Mapa Paper → Angular

4. API checklist

Body dejar: { name: string, phone: string, title: string, color: string }.
Body trato: { code: string, name: string, phone: string }.
Ver algoritmos en doc 05 / 20. [DECISIÓN]

5. Seed y credenciales

6. Anti-patrones de implementación

7. Assets

Copiar desde case:

• assets/trastos/lampara.jpg
• assets/trastos/silla.jpg
• assets/trastos/cuna.jpg
• assets/trastos/maleta.jpg
• assets/hero.jpg (tile Deriva / cover)

[COMPROBADO] existen en el case.

8. QA mínimo antes de merge

Ejecutar smoke S01–S12 (doc 13). Verificar copy irrenunciable en /ok/:code. Verificar 409 sobre MNT-2802.

9. Open questions (no reabren L1)

10. Contacto de diseño

Paper file + docs 07–09. No reinventar sepia de rastro ni grafito de taller. Mood botanical. Ground #F4F1E8. Mark #3F6B4A. Geranio #C45C4A poco.

15-roadmap.md

15 — Roadmap — MANTA

1. Horizonte

[DECISIÓN] El L1 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.

2. Hecho en L1 (Must · cerrado)

Nada de la tabla se reabre como backlog de «el código ya vendrá». El case L1 cierra en una iteración. [DECISIÓN]

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

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

4. Anti-roadmap (no disfrazar)

5. Dependencias del slice cerrado

6. Criterios para abrir un L2/L3

1. Smoke L1 en verde (doc 13).
2. Copy irrenunciable intacto.
3. El brief L2/L3 nombra pagos o GPS sin reabrir plano, F-MKT de una pieza ni mesa.
4. North star sigue siendo modelo o se instrumenta sin PII.

7. Cierre

L1 está completo en una iteración. El roadmap es un muro contra el anuncio y el GPS, no una lista de lo que «faltó». [DECISIÓN]

16-interaction-specs.md

16 — Especificación de interacción — MANTA

1. Convenciones

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

2. Plaza plano (UI-01) + mobile (UI-11) · H-MAP Deriva

AC: título, color y estado visibles sin hover. Tile plaza ≥40 % del recorte 16/10 (AP-21 / D-P1-09). Tres datos con texto («2 libres»), no solo cifra. Cero botones Vender / Reservar / Pujar.

El aviso «MANTA no es Wallapop» es texto, no un CTA de tienda. [DECISIÓN]

390: mismas 4 mantas apiladas. No carousel. S-BOTTOM visible. [DECISIÓN]

3. Dejar (UI-02) + mobile dejar (UI-12)

AC: no email, no DNI, no precio, no pago. Dejar el trasto ≠ vender en Wallapop visible.

4. Llevarse (UI-03) · F-MKT

AC: una sola pieza. Cero carrito. Cero segunda línea. Cero hold IKEA.

5. Success (UI-04)

AC: las cuatro oposiciones están. No QR. No «anuncio activo». No mapa GPS.

6. Login (UI-05)

AC: sin signup. Ayuda demo mute.

7. Mesa REGIDORA (UI-06)

AC: no columnas Recibido / En curso. No PATCH estado. No split lista|ficha. No mapa. ENTREGADO sí se lista.

8. S-BOTTOM · chrome

AC: tres slots. No hamburger. No top de taller. Targets ≥44px. Fijo en 390. Safe-area.

9. Empty / Error / Loading (UI-07 / UI-08 / UI-09)

10. Motion

Sin Ken Burns agresivo sobre Deriva. [DECISIÓN]

11. Guión de interacción demo

1. / loading → tile + 3 datos + 4 mantas.
2. Leer MNT-2801 LIBRE / MNT-2802 PEDIDO.
3. Tap lámpara → sheet Pilar → pending → success Trato.
4. Tap silla → 409.
5. Dejar → form → success Dejado.
6. S-BOTTOM Mesa → login → mesa con MNT-2801 PEDIDO.
7. 390: S-BOTTOM no tapa CTA; sheet por encima; scroll con padding.

12. Criterios de aceptación de interacción

1. F-MKT no abre carrito ni segunda pieza.
2. POST trato no-LIBRE no navega a ok (409).
3. Pending no doble-envía.
4. S-BOTTOM siempre alcanzable en 390.
5. Focus visible en todo el recorrido teclado.
6. Sheet es dialog; Esc cierra.

17-prototype-map.md

17 — Mapa de prototipo — MANTA

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).

2. UX process → docs

3. UI producto → rutas / componentes

4. Flujo prototipo clickable (orden demo)

UI-01 Plaza Deriva
  ├─→ UI-03 Llevarse (Lámpara LIBRE)
  │     └─→ UI-04 Success (Trato)
  ├─→ UI-02 Dejar
  │     └─→ UI-04 Success (Dejado)
  ├─→ UI-11 (mismo /, viewport 390)
  ├─→ UI-12 (mismo /dejar, viewport 390)
  └─→ S-BOTTOM Mesa → UI-05 Login → UI-06 Mesa

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

5. Datos de prototipo = seed

Hotspots Paper deben usar estos códigos en labels si muestran URL. [DECISIÓN]
POST trato demo → MNT-2801 (Pilar Ramos).
POST dejar demo → MNT-2805 (Pilar Ramos, Espejo óvalo, dorado).

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 /encargo, /carrito, /subasta, GPS o anuncio.
4. Mobile 390 cubierto (UI-11, UI-12).
5. UX-00…11 cubiertos.

18-completeness-audit.md

18 — Auditoría de cierre — MANTA

1. Alcance L1 · una iteración

El vertical slice cierra en esta iteración. No hay segunda pasada de producto in-scope. 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 plaza, dejar, llevarse, success, pie de mesa. Ver doc 09.

• Dejar el trasto ≠ vender en Wallapop
• Trueque ≠ subasta
• Llevarse ≠ reservar IKEA
• MANTA no es Wallapop

4. Anti-patrones vigilados

5. Seed

4 trastos · 2 LIBRE · 1 PEDIDO · 1 ENTREGADO · Nines REGIDORA · Pilar sin cuenta · Amparo fuera de login.

Métricas: libres 2 · pedidos 1 · entregados 1.

6. Assets

7. Huecos conscientes (fuera · L2/L3)

Pagos, GPS. Nada más se etiqueta como «faltó del L1».

Login Amparo, email transaccional, instrumentación analytics, PATCH de estado, ficha /mesa/:code, ruta /llevarse 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]

8. Checklist archivos suite

9. Veredicto

Slice L1 cerrado en una iteración. El contrato de manta-app (docs 14 y 20) no se lista como próximo paso de producto: es el mismo alcance, ya definido. Paper file 01M13JZXPYG2GXDC3HWW5K8X6K. Si el repo diverge (leftover PIÑÓN), gana docs 05 + 20 tras alinear ambos.

Cierre: Must cubierto. Roadmap = L2/L3 pagos y GPS únicamente.

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

Gate: node scripts/check-paper-reference.mjs 2026-08-28-manta → OK UX=12 UI=12.

Smoke [COMPROBADO]: health manta-api; GET /api/trastos 4; POST /api/tratos 201 MNT-2801 luego 409; login nines@manta.plaza; ng build 1.58MB; Playwright 1440×900 avgRGB~(189,182,172) dark% 0. API/web apagados (D-P1-06).

19-backlog-completo.md

19 — Backlog completo — MANTA

1. Leyenda

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

2. Épica A — Plaza H-MAP Deriva

3. Épica B — Dejar

4. Épica C — Llevarse F-MKT

5. Épica D — Mesa REGIDORA

6. Épica E — Chrome S-BOTTOM

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 trastos + PlazaPage Deriva
3. DejarPage + POST trastos
4. LlevarseSheet + POST tratos + 409
5. OkPage copy
6. Auth + MesaPage
7. S-BOTTOM + 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 L1 ya cerrado. [DECISIÓN]

11. Contadores

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

20-implementation.md

20 — Implementación — MANTA

1. Resumen ejecutivo técnico

Este documento es la especificación de build del L1 ya cerrado. No es un roadmap: si el repo diverge, gana el contrato de docs 05 + este archivo tras actualizar ambos.

Contrato: trastos + tratos + JWT REGIDORA. Puerto 3028. Health manta-api.

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

El repo no debe contener leftover PIÑÓN (bicis, MECANICO, pinon-api, ganchos, puerto 3027) ni leftover BOBINA (sesiones, PROGRAMADOR). Eso no es MANTA.

2. Cómo arrancar

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

# apps/api/.env
#   DATABASE_URL=<neon fancy-sun-85815074>
#   JWT_SECRET=<secret>
#   PORT=3028

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

Credenciales

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

Vecina / vecina mayor: sin cuenta. Pilar deja en /dejar o se lleva desde /. Amparo no entra por login.

3. Schema

Al boot o vía migrate:

1. CREATE TABLE de users, sessions, trastos, tratos (doc 05).
2. Índices: trastos(code), trastos(status), trastos(sort_order), users(email), tratos(trasto_id), tratos(created_at DESC).
3. Seed idempotente:
   • upsert REGIDORA nines@manta.plaza (hash bcrypt canónico)
   • upsert trastos por code (MNT-2801…MNT-2804) restaurando status, color, cover, donor
   • upsert 2 tratos seed (Lola Méndez / Toni Vega)
4. Dominio: solo trastos + tratos + users. [DECISIÓN]

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

POST de dejar sí genera código nuevo (MNT-2805+). POST de trato reutiliza el code del trasto.

Tablas (recordatorio)

DROP leftover bicis, requests, sesiones, ejemplares si existen en el mismo Neon. [DECISIÓN] El project es de MANTA.

Seed SQL (modelo)

[SUPUESTO de plaza] Objetos demo.

4. Módulos API a implementar

Auth

• POST /api/auth/login
• Valida email/password; compara bcrypt; emite JWT con sub, email, role.
• Guard JWT + role === REGIDORA protege /mesa.
• Públicos: health, trastos, trastos/:code, POST trastos, POST tratos, login.

Oficio

Health (referencia de implementación)

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

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

POST trastos (dejar) — algoritmo

1. Validar body.title (trim, length >= 2) else 400
2. Validar body.name (trim, length >= 2) else 400
3. Validar body.phone (dígitos >= 9) else 400
4. Validar body.color (trim, length >= 3) else 400
5. code = siguiente MNT-XXXX (max existente + 1, piso MNT-2805)
6. INSERT trastos (code, title, color, status=LIBRE, donor_name, donor_phone)
7. 201 { code, title, color, status: LIBRE, dejado: true }

Transacción única. [DECISIÓN]

POST tratos (llevarse) — algoritmo

1. Validar body.code presente else 400
2. Validar body.name (trim, length >= 2) else 400
3. Validar body.phone (dígitos >= 9) else 400
4. SELECT FOR UPDATE trastos WHERE code = body.code
5. Si no hay fila → 404
6. Si status ≠ LIBRE → 409 { error: "NOT_LIBRE", code }
7. UPDATE trastos SET status = PEDIDO
8. INSERT tratos (trasto_id, code, name, phone)
9. 201 { code, title, color, status: PEDIDO, trato: true }

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

GET trastos — shape

{
  "metrics": { "libres": 2, "pedidos": 1, "entregados": 1 },
  "trastos": [ { "code", "title", "color", "status", "cover", "sortOrder" } ]
}

Métricas: count status LIBRE / PEDIDO / ENTREGADO. [DECISIÓN]

GET mesa — shape

{
  "metrics": { "libres": n, "pedidos": n, "entregados": n },
  "mantas": {
    "LIBRE": [ /* trastos + donorName, donorPhone */ ],
    "PEDIDO": [ /* … */ ],
    "ENTREGADO": [ /* … */ ]
  },
  "tratos": [ { "id", "code", "name", "phone", "status", "createdAt" } ]
}

Orden tratos: created_at DESC. [DECISIÓN]

5. Frontend Angular

Rutas

Servicios

UI Must

1. PlazaPage — tile + 3 datos + 4 mantas (Deriva), no bento ni tabla.
2. LlevarseSheet — F-MKT una pieza.
3. DejarPage — form público.
4. OkPage — código + 4 oposiciones.
5. LoginPage / MesaPage.
6. BottomNavComponent — S-BOTTOM.
7. Estados empty/error/loading/409.

Tailwind tokens

ground: #F4F1E8
ink: #1A2B1C
card: #FFFFFF
mark: #3F6B4A
mute: #6E7A70
geranio: #C45C4A
font-display: "Libre Baskerville"
font-sans: "Nunito Sans"

6. Assets en app

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

• lampara.jpg
• silla.jpg
• cuna.jpg
• maleta.jpg

hero.jpg → tile Deriva (/assets/hero.jpg).

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

7. Checklist anti-leftover

8. DoD técnico (merge)

1. Smoke S01–S12 (doc 13) en verde.
2. Health manta-api.
3. Seed idempotente.
4. Mesa 401 sin token.
5. POST trato no-LIBRE → 409.
6. Success muestra las 4 oposiciones.
7. 390 + S-BOTTOM usable.
8. 0 referencias de producto a bicis/MECANICO/pinon-api/ganchos.
9. Ink sobre hueso en cuerpo.

9. Fuera de esta especificación

• Pagos (L2/L3).
• GPS (L2/L3).
• Instrumentación analytics (doc 12 modelo).
• PATCH de estado (mesa de lectura).

Ninguno de esos ítems es un «siguiente paso» del L1. [DECISIÓN]

10. Cierre

Implementación = contrato ejecutable del case 2026-08-28-manta, cerrado en una iteración. [COMPROBADO] alcance L1.