fluxo-e-versionamento.md

+| [Home](home) | [Planejamento](planejamento) | [Arquitetura Geral](arquitetura-geral) | [Front End](front-end) | [Back End](back-end) | [Banco de Dados](banco-de-dados) | [Design do Sistema e Mockups](design-do-sistema-e-mockups) | [Infraestrutura e Orçamento](infraestrutura-e-orçamento) | [Fluxo e Versionamento](fluxo-e-versionamento) |
+|--------------|------------------------------|----------------------------------------|-------------------------|-------------------------------|---------------------------------------------|------------------------------------------|-----------------------------|---------------------------|
+
+# Processo de Desenvolvimento
+
+## Descrição
+
+Esta seção é dedicada a apresentar o processo de desenvolvimento do time, incluindo a organização do trabalho, fluxo de desenvolvimento, comunicação e gerenciamento de riscos. O projeto consiste em um totem interativo com busca e mapeamento 3D para feiras e eventos, com foco em facilitar a localização de expositores e a interação dos visitantes.
+
+## Sumário
+
+- [Git Workflow](#git-workflow)
+- [Matriz de Responsabilidade](#matriz-de-responsabilidade)
+- [Plano de Comunicação](#plano-de-comunica%C3%A7%C3%A3o)
+- [Plano de Riscos](#plano-de-riscos)
+
+## Git Workflow
+
+### Branches
+
+#### Nomes
+
+Como padrão para nomes de branches, foi decidido o seguinte:
+
+```plaintext
+<numeroDaUS>/<nomeDoItem>-<detalheDoItem> (Caso seja uma User Story)
+<tipoDeItem>-<nomeDoItem> (Caso seja um componente)
+```
+
+Exemplo de Componentes:
+
+```plaintext
+US01/TelaDeBusca-filtroPorCategoria
+component-mapa3D
+component-leitorCracha
+```
+
+Exemplo de Páginas:
+
+```plaintext
+page-mapa3D
+page-relatorios
+```
+
+#### Criação
+
+Para garantir que o processo de desenvolvimento esteja sempre atualizado, lembre-se de executar o seguinte comando na branch dev antes de criar uma branch nova:
+
+```plaintext
+git pull origin dev
+```
+
+Depois da execução desse comando é necessário oficialmente criar a Branch, para isso, execute o seguinte comando:
+
+```plaintext
+git checkout -b <nomeDaBranch>
+```
+
+Assim que criar a branch, é necessário fazer um `push`para garantir que a mesma estará remota:
+
+```plaintext
+git push --set-upstream origin <nomeDaBranch>
+```
+
+Pronto! Agora você já pode começar a programar na sua Branch.
+
+### Commits
+
+Para que o código desenvolvido seja salvo em sua branch de maneira remota, é necessário realizar os comandos de `commit` e `push`
+
+#### Salvando Localmente
+
+Para garantir que apenas o código necessário para funcionamento da tarefa lembre-se de realizar o comando `add` apenas nos arquivos **essenciais** para a tarefa:
+
+```plaintext
+git add <nomeDoArquivo>
+```
+
+Depois de adicionar todos os arquivos que deseja salvar, execute o commando de commit com uma mensagem curta que represente o que foi trabalhado nesses arquivos adicionados:
+
+```plaintext
+git commit -m 'descrição da tarefa em português'
+```
+
+Não hesite em realizar vários commits, assim podemos ter docuemntado e salvo vários estados do desenvolvimento
+
+#### Salvando Remotamente
+
+Depois de finalizar o desenvolvimento, envie todos os commits da sua máquina para o servidor remoto. Para isso depois de realizar as etapas de salvamento local, salve remotamente com o comando `push`:
+
+```plaintext
+git push
+```
+
+### Merge Requests
+
+Depois de uma task ter sido desenvolvida e estiver pronta de acordo com os critérios de aceitação, é necessário que a mesma seja enviada para a branch de desenvolvimento. Para isso é necessário abrir um Merge Request pela platafora GitLab:
+
+#### Criando o Merge Request
+
+A criação pode ser realizada na seção Merge Requests do repositório em que a branch foi criada. Clicando no botão `New Merge Request` siga os seguintes passos:
+
+ 1. Selecionar a branch de origem (sua branch de desenvolvimento);
+ 2. Selecionar a branch de destino (branch dev);
+ 3. Selecione `Compare branches and continue`
+ 4. Em `Title`, escreva um título que descreva a funcionalidade adicionada ou bug corrigido;
+ 5. Em `Description`, escreva uma descrição com uma breve justificativa nos arquivos que foram alterados;
+ 6. Caso a tarefa seja visual (criação de componente/tela, correção de bug) adicione um gif exemplificando o uso (se considerar necessário);
+ 7. Na seção `Assignee`, selecione `Assign to me` para que fique registrado quem foi o responsável pelo desenvolvimento daquela tarefa (a pessoa selecionada será chamada caso o revisor tenha dúvidas sobre a tarefa);
+ 8. Em `Milestone` selecione a Sprint em que a tarefa foi realizada;
+ 9. Em `Labels`selecione qual é o tipo de tarefa que foi realizada;
+10. Por último, revise se os arquivos que estão sendo enviados estão corretos e clique em `Submit Merge Request`.
+
+#### Revisando o Merge Request
+
+A revisão de merge request pode ser realizada por qualquer desenvolvedor, mas é preciso da aprovação de pelo menos um AGES III ou AGES IV para que a mesma seja incorporada na dev.
+
+Na hora de revisar o Merge Request, entre na branch em sua máquina e teste a funcionalidade/bug/componente/tela de acordo com os critérios de aceitação apresentados no [Google Docs](https://docs.google.com/document/d/1iZBL0D5rp2U4b0HFPg5X2hVuwPMa1bKXwLbAjfXd3Jc/edit?usp=sharing).
+
+Caso haja pendências, relacionadas a documentação do código, padronização ou arquivos enviados, não exite em realizar um novo commit na branch com as mudanças necessárias antes de realizar a integração.
+