Sistema completo de gestão para laboratórios de análises ambientais. Desenvolvido como plataforma whitelabel, esta versão foi customizada para o LabÁgua da Universidade do Estado do Pará (UEPA).
- Geração de lotes com códigos sequenciais automáticos
- QR Codes únicos para cada amostra
- Scanner QR integrado para acesso rápido (mobile e desktop)
- Rastreamento de status: Aguardando → Em Análise → Concluído
- Impressão em papel A4 (múltiplas por página)
- Suporte para etiquetadoras térmicas (30mm × 60mm)
- Seleção de quantidade de cópias
- QR Code + código legível + data + cliente
- Físico-Químicos: pH, condutividade, turbidez, OD, DBO, DQO...
- Microbiológicos: Coliformes, E. coli, Bactérias Heterotróficas
- Metais: Ferro, Chumbo, Cádmio, Cromo...
- BTEX: Benzeno, Tolueno, Etilbenzeno, Xilenos
- Configurável por matriz analítica (água superficial, subterrânea, efluente...)
- Impressão de laudo de amostra única
- Impressão de lote completo (todas amostras do mesmo prefixo)
- Barra de progresso das análises
- Status de cada parâmetro (concluído/pendente)
- Design profissional para A4
- Autenticação JWT com sessões controladas
- 4 níveis de acesso: Admin, Professor, Técnico, Voluntário
- Logs de auditoria completos
- Histórico de modificações por amostra
- Controle de sessões simultâneas
- Interface adaptada para desktop e mobile
- Scanner QR funciona na câmera do celular
- Navegação simplificada em telas pequenas
Lab-LIMS/
├── backend/ # API Node.js + Express
│ ├── app.js # Servidor principal
│ ├── lims.db # Banco SQLite
│ └── .env # Configurações
│
└── frontend/ # React + TypeScript + Vite
├── src/
│ ├── pages/ # Páginas da aplicação
│ ├── components/# Componentes reutilizáveis
│ ├── config/ # Configurações do laboratório
│ └── contexts/ # AuthContext
└── dist/ # Build de produção
- Node.js 18+
- Git
git clone https://github.com/rdal3/LabLIMS.git
cd Lab-LIMScd backend
npm install
copy .env.example .env
# Edite o .env com seu JWT_SECRET
node app.jscd frontend
npm install
npm run dev- Frontend: http://localhost:5173
- Backend API: http://localhost:3001
- Email: admin@lab.com
- Senha: admin123
Veja o guia completo em INSTALL_UBUNTU.md
- Login com suas credenciais
- Gerar Lote de amostras:
- Selecione a matriz (água superficial, efluente, etc)
- Informe cliente e ponto de coleta
- Defina intervalo (ex: 1 a 10)
- Gere e imprima as etiquetas
- Editar Amostras:
- Escaneie o QR code ou busque no banco
- Preencha os resultados das análises
- Salve e atualize o status
- Gerar Relatório:
- Clique em "Relatório" na amostra
- Escolha amostra única ou lote
- Imprima para apresentar
- Visão Geral: Estatísticas do sistema
- Logs de Auditoria: Todas as ações no sistema
- Modificações de Amostras: Histórico detalhado de edições
- Sessões Ativas: Controle de logins
- Usuários: Criar, editar, desativar usuários
- Parâmetros: Gerenciar parâmetros analíticos
# Porta do servidor
PORT=3001
# Chave secreta para JWT (gere uma aleatória!)
JWT_SECRET=sua_chave_super_secreta_aqui
# URLs permitidas (CORS)
ALLOWED_ORIGINS=http://localhost:5173,http://192.168.1.100:5173Edite este arquivo para adicionar/remover matrizes e parâmetros do seu laboratório.
O código-fonte está disponível publicamente apenas para fins de avaliação acadêmica, transparência e demonstração. Qualquer uso comercial, redistribuição, modificação ou implementação em ambientes de produção requer autorização expressa do autor. © 2026 Raphael David Alvarenga Lopes. Todos os direitos reservados.
Raphael D. A. Lopes
Desenvolvido como plataforma whitelabel para gestão de laboratórios de análises ambientais.
Para suporte, licenciamento ou customizações, entre em contato com o autor.