ALean version: a small monthly event, run by hand from September 2026

Start now with what exists, rather than wait for a system. Part A needs no developer: a one-page rule text, a printable teacher letter, one CS owner, a Google Sheet, a budget line. The board itself stays as it is.

A1One-page rules, as published

This is the text a parent reads. It is deliberately short. Anything not here is decided by FLYER and explained to the family concerned.

A2The monthly routine for CS

One owner, about one working day per month. Times are Vietnam time.

The Sheet

One tab per month, one row per level and rank (15 rows). Columns cover four groups: identity (level, rank, screenshot, display name, profile id, account type), age (birthday on file, age at month end, in band), contact and letter (parent, phone, contacted on, letter received and link, teacher name and phone, call date and outcome), and close-out (decision, decided by, address, bicycle size, consent, ordered, delivered, photo, notes).

The letter

A printable one-page bilingual form is at roadmap.flyer.vn/ranking-prize-letter. CS exports it to PDF once and sends the same file to every family, then takes back a phone photo of the signed page. The field list is in section 7.2.

A3Message templates

A3.1 To the provisional winner's parent

A3.2 To a reserve

A3.3 Call script for the teacher

A3.4 Winner announcement (Zalo, Facebook)

A4Risks handled by hand, and when to build

When to build Part B

• The event is kept after November and the team wants it to run without one CS day per month.
• Disputes about the score itself, not about eligibility, appear more than once.
• The board's number one is repeatedly a grinder rather than a strong student; then start with Part B section 9 (versioned formula with the championship test), which is the smallest piece with the largest effect.

The five backlog items on the board are ordered for that moment and stay parked until then.

1Context and problem

Each month the student with the top score in Starters, Movers, Flyers, KET and PET receives a bicycle. One condition came with the request: the winner presents a letter from their English teacher confirming they are within the Cambridge age range for that level.

The leaderboard already exists and is well used. What it lacks is everything a physical prize needs: a formula that is written down and versioned, eligibility rules, a way to tell a real child from an anonymous or duplicate profile, an age on the profile, and tooling to run a claim.

A bicycle is worth enough that families will optimise for it. Section 4 lists the specific gaps; the consequence is that the first month of prizes would produce disputes the team cannot adjudicate, because the rule that produced the number is not in any repository.

2Goals and success metrics

Goals

• Turn the Monthly tab into a monthly race with a prize students and parents understand and trust.
• Raise the number of students who complete full mock tests every month at the five Cambridge levels.
• Get a verified date of birth onto student profiles, which every future age-banded feature will need.
• Establish a repeatable monthly operating cycle: freeze, claim, verify, announce, deliver.

Success metrics

3How the leaderboard works today

Read from the source, not assumed. The live app is flyer/webs-ranking (Next.js, last commit 27/08/2026) served at ranking.flyer.us; the older ranking-web repository is dead since October 2024. The ranking API is GraphQL v2 in flyer/exam.

Monthly tab, Starters, 7 September 2026. Rank 1 is a class account, not a child, with 770 points a week into the month.

Daily tab, Starters, same day. 106 points in one day means eleven full tests before dinner.

4What blocks a monthly prize

5The standard: programme rules

The rules as a parent should be able to read them. Sections 9 to 14 exist to make these rules true.

5.1 The prize

• Five prizes a month, one per level: Starters, Movers, Flyers, KET, PET. Each prize is one bicycle.
• The winner of a level is the eligible student ranked first on the Monthly tab for that level at the moment the month is frozen.
• Two runners-up per level are held as reserves. If the winner does not complete the claim or fails verification, the prize passes to the next reserve.
• A student can win at most one bicycle per month (if first in two levels, the higher level counts and the lower passes to its reserve) and at most one bicycle per calendar year.

5.2 The score

5.3 Tie-break, in order

1. Lower time on the championship test, capped at the level's allotted duration.
2. More distinct tests completed in the month at that level.
3. Lower total time on the ten counted tests, with each test's time capped at the level's allotted duration so an open tab never counts.
4. Earlier moment at which the final score was reached.

5.4 Eligibility

• A registered student account (not an anonymous profile) with a parent phone number verified.
• A date of birth entered on the profile before the 20th of the month, and locked once entered; later corrections go through support with the same letter.
• The student's age on the last day of the month falls inside the level's age band (section 6).
• Not on the exclusion list: FLYER staff and their test accounts, school demo and sample accounts, partner admin accounts, and any profile flagged for integrity review in the last six months.
• Where one user owns several student profiles, only the profile designated as primary is eligible.

5.5 Claiming

