Sinapse

🏥 O que é o Sinapse

Plataforma multitenant (multi-hospital) que centraliza a comunicação e a operação interna. Cada tenant (hospital ou clínica) tem seus próprios dados, marca, usuários e configurações — completamente isolados.

• Domínio único (sinapsenet.com.br) com escopo por /t/<slug>/
• PWA por tenant: cada instituição instala com sua própria logo, nome e cor
• Papéis por tenant: OWNER, ADMIN, MANAGER (coordenador de setor), MEMBER
• Isolamento total no banco (todo modelo carrega tenantId validado por guard)
• Super Admin (backoffice) gerencia tenants, cria hospitais, reseta senhas

🎭 Papéis (Roles) e permissões

Cada colaborador tem UM papel no tenant, que define o que ele vê e pode fazer:

📢 Publicação de comunicados

• Publicar comunicados com título, conteúdo (texto rico) e categoria
• Segmentação granular: pra todo o hospital, ou pra papéis/setores/cargos/usuários específicos
• Fixar no topo (📌 pinned) — comunicados importantes ficam sempre no topo
• Anexos (PDF, imagens, documentos)
• Data de expiração opcional
• Rascunho vs publicado
• Notificação in-app + push pra todos os destinatários
• Marca automaticamente como lido quando o usuário abre

Visão admin

• Estatísticas de leitura: quantos viram, quantos não viram, taxa
• Lista nominal de quem viu (com data/hora) e quem não viu
• Filtros por status de leitura, busca por nome/e-mail/setor
• Botão Fixar/Desafixar direto no detalhe
• Edição posterior (mesmo depois de publicado)

💬 Conversas diretas e grupos

• Conversa 1-a-1 (DIRECT) ou grupo (GROUP)
• Busca de colaboradores por nome, setor ou cargo (sem expor e-mail — LGPD)
• Envio de texto, imagens, áudio (gravação in-app) e arquivos
• Anexos com allowlist estrita de MIME (PDF, DOC, XLS, TXT, ZIP, imagens raster, MP3/M4A/OGG/WAV/WEBM, MP4)
• Real-time via WebSocket (Socket.IO) — mensagens aparecem instantaneamente
• Indicador de "digitando…"
• Contador de não lidas por conversa + total
• Auto-marca como lido ao abrir
• Grupos: nome, descrição, avatar, criador, admin do grupo, adicionar/remover membros
• Silenciar (mute) conversa individualmente
• Sair do grupo (criador não pode sair — precisa deletar)

Interações em mensagens

• Responder: hover no desktop, long-press no mobile
• Copiar: mesmo menu
• Rolar até a mensagem original ao clicar no reply
• Vibração tátil ao abrir menu de ações (mobile)
• Não é possível apagar mensagens (auditabilidade — mantém integridade das denúncias)

Denúncia de chat

• Ícone 🚨 no cabeçalho da conversa
• Anexa automaticamente as últimas 50 mensagens como prova (snapshot JSON)
• Snapshot sobrevive mesmo se a conversa for deletada depois

📋 Kanban corporativo

• Projetos com dono, membros convidados e status (ativo/pausado/concluído/arquivado)
• Cor personalizada por projeto (barra visual no card)
• Datas de início e término opcionais
• Kanban 4 colunas: A fazer → Em andamento → Em revisão → Feito
• Drag & drop entre colunas (desktop) — otimista com rollback em erro
• Também suporta status Cancelado (fora do kanban visual)

Tarefas

• Título, descrição, prioridade (baixa/média/alta/urgente com ícones), prazo
• Múltiplos responsáveis (assignees) por tarefa
• Checklist interno com toggle done
• Thread de comentários (autor + timestamp)
• Contador de comentários e checklist no card
• Avatares dos assignees empilhados no card
• Marcador visual de tarefa atrasada ou hoje

Permissões

• OWNER do projeto edita projeto e gerencia membros
• MEMBER cria/edita tarefas do projeto
• VIEWER só lê
• OWNER/ADMIN do tenant bypassa (auditoria)
• Não-membro NÃO vê projeto (isolamento por convite)

Visão "Minhas tarefas"

