O que é?

O "Desafio do Código" é um desafio online com um conjunto de missões que guiam você por ferramentas digitais para aprender programação, matemática e inglês. Foi criado por Soraia Novaes para auxiliar crianças de 10 a 108 anos a aprender estas habilidades tão necessárias no mundo atual.

Organização dos Desafios

Na versão antiga o usuário acessava a plataforma e logo via os desafios, que eram fixos. Para esta nova versão temos os Desafios organizados em Trilhas, e Trilhas em Jornadas.

Exemplo, uma Jornada poderia ser "Programação para crianças", onde teriam várias trilhas, tais como "Começando pelo Sketch Jr", "O segundo grande passo, o Sketch", "Outras forma de programar com blocos". E em cada uma destas trilhas teriam os desafios que seriam efetivamente onde a pessoa aprenderia.

O Desafio do Código pode atender diversos públicos, bastando apenas criamos jornadas, trilhas e desafios para isso.

Uma jornada

Uma jornada é algo durador e transformador. Podemos imaginar uma jornada "Programação com PHP", que fará uma pessoa aprender tudo que for necessário sobre o PHP. Dentro desta jornada existirão várias trilhas que subdividem o conteúdo em partes menores.

Uma trilha

Na jornada do PHP, algumas trilhas poderiam ser "Lidando com o servidor local", "O básico do PHP"... e outras tantas trilhas.

Um desafio

Um desafio é basicamente algo que a pessoa precisará aprender, realizar, e ser avaliada por isso. Poderia exisitir uma trilha "Utilizando o Git" onde um dos desafios fosse "Realizando um commit e push". Neste desafio seria explicado detalhadamente como é feito um commit e como dar o push pro repositório, por fim haveria um teste ou questionário simples para validar que a pessoa aprendeu mesmo.

Ao concluir um desafio e realizar a avaliação, ela ganha pontos e avança na plataforma, e confirma que está aprendendo cada vez mais!

Contribuindo

Precisamos de pessoas para manter o Desafio do Código. Ficaremos muitos felizes em ver você contribuindo conosco! Se esse é seu desejo dê uma lida em "Como Contribuir".

Este repositório

É o repositório único do projeto no qual estamos trabalhando em uma nova versão com um padrão mais limpo e moderno de código a partir da iniciativa de Tiago Gouvêa.

O código antigo foi implementado em PHP por alguns voluntários e está na branch desafioAntigo.

Tudo por aqui está (e deverá continuar) em português, incluíndo comentários em códigos, para permitir que mais pessoas contribuam com o projeto.

Componentes e estrutura do projeto

Optamos por usar frameworks mais simples, para que jovens e estudantes possam trabalhar bem com o projeto. Estamos usando:

• PHP 7 - Para que tudo funcione como esperado
• Composer - Gerenciador de dependências
• Slim Framework - É quem carrega a base do projeto, define as rotas e lida com as requisições
• Twig - É o responsável por renderizar as views, mesclar os dados fornecidos pelo PHP com o HTML
• Bootstrap - Para manter as views fáceis de serem construídas e sempre responsivas

Algumas bibliotecas extras para ajudar no trabalho:

• Respect\Validation - Para validar dados de formulários
• Rollbar - Para logar todos os erros online, tanto no backend quanto no frontend

A estrutura de pastas do projeto segue o padrão do Slim, com poucas modificações:

/
|--- app/
|      |--- src/
|      |      |--- Controller
|      |      |--- Model
|      |      |--- Middleware
|      |      |--- Persistence
|      |      |--- View/
|      |--- dependencies.php
|      |--- routes.php
|      |--- settings.php
|--- public/
|      |--- css/
|      |--- js/
|      |--- index.php

Certamente em 99% do tempo você estará trabalhando nos arquivos das pastas Controller, Model, View e public.

Rodando o projeto novo em desenvolvimento

1. Baixe o código do repositório usando seu git;
2. Acesse a pasta do projeto e execute php composer.phar install para instalar as dependências (ou composer install);
3. Dê seu navegado, acesse seu localhost, algo como http://localhost/desafio_do_codigo/public/. Você verá as instruções para concluir sua configuração;
4. Crie um arquivo settings.php em /app/, usando como base o settings.template.php

• Será necessário ter permissão de escrita na pasta /cache/. Se você usa Mac ou Linux precisará dar esta permissão pelo terminal.

Outra forma de rodar o projeto pode ser executando diretamente na pasta raiz do projeto:

php -d display_errors=on  -S localhost:8000 -t public

Tudo pronto para programar! :D