• Provisional winners and reserves are notified on the 1st. They have seven days to submit the teacher confirmation letter (section 7) and a delivery address.
• FLYER verifies within three working days and may call the teacher or the school.
• Winners are announced on the 12th; delivery follows within two weeks; a delivery photo is posted on the winner wall with the family's consent.
• FLYER's decision on eligibility and integrity is final; the rule text and the score breakdown are shown to the claimant so the decision is explainable.

6Age bands per level

Cambridge publishes the Young Learners suite for children aged roughly 6 to 12, but publishes no fixed age for KET and PET for Schools. The bands below are FLYER's operational bands, aligned to that guidance and to Vietnamese school grades; age is counted in completed years on the last day of the prize month.

• Bands overlap on purpose. An eight-year-old may race in both Starters and Movers, and a thirteen-year-old in both KET and PET; the one-prize-per-month rule handles the double win.
• The band applies both ways: older or younger than the band is not eligible. Whether to admit younger “prodigies” is an open question (section 16).
• The board still shows every student. An ineligible student keeps their rank on the public table, marked “not eligible for the prize” with the reason, so the number on the board never changes for them; only the prize passes them by.

7The teacher confirmation letter

The platform can compute an age from a date of birth, but cannot know whether the date is true or whether the child sat the tests. A named teacher who signs a short form answers both, and gives CS one phone number to call.

7.1 Who may sign

• The student's current English teacher at their school, or at an English centre the student attends. Homeroom teachers may sign for grades 1 to 3 where there is no separate English teacher.
• A parent, relative or the student's own FLYER account holder may not sign. A teacher who is the parent may not sign for their own child.
• A teacher on FLYER Teacher or Teado.ai confirms in the product instead of on paper (section 12.4). That is stronger evidence than a scan.

7.2 What the letter contains

The template is a one-page PDF, bilingual, downloadable from the claim page. A photo of the signed page taken with a phone is accepted; the upload is limited to 10 MB and to JPG, PNG, HEIC and PDF.

7.3 Verification by CS

1. Open the claim in admin; the letter is shown next to the profile, the frozen standings row and the integrity signals.
2. Check that name and date of birth match the profile and that the computed age is inside the band.
3. Call the teacher on the number given. Confirm the student, the class and that the teacher signed. Log the call outcome on the claim.
4. Approve, or reject with a reason chosen from a fixed list (date of birth mismatch, teacher unreachable, teacher denies signing, level not appropriate, integrity concern, incomplete letter). A rejection releases the prize to the next reserve automatically.

8The monthly cycle end to end

One cycle per level per month, all five running on the same calendar. Steps 1 and 2 are the existing leaderboard with the new formula; steps 3 to 7 are new.

9Requirement A: versioned ranking formula

Replace the hand-made monthly ranking for the five prize levels with a view whose definition lives in a migration file, computes the best-ten score in section 5.2, and carries a version number that is printed on the board.

What changes

• A new materialized view monthly_prize_ranks (level, month, learner profile, score, distinct test count, capped total time, time of final score, rank, formula version), added to the hourly refresh list next to learner_test_level_ranks.
• The Monthly tab for Starters, Movers, Flyers, KET and PET reads from this view. Daily, Weekly and Yearly, and Monthly for other levels, are unchanged in phase 1.
• Rank is a position (row_number), never a percentile bucket. The sibling monthly recap view uses ntile(100) on production and row_number() on dev; that drift must not be repeated here.
• Month boundaries are computed in Asia/Ho_Chi_Minh explicitly in the SQL, not left to the session time zone of whoever runs the refresh.
• The public rules page and the board footer print “Formula v1, effective 01/10/2026”. A formula change bumps the version and takes effect only from the next month.
• The championship test is an ordinary check point flagged championship_month and championship_level, hidden until its window opens, single attempt enforced server-side, and released into the normal library afterwards. Academic delivers five such tests by the 20th of each month.

