{"id":26358215,"url":"https://github.com/danielgarcia85/reservecut","last_synced_at":"2026-04-12T20:38:37.232Z","repository":{"id":242947224,"uuid":"811005930","full_name":"DanielGarcia85/ReserveCut","owner":"DanielGarcia85","description":"School project showcasing full-stack development skills: Laravel (PHP) backend with REST API, MySQL database, and a C# frontend built in Visual Studio.","archived":false,"fork":false,"pushed_at":"2025-03-13T11:20:26.000Z","size":86610,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-13T12:28:31.196Z","etag":null,"topics":["c-sharp","laravel","laravel-framework","mysql","mysql-database","php8","rest","rest-api","restful-api","visual-studio"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/DanielGarcia85.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-06-05T19:02:11.000Z","updated_at":"2025-03-13T11:20:32.000Z","dependencies_parsed_at":"2025-03-13T12:33:57.187Z","dependency_job_id":null,"html_url":"https://github.com/DanielGarcia85/ReserveCut","commit_stats":null,"previous_names":["danidan85/reservecut","danielgarcia85/reservecut"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanielGarcia85%2FReserveCut","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanielGarcia85%2FReserveCut/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanielGarcia85%2FReserveCut/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DanielGarcia85%2FReserveCut/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DanielGarcia85","download_url":"https://codeload.github.com/DanielGarcia85/ReserveCut/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243878529,"owners_count":20362447,"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":["c-sharp","laravel","laravel-framework","mysql","mysql-database","php8","rest","rest-api","restful-api","visual-studio"],"created_at":"2025-03-16T14:19:47.611Z","updated_at":"2026-04-12T20:38:32.181Z","avatar_url":"https://github.com/DanielGarcia85.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ReserveCut\r\n\r\n**ReserveCut** is a reservation and management application designed for hair salons and barbershops, developed as part of the ***62-41 Architecture*** course at **Haute École de Gestion (HEG)**. This project combines a robust **PHP** backend built with **Laravel** and an interactive **C#** frontend developed in **Visual Studio**.\r\n\r\n## Features\r\n\r\n- 📅 Appointment Management : Schedule, modify, and cancel reservations.\r\n- 👤 Customer Database : Store client details and preferences.\r\n- 💇 Haircut \u0026 Service Catalog : List available haircuts, pricing, and specifications.\r\n- ✂️ Barber \u0026 Specialization Management : Assign barbers based on expertise.\r\n- 🔐 User Role \u0026 Access Management – Different user roles with access control for managing reservations, customers, and services.\r\n\r\n## Project Structure\r\n\r\nThe project is organized into several folders, reflecting the different development stages:\r\n\r\n- **0.Rendu/** : Contains the five milestones submitted to the professor:\r\n- **1.Flyer/** : Initial idea presented as a promotional flyer.\r\n- **2.Logo_Image/** : Logos and images associated with the project.\r\n- **3.SQL/** : Database modeling and SQL scripts.\r\n- **4.VisualStudio/** : Horizontal prototype developed in Visual Studio, containing all application windows.\r\n- **5.Laravel/** : Fully developed backend in PHP using the Laravel framework.\r\n\r\n## Prerequisites\r\n\r\nBefore starting, ensure you have installed:\r\n\r\n- **PHP 8.2 or later**: [Download here](https://www.php.net/downloads)\r\n- **Composer**: [Download here](https://getcomposer.org/download/)\r\n- **Laravel 8.x**: [Installation guide](https://laravel.com/docs/8.x/installation)\r\n- **MySQL 10.4 (MariaDB recommended)**: [Download here](https://dev.mysql.com/downloads/)\r\n- **Visual Studio 2022**: [Download here](https://visualstudio.microsoft.com/downloads/)\r\n- **.NET Framework 7.0.102 or later**: [Download here](https://dotnet.microsoft.com/download/dotnet-framework)\r\n\r\n## Installation\r\n\r\n### Database Setup (MySQL)\r\n\r\n1. **Start MySQL** and open **phpMyAdmin** (`http://localhost/phpmyadmin`).\r\n2. **Create the database** manually or execute the provided script:\r\n   - Import the SQL file located in `3.SQL/DanielGarcia_ReserveCut_MPD_DataBase.sql`.\r\n   - Alternatively, in MySQL, run:\r\n     ```sql\r\n     SOURCE path/to//DanielGarcia_ReserveCut_MPD_DataBase.sql;\r\n     ```\r\n   - Make sure the database name matches the one in your Laravel `.env` file\r\n\r\n### Backend (Laravel)\r\n\r\n1. **Clone the repository**:\r\n   ```shell\r\n   git clone https://github.com/DanielGarcia85/ReserveCut.git\r\n   cd ReserveCut/5.Laravel/reserveCut\r\n   ```\r\n2. **Install depenencies**:\r\n   ```shell\r\n   composer install\r\n   ```\r\n3. Set up environnement\r\n   - Copy the .env.example file to .env\r\n   ```shell\r\n   cp .env.example .env\r\n   ```\r\n   - Generate the application key:\r\n   ```shell\r\n   php artisan key:generate\r\n   ```\r\n   - Configure database settings in the .env file.\r\n4. Migrate the database\r\n   ```shell\r\n   php artisan migrate\r\n   ```\r\n5. Start the development server\r\n   ```shell\r\n   php artisan serve\r\n   ```\r\n\r\n### Frontend (Visual Studio)\r\n\r\n1. Open the project:\r\n   - Launch **Visual Studio**.\r\n   - Open the solution file located in *4.VisualStudio\\source\\repos\\ReserveCut\\ReserveCut.sln*.\r\n3. Restore NuGet packages:\r\n   - Right-click on the solution in **Solution Explorer**.\r\n   - Select *Restore NuGet Packages*.\r\n5. Configure backend connection:\r\n   - Open the appropriate configuration file.\r\n   - Ensure the API URL points to the Laravel backend.\r\n7. Run the application\r\n   - Click *Start* or press F5.\r\n\r\n### Project Status\r\n- **Backend Laravel** : 100% completed\r\n- **Frontend Visual Studio** : 70% completed. Some features are still unde development. The UI is completly finished.\r\n\r\n### Usage\r\n\r\nSince the project is not yet fully completed, there is currently no standalone executable file (.exe, .dmg, etc.). To test the application, launch the frontend directly from Visual Studio in debug mode, allowing it to interact with the running Laravel backend.\r\n\r\n### Useful Resources\r\n\r\n- Laravel Documentation: https://laravel.com/docs/8.x\r\n- Visual Studio Documentation: https://docs.microsoft.com/en-us/visualstudio/\r\n- .NET Framework Documentation: https://docs.microsoft.com/en-us/dotnet/framework/\r\n\r\n## License\r\nThis project is licensed under the *Creative Commons Attribution-ShareAlike (CC BY-SA)* license.\r\n\r\n### Author\r\nProject created by **Daniel Garcia** as part of the ***62-41 Architecture*** course at **Haute École de Gestion (HEG)** during the Spring semester of 2024.\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielgarcia85%2Freservecut","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielgarcia85%2Freservecut","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielgarcia85%2Freservecut/lists"}