# API-Scardua

API FastAPI de integração da **Scardua** com serviços externos (Holmes, Apollo) e banco **Oracle**.

🌐 No ar: **https://api-scardua.flstecnologia.tech**

## Documentação

| Doc | Assunto |
|-----|---------|
| [docs/arquitetura.md](docs/arquitetura.md) | Visão, atores e roadmap do projeto |
| [docs/deploy.md](docs/deploy.md) | Runbook de deploy (Podman/Quadlet/Caddy) |
| [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 · httpx · oracledb (thin mode)