Article image
Marcio Gil
Marcio Gil12/11/2025 16:48
Compartilhe

HelpDeskFlow - Sistema de Gerenciamento de chamados Interno



    Sistema Profissional de Gerenciamento de Chamados Internos


    image image image image

    image

    Sobre o Projeto

    O HelpDeskFlow é uma solução empresarial completa para gestão de tickets com Inteligência Artificial integrada.

    Principais Diferenciais

    • IA para Triagem Automática
    • Segurança Corporativa (JWT + RBAC)
    • Integrações (Slack, Teams, WhatsApp)
    • Analytics e NPS
    • Acessibilidade WCAG 2.1 AA

    Stack Tecnológico

    Backend: Node.js 20+ | Express 4.18 | TypeScript 5.5 | Prisma 5.7 | PostgreSQL 15+

    Frontend: React 18.3 | TypeScript 5.5 | Vite 5.0 | Tailwind CSS 3.4

    Segurança: JWT | bcrypt | Rate Limiting | Zod | Helmet

    Funcionalidades

    Inteligência Artificial

    • Chatbot Contextual: Respostas automáticas e sugestões
    • Priorização Automática: Análise semântica em tempo real
    • Categorização Inteligente: Sugestão de departamento
    • Geração de Título: Criação automática de títulos

    Segurança

    • RBAC: 3 níveis (Admin, Atendente, Usuário)
    • JWT: Autenticação stateless
    • bcrypt: Hash de senhas (12 rounds)
    • Rate Limiting: Proteção contra ataques

    Integrações

    • Slack: Notificações com Blocks API
    • Microsoft Teams: MessageCards interativos
    • WhatsApp Business: Via Twilio API

    Dashboard

    • Analytics em tempo real
    • Cálculo automático de NPS
    • Relatórios PDF

    Deploy

    ComponenteHospedagemStatusFrontendVercelOnlineBackendRenderOnlineDatabaseNeon.techOnline

    App: https://help-desk-flow-frontend.vercel.app

    Credenciais de Teste

    EmailSenhaPerfiladmin@helpdeskflow.comAdmin@123Administradorjoao.silva@helpdeskflow.comAtendente@123Atendentecarlos.oliveira@helpdeskflow.comUsuario@123Usuário

    Estrutura

    HelpDeskFlow/
     backend/          # Node.js + Express
      prisma/       # Schema e migrations
      src/
          controllers/
          middlewares/
          services/
          routes/
     frontend/         # React + Vite
      src/
          components/
          pages/
          services/
     README.md
    

    API Endpoints

    Autenticação

    POST /api/auth/login
    GET  /api/auth/me
    

    Tickets

    GET    /api/tickets
    POST   /api/tickets
    PUT    /api/tickets/:id
    DELETE /api/tickets/:id
    

    IA

    POST /api/chatbot/analyze
    POST /api/chatbot/message
    

    NPS

    GET  /api/feedback/nps
    POST /api/feedback
    

    Integrações

    POST /api/integrations/slack
    POST /api/integrations/teams
    POST /api/integrations/whatsapp
    

    Instalação

    Backend

    cd backend
    npm install
    npx prisma migrate dev
    npm run dev
    

    Frontend

    cd frontend
    npm install
    npm run dev
    

    Desenvolvedor

    Márcio Gil

    Estudante de Engenharia de Software (5º Período)

    image image

    Repositório: https://github.com/MarcioGil/Sistema-de-Chamados-Internos

    Licença

    MIT License

    Desenvolvido com por Márcio Gil

    Se este projeto foi útil, considere dar uma estrela!

    Compartilhe
    Comentários (2)
    Marcio Gil
    Marcio Gil - 13/11/2025 13:22

    Muito obrigado pelo reconhecimento!

    De fato, manter a separação de responsabilidades no padrão MVC é um dos maiores desafios, principalmente quando o projeto evolui e novas demandas surgem. A tentação de “resolver rápido” pode levar ao acoplamento, mas é aí que entra o verdadeiro papel do engenheiro de software: proteger a arquitetura e garantir que cada camada cumpra seu propósito.

    No kFlow, busquei preservar essa clareza com serviços desacoplados, middlewares bem definidos e validações independentes, sempre pensando na escalabilidade e manutenção a longo prazo. É um exercício contínuo de disciplina técnica e mentalidade de engenharia, mais do que fazer funcionar, é fazer certo.

    DIO Community
    DIO Community - 13/11/2025 08:48

    Excelente, Marcio! Que projeto épico, detalhado e de altíssimo valor de negócio! Você tocou no ponto crucial da Engenharia de Software moderna: a necessidade de um Sistema de Gerenciamento de Chamados Internos que seja seguro, integrado e inteligente.

    O seu projeto HelpDeskFlow não é apenas um sistema de tickets; é uma plataforma completa de governança construída sobre uma stack Fullstack Cloud-Native (Node.js/Express, TypeScript, Prisma, React, Tailwind).

    Qual você diria que é o maior desafio para um desenvolvedor ao trabalhar com um projeto que usa o padrão MVC, em termos de manter a separação de responsabilidades e de evitar o acoplamento entre as três camadas, em vez de apenas focar em fazer a aplicação funcionar?