Desenvolvimento

# Clone e entre no projeto
git clone https://github.com/sinapse/core-api.git
cd core-api

# Crie ambiente virtual
python -m venv venv
source venv/bin/activate  # Linux/Mac
# ou
venv\Scripts\activate  # Windows

# Instale dependências
pip install -r requirements.txt
pip install -r requirements-dev.txt

# Configure ambiente
cp .env.example .env
# Edite .env

# Rode com Docker
docker-compose up -d

# Ou rode localmente
uvicorn main:app --reload

# Bom
async def get_user_by_id(
    user_id: int,
    db: AsyncSession = Depends(get_db)
) -> UserModel | None:
    """Busca usuário por ID."""
    result = await db.execute(
        select(UserModel).where(UserModel.id == user_id)
    )
    return result.scalar_one_or_none()

# Evitar
def getUser(id):
    return db.query(User).filter(User.id == id).first()

modules/
└── novo_modulo/
    ├── __init__.py
    ├── endpoints.py      # Rotas FastAPI
    ├── models.py         # Modelos SQLAlchemy
    ├── schemas.py        # Schemas Pydantic
    ├── services.py       # Lógica de negócio
    └── repository.py     # Acesso a dados

@pytest.mark.asyncio
async def test_create_user(client: AsyncClient, db: AsyncSession):
    # Arrange
    user_data = {
        "nome": "Test User",
        "email": "[email protected]",
        "senha": "Test123!"
    }
    
    # Act
    response = await client.post("/api/v1/usuarios", json=user_data)
    
    # Assert
    assert response.status_code == 201
    data = response.json()
    assert data["email"] == user_data["email"]

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "FastAPI",
      "type": "python",
      "request": "launch",
      "module": "uvicorn",
      "args": ["main:app", "--reload", "--port", "8000"],
      "jinja": true,
      "justMyCode": false
    }
  ]
}

# Em main.py
if settings.DEBUG:
    import debugpy
    debugpy.listen(("0.0.0.0", 5678))
    print("Debugger pronto na porta 5678")