• Rota /tarefas — atalho cross-projetos
• Só mostra atribuídas a mim e abertas (TODO/IN_PROGRESS/REVIEW)
• Ordena por prazo (mais próximo primeiro), depois prioridade
• Destaque em vermelho pra atrasadas, amarelo pra "hoje"

Notificações

• PROJECT_INVITE — adicionado a um projeto
• TASK_ASSIGNED — atribuído a uma tarefa
• TASK_COMMENTED — comentário na tarefa que você é responsável
• Badge no ícone do sidebar = tarefas suas com prazo em ≤7 dias ou vencidas

📊 Pesquisas internas

• Criar enquetes com múltiplos tipos de pergunta: texto livre, múltipla escolha, resposta única, nota (rating 1-5), sim/não
• Perguntas obrigatórias vs opcionais
• Máximo de seleções em múltipla escolha
• Modo anônimo (respostas não vinculadas ao usuário)
• Segmentação (hospital todo, papel, setor, cargo, usuários específicos)
• Data de expiração
• Status: RASCUNHO, PUBLICADA, ENCERRADA
• Impede dupla resposta
• Notificação push aos alvos ao publicar

Resultados

• Contagem por opção, percentual, gráfico de barras
• Média das notas (rating)
• Lista de respostas de texto
• Total de respondentes vs audiência prevista
• Se enquete for anônima, respostas não têm autor

📅 Calendário corporativo

• Visualizações mês / semana / dia (FullCalendar tailadmin-style)
• Tipos de evento: reunião, treinamento, escala, plantão, evento externo
• Modo presencial, remoto ou híbrido — com link de reunião (Zoom/Meet)
• Recorrência: única, mensal, anual
• Vinculação com espaço físico (reserva a sala automaticamente)
• Segmentação: hospital todo, papel, setor, cargo ou lista de usuários
• Convite: notificação in-app + push
• Data limite de check-in (janela pós-evento)
• Link público opcional (QR code pra convidados externos — sem meetingLink por segurança)

Check-in / presença

• QR code por evento (impresso na porta ou compartilhado)
• Check-in via app ou escaneando QR
• Marcação manual pelo organizador
• Registro de IP, geolocalização, dispositivo no check-in
• Lista de presença completa após o evento

📝 Atas com assinatura eletrônica

• Editor rich-text (HTML sanitizado) pra escrever a ata durante ou após o evento
• Versionamento: v1 = original, v2+ = adendo/revisão
• Finalização gera PDF timbrado (com logo e branding do tenant)
• PDF inclui lista de presença e slots pra assinatura

Assinatura eletrônica com metadata

• Só quem tinha presença confirmada no evento pode assinar
• Cada assinatura registra: usuário, timestamp, IP, user-agent, geolocalização (opt-in), timezone, screen size, dispositivo
• Solicitação de assinatura envia notificação push aos pendentes
• Metadata técnica (IP/GPS/UA) só visível ao admin e ao próprio signatário (LGPD)

Controle de acesso à ata

• Vê o PDF: admin, autor do evento, quem finalizou, signatários e usuários com access grant
• Admin pode conceder acesso a outros usuários (MinutesAccessGrant)
• MEMBER comum não vê ata que não é dele

🏛️ Reserva de salas e auditórios

• Cadastro de espaços: nome, tipo (sala, auditório, laboratório), capacidade, localização, equipamentos
• Ativar/desativar espaço
• Reserva por período (data + hora início/fim)
• Verificação automática de conflito (não permite reservar horário ocupado)
• Vinculação opcional com evento da agenda (reserva o espaço ao criar o evento)
• Visão calendário: ver quais reservas o espaço tem
• Cancelar reserva

✅ Tickets internos

• Abertura de solicitação com título, descrição, prioridade (baixa/normal/alta/urgente), categoria
• Direcionamento a um setor (assignee automático via setor responsável) ou responsável específico
• Adição de participantes (colaboradores acompanham a thread)
• Anexos com allowlist MIME
• Thread de replies com marcação de "resposta interna" (só admin/atribuído vê)
• Status: aberto, em andamento, aguardando usuário, resolvido, fechado, rejeitado
• Atribuição/reatribuição a outro responsável
• Auditoria completa: IP, user-agent, geolocalização gravados em cada resposta e no ticket
• Contador de não-lidas + notificação push
• Visibilidade: admin vê tudo; MANAGER vê do próprio setor + próprias; MEMBER só as próprias

