CAUDAL Frontend

Aplicación web instalable (PWA) de CAUDAL, el cuaderno digital del acueducto veredal:

• Fontanero: registra la lectura del tanque desde el celular, también sin señal, y anota el cierre del día.
• Junta: ve el estado y el pronóstico del tanque, aprueba o modifica los turnos con motivo y publica el horario.
• Familias: consultan el horario sin datos personales y reportan daños.

React 19 · Vite · TypeScript · PWA sin conexión.

Estado

v1.0.0. La aplicación cubre a los cinco actores: horario público y reporte de daños, sesión, fontanero (con cola sin conexión), Junta (tanque, propuestas, reglas, actas, incidentes, entidades y usuarios), equipo del proyecto y entidades de apoyo. Detalle por actor, rutas y verificación en docs/Version-1.0.0.md.

Documentación

• docs/Version-1.0.0.md: qué incluye la versión 1.0.0, rutas, verificación, despliegue y faltas del contrato de la API.
• AGENTS.md: reglas obligatorias para personas y agentes.
• .agents/: arquitectura, pantallas, cola sin conexión, tema visual, seguridad, patrones y pruebas.
• Documentación canónica del proyecto: caudal-backend/docs.
• Política de seguridad y cómo contribuir.

Cómo correrlo

cp .env.example .env.local
pnpm install
pnpm dev          # http://localhost:5173

Verificación antes de cada commit:

pnpm format:check
pnpm lint
pnpm typecheck
pnpm test:coverage
pnpm build

Pruebas end-to-end (Playwright, con axe): pnpm e2e:install una vez y después pnpm e2e. Otros comandos: pnpm gen:api (tipos desde docs/openapi.json).

Equipo

Nicolas Diaz (NicoalsD) · Drako Salazar (Drako2305) · Nicolas Mora (nicomora70). Proyecto de la materia Patrones de Software.