WITH counted AS (                    -- one row per (student, test) = best attempt that month
  SELECT ua.learner_profile_id, ua.test_level_id, ua.check_point_id,
         bool_or(cp.championship_month IS NOT NULL)                       AS is_championship,
         max(round(10 * ua.grade / ua.max_grade, 2))                      AS best_grade,
         min(least(ua.execution_time, tl.execution_time))                 AS best_time,
         min(ua.submitted_at)                                             AS first_at
  FROM   user_attempts ua
  JOIN   test_level_exam_settings tl ON tl.test_level_id = ua.test_level_id
  JOIN   check_points cp ON cp.id = ua.check_point_id
  WHERE  ua.type_attempt = 'exam' AND ua.submitted_at IS NOT NULL
    AND  ua.grade > 0 AND ua.max_grade > 0
    AND  (ua.submitted_at AT TIME ZONE 'Asia/Ho_Chi_Minh') >= date_trunc('month', now() AT TIME ZONE 'Asia/Ho_Chi_Minh')
  GROUP  BY 1,2,3
), ranked AS (
  SELECT *, row_number() OVER (PARTITION BY learner_profile_id, test_level_id
                               ORDER BY best_grade DESC, first_at) AS k
  FROM counted WHERE NOT is_championship
), best10 AS (
  SELECT learner_profile_id, test_level_id,
         sum(best_grade) FILTER (WHERE k <= 10)   AS score10,
         count(*)                                  AS distinct_tests,
         sum(best_time)  FILTER (WHERE k <= 10)   AS counted_time,
         max(first_at)   FILTER (WHERE k <= 10)   AS final_score_at
  FROM ranked GROUP BY 1,2
), champ AS (                       -- the month's single-attempt championship test
  SELECT learner_profile_id, test_level_id, best_grade * 10 AS champ_score, best_time AS champ_time
  FROM counted WHERE is_championship
)
SELECT b.learner_profile_id, b.test_level_id,
       b.score10 + coalesce(c.champ_score, 0) AS score,
       b.score10, c.champ_score, b.distinct_tests, b.counted_time, c.champ_time, b.final_score_at,
       row_number() OVER (PARTITION BY b.test_level_id
                          ORDER BY b.score10 + coalesce(c.champ_score, 0) DESC,
                                   c.champ_time ASC NULLS LAST, b.distinct_tests DESC,
                                   b.counted_time ASC, b.final_score_at ASC) AS rank,
       1 AS formula_version
FROM best10 b LEFT JOIN champ c USING (learner_profile_id, test_level_id);

Acceptance

• Given a student with twelve tests, the best-ten score equals the sum of their ten best normalised grades and their thirteenth test never changes it.
• Given two students on 200, the one with the lower capped time on the championship test ranks first; then more distinct tests; then lower capped time on the ten counted tests; then the earlier final score.
• A second start is refused by the API with a readable message; only the first attempt counts. Before the window opens the test is not visible in the library, in search, or by direct link.
• The definition is in a migration in the exam repository and produces the same rank on dev and production for the same fixture data.
• Medals on the board are keyed to the server rank, not the row index.

10Requirement B: eligibility and profile

Date of birth

• Add a date-of-birth prompt in the student app and on ranking.flyer.us for any logged-in student without one. Copy: “Add your birthday to be eligible for the monthly bicycle.”
• Once saved, the field is locked (dob_locked_at). Changing it requires a support ticket with a teacher letter or birth certificate. This is what makes the age check meaningful.
• Validation: a date between 3 and 20 years before today; anything else is rejected at the API.
• Cut-off: a date of birth saved on or after the 20th of a month does not count for that month's prize. This stops a family adding a convenient birthday on the 31st after seeing the standings.

Eligibility computation

A nightly job (and again at freeze) writes an eligibility row per active student and level: eligible or not, with a list of reasons. Reasons are a fixed enum so the UI can explain them.

Exclusion list

• Seeded from: every learner profile linked to a @flyer.us or @flyer.vn user, the configured demo student ids that the sample-class job shifts dates for, and profiles owned by partner admin accounts.
• Maintained in admin (section 12) with a reason and an expiry; integrity holds expire after six months.

On the board

• Every row on the Monthly tab of a prize level carries a small badge: “Eligible” or “Not eligible”. Tapping the latter shows the reason to the student themselves and a neutral “not eligible for the prize” to everyone else.
• The pinned footer row for the logged-in student gains a checklist: account, parent phone, birthday, age band, tests counted so far (7 of 10).

11Requirement C: claim flow for students

A page on ranking.flyer.us reachable from the notification and from the board banner, for the logged-in provisional winner or reserve.

• States: invited, draft, submitted, under_review, verified, rejected, expired, awarded, delivered. Each state change notifies the parent.
• Reserves see the same page with “You are 1st reserve. If the winner's claim is not verified you will have five days to submit.” They may upload early.
• A rejected claimant sees the reason code and a support contact; they cannot resubmit in the same cycle except for “incomplete letter”, which allows one resubmission within the window.
• The winner wall at /prize/winners lists past winners by month and level: first name, school, province, score, delivery photo where consented.
• The public rules page at /prize/rules renders section 5 and section 6 of this document, bilingual, with the current formula version.

12Requirement D: admin and verification

12.1 Cycles

