O Cola&Bora é um projeto que surgiu na Universidade Federal de Pernambuco (UFPE), na cadeira "Projetão". É o resultado de um processo de Design Thinking, cujo o objetivo era criar uma solução que proporcionasse maior eficiência a realização de ações sociais realizadas na cidade do Recife - PE.
Aqui é possível ver um vídeo de apresentação do projeto
Indo além das fronteiras da universidade, o Cola&Bora foi um projeto participante da 10ª edição do Campus Mobile. Nele, o projeto passou por mentoria com especialistas de ESG e projetos de impacto social, onde ganhou maturidade e foi finalista na categoria "Smart Cities".
O Cola&Bora tem como principal usuário o Voluntário, um voluntário cadastrado na plataforma pode:
- Criar uma nova Organização Social
- Criar uma nova Ação Social de uma Organização
- Visualizar Participantes de uma Ação Social
- Visualizar outras Organizações Sociais existentes
- Participar de Ações Sociais divulgadas na plataforma
As Organizações Sociais são fundamentais para o funcionamento do Cola&Bora. Uma Organização Social é cadastrada por um voluntário. Após cadastrada, é possível atribuir Ações Sociais a serem realizadas pela Organização, sendo atribuídas pelo voluntário que a cadastrou.
Elas são consideradas instituições que credibilizam as Ações Sociais realizadas. É possível ver quais ações sociais estão associadas à organização social ao consultar suas informações.
Uma Ação Social necessariamente deve estar associada a uma Organização Social. Uma Ação Social deve descrever seus objetivos, áreas de atuação e demais detalhes, como quando e onde irá ocorrer, além dos participantes.
Antes de tudo, para executar o projeto no seu computador é necessário ter os seguintes requisitos:
- SDK do .NET 6
- Docker e Docker Compose
- Clone deste repositório
Após cumpridos os requisitos anteriormente descritos, seguir os seguintes passos:
- Abra o terminal na raiz do repositório clonado
- Inicie o docker com o comando a segur:
$ sudo service docker start
- Execute o arquivo docker-compose.yml
$ sudo docker-compose up -d
- Vá até a pasta "src/Colabora.WebAPI" e execute o projeto
$ cd src/Colabora.WebAPI
$ sudo dotnet run - Abra a url "https://localhost:5000" seu navegador para acessar o Swagger
O Cola&Bora é um projeto idealizado através do conceito Mobile First, ou seja, levando em consideração a usabilidade em dispositivos móveis primeiro. Neste repositório está contida a implementação do backend do Cola&Bora, cujo disponibiliza uma API completa para viabilidade inicial do projeto, cujo será descrita a seguir.
O backend do Cola&Bora foi construído utilizando as seguintes ferramentas:
- ASP.NET Core com .NET 6
- MediatR
- Entity Framework Core
- SQL Server
- FluentValidation
- Google OAuth
- Swagger
- xUnit (Testes)
- NSubstitute (Testes)
- FluentAssertions (Testes)
- Bogus (Testes)