Skip to content

Courses

Applies to: roles with Students.View (view) and Students.Edit (start and complete courses). Last reviewed: 2026-11-18.

A course is one student's enrolment on one training package. This page explains what a course is, its statuses, which course is the "active" one, how to view and complete a course, and how a student can have several courses over time.


1. What a course is

When a student is given a training package, DriveFlow creates a course record that links:

  • the student,
  • the branch,
  • the training package,
  • the licence code (empty for Assessment packages),
  • a status, a start date and, later, a completion date.

Lessons, driving tests and the package invoice are linked to the course they belong to. That is how DriveFlow keeps the lessons of a student's first package separate from the lessons of a second one.

Course versus training package

There is no separate list of courses for the school and no "course catalogue". A course only exists inside a student's profile. What other systems call a "course" (the thing you sell) is a training package in DriveFlow.


2. Course statuses

Status Meaning How a course gets it
Active The course the student is currently training on. Registration; Start New Course.
Purchased Bought and invoiced, but not started yet. An invoice line with Add as new course from this package ticked.
Completed Finished. Kept as history. Complete Course / Complete Active Course; or ticking "Complete the current course" when starting a new one.
Cancelled Exists in the list of statuses, but no screen or rule sets it. Not reachable.
flowchart TD
    R[Register Student] --> A[Active]
    S["Start New Course (new package)"] --> A
    I["Invoice line 'Add as new course from this package'"] --> P[Purchased]
    P -->|"Start New Course, pick the purchased course"| A
    A -->|Complete Course| C[Completed]

3. The active course

A student is meant to have at most one Active course. The Start New Course box enforces this: it will not start a course while another is Active unless you also choose to complete the current one.

The active course decides:

  • the lesson allowance - how many lessons the student may still book (Package allocation);
  • which course new lessons, driving tests and extra lessons are attached to;
  • what the profile's Overview shows under Active Course.

If, through older data, a student has more than one Active course, the one with the latest start date is treated as the active course.

A student can also have no active course, for example after their course was completed and before the next one starts. In that case the allowance is counted across everything the student has ever had (see Package allocation), and the Overview shows "No active course".


4. Where to see a student's courses

Who: users with Students.View.

Where: student profile > Courses tab - "View all training courses for this student."

Screenshot to be added

Screen: Student Profile, Courses tab. Should show: the Active / Completed / Total Courses cards, the Active Course card and the Course History table.

Summary cards

Active, Completed and Total Courses (counts).

Active Course

One card per Active course, showing:

  • the course name (the package name) and, beneath it, the package name and licence code;
  • a status chip;
  • Lesson Progress - completed / total, with a bar;
  • Total Lessons, Completed, Remaining;
  • "Started (date)";
  • View Course and Complete Course buttons.

On this card, Total Lessons is the package's lessons plus extra lessons added to the course, Completed counts lessons with the status Completed, and Remaining is total minus completed. (Lessons that are booked but not yet taken are still part of Remaining here.)

Course History

Every course that is not Active - Completed, Purchased or Cancelled - in a table:

Column Shows
Course The package name.
Licence The licence code, or "–".
Started Start date. For a Purchased course this is the date it was purchased.
Completed Completion date, or "–".
Lessons Completed / total.
Balance Always shows 0.00 (see Limitations).
Status Completed, Purchased or Cancelled.
(eye icon) View Course.

If the student has no courses: "No courses found - This student does not have any courses yet."

The active course is also summarised on the Overview tab, with its own View Course button.


5. Completing a course

Completing a course marks it as finished and frees the student to start another.

Who: users with Students.Edit.

Steps

