# Nota Técnica: Storage No Tributario

Fecha: 2026-04-08

## Estado actual

La normalización de storage por tenant ya se aplicó para archivos tributarios usando ruta canónica por tenant con fallback de lectura:

- `pdf`
- `signed`
- `cdr`
- `unsigned`

Los módulos no tributarios siguen apuntando al disk plano `tenant` (`storage/app/tenant`) en varios puntos del código, por ejemplo:

- `payment_files`
- `document_payment`
- `sale_opportunity_files`
- `purchase_order_attached`
- `guide_files`

## Hallazgos en producción

En la revisión de los 11 tenants activos no se encontraron registros activos ni archivos físicos en producción para:

- `payment_files`
- `document_payment`
- `sale_opportunity_files`
- `purchase_order_attached`
- `guide_files`

Eso significa que hoy no existe una urgencia operativa en esta segunda fase. La deuda es preventiva, no correctiva.

## Decisión

Por ahora se deja sin cambios.

Motivo:

- no hay uso real actual en producción en esas rutas
- la parte crítica de facturación ya quedó protegida
- cambiar esto ahora no aporta valor inmediato

## Recomendación futura

Si estos módulos empiezan a usarse más, aplicar el mismo patrón de tributarios:

1. ruta canónica por tenant
2. fallback de lectura a la ruta plana antigua
3. normalización por copia, no por move

## Exclusión explícita

No mezclar en esta fase el directorio:

- `storage/app/certificates`

Ese storage sigue siendo sensible para facturación y debe tratarse aparte.