🚀 TechCare SaaS

Plataforma SaaS para Gestão Completa de Assistências Técnicas

Do primeiro atendimento até o pós-venda.

Controle clientes, equipamentos, ordens de serviço, estoque, financeiro, garantias, relatórios e muito mais.

---

📑 Sumário

• Sobre
• Objetivos
• Funcionalidades
• Tecnologias
• Arquitetura
• Estrutura do Projeto
• Banco de Dados
• Roadmap
• Instalação
• Docker
• Variáveis de Ambiente
• Scripts
• API
• Segurança
• Inteligência Artificial
• Screenshots
• Contribuição
• Licença

---

📌 Sobre

O TechCare SaaS é um sistema desenvolvido para informatizar todo o fluxo de trabalho de uma assistência técnica.

O objetivo é eliminar planilhas, anotações em papel e conversas espalhadas em aplicativos de mensagens, centralizando todas as informações em uma única plataforma moderna.

O sistema foi projetado utilizando a stack MERN e arquitetura escalável, permitindo futuramente oferecer o software como serviço (SaaS).

---

🎯 Objetivos

• Organizar ordens de serviço
• Melhorar atendimento ao cliente
• Automatizar processos
• Reduzir erros
• Gerar indicadores
• Controlar estoque
• Gerenciar financeiro
• Acompanhar garantias
• Criar portal para clientes
• Permitir múltiplas empresas

---

✨ Funcionalidades

👤 Usuários

• Login
• Cadastro
• Recuperação de senha
• Perfis de acesso
• Auditoria

---

👥 Clientes

• Cadastro completo
• CPF/CNPJ
• Telefones
• WhatsApp
• Histórico
• Equipamentos vinculados
• Endereço
• Observações

---

💻 Equipamentos

• Notebook
• Desktop
• Console
• Celular
• Impressora
• Servidor
• Outros

Cada equipamento possui:

• Número de série
• Senha
• Fotos
• Acessórios
• Estado físico
• Checklist
• Histórico

---

🔧 Ordem de Serviço

Fluxo completo:

Recebido

↓

Diagnóstico

↓

Orçamento

↓

Aguardando Aprovação

↓

Em Manutenção

↓

Testes

↓

Finalizado

↓

Entregue

↓

Garantia

Cada OS possui

• fotos
• vídeos
• assinatura
• QR Code
• PDF
• orçamento
• peças
• mão de obra
• observações

---

📦 Estoque

• Cadastro de peças
• Controle de quantidade
• Estoque mínimo
• Fornecedor
• Movimentações
• Código de barras

---

💰 Financeiro

• Fluxo de Caixa

• Receitas

• Despesas

• Parcelamentos

• PIX

• Cartão

• Dinheiro

• Relatórios

---

📊 Dashboard

Indicadores

• OS abertas

• faturamento

• ticket médio

• lucro

• equipamentos

• clientes

• estoque

• gráficos

---

📱 Portal do Cliente

O cliente poderá

✔ acompanhar andamento

✔ baixar orçamento

✔ aprovar serviço

✔ visualizar garantia

✔ baixar laudos

✔ histórico

---

🤖 Inteligência Artificial

O sistema utilizará IA para

Diagnóstico

Notebook liga

Não dá vídeo

↓

IA sugere:

RAM

BIOS

GPU

Fonte

Resumo

Transforma

200 linhas

↓

Resumo para cliente

Busca Inteligente

Exemplos

Notebook Dell azul

Cliente que trocou SSD

Equipamento com tela quebrada

Notebook Acer do João

---

🏗 Arquitetura

React

↓

React Router

↓

TanStack Query

↓

Express API

↓

Controllers

↓

Services

↓

Repositories

↓

MongoDB

---

🛠 Tecnologias

Front-end

• React

• Vite

• TypeScript

• TailwindCSS

• Shadcn UI

• React Hook Form

• Zod

• Axios

• TanStack Query

• Recharts

---

Back-end

• Node.js

• Express

• JWT

• Bcrypt

• Multer

• Socket.IO

• Redis

• BullMQ

• Cloudinary

• Nodemailer

• Helmet

• Morgan

---

Banco

MongoDB Atlas

Mongoose

---

Infra

Docker

Docker Compose

NGINX

GitHub Actions

PM2

---

📂 Estrutura

techcare/

apps/

    api/

    web/

packages/

    ui/

    config/

    types/

docker/

docs/

.github/

README.md

---

📚 Documentação

docs/

01-visao-geral.md

02-requisitos.md

03-casos-de-uso.md

04-modelagem.md

05-api.md

06-wireframes.md

07-arquitetura.md

08-deploy.md

09-roadmap.md

---

🗄 Banco

Coleções

Users

Companies

Clients

Equipments

Orders

Parts

Suppliers

Invoices

Payments

Notifications

Logs

Roles

---

🔐 Segurança

• JWT

• Refresh Token

• Rate Limit

• Helmet

• RBAC

• Logs

• Auditoria

• Hash de senha

---

🚀 Roadmap

MVP

• Login

• Dashboard

• Clientes

• Equipamentos

• OS

---

v1.0

• Financeiro

• Estoque

• Garantias

• Relatórios

---

v2.0

• Portal Cliente

• QR Code

• Assinatura Digital

• Fotos

---

v3.0

• IA

• Analytics

• Multiempresa

• PWA

---

v4.0

• Aplicativo Mobile

• WhatsApp

• Nota Fiscal

• Integração Bancária

---

⚙ Instalação

git clone https://github.com/seuusuario/techcare-saas

cd techcare-saas

pnpm install

---

▶ Executando

Backend

pnpm dev:api

Frontend

pnpm dev:web

---

🐳 Docker

docker compose up -d

---

🌎 Variáveis

PORT=

JWT_SECRET=

JWT_REFRESH_SECRET=

MONGO_URI=

REDIS_URL=

CLOUDINARY_NAME=

CLOUDINARY_KEY=

CLOUDINARY_SECRET=

SMTP_HOST=

SMTP_PORT=

SMTP_USER=

SMTP_PASS=

---

📈 Futuras Integrações

• WhatsApp Business

• Mercado Pago

• Stripe

• Asaas

• OpenAI

• Google Calendar

• Google Drive

• Firebase

---

🧪 Testes

• Unitários

• Integração

• E2E

---

🤝 Contribuindo

Fork

↓

Nova Branch

↓

Commit

↓

Push

↓

Pull Request

---

📜 Licença

MIT License

---

❤️ Desenvolvido com MERN Stack

Projeto desenvolvido para servir como uma solução SaaS moderna para assistências técnicas, priorizando escalabilidade, organização e excelente experiência para técnicos e clientes.