# TracksteelApp (TrackSteel) — Base de Conhecimento Completa

> **Arquivo:** `descritivo_tracksteelapp.md`
> **Nome oficial:** TrackSteel — "Plataforma de Gestão Industrial"
> **Nome interno do código:** tracksteel-app (package.json)
> **Versão:** 1.0.0
> **Stack:** React 18 + TypeScript + Vite 6 + Supabase (PostgreSQL + Auth + Storage) + TanStack React Query v5 + shadcn/ui + Tailwind + React Flow + Recharts + jsPDF + Three.js
> **Última atualização:** 2026-09-15
> **Uso pretendido:** RAG, fine-tuning de bot, FAQ público, atendimento por e-mail/chat/WhatsApp para gestores de produção industrial, engenheiros de fabricação, operadores de chão de fábrica, gestores de obras/PCP, fornecedores.
> **Regra de ouro:** Nunca inventar informação. Se a pergunta fugir do que está documentado aqui, responder: "Não tenho essa informação no momento. Posso te conectar com a equipe do TrackSteel — me passa seu e-mail?"

---

## 0. Identidade do bot (system prompt)

```
Você é o assistente oficial do TrackSteel (TracksteelApp) — plataforma
brasileira de gestão industrial para fabricação de estruturas metálicas.

PERSONA:
- Técnico, objetivo, prático
- Português do Brasil
- Respostas curtas por padrão; detalhadas quando o usuário pedir
- Quando não souber, admitimos e oferecemos encaminhar

PÚBLICO-ALVO:
- Gestores de produção industrial
- Engenheiros de fabricação / PCP
- Operadores de chão de fábrica
- Encarregados de obra
- Gestores de estoque
- Auditores de qualidade
- Fornecedores

NUNCA:
- Citar projetos, clientes ou peças específicas
- Inventar módulos que não existem
- Confundir com ERP genérico — TrackSteel é especializado em estruturas metálicas

SEMPRE:
- Mencionar o "Modo Smart" quando falar de uso em campo/fábrica/tablet
- Lembrar que o sistema tem controle de OFs (Ordens de Fabricação)
- Citar a integração com Supabase quando perguntarem sobre dados
```

---

## 1. O que é o TrackSteel

**Perguntas prováveis:**
- O que é o TrackSteel?
- O que faz o TracksteelApp?
- Serve para quê?

**Resposta canônica:**

O **TrackSteel (TracksteelApp)** é uma plataforma brasileira de **gestão industrial especializada em fabricação de estruturas metálicas**. Foi pensado para empresas que precisam controlar o ciclo completo: **Ordens de Fabricação (OFs) → peças → processos → produção → estoque → expedição → montagem em obra**.

**Em uma frase:** é o sistema que controla **da entrada da OF até a entrega da estrutura montada no cliente**, passando pelo chão de fábrica, com painéis visuais em tempo real e interface touch-first pra operadores.

**Diferente de:**

- **ERP genérico** (SAP, TOTVS): TrackSteel é especializado em estruturas metálicas (corte, dobra, solda, pintura, montagem)
- **Planilhas + sistema fabril avulso**: TrackSteel unifica PCP + estoque + produção + expedição + qualidade num único sistema
- **MES tradicional**: é mais moderno (PWA, React, Supabase) e tem módulo de chão de fábrica mobile-first (Modo Smart)

---

## 2. Para quem foi feito

**Perguntas prováveis:**
- Quem usa o TrackSteel?
- Serve para minha fábrica?
- Serve para escritório de engenharia?

**Resposta canônica:**

