← All guides

Teaching: programmes, week plan, lesson log and tests

The heart of the institute: what each subject teaches (the programme and its chapters), when the teacher teaches it (the week plan), what was really taught (the lesson log), and how students did (tests and scores). Draft your own programme below; the guide checks the weights and the time before you type it into the app.

Updated 2026-11-16. Three things moved:

See also the worked example From Year 1 to Year 2: one student, end to end — the same steps on live data, through year-end promotion.

The words used on the screens

On the screenIn plain wordsWho writes it
Programme (subject plan)One subject of one grade for the school year, for example Arabic, grade ALIMGY1.Admin
ChapterA part of the programme, in teaching order. Its weight is its share of the year; the weights add up to 100%.Admin
Objective (what students learn)One thing the teacher must teach in a chapter, with the number of lessons (periods) it should take.Admin
Week plan (lesson planning)Which objectives a class works on in which week. The teacher is free to move them.Teacher
Lesson log (what was taught)After each lesson: Done, Partly or Not today for each objective, and a note.Teacher
Chapter progressHow much of the programme a class has been taught, as one percentage.Counted by the app
Assessment (test)A quiz, unit test or exam for one class in one subject.Teacher
Scores: Draft / PublishedDraft = only staff see the scores. Published = the student, the parents and the report see them.Teacher

The big picture

1ProgrammeChapters, weights, objectives
→
2Week planObjectives into weeks
→
3Lesson logDone / Partly, every lesson
→
4ProgressWeighted % per class
→
5TestOnly taught chapters
→
6ScoresDraft, then published

Try it with the demo data

The UAT database has one complete example: Arabic (ARABICY1), class ALIMGY1C1, institution HidayatUnNisa_RUN. All passwords are password.

Sign in asOpenWhat you should see
hun.manager
Admin
Programmes (Chapters) › ARABICY1, ALIMGY14 chapters weighted 15 / 25 / 30 / 30 (Weights 100%), 12 objectives, an evaluation reserved after every chapter, 2 lessons of contingency. The Lessons of the year card shows 44 of 45 lessons — the real lessons of ALIMGY1C1 after holidays and the examination period. Try Export template, change a number, then Upload CSV.
hun.managerCalendar setup › Examination periodsTDEMO Term 1 examinations, 14–18 Dec: that week shows “no lessons” in the week plan.
hun.teacher.amma
Teacher
Week planChapters 1 to 3 spread over the weeks of Semester 1, each followed by its evaluation; chapter 4 and its evaluation waiting on the left. Press the test icon on a full week to add a test and see the three choices: move the plan forward, take from an objective, or keep.
Lesson logA warning that 2 Arabic lessons have no log. Open one, tick Done or Partly, save, and watch the chapter bar move.
Chapter progressProgramme about 33%: chapter 1 completed, chapter 2 in progress (one objective half done), chapters 3 and 4 not started.
Assessments (Tests) › ScoresGreetings quiz: published, one student absent. Alphabet unit test: draft, 3 of 6 scores entered — it is also on the dashboard under Tests to mark. Vocabulary oral test: planned on Monday's Arabic lesson; it replaces that lesson in My Schedule and the lesson log.
hun.student.01
Student
Evaluations & notesThe quiz score is there. The unit test is not, until the teacher publishes it. In My timetable, next Monday's Arabic lesson shows the oral test.

To put the demo back to its starting point, run openemis-core/sql/seed-teaching-demo.sql and then node openemis-core/sql/seed-teaching-demo.mjs.

Before you plan: the rules

  1. Setup first. Programmes and week plans can only be saved once the school has terms, a school day, holidays, the grade, its classes, the subject on every class with lessons per week, and a timetable. The Programmes page lists what is missing, with a Fix link for each.
  2. Real lessons. The year's lessons are counted from the timetable, minus holidays, closures, the examination period and any day type set to “No lessons” (Calendar setup › Calendar types). The programme is planned to the class with the fewest lessons.
  3. Fit the year. Objectives + reserved evaluations + contingency (default 2 lessons) must fit. A save that makes the plan too big is refused.
  4. Evaluations are reserved. The admin reserves an evaluation at the end of a chapter; the teacher chooses its week and its lesson. Teachers can add more tests.
  5. A test replaces a lesson. It is scheduled on one real lesson of the class; that lesson shows the test everywhere and needs no lesson log. Students absent in the register for that lesson start as Absent on the score sheet.

Draft your own programme

Chapters ()

