LMS & virtual classes.
An LMS is usually a filing cabinet for PDFs. This one is a classroom that keeps working after the bell. A course is a teacher's logbook with assignments, quizzes, a discussion forum, a live room, and a notebook for every student — all on one spine, all flowing into the same report card. And underneath it, a quiet accountability engine: the logbook a teacher fills after each period is the same record that releases — or holds — their salary. This handbook walks that whole building, from the course a teacher builds on Monday to the grade a parent reads on Friday.
- 12chapters
- 5actor types
- 30+LMS screens
- ≈22 minto read
Prologue
What an LMS is, and what this one adds#
Most learning-management systems are a place to upload a slide deck and collect a homework file. Useful, forgettable. YESS treats the LMS as the part of the school that happens between the lessons — the reading a student does at home, the question they were too shy to ask in class, the note they jot while the teacher writes on the board, the quiz that tells the teacher half the class never understood step three.
Three ideas run through every chapter. First, one spine: a course is a subject taught to one section by one teacher this term, and everything — modules, assignments, quizzes, the forum, the live room — hangs off it, and everything graded flows into the same gradebook the report card reads. Second, accountability: the teacher's logbook isn't paperwork, it's the record that proves a class was taught, and it gates the teacher's pay. Third, the parent is never the last to know — a new assignment, a missed deadline, a falling quiz average all reach the parent's pocket the same day.
The classroom, extended past its walls — and held to its word.
Chapter one
A course's life#
Greenwood — our example school throughout — runs Form 1A Mathematics this term. A course in YESS is exactly that precise: one subject, one section, one teacher of record, one term. Mr. Adjei opens /dashboard/courses and creates it. It is born a draft — invisible to students until he's ready.
He builds the spine: modules (Whole Numbers, Fractions, Introduction to Algebra), then topics under each, then resources under each topic — a lesson note, a YouTube link, a worksheet PDF. When he finds a better edition of a worksheet he uploads a new version; the old link stays alive for anyone who bookmarked it, but the canonical pointer moves to the new file.
When the spine is ready he flips the course to published. Two things happen automatically: every student in Form 1A is enrolled (no manual roster), and each student's /portal/courses now shows the course with a progress bar. As a student opens topics and ticks them complete, the course percentage rolls up on its own — and when they reach 100%, the enrolment quietly marks itself completed.
Chapter two
Lesson notes, and the question a student was afraid to ask#
A lesson note is the teacher's write-up of what was taught — rich text, tables, maths, images, attached files. Mr. Adjei publishes the day's note from the course's lesson-notes surface. Students read it on /portal/courses/<id>, and the system records a read receipt — so Mr. Adjei can see, at a glance, that 27 of 30 students opened the note and three never did.
Reading raises questions. A student highlights a line and asks it right there — a question thread anchored to the note. The teacher's reply surfaces inline; the asker is notified, and classmates who had the same question see the answer too. The shy question, asked and answered, without a hand going up.
Chapter three
The class, talking after hours#
Every class can have a forum — a per-class discussion board scoped to that subject and section. Mr. Adjei opens one from /dashboard/lms-forums, posts a welcome, and every Form 1A student is notified. A student posts a question about the decimal point and multiplying by ten; Mr. Adjei replies and pins the answer; classmates react.
The walls are real. A Form 2 student cannot read Form 1A's forum — visibility is scoped to the enrolled section, the teacher of record, and oversight roles. A teacher who doesn't teach that class cannot open a forum for it. Students see the forum inside their own course page, under Class discussion; teachers manage it from the dashboard. Everyone posts as themselves — a student can never appear as the teacher.
Chapter four
A notebook for every subject#
Each student gets a digital notebook per subject on /portal/notebooks. It has two sections. The Notes section is the class notebook — what the student copies from the board, visible to the teacher and parent. The Private section is a journal only the student can see ("I still don't get step 3 — ask Kofi at lunch").
The teacher's side is /dashboard/class-notebooks. Mr. Adjei designates the Maths notebook as the class default, then sees a roster: 27 of 32 students wrote notes today; five — flagged in red — wrote nothing. He taps a student's Notes section to check they copied the board correctly. The Private section stays closed to him.
Chapter five
Assignments, from posted to graded#
Mr. Adjei posts "Quadratic projects" on /dashboard/assignments — a title, instructions, a due date, max marks, the submission type (file, text, or link), attempts allowed, attachments, and whether late work is accepted. On publish, students and parents are notified it's there.
Work can be a group project — teacher-assigned, self-select, or hybrid-seeded groups, a student in only one group per assignment — managed at /dashboard/assignments/<id>/groups. A rubric can be defined at /dashboard/assignments/<id>/rubric, and individual students can be granted an /dashboard/assignments/<id>/extensions. Paper and off-platform work has its own surface, /dashboard/offline-assignments, so it can be recorded alongside platform submissions.
A student submits from their portal inbox at /portal/assignments. A plagiarism check runs on text submissions (exact-match and fuzzy similarity), surfaced for review at /dashboard/lms-plagiarism; late submissions are flagged. Mr. Adjei grades each submission from the Submissions tab on /dashboard/assignments — a score plus written feedback — and the grade flows into the gradebook (Chapter nine), so it counts toward the term mark.
Chapter six
Quizzes and online exams, with the answer key locked#
From /dashboard/quizzes a teacher builds a quiz — eight question types, drawn from a reusable question bank filtered by subject, difficulty and question type. A timer (configurable) counts the attempt down. On launch, students are notified.
A student takes the quiz from their own course page — under Quizzes on /portal/courses/<id> — with the timer running. The answer key stays sealed: while a quiz is open the student is served the questions and choices through a view that omits which choice is correct, so there is no way to peek ahead; grading happens on the server. A proctoring banner reminds the student they're being watched.
The instant a student submits, multiple-choice, true/false, short-answer and fill-in-the-blank questions are marked automatically and the score appears; essay and matching answers wait for the teacher. That result does two things on its own: it counts toward the term's assessment marks, and it updates the student's running quiz average that feeds the report card (Chapter nine). For end-of-term assessment, the separate online-exams module carries the stricter, recorded anti-cheat — forced auto-submit and tab-switch counts saved to the attempt.
Chapter seven
The logbook, and the salary it gates#
This is the chapter that makes YESS's LMS unlike any other. After each period, the teacher files a logbook entry on /teacher/logbook — topic covered, objectives, homework, how the class went. The entry is proof the lesson happened. The school sets a coverage goal on /dashboard/lms-settings/coverage-goals, and a compliance check compares each teacher's logged lessons against what the timetable expected — against a school-wide threshold (80% by default) — so the school can see which subjects are on pace and which are weeks behind.
The loop closes at payroll. A teacher who is materially behind has their salary release held — a database gate blocks the payroll run from marking them paid until the shortfall is accounted for. The teacher files a justification ("lost a week to elections, a week to the science fair") on /teacher/logbook-justifications; a reviewer accepts or rejects it on /dashboard/lms-justifications, and an accepted reason lifts the salary block for that month. Every step is tracked end to end: the lesson is logged, the school sees the updated compliance, payroll checks it before releasing pay, and a held salary is freed the moment a reviewer accepts the teacher's reason.
Chapter eight
The classroom, when the class isn't in the room#
A teacher schedules a live session from /dashboard/virtual-classes. YESS Live runs the stream right inside YESS, powered by LiveKit — no external app to install. Students are notified with a join link. When recording is enabled, the session recording is saved for anyone who missed the class. And when the school turns it on, live-class attendance flows into the daily register — viewers who watch at least half the session are marked present on the matching timetable period, so there's no double marking.
Chapter nine
How LMS work reaches the report card#
A school decides how much the LMS counts. On /dashboard/lms-grade-settings the admin sets the weights — an assignment weight and a quiz weight, capped by a maximum LMS contribution — with rules like "drop the lowest assignment or quiz" and a minimum number of submissions required to count. The two weights can't exceed the cap.
As assignments and quizzes are graded, each student's LMS contribution is recomputed and staged on /dashboard/lms-grade-contributions, then synced into the gradebook the report card reads. The teacher sees both the raw LMS scores and their weighted contribution to the final mark — nothing is locked away in a submission.
Chapter ten
Seeing the student who is sliding away#
Admins watch the whole school from /dashboard/lms-admin — every course's health, every teacher's pace — and the analytics at /dashboard/lms-analytics flags students at risk based on how far behind they are on course progress. A teacher can log an intervention and track whether it worked.
The system raises its own flags: behind-schedule logbooks, missing-logbook warnings, at-risk students — all on /dashboard/lms-alerts. Aggregated teacher performance and syllabus-progress reports live on /dashboard/lms-reports, ready to read and export to PDF or CSV.
Chapter eleven
One-on-one, by appointment#
A teacher publishes bookable office-hours slots from /dashboard/office-hours; a student reserves one. Each booking can open a live session, so the extra help happens face-to-face even when the student is at home.
Chapter twelve
The parent's window#
A parent opens their portal and sees, per child, one honest summary: assignments due this week, anything overdue, recent graded work and the average, recent quizzes, and any logbook approval waiting for them. The parent learns the LMS is working the same day it works — not at the report card.
The rhythm
The weekly cycle#
Once a term: the teacher creates or clones a course, fills modules and topics, publishes — and every section student is enrolled. Monday: post the week's resources and a new assignment; students are notified. Daily: students read notes (read receipts), jot in their notebooks, ask in the forum; the teacher files the logbook after each period. Wednesday: a quiz — taken, auto-graded, contribution updated. Friday: the assignment closes, late submissions are flagged, the teacher grades each submission, and scores sync to the gradebook. Monthly: the admin reads school-wide coverage and at-risk flags. Payroll: the logbook releases — or holds — the teacher's pay. Term end: LMS contributions land on the report card at the school's configured weight.
Where this connects
- 07Gradebook & continuous assessmentWhere LMS assignment and quiz scores land and become the term grade, at the weight the school configures.
- 06Class logbookThe after-period teaching record the LMS salary gate runs on — a class proven taught before payroll releases.
- 15Communication hubEvery publish, due date, forum reply and grade notification fans out to the family's pocket through here.
- 10Attendance engineLive-class attendance flows straight into the daily register — no double marking.
What makes this elite
- 1
The logbook gates salary
No other school LMS we surveyed ties the after-period logbook to payroll release. A class is proven taught before the teacher is paid — the accountability the founder asked for, configurable in severity per school.
- 2
The answer key stays sealed
While a quiz is open, students see the questions and the choices but never which one is correct — there's no way to peek ahead. The honour system is built in, not left to trust.
- 3
Offline and paper work still count
Paper and off-platform assignments have their own surface where a teacher records them, so they contribute to the grade alongside platform work — built for schools where the network isn't always there.
- 4
A notebook per subject, two sections
A Notes section the teacher and parent can see; a Private journal only the student sees — two surfaces in one notebook per subject, so the student's own writing stays exactly where they put it.
- 5
Auto-enrolment and progress rollup
Publish a course and the section is enrolled; tick a topic and the course percentage moves on its own. No manual rosters, no stale progress bars.
- 6
One spine to the report card
Course, assignment, quiz, rubric and standard all hang off the same course and flow into the same gradebook, at a weight the school controls.
Epilogue
A note on trust#
The screens in this book can be set up in an afternoon. The trust they encode takes a term to feel: that a student's question gets answered, that a parent isn't surprised, that a class isn't quietly abandoned, and that a teacher is paid for work the school can see. Every default leans that way — and every default can be changed, because the authors of this handbook have run classrooms too.
A course is a promise to keep teaching after the bell. This is how YESS keeps it.
Tutorial
Do it step by step#
The teacher's weekly path through the LMS, on the real screens — from the course built on Monday to the grade a parent reads on Friday.
- 1
Create the course
Mr. Adjei opens /dashboard/courses and creates Form 1A Mathematics — one subject, one section, one teacher, one term. It's born a draft, invisible to students until he's ready.Clone last term's course in one action — modules and resources deep-copy, enrolments and progress reset.
- 2
Build the spine and the notes
In the Content tab add modules → topics → resources; write the day's lesson note from the Lesson Notes tab — students get a read receipt when they open it. - 3
Publish the course
Flip it to published. Every Form 1A student is auto-enrolled and the course appears on /portal/courses with a progress bar that rolls up on its own as students tick topics complete.Publish is gated — a course needs at least one published topic, so no empty shells ever go live.
- 4
Post an assignment
From /dashboard/assignments post the work — instructions, due date, max marks, an optional rubric, groups. Students and parents are notified on publish, with reminders as the deadline nears. - 5
Collect and grade
Students submit on /portal/assignments; you grade each submission from the Submissions tab on /dashboard/assignments — a score plus written feedback. The score flows into the gradebook at the weight set on /dashboard/lms-grade-settings. - 6
Add a quiz for a pulse-check
Build one from /dashboard/quizzes. Multiple-choice, true/false and short answers auto-mark the instant a student submits, and the running quiz average feeds the report card — the answer key stays sealed while the quiz is open.
Course on Monday, grade on Friday — one spine, into the same report card.