| ... | ... | @@ -3,13 +3,16 @@ |
|
|
|
|
|
|
|
# Página de Configuração do Projeto
|
|
|
|
|
|
|
|
<br>
|
|
|
|
## Configurações Servidor
|
|
|
|
|
|
|
|
[Configurações de Servidor](Configurações de Servidor)
|
|
|
|
|
|
|
|
<br>
|
|
|
|
## Configurações FrontEnd
|
|
|
|
|
|
|
|
1. Clonar o projeto do repositório http://www.tools.ages.pucrs.br/Ibere/frontend
|
|
|
|
- `git clone <link do repositório>`
|
|
|
|
2. Na raiz do projeto,
|
|
|
|
|
|
|
|
Aqui deve ser explicado como configurar o Ambiente para que os Desenvolvedores do Projeto possam configurar o projeto para rodar em seus computadores, deve ser sempre atualizado a cada mudança de instalação feita.
|
| ... | ... | @@ -17,14 +20,37 @@ Aqui deve ser explicado como configurar o Ambiente para que os Desenvolvedores d |
|
|
|
* Deve ser explicado a configuração de **TODAS** as partes do projeto, tanto BACK,BANCO,FRONT,etc...
|
|
|
|
* Além de explicar aqui, deve ter em cada Repositório o **RESUMO** de como instalar para quando os Desenvolvedores baixarem o projeto possam configurar por lá também
|
|
|
|
|
|
|
|
<br>
|
|
|
|
## Convenções do time
|
|
|
|
|
|
|
|
### Nomeando uma branch
|
|
|
|
Padrão de nomenclatura de *branches*:
|
|
|
|
- `<número da tarefa>/<nome da tarefa separado por hífen>`
|
|
|
|
|
|
|
|
exemplos:
|
|
|
|
- 10/criar-cadastro-de-cliente
|
|
|
|
- 11/padronizar-layout
|
|
|
|
|
|
|
|
### Criando mensagem para commit
|
|
|
|
Padrão de mensagem:
|
|
|
|
- `<número da tarefa>/<@autor1>, <@autro2>: <descrição do commit>`
|
|
|
|
|
|
|
|
Exemplos:
|
|
|
|
- 10/@membro1, @membro2: Implementa o cálculo de idade do cliente
|
|
|
|
- 10/@membro1, @membro2: Corrige a submissão do formulário de cliente
|
|
|
|
|
|
|
|
Observações:
|
|
|
|
* Descreva de forma sucinta a ação desse *commit*, para manter uma boa documentação do código.
|
|
|
|
* Evite fazer commits com muitas alterações (muitas funcionalidades), pois isso possibilita a rastreabilidade de impacto de cada alteração e um possível *rollback* desse *commit* no caso dele quebrar alguma coisa.
|
|
|
|
|
|
|
|
<br>
|
|
|
|
## Git workflow
|
|
|
|
|
|
|
|
#### Criando branch
|
|
|
|
|
|
|
|
1. Estar vinculado a uma Issue criada no Trello e marcar como In progress
|
|
|
|
2. ir para branch dev e pegar sua ultima atualização, `git checkout dev`, `git pull origin dev`
|
|
|
|
3. Criar uma nova branch indicando qual tarefa está sendo realizada `git checkout -b <autor>/<nome da tarefa>`
|
|
|
|
3. Criar uma nova branch indicando qual tarefa está sendo realizada `git checkout -b <número da tarefa>/<nome da tarefa separado por hífen>`
|
|
|
|
|
|
|
|
#### Aplicando alterações na branch
|
|
|
|
4. Após fazer alterações, pegar as últimas alterações da branch dev, para isso é preciso
|
| ... | ... | @@ -32,13 +58,13 @@ Aqui deve ser explicado como configurar o Ambiente para que os Desenvolvedores d |
|
|
|
- `git checkout dev`
|
|
|
|
- `git pull origin dev`
|
|
|
|
2. Voltar para sua branch e unificar as alterações
|
|
|
|
- `git checkout <autor>/<nome da tarefa>`
|
|
|
|
- `git checkout <número da tarefa>/<nome da tarefa separado por hífen>`
|
|
|
|
- `git merge dev`
|
|
|
|
3. Corrigir possíveis conflitos manualmente
|
|
|
|
|
|
|
|
#### Criando Merge request
|
|
|
|
5. Ao terminar a tarefa, enviar as alterações para o Gitlab e criar um Merge request.
|
|
|
|
6. Se aprovado, limpar ambiente deletando a branch concluida
|
|
|
|
- Deletar branch local `git branch -d <autor>/<nome da tarefa>`
|
|
|
|
- Deletar branch local `git branch -d <número da tarefa>/<nome da tarefa separado por hífen>`
|
|
|
|
- Deletar branch no gitlab na lista de branchs
|
|
|
|
|
