# evo-ai-processor-community

Python 3.10+ / FastAPI · porta 8000

Microserviço de orquestração de agentes de IA — workflows entre múltiplos
agentes, sessões, busca/armazenamento vetorial e integração com serviços de
IA modernos.

## Tecnologias

FastAPI, SQLAlchemy (ORM), Pydantic (validação), Uvicorn (ASGI), Redis
(cache/filas), JWT (`python-jose`/`pyjwt`), Pinecone/Qdrant/OpenSearch
(vetorial), OpenAI (embeddings opcional), Google ADK, LangGraph
(orquestração de workflows entre agentes), MinIO (artefatos), OpenTelemetry
(observabilidade), `a2a-sdk`/`mcp`, Alembic (migrações).

## Estrutura (Domain-Driven + Layered)

```
src/
├── main.py                 # entrypoint
├── api/v1/[resource]/       # routers FastAPI
├── services/[domain]/       # lógica de negócio
├── models/                   # modelos SQLAlchemy
├── schemas/                  # DTOs Pydantic
├── core/                     # config centralizada
├── middleware/
└── utils/

migrations/                   # Alembic (env.py, versions/)
tests/
├── unit/, integration/
```

## Padrões

- Validação de DTO via Pydantic; injeção de dependência via FastAPI; I/O sempre async/await; JWT Bearer.

## Build & testes

```bash
cd evo-ai-processor-community
uv sync
uv run python -m alembic upgrade head
uv run uvicorn src.main:app
uv run pytest tests/unit/
uv run pytest tests/integration/
uv run ruff check .
```