Validez de puntos · backend: dominio (disputed + ResourceValidityReport), migración 0028 y casos de uso

[vgpastor]

Parte del EPIC #120 · ficha docs/features/15-reporte-validez-de-puntos.md (§3.1, §3.2).

Objetivo

Modelar en el contexto resources la captura del reporte de validez y la lógica de "punto en duda".

Tareas

• Resource: añadir disputed: boolean (default false) + disputedAt: Date | null. Métodos de dominio flagDisputed(at) (solo si publicStatus ∈ {active, saturated, paused}) y clearDispute(). Eventos ResourceDisputed / ResourceDisputeResolved.
• Nueva entidad ResourceValidityReport + enum ValidityReason (closed | nonexistent | moved | outdated), con status (open | accepted | dismissed), note y photoUrls opcionales.
• Puerto ResourceValidityReportRepository + adapter Drizzle.
• Migración apps/api/drizzle/0028_resource_validity_reports.sql: tabla resource_validity_reports (+ índice único parcial (resource_id, reporter_user_id) WHERE status='open', índices por recurso/emergencia) y ALTER TABLE resources ADD COLUMN disputed/disputed_at. Aplicar en dev y test (global-setup) vía psql.
• Casos de uso:
  • ReportResourceValidity — valida recurso visible; upsert del reporte abierto del usuario; recuenta reportantes distintos; si ≥ 3 y no estaba en duda → flagDisputed(). Excluye al dueño del recuento.
  • ResolveResourceDispute — confirm_closed (→ changePublicStatus(Closed) + reportes accepted + clearDispute) / dismiss (→ reportes dismissed + clearDispute).
  • GetDisputedResources (cola) y GetResourceValidityReports (detalle).

Criterios de aceptación

• TDD en verde: umbral N=3, dedup por usuario, invariante "solo disputable si visible", idempotencia de flagDisputed, exclusión del dueño.
• pnpm --filter api build y pnpm --filter api test en verde.

Decisiones aplicadas (ficha §8): arquitectura propia en resources, N=3 global, excluir dueño, sin TTL en MVP.

[vgpastor]

✅ Implementado en PR #119. Entregado y ajustes respecto al plan original:

• Dominio: Resource.disputed/disputedAt + flagDisputed() / clearDispute(resolution) / markInvalid() + eventos resource.disputed / resource.dispute_resolved. Entidad ResourceValidityReport + enums ValidityReason (closed/nonexistent/moved/outdated) y ValidityReportStatus.
• Migración 0031 (no 0028 — main ocupó 0028–0030): tabla resource_validity_reports con índice único parcial (resource_id, reporter_user_id) WHERE status='open' + columnas disputed/disputed_at en resources.
• Casos de uso: ReportResourceValidity (upsert + dedup + umbral N=3 → flagDisputed, excluye al dueño), ResolveResourceDispute (3 vías: confirm_closed / mark_invalid / dismiss; devuelve MutationAuditResult para el activity trail de feat: editar/descartar con motivo en validación + trazabilidad coordinador-only #135), GetDisputedResources, GetResourceValidityReports.
• Repos (puerto + Drizzle + en memoria) y wiring del módulo.
• Tests: 23 specs nuevos (dominio + casos de uso). Gate completo verde — build · lint · prettier · test (162 suites, 1066 tests).

Pendiente en el resto de la EPIC: API/endpoints + gen:api (#122), web ciudadano (#123), web coordinación (#124).

---

Generated by Claude Code