{"id":18576043,"url":"https://github.com/zacksff/hotel-reservation-backend","last_synced_at":"2025-10-03T22:59:31.108Z","repository":{"id":228687328,"uuid":"764599894","full_name":"zacksfF/Hotel-Reservation-Backend","owner":"zacksfF","description":"This project is a backend system for managing hotel reservations. It provides a comprehensive API for booking rooms, managing user accounts, and handling various hotel operations. The system is designed to be efficient, secure, and scalable, making it suitable for hotels of all sizes. 🧜🏻‍♂️","archived":false,"fork":false,"pushed_at":"2024-06-08T11:19:24.000Z","size":44,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-16T00:42:11.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zacksfF.png","metadata":{"files":{"readme":"README.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":"2024-02-28T11:24:52.000Z","updated_at":"2024-06-08T11:19:27.000Z","dependencies_parsed_at":"2024-03-25T02:25:34.624Z","dependency_job_id":"384abe03-762a-473f-89a2-ecea5feeee14","html_url":"https://github.com/zacksfF/Hotel-Reservation-Backend","commit_stats":null,"previous_names":["zacksff/hotel-reservation-backend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zacksfF/Hotel-Reservation-Backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zacksfF%2FHotel-Reservation-Backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zacksfF%2FHotel-Reservation-Backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zacksfF%2FHotel-Reservation-Backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zacksfF%2FHotel-Reservation-Backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zacksfF","download_url":"https://codeload.github.com/zacksfF/Hotel-Reservation-Backend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zacksfF%2FHotel-Reservation-Backend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278239972,"owners_count":25954098,"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","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-06T23:23:20.398Z","updated_at":"2025-10-03T22:59:31.055Z","avatar_url":"https://github.com/zacksfF.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hotel reservation backend @zacksfF\n\n## Business Problem\nIn the competitive hospitality industry, efficient and reliable management of hotel reservations is crucial for both customer satisfaction and operational success. Traditional reservation systems often suffer from scalability issues, limited flexibility, and difficulties in handling large volumes of concurrent users. Our Hotel Reservation Backend aims to address these challenges by leveraging modern technologies to provide a robust, scalable, and high-performance solution.\n\n## Features\n``This project contains the following features:``\n- Middleware integration.\n- User Authentication and Authorization: Secure login and registration system with JWT-based authentication.\n- Room Management: CRUD operations for hotel rooms, including availability status and room details.\n- Database support using MongoDB.\n- Reservation System: Endpoints for creating, updating, and canceling reservations, with validation to ensure room availability.\n- Search and Filter: Search for available rooms based on criteria such as date, room type, and price range.\n- Notifications: Email notifications for booking confirmations and reminders.\n- Distributed Logging and Tracing: Implementation of distributed logging and tracing to monitor and debug the application effectively.\n- Integration with OpenTelemetry: Enterprise-level observability with integration to OpenTelemetry for monitoring and tracing.\n- Testing patterns.\n- Use of Docker, Docker Compose, and Makefiles.\n- Github Actions Integration: Continuous Integration and Continuous Deployment (CI/CD) pipelines using CircleCI for automated testing, building, and deployment.\n\n\n\n## Project environment variables\n```\nHTTP_LISTEN_ADDRESS=:3000\nJWT_SECRET=somethingsupersecretthatNOBODYKNOWS\nMONGO_DB_NAME=hotel-reservation\nMONGO_DB_URL=mongodb://localhost:27017\nMONGO_DB_URL_TEST=mongodb://localhost:27017\n```\n\n## Project outline\n- users -\u003e book room from an hotel \n- admins -\u003e going to check reservation/bookings \n- Authentication and authorization -\u003e JWT tokens\n- Hotels -\u003e CRUD API -\u003e JSON\n- Rooms -\u003e CRUD API -\u003e JSON\n- Scripts -\u003e database management -\u003e seeding, migration\n\n## Requirements\n### Mongodb driver \nDocumentation\n```\nhttps://mongodb.com/docs/drivers/go/current/quick-start\n```\n\nInstalling mongodb client\n```\ngo get go.mongodb.org/mongo-driver/mongo\n```\n\n### gofiber \nDocumentation\n```\nhttps://gofiber.io\n```\n\nInstalling gofiber\n```\ngo get github.com/gofiber/fiber/v2\n```\n\n## Docker\n### Installing mongodb as a Docker container\n```\ndocker run --name mongodb -d mongo:latest -p 27017:27017\n```\n\n## Getting Started\nNB: Make sure to have docker and docker-compose installed and running. For docker installation\n```\ngit clone https://github.com/zacksfF/Hotel-Reservation-Backend.git\ncd Hotel-Reservation-Backend\ncode . #if you are uisng vscode\n```\n- Run the application:\n```\ngo run main.go\n```\n\n### Contributing\nContributions are welcome! Please fork the repository and create a pull request with your changes. Ensure your code follows the established style and includes appropriate tests.\n\n### License\nThis project is licensed under the MIT License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzacksff%2Fhotel-reservation-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzacksff%2Fhotel-reservation-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzacksff%2Fhotel-reservation-backend/lists"}