Songs and singers participation tracker

Requirements

• uv 0.9+

Installation

Minimal settings to run the app locally:

1. Copy .env.example to .env

2. Edit .env file, generate a new 32-character secret key and put it in the "your-secret-key-here-generate-new-one"

3. uv sync

4. uv run manage.py migrate

5. uv run manage.py createsuperuser

   • follow cli instructions; email can be blank

6. uv run manage.py runserver

Congratulations, this is now running!

Docker

Docker image also exists:

docker run -p 8000:8000 ghcr.io/lukaklanjsek/myfirstapp:latest

Usage

Managing songs

Add a composer and a poet for your new song. You can also add them alter, but adding them first makes managing songs cleaner.

• Sections with asterisk are mandatory.
• ID of the song is inputted manually, for when your archive is non-sequential.
• There is an alphabetical non-searchable drop-down menu for previously created composers and poets.

There is a connection between each song to its composer, poet and dates of rehearsals.

Managing members

You can add members that participate on your rehearsals.

Ticker "is active" is important for listing the member:

• at the top of members page;
• at creation of a new rehearsal;

Managing rehearsals

Rehearsals connect songs, active members and a calendar.

In the list of rehearsals there is a preview of songs related to it and names of active members that are not present.

• Members with "active" status appear with a checkbox for their rehearsal participation.
• Songs have a search-drop-down menu; you can search among song titles or composer names.

Support

Feel free to open issue on github.

Licence

Apache 2.0.