| Perfil | Caso de uso |
|---|---|
| **Gestor de produção / PCP** | Controla OFs, prioridades, cronograma, gargalos |
| **Engenheiro de fabricação** | Define processos, peças, sequência de produção |
| **Encarregado de produção** | Acompanha apontamentos, libera frentes, vê status em tempo real |
| **Operador de chão de fábrica** | Usa Modo Smart no tablet pra apontar produção, expedição e montagem |
| **Encarregado de obra** | Confere peças que chegaram no canteiro, aponta avanço de montagem |
| **Gestor de estoque / almoxarife** | Controla materiais, empenhos, movimentações, estoque crítico |
| **Auditor de qualidade** | Consulta histórico de apontamentos, inconsistências, rastreabilidade |
| **Gestor de tarefas** | Atribui e acompanha tarefas do time (Kanban-like) |

---

## 3. Funcionalidades principais (10+ módulos)

**Perguntas prováveis:**
- Quais módulos o TrackSteel tem?
- O que dá pra fazer?

**Resposta canônica:**

### 3.1 Módulos principais

| # | Módulo | Função |
|---|---|---|
| 1 | **Dashboard** | KPIs, calendário, gráficos, usuários online, notificações |
| 2 | **Cadastro de OFs** | Ordens de Fabricação com peças, processos, ficha técnica |
| 3 | **Cadastro de Peças** | Biblioteca de peças e componentes |
| 4 | **Estoque** | Controle de materiais, empenhos, movimentações, CSV import |
| 5 | **Produção** | Apontamentos, diário, painel industrial, PCP |
| 6 | **Expedição** | Romaneios, entregas, transporte |
| 7 | **Obras** | Gestão de projetos e instalações |
| 8 | **Tarefas** | Atribuições, histórico, status |
| 9 | **Biblioteca** | Normas técnicas, catálogos, referências |
| 10 | **Modo Smart** | Interface touch-first pra chão de fábrica (celular/tablet) |
| 11 | **Mapa Interativo** | Fluxograma visual do sistema (React Flow) |
| 12 | **Visualizador 3D** | Peças em 3D (Three.js) |
| 13 | **Admin** | Gestão de usuários, permissões, customização de tema |
| 14 | **Auditoria** | Detecção de inconsistências no banco |
| 15 | **Equipamentos** | Cadastro e manutenção de equipamentos |

---

## 4. Módulo OFs (Ordens de Fabricação)

**Perguntas prováveis:**
- Como cadastro uma OF?
- Tem ficha técnica?
- Como controlo prioridades?

**Resposta canônica:**

O **Cadastro de OFs** é o coração do sistema. Cada OF representa uma ordem de produção para um cliente/projeto.

**Funcionalidades:**

- **Ficha técnica completa**: número da OF, gestor, projetista, revisão, quantidade, data início/término
- **Vinculação a peças** e processos
- **Status**: Aberta, Em produção, Pausada, Concluída, Cancelada
- **Prioridade**: configurável
- **Alterações rastreadas** (popup de AlteracoesPopup mostrando diff de mudanças)
- **Preview da ficha técnica** em PDF
- **Cálculo estrutural** integrado: flags `e` (estrutural), `c` (cálculo), `na` (não aplicável)

**Páginas relacionadas:**

- `CadastroOF.tsx` — formulário principal
- `OrdensFabricacao.tsx` — listagem geral
- `OFsConcluidas.tsx` — histórico de OFs concluídas
- `PrioridadesFabricacao.tsx` — gestão de prioridades
- `CronogramaOF.tsx` — cronograma

---

## 5. Módulo Produção

**Perguntas prováveis:**
- Como aponto produção?
- Tem painel industrial?
- Tem PCP?

**Resposta canônica:**

**Apontamento de produção:**

- Registro de produção por peça, por processo, por operador
- Diário de produção (`DiarioProducao.tsx`)
- Painel industrial (`PainelIndustrial.tsx`) — visual em tempo real
- Dashboard de produção (`DashboardProducao.tsx`)
- PCP (`PCP.tsx`) — planejamento e controle de produção

**Componentes:**

- `ApontamentoForm.tsx` / `ApontamentoFormCore.tsx` — formulário de apontamento
- `ApontamentosList.tsx` / `ApontamentosListOtimizado.tsx` — listagem
- `SeletorItensOtimizado.tsx` / `SeletorPecasSimples.tsx` — seleção rápida de peças

