Este documento reúne as principais orientações para novos integrantes dos projetos do LigaLabs, incluindo acessos, ferramentas, comunicação e diretrizes de trabalho.
Ao ingressar em um projeto, o participante é adicionado ao time correspondente no GitHub, com acesso aos repositórios e ao quadro de gestão de tarefas disponível na aba Projects.
- Guia de Onboarding
- 👥 Squads
- 📘 Manual de Padrões e Ferramentas
- 💬 Discord
- 🎨 Aos Designers
- 🛠️ Aos Engenheiros de Software
- Cargos e Funções
Todo o código desenvolvido ao longo de cada ciclo deve obrigatoriamente seguir o Manual de Padrões e Ferramentas disponível no link abaixo:
⚠️ Atenção: Não é permitida a utilização de outro template de projeto sem autorização prévia da coordenação.
Todas as categorias e canais dos projetos encontram-se no Discord.
Link de acesso ao servidor: https://discord.gg/XhtNCuMF
Após ingressarem no servidor, os participantes devem acessar a opção Canais e Membros no menu e selecionar:
- o projeto ao qual estão vinculados;
- o cargo correspondente à sua função no time.
(conforme ilustrado na imagem abaixo)
Todas as reuniões deverão ocorrer exclusivamente no canal do Discord de cada projeto, identificado como 🔈 Meeting Room 👥.
(conforme a imagem ilustrativa abaixo)
Todo e qualquer contato oficial sobre o desenvolvimento do software deve ser realizado exclusivamente pelos canais do Discord.
O WhatsApp deve ser utilizado apenas como meio de lembrete para que mensagens postadas no Discord sejam visualizadas e respondidas.
Essa diretriz tem como objetivo centralizar todas as discussões em um único ambiente, garantindo transparência e alinhamento entre todos os envolvidos.
Os links de acesso ao Figma de cada projeto devem ser adicionados no card
🎨 Link de acesso ao Figma da plataforma, presente no quadro do respectivo projeto.
(conforme exemplificado na imagem abaixo)
Com relação ao uso do Figma, é possível encontrar as instruções de uso e produção no PPT a seguir:
Segue aqui também o PPT construído para:
→ Apresentar o papel dos Designers no Programa Agentes Digitais; → Orientar sobre processos, métodos, ferramentas e entregáveis esperados; → Garantir uma atuação consistente, colaborativa e alinhada aos objetivos do programa;
Liga Labs - Onboarding Design | Ciclo 04
Seguem, abaixo, os links dos Figmas dos projetos do Ciclo 04, com o nome do respectivo designer responsável.
Deve ser criada uma agenda semanal recorrente no Google Calendar para o planejamento e a revisão das sprints de cada projeto. Todos os membros da squad devem ser adicionados ao evento, bem como os seguintes e-mails:
C04 – Plataforma PROCON – ReclamaProcon: Planejamento e Revisão de Sprint
Observações:
- No campo
Adicionar local, informar:Discord; - Não adicionar link de Google Meet, pois todas as reuniões de sprint devem ocorrer via Discord.
Deve ser criada uma agenda quinzenal recorrente com os representantes do órgão parceiro, com o objetivo de validar as entregas e requisitos do projeto.
🚨 A participação do designer nessa reunião é obrigatória.
- A reunião deverá ocorrer via Google Meet;
- O seguinte e-mail também deve ser adicionado à agenda: luiz.arruda.setd@gmail.com
C04 – Plataforma PROCON – ReclamaProcon: Validação de Requisitos
-
Levantamento de Requisitos e Negócio
- Participar de reuniões com stakeholders (produto, negócio e usuários).
- Entender as necessidades do cliente ou do negócio.
- Traduzir problemas reais em soluções técnicas.
- Especificar e melhorar requisitos de sistemas.
-
Planejamento e Coordenação Técnica
- Planejar e revisar sprints.
- Definir tarefas técnicas para desenvolvedores e designers.
- Remover impedimentos e articular com a equipe.
- Ajudar na tomada de decisões técnicas do time.
- Mentorar desenvolvedores mais novos.
-
Arquitetura, Design e Modelagem
- Definir a arquitetura do software.
- Pensar em escalabilidade, segurança e manutenibilidade.
- Projetar APIs, integrações e fluxos de dados.
- Construir documentos de modelagem do sistema (Diagramas de Classes e DER).
- Melhorar continuamente os templates de projeto.
- Documentar código e decisões técnicas.
-
Desenvolvimento e Qualidade
- Criar versões estáveis de código.
- Revisar código com base em boas práticas (SOLID, DRY, KISS, Clean Code).
- Garantir que o sistema funcione corretamente antes de ir para produção.
-
Entrega, Operação e DevOps
- Preparar o software para produção.
- Estruturar pipelines de CI/CD.
- Monitorar sistemas em funcionamento.
-
Evolução Contínua
- Aprender novas tecnologias e ferramentas.
-
Responsáveis pelo acompanhamento e desenvolvimento de 1 produto.
-
Responsáveis pela revisão das telas dos outros produtos.
- Mas não precisam participar das Reviews, apenas acompanhar possíveis dúvidas dos Designers UI.
-
Participar dos ritos semanais internos e reuniões de validação quando necessário.
-
Validar as interfaces diretamente pelo grupo de whatsapp com o cliente.
-
Responsáveis pelo acompanhamento e desenvolvimento da interface de 1 produto.
-
Participar dos ritos semanais internos.
-
Validar as interfaces com diretamente pelo grupo de whatsapp com o cliente;
- E, caso considerem necessário, validar com os líderes.
-
Desenvolver APIs RESTful seguras e escaláveis
- Criar e manter endpoints respeitando os princípios REST.
- Garantir autenticação, autorização e tratamento de erros adequado. Documentar as APIs com OpenAPI (Swagger ou similar).
-
Aplicar testes automatizados
- Escrever testes unitários para garantir o comportamento de funções isoladas.
- Implementar testes de integração para validar fluxos entre camadas e serviços.
-
Utilizar princípios SOLID e padrões de projeto
- Organizar o código de forma legível, reutilizável e sustentável.
- Utilizar padrões como Repository, Service, Controller, etc.
-
Arquitetar sistemas com DDD e Clean Architecture
- Isolar lógica de negócio da infraestrutura.
- Estruturar os projetos por contexto de domínio e responsabilidade.
-
Implementar práticas de CI/CD
- Automatizar pipelines de build, testes e deploy.
- Garantir entregas contínuas e confiáveis.
-
Gerenciar tarefas no Scrum
- Atualizar status no quadro, estimar esforço e participar de cerimônias ágeis.
-
Seguir boas práticas de versionamento e revisão de código
- Utilizar Git com branches bem nomeadas, PRs com boas descrições e participar de revisões de código.
-
Realizar code reviews com foco em qualidade e padrões REST
- Revisar PRs com atenção à consistência de contratos, semântica de rotas e qualidade de código.
-
Colaborar em decisões técnicas e integrações com o frontend
- Participar de definições de arquitetura e refinamentos técnicos com o time.
- Alinhar contratos e fluxos com o time frontend.
-
Componentizar as interfaces do projeto
- Criar componentes reutilizáveis, responsivos e acessíveis com base em um design system.
- Organizar os componentes por responsabilidade e manter o código limpo e legível.
-
Consumir APIs RESTful
- Integrar o frontend com as APIs expostas pelo backend, respeitando os contratos definidos.
- Tratar erros de forma apropriada, lidar com estados de carregamento, sucesso e falha.
- Validar e mapear dados conforme a necessidade da interface.
-
Criar e manter testes automatizados
- Testes E2E (ex: com Cypress ou Playwright) para validar o comportamento do sistema como um todo.
- (Opcional, mas recomendável) Testes unitários para lógica isolada e componentes (ex: com React Testing Library ou Vitest).
-
Garantir performance e acessibilidade (a11y)
- Otimizar tempo de carregamento, lazy loading de componentes e imagens.
- Usar boas práticas de semântica HTML, contrastes e navegação por teclado.
-
Seguir boas práticas de versionamento e revisão de código
- Utilizar Git com branches bem nomeadas, PRs com boas descrições e participar de revisões de código.
-
Implementar práticas de CI/CD
- Automatizar pipelines de build, testes e deploy.
- Garantir entregas contínuas e confiáveis.
-
Gerenciar tarefas no quadro Scrum
- Atualizar status, estimar complexidade e participar de cerimônias ágeis como planning, daily e review.
-
Colaborar com o time de design e produto
- Trabalhar junto com designers para garantir fidelidade visual, responsividade e uma boa experiência do usuário.
- Sugerir melhorias com base em feedbacks e testes de usabilidade.
Quaisques dúvidas ou dificuldades, nos comuniquem.
Atenciosamente, Coordenação LigaLabs
