Skip to content

KerimSikalo/GymDeskApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

124 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ’ช GymDeskApp

Complete Fitness Center Management System

.NET C# SQL Server Live Demo University Project License


๐ŸŽฏ Project Overview

GymDeskApp is a comprehensive fitness center management system designed to digitize and streamline all gym operations. Built as part of an Object-Oriented Analysis and Design course, this enterprise-grade application manages memberships, training sessions, meal planning, e-commerce, and staff recruitment through a unified platform.

"Transforming fitness center management through digital innovation"

๐ŸŒŸ Why GymDeskApp?

  • Complete Solution: All-in-one platform for gym operations
  • Role-Based Access: Secure, hierarchical permission system
  • Real-Time Management: Live session booking and availability tracking
  • E-Commerce Integration: Built-in fan shop with fiscal receipts
  • Academic Excellence: University-grade software engineering project

๐Ÿš€ Key Features

๐Ÿ‹๏ธ Training Management

Feature Description User Roles
Individual Training One-on-one sessions with trainers Admin, Trainer, User
Group Training Multi-participant fitness classes Admin, Trainer, User
Session Booking Real-time availability and reservations All Users
Resource Tracking Equipment and facility management Admin, Trainer

๐Ÿ‘ฅ User & Staff Management

  • Multi-Role System: Admin, Trainer, Receptionist, User
  • Membership Registration: Complete user profile creation
  • Staff Recruitment: Online job applications and employee archiving
  • Access Control: Secure, role-based permissions

๐ŸŽ Nutrition & Wellness

  • Personalized Meal Plans: AI-generated nutrition based on user data
  • Dietary Preferences: Customizable meal recommendations
  • Health Tracking: Integration with fitness goals

๐Ÿ›’ E-Commerce Platform

  • Fan Shop: Gym merchandise and equipment sales
  • Fiscal Receipts: Automated email receipts for purchases
  • Inventory Management: Product catalog and stock tracking
  • Payment Processing: Secure transaction handling

โš™๏ธ Administrative Tools

  • Training Types Management: Create and update exercise programs
  • Schedule Management: Comprehensive calendar system
  • Reporting: Analytics and business intelligence
  • System Configuration: Flexible platform customization

๐Ÿ—๏ธ System Architecture

Technology Stack

Layer Technology Purpose
Backend .NET Core application framework
Language C# Primary development language
Database SQL Server Data persistence & management
Frontend ASP.NET Web interface framework
Deployment Web Hosting Cloud deployment platform

๐Ÿ›๏ธ Architecture Patterns

  • MVC Pattern: Model-View-Controller separation
  • Repository Pattern: Data access abstraction
  • Dependency Injection: Loose coupling and testability
  • Role-Based Security: Hierarchical access control
  • Entity Framework: Object-relational mapping

๐Ÿ” User Roles & Permissions

Role Permissions Key Responsibilities
๐Ÿ‘‘ Admin Full system control System configuration, user management, reports
๐Ÿƒ Trainer Training & nutrition management Session management, meal plans, fan shop
๐Ÿ“‹ Receptionist View & booking operations Session viewing, customer support
๐Ÿ‘ค User/Member Personal management Bookings, meal plans, shop purchases

๐ŸŒ Live Demo & Testing

๐Ÿ”— Access the Application

Live Demo: http://ksikalo1-001-site1.mtempurl.com/

๐Ÿ”‘ Test Credentials

Role Email Password
๐Ÿ‘‘ Admin samir@mail.com Samir1#
๐Ÿƒ Trainer hamza@mail.com Hamza1#
๐Ÿ“‹ Receptionist recepcioner@mail.coom Recepcioner1#
๐Ÿ‘ค User azra@mail.com Azra1#

๐Ÿ—„๏ธ Database Configuration

Server: SQL6032.site4now.net
Database: db_ab930a_ooad2025
Username: db_ab930a_ooad2025_admin
Password: OOADg2t4$
Test Login: 11244298 / 60-dayfreetrial

๐ŸŽ“ Academic Context

University: University of Sarajevo โ€“ Faculty of Electrical Engineering
Course: Object-Oriented Analysis and Design
Class Group: Group 2-RI
Academic Year: 2024/2025

๐Ÿ‘ฅ Development Team

Developer GitHub
Kerim ล ikalo @KerimSikalo
Azra Kovaฤ -
Faris Aljiฤ‡ -
Hamza Kovaฤ -

๐Ÿ› ๏ธ Installation & Setup

๐Ÿ“‹ Prerequisites

  • .NET 6.0 SDK or higher
  • SQL Server (Express or full version)
  • Visual Studio 2022 or Visual Studio Code
  • IIS Express (for local hosting)

๐Ÿ”ง Local Development Setup

  1. Clone the Repository

    git clone https://github.com/KerimSikalo/GymDeskApp.git
    cd GymDeskApp
  2. Database Configuration

    # Update connection string in appsettings.json
    "ConnectionStrings": {
      "DefaultConnection": "your-local-connection-string"
    }
  3. Install Dependencies

    dotnet restore
  4. Database Migration

    dotnet ef database update
  5. Run the Application

    dotnet run
  6. Access Locally

    https://localhost:5001
    http://localhost:5000
    

๐Ÿ“ฑ Application Workflows

๐Ÿ‹๏ธ For Gym Members

  1. Registration: Create account with personal information
  2. Browse Sessions: View available individual/group trainings
  3. Book Training: Reserve preferred time slots
  4. Meal Planning: Generate personalized nutrition plans
  5. Shop: Purchase gym merchandise from fan shop
  6. Track Progress: Monitor fitness journey and bookings

