Commit Inicial

app/clientes/__init__.py

@@ -0,0 +1,12 @@
+from .base import ClienteBase, ClienteConfig, HolmesCliente
+from .registry import get_cliente, listar, obter, registrar
+
+__all__ = [
+    "ClienteBase",
+    "ClienteConfig",
+    "HolmesCliente",
+    "get_cliente",
+    "listar",
+    "obter",
+    "registrar",
+]

app/clientes/base.py

@@ -0,0 +1,82 @@
+import os
+import tempfile
+from abc import ABC, abstractmethod
+from typing import Any
+
+from fastapi import HTTPException
+from pydantic import BaseModel
+
+
+class HolmesCliente(BaseModel):
+    """Credenciais do Holmes. Cada cliente tem a propria conta de integracao."""
+
+    token_api: str
+    usuario: str
+    senha: str
+
+
+class ClienteConfig(BaseModel):
+    """
+    Os DADOS do cliente.
+
+    Fica separado da classe de proposito: dado da pra carregar do banco,
+    classe nao. No dia que cliente novo deixar de exigir deploy, e daqui
+    que a config vai sair — o resto do codigo nao muda.
+    """
+
+    nome: str
+    razao_social: str
+    cnpj: str
+    holmes: HolmesCliente
+
+
+class ClienteBase(ABC):
+    """
+    Base de todo cliente atendido pela API.
+
+    Regra de ouro: aqui so entra o que muda de COMPORTAMENTO entre clientes.
+    Valor (CNPJ, token, id de fluxo) vai em `config`, nao em atributo de classe
+    solto — senao a heranca vira dicionario com passos extras.
+
+    A subclasse satisfaz `config` e `modulos` como atributo de classe mesmo,
+    nao precisa escrever @property.
+    """
+
+    @property
+    @abstractmethod
+    def config(self) -> ClienteConfig: ...
+
+    @property
+    @abstractmethod
+    def modulos(self) -> dict[str, Any]:
+        """Processos habilitados: {"compras": ScarduaCompras(), ...}"""
+
+    # --- comum a todos: ninguem sobrescreve ---
+
+    @property
+    def nome(self) -> str:
+        return self.config.nome
+
+    def modulo(self, nome: str) -> Any:
+        """Pega um processo habilitado do cliente, ou 404 se ele nao tem."""
+        if modulo := self.modulos.get(nome):
+            return modulo
+        raise HTTPException(
+            status_code=404,
+            detail=f"modulo '{nome}' nao habilitado para {self.nome}",
+        )
+
+    @property
+    def cache_token_holmes(self) -> str:
+        """
+        Arquivo de cache do token do Holmes, um por cliente.
+
+        Sem isso dois clientes com contas diferentes sobrescrevem o token
+        um do outro (ver _TOKEN_FILE em app/services/holmes.py).
+        """
+        return os.path.join(
+            tempfile.gettempdir(), f"holmes_token_{self.nome}.json"
+        )
+
+    def __repr__(self) -> str:
+        return f"<Cliente {self.nome}>"

app/clientes/registry.py

@@ -0,0 +1,40 @@
+import logging
+
+from fastapi import HTTPException
+
+from .base import ClienteBase
+
+_CLIENTES: dict[str, ClienteBase] = {}
+
+
+def registrar(cliente: ClienteBase) -> ClienteBase:
+    """Chamado no fim do modulo de cada cliente (app/v1/<cliente>/cliente.py)."""
+    chave = cliente.nome.lower()
+    if chave in _CLIENTES:
+        logging.warning(f"Cliente '{chave}' registrado mais de uma vez, sobrescrevendo")
+    _CLIENTES[chave] = cliente
+    return cliente
+
+
+def obter(nome: str) -> ClienteBase:
+    if cliente := _CLIENTES.get(nome.lower()):
+        return cliente
+    raise HTTPException(
+        status_code=404, detail=f"cliente '{nome}' nao atendido por esta API"
+    )
+
+
+def listar() -> list[str]:
+    return sorted(_CLIENTES)
+
+
+def get_cliente(cliente: str) -> ClienteBase:
+    """
+    Dependencia do FastAPI. Resolve o cliente pelo path param da rota:
+
+        @router.post("/{cliente}/compras/dados")
+        async def rota(cli: ClienteBase = Depends(get_cliente)): ...
+
+    O nome do parametro tem que ser `cliente` pra bater com o {cliente} da rota.
+    """
+    return obter(cliente)