https://github.com/merobi-hub/attendance-tracker

Minimalist attendance tracker in Python on a Flask framework
https://github.com/merobi-hub/attendance-tracker

Last synced: about 1 month ago
JSON representation

Minimalist attendance tracker in Python on a Flask framework

• Host: GitHub
• URL: https://github.com/merobi-hub/attendance-tracker
• Owner: merobi-hub
• Created: 2021-09-10T03:05:30.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-04-22T01:51:13.000Z (8 months ago)
• Last Synced: 2024-04-22T04:01:37.097Z (8 months ago)
• Language: Python
• Size: 247 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Attendance Keeper

## Purpose

This minimalist event management app simplifies event sign-up for both users and hosts. Attendees can check in to events without registering as site users, keeping the effort minimal for guests. Only on-going and upcoming events are presented to site visitors, minimizing the potential for confusion about which event to join and, by extension, the creation of bad data. Hosts can log in using Google and then, behind login-protected routes, secure events with passkeys, view attendance percentages of repeat guests, add and remove attendees, and delete events.        

## Technologies

This Python project is on a Flask framework with database support via Psycopg2 and SQLAlchemy. Flask-WTF handles and secures the forms, and Flask Werkzeug encrypts user passwords. The Datetime library is employed to convert event date and time data for display and check-in filtering. The Oauth2 library and Requests are used to enable third-party logging through Google, and the requisite Client ID and Secret variables are accessed as environment variables for enhanced security. On the front end, Flask Flash messages update users and hosts about authorization and form submission events. Jinja2 templates support a dynamic nav and efficient site design, while Bootstrap4 columns, rows, and cards keep information streamlined and orderly.

## App Images

![homepage image](attendance/static/images/attend_home.png)

The user scrolls through Bootstrap4 cards to select an event. A link on each card takes the user to a check-in form.

![login image](attendance/static/images/attend_login.png)

Hosts can log in with unique credentials or use a third-party option from Google.

![event image](attendance/static/images/attend_event.png)

Each event's unique page lists all participants. Links allow hosts to remove participants and view attendance data.

![profile image](attendance/static/images/attend_profile.png)

A host's profile displays all events ever created by that host and features links to routes allowing for adding of participants and editing/deleting of events, as well as more detailed information about attendees.

## License

Creative Commons BY-SA 4.0

## Db regeneration process notes

Locally:

`export FLASK_APP='attendance'`

`flask db init`

`flask db migrate`

commit changes and push to main

on Heroku: copy and paste deploy db url env var to deploy db url. Then open console and run `flask db upgrade`