4d47887c00
A API deixa de ser especifica da Scardua e passa a atender varios
clientes pela rota /v1/holmes/{cliente}/...
Camada de clientes:
- app/clientes/base.py: ClienteBase (comportamento) + ClienteConfig (dado),
separados de proposito — config sai do configs.json hoje e pode sair do
banco amanha sem o resto mudar
- app/clientes/registry.py: resolve o {cliente} da rota pra instancia
- cada cliente traz a propria conta do Holmes; o cache de token virou um
arquivo por cliente (antes era constante de modulo e dois clientes
sobrescreveriam o token um do outro)
Holmes:
- funcoes de modulo viraram a classe HolmesAPI, amarrada a uma conta
- exposta pronta em cliente.holmes (cached_property)
- as funcoes de parsing puro (extrair_*) ficaram fora da classe
Config:
- app/schemas.py: modulo folha, so pydantic. Config e services usam os
mesmos modelos sem um importar o outro
- app/config.py: so o carregamento do configs.json
- configs.json passa a ter "clientes": {"<nome>": {...}}
Compras:
- schemas aceitam o payload real do Holmes (PEDIDO_LINX vem como numero,
NUMERO NF ENTRADA so existe depois da fase da nota)
- parcelas viram dict[int, Parcela], pareando parcelaN com o vencimento
correspondente e pulando os slots vazios
- payload de saida carrega id_processo como chave de deduplicacao: o
Holmes reentrega webhook e sem isso duplica linha no destino
Criptografia:
- app/services/cripto.py: envelope AES-256-GCM + RSA-OAEP-SHA256. RSA
sozinho nao serve (cifra ~190 bytes; o payload passa disso)
- ciframos com a publica do conector e nao conseguimos desfazer
Deploy:
- Dockerfile e .dockerignore vieram da VPS pro repo
- docs/deploy.md: runbook, incluindo que --format docker e obrigatorio
(em OCI o podman ignora o HEALTHCHECK silenciosamente)
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
95 lines
3.7 KiB
Python
95 lines
3.7 KiB
Python
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
|
|
class Parcela(BaseModel):
|
|
valor: float
|
|
vencimento: datetime | None = None
|
|
|
|
|
|
class Autor(BaseModel):
|
|
id: str
|
|
name: str
|
|
email: str
|
|
|
|
|
|
class ComprasProperties(BaseModel):
|
|
# O Holmes manda PEDIDO_LINX como numero (345, sem aspas). O Pydantic v2
|
|
# nao converte numero pra string sozinho, entao precisa habilitar.
|
|
model_config = ConfigDict(coerce_numbers_to_str=True)
|
|
|
|
protocolo: str
|
|
pedido_linx: str = Field(alias="PEDIDO_LINX")
|
|
fornecedor: str = Field(alias="Fornecedores")
|
|
tipo_compra: str = Field(alias="Tipo de Compra")
|
|
cnpj: str = Field(alias="CNPJ")
|
|
# Chega vazio enquanto o processo nao passou pela fase da nota.
|
|
nf_entrada: str | None = Field(default=None, alias="NUMERO NF ENTRADA")
|
|
|
|
num_parcelas: int | None = Field(default=None, alias="num. parcelas")
|
|
|
|
parcela1: float | None = Field(default=None, alias="parcela1")
|
|
parcela2: float | None = Field(default=None, alias="parcela2")
|
|
parcela3: float | None = Field(default=None, alias="parcela3")
|
|
parcela4: float | None = Field(default=None, alias="parcela4")
|
|
parcela5: float | None = Field(default=None, alias="parcela5")
|
|
parcela6: float | None = Field(default=None, alias="parcela6")
|
|
parcela7: float | None = Field(default=None, alias="parcela7")
|
|
parcela8: float | None = Field(default=None, alias="parcela8")
|
|
parcela9: float | None = Field(default=None, alias="parcela9")
|
|
parcela10: float | None = Field(default=None, alias="parcela10")
|
|
parcela11: float | None = Field(default=None, alias="parcela11")
|
|
parcela12: float | None = Field(default=None, alias="parcela12")
|
|
|
|
vencimento1: datetime | None = Field(default=None, alias="vencimento parcela1")
|
|
vencimento2: datetime | None = Field(default=None, alias="vencimento parcela2")
|
|
vencimento3: datetime | None = Field(default=None, alias="vencimento parcela3")
|
|
vencimento4: datetime | None = Field(default=None, alias="vencimento parcela4")
|
|
vencimento5: datetime | None = Field(default=None, alias="vencimento parcela5")
|
|
vencimento6: datetime | None = Field(default=None, alias="vencimento parcela6")
|
|
vencimento7: datetime | None = Field(default=None, alias="vencimento parcela7")
|
|
vencimento8: datetime | None = Field(default=None, alias="vencimento parcela8")
|
|
vencimento9: datetime | None = Field(default=None, alias="vencimento parcela9")
|
|
vencimento10: datetime | None = Field(default=None, alias="vencimento parcela10")
|
|
vencimento11: datetime | None = Field(default=None, alias="vencimento parcela11")
|
|
vencimento12: datetime | None = Field(default=None, alias="vencimento parcela12")
|
|
|
|
@property
|
|
def parcelas(self) -> dict[int, Parcela]:
|
|
"""Junta parcelaN + vencimento parcelaN, ignorando os slots vazios."""
|
|
parcelas = {}
|
|
for n in range(1, 13):
|
|
valor = getattr(self, f"parcela{n}")
|
|
if valor is None:
|
|
continue
|
|
parcelas[n] = Parcela(
|
|
valor=valor,
|
|
vencimento=getattr(self, f"vencimento{n}"),
|
|
)
|
|
return parcelas
|
|
|
|
@property
|
|
def total_parcelas(self) -> float:
|
|
return round(sum(p.valor for p in self.parcelas.values()), 2)
|
|
|
|
class DadosCompras(BaseModel):
|
|
id: str
|
|
author: Autor
|
|
properties: ComprasProperties
|
|
|
|
|
|
class PayloadCompras(BaseModel):
|
|
# Chave de deduplicacao: o id do processo no Holmes. Como ele reentrega
|
|
# webhook, sem isso todo reenvio vira linha duplicada no banco do cliente.
|
|
id_processo: str
|
|
|
|
protocolo: str
|
|
cnpj: str
|
|
pedido_linx: str
|
|
fornecedor: str
|
|
tipo: str
|
|
nf_entrada: str | None
|
|
aprovador: str
|
|
valor_total: float
|
|
parcelas: dict[int, Parcela]
|