👔 Requisições de RH

• Hub RH com cards de estatísticas (pendentes de aprovação, minhas solicitações abertas)
• Tipos disponíveis: Hora Extra (implementado) + Férias, Troca de Plantão, Atestado, Declaração, Alteração cadastral (em breve)
• Cada requisição: tipo, justificativa, payload específico do tipo (ex: data + hora início + hora fim pra Hora Extra)
• Cálculo automático de duração em minutos (respeita virada de meia-noite)

Fluxo de aprovação

• PENDING → IN_DISCUSSION (após primeiro reply) → APPROVED / REJECTED / CANCELED
• Thread de discussão entre solicitante e aprovadores
• Aprovador NÃO pode aprovar a própria requisição
• Solicitante pode cancelar antes de ser aprovada
• Notificação push aos aprovadores no OPEN e ao solicitante no APPROVE/REJECT
• Push omite conteúdo sensível — só mostra "Nova solicitação de RH" (LGPD art. 11 — motivos médicos)

Quem aprova

• OWNER/ADMIN sempre aprovam
• MANAGER aprova requisições do próprio setor
• Aprovadores extras configuráveis via Configurações RH (colaboradores específicos que aprovam tudo, sem virar admin)

Relatórios

• Filtros por período, tipo, status, setor, requerente
• Total de horas extras aprovadas (soma agregada)
• Ranking por colaborador (top horas extras)
• Contadores por status e tipo

🚨 Canal seguro de denúncias

