# Corrección runtime Laravel en appife sobre fasicat_cukpos

## Causa real

La API FE está apuntando a la base `fasicat_cukpos`, pero el `.env` tiene Laravel usando almacenamiento en base de datos para cache/sesiones/colas:

```env
CACHE_STORE=database
SESSION_DRIVER=database
QUEUE_CONNECTION=database
```

Cuando `Spatie Laravel Data` intenta leer su cache, Laravel consulta la tabla `cache`. Como `fasicat_cukpos.cache` no existe, la ruta `/api/v1/documentos/add` falla antes de completar la emisión:

```text
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'fasicat_cukpos.cache' doesn't exist
```

## Corrección aplicada

Se agregan defaults seguros para una API:

```php
config/cache.php   => default file
config/session.php => default file
config/queue.php   => default sync
```

Importante: si el `.env` ya define `CACHE_STORE=database`, `SESSION_DRIVER=database` o `QUEUE_CONNECTION=database`, esos valores siguen teniendo prioridad. Por eso se incluye también el SQL de tablas runtime.

## SQL obligatorio si el `.env` queda en database

Ejecutar en `fasicat_cukpos`:

```sql
appife/sql/20260704_appife_laravel_runtime_tables.sql
```

Crea, si faltan:

- `cache`
- `cache_locks`
- `sessions`
- `jobs`
- `job_batches`
- `failed_jobs`

## Recomendación para appife en producción POS

Para respuesta rápida desde caja/POS:

```env
CACHE_STORE=file
SESSION_DRIVER=file
QUEUE_CONNECTION=sync
FE_SYNC_SEND_TO_HACIENDA=false
```

Luego ejecutar:

```bash
php artisan optimize:clear
php artisan config:clear
php artisan cache:clear
```

Si no hay SSH, cambiar `.env`, subir los archivos, ejecutar el SQL y reiniciar PHP-FPM/OPcache desde el hosting si está disponible.