Skip to main content

Fluxo de Desenvolvimento Frontend

Este documento descreve as etapas obrigatórias para o desenvolvimento de novas funcionalidades e correções no frontend da Smart NX (SNX). O objetivo é garantir a qualidade técnica, revisão contínua e rastreabilidade de todo o código entregue.

1. Planejamento (Planning)​

O sucesso do desenvolvimento começa com uma definição clara da interface:

  • Ideal: O desenvolvimento deve iniciar apenas com o mock de alta fidelidade pronto e aprovado.
  • Exceção: Caso o mock final não esteja disponível, é aceitável iniciar a partir de um esboço no Stich (ou ferramenta similar) desenvolvido pelo Product Manager (PM).
  • Início: O desenvolvedor só deve iniciar a codificação após ter clareza total dos fluxos e comportamentos definidos nestes artefatos.

2. Estratégia de Branching​

Utilizamos um fluxo de branches baseado em Histórias e Tarefas:

  • Branch de História: Para cada história/épico no Jira, deve-se criar uma branch principal chamada history/NXS-??? (onde NXS-??? é o ID da história).
  • Branches Filhas: Cada tarefa menor ou sub-task da história deve ser desenvolvida em branches filhas, derivadas da history/NXS-???.
  • Merge Final: A branch history/NXS-??? só deve ser mergeada na branch develop após a conclusão e aprovação de todos os seus componentes.

3. Processo de Code Review e Aprovação​

Para garantir agilidade sem perder qualidade:

  • PRs Menores: Em vez de um único PR gigante ao final da história, o desenvolvedor deve abrir Pull Requests menores das branches filhas para a branch de história (history/NXS-???).
  • Aprovadores Obrigatórios: O código deve ser revisado e aprovado pelo Líder de Front e pela Referência Técnica de Front.
  • Aprovação da História: Uma vez que todas as sub-PRs foram revisadas e aprovadas individualmente, a branch de história (history/NXS-???) pode ser mergeada na develop.

4. Fluxograma do Processo​

Histórico de Versões​

DataVersãoAutor / RevisorAlterações
08/04/2026v1.0.0Juathan Coelho DuarteCriação do guia de fluxo de desenvolvimento e fluxograma