Prestações de serviço
Introdução
Serão descritos aqui os requisitos para prestações de serviço, separados por produtos. Os produtos denominados "Sistemas Web" agrupam os requisitos genéricos que são válidos para o grupo todo. Produtos com requisitos específicos serão descritos separadamente.
Qualquer PS que falhe em ter estes requisitos deve ser imediatamente devolvida e corrigida por parte do remetente.
Importante: Algumas prestações de serviço podem ter mais de um serviço solicitado ao mesmo tempo, desde que todos os requisitos mínimos de todos os serviços solicitados estejam adequados.
Toma-se como base para todos os produtos abaixo as seguintes regras:
-
Título deve ser
claro eclaro, conciso (deve ser fácil de localizar na lista de PS da equipe);e deve ser relacionado ao pedido em questão; -
Produto e Serviço preenchidos adequadamente (uma PS a respeito do Jenkins não pode ter ProGet selecionado)
- Uma exceção a esta regra seria uma PS relacionada a múltiplos serviços, que pode ser marcada como "Outros";
- Prioridade deve estar marcado corretamente, para não prejudicar o andamento adequado dos trabalhos (Não serão aceitas PS "urgentes" ou de "alta prioridade" que não tem essa necessidade);
- Chamado, caso tenha, deve ser preenchido para entendimento do contexto;
- Situação deve ser preenchida como "Em análise";
- Descrição deve estar preenchida de maneira clara, detalhada e com o português correto, evitando textos dúbios que podem levar à execução de um serviço errado;
DevOps
Bitbucket
- A descrição deve conter os seguintes dados:
- Nome do repositório (no formato de nome do projeto, por exemplo, Cebi.Usuarios - o nome informal do sistema pode ser diferente do nome do repositório);
- Qual o procedimento a ser feito e seu detalhamento. Por exemplo:
- Criação de novo repositório com nome no formato adequado, indicando quem, além do PO, poderá aceitar PRs em master (caso tenha, o PO deve ter autorizado, seja por mensagem anexada como print ou por comentário/observação no encaminhamento da PS) e informando se precisará de job do Jenkins (neste caso, contendo também todos os requisitos de uma PS para criação de job)
- Configuração de repositório com nome do repositório e qual o problema a ser resolvido;
- Inclusão de responsável por aceitar PRs em master com nome completo da pessoa e autorização do PO, seja por mensagem anexada como print ou por comentário/observação no encaminhamento da PS);
Jenkins
- A descrição deve conter os seguintes dados:
- Nome do job ou nome do sistema do job (no formato de nome do projeto, por exemplo, Cebi.Usuarios - o nome informal do sistema pode ser diferente do nome do job);
- Qual o procedimento a ser feito e seu detalhamento. Por exemplo:
- Criação de novo job com o repositório a qual se refere;
- Tipo de job, podendo ser projeto Web ou Biblioteca;
- Verificação de erro de build com o link direto para o log com erro;
- Manutenção de job, como troca de nome, troca de repositório, troca de JenkinsFile...
- Criação de novo usuário com nome completo da pessoa e e-mail corporativo;
Importante: para casos de verificação de erro de build a PS deve, necessariamente, ter passado por um desenvolvedor responsável e o mesmo deve incluir na solicitação o que ele já verificou/fez, pois muitas vezes, o erro é de compilação.