Training Portal Progress: What Should “Completed” Actually Prove?

Before commissioning a training portal, write down what “completed” means. Opening a lesson, acknowledging that it was read and passing an assessment are different events. A progress bar should describe the event you actually record, not imply that the learner has demonstrated a skill.

This matters for customer onboarding as well as internal learning. The guide is about software evidence and labels, not professional qualifications, legally required training or permission to perform hazardous work. Have any such requirements defined by the appropriate specialists.

Name the evidence behind each label

Start with plain definitions: not started, in progress, content completed and assessment passed, where those distinctions are needed. Do not add states just for appearance. For each one, identify the saved action that supports it and what the learner and reviewer can see.

The Odoo 19 eLearning guide illustrates why similar-looking numbers need care. Its public-view counter covers non-enrolled participants, while total views include enrolled and non-enrolled participants. Those counters are not defined as a count of learners who passed. The guide also has a lesson Duration field to enter, which should not be presented as evidence that a person spent that time studying.

For your app, distinguish a configured estimate from recorded activity. A timer, if requested, still needs a precise definition and should not be described as proof of attention.

Decide whether reading is enough

For a simple product introduction, a learner's acknowledgement may be sufficient for your business purpose. Say that the record shows an acknowledgement. If you need evidence of understanding, specify an appropriate assessment and the result it must record.

Odoo documents a separate quiz with possible answers and designated correct answers. That supports discussing assessment as its own feature; it does not establish the pass threshold, question quality or suitability for your training. Agree those with the content owner.

Write down how retries work, which result counts and whether feedback reveals an answer before a later attempt. A failed assessment should not become a pass merely because all lesson pages were opened. Equally, a learner should understand what remains instead of facing a permanently ambiguous percentage.

Keep completion attached to the content version

For a fictional onboarding course, imagine a lesson changes after a customer finishes it. Should the previous completion remain a historical result, should the new material be optional, or should the customer complete the changed lesson again? Choose a policy rather than silently changing everyone from complete to incomplete.

Record the relevant course or lesson version and the basis of completion. Decide how an authorised correction is explained. Adding an optional resource should not unexpectedly alter a required-completion calculation unless that is the stated rule.

These versioning and correction controls are proposed requirements, not capabilities established by the cited documentation. Scope them explicitly when selecting a ready-made product or commissioning a custom portal.

Test the record, not only the animation

Use fictional learners in the acceptance criteria. Open a page without acknowledging it, finish the required content, fail then retry an assessment and update a lesson after completion. Compare the learner screen, staff report and export with the agreed definitions.

Check that repeated views do not inflate completed-learner totals. Show which required item remains and what happens when a connection fails while saving progress. A success animation should appear only after the agreed result is recorded; unresolved saves need an honest retry or review route.

Bring a sample lesson and the intended evidence of completion to a training-portal discussion. The goal is a useful, explainable learning record. Neither a full progress bar nor a downloadable certificate automatically establishes competence or an external qualification.