Introdução ao desenvolvimento omegaUp
Bem-vindo! Este guia irá ajudá-lo a começar a contribuir para o omegaUp, uma plataforma educacional gratuita que ajuda a melhorar as habilidades de programação.
O que é omegaUp?
omegaUp é uma plataforma de programação educacional usada por dezenas de milhares de estudantes e professores na América Latina. Ele fornece:
- Solução de problemas: Milhares de problemas de programação com avaliação automática
- Concursos: Organize competições de programação
- Cursos: caminhos de aprendizagem estruturados
- Treinamento: pratique problemas organizados por tópico e dificuldade
Antes de começar
Se você é novo no omegaUp, recomendamos:
- Experimente a plataforma: Visite omegaUp.com, crie uma conta e resolva alguns problemas
- Saiba mais sobre nós: Explore omegaup.org para saber mais sobre nossa organização
- Entenda a base de código: Revise a Visão geral da arquitetura para entender como o omegaUp funciona
Caminho de início rápido
-
Configuração de desenvolvimento
Configure seu ambiente de desenvolvimento local usando Docker. Este é o primeiro passo para começar a contribuir.
-
Aprenda como bifurcar o repositório, criar ramificações e enviar solicitações pull.
-
Preso? Aprenda como fazer perguntas de maneira eficaz e obter ajuda da comunidade.
Visão geral do ambiente de desenvolvimento
omegaUp usa Docker para desenvolvimento local:
- Web + API: PHP e MySQL (MVC, APIs JSON)
- Juiz: Go (grader/runner) e sandbox minijail
- UI: Vue.js, TypeScript, Bootstrap 4
- Problemas: gitserver e ZIP — ver Problemas
Caminhos no repositório
| Área | Caminho |
|---|---|
| API | frontend/server/src/Controllers/ |
| DAO | frontend/server/src/DAO/ |
| Migrações | frontend/database/ |
| Vue/TS | frontend/www/js/ |
| Testes PHPUnit | frontend/tests/controllers/ |
| Cypress | cypress/e2e/ |
Leituras
Navegadores
Use um navegador atual (Chrome, Firefox, Safari, Edge). Apenas HTTPS; IE antigo não é suportado.
Contas de Desenvolvimento
Ao configurar seu ambiente local, você terá acesso a duas contas pré-configuradas:
| Nome de usuário | Senha | Função |
|---|---|---|
omegaup |
omegaup |
Administrador |
user |
user |
Usuário regular |
Próximas etapas
- Configure seu ambiente de desenvolvimento - Coloque o Docker em execução e clone o repositório
- Leia o guia de contribuição - Aprenda o fluxo de trabalho para enviar alterações
- Explore a arquitetura - Entenda como o omegaUp está estruturado
- Revise as diretrizes de codificação - Aprenda nossos padrões de codificação
Recursos
- Site: omegaup.com
- GitHub: github.com/omegaup/omegaup
- Discord: Junte-se ao nosso servidor Discord para suporte da comunidade
- Problemas: Relatar bugs ou solicitar recursos
Pronto para começar? Vá para Configuração de desenvolvimento para começar!