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
**Controlador:** `Glass_tariffs.php` | **Librería:** `Glass_pricing_engine.php`
---
---
## Propósito
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
| 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 |
|-------|-------------|
| `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)
- `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
- `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
| 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 | - |
|---------|-------------|---------|
| `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)
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
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
- Importar catálogos de productos desde archivos CSV
- Mapeo de columnas flexible
- Log en `tblperfex_ai_glass_import_log`
- Mapeo de columnas flexible
- Log en `tblperfex_ai_glass_import_log`
### PDF (con IA)
- `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
- Extrae: producto, espesor, precio, fabricante
- Proceso semi-automático con revisión del usuario
## Documentos Relacionados
- [Arquitectura](modulo_arquitectura.md) - Estructura general
- [Configuración](modulo_configuracion.md) - Settings glass_*
- [Knowledge Base](modulo_knowledge_base.md) - Tarifas indexadas en KB
- [Configuración](modulo_configuracion.md) - Settings glass_*
- [Knowledge Base](modulo_knowledge_base.md) - Tarifas indexadas en KB