🎉 Initial commit - Hazard Odoo 16 project

- Custom modules: hazard_shopify, hazard_inventory_report, hazard_website
- Third-party modules: bi_sql_editor, query_deluxe, sql_request_abstract, l10n_mx_sat_sync_itadmin_ee
- Docker setup: Odoo 16 + PostgreSQL 17
- Utility scripts: backup_hazard.sh, update_module.py
- Agent configuration: .agents/AGENTS.md
- Security: Enterprise modules, credentials, backups and production data excluded via .gitignore

fase_1_retail_mvp.md

@@ -0,0 +1,87 @@
+# Propuesta de Implementación: Fase 1 - MVP Retail y Logística (Hazard)
+
+Esta propuesta técnica detalla cómo estructurar una salida a producción rápida y segura en **Fase 1**, enfocándose exclusivamente en el **flujo retail y logística de envíos**, posponiendo la facturación fiscal SAT y conciliación contable avanzada para una **Fase 2**.
+
+---
+
+## 💡 ¿Es viable facturar "por fuera" de Odoo?
+**Totalmente, y de hecho es una estrategia sumamente recomendada para acelerar el Go-Live.**
+
+En Odoo, que la facturación se realice externamente (mediante portales, sistemas contables heredados como Aspel/Contpaqi o facturación directa en el SAT) **no genera ningún problema técnico ni operativo**.
+
+### ¿Cómo se gestiona esto en Odoo?
+1. **Flujo Sin Factura Fiscal:** Odoo procesará el pedido (`sale.order`) y la orden de entrega (`stock.picking`) para rebajar el stock e inyectar la guía a Shopify. La transacción se queda registrada a nivel comercial/operativo.
+2. **Facturas Internas en Odoo (Opcional - Recomendado):** Se pueden generar las facturas dentro de Odoo para tener reportes de ventas y cuentas por cobrar internos, pero **sin timbrarlas fiscalmente** (sin llamar a la API del SAT ni consumir timbres fiscales). Esto permite llevar una pre-contabilidad en Odoo mientras la facturación oficial sigue en su sistema habitual.
+3. **Reducción de Riesgos:** Al remover la dependencia de los certificados digitales (CSD), códigos SAT y validaciones de impuestos del SAT, eliminamos el Eje 1 por completo, eliminando bloqueos técnicos y permitiendo una puesta en marcha inmediata.
+
+---
+
+## 🎯 Enfoque de Fase 1: El Flujo Retail MVP
+Para esta primera etapa, el objetivo prioritario es que **la operación de venta en línea y despacho físico funcione como un reloj**. 
+
+### 🔄 El Flujo Crítico de Fase 1:
+```
+[Compra Cliente en Shopify]
+          │
+          ▼
+[Odoo: Descarga Automática de Pedido (Sale Order)]
+          │
+          ▼
+[Odoo Almacén: Se genera Orden de Salida (Stock Picking)]
+          │
+          ▼
+[Odoo Logística: Generación de Guía DHL/FedEx y Etiqueta PDF]
+          │
+          ▼
+[Odoo: Validación de Salida e Inyección de Guía a Shopify (Fulfillment)]
+          │
+          ▼
+[Shopify: Envía correo con rastreo al cliente final]
+```
+
+---
+
+## 📅 Cronograma Reducido: Fase 1 (MVP Retail & Logística)
+
+Al concentrarnos únicamente en el flujo retail y operativo, **el tiempo de implementación se reduce a la mitad**:
+
+```mermaid
+gantt
+    title Cronograma Fase 1 - MVP Retail y Logística
+    dateFormat  YYYY-MM-DD
+    section Eje 1: Logística
+    Integración DHL/FedEx/Estafeta       :active, des1, 2026-05-21, 4d
+    section Eje 2: Flujo ERP
+    Workflow Ventas & Almacén            : des2, after des1, 3d
+    section Eje 3: Datos
+    Inventario Inicial Real             : des3, after des2, 2d
+    section Eje 4: Capacitación
+    UAT & Capacitación Operativa        : des4, after des3, 4d
+    Acompañamiento Go-Live               : des5, after des4, 2d
+```
+
+### Detalle de Tareas - Fase 1:
+
+| Tarea de Fase 1 | Duración | Descripción / Alcance |
+| :--- | :---: | :--- |
+| **1. Integración Logística** | **3 - 4 días** | Configuración de conectores DHL/FedEx en Odoo para obtener tarifas, guías y PDFs de etiquetas automáticas. |
+| **2. Flujo de Pedidos y Almacén** | **2 - 3 días** | Configuración del flujo de pedidos de venta: cuando el pedido de Shopify se descargue pagado, Odoo lo confirma y genera el albarán de salida en estado "Listo para procesar" de inmediato. |
+| **3. Carga de Inventario Inicial** | **2 días** | Corte físico de inventario. Carga inicial del stock en Odoo y sincronización de cantidades masivas a Shopify para alinear ambos sistemas por primera vez. |
+| **4. Pruebas y Capacitación** | **3 - 4 días** | Simulaciones reales de compra y envío con el equipo de almacén y ventas. Capacitación práctica de despacho y picking. |
+| **5. Soporte en Lanzamiento** | **2 días** | Acompañamiento operativo los primeros días de envíos en vivo. |
+| **TOTAL ESTIMADO FASE 1** | **12 - 15 días hábiles** | **~2.5 a 3 Semanas de Calendario** |
+
+---
+
+## 🚀 Plan de Crecimiento (Fases Posteriores)
+
+Una vez que la bodega y la tienda en línea estén sincronizadas y operando sin fricción, se pueden ir agregando los demás módulos de manera controlada:
+
+### 📅 Fase 2: Contabilidad e Impuestos (A los 1-2 meses del Go-Live)
+* **Localización SAT Mexicana:** Configuración de impuestos IVA, retenciones, cuentas contables oficiales y CSD para timbrado.
+* **Timbrado de Facturas:** Habilitación del timbrado CFDI 4.0 directamente en Odoo, ya sea automático al importar el pedido o en lotes al final del día.
+* **Conciliación de Pasarelas:** Integración del flujo contable de depósitos bancarios de Mercado Pago, PayPal y Shopify Payments.
+
+### 📅 Fase 3: Abastecimiento Inteligente (A los 3-4 meses)
+* **Reglas de Reordenamiento:** Puntos de stock mínimo para generar borradores de órdenes de compra (RFQ) de forma automática.
+* **Costeo y Margen:** Carga de costos reales de compra/importación para reportes exactos de rentabilidad y valuación de inventario en tiempo real.