# 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](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](docs/arquitetura.md) | Visão, atores e as duas pontas do sistema |
| [docs/conector.md](docs/conector.md) | A decisão do conector e por quê (fechada) |
| [docs/deploy.md](docs/deploy.md) | Como subir no servidor do cliente |
| [docs/known-issues.md](docs/known-issues.md) | Problemas conhecidos e TODOs |
| [CLAUDE.md](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)