API Agenda Acadêmica

API REST para gerenciamento de agenda acadêmica de alunos com autenticação JWT e migrations automáticas.

Quick Start

1. Setup

python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate

pip install -r requirements.txt

2. Configuração

Crie arquivo .env:

DATABASE_URL=postgresql://user:password@host:port/database
SECRET_KEY=sua-chave-secreta-gerada
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
REFRESH_TOKEN_EXPIRE_DAYS=7

3. Inicializar BD

Descomente em app/main.py:

Base.metadata.create_all(bind=engine)

Execute uma vez e recomente.

4. Executar

uvicorn app.main:app --reload

API: http://localhost:8000
Docs: http://localhost:8000/docs

Rotas

• GET /api/v1/health - Health check
• GET / - Página inicial
• /api/v1/usuario - Gerenciamento de usuários
• /api/v1/docentes - Gerenciamento de docentes
• /api/v1/discentes - Gerenciamento de discentes
• /api/v1/notas - Gerenciamento de notas
• /api/v1/calendario - Calendário acadêmico
• /app/v1/anotacao - Gerenciamento de anotações

Stack

• FastAPI - Framework web moderno e rápido
• Uvicorn - Servidor ASGI
• SQLAlchemy - ORM
• PostgreSQL/psycopg2 - Banco de dados
• Pydantic - Validação de dados
• PyJWT + bcrypt - Autenticação segura
• Alembic - Migrations automáticas
• Jinja2 - Templates HTML
• python-dotenv - Variáveis de ambiente

Estrutura

app/
├── main.py          # App e rotas principais
├── database.py      # Conexão BD
├── models.py        # Modelos ORM
├── crud.py          # Operações
├── schemas.py       # Validators Pydantic
├── auth.py          # Autenticação JWT
└── routers/         # Endpoints
    ├── anotacao.py
    ├── calendario.py
    ├── discentes.py
    ├── docentes.py
    ├── health.py
    ├── notas.py
    └── usuario.py