Sistema de gestão acadêmica com CLI + API REST (FastAPI)
O RuralBeat é um sistema acadêmico desenvolvido em Python que permite gerenciar disciplinas e usuários através de:
- 🖥️ Interface CLI (terminal)
- 🌐 API REST com FastAPI
O projeto aplica conceitos reais de desenvolvimento backend, incluindo arquitetura em camadas, validação de dados e organização modular.
A dificuldade em organizar disciplinas e acompanhar a estrutura acadêmica de forma simples e centralizada.
Um sistema que permite:
- Cadastro e autenticação de usuários
- Gerenciamento de disciplinas
- Organização por período
- Integração via API para futuras aplicações web
CLI / API (FastAPI)
↓
Controller (Router)
↓
Service
↓
Repository
↓
Database (SQLite)✔ Separação de responsabilidades ✔ Reutilização de código ✔ Estrutura escalável
- Estrutura inicial do projeto
- Configuração do banco SQLite
- CRUD básico de disciplinas (CLI)
- Arquitetura em camadas implementada
- Sistema de autenticação (login/cadastro)
- Validação de email (regex)
- Validação de senha
- Bloqueio de email duplicado
- Filtro de disciplinas por período
- Implementação da API REST com FastAPI
- Criação de endpoints (GET / POST)
- Uso de Pydantic para validação
- Documentação automática (Swagger)
- Integração CLI + API
📁 Acesse os fluxogramas e a planilha do projeto:
https://drive.google.com/drive/folders/12n1BCKfDIjs-ZURshak3fSPBVY3y9v70?usp=sharing
Conteúdo:
- Fluxogramas das funcionalidades
- PDF da planilha de acompanhamento
- Organização das releases
- Python 3.x
- SQLite
- FastAPI
- Uvicorn
- Pydantic
- Regex
- Git e GitHub
GET /disciplinas/POST /disciplinas/Exemplo:
{
"codigo": "12345",
"nome": "Nova Disciplina",
"periodo": 1,
"carga_horaria": 60
}git clone https://github.com/ArtRaWs/RuralBeat.git
cd RuralBeatpython -m venv venvAtivar:
Windows
venv\Scripts\activatepip install fastapi uvicorn pydanticpython -m src.backend.database.init_dbpython -m src.backend.modules.disciplinas.main_cliCrie main.py:
from fastapi import FastAPI
from src.backend.modules.disciplinas.controller import router
app = FastAPI(title="RuralBeat API")
app.include_router(router)Execute:
uvicorn src.backend.main:app --reload- Swagger: http://127.0.0.1:8000/docs
- Redoc: http://127.0.0.1:8000/redoc
- Validação de email
- Validação de senha
- Prevenção de duplicidade
- Queries seguras (anti SQL Injection)
- Organização em camadas
- Integração CLI + API
- Gerenciamento de banco
- Problemas de importação Python
- Autenticação JWT
- Criptografia de senha
- Interface web
- Deploy
Arthur Ricardo Amanda Beatryz
MIT License