Fixr - O jeito fácil de gerenciar sua assistência técnica
O Fixr é uma aplicação web desenvolvida para o gerenciamento de ordens de serviço em assistências técnicas. O projeto tem como objetivo otimizar processos internos, centralizar informações e facilitar o acompanhamento de serviços, oferecendo uma solução completa para empresas do setor.
A aplicação foi idealizada a partir de entrevistas com profissionais da área de eletroeletrônicos, realizadas com o propósito de compreender as principais dificuldades enfrentadas por empresas de pequeno e médio porte. A partir dessas entrevistas, foram definidos os requisitos funcionais e não funcionais do sistema, elaborados os modelos de banco de dados (conceitual, lógico e físico) e desenvolvido um protótipo de interface utilizando a ferramenta Figma.
O Fixr foi desenvolvido como parte da disciplina de Projeto Integrador do curso de Ciência da Computação da Faculdade das Américas (FAM), aplicando tecnologias modernas e práticas consolidadas de desenvolvimento web para garantir segurança, desempenho e escalabilidade.
[!NOTE]
Acesse o projeto agora mesmo: https://fixr.com.br
Criado com
Sumário
Objetivo
O gerenciamento de ordens de serviço em assistências técnicas enfrenta diversos desafios, especialmente em empresas de pequeno e médio porte que ainda utilizam processos manuais. Entre os problemas mais comuns estão a perda de formulários, atrasos no atendimento, dificuldade de acompanhamento do status de reparos e controle ineficiente de estoque.
O Fixr foi desenvolvido para superar essas limitações, oferecendo uma plataforma centralizada que integra o gerenciamento de ordens de serviço, controle de estoque e geração de orçamentos. O sistema permite que técnicos e clientes acompanhem o progresso das ordens em tempo real, além de automatizar o registro de peças utilizadas e pedidos de compra junto a fornecedores, promovendo maior eficiência operacional.
Além disso, o Fixr implementa um modelo de permissões de acesso que organiza os usuários em diferentes níveis funcionais, garantindo segurança e flexibilidade no uso da plataforma pelos setores de atendimento, laboratório e administração.
Arquitetura
O Fixr adota uma arquitetura moderna, organizada em um monorepo que centraliza frontend, backend e pacotes compartilhados, permitindo reuso de código, consistência entre aplicações e automação de tarefas. O projeto utiliza Bun como runtime e gerenciador de pacotes, oferecendo maior performance e compatibilidade com o ecossistema JavaScript/TypeScript.
A estrutura principal do repositório é:
apps/
├─ web/ → Aplicação principal para clientes e técnicos (Next.js)
├─ admin/ → Painel administrativo interno para gerentes e administradores (Next.js)
└─ server/ → API REST em Fastify, responsável por toda a lógica de negócios e integração com o banco de dados
packages/
├─ db/ → Schemas, migrações e conexão com o banco de dados (Drizzle ORM + MySQL)
├─ schemas/ → Schemas Zod compartilhados entre frontend e backend para validação consistente
├─ constants/ → Constantes e enums do sistema
├─ env/ → Configuração centralizada de variáveis de ambiente com validação via Zod
├─ infra/ → Implementação da infraestrutura de deploy
├─ mail/ → Templates de email em React e configuração da fila de processamento com BullMQ
└─ typescript-config/ → Configurações TypeScript compartilhadas entre os projetos
This is the beginning of the README. Read the rest at the original. Read the full README ↗