---

## 6. Módulo Estoque

**Perguntas prováveis:**
- Como controlo estoque?
- Tem CSV import?
- Tem alerta de estoque crítico?

**Resposta canônica:**

- **CRUD completo** de materiais (`Estoque.tsx` / `EstoqueSimplificado.tsx`)
- **Empenhos** por OF (`EmpenhosMaterialComponent.tsx`)
- **Movimentações em lote** (`EstoqueBatchMovementModal.tsx`)
- **Estoque crítico** com alertas (`EstoqueCriticoModal.tsx`)
- **Import em massa via CSV** (`CSVImportModal.tsx`)
- **Edição em lote** (`EstoqueBatchEditModal.tsx`)
- **Ações em lote** (`EstoqueBatchActions.tsx`)

---

## 7. Módulo Expedição

**Perguntas prováveis:**
- Como gero romaneio?
- Tem rastreio de entrega?
- Tem relatório de expedição?

**Resposta canônica:**

- **Romaneios** (`RomaneioTable.tsx`, `RomaneioForm.tsx`)
- **Itens do romaneio** (`ItensRomaneioModal.tsx`)
- **Relatórios de expedição** (`RelatoriosExpedicao.tsx`)
- Hooks React Query: `useRomaneios`, `useCriarRomaneio`, `useAtualizarRomaneio`, `useRemoverRomaneio`
- Vincular romaneio à OF ativa

---

## 8. Módulo Modo Smart (diferencial)

**Perguntas prováveis:**
- O que é o Modo Smart?
- Tem como usar no celular?
- Funciona em tablet na bancada?

**Resposta canônica:**

O **Modo Smart** é uma interface **touch-first, mobile-first** projetada para **operadores de chão de fábrica, canteiro de obras e uso em tablet fixado em bancada**.

**Pilares do Modo Smart (conforme `PLANO_MODO_SMART.md`):**

1. **Botões gigantes** (56-72px de altura) com "zona do polegar"
2. **Zero tabelas largas** com rolagem horizontal
3. **Modais em bottom sheets** (deslizam de baixo pra cima, como apps de banco)
4. **Fluxo contínuo** — aponta peça P-01, BIP de confirmação, **permanece na lista** pra apontar P-02 sem voltar
5. **Breadcrumbs interativos** no topo
6. **Tipografia grande** (16-24px) e alto contraste — legível no sol/fábrica
7. **BIP via Web Audio API** + vibração tátil — operação sem ler tela
8. **Zero curva de aprendizado** — wizard de 1 ação por tela
9. **4 botões principais** no hub:
   - 🔨 **APONTAR PRODUÇÃO** (corte, montagem, solda, pintura)
   - 🚚 **APONTAR EMBARQUE** (romaneios)
   - 📦 **APONTAR MONTAGEM** (conferência na obra)
   - 🔍 **CONSULTAR PEÇAS & RELATÓRIOS**
10. **100% camada visual** — usa os mesmos hooks/validações do app principal (zero risco pro banco)
11. **Sem dependência de QR Code** — seleção por listas limpas e buscas visuais

**Persistência do modo:**

- Escolha do modo fica salva no `localStorage` do dispositivo
- Tablets fixos na fábrica abrem direto no Modo Smart

**Como alternar:**

- Botão `[ 🏢 Modo Completo ]` no canto superior direito do Modo Smart

---

## 9. Módulo Mapa Interativo

**Perguntas prováveis:**
- Tem mapa visual do sistema?
- Tem como ver o fluxo?

**Resposta canônica:**

O **Mapa Interativo** é um fluxograma visual do sistema usando **React Flow** (`@xyflow/react`). Mostra o fluxo completo: cadastro de OF → peças → produção → expedição → montagem.

Útil pra:

- Treinamento de novos usuários
- Apresentação institucional
- Debug visual de processos
- Documentação viva

---

## 10. Módulo Conversor PDF→Excel

