Gestão de Configuração de Projetos

Objetivo

Esta diretriz descreve como estão definidos os itens de configuração, baselines e níveis de controle nos Projetos de Desenvolvimento e nos Projetos de Manutenção.

Os documentos e artefatos gerados pelos Projetos são considerados itens de configuração e são classificados entre:

• Gerenciado: 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).

• 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: Planos de Gestão, Atas, Relatórios Gerenciais, Coleta de Indicadores) e demais artefatos que não se encaixem como Gerenciado.

Nos tópicos a seguir serão apresentados os Itens de Configuração definidos para os Projetos de Desenvolvimento e Projetos de Manutenção, bem como seus níveis de controle e acesso.

Obs.: As modificações em artefatos gerenciados são autorizadas através de tickets na ferramenta adotada pelo Projeto.

Material de Suporte

1. Repositório e estrutura de pastas

Os projetos utilizam pelo menos dois repositórios distintos para os artefatos que compõem o produto e o projeto a ser produzido ou mantido: GIT e/ou Google.
Estes repositórios são administrados pela Almaviva e utilização destes é obrigatória para todos os projetos.

Deverá se indicado, através do artefato "Plano de Projeto e Produto", os devidos repositórios utilizados pelo projeto, podendo ser utilizado mais de um repositório.

O controle de versões é realizado pelos repositórios indicados.

Repositório de gestão do projeto

Repositório de gestão do produto

Quando existir em contrato a obrigatoriedade de alguma pasta ser armazenadas em ambiente controlado pelo cliente (ex. pasta SRC), é obrigatório seguir o "Guia Customização de Processos" e indicar a devida customização no arteafato "Plano de Projeto e Produto" com as seguintes informações:

• Pastas no ambiente do cliente;
• Localização do repositório;
• Ferramenta utilizada;
• Controle de acesso às subpastas;
• Nomenclatura das baselines;
• Origem da customização (ex. local do contrato).

Quando o cliente não solicitar um padrão específico para nomenclatura das baselines, deve ser utilizada a nomenclatura definidas neste documento e registrar da seguinte forma: “De acordo com o padrão Almaviva”.

2. Controle de acessos

Para os Projetos, o controle de acesso ao repositório é estabelecido através do repositório Google conforme indicado abaixo:

Diretórios	PMO	Gerente de Projeto	Arquiteto	Líder Técnico	Equipe do Projeto	Diretoria	Área da Qualidade
Gestão	C/A	C/A	C/A	C/A	C	C	C
Desenvolvimento	C/A	C/A	C/A	C/A	C/A	C	C
Comercial	C/A	C/A	–	–	–	C/A	C

Legenda:

C = Consulta e A = Altera

3. Baseline do Produto

Para projetos hospedados no GIT, a definição da baseline do produto é estabelecida pela configuração correta do projeto:

• Pipelines devem ser configuradas de acordo com as diretrizes do MITH, garantindo a integridade das entregas;
• Para assegurar a rastreabilidade bidirecional das entregas, é obrigatório que as requisições de merge (merge requests) estejam diretamente relacionadas à issue;
• Na etapa de verificação do código fonte, será realizada a validação dos relacionamentos dos merge requests para garantir sua conformidade.

Para projetos não hospedados no GIT, as baselines no repositório de Produto serão nomeadas de acordo com a seguinte regra:

– NOMECLIENTE-NOME_PROJETO-ENTREGA-BAS(X)

Onde X deve ser incrementado a cada baseline gerada. As baselines são estabelecidas com a utilização das TAGs no Google.

Quando a pasta SRC for armazenada no em ambiente controlado pelo cliente, as baselines são geradas de acordo com a ferramenta de controle de versão estabelecida e a regra de nomenclatura pode ser redefinida. Essas informações devem ser registradas no Plano de Projeto e Produto.

4. Itens de configuração do projeto

