Electronical Luuppi Lärpäke. Track who attends the most events in their freshman year!
This repository contains implementation for the new generation of freshman event attendance cards (aka Lärpäke).
Luuppi is student organization for computer science, mathematics and statistical data analysis students in Tampere University Finland.
Fuksilärpäke is traditional part of freshman year for students in Luuppi. Fresmen compete on who gathers the most points during their freshman year. You can get points by fro example attending different events organized by Luuppi and other university organizations. Those with the most points are awarded with different prizes at the Luuppi Christmas party.
Instructions for running the project can be found on wiki
Docker + NodeJs (for minimal front end dev setup)
ASP.NET Core .NET9 C# C# 13 Web API Controllers REST JWT OpenApi Scalar Dependency Injection
In the heart of the Lärpäke is the REST api implemented using ASP.NET Core Web API with controllers. Api is implemented using RESTful architechture and fro easier use, OpenApi Scalar is used to visualize api endpoints and their request data. Authentication and authorization are implemented using json web tokens (JWT). As usual, services are managed by dependency injection (DI).
PostgreSQL Dapper
The web API uses PostgreSQL database to store all the data created by user clients. Dapper ORM is used in the C# code to map sql query results into objects. For those interested, database graphs can be found Wiki -pages under Database Graphs (here).
SSE
Web api serves Server Sent Events (SSE) for subscribed clients when user's event attendance is marked as completed hereby causing UI update.
Vite Typescript CSS HTML
Front end is built with minimal vite + Typescript, HTML, CSS stack.
For UI design drawings see Wiki -> Design (here).
Project uses luuppi's existing Azure Entra Id auth system with minor tweaks.
Project is up an running in larpake.luuppi.fi. Project is in beta stage and should be ready to take real users in the the end of the summer in 2025.
Contributions are always welcomed! Project is still at its youth so no contributing guidelines are written so far. If you are interested in improving Lärpäke, contact us!
@henrivain & @JurnetFIN
For support and feature requests preferably open a issue in Github (see Issues -page)
Or send email to
henri.vainio(at)luuppi.fi or juliusz.kotelba(at)luuppi.fi
Send email to webmaster(at)luuppi.fi or open Github issue. If bug is visual, please include screenshot that demonstrates the error. If error might be caused by data fetching (action requires some data which causes error), please add TraceId from console, if you are provided one. If you don't know where to aquire TraceId from, Lärpäke team is always here to help you!
