Sistema de Tarifas de Vidrio - Perfex AI
Inicio Documentación Módulo AI Documento

Sistema de Tarifas de Vidrio - Perfex AI

MD 9 secciones
Resumen

Documentación interna del módulo Perfex AI [hash:35df87c43b6207692b3b4e34e8ef65e5]

# Sistema de Tarifas de Vidrio - Perfex AI

Sección 1
**Controlador:** `Glass_tariffs.php` | **Librería:** `Glass_pricing_engine.php`

---

## Propósito

Sección 2
Gestión completa de productos de vidrio: catálogo, proveedores, fabricantes, recargos, reglas de precio y cálculo automático de presupuestos. Integrado con la IA para que el chat pueda calcular precios bajo demanda.

## Tablas de Base de Datos

Sección 3
| Tabla | Descripción |
|-------|-------------|
| `tblperfex_ai_glass_products` | Catálogo de productos (tipo, espesor, precio/m²) |
| `tblperfex_ai_glass_suppliers` | Proveedores de vidrio |
| `tblperfex_ai_glass_manufactures` | Fabricantes/marcas |
| `tblperfex_ai_glass_surcharges` | Recargos sobre precio base (%, fijo) |
| `tblperfex_ai_glass_rules` | Reglas de pricing |
| `tblperfex_ai_glass_synonyms` | Sinónimos de nombres de producto |
| `tblperfex_ai_glass_validations` | Reglas de validación |
| `tblperfex_ai_glass_preferred_suppliers` | Proveedor preferido por producto |
| `tblperfex_ai_glass_import_log` | Historial de importaciones CSV/PDF |

## Vistas (10 archivos)

Sección 4
- `products.php` / `product_form.php` - Listado y formulario de productos
- `suppliers.php` / `supplier_form.php` - Listado y formulario de proveedores
- `manufactures.php` / `manufacture_form.php` - Listado y formulario de fabricantes
- `surcharges.php` / `surcharge_form.php` - Listado y formulario de recargos
- `import.php` - Importación de CSV y PDFs
- `extract_manufactures.php` - Extracción de fabricantes desde PDFs (Gemini Vision)
- `settings.php` - Configuración de tarifas

## Settings de Tarifas

Sección 5
| Setting | Descripción | Default |
|---------|-------------|---------|
| `glass_tariffs_enabled` | Módulo activo | 0 |
| `glass_currency` | Moneda (EUR/USD) | EUR |
| `glass_default_margin` | Margen por defecto (%) | - |
| `glass_iva_percent` | IVA (%) | - |
| `glass_min_area_m2` | Área mínima facturable (m²) | - |
| `glass_price_decimals` | Decimales en precios | - |

## Motor de Precios (Glass_pricing_engine)

Sección 6
El `Glass_pricing_engine.php` calcula precios considerando:

1. **Precio base** del producto (€/m²)
2. **Área** calculada desde dimensiones (ancho x alto)
3. **Área mínima**: Si el área es menor que `glass_min_area_m2`, se usa el mínimo
4. **Recargos**: Porcentuales o fijos según tipo de vidrio, espesor, etc.
5. **Margen**: Porcentaje de beneficio configurable
6. **IVA**: Aplicado al final

### CSV

Sección 7
- Importar catálogos de productos desde archivos CSV
- Mapeo de columnas flexible
- Log en `tblperfex_ai_glass_import_log`

### PDF (con IA)

Sección 8
- `Pdf_tariff_parser.php` usa Gemini Vision para extraer tablas de tarifas de PDFs
- Extrae: producto, espesor, precio, fabricante
- Proceso semi-automático con revisión del usuario

## Documentos Relacionados

Sección 9
- [Arquitectura](modulo_arquitectura.md) - Estructura general
- [Configuración](modulo_configuracion.md) - Settings glass_*
- [Knowledge Base](modulo_knowledge_base.md) - Tarifas indexadas en KB