|
|
# Plan de trabajo — Web (SvelteKit) orientado a móvil y acciones de tareas
|
|
|
|
|
|
Contexto y objetivos
|
|
|
- Reforzar la utilidad móvil, mostrar grupos y responsables correctamente, y simplificar acciones prioritarias (completar/undo) manteniendo seguridad (gating) alineada con el backend.
|
|
|
- Mantener el diseño sin truncar descripciones; ofrecer orden por fecha o por grupo; y mostrar TODAS las abiertas en /app/groups.
|
|
|
- Evitar regresiones, con cambios iterativos y fácilmente revertibles.
|
|
|
|
|
|
Decisiones globales
|
|
|
- No truncar descripciones en TaskItem; envolver en varias líneas. Acciones secundarias se desplazan a una segunda línea/menú contextual en móvil.
|
|
|
- “Completar” se promueve como acción principal (checkbox/botón destacado). Incluir “Deshacer completar” con ventana configurable (24h por defecto).
|
|
|
- “Mis tareas” tendrá dos secciones:
|
|
|
1) Asignadas a mí (todas abiertas).
|
|
|
2) Sin responsable de mis grupos (todas abiertas).
|
|
|
- “Grupos” mostrará secciones por grupo, con TODAS las tareas abiertas, expandibles/colapsables, y con toggle “Unassigned first”.
|
|
|
- Búsqueda por texto desaparece de la UI (se reserva a futuro si fuese necesaria).
|
|
|
- Orden conmutado por el usuario: Fecha (due asc, NULL al final) | Grupo (agrupación por grupo y dentro por fecha).
|
|
|
- Seguridad: endurecer PATCH de tareas sin grupo para exigir ser responsable (y opcionalmente creador si el esquema lo permite).
|
|
|
- Ventana de uncomplete (deshacer completar): configurable por variable de entorno UNCOMPLETE_WINDOW_MIN (1440 por defecto).
|
|
|
|
|
|
Medición de impacto y riesgos
|
|
|
- N+1 inicial en /app (al agregar “sin responsable” de todos los grupos) tolerable en MVP, mitigado luego con endpoint “overview”.
|
|
|
- Posible crecimiento de DOM en /app/groups: se mitiga con secciones colapsables.
|
|
|
- Cambios de gating en PATCH requieren revisar casos edge (tareas personales sin asignados previos).
|
|
|
|
|
|
Archivos ya disponibles para edición (confirmados)
|
|
|
- UI:
|
|
|
- apps/web/src/lib/ui/layout/AppShell.svelte
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte
|
|
|
- apps/web/src/lib/ui/data/GroupCard.svelte
|
|
|
- apps/web/src/routes/app/+page.svelte
|
|
|
- apps/web/src/routes/app/+page.server.ts
|
|
|
- apps/web/src/routes/app/groups/+page.svelte
|
|
|
- apps/web/src/routes/app/groups/+page.server.ts
|
|
|
- API:
|
|
|
- apps/web/src/routes/api/me/tasks/+server.ts
|
|
|
- apps/web/src/routes/api/me/groups/+server.ts
|
|
|
- apps/web/src/routes/api/groups/[id]/tasks/+server.ts
|
|
|
- apps/web/src/routes/api/tasks/[id]/+server.ts (PATCH)
|
|
|
- apps/web/src/routes/api/tasks/[id]/claim/+server.ts
|
|
|
- apps/web/src/routes/api/tasks/[id]/unassign/+server.ts
|
|
|
- apps/web/src/routes/api/tasks/[id]/complete/+server.ts
|
|
|
- Infra web:
|
|
|
- apps/web/src/lib/server/env.ts
|
|
|
- apps/web/src/lib/server/db.ts
|
|
|
- Núcleo:
|
|
|
- src/db.ts
|
|
|
|
|
|
Archivos que solicitaremos añadir al chat cuando toque editar
|
|
|
- Documentación: docs/operations.md (para documentar UNCOMPLETE_WINDOW_MIN y notas UX).
|
|
|
- Tests: tests/web/* y tests/unit/* (para cubrir uncomplete y cambios de gating).
|
|
|
- (Opcional) Migraciones: src/db/migrations/* si llegamos a necesitar created_by en gating de PATCH.
|
|
|
|
|
|
Fase 1 — UX base en páginas y TaskItem (sin backend nuevo) — Estado: Completada
|
|
|
Objetivos
|
|
|
- /app: añadir sección “Sin responsable de mis grupos”, quitar búsqueda, añadir conmutador de orden (Fecha | Grupo).
|
|
|
- /app/groups: mostrar TODAS las tareas por grupo en secciones expandibles/colapsables; toggle “Unassigned first”.
|
|
|
- TaskItem: mostrar chip de grupo; mantener descripción sin truncar; reorganizar acciones para móvil.
|
|
|
Archivos a editar
|
|
|
- apps/web/src/routes/app/+page.server.ts
|
|
|
- Cargar /api/me/tasks (open, asignadas a mí).
|
|
|
- Cargar /api/me/groups; para cada grupo, solicitar /api/groups/:id/tasks?onlyUnassigned=true&limit=0 y reunir la lista “unassigned”.
|
|
|
- Construir map {groupId → groupName} para la UI.
|
|
|
- Gestionar query param order=due|group.
|
|
|
- apps/web/src/routes/app/+page.svelte
|
|
|
- Renderizar dos secciones (asignadas y sin responsable). Añadir conmutador de orden. Eliminar campo de búsqueda.
|
|
|
- apps/web/src/routes/app/groups/+page.server.ts
|
|
|
- En vez de previews, cargar /api/groups/:id/tasks?limit=0 para cada grupo (todas abiertas).
|
|
|
- Permitir query unassignedFirst=true (por grupo o global).
|
|
|
- apps/web/src/routes/app/groups/+page.svelte
|
|
|
- Reemplazar cuadrícula de GroupCard por secciones por grupo (cabecera con +/– para colapsar).
|
|
|
- Dentro de cada sección, lista de TaskItem reutilizando las mismas acciones.
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte
|
|
|
- Mostrar chip con el nombre del grupo si group_id != null; “Personal” si no tiene grupo (usar map pasado desde el server o prop groupName).
|
|
|
- Promover “Completar” visualmente (sin cambiar aún la API).
|
|
|
- apps/web/src/lib/ui/data/GroupCard.svelte
|
|
|
- Mantener para posibles resúmenes; la página de grupos dejará de usarla de forma principal.
|
|
|
Decisiones
|
|
|
- Orden “por grupo” inicialmente puede agruparse en cliente para el agregado “sin responsable”; “asignadas” ya vienen por fecha. En fases posteriores, endpoint overview dará orden estable en servidor.
|
|
|
|
|
|
Fase 2 — Backend: Uncomplete (24h configurable) + seguridad de PATCH — Estado: Completada
|
|
|
Objetivos
|
|
|
- Añadir POST /api/tasks/:id/uncomplete (idempotente) con gating simétrico a /complete y ventana configurable.
|
|
|
- Endurecer PATCH /api/tasks/:id para tareas sin group_id: exigir que el usuario sea asignado (y, si luego confirmamos schema, permitir también si created_by = usuario).
|
|
|
Archivos a editar/crear
|
|
|
- apps/web/src/lib/server/env.ts
|
|
|
- Añadir export const UNCOMPLETE_WINDOW_MIN = ... (leer de env, default 1440). Exponer helper uncompleteWindowMs si conviene.
|
|
|
- apps/web/src/routes/api/tasks/[id]/uncomplete/+server.ts (nuevo)
|
|
|
- Validar sesión, id, existencia de tarea.
|
|
|
- Gating:
|
|
|
- Con group_id: miembro activo de grupo allowed.
|
|
|
- Sin group_id: debe estar asignado a la tarea.
|
|
|
- Validar ventana: completed=1 y completed_at >= now - UNCOMPLETE_WINDOW_MIN.
|
|
|
- UPDATE: completed=0, completed_at=NULL (y opcional completed_by=NULL).
|
|
|
- Respuesta: status ('updated'|'already'|'not_found'|'forbidden'), tarea resultante.
|
|
|
- apps/web/src/routes/api/tasks/[id]/+server.ts (PATCH)
|
|
|
- Añadir chequeo cuando group_id IS NULL: exigir que exista asignación del user sobre la tarea (alineado con complete/unassign).
|
|
|
- UI
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte — añadir acción “Deshacer completar” (usando el nuevo endpoint) y toast con feedback.
|
|
|
- apps/web/src/routes/app/+page.svelte — en la sección “Completadas (24 h)” añadir botón “Deshacer completar”.
|
|
|
Documentación y configuración (solicitaremos permiso para editar)
|
|
|
- docs/operations.md — documentar UNCOMPLETE_WINDOW_MIN (minutos; default 1440), semántica e idempotencia.
|
|
|
|
|
|
Fase 3 — Navegación móvil (barra de pestañas) y jerarquía de acciones — Estado: Completada
|
|
|
Objetivos
|
|
|
- Evitar que el header rebose en móvil. Añadir barra inferior con iconos (tabs) para Tareas, Grupos, Integraciones (calendario), Preferencias (alarma). Reducir peso visual de “Integraciones” en móvil.
|
|
|
- Consolidar “Completar” como acción primaria (checkbox/botón destacado); otras acciones (Reclamar/Soltar/Editar/Fecha) en segunda línea o menú contextual.
|
|
|
Archivos a editar/crear
|
|
|
- apps/web/src/lib/ui/layout/AppShell.svelte
|
|
|
- Añadir barra inferior sticky (solo en viewport ≤768px), con safe-area, iconos (SVG inline o emojis inicialmente), aria-labels y foco accesible.
|
|
|
- Mantener header para desktop.
|
|
|
- (Opcional) apps/web/src/lib/ui/icons/* (nuevos)
|
|
|
- CalendarIcon.svelte, AlarmIcon.svelte, TasksIcon.svelte, GroupsIcon.svelte (si prefieres SVGs en vez de emojis).
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte
|
|
|
- Ajustar layout mobile-first: acciones secundarias y espaciado compacto.
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- En móvil (≤768px):
|
|
|
- Header de desktop oculto; tabbar inferior con 5 pestañas: Tareas (✅), Grupos (👥), Recordatorios (⏰), Calendarios (📅) y Salir (🚪, POST).
|
|
|
- Barra superior mínima con título dinámico (“Tareas”, “Grupos”, “Recordatorios”, “Calendarios”), altura 24px y safe-area superior.
|
|
|
- Iconografía con emojis; icono + texto hasta 768px y solo icono en ≤480px.
|
|
|
- Safe-area inferior respetado y offset de Toast ajustado para no solapar la tabbar.
|
|
|
- En desktop (>768px):
|
|
|
- Header visible con navegación renombrada/reordenada: Tareas / Grupos / Recordatorios / Calendarios.
|
|
|
- Accesibilidad:
|
|
|
- aria-labels en pestañas y logout, estado activo visible, orden de tabulación coherente.
|
|
|
- TaskItem:
|
|
|
- “Completar/Deshacer” promovido como acción primaria; acciones secundarias (Reclamar/Soltar, Editar, Fecha) en segunda línea compacta en móvil.
|
|
|
- Descripciones sin truncar, manteniendo legibilidad.
|
|
|
- Integración:
|
|
|
- Cambios aplicados en AppShell y Toast, evitando solapes y reservando espacio en main.
|
|
|
|
|
|
Fase 4 — Optimización: endpoint “overview” y orden en servidor — Estado: Completada
|
|
|
Objetivos
|
|
|
- Evitar N peticiones en /app para el bloque “sin responsable”.
|
|
|
- Servir orden “por grupo” ya resuelto en servidor.
|
|
|
Archivos a crear/editar
|
|
|
- apps/web/src/routes/api/me/tasks/overview/+server.ts (nuevo)
|
|
|
- Respuesta: { assigned: Task[], unassigned: Task[] } (open).
|
|
|
- Params: order=due|group_then_due (por defecto due).
|
|
|
- Cada Task incluye: id, description, due_date, group_id, group_name, display_code, assignees[].
|
|
|
- Gating: igual que /api/me/tasks.
|
|
|
- apps/web/src/routes/api/me/tasks/+server.ts
|
|
|
- (Opcional) Añadir order=group_then_due y group_name via JOIN; mantener compatibilidad con tests existentes.
|
|
|
- apps/web/src/routes/app/+page.server.ts
|
|
|
- Consumir overview para reducir llamadas y aplicar el orden de servidor.
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- Endpoint GET /api/me/tasks/overview creado.
|
|
|
- Devuelve assigned y unassigned (abiertas) con order=due|group_then_due (mapeo desde la UI: group → group_then_due).
|
|
|
- En cada tarea: id, description, due_date, group_id, group_name (null en personales), display_code, assignees[] (vacío en unassigned).
|
|
|
- Gating aplicado: assigned según /api/me/tasks; unassigned solo de grupos allowed con membresía activa del usuario; exclusión de personales en unassigned.
|
|
|
- /app/+page.server.ts consume overview para “sin responsable” y elimina el N+1; se mantiene /api/me/tasks para “Mis tareas (abiertas)” con su paginación actual.
|
|
|
- Respuestas con cache-control: no-store.
|
|
|
|
|
|
Fase 5 — Responsables: conteo, marca “tú” y popover con wa.me — Estado: Completada
|
|
|
Objetivos
|
|
|
- Mostrar de forma compacta cuántas personas están asignadas; marcar si el usuario actual está entre ellas; listar números y permitir mensaje directo (wa.me) bajo demanda.
|
|
|
Archivos a editar/crear
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte
|
|
|
- Badge “Responsables: n” + “tú” si corresponde; al pulsar, abrir popover/modal con lista.
|
|
|
- apps/web/src/lib/ui/feedback/Popover.svelte (nuevo) o reutilizar un modal ligero existente
|
|
|
- Accesibilidad: rol="dialog", focus trap, cierre con ESC.
|
|
|
- (Opcional) apps/web/src/lib/utils/phone.ts (nuevo)
|
|
|
- Helpers para abreviar números y construir URL segura wa.me.
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- TaskItem: badge con conteo e indicador “tú”; en ausencia de responsables se muestra botón deshabilitado con icono 🙅.
|
|
|
- Popover accesible (rol="dialog", focus trap, cierre con ESC, restauración de foco) y compatible con SSR.
|
|
|
- Enlaces directos a WhatsApp usando wa.me/<dígitos>, con normalización de números.
|
|
|
- Unificación de UI en escritorio y móvil.
|
|
|
- No se requirieron cambios de backend; los endpoints ya devolvían assignees[].
|
|
|
|
|
|
Fase 6 — Pulido y peso visual de “Integraciones” — Estado: Completada
|
|
|
Objetivos (cumplidos)
|
|
|
- Mantener “Integraciones” (renombrada a “Calendarios”) accesible pero con menor jerarquía en móvil.
|
|
|
- Ajustar densidad, estados vacíos y recordar colapsado por grupo en localStorage.
|
|
|
|
|
|
Decisiones aplicadas y resultado
|
|
|
- Etiqueta y jerarquía:
|
|
|
- La pestaña se renombra a “Calendarios” en navegación de escritorio y tabbar móvil; títulos y aria-labels actualizados.
|
|
|
- Atenuación en móvil cuando inactiva; estado activo mantiene color primario y foco visible.
|
|
|
- Safe-areas y solapes:
|
|
|
- Offsets en main y Toast para no solapar con la tabbar; sticky de topbar móvil verificado.
|
|
|
- Estados vacíos:
|
|
|
- Opción B aplicada: mensajes con pista de acción (“Crea o reclama…” / “Crea una nueva o invita…”).
|
|
|
- Persistencia de colapsado por usuario en /app/groups:
|
|
|
- Clave localStorage: groupsCollapsed:v1:{userId}.
|
|
|
- Por defecto: abiertos los grupos con al menos una tarea abierta; colapsados los que no tienen tareas abiertas.
|
|
|
- Limpieza de IDs obsoletos; restauración en onMount, SSR-safe (sin parpadeos apreciables).
|
|
|
- Accesibilidad:
|
|
|
- Foco visible en tabs; uso de <details>/<summary> con estado coherente con aria-expanded implícito.
|
|
|
|
|
|
Archivos editados
|
|
|
- apps/web/src/lib/ui/layout/AppShell.svelte (renombrado a “Calendarios”, atenuación móvil, offsets).
|
|
|
- apps/web/src/routes/app/groups/+page.svelte (persistencia de colapsado por usuario + defaults basados en tareas).
|
|
|
- apps/web/src/routes/app/+page.svelte (textos de estados vacíos opción B).
|
|
|
- apps/web/src/lib/ui/feedback/Toast.svelte (offset móvil contra tabbar).
|
|
|
|
|
|
Criterios de aceptación (OK)
|
|
|
- /app muestra dos secciones con todas las tareas requeridas; sin truncar descripciones; orden conmutado.
|
|
|
- /app/groups muestra todas las tareas abiertas por grupo; secciones colapsables; “Unassigned first” operativo.
|
|
|
- Completar y Deshacer completar funcionan desde ambas páginas; ventana de 24h configurable; gating correcto.
|
|
|
- PATCH no permite editar tareas sin grupo si no eres responsable (o creador, si se habilita).
|
|
|
- Navegación móvil no rebosa; barra inferior accesible.
|
|
|
- Asignados: conteo visible, “tú” resaltado y lista en popover con wa.me.
|
|
|
|
|
|
Fase 7 — Densidad y acciones en una sola fila (TaskItem) — Estado: Completada
|
|
|
Objetivos
|
|
|
- Compactar la fila de acciones de TaskItem:
|
|
|
- Convertir el botón/indicador de responsables en “icono + número” sin texto (“personas asignadas” → solo icono + contador), manteniendo aria-label y tooltip accesibles.
|
|
|
- Ubicar en la misma fila: Responsables (icono+conteo), Reclamar/Soltar, Editar, Fecha.
|
|
|
- Reducir padding vertical excesivo para ganar densidad, manteniendo objetivos de accesibilidad (área táctil ≈44px y foco visible).
|
|
|
|
|
|
Plan de trabajo
|
|
|
1) TaskItem.svelte
|
|
|
- Sustituir texto “Responsables: n” por icono + n; aria-label dinámico (“n responsables; tú incluido/excluido”).
|
|
|
- Reorganizar contenedor de acciones para una sola fila en móvil y desktop; permitir wrap en pantallas muy pequeñas si es necesario.
|
|
|
- Ajustar tamaños (icon-size 16–18px) y gaps a 6–8px.
|
|
|
2) Estilos globales y utilidades
|
|
|
- Revisar variables de espacio en tokens.css/base.css; reducir ligeramente los márgenes/paddings verticales de:
|
|
|
- Listas de tareas (ul.list > li o contenedor del TaskItem).
|
|
|
- Card.svelte (padding vertical).
|
|
|
- AppShell .main en móvil (si procede).
|
|
|
- Mantener contraste y focus-visible.
|
|
|
3) QA
|
|
|
- Verificar que en ≤480px no haya desbordes; que los tooltips/aria sean correctos; y targets táctiles respeten accesibilidad.
|
|
|
|
|
|
Archivos a editar
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte (layout de acciones, icono+conteo).
|
|
|
- apps/web/src/lib/styles/base.css (ajustes finos de paddings/gaps).
|
|
|
- apps/web/src/lib/styles/tokens.css (si se decide ajustar variables globales de spacing).
|
|
|
- apps/web/src/lib/ui/layout/Card.svelte (si requiere reducir padding vertical interno).
|
|
|
|
|
|
Criterios de aceptación
|
|
|
- TaskItem muestra todas las acciones en una sola fila en móvil estándar (≥360px) sin saltos.
|
|
|
- El indicador de responsables conserva accesibilidad (aria-label/tooltip) y se entiende su semántica.
|
|
|
- La densidad aumenta perceptiblemente sin comprometer legibilidad ni foco.
|
|
|
|
|
|
Fase 8 — Orden por fecha o por grupo (corrección y alineación) — Estado: Completada
|
|
|
Objetivos
|
|
|
- Alinear el comportamiento de “Orden: Fecha | Grupo” con expectativas:
|
|
|
- Fecha: due_date asc; NULL al final; estable por id.
|
|
|
- Grupo: agrupar por grupo (Personal al final); dentro de cada grupo ordenar por due_date asc; NULL al final.
|
|
|
- Que el orden seleccionado afecte coherentemente a las secciones relevantes (asignadas y/o sin responsable), evitando inconsistencias entre cliente y servidor.
|
|
|
|
|
|
Plan de trabajo
|
|
|
1) Auditoría actual
|
|
|
- Revisar apps/web/src/routes/app/+page.server.ts y el consumo de /api/me/tasks/overview.
|
|
|
- Revisar apps/web/src/routes/app/+page.svelte (groupByGroup/sortByDue) para evitar doble orden contradictorio.
|
|
|
2) Backend
|
|
|
- apps/web/src/routes/api/me/tasks/overview/+server.ts: asegurar order=due|group_then_due y aplicar NULLS LAST consistente.
|
|
|
- Añadir tests que validen el orden en ambos modos.
|
|
|
3) UI
|
|
|
- apps/web/src/routes/app/+page.server.ts: pasar order al backend y confiar en su orden siempre que sea posible.
|
|
|
- apps/web/src/routes/app/+page.svelte: limitar orden en cliente a casos estrictamente necesarios; evitar reordenar lo ya ordenado por servidor.
|
|
|
4) QA y tests
|
|
|
- Casos con due_date iguales, NULLs, mezcla de grupos, y tareas personales.
|
|
|
|
|
|
Archivos a editar
|
|
|
- apps/web/src/routes/api/me/tasks/overview/+server.ts
|
|
|
- apps/web/src/routes/app/+page.server.ts
|
|
|
- apps/web/src/routes/app/+page.svelte
|
|
|
- tests/web/* (añadir/ajustar tests de orden)
|
|
|
|
|
|
Criterios de aceptación
|
|
|
- El cambio de orden se refleja de forma predecible y consistente en toda la página /app.
|
|
|
- Tests cubren due_date NULL, empates y orden de grupos (Personal al final).
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- Backend autoritativo: /api/me/tasks y /api/me/tasks/overview aceptan order=due|group_then_due.
|
|
|
- Modo Fecha: due_date ASC con NULL al final; desempate estable por id.
|
|
|
- Modo Grupo: grupos A→Z con “Personal” al final; dentro de cada grupo due_date ASC con NULL al final; desempate por id.
|
|
|
- Gating consistente aplicado en ambos endpoints.
|
|
|
- UI /app:
|
|
|
- Pasa el parámetro de orden al backend para ambas secciones.
|
|
|
- Evita reordenar en cliente; solo agrupa visualmente “Sin responsable” cuando order=group.
|
|
|
- “Mis tareas (abiertas)” respeta el orden recibido (sin agrupar).
|
|
|
|
|
|
Pendiente (futuro opcional)
|
|
|
- Añadir pruebas automatizadas de orden para /api/me/tasks y /api/me/tasks/overview (casos con NULL y empates).
|
|
|
- Si se desea, agrupar visualmente por grupo en “Mis tareas (abiertas)” cuando order=group (solo encabezados; sin alterar el orden).
|
|
|
- Considerar índices adicionales si el dataset crece (p. ej., índices por due_date y group_id) para acelerar ORDER BY.
|
|
|
|
|
|
Fase 9 — Semilla de desarrollo enriquecida — Estado: Completada
|
|
|
Objetivos
|
|
|
- Disponer de una BD de desarrollo amplia para probar casos reales:
|
|
|
- Grupos con y sin tareas; tareas personales; varias tareas sin responsable; tareas con múltiples responsables; tareas completadas recientemente y antiguas; due_dates en pasado/presente/sin fecha.
|
|
|
- Varios usuarios para validar “tú” y múltiples assignees.
|
|
|
|
|
|
Plan de trabajo
|
|
|
1) Semilla
|
|
|
- apps/web/src/lib/server/dev-seed.ts: ampliar dataset con:
|
|
|
- 3–4 usuarios (incluido el por defecto).
|
|
|
- 4–5 grupos; al menos 1 sin tareas, 1 con muchas tareas, 1 mixto.
|
|
|
- 25–40 tareas variadas (diferentes due, estados, grupos/personales).
|
|
|
- Relaciones de asignación múltiples en algunas tareas.
|
|
|
- Asegurar idempotencia y que no se sobreescriba si ya hay datos.
|
|
|
2) Helpers de test (si procede)
|
|
|
- tests/web/helpers/db.ts: exponer utilidades para crear fixtures específicas.
|
|
|
3) Documentación
|
|
|
- Añadir nota en docs/operations.md sobre cómo regenerar BD local y variables relacionadas.
|
|
|
|
|
|
Archivos a editar
|
|
|
- apps/web/src/lib/server/dev-seed.ts
|
|
|
- tests/web/helpers/db.ts (si se añaden utilidades)
|
|
|
- docs/operations.md (documentación de uso de seed)
|
|
|
|
|
|
Criterios de aceptación
|
|
|
- Entorno dev listo tras bootstrap: datos variados y suficientes para probar todas las vistas/secciones.
|
|
|
- Tests pueden apoyarse en fixtures reproducibles.
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- Semilla enriquecida que crea ~30–35 tareas, 5 grupos (allowed/pending), usuarios múltiples y membresías coherentes; incluye tareas personales, sin/uno/múltiples responsables y completadas recientes/antiguas con due variado.
|
|
|
- Idempotente: se ejecuta solo si la tabla tasks está vacía y con DEV_AUTOSEED_DB='true' en desarrollo; usa DEV_DEFAULT_USER numérico cuando está definido.
|
|
|
- Documentación actualizada en docs/operations.md con instrucciones para activar y regenerar la base de datos de desarrollo.
|
|
|
|
|
|
Fase 10 — Completar tarea sin responsable: auto-asignación al completador — Estado: Completada
|
|
|
Objetivos
|
|
|
- Resolver el edge case: al completar una tarea sin responsables, debe aparecer en “Completadas (24h)” del usuario y permitir “Deshacer”.
|
|
|
- Mantener gating y trazabilidad coherentes.
|
|
|
|
|
|
Plan de trabajo
|
|
|
1) Backend
|
|
|
- apps/web/src/routes/api/tasks/[id]/complete/+server.ts:
|
|
|
- Si la tarea no tiene responsables, añadir (de forma atómica) una asignación al usuario que completa antes de marcar completed=1.
|
|
|
- Registrar completed_by (si existe) o equivalente.
|
|
|
- apps/web/src/routes/api/tasks/[id]/uncomplete/+server.ts:
|
|
|
- Mantener ventana; permitir deshacer si el usuario es responsable (lo será por la auto-asignación) o fue quien completó.
|
|
|
- apps/web/src/routes/api/me/tasks/overview/+server.ts y/o consultas de “recent”:
|
|
|
- Asegurar que la consulta de recientes recoge estas tareas asignadas durante el complete.
|
|
|
2) UI
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte:
|
|
|
- Mensaje de feedback claro al completar una tarea que no tenía responsables (p.ej., “Te has asignado y completado la tarea”).
|
|
|
3) Tests
|
|
|
- Flujo: tarea sin responsables → complete → aparece en completadas → uncomplete permitido dentro de ventana.
|
|
|
|
|
|
Archivos a editar
|
|
|
- apps/web/src/routes/api/tasks/[id]/complete/+server.ts
|
|
|
- apps/web/src/routes/api/tasks/[id]/uncomplete/+server.ts
|
|
|
- apps/web/src/routes/api/me/tasks/overview/+server.ts (si la consulta de recientes depende de esto)
|
|
|
- apps/web/src/lib/ui/data/TaskItem.svelte (feedback UI)
|
|
|
- tests/web/* (casos de integración)
|
|
|
|
|
|
Resultado (implementado)
|
|
|
- Auto-asignación atómica al completar tareas de grupo sin responsables; se registra completed_by.
|
|
|
- Listado “Completadas (24 h)” incluye estas tareas gracias a la auto-asignación.
|
|
|
- Uncomplete permitido dentro de la ventana configurada, manteniendo la asignación creada.
|
|
|
- Tests de integración añadidos: complete-autoassign-recent, uncomplete-window y carrera de complete (con dos usuarios).
|
|
|
|
|
|
Criterios de aceptación
|
|
|
- Completar una tarea sin responsables la vincula al usuario y aparece inmediatamente en “Completadas (24h)”.
|
|
|
- “Deshacer completar” funciona para ese caso dentro de la ventana configurada.
|
|
|
|
|
|
Notas de implementación y buenas prácticas
|
|
|
- Mantener cabeceras cache-control: no-store en endpoints de listas/acciones.
|
|
|
- Reutilizar el gating ya presente en claim/unassign/complete; factorizar si conviene (pero sin sobre-ingeniería).
|
|
|
- Idempotencia en endpoints de mutación (claim, unassign, complete, uncomplete).
|
|
|
- Evitar dependencias externas para UI; usar SVG inline o emojis como placeholder.
|
|
|
- Accesibilidad: aria-label en iconos, focus visible, roles correctos en popovers/diálogos.
|
|
|
|
|
|
Siguientes pasos
|
|
|
1) Implementar Fase 1 (UI base) con los archivos listados.
|
|
|
2) Implementar Fase 2 (uncomplete + PATCH gating).
|
|
|
3) Validar en móvil; luego abordar Fase 3 (tabs inferiores).
|
|
|
4) Optimizar con overview (Fase 4) y cerrar UX de responsables (Fase 5).
|
|
|
5) Pulido y documentación (Fase 6).
|
|
|
|
|
|
Anexo — Ajustes opcionales futuros (Fase 4)
|
|
|
- Parámetro include=assigned|unassigned|both en /api/me/tasks/overview (por defecto unassigned) para reducir coste cuando solo se necesite una parte.
|
|
|
- Paginación en overview (assigned y/o unassigned) con parámetros page/limit independientes.
|
|
|
- Índices de rendimiento sugeridos (si el dataset crece):
|
|
|
- CREATE INDEX IF NOT EXISTS idx_tasks_group ON tasks(group_id);
|
|
|
- CREATE INDEX IF NOT EXISTS idx_tasks_due_open ON tasks(due_date) WHERE COALESCE(completed, 0) = 0;
|
|
|
- Cacheabilidad opcional con ETag/If-None-Match si se añade una versión por usuario; mantener no-store por defecto.
|