README.md

@@ -0,0 +1,26 @@
+# 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)