A list in admin-web of prize cycles, one row per month and level, with status (open, frozen, claiming, verifying, announced, closed), the frozen top ten, and the claim chain (winner, reserve 1, reserve 2 and who currently holds the prize).

12.2 Claims queue

A plain list, filterable by status and level. Each claim opens to a single screen: profile card, frozen standings row with the ten counted tests, the uploaded letter, the teacher's phone, integrity signals (section 13), a call log, and Approve or Reject. The cycle turns to announced once all five levels are verified, or on the 12th.

12.3 Exclusions and overrides

An exclusion list with add, reason, expiry and an audit log. A manual override to pass the prize to a reserve outside the automatic rules, with a mandatory note; overrides are listed on the cycle for later review.

12.4 In-product teacher confirmation (phase 2)

If the student belongs to a class on FLYER Teacher or Teado.ai, the claim names that teacher, who confirms in-product with one tap. The claim records the teacher's account, which is stronger than a phone call. Paper remains for students without a FLYER teacher.

12.5 Exports

CSV of winners per cycle for finance (prize value, delivery cost) and a monthly report of claims by outcome and reason for the product review.

13Anti-abuse and audit trail

A bicycle attracts effort. Rules alone are not enough; the platform must surface signals so that CS reviews with evidence, and every decision must be reconstructible.

• Flags are advisory. The only automatic outcomes are the eligibility reasons in section 10; everything else goes to a human with the evidence attached.
• Every cycle keeps: the frozen standings, the eligibility rows, every claim with its letter and call log, every state change with actor and time, and the formula version. Nothing in that set is ever updated in place.
• A student placed on integrity hold is told so, with a support route. Silence is worse than a clear rule.

14Data and technical design

15Scope, phasing and budget

Running cost per month

Bicycle sizes differ across the age bands: a six-year-old and a sixteen-year-old do not ride the same bicycle. The claim form asks for a size, and procurement should hold two models.

16Open questions

ABản rút gọn: sự kiện nhỏ hằng tháng, chạy thủ công từ tháng 9/2026

Bắt đầu ngay với những gì đang có, không chờ hệ thống. Phần A không cần lập trình viên: một thể lệ một trang, một mẫu giấy xác nhận in được, một người CS, một Google Sheet, một dòng ngân sách. Bảng xếp hạng giữ nguyên.

A1Thể lệ một trang, bản công bố

Đây là nội dung phụ huynh đọc, cố ý ngắn. Điều gì không có ở đây do FLYER quyết định và giải thích cho gia đình.

A2Việc CS làm mỗi tháng

Một người phụ trách, khoảng một ngày công mỗi tháng. Giờ Việt Nam.

Sheet

Mỗi tháng một tab, mỗi cấp độ và hạng một dòng (15 dòng). Các cột: cấp độ, hạng, link ảnh chụp, tên hiển thị, id hồ sơ, loại tài khoản, ngày sinh trong hồ sơ, tuổi cuối tháng, trong khung (có/không), tên phụ huynh, số phụ huynh, ngày liên hệ, ngày nhận giấy, link giấy, tên giáo viên, số giáo viên, ngày gọi, kết quả cuộc gọi, quyết định, người quyết, địa chỉ, cỡ xe, đồng ý công bố, ngày đặt xe, ngày giao, link ảnh, ghi chú.

Giấy xác nhận

Mẫu một trang song ngữ, in được, tại roadmap.flyer.vn/ranking-prize-letter. CS xuất PDF một lần, gửi chung cho mọi gia đình, nhận lại ảnh chụp trang đã ký. Danh sách trường thông tin xem mục 7.2.

A3Mẫu tin nhắn

A3.1 Gửi phụ huynh người thắng tạm thời

A3.2 Gửi dự bị

A3.3 Kịch bản gọi giáo viên

A3.4 Bài công bố người thắng (Zalo, Facebook)

A4Rủi ro xử lý bằng tay, và khi nào cần xây

Khi nào xây Phần B

• Sự kiện được giữ sau tháng 11 và đội ngũ muốn chạy mà không mất một ngày công CS mỗi tháng.
• Tranh cãi về chính điểm số, không phải về điều kiện, xuất hiện nhiều hơn một lần.
• Hạng nhất trên bảng liên tục là người cày đề thay vì học sinh giỏi; khi đó bắt đầu từ Phần B mục 9 (công thức có phiên bản kèm đề vô địch), phần nhỏ nhất nhưng hiệu quả lớn nhất.

Năm item backlog trên board được sắp cho thời điểm đó và tạm gác lại cho tới lúc ấy.

1Bối cảnh và vấn đề

