"""Configuración central: todo lo que cambia entre entornos sale del archivo .env.""" from functools import lru_cache from pydantic import SecretStr, field_validator, model_validator from pydantic_settings import BaseSettings, SettingsConfigDict class Settings(BaseSettings): model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8", extra="ignore") # Almacenamiento # local = carpeta del servidor (disco propio o unidad montada) # smb = la API se conecta a un recurso compartido SMB (Samba/NAS) con usuario y clave storage_type: str = "local" storage_root: str = "./almacenamiento" # solo para storage_type=local # Conexión SMB (solo para storage_type=smb) smb_server: str = "" # IP o nombre del servidor SMB / NAS smb_share: str = "" # nombre del recurso compartido smb_base_path: str = "" # subcarpeta dentro del recurso (opcional) smb_username: str = "" smb_password: SecretStr = SecretStr("") # SecretStr: nunca se imprime en logs ni errores smb_domain: str = "" # dominio o nombre del equipo si la cuenta es local smb_port: int = 445 smb_encrypt: bool = True # cifra el tráfico (SMB 3) smb_timeout: int = 15 # Carpetas que la API NUNCA devuelve, aunque FSCrawler las haya indexado # (rutas relativas a la raíz, separadas por coma). Lo ideal es excluirlas también # en FSCrawler (fs.excludes); esto es una segunda barrera. exclude_folders: str = "" # Elasticsearch (lo alimenta FSCrawler) es_url: str = "https://localhost:9200" es_index: str = "archivos" # el "name" del job de FSCrawler es_username: str = "" es_password: SecretStr = SecretStr("") es_api_key: SecretStr = SecretStr("") # alternativa a usuario/clave es_ca_cert: str = "" # ruta al http_ca.crt de Elasticsearch 8 (recomendado) es_verify_tls: bool = True # False solo para pruebas: no verifica el certificado es_timeout: int = 10 # Base de datos (solo para los logs de búsquedas y descargas) database_url: str = "sqlite:///./api_archivos.db" # Seguridad jwt_secret: str = "cambiar-este-secreto" jwt_algorithm: str = "HS256" download_secret: str = "cambiar-este-otro-secreto" download_link_ttl_minutes: int = 30 allowed_roles: str = "admin,rrhh" # URLs / descargas public_base_url: str = "http://localhost:8000" download_mode: str = "direct" # direct | nginx nginx_internal_prefix: str = "/protegido/" cors_origins: str = "http://localhost" log_file: str = "logs/api_archivos.log" @field_validator("download_mode") @classmethod def _modo_valido(cls, v: str) -> str: v = v.lower().strip() if v not in {"direct", "nginx"}: raise ValueError("DOWNLOAD_MODE debe ser 'direct' o 'nginx'") return v @field_validator("storage_type") @classmethod def _tipo_valido(cls, v: str) -> str: v = v.lower().strip() if v not in {"local", "smb"}: raise ValueError("STORAGE_TYPE debe ser 'local' o 'smb'") return v @model_validator(mode="after") def _coherencia(self) -> "Settings": if self.storage_type == "smb": faltan = [n for n in ("smb_server", "smb_share", "smb_username") if not getattr(self, n)] if not self.smb_password.get_secret_value(): faltan.append("smb_password") if faltan: raise ValueError(f"Con STORAGE_TYPE=smb faltan: {', '.join(f.upper() for f in faltan)}") if self.download_mode == "nginx": # Nginx no puede leer una carpeta SMB que no está montada raise ValueError("DOWNLOAD_MODE=nginx no es compatible con STORAGE_TYPE=smb; usá direct") return self # Helpers para convertir las listas separadas por coma @property def carpetas_excluidas(self) -> list[str]: """'DATOS POLICIA, INFORMATICA/claves' -> ['DATOS POLICIA', 'INFORMATICA/claves'] (se respeta mayúsculas/minúsculas: en Linux las rutas las distinguen).""" return [c.strip().strip("/") for c in self.exclude_folders.split(",") if c.strip()] @property def roles_permitidos(self) -> set[str]: return {r.strip().lower() for r in self.allowed_roles.split(",") if r.strip()} @property def origenes_cors(self) -> list[str]: return [o.strip() for o in self.cors_origins.split(",") if o.strip()] @lru_cache def get_settings() -> Settings: return Settings()