Skip to content

🀝 Teammate @Liamlenguyen β€” stay tuned for more collabs from LUONVUITUOI TEAM ✨
πŸ“§ htkien95@gmail.com  Β·  πŸ“± +84 348 635 408

LUONVUITUOI-CERT

Config-driven certificate portal toolkit. Bring your PDF template and student list β€” get a full portal with search, download, admin panel, and QR verification in minutes.

release license tests stars

Why this exists

Running a competition, awarding diplomas to a cohort, issuing completion certificates? You typically need a public lookup page, an admin backend, and a verification endpoint β€” all wired together correctly. LUONVUITUOI-CERT gives you all three, deployable to Vercel's free tier or any Docker host, with zero boilerplate.

🎨

Bring your own template

Drop in a PDF + coordinates file. The engine overlays student names, dates, and QR codes pixel-perfect β€” no redesign required.

πŸ”

Public lookup portal

Recipients search by name or ID, preview their certificate, download signed PDF. Mobile-first, multilingual-ready.

πŸ”

Admin panel built in

Manage records, apply corrections, track shipments, audit log. Password-protected with JWT + rate limiting.

πŸ“±

QR verification

Every certificate carries a QR code linking to a public verify page β€” third parties confirm authenticity in one scan.

⚑

Deploy anywhere

One-command Vercel deploy (free tier), production Dockerfile, docker-compose β€” pick your infra.

πŸ“¦

Config over code

Single cert.config.json drives everything: branding, fields, overlay coords, auth, shipment rules. No forking required.

10min
First deploy
0
Boilerplate code
$0
Vercel free tier
MIT
License

Architecture

flowchart LR
    A[cert.config.json] --> B[Python serverless API]
    B --> C[Student portal<br/>/ + /verify]
    B --> D[Admin panel<br/>/admin]
    B --> E[(SQLite<br/>students)]
    B --> F[(KV backend<br/>overrides)]
    C -.QR scan.-> G[Verify page]

    style A fill:#fbbf24,stroke:#d97706,color:#0f172a
    style B fill:#0d6e6e,stroke:#0a5757,color:#fff
    style C fill:#14b8a6,stroke:#0d6e6e,color:#fff
    style D fill:#14b8a6,stroke:#0d6e6e,color:#fff
    style G fill:#ccfbf1,stroke:#0d6e6e,color:#0a5757

Next steps

πŸš€

Quickstart β†’

Deploy your first portal in 10 minutes β€” CLI scaffold, config tour, local run.

πŸ›οΈ

Architecture β†’

How the pieces fit β€” handlers, transport, KV, signing, data model.

βš™οΈ

Configuration β†’

Every cert.config.json field + environment variable documented.

πŸ”

Security β†’

Hardening checklist for production deploys.

πŸ› οΈ

Operations β†’

Health probe, log triage, audit trail, incident checklist.

🧭

Troubleshooting β†’

Common failure modes and their root causes.