Mỗi tháng, học sinh điểm cao nhất ở Starters, Movers, Flyers, KET và PET nhận một chiếc xe đạp. Điều kiện kèm theo: người thắng nộp giấy xác nhận của giáo viên tiếng Anh, chứng nhận học sinh đúng độ tuổi Cambridge của cấp độ đã thắng.

Bảng xếp hạng đã có và được dùng nhiều. Thiếu là mọi thứ một giải thưởng hiện vật cần: công thức ghi thành văn và có phiên bản, quy tắc điều kiện dự thi, cách phân biệt học sinh thật với hồ sơ ẩn danh hoặc trùng, ngày sinh trên hồ sơ, và công cụ vận hành nhận giải.

Một chiếc xe đạp đủ giá trị để các gia đình tối ưu vì nó. Các lỗ hổng cụ thể nằm ở mục 4; hệ quả là tháng trao giải đầu tiên sẽ sinh tranh cãi mà đội ngũ không phân xử được, vì quy tắc tạo ra con số đó không nằm trong kho mã nào.

2Mục tiêu và chỉ số

Mục tiêu

• Biến tab Tháng thành cuộc đua hằng tháng có phần thưởng mà học sinh và phụ huynh tin.
• Tăng số học sinh hoàn thành đề thi thử đầy đủ mỗi tháng ở năm cấp độ Cambridge.
• Đưa ngày sinh đã xác minh lên hồ sơ học sinh, nền cho mọi tính năng theo độ tuổi về sau.
• Thiết lập chu trình vận hành hằng tháng lặp lại được: chốt, nhận giải, thẩm định, công bố, trao giải.

Chỉ số thành công

3Bảng xếp hạng hiện đang chạy thế nào

Đọc từ mã nguồn, không suy đoán. Ứng dụng đang chạy là flyer/webs-ranking (Next.js, commit 27/08/2026); kho ranking-web cũ ngừng từ 10/2024. API xếp hạng là GraphQL v2 trong flyer/exam.

Tab Tháng, Starters, ngày 07/09/2026. Hạng 1 là tài khoản lớp, không phải một học sinh, với 770 điểm sau một tuần.

Tab Ngày, Starters, cùng ngày. 106 điểm trong một ngày nghĩa là mười một đề đầy đủ trước bữa tối.

4Điều gì cản trở giải thưởng tháng

5Bộ chuẩn: thể lệ chương trình

Thể lệ ở dạng phụ huynh đọc được. Mục 9 đến 14 tồn tại để các quy tắc này đúng.

5.1 Giải thưởng

• Năm xe đạp mỗi tháng, mỗi cấp độ một chiếc: Starters, Movers, Flyers, KET, PET. Người thắng là học sinh đủ điều kiện xếp hạng nhất tab Tháng lúc chốt.
• Hai học sinh kế tiếp là dự bị, nhận giải nếu người thắng không hoàn tất hoặc không qua thẩm định.
• Tối đa một xe mỗi tháng (đứng nhất hai cấp độ thì tính cấp cao hơn) và một xe mỗi năm dương lịch.

5.2 Điểm

5.3 Phân định đồng điểm, theo thứ tự

1. Thời gian thấp hơn ở đề vô địch, chặn ở thời lượng quy định của cấp độ.
2. Nhiều bài khác nhau hơn hoàn thành trong tháng ở cấp độ đó.
3. Tổng thời gian thấp hơn trên mười bài được tính, thời gian mỗi bài bị chặn ở thời lượng quy định của cấp độ để một tab bỏ quên không bao giờ được tính.
4. Sớm hơn ở thời điểm đạt điểm cuối cùng.

5.4 Điều kiện dự thi

• Tài khoản đã đăng ký, không phải hồ sơ ẩn danh, có số điện thoại phụ huynh đã xác minh.
• Ngày sinh nhập trước ngày 20 của tháng và khoá lại sau khi nhập; sửa về sau qua bộ phận hỗ trợ.
• Tuổi vào ngày cuối tháng nằm trong khung của cấp độ (mục 6).
• Không thuộc danh sách loại trừ: nhân viên FLYER, tài khoản demo và mẫu của trường, quản trị đối tác, hồ sơ đang bị xem xét tính trung thực.
• Một người dùng nhiều hồ sơ thì chỉ hồ sơ chính đủ điều kiện.

5.5 Nhận giải

• Người thắng tạm thời và dự bị được báo ngày 1, có bảy ngày nộp giấy xác nhận (mục 7) và địa chỉ nhận.
• FLYER thẩm định trong ba ngày làm việc, có thể gọi giáo viên hoặc nhà trường.
• Công bố ngày 12, trao giải trong hai tuần sau, ảnh lên bảng vinh danh khi gia đình đồng ý.
• Quyết định của FLYER là cuối cùng; người nhận giải được xem thể lệ và bảng chi tiết điểm.

