CotizaFlow

Aplicación web demostrativa para crear y administrar cotizaciones de pequeños negocios.

CotizaFlow es un proyecto colaborativo de portafolio enfocado en desarrollo frontend, lógica comercial, persistencia local y aseguramiento de calidad. Su objetivo es demostrar la construcción y validación de un flujo completo para gestionar clientes, servicios y cotizaciones.

Estado del proyecto

MVP funcional / fase demostrativa. La interfaz y los flujos principales están disponibles para revisión. Esta versión no utiliza cuentas reales, Supabase ni una base de datos compartida; cada navegador conserva sus propios datos de prueba.

Funcionalidades

• Panel con métricas y estado de cotizaciones.
• Gestión de clientes.
• Catálogo de productos y servicios.
• Creación de cotizaciones con múltiples ítems.
• Cálculo de subtotal, descuento, IVA del 19 % y total.
• Estados: borrador, enviada, aceptada y rechazada.
• Búsqueda y filtrado.
• Descarga de cotizaciones en PDF.
• Persistencia en el navegador mediante localStorage.
• Diseño responsive para computador, tablet y celular.

Tecnologías

• React 19
• TypeScript
• Next.js
• CSS responsive
• Shadcn UI
• Lucide React
• jsPDF

Ejecutar localmente

npm install
npm run dev

Para validar la versión de producción:

npm run lint
npm test

Datos y alcance

La versión actual funciona como demostración: utiliza información ficticia y guarda los cambios en el navegador del usuario. No corresponde a un sistema contable ni emite documentos tributarios electrónicos.

Una segunda fase puede incorporar Supabase para autenticación, PostgreSQL y políticas de seguridad por usuario.

Casos de prueba principales

1. Crear, editar y eliminar clientes.
2. Crear, editar y eliminar servicios.
3. Crear una cotización con uno o varios ítems.
4. Validar cantidades y precios inválidos.
5. Comprobar subtotal, descuento, IVA y total.
6. Buscar y filtrar cotizaciones.
7. Cambiar el estado de una cotización.
8. Descargar el documento en PDF.
9. Comprobar persistencia al recargar la página.
10. Validar navegación y formularios en dispositivos móviles.

Próxima fase

• Autenticación con Supabase.
• Base de datos PostgreSQL.
• Row Level Security para aislar los datos de cada cuenta.
• Pruebas end-to-end con Playwright.
• Flujo automatizado de pruebas mediante GitHub Actions.

---

Todos los nombres, RUT, correos, direcciones y valores incluidos en la demostración son ficticios.

Demostración pública: Ver CotizaFlow en funcionamiento