primer commit

mini-backend/docs/sap-proxy.md

@@ -2,7 +2,7 @@
 
 ## Función Central: `forward_to_sapb1`
 
-Todas las operaciones CRUD pasan por esta función en `core/sap.py`, que actúa como proxy hacia SAP Service Layer.
+Todas las operaciones CRUD pasan por esta función en `core/sap.py`, que actúa como proxy hacia SAP Service Layer. La mayoría de los routers (`business_partners`, `items`, `sales`, `purchases`, `batch`, parte de `catalogs`) no la llaman directamente: pasan por `core/crud_router.py`, una factory que arma el `list/get/create/update` de un recurso OData y delega en `forward_to_sapb1` (ver [Arquitectura](architecture.md)). El proxy hacia el API Gateway de Crystal Reports (`core/api_gateway.py`, usado por `routers/apigateway.py`) sigue el mismo patrón de sesión-global + reintento en 401, mostrado más abajo bajo "Otros proxies".
 
 ```mermaid
 flowchart TD
@@ -116,3 +116,15 @@ sequenceDiagram
 | Error de red            | Lanza `ConnectionError`                                    |
 | Reintento también falla | Lanza `HTTPException` con el mensaje de error SAP          |
 | SAP no disponible       | `HTTPException(500)`                                       |
+
+## Otros proxies (fuera de Service Layer)
+
+| Proxy | Módulo | Sesión | Consumido por |
+| ----- | ------ | ------ | -------------- |
+| API Gateway (Crystal Reports, `rs/v1/*`) | `core/api_gateway.py` (`forward_to_api_gateway`) | `requests.Session` con cookies, global, se re-loguea en 401 igual que el Service Layer | `routers/apigateway.py` |
+| HANA (SQL directo) | `core/hana.py` (`hana_connection`) | Sin sesión persistente: abre y cierra una conexión `hdbcli` por request | `routers/reports.py` |
+
+`core/hana.py` no pasa por `forward_to_sapb1` ni maneja OData: se usa para
+reportes que necesitan una consulta SQL puntual contra HANA (por ejemplo,
+armar el detalle de una guía de remisión para imprimir stickers) en vez de
+paginar un recurso del Service Layer.