Getting Started

Pré-requisitos

• Docker e Docker Compose (recomendado) ou
• Python 3.8+ e Node.js 18+ (desenvolvimento local)

Quick Start com Docker

# Clonar o repositório
git clone git@bitbucket.org:valid-sa/sdk-digital.git
cd sdk-digital

# Copiar variáveis de ambiente
cp .env.example .env

# Subir API + Web Demo
docker-compose up --build

Após o build, os serviços estarão disponíveis em:

Serviço	URL
API	http://localhost:8000
API Docs (Swagger)	http://localhost:8000/docs
Web Demo	http://localhost:5173

Desenvolvimento Local

API (FastAPI)

cd api
pip install -r requirements.txt
PYTHONPATH=../sdk uvicorn app.main:app --reload --port 8000

Web Demo (React/Vite)

cd web
npm install
npm run dev

O Vite automaticamente faz proxy de /api para http://localhost:8000.

Mobile Demo (Expo)

cd mobile
npm install
npx expo start

Testar a API

# Health check
curl http://localhost:8000/api/health

# Processar uma imagem
curl -X POST -F "file=@foto_dedo.jpg" http://localhost:8000/api/process

Resposta de sucesso:

{
  "success": true,
  "quality_score": 91.4,
  "quality": {
    "sharpness": 1691.2,
    "contrast": 42.7,
    "ridge_clarity": 1763.3,
    "score": 91.4,
    "is_acceptable": true
  },
  "warnings": [],
  "image_base64": "iVBORw0KGgo..."
}

Próximos Passos

• Arquitetura — entenda a estrutura do sistema
• API Reference — endpoints detalhados
• Integração Web — integrar em sua aplicação web
• Pipeline do SDK — como funciona o processamento