{"id":15095990,"url":"https://github.com/hmzelidrissi/hotel-reservation-system-api","last_synced_at":"2026-01-06T19:03:38.227Z","repository":{"id":243531506,"uuid":"802281821","full_name":"HMZElidrissi/hotel-reservation-system-api","owner":"HMZElidrissi","description":"This is a simple hotel reservation system backend API. It is built using the Gin web framework and MongoDB as the database. The API provides endpoints for customers to book rooms and get reservations, and for admins to manage rooms and reservations. The API also provides authentication and authorization using JWT tokens.","archived":false,"fork":false,"pushed_at":"2024-06-09T14:48:25.000Z","size":8260,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T17:44:19.286Z","etag":null,"topics":["gin-framework","gin-gonic","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","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/HMZElidrissi.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,"publiccode":null,"codemeta":null}},"created_at":"2024-05-17T22:21:10.000Z","updated_at":"2024-12-12T17:57:01.000Z","dependencies_parsed_at":"2024-06-09T17:26:47.386Z","dependency_job_id":null,"html_url":"https://github.com/HMZElidrissi/hotel-reservation-system-api","commit_stats":null,"previous_names":["hmzelidrissi/hotel-reservation-system-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMZElidrissi%2Fhotel-reservation-system-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMZElidrissi%2Fhotel-reservation-system-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMZElidrissi%2Fhotel-reservation-system-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HMZElidrissi%2Fhotel-reservation-system-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HMZElidrissi","download_url":"https://codeload.github.com/HMZElidrissi/hotel-reservation-system-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245852743,"owners_count":20683085,"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":["gin-framework","gin-gonic","go","golang"],"created_at":"2024-09-25T15:44:36.592Z","updated_at":"2026-01-06T19:03:33.196Z","avatar_url":"https://github.com/HMZElidrissi.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hotel reservation backend\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- customers -\u003e book rooms, get reservations\n- admins -\u003e manage rooms and reservations\n- Authentication and authorization -\u003e JWT tokens\n- Rooms -\u003e CRUD API -\u003e JSON\n- Reservations -\u003e CRUD API -\u003e JSON\n- Scripts -\u003e database management -\u003e seeding, migration\n\n## Installation\n\n- Clone the repository: `git clone https://github.com/HMZElidrissi/hotel-reservation-system-api.git`\n- Define the environment variables in a `.env` file: `cp .env.example .env`\n- Run `make deps` to install dependencies\n- Run `make run` to start the server\n- To run tests, run `make test`\n\n## Technologies Used\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### Gin Web Framework\nDocumentation\n```\nhttps://gin-gonic.com\n```\n\nInstalling gin\n```\ngo get github.com/gin-gonic/gin\n```\n\n## To DO\n\n- [x] Test Customer handlers\n- [ ] Test Admin reservation handlers\n- [ ] Test Admin room handlers\n- [ ] Scripts -\u003e database management -\u003e seeding, migration\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmzelidrissi%2Fhotel-reservation-system-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmzelidrissi%2Fhotel-reservation-system-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmzelidrissi%2Fhotel-reservation-system-api/lists"}