/project-store-simulator

Store Simulator Project - A simple e-commerce API project with Spring. The project uses the Spring framework with the H2 in-memory database to create RESTful endpoints to manage users, products, and sales. The goal is to provide a simple and scalable system simulator to manage an online store.

Primary LanguageJava

storeSimulator

Projeto storeSimulator - um projeto de backend simples de e-commerce com Spring. O projeto utiliza o framework Spring com o Banco em memória H2, para criar endpoints RESTful para gerenciar usuários, produtos e vendas. O objetivo é fornecer um simulador de sistema simples e escalável para gerenciar uma loja virtual.

O projeto foi reestruturado para implementar uma arquitetura de subdomínios, dividindo as responsabilidades de forma mais clara e modular. A seguir está a estrutura do projeto com as camadas MVC:

  • Customer Subdomain: Responsável pelo gerenciamento de clientes.

    • Controller: CustomerController que contém os endpoints CRUD para clientes. Endpoint: "/customers".
    • Service: CustomerService que implementa a lógica de negócio para clientes.
    • Repository: CustomerRepository para acesso aos dados dos clientes.

  • Product Subdomain: Responsável pelo gerenciamento de produtos.

    • Controller: ProductController que contém os endpoints CRUD para produtos. Endpoint: "/products".
    • Service: ProductService que implementa a lógica de negócio para produtos.
    • Repository: ProductRepository para acesso aos dados dos produtos.

  • Sale Subdomain: Responsável pelo gerenciamento de vendas e carrinhos de compras.

    • Controller: SaleController que contém os endpoints CRUD para vendas e carrinhos de compras. Endpoint: "/sales-carts".
    • Service: SaleService que implementa a lógica de negócio para vendas e carrinhos de compras.
    • Repository: SaleRepository para acesso aos dados das vendas e carrinhos de compras.

  • Sale.ItemSale Subdomain: Subdomínio filho responsável pelo gerenciamento dos itens de venda.

    • Controller: SaleController usando o mesmo controller do pai Sale contém os endpoints CRUD para itens de venda. Endpoint: "/sales-carts/items".
    • Service: ItemSaleService que implementa a lógica de negócio para itens de venda.
    • Repository: ItemSaleRepository para acesso aos dados dos itens de venda.

O projeto também está documentado com o Swagger, uma ferramenta para documentação de APIs. Depois de executar o projeto, a documentação pode ser acessada no seguinte endereço: http://localhost:8080/swagger-ui/index.html

Executando o projeto

Para executar o projeto, você precisará ter o Java 17 (ou superior) instalado em sua máquina. Siga as etapas abaixo:

  1. Faça o download do arquivo .jar da versão desejada na seção de releases do repositório.
  2. Abra o terminal e navegue até o diretório onde o arquivo .jar está localizado.
  3. Execute o seguinte comando: java -jar store-simulator-0.0.1.jar

Isso iniciará o servidor e o projeto estará disponível na porta 8080. Agora você pode acessar os endpoints e testar a API.