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

Backend — Documentación del Proyecto

Backend de integración entre el frontend mini-frontend (React 19 + TypeScript + Vite) y SAP Business One Service Layer. Actúa como proxy/middleware autenticando empleados, gestionando sesiones y enrutando operaciones CRUD hacia SAP. Este proyecto vive junto al frontend dentro del monorepo mini-erp (ver CLAUDE.md en la raíz del repo).

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[mini-frontend - React + Vite]
    end

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

    subgraph "SAP Business One"
        SL[Service Layer\nREST API]
        AG[API Gateway\nCrystal Reports]
        DB[(SAP DB / HANA)]
    end

    F -->|HTTP /api/*| API
    API -->|HTTP /b1s/v1| SL
    API -->|HTTP rs/v1/*| AG
    API -->|SQL directo| DB
    SL --> DB
    AG --> 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
Diseño de logging	Contexto de usuario/request, formato JSON
Visualización de logs	Cómo leer logs/backend.log con jq/lnav