Skip to content

Flask powered web app for keeping track of employees coming back into the office after the Covid-19 lockdown around the world eases.

Notifications You must be signed in to change notification settings

GabrielDan92/Flask_Back-To-Office-App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The fully functional website is currently hosted on Python Anywhere's platform, and can be found here.

July 18 update (v2.0):

  • GDPR compliance update for the user view
  • Removed the option to add presence requests for days where the threshold has been reached. After the update, if an user tries to submit a request for a fully booked day, an error message will be returned and the request will no longer be saved to the database.
  • The dropdown lists used for adding the month and day have been replaced with an <input type="date"> object. The documentation can be found on Developer Mozilla's website.
  • CSS updates for different @media (max-width) sizes and other UI updates.

Why did I built this app?

Once the Covid-19 lockdown around the world eases (hopefully sooner than later), some of you will be in charge of gradually bringing the staff back into the office. But how do you keep track of everyone coming to work and if the maximum number of colleagues in the office for a given day has been reached? I believe there is an easier way to centralize and keep track of every staff member that will come to the office rather than just counting email requests from colleagues or try to use a shared Excel solution that comes with its own drawbacks.

By all means, you could try to use shared Excel workbooks saved on shared drives, OneDrive, SharePoint or even use Excel Online as an alternative, but only the ones who've used these solutions know what hassle it is to have a large number of users using the same file at the same time. From users editing the same cell, locked out users while the file is in use, corrupted or missing data, to users hiding or moving columns, formulas, there are a lot of things that can go wrong.

And that's how the Back-To-Office App came into existence.

How did I built the app and what tools did I use?

  • Flask
    • Template inheritance w/ Jinja2
    • Authentication: although I spend a lot of time on Stack Overflow when I encountered blocking points and I found great resources throughout the development phase, I must give credit where credit is due: Anthony Herbert's tutorial on implementing authentication to Flask apps was awesome and I can't recommend it highly enough.
    • Values sent from the Back-End to the Front-End passed through <render_template> as arguments and rendered on pages using Jinja2's engine
    • Python functions for preventing errors down the line: Initialize a blank database with the declared models if the database is not found when the servers starts, or create default values in the db (eg: if the admin profile is not created already) in order to prevent errors at run time. Verify the input count for the employee name and department to prevent adding large strings in the database (for example db.String(50) doesn't seem to prevent adding strings with lengths higher than 50 as I would have thought - I have to further investigate on that - this being the reason for using Python to check the strings length before writing in the database)

  • HTML, CSS and JavaScript for the Front-End part. JavaScript was mostly used for changing div elements' sizes or even hide them based on particular actions done by the user, and prevent submitting the jQuery POST requests if the date format is not valid
  • The Bootstrap framework for almost all styling properties
  • W3.CSS for the employee tables
  • jQuery AJAX for POST requests to the database
  • (!) An important change that can be done to the app is migrating from SQLite3 to PostgreSQL, if not for the added complexity, security and whatnot, then simply by being easier to integrate with other platforms like Heroku if that's your thing (Heroku doesn't support SQLite3 databases, more details here)

I've built the app with two user profile types in mind:

  • End User - the user experience should be as straightforward as it gets:
    • Open the app
    • Submit the presence day(s)
    • Close the app
    • Optionally: see all the other presence requests (with name and department) that have been submitted by now and find out how many employees will be in the office at a given date
    • Due to potential GDPR compliance concerns, I've decided to remove this option for the end user. Instead, I've implemented a search option where the employee can add his/her name and see or delete their request(s) if needed. On top of that, a new presence counter table has been added to the user front page, in order to see how many employees already submitted presence requests for a given day, without showing any personal data from the requesters. The search is case-insensitive, and the SQLAlchemy code I've used for case-insensitive to work is employee.query.filter(employee.name.ilike(employeeName)).all(), where employee is the table's name, name is a column in the employee table, and employeeName being the searched query.

      User

  • Admin - after authentication (on top of the options that the end user has), the admin can also:
    • Delete requests (one request at a time or all the requests at once with a press of a button)
    • Modify the maximum number of employees that can be in the office at the same time

      Admin

About

Flask powered web app for keeping track of employees coming back into the office after the Covid-19 lockdown around the world eases.

Topics

Resources

Stars

Watchers

Forks