{"id":28371269,"url":"https://github.com/Dance-reservation-system/Reservation-system","last_synced_at":"2025-06-24T22:31:23.614Z","repository":{"id":296065608,"uuid":"989303710","full_name":"Dance-reservation-system/Reservation-system","owner":"Dance-reservation-system","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-22T13:20:11.000Z","size":703,"stargazers_count":3,"open_issues_count":15,"forks_count":2,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-06-22T14:29:19.961Z","etag":null,"topics":["docker-compose","hibernate","java-21","jwt","open-source","postgres","railway-app","release-automation","spring-boot-3","spring-security"],"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/Dance-reservation-system.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,"zenodo":null}},"created_at":"2025-05-23T20:54:50.000Z","updated_at":"2025-06-20T22:21:52.000Z","dependencies_parsed_at":"2025-06-15T00:21:22.350Z","dependency_job_id":"1b077f6f-df77-40f4-8854-8090bf006e59","html_url":"https://github.com/Dance-reservation-system/Reservation-system","commit_stats":null,"previous_names":["dance-reservation-system/kamann-modular","dance-reservation-system/reservation-system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Dance-reservation-system/Reservation-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dance-reservation-system%2FReservation-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dance-reservation-system%2FReservation-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dance-reservation-system%2FReservation-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dance-reservation-system%2FReservation-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dance-reservation-system","download_url":"https://codeload.github.com/Dance-reservation-system/Reservation-system/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dance-reservation-system%2FReservation-system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261766632,"owners_count":23206662,"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-compose","hibernate","java-21","jwt","open-source","postgres","railway-app","release-automation","spring-boot-3","spring-security"],"created_at":"2025-05-29T08:09:28.675Z","updated_at":"2025-06-24T22:31:23.605Z","avatar_url":"https://github.com/Dance-reservation-system.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💃 Reservation System - Backend\n\nA modern reservation system **engineered with Domain-Driven Design (DDD) and Clean Architecture** powered by **Java 21** and **Spring Boot 3**, featuring RBAC + ABAC, membership management, class scheduling, and many more.\n\n[![Last Commit](https://img.shields.io/github/last-commit/Dance-reservation-system/Reservation-system?style=flat-square\u0026color=green\u0026logo=github)](https://github.com/Dance-reservation-system/Reservation-system/commits)\n[![Open Issues](https://img.shields.io/github/issues/Dance-reservation-system/Reservation-system?style=flat-square\u0026logo=github)](https://github.com/Dance-reservation-system/Reservation-system/issues)\n[![Open PRs](https://img.shields.io/github/issues-pr/Dance-reservation-system/Reservation-system?style=flat-square\u0026logo=github)](https://github.com/Dance-reservation-system/Reservation-system/pulls)\n[![BE Contributors](https://img.shields.io/github/contributors/Dance-reservation-system/Reservation-system?style=flat-square\u0026color=green\u0026label=BE%20Contributors\u0026logo=github)](https://github.com/Dance-reservation-system/Reservation-system/graphs/contributors)\n[![FE Contributors](https://img.shields.io/github/contributors/Dance-reservation-system/Kamann-web?style=flat-square\u0026color=blue\u0026label=FE%20Contributors\u0026logo=github)](https://github.com/Dance-reservation-system/Kamann-web/graphs/contributors)\n\n\n## ⚙️ Tech Stack\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand full stack\u003c/summary\u003e\n\n### Core\n![Java](https://img.shields.io/badge/Java-21-007396?style=flat-square\u0026logo=openjdk\u0026logoColor=white)\n![Spring Boot](https://img.shields.io/badge/Spring_Boot-3.5.0-6DB33F?style=flat-square\u0026logo=springboot\u0026logoColor=white)\n![Maven](https://img.shields.io/badge/Maven-3.9-C71A36?style=flat-square\u0026logo=apachemaven\u0026logoColor=white)\n\n### Architecture\n![DDD](https://img.shields.io/badge/DDD-Domain--Driven--Design-blueviolet?style=flat-square)\n![Clean Architecture](https://img.shields.io/badge/Architecture-Clean-lightgrey?style=flat-square)\n\n### DB + Migration\n![PostgreSQL](https://img.shields.io/badge/PostgreSQL-16-4169E1?style=flat-square\u0026logo=postgresql\u0026logoColor=white)\n![Flyway](https://img.shields.io/badge/Flyway-10.13.0-CC0200?style=flat-square\u0026logo=flyway\u0026logoColor=white)\n\n### Security \u0026 Access\n![Keycloak](https://img.shields.io/badge/Keycloak-IdP_Authz_Identity-0075A8?style=flat-square\u0026logo=keycloak\u0026logoColor=white)\n![OAuth2](https://img.shields.io/badge/OAuth2-Enabled-orange?style=flat-square\u0026logo=oauth)\n![OpenID](https://img.shields.io/badge/OpenID%20Connect-Supported-orange?style=flat-square\u0026logo=openid)\n![JWT](https://img.shields.io/badge/JWT-Authorization-000000?style=flat-square\u0026logo=jsonwebtokens\u0026logoColor=white)\n\n### Docs \u0026 DevOps\n![Swagger](https://img.shields.io/badge/OpenAPI-3.0-6BA539?style=flat-square\u0026logo=swagger\u0026logoColor=black)\n![CI/CD](https://img.shields.io/badge/GitHub_Actions-CI%2FCD-2088FF?style=flat-square\u0026logo=githubactions\u0026logoColor=white)\n![Railway](https://img.shields.io/badge/Deployed%20to-Railway-0B0D0E?style=flat-square\u0026logo=railway\u0026logoColor=white)\n\n\u003c/details\u003e\n\n---\n\n## 🌟 Features\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to view role-specific features\u003c/summary\u003e\n\n### 🛡️ Owner\n- Manage user accounts (create, update, deactivate, assign roles)\n- Configure studio settings (business hours, cancellation policy, contact info)\n- Manage rooms (create, deactivate, assign to sessions)\n- Define membership card types (entry limits, expiration rules)\n- View schedule of all sessions and generate attendance reports\n- Override or delete sessions (even if booked)\n\n### 🧾 Receptionist\n- View today’s session list with instructor, room, and number of bookings\n- Assign or change rooms for upcoming sessions (if available)\n- Cancel sessions according to policy\n- Verify client membership card validity at check-in\n- Search for clients and manage their reservations on request\n- Mark a session as “in progress” when it starts\n\n### 🕺 Instructor\n- Create class sessions with title, type, date, time, duration, and hall assigned\n- Edit upcoming sessions (start time, capacity, room)\n- Cancel own sessions if no clients are registered\n- View personal teaching schedule\n\n### 💃 Client\n- Browse upcoming sessions with filters (instructor, type, date)\n- Reserve a session if a valid membership card is held\n- Cancel reservations before the allowed deadline\n- Receive booking confirmations and expiration alerts\n- View full history of past and upcoming reservations\n\n\u003c/details\u003e\n\n---\n\n## 🚀 Installation\n\n### 1. Clone Repository and Change into the project directory\n  ```bash\n  git clone https://github.com/Dance-reservation-system/Reservation-system.git\n  cd Reservation-system\n  ```\n\n### See detailed environment setup instructions:\nSee [Keycloak Setup Guide](./docs/keycloak/manual-client-secret-setup.md)\n\n### See contribution guidelines:\nSee [Contribution Guide](./docs/contribution-en.md)\n\n### 2. Create the .env file out of .env-example\n```bash\n  mv .env-example .env\n```\n\n### 3. Containers Setup (App + PostgreSQL 16)\nThe containers contains:\n- java application\n- postgresql database\n\nwhich means there is no need to setup anything more\n\n```bash\ndocker compose up -d --build\n```\n\n## 📚 API Documentation\n  Access interactive Swagger UI at:\n  **http://localhost:8080/swagger-ui.html**\n\n####  Registration Endpoint:\n  **POST /api/v1/auth/register-customer** (requires confirm email)\n  \n  **POST /api/v1/auth/register-instructor** (requires admin confirmation)\n  \n  Request Body (using RegisterRequest):\n```json\n{\n  \"email\": \"customer@example.com\",\n  \"password\": \"password\",\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"phone\": 123456789\n}\n```\n  \n####  Authorization: \n  Use JWT token from\n  **POST /api/v1/auth/login**\n  \n  Request Body:\n  ```json\n  {\n  \"email\": \"customer@example.com\",\n  \"password\": \"password\"\n  }\n```\n\n\n### 🚦 CI/CD Pipeline\n  - Integration testing with H2 in-memory database (GithubActions Workflow)\n  - Production deploys via Railway (Dedicated release branch)\n  - Production secrets managed through GitHub Secrets + Railway Secrets\n  \n\n### 🖥️ Frontend\n  Client available at:\n**[https://github.com/Dance-reservation-system/Kamann-web](https://github.com/Dance-reservation-system/Kamann-web)**\n\n### 📝 Ideas\n\n🎫 Membership expiration reminders\n\n🕒 Schedule conflict detection\n\n📊 PDF report generation\n\n📧 SMTP integration for notifications\n\n📈 Prometheus/Grafana monitoring\n\n🔍 Query performance optimization\n\n### 📜 License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDance-reservation-system%2FReservation-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDance-reservation-system%2FReservation-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDance-reservation-system%2FReservation-system/lists"}