CotizaPro — Busca. Cotiza. Construye.

Aplicación web lista para usar para consultar materiales del inventario, agregar cantidades, generar cotizaciones confiables (con IVA, descuentos y vigencia) y conservar el historial por cliente.

• Stack: React 19 + TypeScript + Vite 7 + Tailwind CSS 4 + React Router.
• Acceso: login con Firebase Authentication, recuperación de contraseña, cambio obligatorio en el primer ingreso y perfiles Administrador / Vendedor con permisos configurables (ver FIREBASE.md). Sin configurar Firebase arranca en modo demo local.
• Datos de negocio: inventario, clientes y cotizaciones en Firestore, compartidos por todo el equipo y sincronizados en tiempo real (colecciones documentadas en FIRESTORE.md). Sin .env el modo demo los guarda en localStorage (clave cotizapro.v1) con catálogo de 30 materiales, 5 clientes y 8 cotizaciones.
• Asesor con IA: chat que asesora en el diseño de proyectos (tipo y cantidad de materiales, contruccion e ideas de proyectos) acepta fotos, planos y dibujos, y propone materiales del inventario para pasarlos a la cotización. Usa Google Gemini con su capa gratuita (ver ASESOR_IA.md).
• Despliegue: sitio estático; el único servicio externo es Firebase (Authentication + Firestore). Publicación desde GitHub en PUBLICAR.md. Todos los servicios de terceros se usan en su version gratuita, cuando la aplicación avance o llegue a su estado productivo se incorporaran los servicios pagos correspondientes a las funcionalidades que requiera la aplicación.

Pantallas

Ruta	Función
/	Buscar materiales por nombre, código o categoría; ver precio, unidad y stock; stepper de cantidad y "Agregar".
/cotizacion	Cotización en curso (borrador): cliente, cantidades, precio editable, descuento por línea, descuento global, IVA, vigencia, notas, generar y compartir.
/cotizacion/:id	Ver o editar una cotización específica.
/cotizaciones	Historial general con KPIs (enviadas, aceptadas, por vencer, borradores), filtros por estado y acciones (PDF, aceptar, rechazar).
/clientes	Lista de clientes con total cotizado y aceptadas; crear cliente.
/clientes/:id	Historial de cotizaciones de ese cliente.
/inventario	Administrar materiales: crear, editar, eliminar, importar CSV, alertas de stock. (solo Administrador)
/reportes	Reportes globales: ventas, conversión, ticket promedio, ventas por vendedor y por mes, top clientes. (solo Administrador)
/usuarios	Crear vendedores con clave temporal, activar/desactivar, eliminar y configurar permisos. (solo Administrador)
/asesor	Asesor de proyectos con IA: chat con imágenes y materiales sugeridos del inventario. (permiso asesor.ia)
/ajustes	Datos de la empresa para el PDF (logo, NIT, dirección), IVA y vigencia por defecto. (edición solo Administrador)
/login	Ingreso y recuperación de contraseña.
/cambiar-password	Cambio obligatorio de contraseña en el primer ingreso.
/pdf/:id	Vista imprimible tamaño carta (Imprimir → "Guardar como PDF").

Reglas del cotizador

total_línea = cantidad × precio_unitario × (1 − descuento_línea / 100)
subtotal    = Σ total_línea
descuento   = subtotal × descuento_global / 100
base        = subtotal − descuento
iva         = base × iva_pct / 100
total       = base + iva

• El nombre y el precio quedan congelados en la cotización (snapshot): cambiar el inventario no altera cotizaciones ya emitidas; la app avisa y ofrece "Actualizar precios" en los borradores.
• El número consecutivo se asigna al generar, no al crear el borrador.
• Vigencia por defecto 15 días; al pasar la fecha, una cotización Enviada pasa a Vencida.
• Se puede cotizar por encima del stock, pero se muestra advertencia.
• Moneda COP sin decimales ($ 1.452.327), IVA por defecto 19 %.

Importar inventario por CSV

Encabezado opcional; separador , o ;:

codigo,nombre,categoria,unidad,precio,stock,stock_minimo,descripcion
COD-1023,Cemento Gris Uso General 50 kg,Cemento,bulto,32400,240,40,Cemento gris de fraguado normal para obra gris
COD-2210,Varilla corrugada 1/2" x 6 m,Acero,unidad,28900,8,20,Varilla figurable grado 60

Unidades válidas: unidad, bulto, m2, m3, kg, ml. Si el código ya existe, se actualiza el material; si no, se crea.

Ejecutar en local

Requiere Node.js 20.19+ (recomendado 22 LTS) y npm.

npm install
npm run dev          # http://localhost:5173

Otros comandos:

npm run build        # typecheck (tsc -b) + build de producción en dist/
npm run preview      # sirve dist/ en http://localhost:4173
npm run typecheck    # tsc -b

Variables de entorno

cp .env.example .env   # config web de Firebase

Sin .env la app funciona en modo demo local (usuarios en localStorage, [email protected] / Admin1234 y [email protected] / Vendedor1234). Para el login real, sigue se requiere los datos suministrados por nosotros los creadores de la aplicación.

Uso local

Para instalarla y usarla en nuestro computador (modo demo, conectada a Firebase o compartida en la red del negocio), ver LOCAL.md.

Limitaciones actuales

• El modo demo local (sin .env) sigue guardando los datos solo en el navegador; ahí las cotizaciones no se comparten entre dispositivos.
• El modo demo local (sin Firebase) no es seguridad de producción: valida credenciales en el propio navegador.
• El PDF es la vista imprimible del navegador (Imprimir → Guardar como PDF), no generación en servidor.
• WhatsApp y correo se abren con enlaces wa.me y mailto:; no hay integración con la API oficial.
• El enlace que se comparte (/pdf/:id) exige sesión: lo abre quien pueda ver esa cotización (su vendedor o un administrador), no un cliente externo.