• Tipos: Reclamação, Conduta inadequada (assédio/ofensa), Outro
• Sequencial por tenant (#0042)
• Status: aberta → em análise → resolvida / descartada
• Anexação opcional da conversa de chat como prova (snapshot das últimas 50 mensagens)
• Snapshot em JSON — sobrevive mesmo se conversa for deletada depois
• Notificação aos OWNER/ADMIN ao abrir
• Auditoria: IP, UA, geolocalização do denunciante gravados

Anonimato controlado

Thread e resolução

• Só OWNER/ADMIN pode responder na thread (evita virar novo vetor de assédio)
• Notas internas (só admins veem) vs respostas oficiais (denunciante recebe)
• Denunciante recebe notificação a cada resposta admin e mudança de status
• Denunciado NÃO tem acesso à denúncia

📄 Central de arquivos do tenant

• Lista unificada de arquivos por tipo: atas, anexos de comunicados/tickets/RH, avatares, logos
• Filtros por tipo (kind), busca
• Storage stats: uso atual vs quota do plano
• Download com controle de acesso (admin baixa qualquer, MEMBER só o que tem permissão)
• Atas visíveis: admin, autor, signatários, granted
• Grants concedidos por admin

🗂️ Hierarquia visual

• Árvore de setores (com parent/child)
• Árvore de pessoas por gestor (manager relation)
• Cards mostram: nome, foto, setor, cargo (e-mail só pra admin)
• Navegação drill-down clicando em setor ou pessoa
• Contadores de membros e sub-setores

👥 Colaboradores

• Cadastro completo: dados pessoais (CPF, RG, nascimento, endereço, contato de emergência), dados profissionais (matrícula, cargo, setor, registro profissional/CRM/COREN, especialidade, CBO)
• Tipo de vínculo: CLT, PJ, Autônomo, Estagiário, Terceirizado
• Gestor direto (manager relation)
• Data de admissão e desligamento
• Foto de perfil
• Ativar/desativar sem apagar
• Reset de senha por admin (ADMIN não reseta OWNER/outros ADMIN; usuário é notificado do reset)
• Busca por nome (admin também busca por e-mail)
• Filtro por setor
• Aniversariantes do mês

🏢 Setores

• CRUD de setores
• Hierarquia (setor pai/filhos)
• Código interno opcional
• Responsável default por setor (usado pra atribuir tickets automaticamente)
• Ativar/desativar

🎓 Cargos

• CRUD de cargos
• Usados na segmentação (comunicados, enquetes, eventos) e nos filtros

📜 Aceite de termos bloqueante

• Modal fullscreen aparece no primeiro acesso — bloqueia app até aceitar
• Precisa rolar até o fim + marcar checkbox pra habilitar botão "Aceitar"
• Grava aceite com IP, user-agent, latitude/longitude (opt-in)
• Múltiplos termos possíveis — se houver N pendentes, aceita 1 por 1
• Termo modelo criado: "Termo Geral de Uso, Privacidade e Conduta" — 9 seções cobrindo objeto, LGPD, auditoria, comunicações, conduta, denúncias, responsabilidades, versionamento, contato DPO

Versionamento

• Publicar nova versão do mesmo slug desativa a anterior automaticamente
• Obriga todos a reaceitar
• Termo com aceites vira imutável (só ativar/desativar)
• Excluir só permitido se zero aceites (senão desativa pra preservar auditoria)

Backoffice de termos

• Página /configuracoes/termos pra OWNER/ADMIN
• Cria, edita, ativa/desativa, exclui termos
• Ver lista de aceites (nome, data, IP, geolocalização, UA)

🔔 Central de notificações

• Sino no header com contador de não lidas
• Página /notificacoes com lista completa
• Marcar como lida (individual ou tudo)
• Filtro apenas não lidas
• Ícone + título + preview + link direto pra ação
• Poll a cada 30s pra atualizar contador

Push notifications (Web Push VAPID)

• Assinatura via /perfil → Notificações push
• Prompt automático no PWA instalado (uma vez, dispensível)
• Título prefixado com emoji do tipo (📢, 💬, 🚨, ⏰)
• Ícone do próprio tenant no push
• Badge numérico no ícone do PWA (soma total de não lidas)
• Tag por contexto: mensagens da mesma conversa se consolidam ("3 novas · Última: ...")
• Renotify: vibra/toca de novo ao atualizar
• Clique abre janela existente ou nova, navega pra URL certa
• Preview omitido em push sensível (RH, denúncia) — LGPD
• Compatível: Chrome/Edge desktop, Android Chrome, iOS 16.4+ (PWA instalado)

Módulos que disparam push

• Chat (msg nova, respeita mute)
• Mural (comunicado publicado)
• Solicitações (nova, resposta, atribuição, mudança de status)
• RH (criada, resposta, aprovação/rejeição)
• Denúncias (criada → admin, resposta → denunciante, status)
• Eventos (convite)
• Atas (solicitação de assinatura)
• Segurança (senha resetada por admin)

📲 Progressive Web App

• Instalável em iPhone, Android, desktop (Chrome/Edge)
• Manifest dinâmico por tenant: cada hospital vira um "app" separado no celular
• Nome, ícone (CEMAC/logo do hospital), cor de tema — tudo do próprio tenant
• Card "Instalar o Sinapse" aparece automaticamente quando browser oferece instalação
• Instruções específicas pra iPhone (Compartilhar → Adicionar à Tela de Início)
• Modo standalone (fullscreen sem barra do browser)
• Shortcuts: Chat, Mural, Agenda direto do menu do ícone

Service Worker

• Cache-first pra estáticos (assets Next), network-first pra HTML
• Fallback offline navigation
• Push handler + notificação com badge numérico
• Update automático: banner verde "🚀 Nova versão disponível" com botão Atualizar
• Check periódico de update a cada 30 min

⚙️ Branding e dados institucionais

• Nome fantasia, razão social, CNPJ (imutável)
• E-mail institucional, telefone, WhatsApp público
• Endereço completo com CEP
• Logo horizontal (topbar, PDFs) — PNG/JPG/WebP (SVG bloqueado por segurança)
• Ícone quadrado (PWA, favicon) — PNG 512×512
• Cor primária (usada no timbrado, tema PWA, destaques)
• Slogan/tagline (aparece no PDF)
• Redes sociais: site, Instagram, Facebook, LinkedIn (rodapé do timbrado)
• Preview em tempo real das imagens

Sub-páginas

• 📜 Termos de Uso — CRUD + versionamento + aceites
• ⚙️ RH: aprovadores extras

🧑 Auto-serviço do colaborador

• Editar dados pessoais: nome, foto, contatos, endereço residencial, contato de emergência, dados demográficos
• Ver dados profissionais (matrícula, cargo, setor — em modo leitura)
• Trocar senha (mínimo 8 chars) — invalida todas as sessões existentes
• Ativar/desativar notificações push (toggle)
• Ver estado da subscription push (ativada/bloqueada/não suportada)
• Instruções específicas pra iOS quando não instalado
• Foto de perfil aparece em mensagens, comentários e listas

🛠️ Gestão cross-tenant (Sinapse)

• Login em /admin com o ADMIN_TOKEN do servidor (comparação timing-safe)
• Listar todos os tenants
• Criar novo tenant (hospital) com dados institucionais completos
• Editar tenant, mudar plano, suspender, cancelar
• Setar quota de storage por tenant
• Configurar contatos comerciais
• Criar setores, cargos e membros dentro de qualquer tenant (usado no onboarding)
• Logout limpa cookie
• Rate limit 5/min no login

🔐 Autenticação

• JWT em cookies httpOnly (access 15min, refresh 30 dias)
• Refresh cookie escopado em /api/auth com sameSite=strict
• Revogação de sessão: tokenVersion no User — logout/changePassword incrementam, invalida TODOS os JWT do usuário
• Bcrypt cost 12 pra hashagem
• Rate limit: login 5/min, refresh 20/min, change-password 5/min, global 100/min
• Comparação timing-safe em tokens admin

🛡️ Autorização multitenant

• TenantGuard valida membership ativa no tenant do path
• Bloqueia tenants SUSPENDED/CANCELED (superadmin bypassa)
• Bloqueia trial expirado
• Todo endpoint /t/:slug/* passa por JwtAuthGuard + TenantGuard
• Filtros de visibilidade por role e segmentação (allTenant/roles/setores/cargos/targeted)
• Ata: só admin/autor/signatário/granted vê o PDF
• Enquete/evento privado: MEMBER não vê se não é target

🧯 Camadas de defesa

• CORS allowlist explícita (WS + HTTP)
• Middleware CSRF (Origin/Referer check em métodos state-changing)
• Content Security Policy restrita via Next (sem unsafe-eval, connect-src self+wss)
• HSTS + X-Frame-Options + Referrer-Policy + Permissions-Policy
• Helmet no backend
• API bindada em 127.0.0.1 (Caddy proxya de fora)
• Firewall UFW só 22/80/443
• PostgreSQL, Redis, MinIO todos em localhost
• Push subscription valida host de FCM/Mozilla/Apple, rejeita hijack cross-user
• Upload: MIME allowlist, extensão sanitizada, path traversal bloqueado, X-Content-Type-Options: nosniff, Content-Disposition: attachment pra tudo exceto imagem raster
• Quota TOCTOU protegida com pg_advisory_xact_lock por tenant
• SVG bloqueado em uploads (aceita <script>)

📋 LGPD e auditoria

• PII (CPF, RG, endereço, contato de emergência) só pra OWNER/ADMIN
• E-mail dos colegas oculto pra MEMBER (org-chart, listas)
• Assinaturas de ata: IP/GPS/UA visíveis só pra admin e ao próprio signatário
• Push notifications sensíveis (RH, denúncias) sem preview do body
• Termo LGPD obrigatório com aceite auditável (IP+UA+geo)
• Chat mensagens não podem ser deletadas (integridade)
• Denúncias sempre gravam requesterId (auditoria) mesmo em anônimas
• Retenção de logs (Marco Civil ≥6 meses) documentada nos Termos

🚧 Próximas funcionalidades

• RH — Férias
• RH — Troca de plantão
• RH — Atestado médico (upload)
• RH — Declaração de vínculo/salarial
• RH — Alteração cadastral
• Módulo Treinamentos (LMS interno)
• Módulo Holerite (contra-cheques digitais)
• Ambiente de teste separado (staging.sinapsenet.com.br)
• 2FA por usuário
• SSO (SAML/OIDC) pra planos Enterprise
• API pública documentada (Swagger) pra integrações