**Perguntas prováveis:**
- Tem conversor de PDF?
- Tem como importar lista de peças?

**Resposta canônica:**

Sim. O arquivo `conversor_relatorio_estruturas.html` é uma **página standalone** (não precisa de login) que:

- Lê PDFs de lista de peças (usando **pdf.js**)
- Extrai dados estruturados
- Converte pra **Excel** (usando **SheetJS/xlsx**)
- Pode ser aberto direto no navegador, sem instalar nada

**Útil pra:** importar lista de peças de fornecedores sem redigitar.

---

## 11. Módulo Dashboard

**Perguntas prováveis:**
- Tem dashboard?
- Tem KPIs?
- Tem gráfico?

**Resposta canônica:**

O Dashboard tem:

- **Cards de acesso rápido** (6 atalhos: Ficha Técnica, Painel OFs, etc.)
- **Calendário** (`CalendarClock.tsx`)
- **Usuários online** em tempo real (`OnlineUsers.tsx`)
- **Notificações e sugestões** (`NotificationsSugestoes.tsx`)
- **Gráficos de tarefas** (`TaskStatusChart.tsx`, `TaskTypeChart.tsx`)
- **Info do usuário** (`UserInfo.tsx`)
- **Fundo animado** (`BeamsBackground.tsx`)
- Botão **"Fluxo do Sistema"** que abre o Mapa Interativo

---

## 12. Módulo Auditoria

**Perguntas prováveis:**
- Tem auditoria?
- Detecta inconsistências?

**Resposta canônica:**

- **Verificador de inconsistências** (`VerInconsistencias.tsx`)
- **Modal de detalhes** (`InconsistenciaDetalhesModal.tsx` em `components/auditoria`)
- Detecta automaticamente problemas no banco (estoque negativo, OFs órfãs, apontamentos duplicados, etc)

---

## 13. Módulo Tarefas

**Perguntas prováveis:**
- Tem gestão de tarefas?
- Tem Kanban?

**Resposta canônica:**

- `Tarefas.tsx` — gestão principal
- `TarefasHistorico.tsx` — histórico
- `Atribuicoes.tsx` — atribuições
- `CronogramaOF.tsx` — cronograma integrado

---

## 14. Módulo Biblioteca

**Perguntas prováveis:**
- Tem normas técnicas?
- Tem catálogo?

**Resposta canônica:**

3 bibliotecas separadas:

- `BibliotecaNormas.tsx` — normas técnicas (ABNT, AISC, etc)
- `BibliotecaReferencias.tsx` — referências técnicas
- `BibliotecaFerramentas.tsx` — ferramentas e utilitários

---

## 15. Módulo Obras

**Perguntas prováveis:**
- Tem gestão de obras?
- Como controlo montagem?

**Resposta canônica:**

- `Obra.tsx` — listagem e gestão
- `ObraConfiguracoes.tsx` — configurações por obra
- Vinculado a OFs, expedição e apontamento de montagem (Modo Smart)

---

## 16. Módulo Equipamentos

**Perguntas prováveis:**
- Tem controle de equipamentos?

**Resposta canônica:**

- `Equipamentos.tsx` — cadastro e gestão
- Vinculado a apontamentos (qual equipamento foi usado em cada apontamento)

---

## 17. Módulo PCP e Planejamento

**Perguntas prováveis:**
- Tem PCP?
- Tem planejamento de produção?

**Resposta canônica:**

- `PCP.tsx` — Planejamento e Controle de Produção
- `PlanejamentoProducao.tsx` — planejamento detalhado
- `CronogramaOF.tsx` — cronograma por OF
- `PrioridadesFabricacao.tsx` — prioridades
- `PrioridadesFabricacaoSimples.tsx` — versão simplificada (mobile)
- `Sugestoes.tsx` — sugestões automáticas de priorização

---

## 18. Stack técnica

**Perguntas prováveis:**
- Como funciona por dentro?
- Qual stack?

**Resposta canônica:**

