--- title: "Plataforma de Treinamento Industrial - De Wireframes a Sistema Completo" slug: "industrial-learning-platform" summary: "Solution Design para plataforma de microlearning em empresa de gases industriais. Identificação de requisitos críticos não mapeados (admin, cadastros, exportação) antes da apresentação ao cliente, evitando retrabalho e garantindo usabilidade real." client: "Empresa de Gases Industriais" industry: "Industrial & Manufatura" timeline: "4 meses" role: "Solution Architect & Tech Lead" image: "" tags: - Solution Design - EdTech - Learning Platform - Requirements Analysis - Tech Lead - User Stories - .NET - Product Design featured: true order: 5 date: 2024-06-01 seo_title: "Plataforma de Treinamento Industrial - Solution Design" seo_description: "Case de Solution Design para plataforma de microlearning, identificando requisitos críticos antes da apresentação ao cliente e liderando desenvolvimento até produção." seo_keywords: "solution design, learning platform, microlearning, requirements analysis, tech lead, industrial training" --- ## Overview Empresa de gases industriais solicita plataforma para treinar funcionários usando metodologia de **microlearning** (conteúdos curtos e objetivos). **Requisito inicial:** "Queremos apenas a estrutura - trilha, microlearning, pergunta de teste e pontuação." **Problema:** Especificação incompleta que resultaria em sistema **impossível de usar** (sem forma de cadastrar conteúdo, sem administradores, sem exportar resultados). **Solução:** Análise crítica de requisitos **antes da apresentação ao cliente**, identificando gaps funcionais e propondo solução completa. --- ## Challenge ### Wireframes Bonitos, Funcionalidade Incompleta **Situação inicial:** UX criou wireframes lindos mostrando: - ✅ Trilhas de aprendizado - ✅ Microlearnings (vídeo/texto + imagem) - ✅ Perguntas de teste (múltipla escolha) - ✅ Pontuação por funcionário **Problema identificado:** Ninguém (cliente, UX, comercial) pensou em: ❌ **Como conteúdo entra no sistema?** - Quem cadastra trilhas? - Quem cria microlearnings? - Quem escreve perguntas? - Interface manual ou import? ❌ **Quem gerencia o sistema?** - Existe conceito de admin? - RH pode criar admins? - Gestor de área pode ver apenas seu time? ❌ **Como dados saem do sistema?** - RH precisa de relatórios - Compliance precisa de evidências - Como exportar dados? - Formato: Excel? PDF? API? **Risco real:** Se desenvolvêssemos exatamente o que foi pedido: - Sistema funcionaria tecnicamente ✅ - **Mas seria completamente inutilizável** ❌ - Cliente teria que pagar refação para incluir CRUD básico - Retrabalho + custo adicional + frustração --- ## Solution Design Process ### Etapa 1: Análise Crítica (Antes da Apresentação) **Ação tomada:** Chamei reunião com UX **antes** de apresentar ao cliente. **Pontos levantados:** **"Como o primeiro conteúdo entra no sistema?"** - UX: "Ah... não pensamos nisso. Vocês vão popular o banco?" - Eu: "E quando cliente quiser adicionar nova trilha? Vamos alterar banco em produção?" **"Quem é o dono do sistema?"** - UX: "O RH, imagino." - Eu: "Apenas uma pessoa? E se ela sair da empresa? Como ela delega?" **"RH pediu relatórios?"** - UX: "Não foi mencionado no briefing." - Eu: "RH sempre precisa de relatórios. É para compliance (NR, ISO)." --- ### Etapa 2: Requisitos Funcionais Identificados Propus 4 módulos adicionais **essenciais**: #### 1. Sistema de Administração **Funcionalidades:** - Usuário padrão: Apenas faz treinamentos - Usuário admin: Gerencia conteúdo + vê relatórios - Admin pode promover outros usuários a admin - Controle de acesso (admin geral vs admin de área) **Por que é crítico:** Sem isso, sistema é estático (conteúdo nunca atualiza). --- #### 2. CRUD de Conteúdo **a) Cadastro de Trilhas:** - Nome da trilha - Descrição - Ordem dos microlearnings - Trilha ativa/inativa (permite despublicar) **b) Cadastro de Microlearnings:** - Título - Tipo: Texto simples (2 parágrafos) OU Vídeo - Upload de imagem (se texto) - URL de vídeo (se vídeo) - Ordem dentro da trilha **c) Cadastro de Perguntas:** - Pergunta (texto) - 3 opções de resposta: - "Ótimo" (verde) - "Mais ou menos" (amarelo) - "Ruim" (vermelho) - Pontuação por resposta (ex: 10, 5, 0 pontos) - Feedback customizado por resposta **Por que é crítico:** Cliente precisa atualizar conteúdo sem chamar dev/DBA. --- #### 3. Exportação de Dados **Funcionalidades:** - Exportar para Excel (.xlsx) - Filtros: - Por período (data início/fim) - Por trilha - Por funcionário - Por área/departamento - Colunas exportadas: - Nome do funcionário - Matrícula - Trilha concluída - Pontuação total - Data de conclusão - Respostas individuais (para auditoria) **Por que é crítico:** RH precisa evidenciar treinamento para: - Normas Regulamentadoras (NR-13, NR-20 - gases inflamáveis) - Auditorias ISO - Processos trabalhistas --- #### 4. Gestão de Usuários **Funcionalidades:** - Importar funcionários (upload CSV/Excel) - Cadastro manual - Ativar/desativar usuários - Atribuir trilhas obrigatórias por área - Notificações de pendências **Por que é crítico:** Empresa tem 500+ funcionários, cadastro manual é inviável. --- ### Etapa 3: Apresentação ao Cliente **Abordagem:** 1. Mostrei wireframes do UX (interface bonita) 2. Perguntei: "Como vocês vão cadastrar a primeira trilha?" 3. Cliente: "Ah... boa pergunta. Não tínhamos pensado nisso." 4. Apresentei os 4 módulos adicionais 5. Cliente: "Faz total sentido! Sem isso não conseguimos usar." **Resultado:** - Proposta aprovada **com módulos adicionais** - Escopo ajustado (timeline + orçamento) - Zero retrabalho futuro - Cliente reconheceu valor agregado --- ## Implementation ### Meu Papel no Projeto **1. Solution Architect** - Identificação de requisitos não-funcionais - Desenho de arquitetura (módulos, integrações) - Definição de tecnologias **2. Tech Lead** - Liderança técnica da equipe (3 devs) - Code review - Definição de padrões de código - Gestão de riscos técnicos **3. Product Owner Técnico** - Criação de **user stories** completas - Priorização de backlog - Refinamento contínuo com cliente --- ### Stack Técnico Escolhido **Backend:** - `.NET 7` - APIs REST - `Entity Framework Core` - ORM - `SQL Server` - Banco de dados - `ClosedXML` - Geração de Excel **Frontend:** - `React` - Interface web - `Material-UI` - Componentes - `React Player` - Player de vídeo - `Chart.js` - Gráficos de progresso **Infraestrutura:** - `Azure App Service` - Hospedagem - `Azure Blob Storage` - Armazenamento de vídeos/imagens - `Azure SQL Database` - Banco gerenciado --- ### User Stories Criadas Escrevi **32 user stories** cobrindo todos os fluxos. Exemplos: **US-01: Cadastrar Trilha (Admin)** ``` Como administrador do sistema Quero cadastrar uma nova trilha de treinamento Para que funcionários possam realizar os cursos Critérios de aceitação: - Admin acessa menu "Trilhas" → "Nova Trilha" - Preenche: Nome, Descrição, Status (Ativa/Inativa) - Pode adicionar microlearnings existentes à trilha - Define ordem dos microlearnings (drag & drop) - Sistema valida campos obrigatórios - Salva e exibe mensagem de sucesso ``` **US-15: Realizar Microlearning (Funcionário)** ``` Como funcionário Quero realizar um microlearning da minha trilha Para aprender sobre o tema e ganhar pontos Critérios de aceitação: - Funcionário acessa trilha atribuída - Vê lista de microlearnings (não completados primeiro) - Clica em microlearning → abre tela com: - Texto (2 parágrafos) + Imagem OU - Player de vídeo embarcado - Botão "Continuar" aparece após: - 30s (se texto) - Final do vídeo (se vídeo) - Marca microlearning como visto - Pergunta de teste aparece automaticamente ``` **US-22: Exportar Resultados (Admin)** ``` Como administrador Quero exportar resultados de treinamento para Excel Para gerar relatórios de compliance e auditorias Critérios de aceitação: - Admin acessa "Relatórios" → "Exportar" - Seleciona filtros (período, trilha, área) - Clica "Gerar Excel" - Sistema processa e baixa arquivo .xlsx - Excel contém colunas: Nome, Matrícula, Trilha, Pontos, Data, Respostas - Formato legível (headers em negrito, colunas autoajustadas) ``` --- ## Key Features Implemented ### 1. Sistema de Pontuação Gamificado **Mecânica:** - Cada pergunta vale pontos (configurável) - Resposta "Ótimo": 10 pontos - Resposta "Mais ou menos": 5 pontos - Resposta "Ruim": 0 pontos **Dashboard do funcionário:** - Pontuação total - Ranking (opcional, configurável) - Badges por trilhas concluídas - Progresso visual (barra de %) **Por que funciona:** Funcionários de chão de fábrica engajam mais com elementos de gamificação. --- ### 2. Microlearning Adaptativo **Tipos de conteúdo:** **Texto + Imagem:** - 2 parágrafos (máx 300 palavras) - 1 imagem ilustrativa - Ideal para: Procedimentos, normas, conceitos **Vídeo:** - Vídeos curtos (2-5 min) - Player embarcado (YouTube/Vimeo ou upload) - Ideal para: Demonstrações, operações de equipamento **Por que microlearning?** - Funcionários fazem no intervalo (10-15min) - Conteúdo curto = maior retenção - Facilita atualização (vs cursos longos) --- ### 3. Sistema de Administração Delegada **Hierarquia:** ``` Admin Geral (RH) ↓ pode promover Admin de Área (Gerentes) ↓ pode visualizar apenas Funcionários da sua área ``` **Permissões:** - Admin geral: Cria trilhas, promove admins, vê todos os dados - Admin de área: Vê apenas relatórios da sua área - Funcionário: Apenas realiza treinamentos **Auditoria:** - Logs de quem criou/editou cada conteúdo - Histórico de promoções a admin - Compliance SOX/ISO --- ### 4. Exportação para Compliance **Formato do Excel gerado:** | Matrícula | Nome | Área | Trilha | Data Conclusão | Pontos | Status | |-----------|------|------|--------|----------------|--------|--------| | 1001 | João Silva | Produção | Segurança NR-20 | 15/11/2024 | 95/100 | ✅ Aprovado | | 1002 | Maria Santos | Logística | Manuseio Gases | 14/11/2024 | 78/100 | ✅ Aprovado | **Aba adicional: Detalhamento de Respostas** - Permite auditoria: "Funcionário X acertou pergunta Y?" - Evidência para processos trabalhistas - Compliance NR-13/NR-20 --- ## Results & Impact ### Sistema em Produção **Status atual:** Em uso há 4+ meses **Métricas de adoção:** - 👥 500+ funcionários cadastrados - 📚 12 trilhas ativas - 📖 150+ microlearnings criados - ✅ 8.000+ treinamentos concluídos - 📊 100+ relatórios exportados (compliance) **Taxa de conclusão:** 87% (média indústria: 45%) --- ### Impacto no Cliente **Antes:** - Treinamentos presenciais (custo alto, agenda difícil) - Evidências em papel (perdas, difícil auditoria) - Dificuldade em atualizar conteúdo **Depois:** - Treinamento assíncrono (funcionário faz quando pode) - Evidências digitais (compliance facilitado) - RH atualiza conteúdo sem chamar TI - Redução de 70% no custo de treinamento **Feedback do cliente:** > "Se tivéssemos implementado apenas o que pedimos inicialmente, o sistema seria inútil. A análise prévia salvou o projeto." --- ### Valor do Solution Design **ROI da análise pré-venda:** **Cenário A (sem análise):** 1. Desenvolver apenas interface (2 meses) 2. Cliente testa e percebe que falta CRUD (1 mês depois) 3. Refação para adicionar módulos (2+ meses) 4. **Total: 5+ meses + frustração do cliente** **Cenário B (com análise - o que fizemos):** 1. Identificar requisitos antes (1 semana) 2. Aprovar escopo completo (1 semana) 3. Desenvolver solução correta (4 meses) 4. **Total: 4 meses + cliente satisfeito** **Economia:** 1+ mês de retrabalho + custo de oportunidade --- ## Tech Stack `.NET 7` `C#` `Entity Framework Core` `SQL Server` `React` `Material-UI` `Azure App Service` `Azure Blob Storage` `ClosedXML` `Chart.js` `User Stories` `Solution Design` `Tech Lead` --- ## Key Decisions & Trade-offs ### Por que não usar LMS pronto? (Moodle, Canvas) **Alternativas consideradas:** 1. ❌ Moodle (open-source, gratuito) 2. ❌ Totara/Canvas (LMS corporativo) 3. ✅ **Desenvolvimento custom** **Justificativa:** - LMS genérico: Complexidade desnecessária (fóruns, wikis, etc) - Cliente quer **apenas microlearning** (simplicidade) - Custo de licença LMS > custo de dev custom - Integração com AD/SSO do cliente (mais fácil custom) - UX otimizada para chão de fábrica (mobile-first, touch) --- ### Por que 3 opções de resposta (vs 4-5)? **Escolha:** Verde (Ótimo), Amarelo (Mais ou menos), Vermelho (Ruim) **Justificativa:** - Funcionários de chão de fábrica preferem simplicidade - Cores universais (semáforo) - Evita paradoxo da escolha (menos opções = mais engajamento) - Gamificação mais clara --- ### Por que Export Excel (vs Dashboard online)? **Ambos foram implementados**, mas Excel é crítico para: **Compliance regulatório:** - Auditores pedem "arquivo assinado digitalmente" - NR-13/NR-20 exigem evidência física - Processos trabalhistas aceitam Excel **Flexibilidade:** - RH pode fazer análises customizadas no Excel - Combinar com outras fontes de dados - Apresentações para diretoria --- ## Lessons Learned ### 1. Solution Design Previne Retrabalho **Lição:** 1 semana de análise crítica economiza meses de refação. **Aplicação:** - Sempre questionar especificações incompletas - Pensar no "dia seguinte" (quem gerencia isso em produção?) - Envolver cliente em discussões de requisitos --- ### 2. UX ≠ Requisitos Funcionais **Lição:** Wireframes bonitos não substituem análise de requisitos. **UX foca em:** Como usuário **usa** o sistema **Solution Design foca em:** Como sistema **funciona** end-to-end Ambos são necessários e complementares. --- ### 3. Perguntar "Como?" é Mais Importante que "O Quê?" **Cliente diz:** "Quero trilhas e microlearnings" **Solution Designer pergunta:** "Como a primeira trilha entra no sistema?" Essa pergunta simples revelou 4 módulos faltantes. --- ### 4. User Stories Bem Escritas Aceleram Desenvolvimento **Investimento:** 2 semanas escrevendo 32 user stories detalhadas **Retorno:** - Devs sabiam exatamente o que construir - Zero ambiguidade - Pouquíssimos bugs (requisitos claros) - Cliente validou histórias antes de codificar **Lição:** Tempo gasto em planejamento reduz tempo de desenvolvimento. --- ### 5. Compliance é Requisito Oculto **Em indústrias reguladas** (saúde, energia, químico), sempre haverá: - Necessidade de auditoria - Exportação de evidências - Logs de quem fez o quê **Lição:** Perguntar sobre compliance **antes**, não depois. --- ## Challenges Overcome | Desafio | Solução | Resultado | |---------|---------|-----------| | Especificação incompleta | Análise crítica pré-venda | Escopo correto desde início | | Cliente sem conhecimento técnico | User stories em linguagem de negócio | Cliente validou requisitos | | Funcionários com baixa familiaridade digital | UX simplificado (3 botões, cores) | 87% taxa de conclusão | | Compliance NR-13/NR-20 | Export Excel com detalhamento | Aprovado em 2 auditorias | | Gestão de 500+ usuários | Import CSV + hierarquia de admins | Onboarding em 1 semana | --- ## Next Steps (Roadmap Futuro) **Funcionalidades planejadas:** 1. **Notificações Push** - Lembrar funcionário de treinamento pendente - Avisar de nova trilha obrigatória 2. **App Mobile Nativo** - Offline-first (vídeos baixados) - Funcionários sem computador 3. **Certificados Digitais** - PDF assinado digitalmente - QR code para validação 4. **Inteligência de Dados** - Quais microlearnings têm mais erro? - Identificar gaps de conhecimento por área --- **Resultado:** Sistema funcional em produção, cliente satisfeito, zero retrabalho - tudo porque 1 semana foi investida em **pensar antes de codificar**. [Precisa de análise crítica de requisitos? Entre em contato](#contact)