๐Ÿƒ For Trainers

  1. Session Management: Create and manage training sessions
  2. Member Support: Assist with workout planning
  3. Nutrition Planning: Generate custom meal plans
  4. Schedule Management: Organize daily training calendar
  5. Progress Tracking: Monitor member development

๐Ÿ‘‘ For Administrators

  1. System Overview: Monitor all platform activities
  2. User Management: Manage members, trainers, staff
  3. Financial Reports: Track revenue and sales analytics
  4. System Configuration: Customize platform settings
  5. Staff Recruitment: Manage job applications and hiring

๐Ÿ“Š System Performance

โšก Performance Metrics

  • Response Time: < 2 seconds for all operations
  • Uptime: 99%+ availability (24/7 operation)
  • Concurrent Users: Optimized for multi-user access
  • Database Performance: Indexed queries and optimization

๐Ÿ”’ Security Features

  • Data Encryption: All sensitive data encrypted
  • Role-Based Access: Hierarchical permission system
  • Secure Authentication: Password hashing and validation
  • SQL Injection Protection: Parameterized queries
  • Session Management: Secure user session handling

๐ŸŽฏ Core Functionalities

๐Ÿ“… Session Management (CRUD)

// Example: Create Training Session
public class TrainingSession {
    public int Id { get; set; }
    public string Name { get; set; }
    public DateTime StartTime { get; set; }
    public DateTime EndTime { get; set; }
    public int MaxParticipants { get; set; }
    public TrainingType Type { get; set; }
    public Trainer AssignedTrainer { get; set; }
}

๐ŸŽ Meal Plan Generation

  • Caloric needs calculation based on user metrics
  • Dietary restriction accommodation
  • Weekly meal scheduling
  • Nutritional balance optimization

๐Ÿ›’ E-Commerce Integration

  • Product catalog management
  • Shopping cart functionality
  • Secure payment processing
  • Automated fiscal receipt generation

๐Ÿ”ฎ Future Enhancements

๐Ÿ“ฑ Mobile Applications

  • Native iOS App - Complete mobile experience
  • Android Application - Cross-platform availability
  • Progressive Web App - Responsive mobile interface

๐Ÿค– AI & Analytics

  • AI Personal Trainer - Machine learning workout recommendations
  • Predictive Analytics - Member behavior insights
  • Smart Scheduling - Optimal session time suggestions
  • Health Monitoring - Wearable device integration

๐ŸŒ Platform Expansion

  • Multi-Gym Support - Chain management capabilities
  • API Development - Third-party integrations
  • Social Features - Member community platform
  • Video Streaming - Online training sessions

๐Ÿงช Testing & Quality

๐Ÿ”ฌ Testing Strategy

# Unit Tests
dotnet test --project Tests/GymDeskApp.UnitTests

# Integration Tests
dotnet test --project Tests/GymDeskApp.IntegrationTests

# Load Testing
dotnet test --project Tests/GymDeskApp.LoadTests

๐Ÿ“‹ Quality Metrics

  • Code Coverage: 85%+ test coverage target
  • Performance Testing: Load testing for concurrent users
  • Security Auditing: Regular vulnerability assessments
  • User Acceptance Testing: Real gym environment validation

๐Ÿค Contributing

This is an academic project, but contributions and suggestions are welcome for educational purposes!

๐Ÿ“ Academic Contributions

  • Code review and optimization suggestions
  • Documentation improvements
  • Feature enhancement ideas
  • Bug reports and fixes

๐ŸŽ“ Educational Value

This project demonstrates:

  • Enterprise Application Development
  • Object-Oriented Design Principles
  • Database Design and Management
  • Role-Based Security Implementation
  • Full-Stack Development Skills

๐Ÿ“š Documentation

๐Ÿ”— Additional Resources

  • System Design Document - Comprehensive architecture overview
  • Database Schema - Complete ERD and table structures
  • API Documentation - Endpoint specifications
  • User Manual - Complete user guide for all roles
  • Deployment Guide - Production setup instructions

๐Ÿ“– Academic Deliverables

  • Requirements Analysis - Functional and non-functional requirements
  • System Architecture - Technical design documentation
  • Testing Reports - Comprehensive QA documentation
  • Project Presentation - Academic presentation materials

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

Academic Use: This project is submitted as coursework for Object-Oriented Analysis and Design course.


๐Ÿ† Achievements & Recognition

  • โœ… Complete CRUD Operations for all entities
  • โœ… Role-Based Security implementation
  • โœ… Live Deployment with real-world hosting
  • โœ… E-Commerce Integration with fiscal compliance
  • โœ… Multi-User System supporting concurrent access
  • โœ… Professional UI/UX following modern design principles

๐Ÿ“ฌ Contact & Support

๐Ÿ‘จโ€๐Ÿ’ป Project Lead - Kerim ล ikalo

๐Ÿซ Academic Supervisor

  • Course: Object-Oriented Analysis and Design
  • Faculty: Faculty of Electrical Engineering
  • University: University of Sarajevo

Built with ๐Ÿ’ช and โ˜• by Team GymDesk

Digitizing fitness center management for the modern age

๐ŸŒ Live Demo

โญ Star this repo ๐Ÿด Fork this repo

๐Ÿ“ฑ Explore More Projects

About

Fitness center management system with user registration, workout plans, booking features and much more.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors