589 lines
16 KiB
Markdown
589 lines
16 KiB
Markdown
---
|
|
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)
|