Skip to content

matheusnsi/qualityInstructionsSystem

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📋 Quality Instructions System

Sistema web para exibição digital de Instruções de Trabalho (ITs) no chão de fábrica — organizado por setor e máquina, com passos ilustrados, EPIs obrigatórios e controle de revisão. Substitui as folhas impressas plastificadas por uma interface sempre atualizada, pensada para tablets e monitores na produção.

⚙️ Sobre este projeto: é uma reimplementação autoral de um sistema que desenvolvi em contexto profissional (estágio na indústria MultiTools). O código aqui é escrito do zero e usa dados fictícios — nenhuma informação, documento ou regra de negócio da empresa está presente. O objetivo é demonstrar a solução e as competências técnicas envolvidas.

✨ Funcionalidades

  • 📂 Instruções organizadas por setor (Injeção, Montagem, Qualidade, Expedição)
  • 🔎 Busca por código, título ou máquina
  • 🪜 Visualização passo a passo de cada instrução
  • 🦺 Lista de EPIs obrigatórios por instrução
  • ⚠️ Avisos de segurança destacados
  • 🔖 Controle de revisão e data de atualização
  • 📱 Interface responsiva e com alto contraste, pensada para o ambiente de fábrica

🛠️ Tecnologias

  • React 18 + TypeScript
  • Vite (build e dev server)
  • CSS puro com variáveis (tema de fábrica, alto contraste)

📁 Estrutura

src/
├── components/
│   ├── Sidebar.tsx           # navegação por setor + busca
│   └── InstructionView.tsx   # exibição da instrução selecionada
├── data/
│   └── instructions.ts       # dados fictícios das ITs
├── types.ts                  # tipagens do domínio
├── App.tsx                   # composição da tela
└── main.tsx                  # entrada da aplicação

🚀 Rodando localmente

git clone https://github.com/matheusnsi/qualityInstructionsSystem.git
cd qualityInstructionsSystem
npm install
npm run dev

Acesse http://localhost:5173.

💡 Contexto e decisões

Na versão de produção, as instruções ficavam em um banco PostgreSQL e eram mantidas por uma área administrativa. Aqui, para manter o projeto simples de rodar e 100% autoral, os dados vivem em um arquivo TypeScript tipado (src/data/instructions.ts) — a mesma modelagem de domínio, sem a camada de banco. A separação entre tipos, dados e componentes de apresentação reflete a organização usada no sistema real.


Desenvolvido por Matheus Nascimento Silveira · LinkedIn · GitHub

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages