mirror of
https://github.com/tiennm99/thptqg.git
synced 2026-10-11 12:28:58 +00:00
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# Project Overview — thptqg2016
|
|
|
|
## Goal
|
|
|
|
Provide a public lookup tool for Vietnam's 2016 National High School Graduation Exam scores (877,461 candidates), running entirely on the client, hosted for free on GitHub Pages.
|
|
|
|
## Scope
|
|
|
|
- Lookup by exam ID or full name (with Vietnamese diacritics handling)
|
|
- Read-only SQL queries against a single `student` table
|
|
- Static dataset — no updates (the 2016 exam is long over)
|
|
|
|
## Target users
|
|
|
|
- Former 2016 candidates checking their scores
|
|
- Education researchers / data journalists running aggregate stats
|
|
- Developers exploring SQL on a real-world dataset
|
|
|
|
## Constraints
|
|
|
|
- **Zero backend**: the full DB (tens of MB gzipped) is downloaded to the browser
|
|
- **Read-only**: INSERT/UPDATE/DELETE rejected to avoid the illusion that user edits persist
|
|
- **Row caps**: 100 rows (lookup), 1000 rows (SQL) to prevent browser hangs
|
|
- **Vietnamese-first UI**: app labels and data are Vietnamese; documentation is English
|
|
|
|
## Data sources
|
|
|
|
Excel files (`.xlsx`/`.xls`) collected from newspapers and exam clusters in 2016, stored in `data/`. One file per cluster, with several different column layouts (see `scripts/build-database.js`).
|
|
|
|
Original aggregator link: <https://dtntbacgiang.edu.vn/tin-tuc/tin-tuc-su-kien/cong-bo-diem-thi-thptqg-2016-toan-bo-120-cum-thi-da-co-diem.html> — no longer accessible, so the raw Excel files are mirrored in this repo under `data/`.
|
|
|
|
## Status
|
|
|
|
Stable. Data is frozen. Recent work focuses on UX polish (dark mode, accessibility, diacritics-insensitive search).
|