Skip to content
brenoluizdevPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

DeskFlow

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.

Sobre o projeto

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.

Por que sem ORM?

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.

Funcionalidades planejadas

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.

Regras de negócio

  1. Todo chamado novo começa com o status Aberto.
  2. Um chamado pode passar para Em andamento.
  3. Para concluir um chamado, é obrigatório registrar uma solução.
  4. Um chamado concluído não pode ser cancelado.
  5. Toda alteração de status é registrada no histórico.
  6. As prioridades são Baixa, Média, Alta e Crítica.
  7. Um chamado pode ter um responsável atribuído.

Arquitetura

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)

Tecnologias

Á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

Estrutura do repositório

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

Como executar

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 compilada

Frontend

cd frontend
npm install
npm run dev

Roadmap

  • 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).

Decisões técnicas

  • 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.
  • tsx em vez de ts-node-dev no desenvolvimento: o ts-node não funcionou com o TypeScript 7, cuja API de compilador mudou; o tsx não depende dela.
  • Lockfile versionado (package-lock.json): garante as mesmas versões de dependências para qualquer pessoa que clonar o projeto.

Autor

Breno Luiz — desenvolvedor Full Stack e estudante de Engenharia de Software.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages