Ticketflix

Repositório da plataforma de exibição de atrações que estão ou estarão com a compra de ingressos disponíveis.

Documentação:

Toda a documentação e artefatos produzidos pela equipe do Ticketflix pode ser encontrado na página:

https://github.com/DSW-2018-2/Ticketflix

Contribuindo:

Para contribuir com o projeto, por favor, leia o CONTRIBUTING, nele contém algumas informações importantes de como contribuir, um link para o nosso código de conduta e alguns dos nossos padrões!

Comandos Básicos (Em desenvolvimento):

Rodando a aplicação:

Observação: Recomendamos, e o processo abaixo foi executado, uma máquina Ubuntu/Linux com a distribuição Ubuntu 16.04.4 LTS.

O primeiro passo é fazer o clone do projeto pelo GitHub (tenha certeza de ter o git instalado em sua máquina):

$ git clone https://github.com/DSW-2018-2/Ticketflix.git

Certifique de ter instalado:

• docker
• docker-compose

E por fim, agora para rodar a aplicação basta rodar o seguinte comando no seu terminal:

$ docker-compose -f local.yml up --build

Com isso as imagens serão baixadas e geradas na sua máquina e você poderá acessar a aplicação pelo seu navegador no endereço 127.0.0.1:8000.

Observação: Caso deseje parar os containers basta usar a combinação CTRL+C no terminal que está rodando a aplicação, ou, caso esteja rodando em backgroud executar o comando:

$ docker-compose -f local.yml down

Configurando seu usuário:

• Para criar um conta de usuário normal, vá em Criar Conta e preencha os campos. Assim que você submeter suas informações, você verá uma página de "Verificar seu endereço de E-mail". Vá no seu terminal, no seu console você verá uma mensagem de email de verificação. Copie o link para seu negador. Agora o E-mail do usuário deve ser verificado e pronto para ser usado.

• Para criar uma conta super usuário, use esse comando:

  $ docker-compose -f local.yml run --rm django python manage.py createsuperuser
  

Por conveniência, você pode manter o seu usuário normal logado no Chrome e seu super usuário (administrador) logado no Firefox (ou similar), assim você consegue ver como o site se comporta em ambos usuários.

Teste de cobertura:

Para verificar a cobertura do seu código, assim como rodar a suíte de testes da sua aplicação, basta rodar os seguintes comandos abaixo:

$ docker-compose -f local.yml run --rm django coverage run -m py.test
$ docker-compose -f local.yml run --rm django coverage html
$ firefox htmlcov/index.html

Observação: Será gerada uma pasta htmlcov/ que conterá o index.html, este arquivo contem o relatório extraído dos testes rodados, no exemplo acima foi utilizado o navegador Mozilla Firefox para a abertura do arquivo HTML gerado. Outras configurações, flags e modos de uso do coverage podem ser verificadas na documentação do coverage.

Rodando os testes com py.test:

Para apenas rodar a suíte de testes com o py.test basta executar o seguinte comando:

$ docker-compose -f local.yml run --rm django py.test

Observação: No próprio terminal será mostrado o output dos testes rodados. Outras configurações, flags e modos de uso do py.test podem ser verificadas na documentação do py.test.

Live Reloading e Compilação SASS CSS:

Caso queira usar a compilação de SASS/CSS ou fazer o uso do Live Reloading leia a documentação do cookiecutter acerca em Live reloading and SASS compilation.

Outras Configurações:

O projeto se apoia em configurações por meio de arquivos de configuração de ambiente, caso deseje neste, link é possível ver o mapa das variáveis de ambiente das configurações django do projeto.

Deploy:

Os detalhes a seguir mostram como implantar esse aplicativo.

Docker

O projeto se apoia em containers para utilização dos serviços e o seu deploy. Veja mais detalhes de como fazer o deploy na documentação do cookiecutter acerca de deploy com docker.