Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/jinkogule/spring-boot-crud

API RESTful que realiza operações CRUD, desenvolvida com Spring Boot.
https://github.com/jinkogule/spring-boot-crud

api-rest java maven spring-boot

Last synced: 7 days ago
JSON representation

API RESTful que realiza operações CRUD, desenvolvida com Spring Boot.

Awesome Lists containing this project

README

        

# Spring Boot CRUD

[![License](https://img.shields.io/github/license/Jinkogule/Spring-Boot-CRUD?style=for-the-badge)](LICENSE)

![Status](https://img.shields.io/badge/STATUS-CONCLU%C3%8DDO-brightgreen?style=for-the-badge)


Sobre
Documentação
Desenvolvimento
Tecnologias
Executar o projeto localmente
Requisições e Respostas da API
Autor
Licença

---

## 💻 Sobre o projeto

O Spring Boot CRUD é um sistema desenvolvido como parte de um projeto acadêmico para a disciplina de Desenvolvimento de Aplicações Corporativas. Este projeto utiliza o framework Spring Boot para implementar uma API RESTful que realiza operações CRUD, baseado em um cenário fictício conforme descrito no [enunciado do trabalho](https://github.com/Jinkogule/Spring-Boot-CRUD/raw/main/src/main/resources/documents/Trabalho_em_grupo.pdf).

## 📋 Documentação

- **[Enunciado do trabalho](https://github.com/Jinkogule/Spring-Boot-CRUD/raw/main/src/main/resources/documents/Trabalho_em_grupo.pdf)**
- **[Wiki](https://github.com/Jinkogule/Spring-Boot-CRUD/wiki)**

## 🧑🏻‍💻 Desenvolvimento

- **[Código-fonte](https://github.com/Jinkogule/Spring-Boot-CRUD)**
- **[Issue Tracking](https://github.com/Jinkogule/Spring-Boot-CRUD/issues)**

## 🛠 Tecnologias

#### **Back-End (API)**

- **[Java 17](https://www.oracle.com/br/java/technologies/downloads/#java17)**
- **[Spring Boot 3](https://spring.io/projects/spring-boot)**
- **[Maven 3.8.6 (Wrapper)](https://maven.apache.org/)**

> Para mais detalhes sobre as configurações do projeto, veja o arquivo [`pom.xml`](https://github.com/Jinkogule/Spring-Boot-CRUD/blob/main/pom.xml).

#### **Banco de Dados**

- **[MySQL 8.0.3](https://www.mysql.com/)**

#### **Utilitários**

- Teste de API: **[Postman](https://www.postman.com/)** -> **[Postman Collection](https://github.com/Jinkogule/Spring-Boot-CRUD/blob/main/src/main/resources/documents/trabalhodac.postman_collection.json)**

## ⚙ Executar o projeto localmente

#### **Pré-Requisitos**

Antes de começar, certifique-se de:

- Instalar o **[Git](https://git-scm.com/)**.
- Instalar o **[MySQL Server 8.0.3](https://dev.mysql.com/downloads/mysql/)** (ou versão compatível).
- Executar o **[script de banco de dados](https://github.com/Jinkogule/Spring-Boot-CRUD/blob/main/src/main/resources/documents/trabalhodac.sql)** para criar o schema e as tabelas necessárias.
- Instalar o **[JDK 17](https://www.oracle.com/br/java/technologies/downloads/#java17)** (ou versão compatível) e configurar a variável `JAVA_HOME` com o caminho correto do JDK.

#### **Rodando o Back-End (servidor)**

```bash
# Clone este repositório
$ git clone https://github.com/Jinkogule/Spring-Boot-CRUD

# Acesse a pasta do projeto no terminal/cmd
$ cd Spring-Boot-CRUD

# Instale as dependências e execute a aplicação usando o Maven Wrapper
# No Linux/macOS ou PowerShell
$ ./mvnw install
$ ./mvnw spring-boot:run

# No Windows
$ mvnw.cmd install
$ mvnw.cmd spring-boot:run
```

[![Postman](https://img.shields.io/badge/Teste%20com%20o%20Postman-FF6C37?style=for-the-badge&logo=postman&logoColor=white)](https://github.com/Jinkogule/Spring-Boot-CRUD/blob/main/src/main/resources/documents/trabalhodac.postman_collection.json)

## 📷 Requisições e Respostas da API

Visualização das Operações CRUD sobre a entidade Atividades:


Create






Criação do primeiro item





Criação do segundo item





Criação do terceiro item


Read






Leitura específica sobre Id=1





Leitura de todos os itens após criações





Leitura de todos os itens após updates sobre Id=1 e Id=2





Leitura de todos os itens após deleções sobre Id=1 e Id=3


Update






Atualização sobre Id=1





Atualização sobre Id=2


Delete






Deleção sobre Id=1





Deleção sobre Id=3

## ✒ Autor

[![Linkedin](https://img.shields.io/badge/-Lucas%20Pimenta-blue?style=flat-square&logo=Linkedin&logoColor=white&link=https://www.linkedin.com/in/lucas-pimenta-0663671b1/)](https://www.linkedin.com/in/lucas-pimenta-0663671b1/)
[![Gmail](https://img.shields.io/badge/[email protected]?style=flat-square&logo=Gmail&logoColor=white&link=mailto:[email protected])](mailto:[email protected])

## 📝 Licença

Este projeto está sob a licença [MIT](./LICENSE).