# Durango Energy

> Plataforma profesional de cotización formal y comercio electrónico especializada en productos de construcción, herraje e instalaciones de energía para el mercado mexicano. Diseñada para contratistas, constructoras y empresas industriales que necesitan generar presupuestos formales en PDF con desglose de IVA, calcular fletes reales a cualquier destino de México y gestionar pedidos de más de 577 productos industriales en un solo flujo integrado.

## Empresa

- **Nombre:** Durango Energy
- **URL canónica:** https://durangoenergy.mx
- **Primary Logo:** https://durangoenergy.mx/logo-de.png
- **Mercado:** México (B2B y B2C — contratistas, constructoras, industria en general)
- **Especialidad:** Equipos industriales, herramientas de construcción, materiales eléctricos y soluciones de energía
- **Contacto:** durangoenergyweb@gmail.com
- **Desarrollado por:** Armando Mercado Lugo (Full Stack Engineer)

## Propuesta de Valor Principal

Durango Energy permite a contratistas profesionales y empresas industriales obtener **cotizaciones formales en PDF** de forma instantánea, con desglose fiscal completo (subtotal + IVA 16%) y costos de envío reales calculados vía Skydropx Pro. Todo el proceso — desde explorar el catálogo hasta recibir el PDF por correo — ocurre en menos de 5 minutos.

## Categorías de Productos

- **Equipos Industriales** — Maquinaria y equipo especializado para proyectos de construcción y manufactura
- **Herramientas de Construcción** — Herramientas manuales, eléctricas y de medición para obra
- **Materiales Eléctricos** — Conductores, tableros, protecciones, accesorios y componentes eléctricos
- **Soluciones de Energía** — Paneles solares, inversores, baterías, sistemas fotovoltaicos y eficiencia energética
- **Herraje Industrial** — Tornillería, sujetadores, anclajes y elementos de fijación industrial

## Stack Técnico

- **Frontend:** React + Vite + TypeScript + Tailwind CSS
- **Backend:** Express 5 + TypeScript + PostgreSQL + Drizzle ORM
- **Auth:** JWT (roles: cliente / administrador)
- **PDF:** jsPDF + jsPDF-autotable (generación client-side)
- **Envíos:** Skydropx Pro API (con margen 10%)
- **Correo:** Nodemailer / Gmail SMTP

---

## Rutas Públicas y de Cliente

- [/](/) — Página de inicio: hero, propuesta de valor para contratistas, productos destacados y secciones de misión/visión.
- [/catalog](/catalog) — Catálogo completo de más de 577 productos con búsqueda por texto, filtros por categoría y paginación.
- [/product/:id](/product/:id) — Ficha de producto: especificaciones técnicas, precio con IVA incluido (16%), reseñas y botón "Agregar al carrito".
- [/cart](/cart) — Carrito de compras con subtotal, IVA (16%) y acceso al flujo de cotización formal.
- [/shipping](/shipping) — Selección de dirección de entrega y cálculo de tarifas de envío reales en tiempo real (Skydropx).
- [/checkout](/checkout) — Revisión final del pedido, confirmación de dirección y generación de cotización formal en PDF.
- [/login](/login) — Inicio de sesión para clientes registrados.
- [/register](/register) — Registro de nuevos clientes (nombre, correo, teléfono, contraseña).
- [/profile](/profile) — Perfil del usuario: datos personales y gestión de direcciones guardadas.
- [/quotes](/quotes) — Historial de cotizaciones formales generadas por el contratista o empresa autenticada.

## Páginas Legales

- [/aviso-de-privacidad](/aviso-de-privacidad) — Aviso de Privacidad (LFPDPPP México).
- [/politica-de-ventas](/politica-de-ventas) — Política de Ventas y devoluciones.
- [/terminos-y-condiciones](/terminos-y-condiciones) — Términos y Condiciones de uso.

## Panel de Administración (rutas protegidas)

- [/admin](/admin) — Dashboard: resumen de ingresos reales, cotizaciones por estado y métricas de actividad.
- [/admin/products](/admin/products) — Gestión del catálogo: crear, editar, activar/desactivar y eliminar productos.
- [/admin/users](/admin/users) — Gestión de usuarios: clientes y administradores, control de acceso y generación de invitaciones.
- [/admin/quotes](/admin/quotes) — Listado de todas las cotizaciones con filtros por estado (pendiente / completada / cancelada) y cambio de estado inline.
- [/admin/login](/admin/login) — Portal de acceso exclusivo para administradores.
- [/register-admin](/register-admin) — Registro de nuevos administradores mediante token de invitación de un solo uso.

## API Endpoints Principales

- `POST /api/auth/register` — Registro de cliente
- `POST /api/auth/login` — Autenticación y emisión de JWT
- `GET /api/products` — Listado del catálogo con filtros
- `GET /api/products/:id` — Detalle de producto
- `GET/PUT /api/cart` — Carrito persistente del usuario
- `GET/POST /api/addresses` — Gestión de direcciones
- `POST /api/quotes` — Creación de cotización formal (dispara emails automáticos al cliente y a la empresa)
- `GET /api/quotes` — Historial de cotizaciones del contratista
- `GET /api/shipping/rates` — Tarifas de envío por destino (Skydropx Pro)
- `PATCH /api/quotes/:id` — (Admin) Cambio de estado de cotización
- `GET /api/admin/users` — (Admin) Lista de usuarios