A tabela abaixo está dividida de acordo com os repositórios de Gestão do Projeto (GIT e Rep. Google) e mostra a identificação dos itens de configuração e as seguintes informações: Identificação do item, Abordagem, Código do Item, Regra de Nomenclatura, Local para armazenamento (GIT ou Rep. Google), Nível de Controle, Obrigatoriedade de ser gerado, Necessidade de aprovação pelo cliente e a baseline onde é incorporada (quando aplicável).

Item de Configuração	Abordagem	Código	Regra de Nomenclatura	Diretório / Repositório	Nível de Controle	Obrigatório (S/N)?	Aprovado Pelo Cliente (S/N)?	Baseline
Análise de Viabilidade do Planejamento	Ambos	–	GIT: Milestone [identificação do Milestone]	GIT do Projeto: Milestone	Versionado	S	N	N/A
Apresentação Kickoff	Ambos	–	Google: NOME PROJETO_KICK_OFF_ABERTURA_V1.0_AAAAMMDD	Rep. Google: Gestao/2-Relatorios_de_Gestao/Apresentacao	Versionado	S	N	N/A
Atas de Reunião	Ambos	–	Git: Label "Ata de Reunião" / Doc.: AAAAMMDD-ATA-NOME PROJETO	GIT: Issue / Google: Gestao/2-Relatorios_de_Gestao/Atas	Versionado	N	N	N/A
CheckList de Baseline de Auditoria	Ambos	CHECK	Doc.: CHECK-BASELINE-	Google: Desenvolvimento/CHK/BL	Versionado	S	N	N/A
CheckList de Verificação de Casos de Uso / Histórias	Preditiva	CHECK	Doc.: CHECK-UC-	Google: Desenvolvimento/CHK/UC	Versionado	S	N	N/A
Checklist de Verificação de Código Fonte	Ambos	–	GIT: Issue - Checklist de Código-Fonte / Doc.: CHECK-SRC-UC-_NET ; CHECK-SRC-UC-_JAVA	GIT: Issue / Google: Desenvolvimento/CHK/SRC	Versionado	S	N	N/A
Checklist de Baseline de Entrega	Ágil	–	GIT: Milestone [identificação do Milestone]	GIT: Milestone	Versionado	S	N	N/A
Checklist de Verificação de Pacote de Entrega	Preditiva	CHECK	Doc.: CHECK---	Google: Desenvolvimento/CHK/SRC	Versionado	S	N	N/A
Checklist de Iniciação	Ambos	–	Git: Plano de Projeto e Produto / Doc.: PLP_	Git: Wiki / Google: Gestao/4-Planos	Versionado	S	N	N/A
Checklist de Verificação de Requisito Funcional	Preditiva	CHECK	Doc.: CHECK-UC-RF-	Google: Desenvolvimento/CHK/UC	Versionado	N	N	N/A
Checklist de Verificação do Documento de Canais	Preditiva	CHECK	Doc.: CHECK-	Google: Desenvolvimento/CHK/UC	Versionado	S (projetos de portais)	N	N/A
CheckLists de Verificação de Documento de Arquitetura	Ambos	CHECK	Doc.: CHECK-DAQ-	Google: Desenvolvimento/CHK/DAQ	Versionado	S	N	N/A
Cronograma	Preditiva	–	Doc.: CRO-	Google: Gestao/3-Cronograma	Versionado	S	N	N/A
Contrato	Ambos	–	–	Google: Gestao/1-Comercial	Gerenciado	S	S	Novo Desenvolvimento: Integra / Manutenção: N/A
Proposta	Ambos	–	–	Google: Gestao/1-Comercial	Gerenciado	S	N	Novo Desenvolvimento: Integra / Manutenção: N/A
Estimativa de Componente de Manutenção	Preditiva	ESTCM	Doc.: ESTCM-SM--	Google: Gestao/1-Comercial/Estimativas	Versionado	S	N	N/A
Estimativas de Iteração Componente de Manutenção	Preditiva	ESTIT-CM	Doc.: ESTIT-CM-	Google: Gestao/1-Comercial/Estimativas	Versionado	S	N	N/A
Estimativa de Tamanho e Esforço em APF	Ambos	APF	--APF / APF-SM-- / --APF-	Google: Gestao/1-Comercial/Estimativas	Versionado	S	N	N/A
Estimativa de Tamanho e Esforço em UCP	Ambos	UCP	--UCP / UCP-SM--	Google: Gestao/1-Comercial/Estimativas	Versionado	S	N	N/A
Estimativas de Portais	Ambos	PORT	--PORT / PORT-SM--	Google: Gestao/1-Comercial/Estimativas	Versionado	S	N	N/A
Planilha Criação Timesheet	Ambos	TS	Doc.: TIMESHEET-	Google: Gestao/6-Documentos_complementares	Versionado	N	N	N/A
Planilha de Formação de Preços	Ambos	PFP	Doc.: PFP-	Google: Gestao/1-Comercial	Versionado	S	N	N/A
Plano de Composição	Preditiva	PLC	Doc.: PLC-	Google: Desenvolvimento/Planos	Versionado	S	N	N/A
Plano de Comunicação	Ambos	–	Git: Plano de Projeto e Produto / Doc.: PLP_	Git: Wiki / Google: Gestao/4-Planos	Versionado	S	N	N/A
Plano de Projeto e Produto	Ambos	–	Git: Plano de Projeto e Produto / Doc.: PLP_	Git: Wiki / Google: Gestao/4-Planos	Versionado	S	N	N/A
Plano de Riscos, Oportunidades e Problemas	Ambos	–	GIT: Issues no Board	GIT: Board do Projeto	Versionado	S	N	N/A
Proof of Concept	Ambos	POC	Doc.: POC	Google: Desenvolvimento/POC	Versionado	N	N	N/A
Proposta Técnica	Ambos	PTEC	Doc.: --PTEC	Google: Gestao/1-Comercial	Gerenciado	S	S	Novo Desenvolvimento: Integra / Manutenção: N/A
Relatório de Análise e Decisão	Ambos	DAR	Doc.: -DAR	Google: Desenvolvimento/Documentação Complementar	Versionado	Quando aplicável	N	N/A
Relatório de Análise e Decisão para Arquitetura	Ambos	DAR-ARQ	Doc.: -DAR-ARQ	Google: Desenvolvimento/Documentação Complementar	Versionado	S	N	N/A
Relatório de Status e Progresso do Projeto	Ambos	STATUS	Doc.: RelatorioStatusProgresso_	Google: Gestao/2-Relatorios_de_Gestao	Versionado	S	N	N/A
Resultado do Teste	Ambos	–	Doc.: RTST-- ou registro no task da issue	Google: Desenvolvimento/Testes / GIT: Issue	Versionado	S	N	N/A
Solicitação de Mudança	Preditiva	SM	Doc.: SM--	Google: Desenvolvimento/SM	Versionado	Quando aplicável	S	N/A
Controle Integrado de Mudança	–	–	Controlado pelo EPM	Lista "Controle Integrado de Mudança" no site do projeto no EPM	Versionado	Desenvolvimento: aplicável / Manutenção: S	S	N/A
Termo de Aceite	Preditiva	–	Doc.: TermoAceite_	Google: Gestao/5-Aceite_Cliente	Versionado	Conforme cronograma	S	N/A
Transição	Ambos	–	Git: Plano de Projeto e Produto / Doc.: PLP_	Git: Wiki / Google: Gestao/4-Planos	Versionado	Gestão: Quando aplicável / Operação: S	N	N/A
CEP	Ambos	–	Google: NOME PROJETO_CEP_AAAAMMDD	Rep. Google do Projeto: Gestao/2-Relatorios_de_Gestao/Apresentacao	Versionado	S	N	N/A
Plano Físico Financeiro	Ambos	–	Google: CLIENTE - Plano Físico Financeiro-AAAA	Rep. Google do Projeto: Gestao/4-Planos	Versionado	S	N	N/A

