utnkar / event-calendar

event-calendar

A web application that makes it easy for students to keep track of current events at campus Polacksbacken. The application is running a django backend and uses Tailwind for frontend purposes.

Getting Started (Not final)

1. Install Nodejs and npm
2. Install Python 3, at least version 3.6 or up.
3. Install the following python packages:
   • python3-venv
   • python3-dev
   • build-essentials
   • libpq-dev
4. Clone the repository.
5. Run source ./source_me.sh to create a virtual environment.
6. Run pip install --upgrade pip to make sure that pip is running the latest version
7. Run pip install -r dev-requirements.txt
8. Use cd src to enter the website directory.
9. Run ./manage.py migrate to initialize the database.
10. Run ./manage.py createsuperuser to create an admin user.
11. Open another terminal and run ./manage.py tailwind start

During development, you can run a test web server using ./manage.py runserver.

IMPORTANT! When running commands you must be in the virtual environment (a.k.a. source source_me.sh)

Trouble shooting

You might need to restart your server and/or tailwind during initial setup in order for it to work correctly.

event-calendar's Issues

Add bool model for whole-day events

Some events don't have a specific start time in hours and minutes, but are rather whole-day events (such as committee searches).

To support this, users should be able to select "whole-day" through a checkbox or something similar when creating, which should disable the hour and minute fields

Implement admin.py

Create customized admin view

Create documentation pages

UTN documents it's projects and systems at docs.utn.se.

We need to add documentation for the event-calendar.
Some of the documents at that page is subpar and other is really good. When looking for inspiration look at at the pages for OrdSys.
Similar documentation for event-calendar will help when switching team members and increase longevity of the product.

Create an event view

Clicking on an event on the start page should take you to the event view where more details about the event is shown

Create a design for event view

Each event should have a view.
In this view there needs to be a picture.
Descirption and additional info.

Look at nationsguiden for inspiration

Enable support for more time selections when creating an event

When creating an event there are only a limited available choices for when an event begins/ends.

Needs to be Hour.Min
Maybe not one for all 60 minutes but e.g 10.15, 10.30 etc

Event scheduling

It would be good to have the ability to publish a event at a certain time.

Give the option to publish a event at a given time

Enable support for sections to upload their logos

When creating a section there needs to be an option to upload their logo.

This logo will then be shown on that sections events.

Have links to utn.se and nationsguiden.se

On the start page there should be links to utn and nationsguiden

Create a design for Mobile view

Currently there is a design for desktop view but none for mobile.

Figma link

Create a start page with upcoming events

The start page should list all upcoming events

Make the UTN logo work as a button

The utn logo should redirect the user to the start page of the event-calendar site

Remove hardcoded attributes for event cards

All event cards have the date 18th of April and are organized by UTN and a gray circle. Change it so it is accordingly to what is chosen in the admin view when creating an event.

Create a view about all organizations

There should be a view that displays information about each organization

Add support for AK/DK

Next to the minute field when creating events, there should be a dropdown menu where you can select None/ak/dk for events, meaning you can create an event that starts at 17:00 ak. This should not replace the minute field however, since some events might want to start at, say, 17:30 dk

Improve design for desktop

The current design works but there is room for improvements.
A bit vague description but feel free to add your own magic. There might be a problem with usability when there are many events in the feed.

Figma link

Enable tickets to be released at a certain time

Some events require that tickets will be released at a specific time.

This can be solved with the events google forms page to only be available at that time but it would be nice to show a greyed out button with a countdown or something.
Once available replace that with a 'anmäl dig här' thingy

Show the real week number

On the frontpage there is now a hardcoded week number.
This needs to show the current one instead.

Look into how dates work in django and where a helper function might best be implemented to support this.

Remove hardcoded attributes from an event card

Improve readme

The guide is incomplete.

1. Windows users
2. Maybe tutorial to install all requirements needs more explaining

Look over all other instructions and remove unnecessary steps

Events should be searchable

On the start page it should be possible to search for events

Filter events on the start page

On the start page it should be possible to filter events based on host, categories and similar