Skip to content

thtsystems/open-visit

Repository files navigation

OpenVisit

Aplicação open-source para agendamentos de visitas em parques empresariais

Specs de design da aplicação no Figma

Documentação da API Rest da aplicação no Postman


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.

Sobre a aplicação

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);
  • Postgres: base de dados;
  • Cloudflare: provedor de serviços de cloud;

Acompanhando os espaços

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.

Sobre a contribuição

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.

Sobre a licença e distribuição

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.

About

Open-source application for visiting scheduling.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published