Legenda:

NS: Número sequencial

YYYYMMDD: Ano, Mês e Dia.

5. Itens de configuração do produto

A tabela abaixo está dividida de acordo com o repositório Gestão do Produto e mostra a identificação dos itens de configuração e as seguintes informações: Identificação do item, abordagem, Código do Item, Regra de Nomenclatura, Local para armazenamento (GIT ou Rep. Google), Nível de Controle, Obrigatoriedade de ser gerado, Necessidade de aprovação pelo cliente e baseline onde é incorporada.

Item de Configuração	Abordagem	Código do Documento	Regra de Nomenclatura	Diretório	Nível de Controle	Obrigatório (S/N)?	Aprovado Pelo Cliente (S/N)?	Baseline
Caso de Uso / Histórias de Usuário	Ambos	UC / HU	GIT: Issue com label "História de Usuário" ou Docs.: UC-\<NR>-\<NOME CASO USO> OU HU-\<NR>-\<NOME HISTORIA>	GIT: Issue Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	S	S	Integra
Casos / Cenários de Teste	Ambos	TC	GIT: Registro no task da issue Docs.: TC-\<NR>-\<NOME CASO USO>	GIT: Issue Rep. Google do Projeto: Desenvolvimento\Casos de Teste	Versionado	S	N	N/A
Código Fonte	Ambos	–	Não existe regra.	GIT: Issue - Task com label "Implementação" ou Rep. Google do Projeto: Desenvolvimento\SRC	Gerenciado	S	N	Integra
Diagrama de Atividades	Preditiva	DA	Doc.: DA-UC-\<NR>-\<NOME CASO USO>	Rep. Google do Projeto: \Desenvolvimento\ Diagramas	Gerenciado	N	N	Integra
Diagrama de UC	Preditiva	DUC	Doc.: DUC-UC-\<NR>-\<NOME CASO USO>	Rep. Google do Projeto: \Desenvolvimento\ Diagramas	Gerenciado	N	N	Integra
Diagramas	Preditiva	DIAG	Doc.: DIAG-\<DIAGRAMA>	Rep. Google do Projeto: Desenvolvimento\Diagramas	Gerenciado	N	N	Integra
Documento de Arquitetura	Ambos	DAQ	Doc.: DAQ-\<NOME DO PROJETO>	Rep. Google do Projeto: Desenvolvimento\DAQ	Gerenciado	S	N	Integra
Documento de Canais	Preditiva	DOCCA	Doc.: DOCCA-\<NOME DO CANAL>	Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	S (para projetos de portais)	S	Integra
Especificação Suplementar	Preditiva	SUP	Doc.: SUP-\<NOME PROJETO>	Rep. Google do Projeto: Desenvolvimento\Documentação Complementar	Gerenciado	N	N	Integra
Glossário	Ambos	GLO	Doc.: GLO-\<NOME PROJETO>	Rep. Google do Projeto: Desenvolvimento\Requisitos	Versionado	N	N	N/A
Manual de Instalação	Ambos	MANINST	MANINST	Rep. Google do Projeto: Desenvolvimento\Manuais	Gerenciado	S	N	Integra
Manual do Usuário	Ambos	MANU	MANU	Rep. Google do Projeto: Desenvolvimento\Manuais	Versionado	N	N	Integra
Mensagens do Sistema	Ambos	MSIS	MSIS	Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	N	N	Integra
Modelagem de Dados	Ambos	MER	MER-\<Nº ou NOME DA ENTREGA>	Rep. Google do Projeto: Desenvolvimento\Banco de Dados\MER	Gerenciado	S	N	Integra
Plano de Implementação	Ambos	PLI	GIT: Task com label "Implementação" na issue Doc: PLI-NUMERO-DO-CASO-DE-USO	GIT: Task Issue Rep. Google do Projeto: Desenvolvimento\Planos	Gerenciado	S	N	Integra
Protótipos	Ambos	PROT	\<YYYYMMDD>-PROT Ou \<YYYYMMDD>-PROT-UC-\<NR>-NOME DO UC>	Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	N	N	Integra
Regra de Negócio	Ambos	RNG	RNG	Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	N	N	Integra
Requisitos Funcionais	Ambos	RF	RF	Rep. Google do Projeto: Desenvolvimento\Requisitos	Gerenciado	N	N	Integra

Legenda:

YYYYMMDD: Ano, Mês e Dia.