# Quickstart: Contratos MultiCliente MultiPunto

**Feature**: `007-contratos-multicliente-multipunto` | **Date**: 2026-05-28

## Prerrequisitos

- Features **005** y **006** implementadas (modelos suministro + patrones).
- BD secundaria con contratos `TipProCom = 3`.
- `AGENT_CAPABILITY_AGENT_DATABASE=true`

```bash
php artisan cache:forget agent_database_queries_catalog
```

## Preguntas de prueba — Listado

| # | Pregunta | Esperado |
|---|----------|----------|
| 1 | "Lista los contratos multicliente multipunto" | Solo TipProCom=3; representante + cliente empresa + suministro |
| 2 | "Contratos del representante [NIF]" | Filtro por contacto |
| 3 | "Contratos del cliente empresa [nombre]" | Filtro por Cliente vinculado |
| 4 | "Detalle de suministro del contrato [id]" | CUPS, tarifas, potencias |

## Preguntas de prueba — Agregación

| # | Pregunta | Esperado |
|---|----------|----------|
| 5 | "¿Cuántos contratos multicliente por localidad de suministro?" | COUNT exacto; sin "lista truncada" |
| 6 | "¿Cuántos por localidad y mes?" | Dos dimensiones |
| 7 | "Consumo eléctrico total por tarifa en multicliente" | SUM agrupado |
| 8 | "¿Cuántos contratos por representante?" | Top-N + hay_mas |

## Verificación

1. Listados no limitados a 50 filas del catálogo general.
2. Agregados con `truncated: false`.
3. Contacto sin cliente empresa: columnas empresa vacías/"Sin dato", sin inventar datos.

## Comandos

```bash
php artisan test --filter=ContratosMulticliente
vendor/bin/pint --dirty
```