{"id":26948762,"url":"https://github.com/prakhar-code/v-book","last_synced_at":"2025-04-02T21:33:38.759Z","repository":{"id":277559328,"uuid":"932267635","full_name":"Prakhar-code/v-Book","owner":"Prakhar-code","description":"A full fledge cabin booking system designed for corporates, where the employees can book cabins in there respective workplace for different purposes !","archived":false,"fork":false,"pushed_at":"2025-03-09T08:52:50.000Z","size":975,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T09:26:51.990Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/Prakhar-code.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":"2025-02-13T16:34:20.000Z","updated_at":"2025-03-09T08:52:54.000Z","dependencies_parsed_at":"2025-03-09T09:24:04.923Z","dependency_job_id":"7181d335-6bd4-45ee-bb78-99ae72149dc5","html_url":"https://github.com/Prakhar-code/v-Book","commit_stats":null,"previous_names":["prakhar-code/v-book"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prakhar-code%2Fv-Book","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prakhar-code%2Fv-Book/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prakhar-code%2Fv-Book/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prakhar-code%2Fv-Book/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Prakhar-code","download_url":"https://codeload.github.com/Prakhar-code/v-Book/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246896529,"owners_count":20851456,"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":[],"created_at":"2025-04-02T21:33:37.492Z","updated_at":"2025-04-02T21:33:38.744Z","avatar_url":"https://github.com/Prakhar-code.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# v-Book 📚🏢\n\n**v-Book** is a full-fledged cabin booking system designed to simplify corporate planning and make booking meeting or working spaces seamless and hassle-free. With a smooth and user-friendly interface, **v-Book** lets users securely book cabins, manage their reservations, and leave reviews to assist fellow colleagues in making informed decisions. The system is built using **FastAPI** for the backend and **ReactJS**, **HTML**, and **CSS** for the frontend.\n\n## Features 🛠️\n\n- **User Registration and Login**: \n  - Secure authentication for users to create accounts, log in, and manage their profiles.\n  \n- **Cabin Listings**: \n  - Browse through available cabins with detailed descriptions, capacity, amenities, and availability.\n  \n- **Booking Management**: \n  - Easy booking process with real-time availability checks to avoid conflicts.\n\n- **Reviews and Ratings**: \n  - Leave reviews and ratings for cabins to help colleagues make informed decisions about their bookings.\n\n- **Admin Dashboard**: \n  - Manage cabin listings, monitor bookings, and control user accounts with an intuitive dashboard for administrators.\n\n## 🛠️ Installation\n\n### Prerequisites\n\n- **Python** (for FastAPI backend)\n- **Node.js** (for ReactJS frontend)\n- **npm** (for managing frontend dependencies)\n\n### Step 1: Set up the Backend (FastAPI)\n\n1. Clone the repository:\n\n   ```bash\n   git clone git clone https://github.com/Prakhar-code/v-Book.git\n   cd v-Book/backend\n   ```\n\n2. Install the required Python dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Run the FastAPI server:\n\n   ```bash\n   uvicorn app.run:app --reload\n   ```\n\n4. The backend should now be running on `http://localhost:8000`.\n\n### Step 2: Set up the Frontend (ReactJS)\n\n1. Navigate to the frontend directory:\n\n   ```bash\n   cd /frontend/frontend-vbook\n   ```\n\n2. Install the required npm dependencies:\n\n   ```bash\n   npm install\n   ```\n\n3. Start the React development server:\n\n   ```bash\n   npm start\n   ```\n\n4. The frontend should now be accessible at `http://localhost:3000`.\n\n### Step 3: Configuration (Optional)\n\nYou can configure various aspects of the system by editing the configuration files for the backend and frontend. This includes modifying the cabin types, booking rules, and user roles.\n\n## 📝 Usage\n\n### 1. **User Registration and Login**\n   - **Sign Up**: New users can register by providing basic information like email, password, and company details.\n   - **Log In**: Returning users can securely log in with their credentials.\n\n### 2. **Cabin Listings**\n   - Users can browse through a variety of cabins available for booking. Each listing includes details such as:\n     - Cabin Name\n     - Capacity\n     - Available Amenities\n     - Availability Status\n     - Cabin Description\n\n### 3. **Booking a Cabin**\n   - Select a cabin from the listings and choose your desired date and time.\n   - The system performs a real-time check for availability.\n   - Once confirmed, users can finalize the booking with a single click.\n\n### 4. **Leaving Reviews and Ratings**\n   - After using a cabin, users can leave feedback in the form of reviews and ratings to help other colleagues make informed booking decisions.\n\n### 5. **Admin Dashboard**\n   - Admin users can access the dashboard to:\n     - Add or remove cabins.\n     - View and manage all bookings.\n     - Manage user accounts and permissions.\n\n## 💡 Why Use v-Book?\n\n- **Streamlined Corporate Planning**: Makes cabin booking for meetings or workspaces easy and organized, reducing scheduling conflicts.\n- **Real-Time Availability**: Avoid double-bookings with automatic availability checks.\n- **Transparency Through Reviews**: User reviews and ratings ensure that colleagues can make informed decisions based on firsthand experiences.\n- **Admin Control**: Full control over cabin listings, bookings, and user management.\n\n## ⚡ Contributing\n\nWe welcome contributions to v-Book! If you'd like to help improve the project, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/your-feature-name`).\n3. Make your changes and commit them (`git commit -am 'Add new feature'`).\n4. Push to your branch (`git push origin feature/your-feature-name`).\n5. Open a pull request with a clear description of your changes.\n\n\n---\n\nThis README provides an overview of the project, its installation process, usage instructions, and contributing guidelines. You can modify or extend any section to fit your project better!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprakhar-code%2Fv-book","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprakhar-code%2Fv-book","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprakhar-code%2Fv-book/lists"}