# FastPresupuesto

Plugin para crear presupuestos rápidos sin seleccionar un cliente real en el formulario, manteniendo compatibilidad con la lógica interna de FacturaScripts.

## Para Usuarios

## Qué hace
- Añade un botón **Nuevo presupuesto rápido** en `ListPresupuestoCliente`.
- Abre un modal para introducir:
- Nombre
- Teléfono
- Email
- Crea un `PresupuestoCliente` directamente y abre su edición.

## Flujo funcional
1. Entras en **Ventas > Presupuestos**.
2. Pulsas **Nuevo presupuesto rápido**.
3. Rellenas nombre, teléfono y email.
4. Se crea el presupuesto y se abre en edición.

## Restricción importante
- El plugin usa un cliente técnico (`FASTPRES`) para cumplir requisitos internos del ERP.
- Si un documento con ese cliente se intenta cerrar en estado no editable (caso factura), se bloquea y se pide asignar cliente real.

## Qué verás en el presupuesto
Cuando el cliente del documento es `FASTPRES`, en cabecera aparecen inputs destacados (borde rojo) para:
- Nombre
- Teléfono
- Email

## Para Técnicos

## Objetivo técnico
Permitir creación rápida con datos de contacto, sin romper:
- `SalesDocument::getSubject()`
- `Calculator::apply()`
- flujo estándar de guardado/estados

## Estrategia
En vez de dejar `codcliente` vacío (incompatible con cálculos y validaciones), se usa un cliente técnico fijo:
- `Init::TECHNICAL_CUSTOMER_CODE = FASTPRES`

## Implementación por archivos

### `Init.php`
- Registra extensiones de:
- `Extension\Controller\ListPresupuestoCliente`
- `Extension\Model\PresupuestoCliente`
- `Extension\Model\FacturaCliente`
- Registra `SalesHeaderHTMLMod`.
- En `update()` crea el cliente técnico si no existe.

### `Extension/Controller/ListPresupuestoCliente.php`
- Añade botón/modal de alta rápida.
- Acción `create-fast-presupuesto`:
- Valida token.
- Valida nombre obligatorio.
- Valida formato email.
- Crea presupuesto con cliente técnico.
- Guarda contacto en campos custom y en campos espejo del documento.

### `Extension/Model/PresupuestoCliente.php`
- `testBefore()` para presupuesto rápido:
- sanea datos.
- valida nombre y email.
- sincroniza campos espejo.

### `Mod/SalesHeaderHTMLMod.php`
- Solo actúa si `modelClassName() === PresupuestoCliente` y cliente `FASTPRES`.
- Renderiza inputs custom (nombre/teléfono/email) en cabecera.
- Aplica cambios y sincroniza espejo al guardar.

### `Extension/Model/FacturaCliente.php`
- Bloquea guardado en estado no editable si el cliente sigue siendo `FASTPRES`.

### `Table/presupuestoscli.xml`
Añade columnas propias del plugin:
- `contacto_telefono` (`varchar(20)`)
- `contacto_email` (`varchar(150)`)

## Mapeo de datos

### Campos de trabajo (plugin)
- `nombrecliente`
- `contacto_telefono`
- `contacto_email`

### Campos espejo (documento estándar)
Para que salga correctamente en el PDF estándar sin tocar Core:
- `direccion` <= `contacto_email`
- `provincia` <= `contacto_telefono`

`PDFDocument` imprime `nombrecliente` y bloque de dirección (`direccion`, `provincia`, etc.), por eso se usa este espejo.

## Traducciones
- Archivo: `Translation/es_ES.json`
- Constantes PHP: `Lib/TransKeys.php`
- En XML se usan directamente keys de traducción.

## Calidad de código
El plugin incluye configuración local:
- `phpstan` nivel 5 + strict rules
- `php-cs-fixer`
- scripts en `composer.json`

Comandos (desde `Plugins/FastPresupuesto`):
- `composer run phpstan`
- `composer run cs:check`
- `composer run cs:fix`

## Notas de mantenimiento
- Si cambia la plantilla PDF base del ERP, revisar el mapeo espejo.
- Si en el futuro se quiere mostrar teléfono/email de forma nativa en PDF, hacerlo vía extensión PDF en plugin, no tocando Core.