ricardo/CarneiroTech
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ae8f308025
CarneiroTech/Content/Archive/Consulting/industrial-learning-platform.md

16 KiB
Raw Blame History

title slug summary client industry timeline role image tags featured order date seo_title seo_description seo_keywords
Plataforma de Treinamento Industrial - De Wireframes a Sistema Completo industrial-learning-platform 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. Empresa de Gases Industriais Industrial & Manufatura 4 meses Solution Architect & Tech Lead
Solution Design
EdTech
Learning Platform
Requirements Analysis
Tech Lead
User Stories
.NET
Product Design
true 5 2024-06-01 Plataforma de Treinamento Industrial - Solution Design Case de Solution Design para plataforma de microlearning, identificando requisitos críticos antes da apresentação ao cliente e liderando desenvolvimento até produção. 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