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 GitLab, com acesso aos repositórios e ao quadro de gestão de tarefas disponível na aba Plan/Issue board.
- Guia de Onboarding
- 👥 Squads
- C05 - Plataforma DGFA - SISTERS - Terapia Renal Substitutiva
- C05 - Plataforma PMPE - Escuta Cidadã
- C05 - Plataforma SEAP - SIEP - Sistema Integrado de Egressos de PE
- C05 - Plataforma SEAPEN - SEAP Cidadão
- C05 - Plataforma SEE - Declarações Escolares Digitais em PE
- C05 - Plataforma SEMOBI - Rota Segura PE
- 📘 Manual de Padrões e Ferramentas
- 💬 Discord
- 🎨 Aos Designers
- 🛠️ Aos Engenheiros de Software
- Papéis e Responsabilidades
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:
C05 – 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
C05 – Plataforma PROCON – ReclamaProcon: Validação de Requisitos
- Acompanhar o trabalho dos ES e a evolução dos projetos;
- Remover impedimentos técnicos e de fluxo de trabalho;
- Gerenciar as atividades dos Analistas de Dados;
- Gerenciar máquinas de homologação e produção;
- Idealizar e validar fluxos de trabalhos;
- Intermediar a Transferência Tecnológica de soluções;
- Gerenciar o lançamento de soluções em ambiente de homologação e produção.
-
Garantir que as equipes do LigaLabs iniciem o ciclo com documentação técnica validada:
- Documento de Requisitos
- Refinamento do backlog
- Elaboração da modelagem de dados
-
Promover o 1º alinhamento com os superiores hierárquicos do órgão ainda na etapa inicial, logo após a finalização do refinamento de requisitos, para garantir a primeira validação formal;
-
Reduzir riscos de retrabalho, divergências de expectativa e insatisfações na entrega final.
-
Apropriação de Requisitos e Negócio
- Apropriar-se dos requisitos de sistemas;
- 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.
-
Planejamento e Coordenação Técnica
- Planejar e revisar sprints;
- Definir tarefas técnicas para desenvolvedores e designers;
- Não permitir que os devs entrem em contato com o cliente, exceto em casos excepcionais.
- Remover impedimentos e articular-se 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.
-
Prototipar as interfaces de 1 produto;
-
Revisar as telas dos outros produtos;
- Acompanhar possíveis dúvidas dos Designers UI, sem a necessidade de participar das Reviews;
-
Participar dos ritos semanais internos e de reuniões de validação quando necessário;
-
Validar as interfaces diretamente pelo grupo de WhatsApp com o cliente.
-
Prototipar as interfaces de 1 produto;
-
Participar dos ritos semanais internos;
-
Validar as interfaces 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
