Simulação de Loja Virtual com Visões de Cliente e Administrador

Um projeto em Java com foco em Orientação a Objetos para simular um e-commerce funcional, separando as responsabilidades e visões entre usuários finais (clientes) e administradores.

---

Equipe

• Alison Andrade Alves
• José Arthur de Araújo Almeida
• Ruan Gouveia dos Santos

---

Índice

1. Objetivos Principais
2. Funcionalidades Planejadas
3. Estrutura do Projeto
4. Tecnologias Utilizadas
5. Como Executar o Projeto
6. Como criar o excutável JAR

---

Objetivos Principais

• Modelagem Orientada a Objetos: Implementar as entidades de uma loja virtual (Produtos, Clientes, Carrinho de Compras, Pedidos), definindo seus atributos e comportamentos, e estabelecendo os relacionamentos entre elas.
• Interface Gráfica Interativa: Desenvolver interfaces de usuário distintas para clientes e administradores utilizando uma biblioteca gráfica Java, proporcionando uma experiência intuitiva para cada tipo de usuário.
• Visão do Cliente: Permitir que os clientes naveguem por um catálogo de produtos, visualizem detalhes dos produtos, adicionem itens a um carrinho de compras, visualizem e modifiquem o carrinho, e simulem a finalização de um pedido.
• Visão do Administrador: Fornecer funcionalidades para o gerenciamento do catálogo de produtos, incluindo o cadastro, edição e exclusão de produtos.
• Separação de Acesso: Implementar mecanismos para garantir que os clientes não tenham acesso às funcionalidades administrativas, utilizando interfaces separadas e um sistema básico de login para administradores.

---

Funcionalidades Planejadas

Visão do Cliente

• Exibição de um catálogo de produtos (com nome, preço, imagem e breve descrição).
• Adição de produtos ao carrinho de compras com especificação de quantidade.
• Visualização do carrinho de compras com a possibilidade de alterar quantidades e remover itens.
• Cálculo do valor total do carrinho.
• Simulação do processo de finalização de pedido (coleta de informações básicas).

Visão do Administrador

• Tela de login para acesso à área administrativa.
• Listagem de produtos cadastrados.
• Formulário para cadastro de novos produtos.
• Formulário para edição de produtos existentes.
• Funcionalidade para exclusão de produtos.

---

Estrutura do Projeto

O projeto segue uma estrutura modular organizada da seguinte forma:

simulador-loja-poo/
│
├── src/main/
│   ├── java/br/edu/ifpb/lojavirtual/
│   │   ├── controller/   # Controladores que gerenciam a interação View-Model
│   │   ├── dao/          # Camada de Acesso a Dados (Data Access Objects)
│   │   ├── model/        # Classes de modelo/entidades.
│   │   ├── pagamento/    # Lógica de processamento de pagamentos
│   │   ├── service/      # Camada de serviços e lógica de negócios
│   │   ├── util/         # Classes utilitárias
│   │   └── MainApp.java  # Ponto de entrada da aplicação
│   │
│   └── resources/br/edu/ifpb/lojavirtual/
│       ├── imagens/      # Imagens utilizadas na interface gráfica
│       └── view/         # Arquivos da interface (telas, componentes visuais)
│
├── .gitignore
├── build.gradle.kts      # Arquivo de configuração e dependências do Gradle
├── loja_virtual.db       # Banco de dados SQLite da aplicação
└── README.md

Tecnologias Utilizadas

• Linguagem: Java
• Interface Gráfica: JavaFX
• IDE: IntelliJ IDEA
• Versionamento de Código: GitLab
• Criação de Telas: Scene Builder

---

Como Executar o Projeto

Pré-requisitos:

• Java Development Kit (JDK) 21 ou superior.
• Uma IDE Java como Eclipse ou IntelliJ IDEA.

Passo a passo - Executando pela interface da IDE:

1. Clone o repositório:

   git clone https://gitlab.com/projeto-poo1/simulador-loja-poo.git

2. Abra o projeto na sua IDE de preferência.
3. Localize a classe principal (MainApp).
4. Execute o projeto para iniciar a aplicação.

Passo a passo - Executando pelo terminal:

1. Clone o repositório:

   git clone https://gitlab.com/projeto-poo1/simulador-loja-poo.git

2. Abra o terminal na raiz do projeto.
3. Execute o seguinte comando:

    ./gradlew run

Como criar o executável JAR

1. Mude para a branch criando-jar:
   1. Pelo terminal:

      git checkout criando-jar

   2. Ou pela interface da IDE, selecionando a branch criando-jar.
2. Abra o terminal na raiz do projeto.
3. Execute o seguinte comando:

    ./gradlew shadowJar

4. Localize o arquivo JAR gerado em build/libs/simulador-loja-poo-1.0.0.jar.
5. Execute o JAR com o comando:

   java -jar build/libs/simulador-loja-poo-1.0.0.jar