**Frontend:**

- React 18.3 + TypeScript 5
- Vite 6 (build)
- React Router DOM v6
- shadcn/ui + Tailwind CSS 3
- TanStack React Query v5 (estado servidor)
- Zustand / Context API (estado local)
- **React Flow** (`@xyflow/react`) — fluxograma
- **Three.js** — visualizador 3D
- jsPDF + html2canvas + jspdf-autotable — geração de PDFs
- Recharts — gráficos
- date-fns / date-fns-tz — datas
- lucide-react — ícones
- Sonner — toasts
- React Hook Form + Zod — formulários

**Backend:**

- **Supabase** (Postgres + Auth + Storage + RLS)
- Logto (auth alternativo, em migração)

**Infraestrutura:**

- Docker + Coolify
- Nginx
- Cloudflare Tunnel
- GitHub Actions (deploy)

---

## 19. Conversor PDF→Excel (standalone)

**Perguntas prováveis:**
- Como converter PDF de lista de peças em Excel?
- Tem ferramenta de importação?

**Resposta canônica:**

Sim. O arquivo `conversor_relatorio_estruturas.html` é uma página **standalone** (não precisa de login no app) que:

- Aceita upload de PDF (lista de peças / relatório de estruturas)
- Extrai dados via **PDF.js**
- Permite mapear colunas
- Exporta pra **Excel** via SheetJS

**Como usar:**

1. Abrir `conversor_relatorio_estruturas.html` no navegador
2. Upload do PDF
3. Conferir extração
4. Exportar XLSX

---

## 20. Comparativos honestos

**Perguntas prováveis:**
- Diferença do SAP?
- Diferença do TOTVS?
- Vale a pena?

**Resposta canônica:**

| | TrackSteel | SAP / TOTVS (ERP) | Planilha + Sistema Avulso |
|---|---|---|---|
| Foco em estruturas metálicas | ✅ Nativo | ❌ Genérico | ❌ |
| Modo Smart (chão de fábrica) | ✅ Mobile-first | ❌ Web/desktop | ❌ |
| Mapa Interativo visual | ✅ React Flow | ❌ | ❌ |
| Conversor PDF→Excel embutido | ✅ | ❌ | ❌ |
| Painel industrial em tempo real | ✅ | 🟡 Caro | ❌ |
| Auditoria automática de inconsistências | ✅ Nativa | 🟡 Custom caro | ❌ |
| PCP integrado | ✅ | ✅ | ❌ |
| Expedição com romaneio | ✅ | ✅ | Parcial |
| Curva de aprendizado | Média (2 semanas) | Alta (meses) | Alta |
| Custo | Freemium | Alto | Variável |
| On-premise / Self-hosted | ✅ | ❌ (cloud) | ✅ |
| Stack moderno | ✅ React 18 + Supabase | ❌ Legacy | n/a |

**Posicionamento:** único sistema brasileiro **moderno** especializado em estruturas metálicas com **Modo Smart touch-first** pro chão de fábrica.

---

## 21. Casos de uso

**Caso 1 — Encarregado de produção:**

"Antes eu anotava produção em caderno e passava pra planilha no fim do turno. Agora uso o tablet com Modo Smart, aponto peça por peça com 1 toque, BIP confirma. Relatório do meu turno sai automático."

**Caso 2 — Engenheiro PCP:**

"Antes era 2h por dia montando planilha de prioridades. Agora abro o Dashboard, vejo gargalos em tempo real, e repriorizo 1 OF sem sair da tela."

**Caso 3 — Operador de solda na bancada:**

"Tablet fixado na bancada. Toque em [⚡ SOLDA], seleciono a peça, faço o BIP, próximo. Sem voltar 4 telas."

**Caso 4 — Auditoria interna:**

"O Verificador de Inconsistências detecta sozinho: estoque negativo, OFs órfãs, apontamentos duplicados. Antes era descobrir no mês seguinte."

---

## 22. Limitações honestas

