VeriFactuDev

@RestController InvoiceController

@PostMapping("/api/v1/invoices")
public ResponseEntity<InvoiceResult> create(@RequestBody InvoiceDTO invoice) {
    // 1. Recibe datos crudos desde la App
    // 2. Valida formato básico
    // 3. Llama al servicio asíncrono
    return ResponseEntity.ok(invoiceService.process(invoice));
}

El controlador debe ser ligero. Su única función es recibir la petición HTTP y delegar. No realiza cálculos.

@Service InvoiceService

@Transactional
public InvoiceResult process(InvoiceDTO data) {
    // 1. Recuperar Hash Anterior (Encadenamiento)
    String prevHash = repo.findLastHash();
    
    // 2. Generar Huella
    String newHash = hashGenerator.getHashNew(data, prevHash);
    
    // 3. Firmar (Si es TicketBAI)
    String signature = signer.sign(newHash, keyManager.getPrivKey());
    
    // 4. Guardar estado "PENDIENTE_ENVIO"
    repo.save(new InvoiceEntity(data, newHash, signature));
    
    // 5. Disparar envío asíncrono
    eventPublisher.publish(new SendInvoiceEvent(id));
}

El corazón del sistema. Garantiza que la factura se guarde y se encadene antes de intentar enviarla.

Component: KeyManager & Signer

Integra tus clases existentes:

• HashGenerator.java: Implementa SHA-256.
• Signer.java: Usa SHA256withRSA.
• KeyManager.java: Carga el .p12 desde volumen seguro.

Transport Strategy

Patrón "Strategy" para elegir protocolo:

public interface FiscalSender {
    void send(Invoice inv);
}

// Para AEAT (Nacional)
public class VerifactuSoapSender implements FiscalSender { ... }

// Para Bizkaia (Batuz)
public class TicketBaiRestSender implements FiscalSender { ... }

Esto permite añadir nuevas haciendas (Navarra, Álava) sin tocar el código principal.

Persistence Layer

Schema PostgreSQL vital para integridad:

TABLE invoices (
    id SERIAL PRIMARY KEY,
    chain_hash VARCHAR(64) NOT NULL,
    prev_hash VARCHAR(64) NOT NULL,
    signature TEXT,
    status VARCHAR(20) DEFAULT 'PENDING', -- PENDING, SENT, ERROR
    aeat_csv VARCHAR(100), -- Código Seguro Verificación devuelto
    retry_count INT DEFAULT 0
);