# Backend SN — Documentación del Proyecto

Backend de integración entre una aplicación frontend (Next.js) y **SAP Business One Service Layer**. Actúa como proxy/middleware autenticando empleados, gestionando sesiones y enrutando operaciones CRUD hacia SAP.

## Stack Tecnológico

| Componente    | Tecnología        |
| ------------- | ----------------- |
| Framework     | FastAPI (Python)  |
| Servidor ASGI | Uvicorn           |
| HTTP Client   | `requests`        |
| Logging       | JSON estructurado |
| Sesiones      | In-memory         |

## Diagrama de Contexto del Sistema

```mermaid
graph TB
    subgraph "Frontend"
        F[App SN - Next.js]
    end

    subgraph "Backend SN - FastAPI"
        API[API Proxy\n:8000]
    end

    subgraph "SAP Business One"
        SL[Service Layer\nREST API]
        DB[(SAP DB\nSBO_PRUEBA_*)]
    end

    F -->|HTTP /api/*| API
    API -->|HTTP /b1s/v1| SL
    SL --> DB
```

## Documentos

| Documento                                    | Descripción                                  |
| -------------------------------------------- | -------------------------------------------- |
| [Arquitectura](architecture.md)              | Componentes, dependencias, middlewares, APIs |
| [Flujo de Autenticación](auth-flow.md)       | Login, logout, sesiones, middleware          |
| [Proxy SAP](sap-proxy.md)                    | Enrutamiento a SAP, re-autenticación, OData  |
| [API Reference](api-reference.md)            | Todos los endpoints, ejemplos request/response |
| [Visualización de logs](logs-viewing.md)     | Cómo leer `logs/backend.log` con `jq`/`lnav` |