Este repositório contém uma API REST robusta desenvolvida com Flask, focada no gerenciamento de cursos, formações, professores e usuários. A aplicação utiliza práticas modernas de desenvolvimento, incluindo autenticação JWT, controle de acesso baseado em funções (RBAC) e persistência em banco de dados relacional.
- Gerenciamento de Cursos: CRUD completo para cursos, incluindo integração com formações.
- Gestão de Formações: Organização de cursos e vinculação de múltiplos professores.
- Controle de Professores: Cadastro e listagem de instrutores.
- Sistema de Usuários e Segurança:
- Registro de usuários com senhas criptografadas (
passlib). - Autenticação via JWT (JSON Web Tokens) com suporte a Refresh Tokens.
- Controle de acesso administrativo via decorator
@admin_required. - Proteção de endpoints via
@api_key_requiredusando chaves API únicas.
- Registro de usuários com senhas criptografadas (
- Paginação: Resultados de listagem otimizados com suporte a parâmetros de página e quantidade por item.
- HATEOAS: Links dinâmicos nos recursos para facilitar a navegação na API.
- Core: Flask, Flask-RESTful.
- Banco de Dados: SQLAlchemy (ORM), Flask-Migrate (Alembic) para migrações e PyMySQL.
- Serialização: Marshmallow e Flask-Marshmallow para validação e transformação de dados.
- Segurança: Flask-JWT-Extended e Passlib.
- Servidor: Gunicorn (configurado no Procfile para deploy).
- Clonar o repositório:
git clone <url-do-repositorio> cd flask_api
- Configurar o ambiente virtual:
python -m venv venv source venv/bin/activate # No Windows: venv\Scripts\activate Instalar dependências: Bash pip install -r Requirements.txt Configurar o Banco de Dados: Certifique-se de ter um servidor MySQL rodando e ajuste as credenciais no arquivo config.py: Python USERNAME = "root" PASSWORD = "seu_password" SERVER = "localhost" DB = "api_flask"
- Executar Migrações:
flask db upgrade
- Rodar a aplicação:
python api/run.py
POST /login: Autenticação de usuário e geração de tokens.
GET /cursos: Listagem paginada de cursos (requer api_key).
GET/POST /formacoes: Gerenciamento de formações (requer JWT).
GET/POST /professores: Gerenciamento de professores (requer JWT).
POST /usuario: Criação de novos usuários e geração de api_key.
- Segurança: Destaquei o uso de
api_keyeJWT, que são diferenciais do seu código. - Estrutura: Mencionei o uso de
Services,Models,Views(Resource) eSchemas, que organizam bem o seu projeto. - Persistência: Referenciei o fluxo de migrações com Alembic que está presente no seu diretório
migrations.