Transforme enunciados em trabalhos acadêmicos profissionais com o poder da IA.
O AcademicManager é uma ferramenta robusta para automação de trabalhos acadêmicos. Ele utiliza inteligência artificial (Gemini) para processar enunciados, gerar templates estruturados e exportar documentos PDF formatados seguindo padrões acadêmicos.
Recentemente o projeto passou por uma grande evolução, ganhando uma interface web de última geração e ferramentas de BI:
- Dashboard Administrativo: Visualize seu progresso com gráficos de atividade em tempo real.
- Configurações Dinâmicas: Altere chaves de API, fontes de PDF e preferências gerais diretamente na UI, com persistência por sessão (LocalStorage).
- Sistema de Backup & Restore: Proteja seus projetos exportando e importando pacotes compactados (.zip) de forma integrada.
- Híbrido por Design: Escolha entre o modo terminal (CLI) clássico ou a nova experiência Web.
A maneira mais rápida e limpa de subir o projeto em qualquer ambiente.
# Clone e entre na pasta
git clone https://github.com/cleitonleonel/AcademicManager.git
cd AcademicManager
# Suba o ambiente com um comando
docker compose up -dO sistema estará disponível em:
- 🌐 Interface de Usuário: http://localhost:8000/
- 📚 Documentação da API: http://localhost:8000/docs
Tip
Os projetos criados serão salvos na pasta academic_projects/ do seu computador, graças aos volumes do Docker.
# Instale as dependências
poetry install
# Modo Web
poetry run python main.py --web
# Modo Terminal (CLI)
poetry run python main.pyPara utilizar as funcionalidades de IA (Gemini):
- Obtenha sua chave em aistudio.google.com.
- Você pode configurá-la de duas formas:
- Fixa: Renomeie
config-dev.iniparaconfig.inie insira a chave. - Dinâmica: Insira a chave diretamente na tela de Configurações do Dashboard (válido para a sessão atual).
- Fixa: Renomeie
academic_manager/: Motor central (Core, PDF, Services).api/: Backend FastAPI, rotas e lógica assíncrona.frontend/: Dashboard moderno (HTML/CSS/JS).academic_projects/: Diretorio onde seus trabalhos são armazenados.
O projeto utiliza o pytest para garantir a estabilidade das funcionalidades centrais e da API.
Você pode executar os testes de três formas diferentes:
# Executa todos os testes e mostra a cobertura no terminal
poetry run pytest
# Gera um relatório HTML detalhado de cobertura
poetry run pytest --cov-report=htmlExecute os testes dentro do container para garantir que o ambiente seja idêntico ao de produção:
docker compose run --rm academic-manager pytestpython -m pytest- Core: Validação da geração de PDF, lógica de templates e manipulação de arquivos.
- API: Testes de integração de todos os endpoints HTTP usando
TestClient. - Stress: Testes de performance para garantir estabilidade sob carga.
- Cobertura: Relatórios automáticos que mostram exatamente quais partes do código foram testadas.
Este projeto está licenciado sob a Licença MIT.
Cleiton Leonel Creton - @cleitonleonel
Important
Este projeto é uma ferramenta de auxílio acadêmico. Lembre-se sempre de revisar o conteúdo gerado pela IA para garantir a precisão e a qualidade do seu trabalho.