Willdom Lee

A Classroom Management System Built with AI on Weekends: iClassQuest

Teaching is hard, especially when you are a homeroom teacher. Every day, they move between group chats and spreadsheets—tallying scores, analyzing results, and communicating with parents—all to make sure no child's growth goes unnoticed.

From what I have seen, the daily workflow for managing classroom points looks something like this: open a paper scorebook, find the right page and name, add or subtract points, then total everything up each week and manually enter an Excel report. Students help with parts of the process, too.

After watching this for a year, I felt I had to do something. With AI taking off, I decided to spend my weekends making the tedious parts easier and helping every child's effort get noticed. That is how iClassQuest began.

What it looks like

In simple terms, the classroom screen displays seating, points, and rankings, and lets you click a student to add or subtract points. Teachers can also use their phones as remote controls. There is no need to walk over to the classroom computer or hunt for a name in a notebook. Two taps on a phone, and the score updates on the screen in real time. Standing, walking, or sitting—it never interrupts the lesson.

The classroom display supports adding and subtracting points directly.

The following demo data was randomly generated by AI; it is not real student data.

The mobile interface
Points can also be added or subtracted from a phone, with changes synced in real time.
Batch operations on mobile

But simply moving a paper scorebook onto a phone would not be particularly interesting.

Making points more engaging

I added a pet evolution system: every student gets a pet of their own, and the better they do, the stronger it becomes.

It starts as a dragon egg, then hatches into a baby dragon, a flying dragon, a great dragon, and eventually a legendary dragon 🐉. There are three evolution paths to choose from: dragons, plants, and mythical creatures.

Higher-level pets glow on the classroom screen, with halo effects and gently pulsing animations. The progression thresholds draw on flow theory in game design: quick early levels give students a sense of achievement, while slower progress later sustains their interest. The next level should feel neither out of reach nor so easy that reaching the top becomes boring.

There are also live leaderboards, group points, AI weekly report presentations with full-screen animations and AI narration, batch scoring, custom scoring rules, and one-click Excel exports. Together, these cover most of a homeroom teacher's daily scoring needs.

Developing with AI

To be honest, most of the code for this project was written with AI assistance.

I handled product design and architectural decisions; AI handled the coding. I stayed responsible for requirements, interaction details, and edge cases, while letting AI generate the implementation. This kind of human–AI collaboration is remarkably efficient.

The entire system took about three weekends plus the Labor Day holiday to go from zero to launch. It uses Vue 3, Node.js, SQLite, and Docker, and runs on Tencent Cloud.

The tool solves a real problem, and it also gave me a chance to put AI's engineering abilities to the test. AI was deeply involved at every stage, from frontend and backend development to deployment and operations. As I keep saying: instead of just watching what other people build with AI, try it yourself.

Want to try it?

The system has been running reliably in a classroom for a while now and is used every day.

If you are curious, I have set up a demo that you can open in a desktop browser. Its data resets automatically every day, so please do not save any private information:

Open on a computer: https://demo.iclassquest.com

After scanning the code on your phone, use the password demo.

An overview of the project: https://iclassquest.com

Teachers who are interested can leave a message on my WeChat account explaining why they need it. If the tool fits your needs, I can set up access completely free. This is a spare-time project, though, so places are limited, and I cannot promise service availability or support. If something goes wrong, I will probably only be able to look at it on the weekend. Please keep your expectations modest.

A quest is a search or an exploration. Let's keep exploring this interesting world together.

Visit the project website ↗

Originally published in Chinese on WeChat, 南山独唱团 · Read the original ↗