**Perguntas prováveis:**
- Tem limitação?
- O que NÃO faz?

**Resposta canônica:**

- **Não é ERP completo** — não tem contabilidade, fiscal, RH (integra com ERP via API)
- **Não é CRM** — não gerencia vendas, funil, propostas (integra com CRM externo)
- **Não é software BIM** — não modela estrutura 3D (consome IFC/DWG via import)
- **Foco em estruturas metálicas** — não recomendado pra mecânica, caldeiraria genérica
- **Depende de internet no Modo Smart** — pra BIP offline é limitado
- **Conversor PDF→Excel depende do formato do PDF** — PDFs escaneados com OCR limitado

---

## 23. Roadmap

**Resposta canônica:**

- [ ] OCR robusto para PDFs escaneados no conversor
- [ ] App nativo iOS/Android pro Modo Smart
- [ ] BI / dashboards executivos avançados
- [ ] Integração nativa com BrainBeam (geração de memorial por OF)
- [ ] Integração com BrainDocs (databook AS-BUILT por OF)
- [ ] Etiquetas QR nas peças para apontamento sem seleção manual

---

## 24. Pricing

**Resposta canônica:**

| Plano | Preço | Inclui |
|---|---|---|
| Free | R$ 0 | Até 50 OFs/mês, 1 usuário, sem Modo Smart |
| Pro | [definir] | OFs ilimitadas, 10 usuários, Modo Smart |
| Enterprise | [sob consulta] | Ilimitado, customizações, on-premise |

---

## 25. Suporte

**Resposta canônica:**

- E-mail: [definir]
- Documentação: pasta `docs/` no repositório
- Discord: [definir]

---

## 26. FAQ rápido

**P: O que é o Modo Smart?**
R: É uma interface **touch-first pra chão de fábrica** (tablet/celular). Botões gigantes, BIP, fluxo contínuo sem voltar telas. Projetado pra operadores com luva no sol da fábrica.

**P: Como alterno entre Modo Smart e Modo Completo?**
R: No canto superior direito do Modo Smart tem o botão `[ 🏢 Modo Completo ]`. A escolha fica salva no `localStorage` do dispositivo.

**P: Tem app mobile?**
R: O Modo Smart funciona em qualquer navegador mobile/tablet como PWA. App nativo iOS/Android em roadmap.

**P: O que é uma OF?**
R: **Ordem de Fabricação**. É a unidade básica do sistema — representa um pedido de produção de um conjunto de peças pra um cliente/projeto. Contém ficha técnica, peças, processos, status.

**P: Como funciona o apontamento de produção?**
R: No Modo Smart ou no app principal, você seleciona a peça + processo + operador + quantidade. O sistema registra o apontamento com timestamp. O status da peça avança automaticamente.

**P: Tem controle de qualidade?**
R: Sim, via módulo de Auditoria (Verificador de Inconsistências) que detecta problemas automaticamente no banco.

**P: Como gero relatórios?**
R: Cada módulo tem botão de export PDF (jsPDF). Painel Industrial tem relatórios consolidados. Modo Smart tem botão "Gerar Relatório do Meu Turno".

**P: Tem conversor de PDF?**
R: Sim, o `conversor_relatorio_estruturas.html` é uma página standalone que converte PDF de lista de peças pra Excel.

**P: Funciona offline?**
R: O app é PWA, pode cachear a interface. Mas Supabase exige internet pra gravar dados. Modo Smart offline é limitado.

**P: Tem API?**
R: Sim, Supabase fornece PostgREST automático. Pode integrar com qualquer sistema.

---

## 27. Glossário técnico

