Loading repository data…

Sistema-CRM

Projeto backend de um sistema CRM (Customer Relationship Management) desenvolvido em NestJS com TypeORM. Permite o gerenciamento de usuários, categorias e produtos, com suporte a operações CRUD e organização de dados comerciais. Desenvolvido como parte de um desafio prático da Generation Brasil.

#jest#jwt-auth#nestjs-backend#nodejs#passport#typeorm

README preview

📊 FLOW CRM - Sistema de Gerenciamento Comercial

Projeto desenvolvido pelo Grupo 2 para o desafio prático da Generation Brasil, com o objetivo de criar um sistema CRM para gestão de usuários, categorias e produtos.

🧾 1. Sobre o Projeto

O sistema FLOW CRM foi criado para auxiliar empresas no gerenciamento de produtos, categorias e usuários em diferentes níveis de acesso. Ele permite realizar operações de cadastro, listagem, atualização e exclusão (CRUD) de forma simples e funcional.

O projeto segue boas práticas de desenvolvimento com NestJS e integração com banco de dados relacional via TypeORM.

🧱 2. Estrutura das Entidades

Usuário: id, nome, email, senha, foto, perfil (enum)
Categoria: id, descrição
Produto: id, nome, descrição, preço, quantidade, categoria_id (FK), usuario_id (FK)

🔗 3. Diagrama Entidade-Relacionamento:

classDiagram
class Usuario {
  +id: number
  +nome: string
  +email: string
  +senha: string
  +foto: string
  +perfil: enum
}

class Categoria {
  +id: number
  +descricao: string
}

class Produto {
  +id: number
  +nome: string
  +descricao: string
  +preco: number
  +quantidade: number
  +usuario: Usuario
  +categoria: Categoria
}

Usuario "1" --> "N" Produto
Categoria "1" --> "N" Produto

Ou seja, cada produto pertence a um único usuário e uma única categoria.
Cada usuário e cada categoria pode estar associado a vários produtos.

🧰 4. Tecnologias Utilizadas

NestJS (TypeScript) – Back-end
TypeORM – ORM
MySQL – Banco de dados relacional
Insomnia – Testes de API REST
Git + GitHub – Versionamento
Node.js + VSCode

🔁 5. Funcionalidades

Usuário

Criar, listar, buscar por ID ou nome, atualizar e deletar.

Categoria

Criar, listar, buscar por ID ou descrição, atualizar e deletar.

Produto

Criar, listar, buscar por ID ou nome, buscar por faixa de preço, atualizar e deletar.

📦 6. Estrutura RESTful

O projeto está organizado em:

Controller
Service
Entity
Module
Enum

Com base nas boas práticas do NestJS, garantindo separação de responsabilidades e facilidade de manutenção.

🧪 7. Testes com Insomnia

Todos os endpoints foram testados utilizando o Insomnia, garantindo o funcionamento correto de cada operação nas três entidades principais.

🚀 8. Como Executar o Projeto

Pré-requisitos

Node.js instalado
MySQL rodando
Arquivo app.module configurado corretamente com as credenciais do banco

Passos

# Instale as dependências
npm install

# Rode o projeto em modo desenvolvimento
npm run start:dev

📄 9. Considerações Finais

O projeto foi desenvolvido como parte do desafio prático da Generation Brasil, aplicando conhecimentos de APIs REST, banco de dados, versionamento com Git e desenvolvimento em equipe.

👤 10. Sobre

Projeto desenvolvido por

👥 Equipe

Projeto acadêmico | Generation Brasil - 2025