Skip to content

vivereTeam/vivere-back

Repository files navigation

🚀 Vivere Backend API

📖 Descrição

API do sistema Vivere, responsável pela gestão de usuários, eventos e carrinhos de compra. Desenvolvida com Node.js e Prisma para integração com PostgreSQL.


🛠️ Tecnologias Principais

  • Node.js (v18+) - Ambiente de execução JavaScript
  • Express - Framework web para API RESTful
  • Prisma - ORM para PostgreSQL
  • JWT - Autenticação segura
  • Swagger - Documentação de API
  • Docker - Containerização do serviço

🖥️ Repositório do Front-End

A interface do usuário do projeto está disponível em:
🔗 vivereTeam/vivere-front


📂 Estrutura do Projeto

└── vivereteam-vivere-back/
    ├── README.md
    ├── docker-compose.yml
    ├── Dockerfile
    ├── package.json
    ├── swagger-output.json
    ├── .dockerignore
    ├── prisma/
    └── src/
        ├── server.js
        ├── server.test.js
        ├── controllers/
        │   ├── cartController.js
        │   ├── eventoController.js
        │   └── userController.js
        ├── middleware/
        │   ├── authMiddleware.js
        │   └── checkRole.js
        └── routes/
            ├── cartRoutes.js
            ├── eventoRoutes.js
            └── userRoutes.js

🔧 Instalação e Configuração

Siga os passos abaixo para rodar o projeto localmente ou com Docker.

Requisitos Prévios

  • Node.js (v16 ou superior)
  • Docker e Docker Compose (opcional)
  • PostgreSQL (somente para execução local, caso não use Docker)

💻 Executar com Docker (Recomendado)

1. Configure o arquivo .env

Crie um arquivo .env na raiz do projeto com:

DATABASE_URL=postgresql://postgres:postgres@db:5432/mydatabase
JWT_SECRET=sua_chave_jwt_segura

2. Inicie o projeto com Docker

docker-compose up --build

🛠️ Executar Localmente

1. Clone o Repositório

git clone https://github.com/vivereTeam/vivere-back
cd vivere-back

2. Instale as Dependências

npm install

3. Configure o Arquivo .env

Crie um arquivo .env com as seguintes variáveis:

DATABASE_URL=postgresql://usuario:senha@localhost:5432/nome_do_banco
JWT_SECRET=sua_chave_jwt_segura

Atenção:

  • Você precisa ter o PostgreSQL instalado e rodando localmente, ou usar um banco externo.
  • Use as credenciais do seu ambiente (usuário, senha, host, nome do banco etc).

4. Execute as Migrações

npx prisma migrate dev

5. Inicie o Projeto

npm run dev

📚 Documentação da API


🤝 Contribuição

  1. Crie uma branch:
    git checkout -b feature/NomeDaFeature
  2. Faça o commit:
    git commit -m 'feat: adiciona NomeDaFeature'
  3. Envie a branch:
    git push origin feature/NomeDaFeature
  4. Abra um Pull Request com uma descrição clara

📜 Licença

MIT License – Consulte o arquivo LICENSE.


👥 Colaboradores

J0aoPaulo
João Paulo Almeida
DavidEricson00
David Ericson

About

E-commerce for creating, managing and sharing personalized experiences, going beyond the traditional event ticket model. [Backend]

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors