🔍 Siberius API

Sistema de Indexação de PDFs e Gestão de Ordens de Serviço

Base URL: http://sysfutura.prismasolutions.info

📋 Funcionalidades

� Autenticação Híbrida

Login completo (email/senha) ou PIN rápido para tela touch

🗂️ Indexação Automática

Varredura recursiva de PDFs com parse inteligente de nomes

🔄 Versionamento

Controle completo de versões de OS com histórico

👥 Gestão de Equipes

Alocação de múltiplos técnicos com verificação de conflitos

📊 API REST Completa

CRUD completo para todas as entidades

🔐 Autenticação

POST /auth/login Login completo (email + senha) ▼

Para: Web e Mobile

Body: { email, senha }

JWT Token Validade 12h
curl -X POST http://sysfutura.prismasolutions.info/auth/login \ -H "Content-Type: application/json" \ -d '{"email":"admin@teste.com","senha":"123456"}'

Resposta:

{"token":"eyJhbGc...","usuario":{"id":1,"nome":"Admin","email":"admin@teste.com"},"expiresIn":"12h"}
POST /auth/login/pin Login rápido com PIN ▼

Para: Tela Touch em sala de reuniões

Body: { usuarioId, pin }

PIN 4-6 dígitos Uso Interno
curl -X POST http://sysfutura.prismasolutions.info/auth/login/pin \ -H "Content-Type: application/json" \ -d '{"usuarioId":1,"pin":"1234"}'

Fluxo:

  1. Usuário seleciona seu nome na lista
  2. Digita PIN de 4 dígitos
  3. Recebe token válido por 12h
GET /auth/usuarios Lista usuários para seleção ▼

Retorna apenas id e nome dos usuários ativos (sem dados sensíveis).

Uso: Popular dropdown/lista na tela de login com PIN

curl http://sysfutura.prismasolutions.info/auth/usuarios
GET /auth/verify Verifica se token é válido ▼

Header: Authorization: Bearer {token}

curl http://sysfutura.prismasolutions.info/auth/verify \ -H "Authorization: Bearer eyJhbGc..."
POST /auth/refresh Renova token expirado ▼

Header: Authorization: Bearer {token_expirado}

curl -X POST http://sysfutura.prismasolutions.info/auth/refresh \ -H "Authorization: Bearer eyJhbGc..."

🗂️ Ordens de Serviço

GET /api/ordens-servico Lista todas as ordens de serviço ▼

Retorna todas as OSs indexadas com possibilidade de filtros.

curl http://sysfutura.prismasolutions.info/api/ordens-servico
GET /api/ordens-servico/:id Busca OS por ID ▼

Retorna detalhes completos de uma ordem de serviço específica.

curl http://sysfutura.prismasolutions.info/api/ordens-servico/1
GET /api/ordens-servico/numero/:numero Busca OS por número ▼

Busca ordem de serviço pelo número da OS. Retorna todas as versões.

curl http://sysfutura.prismasolutions.info/api/ordens-servico/numero/12345
POST /api/ordens-servico Cria nova ordem de serviço ▼

Body: { numeroOS, nomeCliente, nomeEvento, data, osAtualizada }

curl -X POST http://sysfutura.prismasolutions.info/api/ordens-servico \ -H "Content-Type: application/json" \ -d '{"numeroOS":"12345","nomeCliente":"João Silva","nomeEvento":"Manutenção","data":"2025-12-28"}'
PUT /api/ordens-servico/:id Atualiza ordem de serviço ▼

Body (parcial): Envie apenas os campos que deseja atualizar

curl -X PUT http://sysfutura.prismasolutions.info/api/ordens-servico/1 \ -H "Content-Type: application/json" \ -d '{"nomeCliente":"João Silva Updated","status":"concluido"}'
DELETE /api/ordens-servico/:id Remove ordem de serviço ▼
curl -X DELETE http://sysfutura.prismasolutions.info/api/ordens-servico/1

🔧 Técnicos

GET /api/tecnicos Lista todos os técnicos ▼
curl http://sysfutura.prismasolutions.info/api/tecnicos
POST /api/tecnicos Cria novo técnico ▼

