The rule
A learner receives a certificate for a course when, all at once:
- the course offers a certificate (the Offer a certificate switch in the course editor),
- every lesson of the course is marked complete, and
- every required quiz of the course is passed (optional quizzes do not count).
The check runs on the server (certificateStatus in src/lib/learning.ts, used by issueCertificate in src/lib/learn.ts). The learner's course home shows what is still missing. When everything is done, the Issue my certificate button calls POST /api/learn/{slug}/certificate; asking twice returns the same certificate.
What it records
The certificate is a database row with a snapshot taken at issue time: the learner's name (as on their profile), the course title in both languages, the instructor's name, the learning hours (lesson minutes rounded to hours) and the date. Editing the course or the learner's name later does not change certificates already issued.
Each certificate gets a code like MRF-7KQ2-M9XD: random, unique, and written without the easily confused characters 0, O, 1, I and L.
Verification
/certificate/{code}shows the certificate with a "verified" badge. It is public: anyone with the code can open it. That is the link learners share with employers./verifylets anyone type a code and see whether it is genuine, with the name, course, hours and date.GET /api/certificates/{code}answers the same as JSON for other systems (rate-limited per visitor).
The certificate only shows what is printed on it; no email or other data is exposed.
Printing
The certificate page has Print or save as PDF. The print styles put it on one landscape A4 page without the site header and footer. Learners should choose landscape and turn off the browser's headers and footers in the print dialog.
Changing the design
The certificate is the component src/components/site/Certificate.tsx: academy logo and name, the learner's name over the highlighter stroke, the course, hours and instructor, the date, a seal with the code, and the signature from Dashboard > Settings > Signed by. Change the layout there; sizes use clamp() so it scales from phone to A4.
Revoking
To withdraw a certificate (for example after a refund), refund the order, which removes the enrolment and its certificate, or remove the enrolment in Dashboard > Enrolments. The verification page then answers "No certificate has this code".