Start from any of these places:

  • profile > Courses tab > Complete Course on the active course card;
  • the student's actions menu > Complete Active Course;
  • View Course > Complete Course (only offered there when the course's requirements are met; see section 6).

Then:

  1. The Complete Course box opens, showing the student's name and a summary: Course, Licence Code, Current Status, Lessons (completed / total).
  2. Read the warning - "You are about to mark this course as Completed." - and the What happens next? list.
  3. Set the Completion Date (required; starts on today).
  4. Click Complete Course.
  5. You see "Course completed successfully."

Screenshot to be added

Screen: Complete Course box. Should show: course summary, the "What happens next?" list and the Completion Date field.

What completing does

  • The course status becomes Completed and the completion date is saved.
  • The course moves to Course History. Its lessons, tests, invoices and payments stay available.
  • The student is not deactivated or deleted, and their status does not change.
  • The student now has no active course until a new one is started.

What completing does not check

No checks before completing

From the Courses tab and the actions menu, a course can be completed at any time: with lessons still outstanding, lessons still booked in the future, an unpaid balance, or no driving test passed. Nothing is cancelled or adjusted automatically. Check the View Course box first (section 6) if you want to know whether the course is really finished.

Messages

Message Cause
No active course for student Complete Active Course chosen for a student with no Active course.
No course found for student The student's courses could not be loaded.
Please select a completion date. The date was cleared.
Only an active course can be completed. The course is Purchased, Completed or Cancelled.
Course not found. The course no longer exists.
Unable to complete course. Refused without a specific reason.

After completing from the Courses tab, the tab does not refresh by itself; reopen the profile to see the course under Course History.


6. Viewing a course

Click View Course (Overview tab, active course card, or the eye icon in Course History). The Course Details box opens.

Screenshot to be added

Screen: Course Details box. Should show: Course Information, Lesson Progress, Course Requirements and Financial Summary sections.

Section Shows
Heading The licence code and its name, for example "B - Code B" (or "Course" when there is no licence code).
Student The student's name.
Course Information Training Package, Licence Code, Start Date, Completion Date, Branch.
Lesson Progress "N of M completed", a percentage, and Total, Completed, Remaining.
Course Requirements Learner's Licence (Completed / Pending), Training (Completed / Pending), Driving Test (Passed / Pending).
Financial Summary Total Invoiced, Paid, Outstanding - for the invoices linked to this course.
Notes Only if the course has notes.
Completion Only for an Active course (see below).

Important differences from the other screens:

  • In this box, Total is the number of lessons that have been booked on the course (in any status, including cancelled ones), not the number of lessons in the package. A student on a 10-lesson package with 4 lessons booked shows "Total 4". Use the Courses tab or the Lessons tab for the package figures.
  • Training: Completed here means the course status is Completed. It is not the student's Training Completed status.
  • Learner's Licence follows the Has Learners Licence tick on the student.
  • Driving Test: Passed means a driving licence test linked to this course has been completed with the result Passed.

The Completion section

For an Active course the box says either:

  • "Course requirements completed - This course is ready to be completed." with a Complete Course button, or
  • "The course is not yet ready for completion."

"Ready" means: every lesson booked on the course has the status Completed, and a driving licence test for the course has been passed. This is guidance only. It does not block completing the course from the Courses tab or the actions menu.


7. Several courses for one student

A student keeps one record for life, and gains a new course each time they take another package - for example Code B first, then Code EB a year later, or a learner's-only package followed by a lessons package.

  • All courses stay on the Courses tab.
  • Only the active course's lessons count towards the allowance, so an old course never uses up a new one.
  • The student's own package and licence code (shown in the profile header and Overview) always follow the most recently started course.
  • Each course is invoiced separately.

How to add a course is covered in Student enrolment.


8. Example

Lerato registered in January on "Learner's Licence - Code B" (0 lessons). In March she passes her learner's test and buys "Code B - 10 Driving Lessons".

  1. Reception opens Lerato's actions menu > Start New Course.
  2. The box shows her Active Course (the learner's package). Reception ticks Complete the current course.
  3. Licence Code Code B, Training Package Code B - 10 Driving Lessons. Start Course.

Result: the learner's course is Completed (dated today) and appears in Course History; a new Active course with 10 lessons starts today; a Pending invoice is raised for the new package; Lerato's status becomes In Training; her allowance is now 10 lessons, untouched by anything from the first course.


9. Limitations and notes

  • Cancelled is never set. There is no way to cancel a course. To abandon a course, complete it and correct the invoice by hand.
  • Course History "Balance" always shows 0.00. The list does not calculate a balance per course (GetStudentCoursesQueryHandler). Open View Course for the real figure under Financial Summary.
  • Course Details counts booked lessons, not package lessons, and its "Remaining" counts every booked lesson that is not Completed, including cancelled ones (GetCourseByIdQueryHandler).
  • Completing a course does not change the student's status and does not clear "training completed". A student whose course is completed stays, for example, In Training or Training Completed until another action changes it.
  • No checks when completing (lessons, balance, test).
  • The Courses tab does not refresh after Complete Course, and the Complete Course button on the card is shown to users without Students.Edit (the server refuses).
  • A course's notes cannot be entered anywhere; the Notes section only shows if data exists.
  • Course start date for a Purchased course is first the purchase date and is replaced by the real start date when the course is started.
  • Reopening a completed course is not possible.
  • Licensing a student does not complete their course (see Student status management).
  • The course endpoints are not gated by a plan feature, only by Students.View / Students.Edit (CoursesController.cs).