Diretrizes de Gestão de Configuração
Índice
Objetivo
Esta página descreve como estão definidos os itens de configuração, baselines e níveis de controle nos projetos e processos organizacionais de Gerência de Portfólio de Projetos e Medição.
Nível de Controle
Os documentos e artefatos gerados pelos projetos e processos organizacionais são considerados itens de configuração e são classificados entre:
- Formal
Itens controlados com histórico de alterações e recuperação de versões anteriores, com a necessidade de solicitação formal para a realização de alterações. São artefatos que definem os requisitos e que contenham informações para a produção do produto a ser entregue (Exemplos: códigos fonte, documento de arquitetura, documentos técnicos enviados pelo cliente, outros documentos técnicos). As modificações em artefatos formais são autorizadas através de tickets na ferramenta Redmine ou tasks no Youtrack e estas devem seguir o padrão abaixo:
#ID Alteração de artefato: <nome do artefato>
Sendo que #ID é o número da issue na ferramenta (Redmine ou Youtrack).
- Versionado
Itens controlados com histórico de alterações e recuperação de versões anteriores, sem a necessidade de solicitação formal para a realização de alterações. São artefatos de gestão (por exemplo: atas, relatórios gerenciais, coleta de indicadores) e demais artefatos que não se encaixem como “Formal”.
Nos tópicos a seguir serão apresentados os itens de configuração definidos para os projetos, bem como seus níveis de controle e acesso.
Repositórios e Estrutura Padrão de Pastas
Os projetos utilizam pelo menos dois repositórios distintos, um para os artefatos de gestão nomeado nesse documento como repositório de gestão e outro para os artefatos que compõem o produto a ser produzido ou mantido, nomeado nesse documento como repositório de produto. Os processos organizacionais possuem pelo menos um repositório para armazenamento de artefatos e registros de ações de acompanhamento. Os projetos devem indicar os repositórios a serem utilizados e pode ser utilizado mais de um repositório de produto.
- Repositórios de gestão do projeto
O repositório de gestão utiliza a ferramenta Redmine e esse ambiente é administrado pela MSTECH. A utilização desse repositório é obrigatória para todos os projetos.
Repositório de gestão do projeto: http://sg-redmine.mstech.com.br/ > Projetos > Nome do Projeto
- Repositórios de Produto
O repositório de artefatos técnicos do produto pode utilizar a ferramenta TFS ou GitLab. Ambos os ambientes são administrados pela MSTECH e cada registro de projeto (na ferramenta SharePoint) possui a informação da ferramenta utilizada. A utilização de pelo menos um desses repositórios é obrigatória para todos os projetos. Além disso, a ferramenta Youtrack deve ser utilizada para gestão do backlog e apontamento de horas.
Repositórios de produto: tfs:8080/tfs/ > Collection > Produto gitlab.mstech.com.br/ > Produto https://youtrack.mstech.com.br/ > Container do produto
- Repositório de Garantia da Qualidade
O repositório oficial de Garantia da Qualidade utiliza a ferramenta Redmine com o nome “Garantia da Qualidade”. O ambiente é administrado pela MSTECH e sua utilização é obrigatória.
Repositório: http://sg-redmine.mstech.com.br/ > Projetos > Garantia da Qualidade
- Repositórios de Gestão de Portfólio de Projetos
O repositório de uso do processo de Gestão de Portfólio de Projetos encontra-se na ferramenta Redmine com o nome “Gestão de Portfólio de Projetos”. O ambiente é mantido pela MSTECH e a utilização é obrigatória.
Repositórios: http://sg-redmine.mstech.com.br/ > Projetos > Gestão de Portfólio de Projetos
- Repositórios de Medição
O repositório para armazenamento de artefatos concluídos de medição e análises de indicadores utiliza a ferramenta Redmine com o nome “Medição”. O ambiente é administrado pela MSTECH e sua utilização é obrigatória.
Repositório: http://sg-redmine.mstech.com.br/ > Projetos > Medição
- Repositório de Diretrizes
Todas as diretrizes existentes são mantidas na wiki corporativa da MSTECH.
Repositório: https://wiki.mstech.com.br/ > Padrões de Desenvolvimento MSTECH > Diretrizes
Controle de Acessos
Para o repositório de gestão de projetos, o acesso é estabelecido no Redmine, conforme indicado abaixo:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Colaboração |
| Scrum Master | Colaboração |
| Desenvolvedores | Colaboração |
| Analistas de Testes | Colaboração |
| Analistas de QA | Leitura |
| Responsável por GPP | Colaboração |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Colaboração |
Para artefatos de produtos, o acesso ao repositório no TFS é composto da seguinte forma:
| Papeis | Repositório | |||
|---|---|---|---|---|
| Src | Docs | Tests | Build | |
| Product Owner | Leitura | Colaboração | Leitura | Leitura |
| Scrum Master | Colaboração | Colaboração | Colaboração | Colaboração |
| Desenvolvedores | Colaboração | Colaboração | Leitura | Colaboração |
| Analistas de Testes | Leitura | Colaboração | Colaboração | Colaboração |
| Analistas de QA | Leitura | Leitura | Leitura | Leitura |
| Responsável por GPP | Leitura | Leitura | Leitura | Leitura |
| Responsável por Medição | Leitura | Leitura | Leitura | Leitura |
| Diretoria | Leitura | Leitura | Leitura | Leitura |
| Escritório de PCP | Leitura | Leitura | Leitura | Leitura |
| Arquiteto | Colaboração | Colaboração | Colaboração | Leitura |
Já o acesso ao repositório no GitLab é composto da seguinte forma:
| Papeis | Repositório |
|---|---|
| Src | |
| Product Owner | Colaboração |
| Scrum Master | Colaboração |
| Desenvolvedores | Colaboração |
| Analistas de Testes | Colaboração |
| Analistas de QA | Colaboração |
| Responsável por GPP | Colaboração |
| Responsável por Medição | Colaboração |
| Diretoria | Colaboração |
| Escritório de PCP | Colaboração |
| Arquiteto | Colaboração |
Por fim, o repositório para gestão do backlog do produto é configurado da forma abaixo:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Colaboração |
| Scrum Master | Colaboração |
| Desenvolvedores | Colaboração |
| Analistas de Testes | Colaboração |
| Analistas de QA | Leitura |
| Responsável por GPP | Leitura |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Colaboração |
Para cada célula, haverá um membro da equipe com acesso suficiente para administrar todas as permissões dos repositórios de produtos atendidos pela célula. Na falta desse integrante, deve ser nomeado um substituto para assumir a responsabilidade de manter as permissões dos repositórios devidamente atribuídas.
Para artefatos gerados pelo QA, o acesso ao repositório se faz da seguinte maneira:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Leitura |
| Scrum Master | Leitura |
| Desenvolvedores | Leitura |
| Analistas de Testes | Leitura |
| Analistas de QA | Colaboração |
| Responsável por GPP | Leitura |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Leitura |
| Arquiteto | Leitura |
Para artefatos gerados por GPP na ferramenta Redmine, o acesso ao repositório se faz da seguinte maneira:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Leitura |
| Scrum Master | Leitura |
| Desenvolvedores | Leitura |
| Analistas de Testes | Leitura |
| Analistas de QA | Colaboração |
| Responsável por GPP | Colaboração |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Leitura |
Para artefatos gerados por GPP na ferramenta Sharepoint, o acesso ao repositório se faz da seguinte maneira:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Colaboração |
| Scrum Master | Colaboração |
| Desenvolvedores | Leitura |
| Analistas de Testes | Leitura |
| Analistas de QA | Leitura |
| Responsável por GPP | Colaboração |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Leitura |
Para os artefatos de medição, o acesso ao repositório é composto da forma abaixo:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Leitura |
| Scrum Master | Leitura |
| Desenvolvedores | Leitura |
| Analistas de Testes | Leitura |
| Analistas de QA | Leitura |
| Responsável por GPP | Leitura |
| Responsável por Medição | Colaboração |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Leitura |
O repositório que armazena as diretrizes da MSTECH, por sua vez, possui o acesso composto da seguinte maneira:
| Papeis | Repositório |
|---|---|
| Único | |
| Product Owner | Leitura |
| Scrum Master | Leitura |
| Desenvolvedores | Leitura |
| Analistas de Testes | Leitura |
| Analistas de QA | Leitura |
| Responsável por GPP | Leitura |
| Responsável por Medição | Leitura |
| Diretoria | Leitura |
| Escritório de PCP | Colaboração |
| Arquiteto | Leitura |
Baseline de Produto
As baselines de cada entrega do produto deverão ser nomeadas de acordo com a regra abaixo.
v<X.X.X.X.>
Exemplo: v1.2.1.3
Obs.: as baselines são estabelecidas utilizando labels (no TFS) ou tags (no GitLab).
Itens de Configuração
As tabelas abaixo estão divididas de acordo com os repositórios definidos (de gestão, produto, QA, GPP e Medição) e mostram a identificação dos itens de configuração e as seguintes informações: identificação do item, regra de nomenclatura, local para armazenamento, nível de controle, obrigatoriedade de ser gerado, necessidade de aprovação pelo cliente, e baseline onde é incorporado.
Lista de itens no repositório do projeto
Redmine:
| Artefato (por Projeto/Produto) | Regra de Nomenclatura | Armazenamento (do artefato concluído) | Tipo | Obrigatório? | Aprovado pelo cliente? | Baseline |
|---|---|---|---|---|---|---|
| Necessidades do cliente | (Nome do projeto)-NecessidadesCliente | Documentos do pré-projeto no Redmine | Formal | Sim | Sim | Entrega |
