Plataforma operacional para centralizar reposições, admissões, faltas, glosas, estoque, indicadores e estrutura de contratos.
API · Configuração · Módulos
O TM Hub é a interface web do ecossistema operacional da TM. Ele combina fluxos administrativos, painéis executivos e operações em tempo real em uma experiência responsiva, com suporte a tema claro/escuro e controle granular de acesso.
A aplicação consome a API TM Hub e recebe eventos via Socket.IO para manter telas críticas sincronizadas sem atualizações manuais.
| Área | Recursos |
|---|---|
| Reposições | Requisições públicas e autenticadas, lançamento rápido, reservas técnicas, histórico, timeline e KDS em tempo real |
| Admissões | Vagas de substituição e aditivos, acompanhamento de SLA em dias úteis e dashboard |
| Faltas | Tratativa, prazos documentais, lançamentos manuais e indicadores |
| Glosas | Cobertura integral/parcial, valores, evidências, filtros e exportação XLSX |
| Ponto 48h | Importação e análise de apontamentos operacionais |
| Estoque | Produtos, movimentações, códigos de barras e leitura por câmera |
| Estrutura | Departamentos, contratos, supervisores, locais, ativos e patrimônio |
| Projetos | Cards, responsáveis, etapas e acompanhamento visual |
| Configurações | Usuários, permissões, filiais, contratos, departamentos e tema persistente |
- Autenticação por JWT e rotas protegidas.
- Permissões por tela: visualizar, criar e alterar.
- Escopo obrigatório por filial para usuários comuns.
- Visão unificada das filiais vinculadas ao usuário.
- Tema claro e escuro persistido.
- Atualizações em tempo real com Socket.IO.
- Dashboards com Chart.js.
- Exportações em XLSX e PDF.
- Upload, arrastar e colar evidências.
- Geração e leitura de códigos de barras.
- Interface responsiva e instalável como PWA.
Important
O filtro de filial é uma regra de segurança e de negócio. Usuários comuns recebem somente dados das filiais às quais estão vinculados. As rotas públicas são as únicas exceções previstas.
| Camada | Tecnologias |
|---|---|
| Interface | React 19, PrimeReact, PrimeFlex e PrimeIcons |
| Build | Vite 8 |
| Navegação | React Router |
| Comunicação | Axios e Socket.IO Client |
| Indicadores | Chart.js e chartjs-plugin-datalabels |
| Documentos | jsPDF, OpenPyXL no backend e exportações XLSX |
| Códigos | bwip-js e Quagga2 |
| PWA | Web App Manifest e ícones multiplataforma |
Usuário
│
▼
React + PrimeReact
├── HTTP / Axios ───────────────► Flask REST API
└── Socket.IO Client ◄──────────► Flask-SocketIO
│
▼
PostgreSQL + SQLAlchemy
- Node.js 20 ou superior.
- npm.
- API TM Hub configurada e em execução.
git clone https://github.com/foxtec198/tmhub.git
cd tmhub
npm installCrie um arquivo .env na raiz:
VITE_SERVER=http://localhost:8590Inicie o ambiente:
npm run devA aplicação ficará disponível em http://localhost:5173.
Para testar em outros dispositivos da rede local no Windows:
npm run dev:mobile| Comando | Finalidade |
|---|---|
npm run dev |
Inicia o Vite em modo de desenvolvimento |
npm run dev:mobile |
Prepara o acesso pela rede local |
npm run build |
Gera o bundle de produção |
npm run preview |
Visualiza localmente o bundle gerado |
npm run lint |
Executa as verificações do ESLint |
src/
├── components/ # Componentes reutilizáveis
├── contexts/ # Loading, toast e estados globais
├── layouts/ # Estrutura autenticada da aplicação
├── pages/ # Telas organizadas por domínio
├── utils/ # API, Socket.IO e permissões
└── App.jsx # Rotas públicas e protegidas
- O token é enviado no cabeçalho
Access-Token. - A interface oculta ações sem permissão, mas a decisão final sempre ocorre na API.
- O backend restringe consultas e mutações pelo escopo de filial.
- Credenciais e segredos nunca devem ser adicionados ao repositório.
O backend, os modelos de dados e as regras de negócio estão no repositório api_tmhub.
Projeto proprietário destinado ao uso interno. Distribuição, cópia ou modificação externa dependem de autorização.