1. Write the programme Admin

  1. Open Programmes (Chapters). With your institution chosen, the list shows every subject it offers; a subject with no chapters yet says Start programme.
  2. Add the chapters of in the order they are taught. Use the arrows to reorder.
  3. Give each chapter a weight: its share of the year. A harder or longer chapter weighs more. The badge at the top must read Weights 100%; Split weights evenly gives a starting point.
  4. Open a chapter to write what it covers and its objectives, usually one to three. For each, the number of periods (lessons) it should take.
  5. The second badge compares the periods you estimated with the lessons the year really has (lessons per week × teaching weeks). If it is over, the programme will not fit.
  6. Save programme. An objective that is already planned, taught or tested shows a lock: it can be reworded but not removed.

A programme belongs to the grade and the school year, so every class of that grade follows it. Each class has its own week plan and its own progress.

2. Plan the weeks Teacher

  1. Open Week plan (Lesson planning) and choose the class and subject at the top right.
  2. On the left are the objectives not planned yet, by chapter. On the right, the weeks; each shows how many lessons it really has, after holidays.
  3. Click a week to select it, then press + on an objective (or Add whole chapter). You can also drag an objective onto a week.
  4. Move an objective with the arrows on its card (one week earlier or later), or drag it. The small number is how many lessons of that week it takes; an objective can be spread over several weeks.
  5. A week that has more planned than it has lessons turns orange. It is a warning only: you decide.
  6. Save week plan. You can change it at any time; nothing is lost.

3. Log every lesson Teacher

  1. Open Lesson log (What was taught). It opens on today with your lessons; use the arrows or the date for another day.
  2. Log this lesson. The objectives planned for this week, and any you started earlier and did not finish, are already listed.
  3. For each: Done, Partly (then how much, for example 50%), or Not today. Taught something else? Add another objective I taught.
  4. Add a note when useful, for example “half the class away for a strike, will finish Thursday”. If nothing was taught, the note is required.
  5. Save log. The chapter bar shows where the chapter stands after this lesson. An unfinished objective comes back at the next lesson.

Every lesson should have a log; this replaces the paper record. The orange banner lists the lessons of the last 14 days that have none, and administrators see the same list for the whole institution.

4. Follow the progress

  1. Chapter progress (My programmes): one line per class and subject, with the programme percentage and how many lessons are not logged.
  2. Open a line to see each chapter: Not started, In progress or Completed, with its weight and its objectives.
  3. A teacher sees their own classes. An administrator or principal sees every class of the institution.

5. Plan a test Teacher

  1. Assessments (Tests) › Create assessment: type (quiz, unit test, exam), class, subject, date, time and whether it is written or oral.
  2. Press Scores on its line to open its sheet. Under Chapters assessed, pick what the test covers. A chapter with a lock has not been taught to this class yet and cannot be picked.
  3. Set what the scores are out of (20 by default) and whether the test counts toward the final result.
  4. The test now shows on the calendar of every student of the class, and in its week on the week plan.

6. Enter the scores Teacher

  1. From the day of the test, open Scores. Before that day the sheet is locked.
  2. Type a score per student; Enter jumps to the next one. A student who missed the test: press Absent. They get no score and do not lower the average.
  3. Save draft as often as you like. A draft is seen by staff only.

7. Publish Teacher

  1. When every student has a score or is marked absent, press Publish to students and parents.
  2. Students and parents are notified and see the score in their results; if the test counts, it goes into the report card average.
  3. To change a published score, type the new score and a reason. The change is logged with who, when and why, and the family is told the score changed.
  4. Take back to draft hides the scores again (also with a reason).

How progress is counted

Troubleshooting

You seeWhyWhat to do
A subject is missing from ProgrammesThe institution does not offer it for that grade and year.Add it in Subject Offerings.
The week plan says “no programme yet”The subject has no chapters for the grade of this class.An administrator writes it in Programmes (step 1).
Every week shows “No lessons this week”The class has no published timetable with this subject.Timetable Builder: place the lessons and publish.
A lesson is missing from the lesson logIt is not on the published timetable for that day, the day is a holiday, or it is outside the term.Check the timetable and Calendar Setup.
A chapter cannot be picked for a testNo lesson log covers it yet for this class.Log a lesson for it (step 3), then pick it.
“N students have no score” when publishingPublishing needs a score or Absent for everyone.Fill the gaps or press Absent.
A student cannot see a scoreThe scores are still a draft.Publish (step 7).
The old mark sheet refuses a mark (“use the score sheet”)A test of one class and subject is marked on its score sheet only.Assessments › Scores.