Comercial-Scardua/conector-scardua
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Conector que roda na rede da Scardua: recebe da API da FLS e grava no Oracle privado
2 commits 1 branch 0 tags 58 KiB
Find a file
Exact
Ricardo 7a9b0f8aa5 Adiciona testes do conector com fixtures offline 
Cobre o caminho completo sem depender da VPS estar no ar: cifra com uma
chave de teste descartavel, troca a chave do app por monkeypatch e exercita
a rota.

8 casos: recusa sem token e com token errado; caminho feliz; envelope
adulterado (o GCM tem que estourar, nao passar); cifrado com outra chave;
payload fora do contrato (422, nao 200 nem 500); e dois travando o contrato
com a API da VPS — se o PayloadCompras dos dois lados divergir, quebra aqui
em vez de em producao.

Fixtures em tests/fixtures/: par de chaves so pra teste, o payload real do
Holmes e o payload ja tratado. O .gitignore abre excecao estreita pra
tests/fixtures/*.pem — chave real continua barrada.

Tambem:
- 422 passa a usar HTTP_422_UNPROCESSABLE_CONTENT (o _ENTITY deprecou)
- app/services/holmes.py removido: o conector nao fala com o Holmes
- app/utils/cesar.py entra como veio

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 06:13:13 -03:00
app Adiciona testes do conector com fixtures offline 2026-08-18 06:13:13 -03:00
deploy Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
docs Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
tests Adiciona testes do conector com fixtures offline 2026-08-18 06:13:13 -03:00
.dockerignore Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
.gitignore Adiciona testes do conector com fixtures offline 2026-08-18 06:13:13 -03:00
CLAUDE.md Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
configs.example.json Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
Dockerfile Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
main.py Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
pyproject.toml Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
README.md Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00
requirements.txt Conector Scardua — recebe da API da FLS e entrega no Oracle do cliente 2026-08-18 06:05:03 -03:00

README.md

Conector Scardua

Serviço que roda dentro da rede da Comercial Scardua e faz a ponte entre a API pública da FLS (na VPS) e o Oracle privado do cliente (10.16.x).

Recebe o payload cifrado, abre com a chave privada, valida e — quando a fase 2 entrar — grava no Oracle.

⚠️ Este repositório mudou de papel. Ele era a API que roda na VPS; essa parte migrou pro repositório da API (ver docs/arquitetura.md). Aqui ficou o conector.

Onde ele fica no fluxo

Holmes --webhook--> [API na VPS da FLS] --cifra e envia--> [ESTE conector] --> [Oracle do cliente]
                     público, TLS                          rede privada do cliente

Documentação

Doc Assunto
docs/arquitetura.md Visão, atores e as duas pontas do sistema
docs/conector.md A decisão do conector e por quê (fechada)
docs/deploy.md Como subir no servidor do cliente
docs/known-issues.md Problemas conhecidos e TODOs
CLAUDE.md Guia rápido do código

Rodar local (Windows)

Precisa do configs.json na raiz — veja configs.example.json.

uvicorn main:app --reload --port 8000

Stack

Python ≥3.10 · FastAPI + Uvicorn · Pydantic v2 · cryptography (RSA-OAEP + AES-GCM) · oracledb (thin mode)