Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mathmendesreis/sistema-de-gerenciamento-de-clientes
Este projeto visa criar uma solução eficiente para o gerenciamento de clientes de uma empresa que realiza limpeza em residências. A plataforma é composta por um backend em Node.js utilizando PostgreSQL como banco de dados, e um frontend em React.
https://github.com/mathmendesreis/sistema-de-gerenciamento-de-clientes
axios backend docker-compose frontend fullstack-development hooks monorepo nodejs orientacao-a-objetos postgresql react-hook-form react-router reactjs shadcn-ui sql tawilwind typescript vite
Last synced: about 2 months ago
JSON representation
Este projeto visa criar uma solução eficiente para o gerenciamento de clientes de uma empresa que realiza limpeza em residências. A plataforma é composta por um backend em Node.js utilizando PostgreSQL como banco de dados, e um frontend em React.
- Host: GitHub
- URL: https://github.com/mathmendesreis/sistema-de-gerenciamento-de-clientes
- Owner: MathMendesReis
- License: mit
- Created: 2024-02-01T12:41:26.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-02-04T00:35:33.000Z (11 months ago)
- Last Synced: 2024-07-08T22:45:31.350Z (6 months ago)
- Topics: axios, backend, docker-compose, frontend, fullstack-development, hooks, monorepo, nodejs, orientacao-a-objetos, postgresql, react-hook-form, react-router, reactjs, shadcn-ui, sql, tawilwind, typescript, vite
- Language: TypeScript
- Homepage:
- Size: 619 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sistema de Gerenciamento de Clientes
## Introdução
Este projeto visa criar uma solução eficiente para o gerenciamento de clientes de uma empresa que realiza limpeza em residências. A plataforma é composta por um backend em Node.js utilizando PostgreSQL como banco de dados, e um frontend em React.
## Parte 1 - Gerenciamento de Clientes
A empresa utiliza as seguintes informações para gerenciar seus clientes: nome, email e telefone. As funcionalidades implementadas na plataforma incluem:
- Listagem de clientes com capacidade de filtragem com base nas informações cadastradas.
- Cadastro de novos clientes.
## Parte 2 - Otimização de Rotas de Atendimento
Além do cadastro e visualização de clientes, a empresa deseja otimizar as rotas de atendimento para maximizar a eficiência na visitação dos clientes. Cada cliente possui coordenadas X e Y em um mapa bidimensional.
O algoritmo para calcular a rota, partindo da empresa (0,0) e passando por todas as localizações dos clientes, está disponível via rota da API. Foi implementado um botão na tela de clientes que, ao ser clicado, abre uma modal mostrando a ordem de visitação dos clientes na rota calculada.
## Configuração e Execução Local
Para rodar o projeto localmente, siga as instruções abaixo:
## Backend (Node.js com PostgreSQL)
- Clone o repositório: git clone https://github.com/MathMendesReis/-Facilita-Jur-dico.git
- certifique-se que está na pasta faciita-juridico
- necessario ter o docker
- Instale as dependências: npm install
- Execute o servidor: npm run start
- o frontend vai rodar na porta http://localhost:5173/
## Banco de Dados - DDL
A estrutura da tabela no banco de dados PostgreSQL é definida pelo seguinte DDL:
```sql
CREATE TABLE cliente_tb (
id VARCHAR(255) PRIMARY KEY NOT NULL,
nome VARCHAR(255) NOT NULL,
email VARCHAR(255) NOT NULL,
telefone VARCHAR(20) NOT NULL,
rua VARCHAR(255) NOT NULL,
numero VARCHAR(10),
bairro VARCHAR(100),
cidade VARCHAR(100) NOT NULL,
estado VARCHAR(50) NOT NULL,
latitude VARCHAR(50) ,
longitude VARCHAR(50),
creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL
);
CREATE TABLE adress_tb (
id VARCHAR(255) PRIMARY KEY NOT NULL,
rua VARCHAR(255) NOT NULL,
numero VARCHAR(10),
bairro VARCHAR(100),
cidade VARCHAR(100) NOT NULL,
estado VARCHAR(50) NOT NULL,
latitude VARCHAR(50) ,
longitude VARCHAR(50),
creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL
);
```
## Observações Gerais
- O código fonte está disponível neste repositório.
- O prazo para realização do teste foi de 3 dias.
- Preferência para consultas em SQL na API, evitando o uso de ORMs.
## Endpoints
### FindAllClientes
- Retorna todos os usuarios cadastrados;
- path: http://localhost:3003/cliente
### FindAdress
- Retorna o endereço do comercio;
- path: http://localhost:3003/cliente/adress
### SortClientsByAdress
- Retorna os clientes ordenados por proximidade da loja;
- path: http://localhost:3003/cliente/sort'
### RegisterCliente
- Adiciona um novo cliente ao sistema;
- methodo : post
- path: http://localhost:3003/cliente/register'
### RegisterAdressStore
- Registra um novo endereço da loja;
- methodo : post
- path: http://localhost:3003/register/adress'
### Tecnologias utilizadas
## Conclusão
Este teste foi desenvolvido para avaliar habilidades básicas e lógica na resolução de problemas. As escolhas e abordagens adotadas foram documentadas para melhor compreensão. Em caso de dúvidas, favor entrar em contato para esclarecimentos adicionais.