Initial commit: mini-erp (backend FastAPI + frontend React/Vite)

Base para el flujo de ramas por cliente.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

mini-backend/logger_config.py

@@ -0,0 +1,85 @@
+import os
+import logging
+import json
+import sys
+from datetime import datetime, timezone
+from context import get_request_id, get_current_user  # Importamos las funciones
+from logging.handlers import RotatingFileHandler
+
+
+# ============================================================================
+class JsonFormatter(logging.Formatter):
+    """Formateador personalizado para exportar logs en formato JSON puro."""
+    EXTRA_FIELDS = ("http_method", "endpoint", "status_code")
+
+    def format(self, record):
+        user = get_current_user()
+        log_record = {
+            "timestamp": datetime.fromtimestamp(record.created, tz=timezone.utc).isoformat(),
+            "level": record.levelname,
+            "request_id": get_request_id(),  # ⚡️ Inyección automática del ID de rastreo
+            "webUser": user["webUser"],
+            "emp_id": user["emp_id"],
+            "full_name": user["full_name"],
+            "message": record.getMessage(),
+            "module": record.module,
+            "function": record.funcName,
+            "line": record.lineno
+        }
+        for field in self.EXTRA_FIELDS:
+            if hasattr(record, field):
+                log_record[field] = getattr(record, field)
+        # Si el log incluye excepciones, las añade al JSON
+        if record.exc_info:
+            log_record["exception"] = self.formatException(record.exc_info)
+        return json.dumps(log_record, ensure_ascii=False)
+
+
+# ============================================================================
+def setup_logging(environment: str = "production"):
+    """Configura el logger global de la aplicación."""
+    root_logger = logging.getLogger()
+    
+    # Evita duplicar logs si la función se ejecuta más de una vez
+    if root_logger.hasHandlers():
+        root_logger.handlers.clear()
+
+    # Definir el nivel mínimo de captura (INFO por defecto)
+    root_logger.setLevel(logging.INFO)
+
+    # Handler para la consola (Standard Output)
+    console_handler = logging.StreamHandler(sys.stdout)
+
+    if environment == "production":
+        # En producción usamos JSON estructurado
+        console_handler.setFormatter(JsonFormatter())
+    else:
+        # En desarrollo usamos texto limpio y con colores opcionales
+        readable_formatter = logging.Formatter(
+            fmt="%(asctime)s [%(levelname)s] %(module)s.%(funcName)s:%(lineno)d - %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S"
+        )
+        console_handler.setFormatter(readable_formatter)
+
+    root_logger.addHandler(console_handler)
+
+    # 2. CREAR CARPETA Y ARCHIVO FÍSICO EN DISCO
+    log_dir = "logs"
+    if not os.path.exists(log_dir):
+        os.makedirs(log_dir) # Crea la carpeta 'logs/' si no existe
+
+    # Usamos 'RotatingFileHandler' para que el archivo no crezca infinitamente.
+    # Cuando llegue a 5MB, lo cierra, lo renombra a backend.log.1 y crea uno nuevo.
+    file_handler = RotatingFileHandler(
+        filename=os.path.join(log_dir, "backend.log"),
+        maxBytes=5 * 1024 * 1024,  # 5 Megabytes
+        backupCount=3,             # Mantener máximo 3 archivos viejos de respaldo
+        encoding="utf-8"
+    )
+    file_handler.setFormatter(JsonFormatter())
+    root_logger.addHandler(file_handler)
+
+
+    # Silenciar logs ruidosos de librerías externas (opcional)
+    logging.getLogger("uvicorn.access").setLevel(logging.WARNING)
+# ============================================================================