STAR is a streamlined web application for organizing and managing station-based team events. Perfect for rallies, orienteering events, team-building activities, educational tours, and scavenger hunts.

Overview

STAR is a single-binary application that helps event organizers manage teams as they progress through a series of stations along predefined routes. The app provides:

Real-time tracking of team movements between stations
Rating system for evaluating team performance
Flexible route planning with multiple possible paths
Map integration for station locations
QR code generation for easy station access

Key Features

Team Management: Create teams, assign routes, track progress, and monitor ratings
Station Control: Station supervisors can record when teams arrive, start activities, and depart
Route Planning: Define custom routes with specific station sequences
Performance Rating: Score teams at each station and generate overall rankings
Admin Dashboard: Comprehensive overview of event progress and team status
Multi-language Support: Currently in German with i18n infrastructure

For Station Supervisors

Station supervisors can:

Check in teams when they arrive at a station
Record when teams begin their activities
Mark when teams complete the station and leave
Rate team performance and add notes
View which teams should be arriving next

Getting Started

Demo Instance

startest.it-results.at
Database resets on every commit/deployment
Default admin credentials: "a"/"123"

Development

Install inotifywatch on your system
Use ./watch.sh for automatic re-compilation upon changes

Localization Testing

To test for errors in localization strings:

cargo r -r -- --locale-file /path/to/stationslauf/locales/de-AT.yml --rust-src-to-check /path/to/stationslauf/src

Technical Details

Implementation: Single-binary application (plus database and .env file)
Automatic Assignment: Teams are automatically assigned to start stations to balance workload
PDF Generation: Create printable documents with login QR codes for station supervisors
Maps Integration: Navigation and station location visualization

Project Structure

Teams: Groups of participants following specific routes
Stations: Checkpoints where teams perform activities and get rated
Routes: Defined paths connecting stations in specific sequences
Admins: Users who can manage the entire system, create entities, and view results

License

STAR is licensed under the European Union Public License (EUPL) 1.2, a free software license. This license allows you to use, modify, and distribute the software. If you distribute modified versions, you must release your changes under a compatible open-source license. The EUPL 1.2 provides compatibility with several other open-source licenses.

Hosting options

You're welcome to self-host STAR on your own servers or infrastructure. This gives you complete control over your deployment, data, and customizations. Should you share your modified version, the EUPL 1.2 simply asks that you contribute your improvements back to the open-source community.

Alternatively, if you'd prefer a hassle-free experience without managing servers and updates, I can host the application for you. This option provides you with support and maintenance while letting you focus on organizing your event rather than technical details. You can find more information at https://star.it-results.at

Contribution

Got ideas to make STAR even better? I'd love to hear from you! Whether it's a small suggestion, a bug report, or a brilliant new feature concept, please drop me a line at philipp@hofer.link.

If you're interested in contributing code, documentation, or other improvements directly, I'm happy to set up a Gitea account here to make collaboration smooth and easy. Just reach out and we can get you started.

Your feedback and contributions help make this project better for everyone—so don't be shy! Let's make STAR the best station-based event management tool together.