LUONVUITUOI-HONOR ROLL¶
Config-driven student honor-roll toolkit. Bring your results CSV/Excel/JSON and a config to obtain a public honor roll with search, admin panel, and multi-competition galleries in minutes.
Why this exists¶
Running a competition, awarding medals, or hosting an olympiad requires a public showcase where students see their achievements, parents confirm results, and schools track their medals, all searchable, styled beautifully, and easy to manage. LUONVUITUOI-HONOR ROLL delivers all three capabilities, deployable to Vercel's free tier or any Docker host, with zero boilerplate.
Multi-competition gallery¶
Define one or many competitions across years. Each runs independently; students see all their medals across every edition.
Flexible medal registry¶
Define each medal once (rank, label, color, icon). Badges stay consistent. CSV/Excel/JSON ingest.
Public honor roll + search¶
Beautiful card and table views. Visitors search by name or ID, see every achievement instantly.
Admin surface built in¶
Add, correct, or delete entries without touching files. Password-protected, audit log included.
Deploy anywhere¶
One-command Vercel deploy (free tier), production Dockerfile, or docker-compose. Select your preferred infrastructure.
Bilingual & mobile-ready¶
English + Vietnamese. Responsive, animated UI that shines on desktop, tablet, phone.
Getting started¶
Quickstart β¶
Deploy your first honor roll in 10 minutes. CLI scaffold, config walk-through, local run, Vercel push.
Configuration β¶
Every honor.config.json field + environment variable documented. Learn how to define competitions, medals, and rules.
Architecture β¶
How the pieces fit: handlers, data model, search index, admin auth, and UI layers.
Sibling projects¶
- LUONVUITUOI-CERT: A certificate portal toolkit. Issues and verifies PDF certificates with QR codes and admin panel. Whereas HONOR ROLL celebrates achievements, CERT proves them.