Day brief — 2026-08-07 — ALS-2
1. LOAD — restricciones del día
| Eje | Decisión | Motivo (diversidad) |
|---|
| Complejidad | Nivel 2 | Tras CORREA (L3 marketplace) no se repite L3 consecutivo. L2 = dominio acotado, multi-rol JWT, CRUD de entidad core + estados. |
| Sector | Agricultura / explotación familiar | No usado en la serie (COMAL cocina, ATRIO museo, MERIDIANA clínica, SENDA mayores, FIRME legal, TROCHA logística, CORREA mascotas). |
| Tipo de producto | Cuaderno digital de parcelas + tareas | Tool ops de campo, no marketplace, no SaaS legal, no flota GPS. |
| Auth | JWT multi-rol FARMER + TECHNICIAN | Directiva D-P1-05; panel no abierto. |
| Craft mínimo | ≥ CORREA densificado | Rúbrica no baja; L2 ≠ menos detalle visual ni docs thin. |
| Cierre | §1.1 completo en una iteración | Docs + Paper + app + Neon + smoke; sin “próximos pasos de producto del día”. |
| Puerto API | 3007 | Evitar colisión con CORREA (3006) y anteriores. |
Anti-patrones a evitar (top del catálogo)
| ID | Anti-patrón | Mitigación hoy |
|---|
| AP-thin-docs | Docs de 1–2 líneas | Suite 00–20 con tablas, AC y criterios de aceptación |
| AP-generic-ui | UI “SaaS genérico” / “básica porque L2” | Palette bone × leaf × straw; Literata + Manrope |
| AP-no-auth | Panel sin login | JWT obligatorio en /api/tasks* |
| AP-marketplace-copy | Lógica de marketplace en tool ops | No catálogo, no ratings, no checkout |
| AP-gps-fleet | Flota/ruta tipo TROCHA | Parcelas y tareas de campo, sin GPS ni paradas de reparto |
| AP-fake-research | Estadísticas inventadas como primarias | Solo hipótesis y supuestos etiquetados |
| AP-open-debt | Backlog de features del L2 del día | Vertical slice cerrado: listar, crear, detalle, status |
| AP-canvas-chaos | Paper sin bandas § | §1 UX · §2 Design+Public · §3 App · §4 Mobile · §5 States |
Barra de calidad actual (ratchet)
- Paper: bandas §1–§5, ≥8 artboards UX densos + DS + app + mobile + states.
- Angular alineado a tokens (no default Tailwind genérico).
- API Nest + Prisma + Neon con seed demo usable.
- Smoke: login + list + create (FARMER) + patch status;
ng build o serve OK.
- Docs en español, profundidad tipo portfolio (no stubs).
2. BRIEF — concepto del día
| Campo | Valor |
|---|
| Nombre | SURCO |
| Eslogan | ”El campo, al día.” |
| Una frase | Cuaderno digital de parcelas y tareas de campo para explotaciones familiares, con roles agricultor y técnico. |
| Tipo | Tool ops L2 — cuaderno multi-rol (no marketplace, no fleet) |
| Roles | FARMER (Inés Roura) · TECHNICIAN (Pol Vidal) |
| Dominio | Parcel + FieldTask (PENDING | ACTIVE | DONE | CANCELLED) + User |
| Estilo | Bone #F4F0E6 × Leaf #3D5C3A / #1B3A2A / #2A4A32 × Straw #C4A35A |
| Tipo | Literata (display) + Manrope (UI) |
| Stack | Angular + NestJS + Prisma + Neon + Tailwind + JWT |
| Paper | https://app.paper.design/file/01KZDGF3509TA4WDZTTQJW1V45 |
| Neon | old-paper-48739086 · API :3007 · Web :4200 |
| App | /Users/cristian/orca/surco-app/ |
Por qué L2 agro (y no otra cosa)
- Diversidad de sector: la serie no había tocado agricultura; cierra un hueco frente a legal, logística y marketplace.
- Complejidad L2 justa: dos roles con vistas filtradas, máquina de estados de tarea, creación con parcela implícita y asignación opcional de técnico — suficiente para vertical slice sin multi-tenant ni pagos.
- Diferenciación vs TROCHA: TROCHA es flota última milla + paradas GPS/ruta; SURCO es cuaderno de explotación (bancales, cultivos, riego/poda/muestreo).
- Diferenciación vs CORREA: CORREA es marketplace B2C con mascotas y reservas; SURCO es tool interno de finca, sin catálogo ni matching.
- Metáfora de marca: surco = línea de labranza; el producto “traza” el día de campo en digital sin romanticismo rural kitsch.
Must-have del día (alcance L2)
| # | Entrega | Criterio done |
|---|
| 1 | Home marketing | Hero real, 3 pasos, CTAs rol, footer demo |
| 2 | Login JWT | FARMER y TECHNICIAN; redirect a tareas |
| 3 | Lista tareas + stats | Filtro por rol; chips de estado; empty |
| 4 | Detalle + cambio de estado | PATCH status; permisos por rol |
| 5 | Nueva tarea (solo FARMER) | Parcela por nombre, dueAt, técnico opcional |
| 6 | Empty / error | Sin tareas; fallo de red en lista |
| 7 | Paper §1–§5 | UX process + DS + app + mobile + states |
| 8 | Docs 00–20 + README + executive | Portfolio ES, sin stubs |
Explicitamente fuera de alcance (no son deuda del día)
- GPS de parcelas / mapas SIG
- Cuaderno oficial de explotación (compliance legal agro UE)
- Inventario de fitosanitarios / trazabilidad normativa
- Multi-explotación / multi-tenant
- Notificaciones push / WhatsApp
- App nativa offline-first completa
- Pagos, marketplace de insumos, clima API
3. Directivas activas aplicadas
| ID | Aplicación en SURCO |
|---|
| D-P0-01 | L2 no reduce craft ni profundidad de docs |
| D-P0-02 | Hi-fi con media real (assets/hero.jpg), microcopy agro |
| D-P0-03 | Angular + Nest + Neon + Tailwind + repo app |
| D-P0-04 | Canvas Paper en bandas §1–§5 con labels |
| D-P0-05 | Hero fotorrealista en case y app |
| D-P0-06 | Cierre §1.1 sin backlog del alcance L2 |
| D-P1-01 | ≥8 artboards UX en Paper (stakeholders → datos) |
| D-P1-02 | Tokens leaf/straw/bone en Angular |
| D-P1-03 | apps/api + apps/web independientes |
| D-P1-05 | JWT en todas las rutas de tareas |
| D-P1-06 | Smoke login + GET/POST/PATCH tasks |
4. Cuentas demo
| Rol | Nombre | Email | Password |
|---|
| FARMER | Inés Roura | campo@surco.agro | password123 |
| TECHNICIAN | Pol Vidal | tecnico@surco.agro | password123 |
Seed de referencia: parcelas Bancal Nord (olivo arbequina 2,4 ha) y Surco Baix (almendro 1,1 ha); 5 FieldTask con códigos SU-MMDD-XX.
Supuestos (no investigación primaria)
- Explotaciones familiares mediterráneas coordinan con libreta/WhatsApp.
- Técnico externo de asesoramiento visita varias fincas.
- Conectividad intermitente en campo (offline full = out of scope v1).
5. Criterio de cierre del día
Estado del brief: listo para EXECUTE y entrega de caso.
