Padrões de uso do planner

Introduction

Para uma melhor organização das nossas demandas, usaremos como base algumas partes da metodologia Scrum. Com isso, no início da semana, é feito um Planejamento de Sprint Semanal, onde é levantado o que você fez na semana passada, o que deixou de fazer e o que você fará na semana em questão. Durante a semana são feitas Daily Meetings para acompanhar as demandas que estão em andamento na semana em questão.

Todas as reuniões serão feitas a partir das 8h da manhã, esteja disponível a partir deste horário.

Com a imensa quantidade de demandas que cada um do time tem, é imprescindível que todos adotem os padrões descritos para que possamos continuar entregando tudo com agilidade e excelência.

Nomenclature

Todos as tarefas deverão estar escritas, em inglês, com todas as palavras em letras minúsculas, conforme padrão a seguir:

<project> (<type>) : <subject>

Projects:

Todos os projetos que forem usados no Planner devem estar listados abaixo, ou seja, sempre que houver um novo projeto, acrescente na lista abaixo com nome e descrição:

all-in-portal: Dashboard contendo todos as ferramentas do Grupo Sozo
app-vlg: Aplicativo mobile da VLG Investimentos
site-gsozo: Site do Grupo Sozo
site-vlgi: Site da VLGI Investimentos. a.k.a.: vlg investimentos, vlgi investimentos, vlgi assessoria
site-vlgs: Site da VLGI Vida. a.k.a.: vlg seguros, vlgi vida, zermatt
site-vlgc: Site da VLGI Corporate. a.k.a.: vlg corporate
site-m1m: Site do m1m. a.k.a: vlgi news
site-vlgi-asset: Site da vlgi asset
api-vlg: API Rest para consumir dados do banco VLGI Investimetnos
api-open-data: API Rest para consumir dados abertos como o do comparador de fundos
strapi-m1m: Painel administrativo do m1m (isso inclui o banco)
strapi-press-media: Painel administrativo de mídia e imprensa
strapi-educational: Painel administrativo da plataforma educacional
sozo-auth: Aplicação de autenticação do grupo sozo (isso inclui o banco)
funds-extractor: Extrator de dados para o comparador de fundos (isso inclui o banco)
funds-comparator: Comparador de fundo (widget)
power-bi: Dashboards construídos no power-bi
n8n: Automações utilizando o n8n
airflow: Automações utilizando o airflow
automations: Automações diversas, sem um framework ou ferramenta bem definido (scripts inclusos)
course: Criação de cursos para instrução dos colaboradores (e.x. Microsoft Team, Office365)
gerencial-vlg: Gerencial da VLG Investimentos
gerencial-vlg-seg: Gerencial da VLG Seguros
gerencial-vlg-corp: Gerencial da VLG Corporate
db-vlg: Banco da VLG Investimentos
db-vlg-seg: Banco da VLG Seguros
db: Bancos de dados diversos
gsozo-pkg: Pacote com diversos módulos úteis para automações
variable-income: Projeto com a mesa de Renda Variável
dbt: Ferramenta para ELT
infra: Projeto de reestruturação e padronização da infra do grupo Sozo
rebranding-operation: Operação para alterar a identidade visual das aplicações para a nova marca
pdf-viewer: Aplicação para visualizar pdf, evitando copia e download
redmine: Instância do Redmine para gerenciar projetos
app-stack: Projeto para criar e estudar viabilidade de stacks de desenvolvimento mobile

Types:

Para os casos que não cabem tipo, que fogem de um projeto de desenvolvimento clássico, este atributo é opcional.

research: A research task about a technology or platform
build: Build related changes (eg: npm related/ adding external dependencies)
deploy: A deployment related task (eg: researching hosting platforms or adding code specific for a certain platform)
chore: A code change that external user won't see (eg: change to .gitignore file or .prettierrc file)
feat: A new feature
fix: A bug fix
docs: Documentation related changes
refactor: A code that neither fix bug nor adds a feature. (eg: You can use this when there is semantic changes like renaming a variable/ function name)
perf: A code that improves performance
style: A code that is related to styling
test: Adding new test or making changes to existing test
upgrade: Upgrade dependencies, packages (eg: upgrade strapi version)

Subjects:

Use imperative, present tense (e.g.: use "add" instead of "added" or "adds").

Don't use dot(.) at the end.

Don't capitalize first letter.

Examples:

No planner possuímos demandas de mais alto nível de detalhamento, segue exemplos abaixo:

site-vlg (feat): add new slide with video to home
n8n: update app to aws
app-vlg (style): change login button to green

OBS: Nem todo commit é uma atividade no planner. Como dito, o planner possui alto nível de detalhamento. Abaixo segue um exemplo para a mesma atividade, com seus commits intermediários para concluir a atividade do planner

Exemplo:

No planner:

site-vlg (feat): add new slide with video to home

No git:

nav-main (refactor): allow to force change of navigation colors
carousel (refactor): allow handle on change
checkEnvByWidth (refactor): changed devices sizes
(feat): add new home1 slide with video

Flow of Tasks

1. Criação da Demanda

Chegou uma nova demanda ou tive uma ideia, siga os passos:

Criar tarefa no backlog, seguindo o padrão descrito acima (nome curto, detalhes na descrição);
Adicionar as seguintes tags: team, company and status(optional);
Atribuir as pessoas envolvidas na demanda, se já souber;
Se souber, adicione a prioridade da demanda.

Example:

2. Liberação da Demanda

Após a criação da demanda, é necessária a liberação dela, então siga os passos:

Ainda no backlog:

Se necessário solicitar liberação executar 2, 3, 4, 5 abaixo, se não pular p/ o 6;
Solicitar liberação do head/governança/board por e-mail;
Adicionar tag s-waiting-authorization;
Adicionar data para cobrar a liberação;
Se já aprovado, remover a tag de liberação e seguir passos abaixo;
Se já souber, adicionar a prioridade da demanda.

3. Execução da Demanda (Parte 1)

Demanda devidamente autorizada, decidido que essa demanda será feita na semana em questão, siga os passos:

Mover para sprint backlog;
Adicionar data estimada de conclusão, ou data de algum check point;
Adicionar data estimada para início da atividade (se necessário);
Adicionar a prioridade da demanda;
Atribuir envolvidos na execução (obrigatório).

4. Execução da Demanda (Parte 2)

Vai começar a demanda agora? Siga os passos:

Marcar como demanda em andamento (por mais que leve dias, mantenha ela neste estado);
Fazer a demanda.

5. Ação de Terceiros

Se você precisa da resposta/informação de outra pessoa, siga os passos:

Adicionar tag s-waiting-feedback;
Solicitar o que precisa, a quem precisa;
Adicionar data para cobrar o retorno;
Recebido o retorno, remover a tag.

6. Conclusão da Demanda

Se você já finalizou a demanda, siga os passos:

Se necessário validação, executar passo abaixo, se não só marcar como concluído;
Adicionar tag s-waiting-validation;
Adicionar data para cobrar a validação;
Se validado e aprovado, remover a tag e marcar demanda como concluída.

7. Pausa na Demanda

Por algum motivo você teve de dar uma pausa na demanda que estava em andamento, siga os passos:

Adicionar tag s-paused;
Manter no sprint backlog e como em andamento;