Configurar projetos do GitHub

Compreender o escopo e a propriedade do projeto é crucial para uma colaboração bem-sucedida entre os Projetos do GitHub e os Painéis do Azure. Nesta unidade, exploraremos as principais considerações para definir os limites e as responsabilidades do projeto.

Âmbito do projeto e decisões de propriedade

Organização vs. Projetos de Usuário - Matriz de Decisão:

Fator	Projeto da Organização	Projeto de Usuário
Colaboração em equipa	Trabalho multi-equipa e multifuncional	Experiências individuais ou em pequenas equipas
Governação	Processos de aprovação formal, pistas de auditoria	Iteração leve e rápida
Visibilidade	Transparência em toda a empresa	Visibilidade individual ou restrita
Controlo de acesso	Permissões baseadas em função, SSO corporativo	Controlo individual
Ciclo de vida	Cargas de trabalho de produção a longo prazo	Protótipos, aprendizagem, testes

Recomendações de boas práticas:

• Usar projetos de organização para aplicativos de produção e serviços compartilhados
• Aproveite os projetos do usuário para prova de conceitos e aprendizado individual
• Considere a governança de dados e os requisitos de conformidade ao escolher o escopo

Fluxo de trabalho de criação de projetos

Para projetos de organização:

1. Navegue até a página principal da sua organização no GitHub
2. Clique em Projetos na navegação da organização
3. Selecione o menu suspenso Novo projeto → Novo projeto
4. Escolha o modelo de projeto apropriado com base nas necessidades do fluxo de trabalho

Para projetos de usuários:

1. Clique no seu avatar → Seus projetos
2. Selecione o menu suspenso Novo projeto → Novo projeto
3. Selecionar modelo alinhado com os objetivos do projeto

Guia de seleção de modelos de projeto:

Template	Caso de uso	Principais características
Backlog da equipe	Planeamento de sprint, desenvolvimento de funcionalidades	Pontos de história, ciclos de sprint
Feature	Roteiro do produto, planejamento de lançamento	Marcos e dependências
Triagem de bugs	Gestão de questões, garantia de qualidade	Gravidade, prioridade, acompanhamento de status
Blank	Fluxos de trabalho personalizados, processos especializados	Flexibilidade total de personalização

Documentação do projeto e estratégia de comunicação

Melhores práticas para README e descrições:

1. Navegue até ao seu projeto
2. Clique no menu de configurações (três pontos) no canto superior direito
3. Selecione Configurações
4. Crie documentação abrangente do projeto:

Estrutura de Descrição do Projeto:

• Finalidade: Declaração clara dos objetivos e do âmbito do projeto
• Partes interessadas: principais membros da equipe, patrocinadores e tomadores de decisão
• Critérios de sucesso: Resultados mensuráveis e critérios de aceitação
• Linha do tempo: principais marcos e expectativas de entrega

Estrutura do Conteúdo do README:

# Project Name

## Overview

Brief description of project goals and context

## Getting Started

Prerequisites and setup instructions

## Workflow Guidelines

- Issue creation and labeling standards
- Review and approval processes
- Communication protocols

## Team Information

Contact details and responsibilities

Exemplo de modelo LEIA-ME empresarial:

# Customer Portal Enhancement Project

## Project Overview

Modernize customer self-service portal to improve user experience and reduce support ticket volume by 30%.

## Key Stakeholders

- **Product Owner**: Name (email@company.com)
- **Tech Lead**: Name (email@company.com)
- **UX Designer**: Name (email@company.com)

## Success Metrics

- Page load time < 2 seconds
- User satisfaction score > 4.2/5
- Support ticket reduction of 30%

## Workflow Standards

- All features require design review before development
- Security review mandatory for user-facing changes
- Performance testing required for all releases

Planejamento e gerenciamento estratégico de itens de trabalho

Criação de problemas e estratégia de organização

Fluxo de trabalho de configuração inicial do projeto: Quando o novo projeto é inicializado, ele solicita que você adicione itens. Esta é a sua oportunidade de estabelecer a base do projeto.

Abordagem estratégica para a criação de questões:

1. Comece com épicos e temas: crie itens de trabalho de alto nível que representem os principais recursos ou iniciativas
2. Divida em histórias de usuários: defina funcionalidades específicas e testáveis da perspetiva do usuário
3. Adicionar tarefas técnicas: inclua trabalhos de infraestrutura, teste e implantação
4. Dependências do plano: identifique relações bloqueadoras e itens críticos do caminho

Práticas recomendadas para o modelo de questões:

Modelo de issue de funcionalidade:

## User Story

