CastsBrasil

Esse é o código fonte do site CastsBrasil. CastsBrasil tem como objetivo apresentar screencasts colaborativos de qualidade, sem nenhuma forma de cobrança, apenas com o intuito de difundir a linguagem na comunidade brasileira e facilitar o estudo de iniciantes, intermediários e até mesmo profissionais com casts totalmente em Português.

Configuração Inicial

Esse projeto está sendo desenvolvido usando Ruby 2.3.1. Se você estiver utilizando rvm ou rbenv ele vai selecionar a versão exata em desenvolvimento especificada no arquivo .ruby-version.

• Crie um arquivo de configuração do banco de dados:

cp config/database.example.yml config/database.yml

• Execute o comando rake db:migrate para criar todas as tabelas no seu banco de dados.
• Execute o comando RAILS_ENV=test rake db:migrate para criar todas as tabelas no seu banco de dados de teste.
• Execute o comando rails s para subir o servidor rails

Configuração inicial com Docker

Você utilizar o Docker para desenvolver e colaborar com o projeto, para isso siga os passos abaixo:

Requerimentos

• Docker 1.12+
• Docker Compose

Setup

• Build:

docker-compose build

-Crie um arquivo de configuração do banco de dados:

cp config/database.example.yml config/database.yml

Desenvolvimento

• Acesso ao container para desenvolvimento

docker-compose run --rm web bash

Servidor

• Execute o comando abaixo para subir o servidor

docker-compose up

O projeto está disponível em http://localhost:3000

Testes

Esse projeto utiliza o rspec como framework de testes principal. Todas as expectations estão de acordo com a nova forma da versão 3.0 do rspec. A suíte de testes é monitarada pelo semaphore app.

Dependências

Esse projeto utiliza o bundler para controle de dependências ruby e o bower para controle de dependências js e css. O bower é utilizado em conjunto com o bower-installer para ter um controle maior dos arquivos que entram no controle de versão. Ambos são monitorados pelo gemnasium.

Controle da Qualidade

Para manter um alto controle de qualidade do código é utilizado o simplecov para mensurar a quantidade de código coberto por testes. Esse controle é monitorado pelo coveralls.

Garantia da Qualidade

Para garantir a qualidade, é utilizado um guia de estilos, boas práticas e má praticas. Essa garantia é monitorada pelo Code Climate e pelo houndci. O Code Climate checa por má práticas de programação em relação a estrutura do código enquanto que o Houndci checa má práticas na sintaxe do código, isto é, se a leitura do mesmo não é demasiada complicada.

Documentação

Para documentação é utilzado o yardoc que disponibiliza uma api flexível. Para monitoramento da documentação é utilizado o inch-ci.

Gerenciamento de Projeto

Para controle das funcionalidades, bugs, revisão de código e afins é utilizado o waffle que trabalha em cima das issues do github, e disponibiliza um painel para um controle maior.

Discussões

Para discussões relacionadas ao projeto, é utilizado o gitter que disponibiliza um chat em tempo real. Para discussões a longo prazo (assíncronas) é utilizado o google groups.

Triagem de tarefas

Você pode acompanhar o projeto utilizando Codetriage. Ao efetuar o cadastro na plataforma, todos os dias você poderá receber um newsletter com algumas tarefas que precisam de ajuda para serem solucionadas.