Skip to content

Latest commit

 

History

History
249 lines (173 loc) · 10.8 KB

Readme.md

File metadata and controls

249 lines (173 loc) · 10.8 KB
Sample screenshot

myOfficeX: Unser Ziel - Dein Komfort

Introduction

The Feedback App is an innovative web-based solution developed by myOfficeX to make offices more comfortable, energy-efficient, and cost-effective. This README provides an overview of the app, its purpose, and its features.

Significance

The Feedback App aims to tackle two major issues prevalent in office environments: comfort and energy efficiency. Studies reveal that a significant portion of office workers experience discomfort due to factors such as noise, unpleasant temperature, and inadequate air quality. Additionally, a substantial amount of energy is wasted in office buildings due to inefficiencies. By addressing these challenges, the Feedback App aims to create a more productive and sustainable work environment.

Methodology

The Feedback App utilizes a user-friendly interface that allows office workers to submit their feedback on various comfort factors such as noise, temperature, and air quality easily and anonymously. The app then analyzes the frequency and severity of the reported issues and creates a visualization. Thanks to this visualization, the employer or facility manager can quickly see if there are any comfort issues in the office that need to be addressed.

The elegance of this solution lies in its triple benefit for employers, as comfort issues always have implications for cost-effectiveness and energy efficiency. Here's an example: A malfunction in the heating, ventilation, and air conditioning system can result in employees feeling either too hot or too cold. This negatively impacts their productivity as they feel uncomfortable and struggle to concentrate. Additionally, the building's energy consumption increases unnecessarily as more energy is expended on heating or cooling than required. The heightened energy costs and reduced work performance have adverse effects on cost-effectiveness. Through the myOfficeX Feedback-App, such problems can be swiftly addressed, resulting in a more comfortable, energy-efficient, and cost-effective office environment.

In addition, a tips page is designed to provide office workers with valuable guidance and practical suggestions to improve their comfort and well-being in the workplace. It offers a range of helpful tips and strategies that can be easily implemented to create a more conducive and enjoyable work environment.

Result/Conclusion (myofficeX-Application)

The myOfficeX Feedback App has been developed as a comprehensive solution to address the challenges of office comfort, energy efficiency, and cost-effectiveness. By leveraging its user-friendly interface along its data analysis and visualization capabilities, the app offers significant benefits and outcomes for both office workers and employers.

Key benefits of the myOfficeX Feedback App include:

  • Enhanced Comfort and Productivity: Through the app's feedback submission feature, office workers can easily and anonymously report comfort-related issues such as noise, temperature, and air quality. By promptly addressing these concerns, employers can create a more comfortable and productive work environment, positively impacting employee satisfaction and performance.

  • Improved Energy Efficiency: The app's visualization feature allows employers to gain valuable insights into comfort issues within the office space. By identifying and resolving energy inefficiencies, such as heating and cooling malfunctions, unnecessary energy consumption can be reduced, resulting in cost savings and a more sustainable workplace.

  • Cost-Effectiveness: The myOfficeX Feedback App's triple benefit approach ensures that employers can address comfort issues while considering their impact on cost-effectiveness and energy efficiency. By efficiently resolving problems and optimizing office conditions, unnecessary expenses can be minimized, leading to better financial outcomes.

  • User Satisfaction and Engagement: The app's user-friendly design and anonymous feedback submission process promote transparency and encourage active participation from office workers. By providing a platform for employees to voice their concerns, employers can foster a culture of openness and continuous improvement, enhancing overall satisfaction and engagement.

In conclusion, the myOfficeX Feedback App offers a practical and effective solution for addressing office comfort, energy efficiency, and cost-effectiveness. With its intuitive interface, data-driven insights, and actionable recommendations, the app empowers employers to create a comfortable, sustainable, and financially viable work environment while prioritizing employee well-being and satisfaction.

Manual: How use the application

