Super OS

Sistema de Ordem de Serviço para pequenas assistências técnicas

---

Contexto do Projeto

Comecei o Super OS depois de ver de perto como pequenas assistências técnicas costumam controlar tudo em planilha ou caderno: cliente, peça usada, valor cobrado, se já entregou ou não. Funciona até certo ponto, mas fica difícil de manter à medida que o volume de OS cresce. A ideia aqui foi construir algo simples e direto para resolver isso — cadastro de clientes, peças e serviços, geração de ordem de serviço e orçamento, com controle de usuários e permissões por cargo. Nada além do necessário para rodar o dia a dia de uma assistência pequena.

Funcionalidades

Usuários e Permissões

• CRUD de usuários
• CRUD de cargos (roles)
• Controle de permissões por cargo
• Autenticação via API Sanctum (com cookies)

Cadastros

• CRUD de clientes
• CRUD de fabricantes
• CRUD de categorias de peças
• CRUD de peças
• CRUD de serviços
• CRUD de termos (condições / observações padrão)

Ordem de Serviço

• Geração de Ordem de Serviço
• Associação de cliente, serviços e peças
• Cálculo automático de valores
• Visualização detalhada da OS
• Impressão da Ordem de Serviço

Orçamento

• Geração de orçamento a partir da OS
• Visualização
• Impressão

Arquitetura

• Back-end: API REST
• Front-end: SPA consumindo a API

Tecnologias

Back-end

• Laravel
• API REST
• Laravel Sanctum
• Spatie Permissions

Front-end

• Vue.js 3 (Composition API)
• Pinia
• Bootstrap

Banco de Dados

• MySQL

Ambiente

• Docker (Laravel Sail)

Requisitos

• Docker
• Docker Compose

Instalação

O projeto é dividido em dois diretórios independentes: backend/ (API Laravel) e frontend/ (SPA Vue).

1. Clone o projeto

git clone https://github.com/CRAFTDEATH/super-os.git
cd super-os

2. Backend (Laravel Sail)

cd backend
cp .env.example .env

./vendor/bin/sail up -d

# opcional (alias)
alias sail='bash vendor/bin/sail'

sail composer install
sail artisan key:generate
sail artisan migrate --seed

A API fica disponível em http://localhost:8060.

3. Frontend (Vue + Vite)

cd frontend
cp .env.example .env
npm install
npm run dev

Acesso ao sistema

Por padrão:

http://localhost:5173

Usuário inicial

Email: admin@hotmail.com Senha: password

Capturas de Tela

Login e Autenticação

Autenticação via API Sanctum com cookies:

• Email e senha
• Recuperação de senha via e-mail
• Sessão persistente com cookie

Usuários e Cargos

Configuração de Permissões para Cargos

A tela de configuração de cargos permite gerenciar permissões por módulo:

• Atribuição de permissões específicas a cada cargo
• Controle de acesso por funcionalidade (CRUD, visualização, impressão, etc.)
• Herança de permissões entre cargos
• Visualização das permissões ativas

Peças - Listagem e Operações

Ordem de Serviço - Fluxo Completo

Serviços

---

Licença

MIT