An open API service indexing awesome lists of open source software.

https://github.com/imsamuelcovalero/project-our-shop-app-angular

Plataforma de e-commerce, implementada com MongoDB, Angular.js e Node.js, oferecendo recursos completos para visualização de produtos, gerenciamento de carrinho, finalização de compra e consulta ao histórico de pedidos.
https://github.com/imsamuelcovalero/project-our-shop-app-angular

angular-material angularjs backend cors crud-application css3 docker docker-compose express-async-errors expressjs frontend full-stack joi-validation mongodb mongoose nodejs nodemon rest-api toast-notifications

Last synced: 2 months ago
JSON representation

Plataforma de e-commerce, implementada com MongoDB, Angular.js e Node.js, oferecendo recursos completos para visualização de produtos, gerenciamento de carrinho, finalização de compra e consulta ao histórico de pedidos.

Awesome Lists containing this project

README

          

# Bem-vindo ao Project-Our-Shop-App-Angular

O __Project-Our-Shop-App-Angular__ é uma aplicação de comércio eletrônico desenvolvida com `MongoDB` no banco de dados, `Angular.js` no `frontend` e `Node.js` com `Mongoose`no `backend`. Ela permite que usuários visualizem produtos, adicionem itens ao carrinho de compras, realizem o checkout escolhendo o ponto de retirada e vejam o histórico de pedidos.

## Sumário

- [Bem-vindo ao Project-Our-Shop-App-Angular](#bem-vindo-ao-project-our-shop-app-angular)
- [Sumário](#sumário)
- [Visualização](#visualização)
- [Contexto](#contexto)
- [Visão Geral de Funcionalidades](#visão-geral-de-funcionalidades)
- [Como rodar a aplicação e detalhes do funcionamento](#como-rodar-a-aplicação-e-detalhes-do-funcionamento)
- [Início Rápido](#início-rápido)
- [Frontend](#frontend)
- [Backend](#backend)
- [Notas](#notas)
- [Git, GitHub e Histórico de Commits](#git-github-e-histórico-de-commits)

## Visualização

__Em construção__

![Project-Our-Shop-App-Angular](https://github.com/imsamuelcovalero/Project-Our-Shop-App-Angular/assets/98184355/6651864d-1d2e-459f-ac2f-6ce4cb667097)

## Contexto

O __Project-Our-Shop-App-Angular__ é um sistema de comércio eletrônico criado para proporcionar uma experiência de compra online eficiente e versátil. Ele permite que os usuários naveguem por um catálogo de produtos, adicionem itens ao carrinho de compras, e efetuem o _checkout_ com a opção de escolher o ponto de retirada dos produtos adquiridos. Um destaque desta plataforma é o recurso de _cashback_, que pode ser utilizado para reduzir o valor total da compra. Além disso, os usuários podem acompanhar seu histórico de pedidos e consultar o saldo atual de _cashback_ na página de histórico de ordens, proporcionando maior controle e transparência sobre suas transações.

### Visão Geral de Funcionalidades

O __Project-Our-Shop-App-Angular__ conta com uma interface amigável e intuitiva, com opção de `temas` claro e escuro, que permite aos usuários:

- Fazer login ou se registrar
- Visualizar e escolher produtos que deseje comprar
- Ter a opção de utilizar o cashback para abater no valor total da compra
- Escolher um local de retirada
- Consultar o histórico de ordens

## Como rodar a aplicação e detalhes do funcionamento

### Início Rápido

Detalhes

Clone o repositório para sua máquina local.
```bash
git clone git@github.com:imsamuelcovalero/Project-Our-Shop-App-Angular
```

**Com Docker**

1. Navegue até o diretório raiz do projeto no terminal: `cd Project-Our-Shop-App-Angular`.
2. No diretório raiz do projeto, execute `docker-compose up -d` para iniciar os containers.
3. O servidor de `backend` estará rodando na porta `3001` e a aplicação na porta `4200`.

**Sem Docker**

1. Navegue até o diretório raiz do projeto no terminal: `cd Project-Our-Shop-App-Angular`.
2. Acesse o diretório `backend` e execute `npm install` para instalar as dependências.
3. Inicie o servidor com `npm run dev`.
4. A aplicação estará rodando na porta `3001`.
5. Acesse o diretório `frontend` e execute `npm install` para instalar as dependências.
6. Execute `ng serve` para iniciar a aplicação.
7. Abra um navegador web e acesse `http://localhost:4200`.
8. Você precisa estar com o `MongoDB` rodando localmente ou por um container do `docker` para que a aplicação funcione corretamente.

**Maiores detalhes sobre o funcionamento da aplicação podem ser encontrados no `README` do `frontend` e do `backend`.**

### Frontend

O `README` referente ao __Frontend__ pode ser acessado [aqui](frontend/README.md).

### Backend

O `README` referente ao __Backend__ pode ser acessado [aqui](backend/README.md).

## Notas

### Git, GitHub e Histórico de Commits

Este projeto utiliza a [Especificação de Commits Convencionais](https://www.conventionalcommits.org/en/v1.0.0/), com alguns tipos da [convenção Angular](https://github.com/angular/angular/blob/22b96b9/CONTRIBUTING.md#-commit-message-guidelines). Além disso, foi utilizado o pacote [conventional-commit-cli](https://www.npmjs.com/package/conventional-commit-cli)

[⬆ Voltar ao topo](#sumário)