{"id":25089643,"url":"https://github.com/unlockway/unlockway-api","last_synced_at":"2026-04-11T00:11:58.397Z","repository":{"id":274826414,"uuid":"924193910","full_name":"unlockway/unlockway-api","owner":"unlockway","description":"Unlockway API Built with Java, Spring Boot (maven) and Hibernate JPA.","archived":false,"fork":false,"pushed_at":"2025-03-22T01:41:28.000Z","size":1496,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T02:28:48.182Z","etag":null,"topics":["azure-app-service","azure-blob-storage","docker","java","jwt","maven","postgresql","spring-boot","swagger"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unlockway.png","metadata":{"files":{"readme":"README-PTBR.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-29T15:28:00.000Z","updated_at":"2025-03-22T01:41:32.000Z","dependencies_parsed_at":"2025-01-29T16:44:02.066Z","dependency_job_id":null,"html_url":"https://github.com/unlockway/unlockway-api","commit_stats":null,"previous_names":["unlockway/unlockway-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlockway%2Funlockway-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlockway%2Funlockway-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlockway%2Funlockway-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unlockway%2Funlockway-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unlockway","download_url":"https://codeload.github.com/unlockway/unlockway-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246679069,"owners_count":20816402,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azure-app-service","azure-blob-storage","docker","java","jwt","maven","postgresql","spring-boot","swagger"],"created_at":"2025-02-07T11:18:17.308Z","updated_at":"2025-12-30T23:13:28.788Z","avatar_url":"https://github.com/unlockway.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🥘 API de Gerenciameto de Refeições Saudáveis (Projeto de TCC)\n\n![Unlockway Logo](./.github/assets/unlockway_logo.png)\n\n![Azure](https://img.shields.io/badge/azure-%230072C6.svg?style=for-the-badge\u0026logo=microsoftazure\u0026logoColor=white) ![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge\u0026logo=openjdk\u0026logoColor=white) ![Spring](https://img.shields.io/badge/spring-%236DB33F.svg?style=for-the-badge\u0026logo=spring\u0026logoColor=white) ![Hibernate](https://img.shields.io/badge/Hibernate-59666C?style=for-the-badge\u0026logo=Hibernate\u0026logoColor=white) ![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge\u0026logo=docker\u0026logoColor=white) ![Postgres](https://img.shields.io/badge/postgres-%23316192.svg?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white) ![JWT](https://img.shields.io/badge/JWT-black?style=for-the-badge\u0026logo=JSON%20web%20tokens) ![Swagger](https://img.shields.io/badge/-Swagger-%23Clojure?style=for-the-badge\u0026logo=swagger\u0026logoColor=white)\n\nEste projeto foi construído na faculdade como parte de um projeto de integração entre várias disciplinas (TCC). A API de Gerenciamento de Refeições Saudáveis é uma API robusta e escalável projetada para gerenciar rotinas de refeições saudáveis e notificações para os usuários. Construída usando Spring Boot com Maven, segue os princípios da Arquitetura MVC e Hexagonal. A API utiliza Hibernate JPA para interações com o banco de dados PostgreSQL, rodando localmente via Docker e Docker Compose. Para produção, a API é implantada usando Azure App Services, e as imagens são armazenadas usando Azure Blob Storage. A autenticação é feita usando tokens JWT, que expiram em uma hora. Os endpoints da API são documentados com Swagger. A API é usada para um aplicativo móvel Flutter. Você pode encontrar o repositório do aplicativo móvel [aqui](https://github.com/unlockway/unlockway_mobile).\n\n\u003e Acesse o protótipo de layout construído no Figma clicando [aqui](https://www.figma.com/design/eVCIm7PVUYjDSV6PrifbAG/Fatec---Projeto-Integrador%3A-Unlockway?node-id=0-1\u0026t=JH2hcRXH9DhEu4BF-1)\n\n## Diagrama de Classe\n\n![Diagrama de Classe](./.github/assets/class_diagram.png)\n\n## Diagrama de Sequência\n\n- Criação de uma Refeição\n\n![Diagrama de Sequência para criação de uma refeição](./.github/assets/sequence_diagram_create_meal.png)\n\n- Criação de uma Rotina\n\n![Diagrama de Sequência para criação de uma rotina](./.github/assets/sequence_diagram_create_routine.png)\n\n## Casos de Uso\n\n![Casos de Uso](./.github/assets/use_cases.png)\n\n## Preview\n\n![Swagger Page Preview](./.github/assets/unlockway_api_full_swagger.jpeg)\n\n## Tecnologias\n\n- **Java 17**\n- **Spring Boot**\n- **Maven**\n- **Hibernate JPA**\n- **PostgreSQL**\n- **Docker \u0026 Docker Compose**\n- **Azure App Services**\n- **Azure Blob Storage**\n- **JWT Authentication**\n- **Swagger**\n- **Flutter (Mobile Application)**\n\n## Como configurar sua máquina\n\n1. **Clone o repositório:**\n\n   ```sh\n   git clone https://github.com/unlockway/unlockway_api_v2.git\n   cd ./unlockway_api_v2\n   ```\n\n2. **Instale o Docker e o Docker Compose:**\n\n   - [Docker Installation Guide](https://docs.docker.com/get-docker/)\n   - [Docker Compose Installation Guide](https://docs.docker.com/compose/install/)\n\n3. **Configure o banco de dados Postgre:**\n\n   ```sh\n   docker-compose up --build -d # or `docker compose up --build -d (whitout the -)`\n   ```\n\n4. **Configure as propriedades da aplicação:**\n   - Atualize o arquivo `application.properties` com as variáveis de produção necessárias caso queira rodar em produção.\n\n## Como Executar a API\n\n1. **Instale as dependências:**\n\n   ```sh\n   mvn clean install\n   ```\n\n2. **Rode a aplicação:**\n\n   ```sh\n   mvn spring-boot:run\n   ```\n\n3. **Acesse a documentação do Swagger:**\n   - Navegue para `http://localhost:8080/swagger-ui/index.html` para visualizar e testar os endpoints.\n\nVocê também pode usar um editor de código (IDE) de sua preferência para executar a API. Aqui vai algumas opções populares:\n\n- [Visual Studio Code](https://code.visualstudio.com/)\n- [IntelliJ IDEA](https://www.jetbrains.com/idea/)\n\n## Como contribuir\n\n1. **Fork o repositório**\n\n2. **Crie uma nova branch:**\n\n   ```sh\n   git checkout -b feature/your-feature-name\n   ```\n\n3. **Faça suas alterações e então crie um commit:**\n\n   ```sh\n   git commit -m \"Add your message here\"\n   ```\n\n4. **Empurre suas alterações pra uma branch remota:**\n\n   ```sh\n   git push origin feature/your-feature-name\n   ```\n\n5. **E por fim crie um Pull Request**\n\n### Contribuidores\n\n| ![Victor H. Silva](https://github.com/vickttor.png) | ![Bruno Pequeno](https://github.com/bruno-pequeno.png) | ![Daniel Vieira](https://github.com/DanielVieira2828.png) | ![Felipe Thaylan](https://github.com/ThaylanFe.png) | ![João Zavisas](https://github.com/Zavisas.png) |\n| :-------------------------------------------------: | :----------------------------------------------------: | :-------------------------------------------------------: | :-------------------------------------------------: | :---------------------------------------------: |\n|   [Victor H. Silva](https://github.com/vickttor)    |   [Bruno Pequeno](https://github.com/bruno-pequenor)   |   [Daniel Vieira](https://github.com/DanielVieira2828)    |   [Felipe Thaylan](https://github.com/ThaylanFe)    |   [João Zavisas](https://github.com/Zavisas)    |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funlockway%2Funlockway-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funlockway%2Funlockway-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funlockway%2Funlockway-api/lists"}