6Khung tuổi theo cấp độ

Cambridge công bố bộ đề Thiếu nhi cho trẻ 6 đến 12 tuổi, nhưng không công bố độ tuổi cố định cho KET và PET for Schools. Khung dưới đây là khung vận hành của FLYER, bám hướng dẫn đó và khối lớp Việt Nam; tuổi tính tròn năm vào ngày cuối tháng trao giải.

• Khung cố ý chồng lấn: trẻ tám tuổi đua được cả Starters và Movers. Quy tắc một giải mỗi tháng xử lý trường hợp thắng kép.
• Khung áp dụng cả hai chiều, lớn hơn hay nhỏ hơn đều không đủ điều kiện. Có nhận “thần đồng” nhỏ tuổi hay không là câu hỏi mở (mục 16).
• Bảng vẫn hiển thị mọi học sinh. Người không đủ điều kiện giữ nguyên hạng, chỉ gắn nhãn “không đủ điều kiện nhận giải”; con số trên bảng không đổi.

7Giấy xác nhận của giáo viên

Nền tảng tính được tuổi từ ngày sinh nhưng không biết ngày đó có thật không, và học sinh có tự làm bài không. Một giáo viên có tên, ký vào mẫu ngắn, trả lời được cả hai và cho CS một số điện thoại để gọi.

7.1 Ai được ký

• Giáo viên tiếng Anh hiện tại của học sinh ở trường, hoặc ở trung tâm tiếng Anh học sinh đang theo học. Giáo viên chủ nhiệm có thể ký cho lớp 1 đến 3 khi không có giáo viên tiếng Anh riêng.
• Phụ huynh, người thân hoặc chính chủ tài khoản FLYER của học sinh không được ký. Giáo viên là phụ huynh không được ký cho con mình.
• Giáo viên dùng FLYER Teacher hoặc Teado.ai xác nhận ngay trong sản phẩm thay vì trên giấy (mục 12.4). Bằng chứng này mạnh hơn ảnh chụp.

7.2 Nội dung giấy xác nhận

Mẫu là một trang PDF song ngữ, tải từ trang nhận giải. Ảnh chụp trang đã ký bằng điện thoại được chấp nhận; tệp tải lên giới hạn 10 MB và các định dạng JPG, PNG, HEIC, PDF.

7.3 Thẩm định bởi CS

1. Mở hồ sơ nhận giải: giấy xác nhận nằm cạnh hồ sơ học sinh, dòng bảng đã chốt và các tín hiệu trung thực.
2. Kiểm tra tên và ngày sinh khớp hồ sơ, và tuổi tính được nằm trong khung.
3. Gọi giáo viên theo số đã cho. Xác nhận học sinh, lớp và việc giáo viên đã ký. Ghi kết quả cuộc gọi vào hồ sơ.
4. Duyệt, hoặc từ chối theo lý do chọn từ danh sách cố định. Từ chối tự động chuyển giải cho dự bị kế tiếp.

8Chu kỳ hằng tháng từ đầu đến cuối

Mỗi cấp độ một chu kỳ mỗi tháng, cả năm cấp độ chạy cùng lịch. Bước 1 và 2 là bảng xếp hạng hiện có với công thức mới; bước 3 đến 7 là phần mới.

9Yêu cầu A: công thức xếp hạng có phiên bản

Thay view tạo tay bằng một view có định nghĩa trong migration, tính điểm theo mục 5.2 và mang số phiên bản in trên bảng.

Thay đổi

• Materialized view monthly_prize_ranks (cấp độ, tháng, hồ sơ, điểm, số bài khác nhau, thời gian đã chặn, thời điểm đạt điểm cuối, hạng, phiên bản), làm mới mỗi giờ cạnh learner_test_level_ranks.
• Tab Tháng của năm cấp độ có giải đọc từ view này; Ngày, Tuần, Năm giữ nguyên ở giai đoạn 1.
• Hạng là vị trí (row_number), không bao giờ là nhóm phần trăm. View cùng họ đang lệch giữa dev và production, không lặp lại ở đây.
• Ranh giới tháng tính theo Asia/Ho_Chi_Minh ngay trong SQL, không theo múi giờ phiên chạy lệnh.
• Trang thể lệ và chân bảng in “Công thức v1, hiệu lực từ 01/10/2026”. Đổi công thức là tăng phiên bản, chỉ hiệu lực từ tháng sau.
• Đề vô địch là check point thường, gắn cờ championship_month và championship_level, ẩn tới khung giờ mở, máy chủ chỉ cho một lượt, mở vào thư viện sau khung giờ. Học thuật bàn giao năm đề trước ngày 20 mỗi tháng.

