Laboratório Óptico · OticaHub Lab
Sistema de gestão da produção para laboratórios de montagem óptica.
Da entrada da ordem de serviço até a entrega na loja, com bancada por etapas, previsão de atraso e acompanhamento em tempo real para vendedores e óticas.
lab.oticahub.com · aplicativo em mobile/
Sistema web e aplicativo usam o mesmo banco. A operação da ótica (venda, receita, estoque, financeiro e CRM) está no ERP Ótica.
O problema
Em um laboratório de montagem, a ordem de serviço passa por várias mãos: o vendedor na ótica, o balcão que recebe, quem espera as lentes, o montador em cada máquina e a conferência final. Sem um sistema, o controle fica em papel e WhatsApp: ninguém sabe em que etapa o óculos está, o atraso só aparece quando o cliente reclama e o vendedor liga várias vezes para perguntar.
A solução
Um painel único, pensado para a rotina da bancada:
- Lançamento rápido — a OS entra em segundos só com o número, só com o nome do cliente ou com os dois. Aceita leitor de código de barras e lista colada do WhatsApp.
- Bancada de montagem — cada OS mostra a próxima ação em um botão grande (Iniciar blocagem, Concluir facetadora, Marcar como pronta), registrando quem fez e quando em cada uma das cinco etapas: conferência inicial, lensometria, blocagem, facetadora e conferência de qualidade.
- Previsão de atraso — o sistema calcula o progresso de cada OS e avisa antes do prazo vencer. O gestor vê o radar e manda a atualização para o vendedor pelo WhatsApp com a mensagem já escrita.
- Portal do vendedor e da loja — um link seguro, sem senha, onde o vendedor acompanha os serviços em seu nome com % de progresso, linha do tempo, previsão e recados para o laboratório.
- Qualidade — ocorrências por etapa (lente riscada, erro de blocagem, grau divergente…) que bloqueiam a OS de ficar pronta até serem tratadas.
- Ranking da produção — pódio de montadores, vendedores e lojas com metas, prêmios e modo TV para a parede do laboratório.
- Gestão — dashboard de fila e produção, metas diária/semanal/mensal, estoque de lentes por grau com QR Code e relatórios em CSV.
Engenharia de Produção aplicada
Este projeto nasceu como um trabalho de melhoria contínua dentro de um laboratório real. Cada funcionalidade é uma ferramenta de gestão da produção transformada em software:
| Ferramenta | No sistema |
|---|
| Kanban puxado | Fluxo da OS em colunas, puxado pelo prazo, com limite WIP por coluna que fica vermelho quando o fluxo trava |
| Gestão visual / Andon | Radar de prazos, alerta de risco e ranking em modo TV |
| Trabalho padronizado | Cinco etapas fixas na bancada, com a próxima ação em um toque |
| Poka-yoke | A OS não fica pronta sem as 5 etapas concluídas e sem ocorrência aberta |
| Jidoka / qualidade na fonte | Ocorrência registrada na etapa onde aconteceu, bloqueando o avanço |
| 5S | Auditoria 5S com checklist de 20 itens por área, nota de 0 a 5 por senso, radar e evolução semanal |
| Kaizen / PDCA | Quadro de ideias da equipe em Planejar → Executar → Verificar → Padronizar, com 5 Porquês e matriz impacto × esforço |
| Lean Six Sigma | Nível sigma (DPMO), FPY, OTD, lead time, Lei de Little, takt time, Pareto 80/20 e carta de controle u, organizados no ciclo DMAIC |
| Teoria das Restrições | Tempo de ciclo por etapa da bancada e identificação automática do gargalo |
📄 O caso completo, no roteiro DMAIC (Definir, Medir, Analisar, Melhorar e Controlar), está em docs/estudo-de-caso.md.
Telas
As telas usam dados de simulação (OS SIM-…).
Fluxo de uma ordem de serviço
flowchart LR
A[Entrada da OS<br/>balcão ou lançamento rápido] --> B{Lentes<br/>chegaram?}
B -- não --> L[Aguardando lentes]
L --> B
B -- sim --> M[Aguardando montagem]
M --> E1[Conferência inicial] --> E2[Lensometria] --> E3[Blocagem] --> E4[Facetadora]
E4 --> Q[Conferência de qualidade]
Q -- ocorrência --> C[Em correção] --> E1
Q -- aprovada --> P[Pronta]
P --> S[Entregue à loja]
A cada passo o sistema recalcula o progresso e a previsão de conclusão. Se a previsão passa do prazo combinado, a OS entra no radar como risco de atraso e o vendedor pode ser avisado na hora.
Aplicativo
O chão de fábrica também tem aplicativo, na pasta mobile/. O nome na tela é Laboratório ALEX. Ele entra no mesmo projeto Supabase do site: os mesmos perfis, as mesmas funções do banco e a mesma fila. A chave de serviço não vai para o celular. Só a chave anônima, com a segurança feita no PostgreSQL.
| Área | O que a pessoa faz |
|---|
| Painel | Vê a fila do dia e os avisos de prazo e recado |
| Lançar | Entra a ordem de serviço |
| Bancada | Avança a próxima etapa da montagem |
| Lentes | Separa o que ainda não foi pedido do que já tem número e data do laboratório externo (Zeiss, Essilor, Hoya e outros) e confere se chega antes do prazo do cliente |
| Conversa | Lê o recado do vendedor e responde na própria OS, em texto ou áudio |
O código de tela, API e prazo está em mobile/lib. Os testes do prazo da lente estão em mobile/test.
cd mobile
cp .env.example .env # SUPABASE_URL e SUPABASE_ANON_KEY, as mesmas NEXT_PUBLIC do site
flutter pub get
flutter test
flutter run
É preciso o Flutter SDK instalado. Android com depuração USB ou um emulador.
Arquitetura
flowchart TB
subgraph Usuarios[Quem usa]
G[Gestor / balcão]
MT[Montador na bancada]
V[Vendedor e loja<br/>portal por link]
end
subgraph Vercel[Vercel · região São Paulo]
N[Next.js 16 · App Router<br/>Server Components e Server Actions]
end
APP[App Flutter<br/>Laboratório ALEX]
subgraph Supabase[Supabase · São Paulo]
AU[Auth]
DB[(PostgreSQL<br/>RLS + funções transacionais)]
ST[Storage privado<br/>fotos, PDFs e áudio]
end
G & MT --> N
V --> N
MT --> APP
N --> AU
N --> DB
N --> ST
APP --> AU
APP --> DB
APP --> ST
Decisões de projeto que valem destacar:
- Regras críticas no banco: mudança de status, avanço de etapa, ocorrências e estoque passam por funções SQL transacionais. Uma OS só fica Pronta com as cinco etapas concluídas e sem ocorrência aberta, mesmo que alguém tente pela API.
- Row Level Security em todas as tabelas, com cinco perfis (administrador, gestor, montador, estoquista e consulta). Esconder um botão não é a proteção; o banco recusa a operação.
- Portal sem senha e sem vazamento: o vendedor recebe um token próprio; o banco guarda só o hash, com limite de requisições e revogação.
- Regras de negócio puras e testadas em
src/lib/domain (previsão, ranking, lançamento rápido, transições de status), com testes automatizados.
- Desempenho: funções na mesma região do banco (
gru1), carregamento instantâneo com esqueleto de tela e consultas agrupadas.
Tecnologias
| Camada | Uso |
|---|
| Next.js 16 (App Router), React 19, TypeScript | Sistema web |
| Flutter e Dart | Aplicativo de chão, em mobile/ |
| Tailwind CSS 4, lucide-react, dnd-kit | Visual, ícones e Kanban |
| Supabase: PostgreSQL, Auth, Storage | Dados, segurança (RLS) e arquivos |
| Zod | Validação de formulários |
| Vitest | Testes das regras de negócio |
| Vercel + GitHub Actions | Deploy contínuo e verificação a cada push |
Rodando localmente
git clone https://github.com/alexferreiraindustrial-hue/laboratorio-optico.git
cd laboratorio-optico
npm install
cp .env.example .env.local # preencha com as chaves do seu projeto Supabase
npm run dev
O passo a passo completo (migrations, primeiro administrador, permissões e publicação) está em docs/INSTALACAO.md.
npm test # regras de negócio
npm run typecheck # TypeScript
npm run lint # ESLint
npm run build # build de produção
Roadmap
O desenvolvimento segue em ciclos curtos. As próximas entregas estão nas Issues e o histórico de cada versão em CHANGELOG.md. Destaques:
Para quem avalia
O repositório está publicado para consulta. A licença não autoriza cópia nem uso comercial sem permissão: veja LICENSE.
| O que conferir | Onde |
|---|
| Sistema no ar | lab.oticahub.com |
| Regras de prazo, ranking e fluxo | src/lib/domain e npm test |
| Permissão no banco, não só na tela | supabase/migrations |
| Aplicativo | fotos acima e o código em mobile/lib |
| Caso de melhoria contínua | docs/estudo-de-caso.md |
| ERP da ótica, código privado | erp-otica |
Autor
Alex Ferreira — estudante de Engenharia de Produção e Técnico em Óptica.
Não sou programador de formação: uso a Inteligência Artificial como ferramenta de engenharia para transformar problemas reais de gestão em soluções que funcionam no dia a dia. Eu defino o processo, as regras e os indicadores com base em Lean, Kanban, 5S e Six Sigma; a IA me ajuda a construir, conectando as ferramentas da operação por API e MCP, com automações em n8n e integração com CRM e WhatsApp; e a validação acontece no chão do laboratório. O sistema segue em melhoria contínua com uso real.
LinkedIn · antonio.oticahub.com
© 2026 Antonio Alex Silva Ferreira LTDA. Código publicado para consulta e portfólio — veja LICENSE.
