Proteção Jurídica com SHA-256

Plataforma de Suporte para Redes de Franquias

Sistema completo de gestão de comunicação entre franqueador e franqueados com rastreabilidade jurídica, registro de atendimentos da IA, onboarding de novas unidades e exportação de relatórios com hashes de integridade.

11
Tabelas no Schema
42+
Endpoints de API
11
Páginas Frontend
29+
Testes Unitários
7 Módulos Integrados

Funcionalidades Principais

Cada módulo foi projetado para garantir rastreabilidade completa e facilidade de uso para franqueadores e franqueados.

Sistema de Tickets

Abertura, rastreamento, atribuição e resolução de demandas com categorização por prioridade e tipo.

Conversas Registradas

Thread de mensagens por ticket com hash SHA-256 por interação, garantindo integridade jurídica.

Logs de IA 24/7

Endpoint público para registro automático de conversas da IA de atendimento. Integração via API REST.

Notificações

Alertas em tempo real para eventos críticos: novos tickets, respostas, resoluções e urgências.

Onboarding

Checklist de tarefas para novos franqueados com 7 categorias, progresso por unidade e importação de planilha.

Exportação PDF

Relatórios com validade jurídica contendo hashes de integridade, histórico completo e aviso legal.

Anexos em S3

Upload de documentos, imagens e arquivos vinculados aos tickets. Armazenamento seguro em nuvem.

Arquitetura Técnica

Stack Moderna e Robusta

Construído com as tecnologias mais recentes para garantir performance, segurança e manutenibilidade.

Frontend
React 19
Styling
Tailwind CSS 4
API
tRPC 11
Server
Express 4
Database
Drizzle ORM
Storage
MySQL / TiDB
Files
AWS S3
Testing
Vitest

Schema do Banco de Dados — 11 Tabelas

TabelaPropósito
usersAutenticação e controle de acesso
franchise_unitsUnidades franqueadas
ticketsDemandas de suporte
ticket_messagesThread de conversas
ticket_attachmentsArquivos anexados
ticket_status_historyTrilha de auditoria
ai_conversation_logsLogs de atendimento IA
notification_logsNotificações internas
onboarding_task_templatesTemplates de onboarding
onboarding_assignmentsTarefas por unidade
ticket_categoriesCategorias de tickets

API — 42+ Endpoints tRPC + REST

Tickets8 endpoints

create, myTickets, all, getById, addMessage, updateStatus, assign, rate

AI Logs5 endpoints

create, externalLog, myLogs, allLogs, sessionDetail

Notificações4 endpoints

list, unreadCount, markRead, markAllRead

Dashboard5 endpoints

metrics, recentTickets, allUnits, allAdmins, allUsers

Onboarding11 endpoints

templates, seed, createTemplate, initForUnit, myTasks, allProgress...

Unidades6 endpoints

mine, register, update, list, getById, toggleActive

Categorias3 endpoints

list, create, update

Controle de Acesso

Dois Perfis, Uma Plataforma

Franqueador

role: admin
  • Dashboard com métricas globais de atendimento
  • Visualizar e gerenciar todos os tickets
  • Atribuir tickets a responsáveis
  • Responder demandas dos franqueados
  • Gerenciar unidades franqueadas
  • Criar e editar categorias de tickets
  • Gerenciar templates de onboarding
  • Iniciar onboarding por unidade
  • Visualizar logs de IA de todas as unidades
  • Exportar relatórios PDF para evidência jurídica

Franqueado

role: user
  • Painel com métricas da sua unidade
  • Abrir tickets com categorização e prioridade
  • Acompanhar status e histórico de tickets
  • Enviar mensagens e anexar documentos
  • Visualizar histórico de atendimentos da IA
  • Receber notificações de respostas e resoluções
  • Completar checklist de onboarding
  • Registrar e editar dados da unidade
  • Avaliar tickets resolvidos (satisfação 1-5)
  • Exportar relatórios dos seus tickets
Processo de Construção

Workflow em 7 Etapas

Processo estruturado e reutilizável para construir sistemas de suporte para qualquer rede de franquias.

1

Inicializar Projeto

Setup com banco de dados, servidor e autenticação

2

Definir Schema

11 tabelas com hashes de integridade SHA-256

3

Construir API

42+ endpoints tRPC + REST para upload e export

4

Desenvolver Frontend

11 páginas com layout responsivo por perfil

5

Sistema de Onboarding

Importar planilha de tarefas e atribuir por unidade

6

Proteção Jurídica

PDF com hashes, aviso legal e trilha de auditoria

7

Testes Automatizados

29+ testes unitários cobrindo RBAC e integridade

Proteção Jurídica

Integridade Criptográfica dos Dados

Cada interação no sistema é protegida por hash SHA-256, criando uma trilha de auditoria imutável com validade como evidência técnica.

Sistema de Hashes SHA-256

Entidades Protegidas
TicketsMensagensMudanças de StatusLogs de IA
Formato do Hash
campo1|campo2|...|timestamp.toISOString()
Exemplo de Hash
a7ffc6f8bf1ed76651c14756a061d662f580ff4de43b49fa82d80a4b80f8434a

Exportação PDF Jurídica

O relatório PDF inclui todas as informações necessárias para uso como evidência em processos jurídicos:

  • Aviso legal sobre integridade dos dados
  • Informações completas do ticket
  • Histórico de todas as mensagens com hashes
  • Trilha de mudanças de status com timestamps
  • Lista de anexos com metadados
  • Seção de verificação de integridade
  • Data/hora de geração do documento

Aviso Legal: Este documento contém registros imutáveis de comunicação com hashes de integridade SHA-256. Cada interação possui carimbo de data/hora e hash criptográfico que garante a autenticidade dos dados.

Onboarding de Franqueados

Boas-Vindas Estruturadas

Checklist completo para novos franqueados com 7 categorias de tarefas, importação de planilha e acompanhamento de progresso por unidade.

Contratual

Assinatura, taxa, CNPJ

Boas-Vindas

Email, confirmação

Imóvel

Ponto, documentação, contrato

Implantação

Projeto, equipamentos, AC

Financeiro

Proger, orçamentos

Marketing

Concorrentes, cardápio, mídia

Infraestrutura

Água, energia, gás, prefeitura

Como Funciona

1

Admin importa templates de tarefas a partir da planilha Excel da rede

2

Admin inicia o onboarding para cada nova unidade franqueada

3

Franqueado visualiza sua checklist com barra de progresso

4

Franqueado marca tarefas como concluídas e adiciona observações

5

Admin acompanha o progresso de todas as unidades em tempo real

Personalização

Adaptável para Qualquer Rede

Pontos de customização documentados para adaptar o sistema às necessidades específicas de cada rede de franquias.

Tarefas de Onboarding

Importe a planilha de tarefas da rede, mapeie categorias e responsáveis automaticamente.

Categorias de Tickets

Ajuste o enum de categorias no schema e crie novas classificações de demandas.

Responsáveis

Atualize os valores de responsáveis no seed data conforme a estrutura organizacional.

Aviso Legal

Modifique o texto jurídico do PDF conforme a jurisdição e requisitos legais da rede.

Branding

Altere cores primárias, logo e nome do sistema no CSS e configurações do projeto.

Tipos de Notificação

Estenda o enum de notificações para incluir novos tipos de eventos específicos da rede.

Perguntas Frequentes

FAQ

Pronto para Proteger sua Rede?

Acesse o sistema agora e comece a registrar as comunicações da sua rede de franquias com rastreabilidade jurídica completa.