Body: { nome, email, telefone?, especialidade? }

curl -X POST http://sysfutura.prismasolutions.info/api/tecnicos \ -H "Content-Type: application/json" \ -d '{"nome":"João Silva","email":"joao@email.com","especialidade":"Manutenção"}'
PUT /api/tecnicos/:id Atualiza técnico ▼

Body (parcial): Envie apenas os campos que deseja atualizar

curl -X PUT http://sysfutura.prismasolutions.info/api/tecnicos/1 \ -H "Content-Type: application/json" \ -d '{"telefone":"(11) 98888-8888","ativo":false}'
DELETE /api/tecnicos/:id Remove técnico ▼
curl -X DELETE http://sysfutura.prismasolutions.info/api/tecnicos/1

👥 Atendimentos / Gestão de Equipes

POST /api/atendimentos Vincula técnico a uma OS ▼

Validações:

  • ✅ Verifica conflitos de agenda (aviso, não bloqueia)
  • ✅ Previne duplicação (mesmo técnico, mesma OS)
  • ✅ Valida técnico ativo
curl -X POST http://sysfutura.prismasolutions.info/api/atendimentos \ -H "Content-Type: application/json" \ -d '{"ordemServicoId":1,"tecnicoId":1,"status":"pendente"}'
POST /api/atendimentos/equipe Escala equipe completa para uma OS ▼

Vincula múltiplos técnicos de uma vez com validação individual.

Múltiplos Técnicos Verificação de Conflitos Relatório Detalhado
curl -X POST http://sysfutura.prismasolutions.info/api/atendimentos/equipe \ -H "Content-Type: application/json" \ -d '{"ordemServicoId":1,"tecnicoIds":[1,2,3,4],"status":"pendente"}'
GET /api/atendimentos/tecnico/:id/agenda/:data Verifica agenda do técnico ▼

Consulta todos os atendimentos de um técnico em uma data específica.

Formato da data: YYYY-MM-DD

curl http://sysfutura.prismasolutions.info/api/atendimentos/tecnico/1/agenda/2025-12-28
GET /api/atendimentos/ordem-servico/:id Lista equipe alocada em uma OS ▼

Retorna todos os técnicos vinculados a uma ordem de serviço.

curl http://sysfutura.prismasolutions.info/api/atendimentos/ordem-servico/1
PUT /api/atendimentos/:id Atualiza atendimento ▼

Body (parcial): { status?, observacoes?, tecnicoId?, ordemServicoId? }

Útil para mudar status (pendente → em_andamento → concluido) ou reatribuir técnico.

curl -X PUT http://sysfutura.prismasolutions.info/api/atendimentos/1 \ -H "Content-Type: application/json" \ -d '{"status":"concluido","observacoes":"Trabalho finalizado"}'
DELETE /api/atendimentos/:id Remove atendimento ▼

Remove a alocação de um técnico de uma OS.

curl -X DELETE http://sysfutura.prismasolutions.info/api/atendimentos/1

👤 Usuários

GET /api/usuarios Lista todos os usuários ▼
POST /api/usuarios Cria novo usuário ▼

Body: { nome, email, senha }

curl -X POST http://sysfutura.prismasolutions.info/api/usuarios \ -H "Content-Type: application/json" \ -d '{"nome":"Admin","email":"admin@email.com","senha":"senha123"}'
PUT /api/usuarios/:id Atualiza usuário ▼

Body (parcial): { nome?, email?, senha?, ativo? }

curl -X PUT http://sysfutura.prismasolutions.info/api/usuarios/1 \ -H "Content-Type: application/json" \ -d '{"nome":"Admin Updated","ativo":false}'
DELETE /api/usuarios/:id Remove usuário ▼
curl -X DELETE http://sysfutura.prismasolutions.info/api/usuarios/1

🏥 Health Check

GET /health Verifica status da API ▼
curl http://sysfutura.prismasolutions.info/health

ℹ️ Informações Adicionais

Versionamento de OS

O sistema mantém histórico completo de versões de ordens de serviço:

Gestão de Equipes

Recursos para trabalho em equipe: