O'Time

O O'Time é uma aplicação web que auxilia na montagem de horários escolares de maneira simples e rápida.

Início

Estas instruções permitem que você obtenha uma cópia do projeto e configure em seu computador para desenvolvimento e testes.

Pré-requisitos

Para baixar, compilar e executar em seu computador, você deve ter:

• Sistema de controle de versões git ([https://www.git-scm.com/])
• Kit de Desenvolvimento python (3.*+) ([https://www.python.org/])
• Framework para aplicações web django ([https://www.djangoproject.com/])

Instalação

Distribuições GNU/Linux baseadas em Debian

Importante: É aconselhável fazer um update do apt-get:

sudo apt-get update

• git

sudo apt-get install git

• python

sudo apt-get install python3

Importante: é preciso que o pip esteja instalado, que é um gerenciador de pacotes Python. É por ele que instalaremos o Django.

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py

É aconselhável fazer um upgrade dele:

python3 -m pip install --upgrade pip

• django

pip install Django

Clonar o repositório

Para realizar um clone do projeto, execute através do terminal ou cmd:

git clone https://gitlab.devops.ifrn.edu.br/tads.cnat/pdsweb/2019.2/g-horarios.git

Observação: o comando acima clona o repositório através do protocolo HTTPS e exige que você digite suas credenciais da plataforma de hospedagem de códigos que você está utilizando (neste caso, o GitLab).

• Se você preferir e já ter colocado a chave pública SSH da sua máquina na lista de aceitação de requisições SSH, poderá clonar com o comando git clone git@gitlab.devops.ifrn.edu.br:tads.cnat/pdsweb/2019.2/g-horarios.git. Através deste método, a requisição não pede senha e a comunicação se torna mais segura.

O clone do git cria um diretório chamado g-horarios se não for informado um nome de diretório.

Viajar até o repositório criado

Para entrar no diretório recém-criado, ainda no terminal ou no cmd digite

cd g-horarios

Criar o banco de dados

Para rodar o script que cria o banco de dados, assumindo que você esteja dentro do diretório principal da aplicação, rode no terminal ou cmd:

python3 src/projeto/manage.py migrate

Opcional: criar um usuário para a interface administrativa

Até o momento, o banco de dados deve estar vazio. Para adicionar dados a ele, uma alternativa é criar um usuário para a interface administrativa. Rode no terminal ou cmd:

python3 src/projeto/manage.py createsuperuser

Executar em modo desenvolvimento

Para executar em modo de desenvolvimento, no terminal ou no cmd, rode:

python3 src/projeto/manage.py runserver

Documentação

Verifique o diretório doc para a documentação do sistema

Contribuindo

Veja o arquivo CONTRIBUTING.md para maiores detalhes.

Equipe de desenvolvimento

• Eduardo Riev da Silva Oliveira - eduardoriev12@gmail.com - Gerente

• Luan da Costa Redmann - luandacostaredmann@gmail.com - Back-End/

• Rafael Horacio Soares de Abreu - rafael.horacio@escolar.ifrn.edu.br - Front-End

• Rodrigo Pereira da Silva - missidia@hotmail.com - Designer

• Wallase Alan Costa de Morais - wallacealanmorais@gmail.com - Fullstack

Licença

Este projeto é licenciado pela GNU GPL 3.