Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mauriciohidani/alurachallengescreensound
Alura One G7 - Challenge Screen Sound
https://github.com/mauriciohidani/alurachallengescreensound
alura artists challenge openai-api oracle relational-databases songs
Last synced: about 1 month ago
JSON representation
Alura One G7 - Challenge Screen Sound
- Host: GitHub
- URL: https://github.com/mauriciohidani/alurachallengescreensound
- Owner: mauricioHidani
- Created: 2024-10-30T18:08:30.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-30T19:07:45.000Z (2 months ago)
- Last Synced: 2024-10-30T19:28:34.642Z (2 months ago)
- Topics: alura, artists, challenge, openai-api, oracle, relational-databases, songs
- Language: Java
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Desafio Screen Sound
🚩Java e Spring Framework G7 - ONE | Java: persistência de dados e consultas com Spring Data JPA
📅30 de outubro de 2024 - 📍São Paulo, Brasil
🌎[@Alura](https://www.alura.com.br/) | [@One](https://www.oracle.com/br/)
## Versões
- [Java 21](https://docs.oracle.com/en/java/javase/21/)
- [Maven](https://maven.apache.org/what-is-maven.html)
- [Theokanning Openai GPT3 v0.18.2](https://github.com/TheoKanning/openai-java)
## Desafio
Implementar uma aplicação para armazenar dados de nossos artistas e músicas preferidos em um banco de dados relacional,
podendo buscar informações por artistas e consultar dados sobre os mesmos através de integração com a API do ChatGPT.
- Você precisará de uma classe _Artista_, com os dados para representar o mesmo;
- Será necessário também uma classe específica para representar as _Músicas_;
- Para o artista, pode praticar a implementação de _enum_, para definir o **tipo** do artista, por exemplo: **solo**,
**dupla** ou **banda**;
- Lembre-se de criar o projeto através do site do [Spring Initializr](https://start.spring.io/), onde já é possível
adicionar as dependências do **Spring Data JPA** e do **PostgreSQL**;
- Crie uma classe principal com o menu, com as opções desejadas, como: **cadastrar artista**, **cadastrar música**,
**pesquisar músicar por artistas**, **etc**;
- Lembre-se de estender o **CommandLineRunner** na classe do Spring, sobrescrevendo o método run para chamar o menu
criado.
### 🔨 Objetivos do projeto
- O objetivo do projeto é praticar a modelagem de classes e relacionamentos utilizando o Spring Data JPA;
- É importante descrever e implementar corretamente a relação entre **Artista** e **Música**, visto que um artista
pode estar associado a mais de uma música;
- Uma música só deve ser salva no banco de dados, caso o Artista tenha sido previamente cadastrado;
- Praticaremos **Derived Queries** e **JPQL** para verificar se o artista já está cadastrado e buscar músicas
por um determinado artista;
- Faremos a **integração** com a **API do ChatGPT** para buscar informações sobre um determinado artista.
## Utilização
### OpenAI GPT3 API
Para conseguir utilizar a aplicação onde é gerado a _Descrição do Artista_ é necessário que se crie uma conta na
[Plataforma](https://platform.openai.com/docs/overview) da OpenAI para consumir APIs, após sua criação deve-se registrar
uma **Chave de API/API Key** para assim conseguir que a aplicação realize requisições de consulta da _Descrição do
Artista_.
Depois de registrado e com a chave de acesso da OpenAI, é necessário criar uma _variável de ambiente_ no sistema com o
nome `OPENAI_API_KEY` e o valor da sua **Chave**, ou trocar no arquivo `application.yml` o valor que indica a variável
de ambiente `OPENAI_API_KEY` para sua **Chave**.
### Perfil ou Profile da Aplicação
No arquivo `application.yml` está indicado dois possiveis **Profiles**, `prod`=Produção e `test`=Teste, cada um representa
seu ambiente. A aplicação irá inicializar a configuração respectiva ao seu perfil de ambiente escolhido.
Assim quando rodar a aplicação em `test` a base de dados utilizada será o `H2`, um banco de dados de teste que irá
armazenar as informações em memória, pesistidas apenas enquanto a aplicação estiver rodando.
Já ao perfil de `prod` a aplicação irá rodar com a base de dados usando o `Postgres`. Sendo necessário mudar ou atribuir
as variáveis de ambiente para conseguir consumir/requisitar o SGBD `Postgres`.
- `POSTGRES_URI`: URI que representa a conexão com o `Postgres` _(exp: jdbc:postgresql://localhost:port/sua_base_de_dados)_;
- `POSTGRES_USERNAME`: Nome de usuário para conectar com o `Postgres` _(obs: quando não modificado será `postgres`)_;
- `POSTGRES_PASSWORD`: Senha utilizada para acessar o SGBD _(obs: caso necessite resetar a senha do `Postgres` por não
lembrar mais o [link](https://www.youtube.com/watch?v=wfxrRxzm8jY) irá explicar como fazé-lo no OS Windows)_;
## Descrição
**Inicio da aplicação**
**Menu da aplicação**
**Adicionando Artista**
**Adicionando Música**
**Listagem de Músicas**
**Consulta de Música por Artista**
**Consultar Descrição/Dados de um Artista**
**Mensagem Sair da Aplicação**
