O ambiente de desenvolvimento do projeto é dividido em serviços operando em containers, orquestrados com Docker-Compose. Estes são:
- PostgreSQL: Banco de dados relacional.
- NodeJS: Interpretador de Javascript;
- Express, CORS: Bibliotecas para requisições HTTP;
- Sequelize: Biblioteca para gerenciamento de migrations e utilidades relacionadas ao DB.
- NodeJS: Interpretador de Javascript;
- VueJS: Framework para desenvolvimento de interfaces;
- Axios: Biblioteca para integração com APIs.
- Docker
- Docker-Compose
-
Faça um fork deste repositório (
pds-team-leader/linhas-de-cuidado
) -
Faça o clone do repositório
seu_usuario/linhas-de-cuidado
em um diretório na sua máquina:git clone https://github.com/SEU_USUARIO/linhas-de-cuidado.git
cd linhas-de-cuidado
-
Adicione o "repositório raiz" (pds-team-leader/linhas-de-cuidado) aos seus remotes:
git remote add pds-ldc https://github.com/pds-team-leader/linhas-de-cuidado.git
-
Use o Docker para construir as imagens do ambiente:
docker-compose build
docker-compose up
A princípio, os serviços de Front-End e Back-End serão entregues nas portas http://localhost:8000 e http://localhost:3000, respectivamente.
- Para inserir um novo Card, certifique-se de estar up to date com a master e em seguida insira uma nova Branch correspondente ao seu Card.
git fetch linhas-de-cuidado master
git checkout -b CARD-XX linhas-de-cuidado/master
- Algumas tarefas podem ser grandes demais, ou ter dependencias entre setores diferentes, de forma que as entregas são dependentes entre si e, portanto, funcionam melhor agrupadas.
- A uma tarefa dessa proporção chamamos de Épico. Seus Cards se juntarão ao épico, que uma vez pronto, será incorporado na Master.
- Sendo assim, ao criar um novo Card para trabalhar, você o criará a partir do Card Épico, não da master, e ao entregá-lo pronto, você fará o merge em direção ao épico, não à Master.
git fetch linhas-de-cuidado CARD-XX
git checkout -b CARD-XX linhas-de-cuidado/CARD-XX
- Para seus commits, tente seguir o padrão para evidenciar o CARD ao qual a sua adição se refere
git commit -m "[CARD-XX] - Adiciona nova funcionalidade"
- Em seguida, você realizará o push para seu repositório remoto (o fork)
git push origin CARD-XX
- Ao clonar o repositório Fork em sua máquina, o git criará automaticamente um remote origin, que aponta para o repositório seu_usuario/linhas-de-cuidado.
Esse é o repositório no qual você realizará seus commits e pushes:
git push origin CARD-XXXX
- Uma vez feito o push de um novo Card, você deverá criar uma Pull Request no Github. Vá para https://github.com/pds-team-leader/linhas-de-cuidado/pulls e clique em "New Pull Request".
- O Github geralmente detecta mudanças no repositório fork que podem ser mescladas ao repositório raíz, nesses casos você verá algo como:
- Caso contrário, basta clicar em "compare across forks" e seguir com a definição da Pull Request.
- O exemplo da imagem acima é um caso excepcional em que se realiza o merge das branches "main" de cada repositório. Você NÃO DEVE fazer o merge com a main.
- Ao Criar um novo CARD ou Épico é criada uma branch equivalente no repositório raíz, você deve realizar o merge da branch de seu CARD no repositório fork para a branch equivalente no repositório raíz:
- Antes mesmo de criar sua Pull Request e requisitar a avaliação de outros desenvolvedores, você pode fazer o review de seu próprio código e adicionar commits com correções, caso necessário. Feito isso, basta clicar em "Create Pull Request".
- Você verá que já pode realizar o merge, no entanto, é recomendado que marque colegas e peça a avaliação de pelo menos 2 pessoas, que deverão aprovar a PR, antes de fazer o merge.