Overview

Introduction

Jeydoo is a web application originally developed in 2013 for managing employee billing in fitness centers. The initial development was based on Ruby on Rails with a MySQL database. Over the years, the software has undergone multiple adaptations, but it has since become outdated from a technical standpoint and is now ready for a complete overhaul.

The following documentation redefines and details all the core modules to serve as the foundation for developing Jeydoo 2.0—a modern, state-of-the-art system designed to be scalable and adaptable for future distribution to other clients.

What does Jeydoo do?

Payroll Accounting in Fitness Centers: The Challenge

Payroll accounting for employees in fitness centers is often a significant challenge for center operators. One major reason is the large and diverse workforce. With long opening hours and typically multi-shift operations, fitness centers employ not only permanent staff but also a high number of temporary and part-time employees.

Additionally, it is common practice for employees to receive financial incentives through commissions or bonuses tied to the success and growth of membership numbers. These commissions can take various forms, adding another layer of complexity to payroll calculations. Legal requirements and compliance regulations further increase this complexity.

Another challenge lies in managing contractually agreed working hours versus actual working hours, which are often used as factors in calculating both salaries and commissions.

To manage all these variables effectively, a software solution must be highly flexible and configurable. This is precisely what Jeydoo is designed to do.

To ensure flexibility and accuracy in calculations, Jeydoo is built on a modular architecture, with all core functions organized into the following areas:

Core Functions:

1. Time Booking
   

2. Admin & Settings
   

3. Interface API
   

4. Master Data
   

5. Specifications
   

6. Transaction Data
   

7. Settlement
   

8. Dialogs
   

9. Reports

10. Background Jobs
    

Definitions & abbreviations

Terms and abbreviations are defined below in order to use standardized wording and avoid misunderstandings.

1. Areas

Parts of the software that contain one or more modules. Areas have no function and are mainly used in the navigation as a grouping for a better overview.

2. Modules

Modules are individual functions of the software for recording and processing master data, specifications, transaction data and more.

3. Employees

Salaried employees are persons permanently employed by a company with a contractually regulated employment relationship, usually full-time or part-time. They receive a regular salary and are entitled to social benefits such as vacation, sick pay and social insurance.

3. Mini-jobbers 

Mini-jobbers are employees who are employed on a short-term or marginal basis to support the company as required. They often work on an hourly basis, e.g. as mini-jobbers, and usually have no long-term commitment to the company.

In the context of payroll accounting, salaried employees and mini-jobbers are calculated separately, as they are subject to different labor law regulations and accounting modalities.

AZK = Working time account (in our context an annual working time account)

FAZ = Working time factor (described in detail below)