📖 Documentação Técnica + IA

Mineração de Documentação
PIMA CD4

55 telas do equipamento extraídas automaticamente do PDF manual por detecção clássica de imagem + Groq Vision. Catálogo estruturado → Simulador 3D funcional.

📊 Os Números

O que a extração produziu

Um PDF manual em português do Alere PIMA CD4 analisado por visão computacional. Resultados abaixo.

55
Telas Catalogadas
Visores LCD únicos identificados
35
Páginas Processadas
Do manual PDF original (págs 12-46)
8
Categorias de Estado
Fluxo principal, menus, erros...
5
Ambientes Gerados
Treinamento 3D a partir do catálogo
Catalogação Manual (estimado) ~3-5 dias
vs
Pipeline Automatizado ~5 minutos
🔬 O Desafio

Do manual de papel ao simulador 3D

🎯 O Equipamento

Alere PIMA CD4 — analisador portátil de contagem de linfócitos CD4, usado no diagnóstico e monitoramento de pacientes HIV positivos. Essencial em regiões remotas.

O manual técnico em português contém screenshots do visor LCD espalhados por 35 páginas — cada um representando um estado diferente do equipamento.

💡 A Ideia

E se pudéssemos extrair automaticamente cada tela do manual, classificar por estado e gerar um catálogo estruturado — tudo isso em minutos?

Esse catálogo alimentaria um simulador 3D interativo para treinamento de profissionais de saúde, sem depender de catalogação manual.

🏗️ O Pipeline

PDF → Catálogo Estruturado → Simulador 3D

Cinco etapas, zero intervenção manual, ~5 minutos de processamento.

1
📄

PDF → Imagens

Conversão do PDF (35 páginas) para imagens PNG com pdf2image

2
🔍

Detecção Clássica

Algoritmo scipy.ndimage identifica regiões escuras contíguas com proporção de visor LCD

3
👁️

Groq Vision

Llama-4-Scout-17B transcreve o texto de cada crop: header, body, footer → JSON estruturado

4
🗂️

Catálogo JSON

55 screens organizados por estado, com variantes de header/body por contexto

5
🎮

Simulador 3D

Next.js + R3F + Zustand + Tailwind — display LCD, teclado, estado e transições

💡 Diferencial técnico

O pipeline não usa OCR tradicional nem API de visão paga. A detecção do visor LCD é feita por processamento clássico de imagem (scipy ndimage.label() + heurísticas de proporção e brilho). O Groq Vision entra apenas para transcrever o texto dos crops já recortados — reduzindo custo em ~90% e aumentando a precisão.

📊 55 Telas em 8 Categorias

Estado completo da máquina mapeado

Cada tela do visor LCD foi extraída, classificada e organizada por categoria de estado.

Fluxo Principal

5 telas
  • run_test (IDLE)
  • insert_cartridge
  • reading_cartridge
  • analysing
  • analysis_done

Resultados

4 telas
  • results
  • result_screen
  • invalid_test
  • manual_abort_error

Identificação

6 telas
  • operator_list
  • enter_sample
  • new_operator
  • edit_operator
  • operator_id
  • operator_list_updated

Menus e Config

5 telas
  • main_menu
  • settings_list
  • device_info
  • set_date
  • set_time

Exportação/Arquivo

13 telas
  • results_menu
  • view_results
  • print_results
  • print_confirmation
  • printing_results
  • insert_storage_medium
  • select_storage
  • export_results
  • export_results_selected
  • exporting_results
  • remove_storage_medium
  • delete_confirmation
  • delete_results

Interrupções

2 telas
  • analysis_menu
  • abort_analysis

Power Off

2 telas
  • power_off_confirmation
  • shutdown

Erros/Sistema

18 telas
  • archive_full
  • barcode_error
  • invalid_barcode
  • operator_required
  • invalid_entry_sample_id_required
  • invalid_entry_operator_exists
  • failure_export_failed
  • warning_recharge_battery
  • error_recharge_battery
  • printer_error
  • paper_required
  • invalid_selection
  • storage_medium_full
  • storage_medium_lost
  • unexpected_exception
  • error_0000
  • hardware_failed
  • no_sample_detected

79 variantes no total (algumas telas aparecem em contextos diferentes no manual)

🖼️ Demonstração

Do visor do manual ao display simulado

🖥️ Simulador Interativo — Em Ação

Simulador PIMA CD4 em funcionamento

Display LCD simulado + teclado numérico + painel de controle de fluxo

💡 O que torna isso único

Não encontramos nada similar na internet: a capacidade de transformar documentação técnica estática em simulação interativa usando visão computacional. Isso abre possibilidades enormes para treinamento, certificação e qualidade — dentro e fora da Controllab.

🎯 Resultado Final

5 ambientes de treinamento gerados

O catálogo de telas alimentou diferentes interfaces de simulação, cada uma com um propósito.

🎮 Treinamento FPS

Primeira pessoa com física, mira PointerLock, 7 etapas do fluxo PIMA CD4. R3F + TSL shaders.

React Three Fiber

🌀 Treinamento Orbital

Câmera orbital guiada por etapas com destaque do objeto-alvo. Inspirado no Oxide Explorer.

OrbitControls

🖥️ Simulador Standalone

Display LCD + teclado numérico + máquina de estados. Navegação livre por todas as 55 telas.

Next.js + Zustand

🔬 Lab Explorer

Tour livre pelo laboratório 3D com informações de cada equipamento. Layout 3 colunas.

R3F + Three.js

🎬 Demo Guiada

Sandbox interativo + tutorial guiado + auto play. Experiência completa do equipamento.

Next.js + R3F

📦 Screens Catalog

screens.generated.json — 55 screens com estados, header/body/footer variants. Pronto para consumo.

JSON Estruturado
🧱 Stack Tecnológica

Duas pontes, uma pipeline

🔬 Pipeline de Extração

PDF → Imagenspdf2image (poppler)
Detecção LCDscipy.ndimage + heurísticas
TranscriçãoGroq Vision (Llama-4-Scout-17B)
FormatoJSON + PNG individuais

🎮 Simulador 3D

FrameworkNext.js (App Router)
RenderizaçãoReact Three Fiber + Three.js (WebGPU)
EstadoZustand (trainingStore + uiStore)
AnimaçõesGSAP + TSL Shaders
EstiloTailwindCSS v4
🚀 Aplicação na Controllab

Isso pode ser aplicado a outros equipamentos?

Sim. O pipeline é genérico e funciona com qualquer equipamento que tenha documentação técnica com imagens de display.

📋 Novos equipamentos

Qualquer manual técnico com screenshots de display pode ser processado. O pipeline é o mesmo: PDF → detecção → transcrição → catálogo → simulação.

🎓 Treinamento interno

Simuladores permitem treinar profissionais sem risco de danificar equipamentos reais. Ideal para capacitação em larga escala.

📊 Documentação viva

Em vez de manuais estáticos em PDF, tenha documentação interativa que mostra cada tela e estado do equipamento em tempo real.