bryanjulio / open-visit Goto Github PK

Bem vindos, alunos e demais participantes.

Esse é um workshop concebido por Thiago Tomazella, Coordenador de Tecnologia e Desenvolvimento na Cesta Básica Brasil, com o intuito de introduzir os formandos e convidados às práticas de desenvolvimento de projetos fazendo desenvolvimento de uma aplicação open-source real.

O espaço será aberto semanalmente às quartas-feiras, das 22h15 às 23h. O desenvolvimento da aplicação será liderado pelos desenvolvedores Ernesto Resende, engenheiro de software na Cesta Básica Brasil, e Denilson Martins, desenvolvedor full-stack na Nenu.

Warning 💡 Para os alunos:

As horas dedicadas a este projeto servem exclusivamente para fins de conhecimento e não podem ser utilizados para fins curriculares e de cursos.

O projeto foi concebido principalmente como uma oportunidade de aprendizado, desenvolvimento de habilidades e aquisição de conhecimento. O objetivo principal é fornecer aos alunos universitários um ambiente onde possam crescer profissionalmente, adquirir novas competências e aprimorar as existentes.

Durante as sessões do espaço, será desenvolvido uma aplicação web de agendamento para o controle de entrada e saída de visitantes em parques logísticos.

A aplicação será usada pelas empresas dos parques para registrar informações de identificação do visitante (data e horário de entrada), assim como informações sobre a pessoa e/ou departamento que devem ser contatados para autorizar a entrada do visitante. Na outra ponta, a aplicação também será usada pelos parques logísticos para visualizar informações sobre o visitante e a empresa.

Note: Ainda não há um escopo completo das funcionalidades da aplicação. Parte da ideia do espaço é que os processos por trás da tomada de decisões sobre as funcionalidades e escopo da aplicação sejam expostos aos participantes, de forma que sejam capazes de observar o que acontece antes mesmo do código começar a ser escrito em projetos reais.

Durante as sessões do espaço, a aplicação será projetada, desenvolvida e lançada para o público.

O projeto irá adotar as seguintes tecnologias:

• React: aplicação cliente na web;
• Hono: aplicação backend (API);
• SQLite (D1): base de dados;
• Cloudflare: provedor de serviços de cloud;

Os espaços serão focados exclusivamente nos processos pertinentes ao desenvolvimento da aplicação. Eis o que não iremos fazer durante espaço:

• Instalação e configuração de runtime de desenvolvimento (Node.js);
• Instalação e configuração das ferramentas de versionamento e colaboração (Git);
• Instalação e configuração do sistema operacional (ambiente Linux);

Com a progressão do desenvolvimento da aplicação, os participantes poderão colaborar com partes do desenvolvimento no intuito de colocar em prática aspectos do desenvolvimento colaborativo no GitHub.

Todos os guias técnicos de contribuição podem ser encontrados em CONTRIBUTING.md. O guia contém instruções sobre como configurar o Git, trabalhar de forma colaborativa no GitHub, e inicializar o projeto em um ambiente de desenvolvimento local.

Com excessão deste README (apenas durante o período de desenvolvimento nas sessões do workshop) todo o material deste repositório será mantido em inglês, incluindo código-fonte, comentários, issues, discussions e pull requests. Caso tenha dúvidas, entre em contato com um dos mantenedores.

A aplicação será desenvolvida e distribuída sob modelo open-source, na licença MIT. Participantes devem concordar que, caso colaborem diretamente com a manutenção do código-fonte, o mesmo estará aberto para uso de qualquer entidade, incluindo aquelas com fins lucrativos.