mini-erp/mini-backend/docs/index.md

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

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	Componentes, dependencias, middlewares, APIs
Flujo de Autenticación	Login, logout, sesiones, middleware
Proxy SAP	Enrutamiento a SAP, re-autenticación, OData
API Reference	Todos los endpoints, ejemplos request/response
Visualización de logs	Cómo leer logs/backend.log con jq/lnav