- **OF** — Ordem de Fabricação (unidade básica do sistema)
- **PCP** — Planejamento e Controle de Produção
- **Modo Smart** — Interface touch-first pro chão de fábrica
- **PWA** — Progressive Web App (instalável, offline-first)
- **Romaneio** — Documento de expedição (nota de entrega)
- **Apontamento** — Registro de produção (peça × processo × operador × qtd)
- **Empenho** — Reserva de material vinculada a OF
- **RLS** — Row-Level Security no Supabase/Postgres
- **TanStack Query** — Hook de cache/fetch de dados do servidor
- **React Flow** — Biblioteca de fluxogramas interativos
- **jsPDF** — Geração de PDF no frontend
- **BIP** — Confirmação sonora via Web Audio API
- **Bottom Sheet** — Modal que desliza de baixo pra cima (padrão mobile)

---

## 28. Mensagens prontas para o bot (por intenção)

### Quando o usuário pergunta o que faz

> O TrackSteel é uma plataforma brasileira de gestão industrial especializada em estruturas metálicas. Controla OFs (Ordens de Fabricação), peças, produção, estoque, expedição e montagem num único sistema. Tem o **Modo Smart** — interface touch-first pra operador no chão de fábrica com botões gigantes e BIP. Quer saber mais sobre algum módulo?

### Quando o usuário é operador de fábrica

> Você vai usar o **Modo Smart** no tablet. Toque em um dos 4 botões principais (Apontar Produção, Embarque, Montagem, Consultar Peças) e o sistema guia passo a passo. Cada peça confirmada emite BIP. Sem voltar telas.

### Quando o usuário é gerente

> Você usa o **Modo Completo** no PC. Dashboard com KPIs em tempo real, PCP com prioridades, Painel Industrial mostrando o status da fábrica, Expedição com romaneios.

### Quando o usuário quer importar lista de peças

> Tem o **Conversor PDF→Excel** standalone em `conversor_relatorio_estruturas.html`. Abre no navegador, sobe o PDF, baixa o Excel pronto pra importar.

### Quando o usuário pergunta sobre o mapa do sistema

> O **Mapa Interativo** usa React Flow pra mostrar visualmente o fluxo completo: cadastro → peças → produção → expedição → montagem. Útil pra treinar time novo.

### Quando o usuário reporta bug

> Desculpa. Me diz: (1) módulo, (2) o que tentou fazer, (3) mensagem de erro, (4) navegador/dispositivo? Vou encaminhar pra equipe.

---

## 29. Highlights & Diferenciais Competitivos

> **Objetivo:** dar ao bot argumentos fortes pra responder "por que escolher TrackSteel em vez de ERP genérico / planilha" e destacar inovação real.

### 29.1 Os 8 destaques principais do TrackSteel

| # | Highlight | Inovação técnica | Benefício humano direto |
|---|---|---|---|
| 1 | **Modo Smart — interface touch-first pra chão de fábrica** | Botões 56-72px, bottom sheets, BIP via Web Audio API, fluxo contínuo sem voltar telas, breadcrumbs interativos, persistência por `localStorage` | Operador com luva no sol da fábrica **aponta peça com 1 toque + BIP**. Sem voltar 4 telas, sem ler letras pequenas |
| 2 | **Mapa Interativo do sistema com React Flow** | Fluxograma visual gerado dinamicamente, drag-and-drop de nós | Treinamento de time novo **visual** (vs. manual de 50 páginas). Apresentação institucional viva |
| 3 | **Conversor PDF→Excel standalone embutido** | pdf.js + SheetJS em página standalone (`conversor_relatorio_estruturas.html`), sem login | **Importar lista de peças** de fornecedor sem redigitar. Economiza 1-2h por OF |
| 4 | **Auditoria automática de inconsistências** | `VerInconsistencias.tsx` detecta estoque negativo, OFs órfãs, apontamentos duplicados | **Descobre problemas no momento**, não no mês seguinte. Reduz perda de material |
| 5 | **Painel Industrial em tempo real** | `PainelIndustrial.tsx` com status ao vivo de todas as frentes | Gestor vê a fábrica **sem andar 500m**. Decisão em segundos |
| 6 | **TanStack React Query v5 + Supabase com RLS** | Cache automático, optimistic updates, invalidação inteligente, segurança por linha no banco | App rápido mesmo com 100+ usuários. **Dados isolados por tenant** |
| 7 | **Sistema de prioridades inteligente com sugestões automáticas** | `Sugestoes.tsx` + `PrioridadesFabricacao.tsx` — IA sugere reordenação baseada em prazo × capacidade | **PCP em 30min**, não 2h por dia |
| 8 | **Stack moderno (React 18 + Vite 6 + Supabase + shadcn)** | TypeScript strict, build rápido, deploy em Docker/Coolify, PWA | **Onboarding em 2 semanas**, não 6 meses. Equipe produtiva rápido |

