Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/powerandcontrol/sada
https://github.com/powerandcontrol/sada
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/powerandcontrol/sada
- Owner: powerandcontrol
- License: mit
- Created: 2024-10-02T20:15:40.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-16T17:30:16.000Z (3 months ago)
- Last Synced: 2024-10-18T13:54:41.039Z (3 months ago)
- Language: Python
- Size: 2.39 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
SADA
Sistema de Apoio ao Desempenho Acadêmico
## 🌟 Sobre
O SADA foi pensado e desenvolvido para auxiliar todos os estudantes do curso de Sistemas de Informação da UNIRIO que se sentem perdidos na hora de organizar a sua grade curricular.
O sistema analisa, a partir do Histórico do aluno, a situação do mesmo em cada matéria presente na grade curricular do curso.
A partir da tela de visualização dessa análise, o aluno consegue facilmente encontrar as disciplinas que ele ainda não cursou e que estão disponíveis no período atual. Assim, facilitando a criação da grade de horários.
### 📷 Fotos do Website
#### 📃 Tela Inicial
Ao abrir a tela inicial, o usuário deve preencher três inputs principais:
- Currículo: escolher entre o currículo antigo 2008.1 ou o atual 2023.2 (de acordo com a sua grade curricular atual)
- Tipo do Histórico: escolher qual tipo de histórico você baixou pelo Portal do Aluno (CR Aprovado ou Integralização)
- Período: escolher o período que você está cursando no período atual.
#### 📃 Tela de Obrigatórias
Na tela de Obrigatórias, as disciplinas obrigatórias da Grade Curricular são classificadas em três status diferentes:
- Cursadas: matérias que o aluno já cursou, aparecem com a cor verde.
- Não Cursadas e Disponíveis: matérias que o aluno não cursou ainda e que ele já possui todos os pré-requisitos necessários para cursar,aparecem com a cor azul escuro.
- Não Cursas e Indisponíveis: matérias que o aluno não cursou ainda e que ele não possui todos os pré-requisitos necessários para cursar, aparecem com a cor vermelha.
### 👾 Tecnologias Utilizadas
O SADA é uma solução web que utiliza `HTML`, `CSS` e `Javascript` para o Front-End da aplicação, enquanto o Back-End fica por conta do `Python` e do seu framework web `Flask`.
O SGBD escolhido para fazer a criação e manutenção do Banco de Dados foi o `SQLite`, devido a sua integração com a biblioteca do Python `SQLAlchemy`.
#### Linguagens, Bibliotecas e Frameworks
### 🎯 Funcionalidades
- Upload de Histórico
- Análise de Progresso Curricular
- Visualização de dados
### 🎨 Paleta de Cores
| Cor | Hex |
| ----------------- | ------------------------------------------------------------------ |
| Cor Principal |  #08415C |
| Cor Secundária |  #FFFFFF |
| Cor de Destaque |  #CC2936 |
| Text Color |  #000000 |
## 🖥️ Ambiente de desenvolvimento
### 🐍 Pré-Requisitos
Esse website é uma solução em Python, então antes de tudo é necessário baixar a linguagem de programação no site oficial .
O segundo requisito necessário é o Git, que gerencia o controle de versionamento do projeto. Um tutorial de como instalar e começar a usar o Git pode ser encontrado no site oficial da ferramenta.
### 🧰 Clonando o projeto
Tendo ambos os Pré-Requitos instalados no seu computador, você já consegue rodar o projeto localmente.
O primeiro passo é clonar o projeto na sua pasta de preferência.
```bash
git clone https://github.com/powerandcontrol/SADA.git
```
### 🔑 Ambiente virtual
Para rodar esse projeto você precisará criar um ambiente virtual `venv` dentro da pasta do SADA.
```bash
cd SADA
python -m venv venv
```
E, depois de criado, será necessário ativá-lo.
```bash
venv\scripts\activate
```
### ⚙️ Instalando as Bibliotecas
As bibliotecas necessárias podem ser encontradas no arquivo `requirements.txt` e conseguimos baixar elas usando o gerenciador de pacotes `pip`.
```bash
pip install -r requirements.txt
```
### 🧪 Rodando Localmente
Tendo seguido todos os passos anteriores você pode rodar o projeto sem maiores problemas usando o comando:
```bash
python app.py
```
## 👋 Contribuidores
## ⚠️ Licensa
Licensa MIT.