WITH counted AS (                    -- mỗi dòng = (học sinh, đề) với lượt tốt nhất trong tháng
  SELECT ua.learner_profile_id, ua.test_level_id, ua.check_point_id,
         bool_or(cp.championship_month IS NOT NULL)                       AS is_championship,
         max(round(10 * ua.grade / ua.max_grade, 2))                      AS best_grade,
         min(least(ua.execution_time, tl.execution_time))                 AS best_time,
         min(ua.submitted_at)                                             AS first_at
  FROM   user_attempts ua
  JOIN   test_level_exam_settings tl ON tl.test_level_id = ua.test_level_id
  JOIN   check_points cp ON cp.id = ua.check_point_id
  WHERE  ua.type_attempt = 'exam' AND ua.submitted_at IS NOT NULL
    AND  ua.grade > 0 AND ua.max_grade > 0
    AND  (ua.submitted_at AT TIME ZONE 'Asia/Ho_Chi_Minh') >= date_trunc('month', now() AT TIME ZONE 'Asia/Ho_Chi_Minh')
  GROUP  BY 1,2,3
), ranked AS (
  SELECT *, row_number() OVER (PARTITION BY learner_profile_id, test_level_id
                               ORDER BY best_grade DESC, first_at) AS k
  FROM counted WHERE NOT is_championship
), best10 AS (
  SELECT learner_profile_id, test_level_id,
         sum(best_grade) FILTER (WHERE k <= 10)   AS score10,
         count(*)                                  AS distinct_tests,
         sum(best_time)  FILTER (WHERE k <= 10)   AS counted_time,
         max(first_at)   FILTER (WHERE k <= 10)   AS final_score_at
  FROM ranked GROUP BY 1,2
), champ AS (                       -- đề vô địch một lượt của tháng
  SELECT learner_profile_id, test_level_id, best_grade * 10 AS champ_score, best_time AS champ_time
  FROM counted WHERE is_championship
)
SELECT b.learner_profile_id, b.test_level_id,
       b.score10 + coalesce(c.champ_score, 0) AS score,
       b.score10, c.champ_score, b.distinct_tests, b.counted_time, c.champ_time, b.final_score_at,
       row_number() OVER (PARTITION BY b.test_level_id
                          ORDER BY b.score10 + coalesce(c.champ_score, 0) DESC,
                                   c.champ_time ASC NULLS LAST, b.distinct_tests DESC,
                                   b.counted_time ASC, b.final_score_at ASC) AS rank,
       1 AS formula_version
FROM best10 b LEFT JOIN champ c USING (learner_profile_id, test_level_id);

Tiêu chí nghiệm thu

• Học sinh có mười hai bài: điểm bằng tổng mười điểm quy đổi tốt nhất; bài thứ mười ba không đổi điểm.
• Hai học sinh cùng 200 điểm: xếp theo thời gian đề vô địch, số bài khác nhau, thời gian mười bài được tính, rồi thời điểm đạt điểm cuối.
• Lượt thứ hai ở đề vô địch bị API từ chối kèm thông báo đọc được. Trước khung giờ, đề không hiện ở thư viện, tìm kiếm hay liên kết trực tiếp.
• Định nghĩa nằm trong migration kho exam, cho cùng thứ hạng trên dev và production.
• Huy chương trên bảng gắn theo hạng từ máy chủ, không theo chỉ số dòng.

10Yêu cầu B: điều kiện dự thi và hồ sơ

Ngày sinh

• Nhắc nhập ngày sinh trong ứng dụng học sinh và trên ranking.flyer.us: “Thêm ngày sinh để đủ điều kiện nhận xe đạp hằng tháng.”
• Lưu xong thì khoá (dob_locked_at); đổi phải qua phiếu hỗ trợ kèm giấy xác nhận hoặc giấy khai sinh.
• Kiểm tra: ngày trong khoảng 3 đến 20 năm trước hôm nay; ngoài khoảng bị API từ chối.
• Ngày sinh lưu từ ngày 20 trở đi không tính cho giải tháng đó, để không ai thêm ngày sinh thuận tiện sau khi đã thấy bảng.

Tính điều kiện dự thi

Tác vụ hằng đêm, chạy lại lúc chốt, ghi một dòng cho mỗi học sinh và cấp độ: đủ hay không, kèm lý do theo enum cố định để giao diện giải thích được.

Danh sách loại trừ

