{"id":15068816,"url":"https://github.com/fedorovychh/air-companies-manager","last_synced_at":"2026-01-03T16:03:53.368Z","repository":{"id":230386918,"uuid":"778165180","full_name":"fedorovychh/air-companies-manager","owner":"fedorovychh","description":"Back-end project for managing air companies, airplanes and flights. Using Java 11 and Spring Boot 2.2.","archived":false,"fork":false,"pushed_at":"2024-04-01T12:33:26.000Z","size":229,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-22T21:22:05.258Z","etag":null,"topics":["docker","java11","mysql","spring-boot"],"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/fedorovychh.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-27T07:50:30.000Z","updated_at":"2024-03-29T16:43:50.000Z","dependencies_parsed_at":"2024-04-01T13:48:30.729Z","dependency_job_id":null,"html_url":"https://github.com/fedorovychh/air-companies-manager","commit_stats":null,"previous_names":["fedorovychh/air-companies-manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedorovychh%2Fair-companies-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedorovychh%2Fair-companies-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedorovychh%2Fair-companies-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fedorovychh%2Fair-companies-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fedorovychh","download_url":"https://codeload.github.com/fedorovychh/air-companies-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243847056,"owners_count":20357317,"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":["docker","java11","mysql","spring-boot"],"created_at":"2024-09-25T01:39:22.485Z","updated_at":"2026-01-03T16:03:53.346Z","avatar_url":"https://github.com/fedorovychh.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Air Companies Management API\n\nA project to comfortable managing many Air Companies, airplanes and flights.\nYou can create companies, operate information about them, move airplanes between companies, monitor expired or overdue flights and so on.\n\n## Demo\n\n[Video: how to run and test Air Companies Management API?](https://youtu.be/A4GtEhIhfSo)\n\n### Swagger UI\n\n![Swagger-UI](images/swagger-ui.png)\n\n### Postman Collection\n\n![Postman-Collection](images/postman-collection.png)\n\n## Tech Stack\n\nTechnologies that are used to create an efficient and well-organized environment for the development and management of the Air Companies Management API.\n\n- **Java 11**\n\n- **Spring Boot 2.2**\n\n- **Spring Data JPA**\n\n- **Mapstruct**\n\n- **Lombok**\n\n- **MySQL**\n\n- **Docker**\n\n- **Maven**\n\n## How to run?\n\n**This API requires JDK 11 and Docker!!!**\n\nIf you don't have installed Java 11 or Docker, download it and install: \n\n- Link to download JDK: [Java 11](https://www.oracle.com/cis/java/technologies/javase/jdk11-archive-downloads.html)\n\n- Link to download Docker: [Docker](https://docs.docker.com/desktop/install/windows-install/)\n\nIf you want to run locally this API, you'll need MySQL:\n\n- Linl to download MySQL: [MySQL](https://dev.mysql.com/downloads/mysql/)\n\n1. Clone the project\n\n```\n$ git clone https://github.com/fedorovychh/air-companies-manager.git\n```\n2. Start your Docker\n3. Open API in Inteliji IDEA\n4. Open resources folder and find an application.properties file. Then specify your MySQL DB password (if you want to run application locally).\n```\nspring.datasource.password=${DB_PASSWORD}\n```\n\n5. Open .env file in root folder and specify your MySQL DB password.\n\n```\nMYSQLDB_ROOT_PASSWORD=root\n```\n\n6. Run following terminal commands:\n```\nmvn clean package\n```\nThis project is build on maven, so this command deletes target/ folder and creates .jar file, that is necessary for Docker.\n```\ndocker-compose build\ndocker-compose up\n```\nThese commands create image and run docker container.\n\nWait until next message will be shown:\n```\nStarted AirCompaniesManagerApplication in 20 seconds\n```\n\n7. Open browser and follow address: http://localhost:8088/api/swagger-ui.html\n\nSwagger UI added to demonstrate what endpoints does API contain.\n\n**To test API properly, please use this [Postman Collection](https://www.postman.com/spaceflight-architect-34290083/workspace/public-workspace/api/3d017b1a-8a36-4ff0-9c24-1aa68bd4606d).**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedorovychh%2Fair-companies-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffedorovychh%2Fair-companies-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffedorovychh%2Fair-companies-manager/lists"}