# Hazard Odoo & Shopify Connector

Este repositorio aloja la infraestructura, configuración y módulos personalizados (Addons) para el ERP Odoo 16 de **Hazard**, enfocado en la marca de ropa urbana. El núcleo de este proyecto es su integración bidireccional y reactiva con el eCommerce en **Shopify**.

## 🚀 Arquitectura del Proyecto

El sistema se ejecuta en un VPS mediante Docker Compose, incluyendo:
* **Odoo 16** (`hazard-odoo-odoo`): Contenedor custom basado en Odoo Community, inyectado con módulos Enterprise.
* **PostgreSQL 17** (`odoo-16-db-hazard-new`): Base de datos en el puerto interno `5432`.

### Módulos Customizados (`/Addons/custom/`)
* **`hazard_shopify`**: El conector principal de más de 4500 líneas. Maneja inventario reactivo (colas asíncronas), importación de pedidos B2C, fulfillment automatizado, traslados BOPIS (retiro en tienda), cálculos de reembolsos y gestión de catálogo (excluyendo estrictamente el flujo B2B y Maquila).
* **`hazard_inventory_report`**: Módulo para emisión de reportes especializados.

---

## 🤖 Automatización y Agentes IA (MCP)

Este repositorio está preparado para el futuro con **Model Context Protocol (MCP)**, permitiendo a los agentes de Inteligencia Artificial operar directamente sobre la lógica de negocio, bases de datos y APIs externas de manera segura:

1. **`odoo-mcp-hazard/`**
   Servidor MCP en Python (ejecutado vía `uv`) que conecta con la API XML-RPC de Odoo. 
   *Herramientas:* `odoo_search_read`, `odoo_create`, `odoo_write`, `odoo_execute_method`.

2. **`shopify-mcp/`**
   Servidor MCP en Node.js que interactúa directamente con la API REST de la tienda Shopify para comprobación en tiempo real de transacciones, órdenes e inventario base.

3. **PostgreSQL MCP**
   Conexión de lectura SQL directa a la base de datos interna `hazard_new` para minería y auditoría rápida.

---

## 📜 Reglas del Proyecto y Desarrollo

Toda la documentación técnica profunda, decisiones de arquitectura (como la lógica de nombrado de SKU, diccionarios de tallas/colores) y reglas estrictas para Inteligencias Artificiales se encuentran centralizadas en el archivo de personalización.

👉 **Por favor consulta [`.agents/AGENTS.md`](.agents/AGENTS.md) antes de proponer o realizar cualquier cambio al código base.**