• Khởi tạo từ hồ sơ gắn với @flyer.us hoặc @flyer.vn, danh sách học sinh demo bị dời ngày, và hồ sơ thuộc quản trị đối tác.
• Duy trì trong trang quản trị (mục 12) với lý do và ngày hết hạn; tạm giữ vì tính trung thực hết hạn sau sáu tháng.

Trên bảng

• Mỗi dòng mang nhãn “Đủ điều kiện” hoặc “Không đủ điều kiện”. Mở nhãn: chính học sinh thấy lý do, người khác chỉ thấy dòng trung tính.
• Học sinh đã đăng nhập có thêm danh sách kiểm tra ở dòng chân: tài khoản, số phụ huynh, ngày sinh, khung tuổi, số bài được tính.

11Yêu cầu C: luồng nhận giải cho học sinh

Một trang trên ranking.flyer.us, mở từ thông báo hoặc banner, dành cho người thắng tạm thời và dự bị.

• Trạng thái: invited, draft, submitted, under_review, verified, rejected, expired, awarded, delivered; mỗi lần đổi đều báo phụ huynh.
• Dự bị thấy cùng trang, kèm dòng “Nếu hồ sơ người thắng không được xác nhận, học sinh có năm ngày để nộp”, và có thể tải lên sớm.
• Người bị từ chối thấy mã lý do và đầu mối hỗ trợ, chỉ được nộp lại một lần nếu lý do là “giấy chưa đầy đủ”.
• Bảng vinh danh /prize/winners: tên, trường, tỉnh thành, điểm, ảnh trao giải khi được đồng ý.
• Trang thể lệ /prize/rules hiển thị mục 5 và 6, song ngữ, kèm phiên bản công thức hiện hành.

12Yêu cầu D: quản trị và thẩm định

12.1 Chu kỳ

Danh sách chu kỳ trong admin-web, mỗi dòng một tháng và một cấp độ: trạng thái, top 10 đã chốt, và chuỗi người thắng, dự bị 1, dự bị 2 kèm người đang giữ giải.

12.2 Hàng đợi hồ sơ

Danh sách phẳng, lọc theo trạng thái và cấp độ. Mỗi hồ sơ mở một màn hình duy nhất: thẻ học sinh, dòng bảng đã chốt kèm chi tiết mười bài được tính, giấy đã tải lên, số giáo viên, tín hiệu trung thực (mục 13), nhật ký cuộc gọi, nút Duyệt hoặc Từ chối. Chu kỳ chuyển sang đã công bố khi cả năm cấp độ xong, hoặc vào ngày 12.

12.3 Loại trừ và ghi đè

Danh sách loại trừ kèm lý do, ngày hết hạn và nhật ký kiểm toán. Thao tác ghi đè thủ công để chuyển giải ngoài quy tắc tự động, bắt buộc có ghi chú và hiện trên chu kỳ.

12.4 Xác nhận của giáo viên ngay trong sản phẩm (giai đoạn 2)

Nếu học sinh thuộc lớp trên FLYER Teacher hoặc Teado.ai, hồ sơ nêu tên giáo viên đó và giáo viên xác nhận ngay trong sản phẩm bằng một lần chạm. Hồ sơ ghi lại tài khoản giáo viên, mạnh hơn một cuộc gọi. Giấy vẫn dùng cho học sinh không có giáo viên trên FLYER.

12.5 Xuất dữ liệu

CSV người thắng theo chu kỳ cho kế toán, và báo cáo tháng về hồ sơ theo kết quả và lý do.

13Chống gian lận và dấu vết kiểm toán

Quy tắc thôi chưa đủ: nền tảng phải đưa tín hiệu để CS xem xét có bằng chứng, và mọi quyết định phải dựng lại được.

• Cờ chỉ để tham khảo. Kết quả tự động duy nhất là các lý do ở mục 10, còn lại đều qua người xem xét.
• Mỗi chu kỳ lưu: bảng đã chốt, dòng điều kiện, hồ sơ kèm giấy và nhật ký cuộc gọi, mọi lần đổi trạng thái kèm người và thời điểm, phiên bản công thức. Không gì bị cập nhật tại chỗ.
• Học sinh bị tạm giữ vì tính trung thực được thông báo rõ, kèm đường hỗ trợ.

14Dữ liệu và thiết kế kỹ thuật

15Phạm vi, giai đoạn và ngân sách

Chi phí vận hành mỗi tháng

Trẻ sáu tuổi và học sinh mười sáu tuổi không đi cùng một cỡ xe. Mẫu nhận giải hỏi cỡ, mua sắm giữ hai mẫu.

16Câu hỏi mở