Manual for Office Workers

  1. To get started, visit the myOfficeX landing page at www.myofficex.ch.

  2. If you haven't registered yet:

    a) Click on the "Register" button in the navigation bar.

    b) Fill out the registration form with your preferred username, email address, password (confirming it as well), and the office code provided by myOfficeX. If you don't have an office code, please contact us at [email protected] for assistance. Once completed, submit the form to access the app.

  3. If you have already registered:

    a) Simply log in using your registered email and password.

  4. Once logged in, you can start using the app:

    a) Navigate to the Feedback page.

    b) Choose the specific zone on the office floor plan for which you want to provide feedback.

    c) Rate the current comfort level for the four feedback categories.

    d) Optionally, you can also provide additional comments via a text message.

  5. Explore the Tips page to access helpful guidance:

    a) Click on the "Tips" section in the navigation bar.

    b) Select the feedback category you are interested in by clicking the corresponding blue button. This will open a modal where you can find valuable tips and strategies.

Manual for Facility Managers/Employers

  1. Begin by visiting the myOfficeX landing page at www.myofficex.ch.

  2. If you haven't registered yet:

    a) Click on the "Register" button in the navigation bar.

    b) Complete the registration form by entering your desired username, email address, password (confirming it as well), and the office code provided by myOfficeX. If you don't have an office code, please contact us at [email protected] for further assistance. Once finished, submit the form to register as an office worker.

    c) To gain access to the facility manager/employer features, please get in touch with myOfficeX admins directly, either in person, over the phone, or via [email protected]. They will activate the additional functionalities for you.

  3. If you have already registered, simply log in using your email and password.

  4. Access the "Report" page to view feedback data:

    a) Specify the desired time range for the report, ensuring that start and end date are not the same.

    b) The feedback for each category will be displayed on the floor plan corresponding to that specific category.

  5. For more detailed information, refer to the accompanying table.

  6. To conclude your session, log out by selecting the designated option in the navigation bar associated with your username.

Setup from Github (LAMP / Docker-Sail)

Setup / Installation with LAMP Stack

Prerequisites

  • LAMP Stack (Linux/Apache/Mysql/Php) or XAMPP-setup (Windows)
  • Composer
  • PHP 8.1
  • Mysql or Mariadb Database

Setup LAMP

  • get github code for cloning
  • Open repository in editor of your choice
  • Open terminal
  • Start Database
    sudo systemctl start mariadb
  • Create Databse
    CREATE DATABASE <name database>;
  • Create User (these are the Env.variables afterwards)
    CREATE USER 'DB_USERNAME'@'localhost' IDENTIFIED BY 'DB_PASSWORD';
  • Grant user previleges
    GRANT ALL PRIVILEGES ON <name database>.* TO 'DB_USERNAME'@'localhost';
    FLUSH PRIVILEGES;
  • Install Node/NPM if needed
    npm install
    
  • If installed, update
    npm update 
    
  • Update Composer
    composer update 
    
  • If no composer, install guide (Ubuntu)*
  • Generate Key:
    php artisan key: generate
    
  • Run Database
    php artisan serve
    

* Get Composer

Setup / Installation Docker-Sail

  • get github code for cloning
  • Open repository in editor of your choice
  • Open terminal
  • Insert following code:
    docker run --rm \
        -u "$(id -u):$(id -g)" \
        -v $(pwd):/var/www/html \
        -w /var/www/html \
        laravelsail/php82-composer:latest \
        composer install --ignore-platform-reqs
  • Start docker(sail) and dev server:
    sail up -d
    sail npm run dev
  • In case npm not running:
    sail npm install --save-dev
    

    *only if you need it dev-only, otherwise, remove "--save-dev"

Thank you for your time.

Any feedback or assisting constructive critique is welcome.
Feel free to reach out or text via contact@myofficeX.

License:

  • The use, reproduction, modification, publication, distribution, sublicensing, and/or sale of the copyrighted material (e.g., software) is prohibited without explicit written permission.

Tools Used:


Main Content:


20230710 1st rm:

Cyrill Senger [CyrSen/MP_MOX](https://github.com/CyrSen/MP_MOX)
A production by and Gaudenz Raiber [Gaudenz77](https://github.com/Gaudenz77)