{"id":18303473,"url":"https://github.com/yawkar/marvel-catalog","last_synced_at":"2026-04-15T18:31:59.704Z","repository":{"id":44463520,"uuid":"511664696","full_name":"YawKar/marvel-catalog","owner":"YawKar","description":"(Hobby project) REST API service for managing catalog of superheroes and comics","archived":false,"fork":false,"pushed_at":"2022-11-01T18:53:28.000Z","size":163,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-27T09:34:45.398Z","etag":null,"topics":["docker-compose","hobby-project","java","rest-api","spring","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YawKar.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-07-07T20:25:08.000Z","updated_at":"2023-02-13T13:48:46.000Z","dependencies_parsed_at":"2023-01-21T06:47:29.477Z","dependency_job_id":null,"html_url":"https://github.com/YawKar/marvel-catalog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/YawKar/marvel-catalog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YawKar%2Fmarvel-catalog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YawKar%2Fmarvel-catalog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YawKar%2Fmarvel-catalog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YawKar%2Fmarvel-catalog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YawKar","download_url":"https://codeload.github.com/YawKar/marvel-catalog/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YawKar%2Fmarvel-catalog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31854713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["docker-compose","hobby-project","java","rest-api","spring","spring-boot","swagger"],"created_at":"2024-11-05T15:25:46.029Z","updated_at":"2026-04-15T18:31:59.677Z","avatar_url":"https://github.com/YawKar.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marvel catalog - REST API service\nREST API service for managing catalog of superheroes and comics\n\n![Project stage: Development][project-stage-badge: Development]\n\n[project-stage-badge: Development]: https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg\n\n## Table of Contents\n* [How to run](#how-to-run)\n* [API endpoints](#api-endpoints)\n* [Database UML Model](#database-uml-model)\n* [Technologies and Features used](#technologies-and-features-used)\n\n## How to run\n```bash\n./mvnw clean                      # clean /target (if it's not the first run)\n./mvnw package -Dmaven.test.skip  # build .jar (and skip testing)\ndocker compose up                 # run composition\n```\n\n## API endpoints\nPostman collection is available for playing with api: [Marvel Catalog.postman_collection.json](docs/Marvel%20Catalog.postman_collection.json)\n* Swagger UI docs\n  * `GET /ui-docs`\n    * Opens Swagger UI docs\n* Characters controller\n  * `GET /v1/public/characters`\n    * Gets the list of all heroes from the catalog\n  * `GET /v1/public/characters/{heroId}`\n    * Gets a hero by the specified `heroId`\n  * `GET /v1/public/characters/{heroId}/comics`\n    * Gets all comics in which the hero with the specified `heroId` present\n  * `POST /v1/public/characters`\n    * Posts new hero\n  * `PUT /v1/public/characters/{heroId}`\n    * Updates the existing hero\n  * `PUT /v1/public/characters/{heroId}/comics`\n    * Updates comics in which the hero presents\n* Comics controller\n  * `GET /v1/public/comics`\n    * Gets the list of all comics from the catalog\n  * `GET /v1/public/comics/{comicId}`\n    * Gets the comic by the specified `comicId`\n  * `GET /v1/public/comics/{comicId}/characters`\n    * Gets all heroes which present in the comic with the specified `comicId`\n  * `POST /v1/public/comics`\n    * Posts new comic\n  * `PUT /v1/public/comics/{comicId}`\n    * Updates the existing comic\n\n## Database UML Model\nUML/Entities Relationship diagram:\n![ER Diagram](docs/ER_Diagram.png)\n\n## Technologies and Features used\n\n![java](https://img.shields.io/badge/Java-ED8B00?style=for-the-badge\u0026logo=java\u0026logoColor=white)\n![spring](https://img.shields.io/badge/spring%20-%236DB33F.svg?\u0026style=for-the-badge\u0026logo=spring\u0026logoColor=white)\n![Spring Boot](https://img.shields.io/static/v1?style=for-the-badge\u0026message=Spring+Boot\u0026color=6DB33F\u0026logo=Spring+Boot\u0026logoColor=FFFFFF\u0026label=)\n![Spring Data](https://img.shields.io/static/v1?style=for-the-badge\u0026message=Spring+Data\u0026color=6DB33F\u0026logo=Spring+Data\u0026logoColor=FFFFFF\u0026label=)\n![junit](https://img.shields.io/badge/junit-%2343B02A.svg?style=for-the-badge\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAYAAAAfSC3RAAABcWlDQ1BpY2MAACiRdZE9S8NQFIbftkpFKx0UlOKQoYpDi0VBHLUOXYqUWsGqS3KbtEKShpsUKa6Ci0PBQXTxa/Af6Cq4KgiCIoi4+Af8WqTEc5tCi7Qn3JyH9573cO+5gD+tM8PuSQCG6fBsKimt5tek4Dt8iGAEUwjJzLYWMpk0usbPI1VTPMRFr+51HWOgoNoM8PURzzKLO8TzxOktxxK8RzzMSnKB+IQ4xumAxLdCVzx+E1z0+Eswz2UXAb/oKRXbWGljVuIG8SRx1NArrHkecZOQaq4sU47QGoONLFJIQoKCCjahw0Gcskkz6+xLNHxLKJOH0d9CFZwcRZTIGyO1Ql1VyhrpKn06qmLu/+dpazPTXvdQEuh9dd3PcSC4D9Rrrvt76rr1MyDwAlybLX+Z5jT3TXqtpUWPgfAOcHnT0pQD4GoXGH22ZC43pAAtv6YBHxfAYB4Yugf6171ZNfdx/gTktumJ7oDDI2CC6sMbf/dvaAZsdJhFAAAACXBIWXMAAELcAABC3AECnn0dAAACg0lEQVQoU01STUhUYRQ938+b9944MzJoptmMDtIiNKVaRBJFUYvUNkOBRajbNkGbFkEUJELhpqJNlBVTEEQhucgK2hT0Y5EpJjiaZKTQTD8246jv7+u+MaMLH3zvvXvuOfecx/BfTSZbGnXOj3hKtTqel6BPSmNs4lZ9ZPDi5sjtbPLq+Go78y9TyRZNMNapcX5aBPS4Izhszyv2GODobSrB3Ro5XWJ5PcpVfenOPk/e27UNnLEuKfglx7YN42A7ynfugUBxJnF6MD/2g82+TjDNuKyUY8XOt6ZkU1lZI7WcVQqGpYBgbR1mSnX0T76ARyC/RpYykC7NkJ7BGOs2KireS3+nAGfr8rYDLiX0kjBGslPoeZkCzYEmJIJSh8YFlO2C61oMYIclGdFmrwymLg0IBUGESG7YUXw1/n0GX/IZCMZXlLs+NQ5IV6kEgelBgWRgOZ9DczSO5oZ2wDQwY+fQO/wAg5/fIsAlAYlFIcEoggXaMejL8ktEoySZmC0LWvV6VB47jnRY4NDAOeStAgQ5TsACpxgmKIZ/aTrZLKy5Wdg/fyA39Aq/371B1Aij3AzDUbSjIL85T3OKYrAI9KUSEzeDxbtyHIhQBLKiEgVnGfPWwsqekg5nj+SS66aUUoel69aIujjK2jtgZ79BFQrQYnFgUwPujD5EpjAPQ9d9Z6fppMTeqjWZtaa5YDK+by7I5eMtMbj1G5FLxDCm27jyYQD3088hNAkmxJLyvJOLX2ef/v09gGzb/q6hauPMie2R2kWS4wduew65xaEHAmAePilPdaePXrtRNHHVlQsTk8Nbdzc8G60K/QLnpUypkOTC1rgc42A3Ybun0h3Xn6z2/wHzuf4Hs/nm1gAAAABJRU5ErkJggg==)\n![maven](https://img.shields.io/badge/Maven-C71A36?style=for-the-badge\u0026logo=apache-maven)\n![postgres](https://img.shields.io/badge/postgres-%23316192.svg?\u0026style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n![swagger](https://img.shields.io/badge/swagger-%2385EA2D.svg?\u0026style=for-the-badge\u0026logo=swagger\u0026logoColor=white)\n![docker](https://img.shields.io/badge/docker-%232496ED.svg?\u0026style=for-the-badge\u0026logo=docker\u0026logoColor=white)\n![postman](https://img.shields.io/badge/Postman-FF6C37?style=for-the-badge\u0026logo=Postman\u0026logoColor=white)\n\n* Spring\n    * Spring Boot 2.7.1\n    * Spring Data JPA\n    * Spring Boot Starter Validation\n* JUnit 5\n* PostgreSQL 14\n* ModelMapper\n* Swagger\n    * Springdoc\n    * Swagger Annotations\n* Docker\n  * docker-compose (PostgreSQL14 + Spring Boot)\n* Postman\n* StarUML\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyawkar%2Fmarvel-catalog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyawkar%2Fmarvel-catalog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyawkar%2Fmarvel-catalog/lists"}