Contacts List

Sistema Full Stack para gerenciamento de clientes e contatos.

Índice

• Sobre o Projeto
• Funcionalidades
• Tecnologias Utilizadas
• Estrutura do Projeto
• Como Rodar o Projeto
• Comandos Principais

---

Sobre o Projeto

O Contacts List é uma aplicação web para cadastro, listagem e gerenciamento de clientes e seus contatos. O sistema possui autenticação, controle de acesso e exportação de relatórios em PDF.

Funcionalidades

• Cadastro, login e autenticação de clientes
• CRUD de clientes e contatos
• Listagem de contatos por cliente
• Exportação de contatos em PDF
• Interface responsiva

---

Tecnologias Utilizadas

• Back-end:
  • Node.js, NestJS, TypeScript
  • Prisma ORM, PostgreSQL
  • JWT para autenticação
• Front-end:
  • React, TypeScript, Vite
  • Styled-components
  • React Hook Form, Zod
  • Axios
• Outros:
  • Docker, Docker Compose

---

Estrutura do Projeto

5. Contacts List/
├── back-end/        # API NestJS + Prisma
├── front-end/       # Aplicação React + Vite
├── docker-compose.yml
└── README.md

---

Como Rodar o Projeto

Pré-requisitos

• Docker e Docker Compose instalados
• Node.js e npm (opcional, para rodar sem Docker)

Usando Docker Compose

1. Crie um arquivo .env na raiz com as variáveis necessárias (PORT, PGPORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB, DATABASE_URL).
2. Execute:

   docker-compose up --build

3. O back-end estará em http://localhost:<PORT> e o front-end em http://localhost:3000.

Rodando Manualmente

Back-end

1. Entre na pasta back-end:

   cd back-end
   npm install
   npx prisma migrate dev
   npm run start:dev

2. Configure o banco PostgreSQL e a variável DATABASE_URL.

Front-end

1. Entre na pasta front-end:

   cd front-end
   npm install
   npm run dev

---

Comandos Principais

Back-end

• npm run start:dev — inicia o servidor em modo desenvolvimento
• npx prisma migrate dev — executa as migrations do banco
• npm run test — executa os testes

Front-end

• npm run dev — inicia o front-end em modo desenvolvimento
• npm run build — build de produção

---