Projeto E-commerce G3 - MATE85

Um simples projeto backend inicial de E-commerce utilizando NextJS Framework para demonstração da disciplina MATE85 - Tópicos em Sistemas de Informação e Web I.

Este projeto rosa usando Next.js e foi criado usando o create-next-app.

Milestones: contém o cornograma e calendário desse projet

Gerenciamento do Projeto

Discussóes de Tecnologia

Requisitos do Sistema

Documento de Arquitetura

Versáo temporária

=======

Tecnologias

As tecnologias que serão usadas nesse projeto são:

• Next.js - como nosso metaframework que contém um backend robusto, além de permitir SSR e outra funções usando React
• Postgres SQL (running at Neon - como nossa database, mas provavelmente será migrado para o Firebase
• Prisma - será o nosso ORM que serve como uma camada de abstração entre a aplicação e o dados persistentes
• Rodando React como nosso framework frontend em cima do Next.js
• Tailwind CSS para ser usado em conjunto com o React

=======

Instalação

Documento de Implantação

Os passos abaixo estão desuatalizados e serão atualizados assim que recebermos um feedback no nosso documento

Depois de clonar este repositório, você precisa rodar o passo de instalção

npm install

O próximo passo é criar um arquivo .env no diretório raiz deste projeto vai conter a informação da conexão com o banco. Nos passos seguintes, substituir o USERNAME e PASSWORD pelos dados de autenticação.

DATABASE_URL=postgres://USERNAME:PASSWORD@localhost:5432

Se você não tiver uma instância Postgres rodando localmente, você pode criar uma em um provedor gratuito como o Neon ou outro similar.

DATABASE_URL=postgres://USERNAME:PASSWORD@XXX.neon.tech/neondb?pgbouncer=true&connect_timeout=10
DIRECT_URL=postgres://USERNAME:PASSWORD@XXX.neon.tech/neondb?connect_timeout=10

Para certos provedores, como o Neon, uma shadow dabtabase é necessária para o Prisma rodar as migrações, portanto adicionar a linha abaixo no final do arquivo .env

SHADOW_DATABASE_URL=postgres://USERNAME:PASSWORD@XXX.neon.tech/shadow?pgbouncer=true&connect_timeout=10

Depois de linkar o banco, basta rodar o script de pós instalação

npm run post-install

=======

Desenvolvimento

Para rodar o Next.js em modo de desenvolvimento, basta rodar o seguinte comendo.

bash
npm run dev
# or
yarn dev
# or
pnpm dev

Em seguida, abra http://localhost:3000 com o seu navegador.

=======

Obervações

Este projeto usa next/font para automaticamente otimizar e carregar Inter, uma font custom do Google Font.