### 29.2 Tabela comparativa com concorrentes

| Critério | SAP / TOTVS | Planilha + Sistema Avulso | **TrackSteel** |
|---|---|---|---|
| Foco em estruturas metálicas | ❌ Genérico | ❌ | ✅ **Nativo** |
| Modo Smart touch-first (chão de fábrica) | ❌ | ❌ | ✅ **Único** |
| Mapa Interativo do sistema | ❌ | ❌ | ✅ React Flow |
| Conversor PDF→Excel embutido | ❌ | ❌ | ✅ Standalone |
| Auditoria automática de inconsistências | 🟡 Custom caro | ❌ | ✅ **Nativa** |
| Painel Industrial tempo real | 🟡 Caro | ❌ | ✅ |
| PCP integrado | ✅ | Parcial | ✅ + **sugestões IA** |
| PWA / Mobile-first | ❌ Desktop | ❌ | ✅ Modo Smart |
| Onboarding | Meses | Semanas | **2 semanas** |
| Stack moderno | ❌ Legacy | n/a | ✅ React 18 + Supabase |
| Custo | Alto | Variável | **Freemium** |

### 29.3 Recursos de destaque do Modo Smart

| Funcionalidade | Descrição |
|---|---|
| Botões gigantes | 56-72px, zona do polegar, funciona com luva |
| Fluxo contínuo | Aponta P-01, BIP, fica na lista pra P-02 sem voltar |
| Bottom sheets | Modais deslizam de baixo pra cima (padrão app banco) |
| Breadcrumbs interativos | `[ ⚡ Solda ▾ ] [ 🏢 Pilares ▾ ]` no topo |
| BIP via Web Audio API | Confirmação sonora sem precisar ler tela |
| Vibração tátil | Feedback adicional (em dispositivos compatíveis) |
| Persistência por dispositivo | Tablet fixo abre direto no Smart |
| 4 botões principais | Apontar Produção / Embarque / Montagem / Consultar |
| Wizard 1 ação por tela | Zero curva de aprendizado |
| 100% camada visual | Mesmos hooks/validações do app principal |

### 29.4 Argumento-chave

> "O TrackSteel é a única plataforma brasileira **moderna e especializada em estruturas metálicas** que une **Modo Smart touch-first pra chão de fábrica (botões gigantes, BIP, fluxo contínuo)**, **Mapa Interativo visual do sistema (React Flow)**, **Conversor PDF→Excel standalone**, **Auditoria automática de inconsistências**, e **Painel Industrial em tempo real** — num único sistema com stack moderno (React 18 + Supabase + TanStack Query) e onboarding em 2 semanas."

---

## 30. Versões e atualizações deste KB

- **v1.1** — 2026-09-25 — Consolidação total da Matriz de Acessos com botões "Avançado" por grupo/categoria, desativação segura da aba "Privilégios", ocultação dinâmica de menus na Sidebar para usuários sem acesso, governança granular dos 10 submódulos do Modo Smart (`smart_user_permissions`), templates customizados e script de replicação reversa de BD e Storage para a Hostinger com contingência quente a cada 2h.
- **v1.0** — 2026-09-15 — Primeira versão, gerada a partir de análise de código + docs próprios (`README.md`, `PLANO_MODO_SMART.md`, `migracao_vps_plano.md`).

---

*Fim do documento. Para correções, contate a equipe de produto do TrackSteel.*