Sistema web de gerenciamento de chamados internos de TI: funcionários registram problemas, a equipe de tecnologia atribui responsáveis, acompanha o atendimento e documenta as soluções.
Status: em desenvolvimento (Etapa 1: modelagem do banco de dados). As funcionalidades listadas abaixo são o escopo planejado e estão marcadas conforme o progresso real na seção Roadmap.
O DeskFlow é um projeto de estudo com escopo deliberadamente controlado. Ele simula o dia a dia de um setor de suporte de TI e foi pensado para praticar, de ponta a ponta, o que se espera de um desenvolvedor de sistemas em um ambiente corporativo:
- modelagem e consultas em um banco relacional (SQL Server / T-SQL), escritas à mão, sem ORM;
- uma API REST em camadas (Node.js + Express + TypeScript);
- uma interface em React + TypeScript;
- regras de negócio, histórico de alterações e transações;
- debugging, testes, Git/GitHub (branches e Pull Requests) e documentação técnica.
Para dominar o SQL e entender o que acontece entre a aplicação e o banco: planos de consulta, índices, constraints, transações e stored procedures. Um ORM pode ser avaliado depois, com esse conhecimento como base.
Dashboard
- Total de chamados e quantidade por status (abertos, em andamento, concluídos).
- Chamados por prioridade e indicadores básicos de desempenho.
Gerenciamento de chamados
- Criar, listar, consultar, editar e cancelar chamados.
- Pesquisa e filtros.
Detalhes do chamado
- Título, descrição, prioridade, status, solicitante e responsável.
- Datas de abertura e de conclusão.
- Comentários e histórico de alterações.
- Todo chamado novo começa com o status Aberto.
- Um chamado pode passar para Em andamento.
- Para concluir um chamado, é obrigatório registrar uma solução.
- Um chamado concluído não pode ser cancelado.
- Toda alteração de status é registrada no histórico.
- As prioridades são Baixa, Média, Alta e Crítica.
- Um chamado pode ter um responsável atribuído.
Navegador
│ HTTP / JSON
▼
Frontend ── React + TypeScript + Vite + React Router
│ consumo da API REST
▼
Backend ── Node.js + Express + TypeScript
│ Rotas → Controllers → Services → Acesso a dados (SQL manual)
▼
Banco ── Microsoft SQL Server (T-SQL)
| Camada | Responsabilidade |
|---|---|
| Rotas | Mapeiam URL e verbo HTTP para um controller |
| Controllers | Recebem a requisição, validam a entrada e devolvem a resposta |
| Services | Concentram as regras de negócio |
| Acesso a dados | Executam o SQL no banco (driver mssql) |
| Banco | Armazena os dados e garante a integridade (constraints) |
| Área | Tecnologias |
|---|---|
| Frontend | React, TypeScript, Vite, React Router |
| Backend | Node.js, Express, TypeScript, mssql, tsx (execução em desenvolvimento) |
| Banco de dados | Microsoft SQL Server, T-SQL, SQL Server Management Studio |
| Ferramentas | Git, GitHub (Issues e Pull Requests), Postman ou Insomnia |
Um único repositório com duas aplicações independentes, cada uma com o seu package.json:
deskflow/
├── backend/ API REST (Node + Express + TypeScript)
├── frontend/ Interface web (React + TypeScript + Vite)
└── README.md
As instruções abaixo cobrem o que já existe. A configuração do banco e das variáveis de ambiente será documentada quando essas partes forem implementadas.
Pré-requisitos: Node.js (versão LTS recente) e npm.
Backend
cd backend
npm install
npm run dev # desenvolvimento, com reinício automático
npm run build # compila o TypeScript para dist/
npm start # executa a versão compiladaFrontend
cd frontend
npm install
npm run dev- Etapa 1 — SQL Server e modelagem: instalação, criação do banco e das tabelas, relacionamentos, inserção de dados e consultas básicas
- Etapa 2 — SQL intermediário: JOINs,
GROUP BY,HAVING, subqueries, constraints, índices e consultas de relatório - Etapa 3 — Backend: conexão com o SQL Server, API REST, controllers, services e CRUD
- Etapa 4 — Frontend: componentes, hooks, formulários, rotas e consumo da API
- Etapa 5 — Regras de negócio: fluxo dos chamados, histórico, comentários, validações e transações
- Etapa 6 — Debugging e testes: logs, testes e validação de dados
- Etapa 7 — Documentação: README, documentação técnica e apresentação do projeto
Itens concluídos: configuração inicial do repositório e do backend (TypeScript, scripts de desenvolvimento e build).
- Repositório único, sem ferramentas de workspace: o escopo é pequeno e uma funcionalidade costuma tocar banco, API e tela; um único Pull Request cobre as três camadas.
- SQL escrito à mão, sem ORM: o objetivo é aprender o SQL Server a fundo.
tsxem vez dets-node-devno desenvolvimento: ots-nodenão funcionou com o TypeScript 7, cuja API de compilador mudou; otsxnão depende dela.- Lockfile versionado (
package-lock.json): garante as mesmas versões de dependências para qualquer pessoa que clonar o projeto.
Breno Luiz — desenvolvedor Full Stack e estudante de Engenharia de Software.