As a [user type], I want [functionality] so that [business value].

## Acceptance Criteria

- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## Definition of Done

- [ ] Code review completed
- [ ] Unit tests written and passing
- [ ] Integration tests updated
- [ ] Documentation updated
- [ ] Accessibility review completed

## Dependencies

- Links to related issues or external dependencies

## Technical Notes

Implementation considerations and architectural decisions

Clique no sinal de mais (+) para adicionar mais problemas sistematicamente com base no seu plano de projeto.

Hierarquia e organização do item de trabalho:

• Epics: Grandes funcionalidades ou iniciativas principais
• Características: Funcionalidade fornecível
• Histórias de usuário: recursos específicos voltados para o usuário
• Tarefas: Trabalho de execução técnica
• Bugs: Defeitos e problemas que requerem resolução

Exemplos avançados de categorização de problemas

Estratégia de etiquetagem para projetos empresariais:

Categoria	Etiquetas	Purpose
Prioridade	priority:critical, priority:high, priority:medium, priority:low	Alocação e agendamento de recursos
Type	type:feature, type:bug, type:technical-debt, type:research	Categorização do trabalho e relatórios
Equipa	team:frontend, team:backend, team:qa, team:design	Propriedade e responsabilidade
Situação	status:blocked, status:in-review, status:needs-info	Gerenciamento de estado do fluxo de trabalho
Lançamento	release:v2.1, milestone:q1-2024	Planejamento e acompanhamento de lançamentos

Configuração e governança avançadas de projetos

Segurança e gestão de acessos

Navegue até as configurações do projeto clicando no menu (três pontos) no canto superior direito.

Práticas recomendadas de controle de acesso:

Função	Permissões	Casos de uso
Administrador	Controle total do projeto, gerenciamento de configurações	Proprietários de projetos, líderes de tecnologia
Escrever	Criar/editar itens, gerenciar fluxos de trabalho	Membros da equipa de desenvolvimento
Leia	Ver conteúdo do projeto, adicionar comentários	Partes interessadas, equipe de QA
Sem acesso	Não é possível visualizar o projeto	Utilizadores externos, dados restritos

Considerações sobre segurança empresarial:

• Habilitar a autenticação de dois fatores para todos os administradores de projeto
• Revisões regulares de acesso e auditorias de permissões (com recomendação de realização trimestral)
• Integração com SSO corporativo e sistemas de gerenciamento de identidade
• Registo de auditoria destinado à monitorização de conformidade e segurança

Campos personalizados e configuração do fluxo de trabalho

Design estratégico de campo personalizado:

Rastreamento de valor comercial:

• Estimativa de esforço: pontos de história ou estimativas de tempo
• Prioridade do negócio: Impacto no cliente ou potencial de receita
• Avaliação dos riscos: complexidade técnica ou risco de dependência
• Requisitos de conformidade: segurança, acessibilidade, necessidades regulamentares

Exemplos comuns de campos personalizados da empresa:

Nome do campo	Type	Valores/Opções	Purpose
Valor de Negócio	Selecionar	Alto, Médio, Baixo	Priorização e análise de ROI
Esforço	Número	1-13 (sequência de Fibonacci)	Planeamento de sprint e capacidade de equipa
Componente	Selecionar	Frontend, Backend, Banco de Dados, API	Apropriação técnica e especialização
Segmento de Clientes	Selecionar	Empresa, PME, Individual	Segmentação e validação de funcionalidades
Destino de lançamento	Date	Datas específicas	Planejamento de etapas e dependências

Automação e otimização do fluxo de trabalho:

• Configurar transições de status automatizadas baseadas em estados de pull request
• Configurar notificações para atualizações críticas e bloqueadores
• Estabeleça ciclos de revisão e fluxos de trabalho de aprovação
• Implementar procedimentos de escalonamento para itens de trabalho paralisados

Melhoria contínua e analítica

Monitorização do estado de funcionamento do projeto:

• Acompanhe as tendências de velocidade e a utilização da capacidade da equipe
• Monitore o tempo de ciclo desde a criação do problema até a conclusão
• Identificar gargalos e oportunidades de melhoria de processos
• Retrospetivas regulares e ajustes de fluxo de trabalho

Pontos de verificação de integração:

• Reuniões semanais de sincronização de projetos com atualizações das partes interessadas
• Sessões mensais de revisão e otimização de processos
• Alinhamento estratégico trimestral e avaliação de metas
• Auditorias anuais de governança e segurança do projeto

Para obter mais informações sobre projetos, consulte:

• Guia de início rápido para projetos - GitHub Docs.
• Criando um problema - GitHub Docs.