Home

ReTool — Wiki

O ReTool é uma aplicação web para a gestão dos dispositivos da ferramentaria e do fluxo de reutilização de peças. Foi desenvolvido por alunos do curso de Desenvolvimento de Software Multiplataforma (DSM) da Fatec Matão, em parceria com a Baldan. A equipe completa está na tela Sobre do próprio sistema.

Objetivos do projeto, conforme a tela Sobre:

• estruturar o cadastro inicial das peças da ferramentaria;
• registrar a utilização de cada peça e sua aplicação;
• apoiar a padronização dos dados com evolução contínua, orientada pelas áreas técnicas (TI e Ferramentaria).

Estado desta documentação: descreve o código da branch feat/administracao-acessos-auditoria (setembro de 2026). Até essa branch ser integrada à main, a Administração, o cadastro como Convidado, as senhas temporárias, a Cloud Function e os índices do histórico existem apenas nela.

Principais funcionalidades

Área	O que faz	Página
Dispositivos	Cadastro, busca, filtros, imagens, PDFs, importação por planilha e ações em massa	Módulos do Sistema
Classificações	Categorias, famílias e produtos usados nos dispositivos	Módulos do Sistema
Reutilizações	Fluxo de solicitação e análise entre Engenharia e Projetista, com histórico e hard saving	Módulos do Sistema
Acesso	Login, cadastro como Convidado, aprovação, cargos e senha temporária	Usuários, Cargos e Permissões · Fluxos de Acesso
Administração	Cadastros pendentes, solicitações de cargo, usuários e histórico de ações	Fluxos de Acesso · Logs e Auditoria
Notificações	Sino com avisos de cadastros, cargos e reutilizações	Notificações

Por onde começar

• Vou rodar o projeto pela primeira vez: Configuração do Ambiente
• Quero entender como o sistema é construído: Arquitetura → Firebase e Firestore
• Vou mexer no código: Guia do Desenvolvedor → Testes
• Vou publicar uma versão: Build e Deploy
• Algo deu errado: Solução de Problemas

Todas as páginas

1. Arquitetura — stack, camadas, diretórios e rotas
2. Configuração do Ambiente — instalação, variáveis de ambiente e execução local
3. Módulos do Sistema — telas e regras de negócio
4. Usuários, Cargos e Permissões — cargo × situação × permissões
5. Fluxos de Acesso — cadastro, aprovação, cargo e senhas
6. Notificações
7. Logs e Auditoria — o que é registrado e a tela de Histórico de Ações
8. Firebase e Firestore — projetos, coleções, regras, índices e Cloud Functions
9. Segurança
10. Testes
11. Build e Deploy
12. Guia do Desenvolvedor
13. Solução de Problemas — inclui FAQ
14. Histórico de Alterações