Skip to content

Part 4 of 7 · Training reminder bot series ~5 min read

How a completion gets recorded

A completion is the one write in this system that carries any weight, and the design question is not how to record it but who is allowed to and what that record has to contain to still be worth something in three years.

Key takeaways

  • Nobody confirms their own completion. It is the one permission rule in the system.
  • The record says who confirmed, when, and how the training was delivered.
  • An external qualification is recorded as a completion with its own expiry, not as an exception.
  • Evidence is optional and, when supplied, is a link rather than a stored document.
  • A completion is never edited. A correction is a new record superseding the old one.

Who confirms

How a training completion is confirmed and recordedA vertical chain of five steps entered by a box labelled Training happened, somehow. Step one asks who is confirming, checking the staff list for a manager or trainer, and never the person themselves; a self-confirmation exits to Refused. Step two asks how it was delivered, as a course, in house, or an external certificate. Step three computes the validity from the requirement's own validity period. Step four writes the completion to an append-only completions table that is never edited. Step five schedules the refresher at expiry minus the lead time. A note says the last step is why this system still works in year three.AWS ACCOUNTTraining happenedsomehowWho is confirming?never the person themselvesStaff listmanager, trainerRefusedself-confirmationthe same personHow was it delivered?course, in house,external certCompute the validityfrom the requirementRequirementsvalidity periodWrite the completionappend-onlyCompletionsnever editedSchedule the refresherat expiry minus leadThe last step is why this system still works in year three.
Fig 1. How a completion is recorded. The self-confirmation refusal is the only permission rule here, and the refresher scheduling is what makes the record self-maintaining.
  • Database
  • App integration
  • Security & identity
  • Management
  • Analytics
  • Front-end & mobile
  • People

Why no self-confirmation

Not because people are dishonest — overwhelmingly they are not — but because a training record where anybody can mark their own training complete is worth nothing to an insurer, an auditor or a client asking for evidence. The whole value of the record is that somebody other than the beneficiary attested to it.

The rule is enforced by comparing the confirming address with the subject’s, which is crude and sufficient. In practice a supervisor confirms for their team, a trainer confirms for a session, and both are recorded by name.

External qualifications

Somebody arrives already holding a first-aid certificate. That should satisfy the requirement, and the wrong way to do it is a person-level exception saying they do not need it. The right way is a completion of type external with the certificate’s own expiry date rather than the requirement’s default validity.

That distinction matters in three years: an exception says nothing about when it stops being true, whereas an external completion carrying the certificate’s real expiry will generate a refresher assignment on the right date, exactly like an internal one.

Evidence

What a training completion record contains for four delivery typesA horizontal row of five boxes. In house: who trained and who attended. External course: the provider and the date. Certificate: a link rather than a copy. Toolbox talk: the topic and the attendees. Enough to stand up: without being a document store. A note says a link to wherever the certificate already lives beats a second copy of it here.WHAT A COMPLETION RECORDSIn housewho trained, who attendedExternal courseprovider and dateCertificatea link, not a copyToolbox talktopic and attendeesEnough to stand upwithout being a document storeA link to wherever the certificate already lives beats a second copy of it here.
Fig 2. What each kind of completion carries. The system records enough to be evidence and deliberately does not become a document store.
  • Machine learning
  • Networking
  • Front-end & mobile
  • People
  • Outside AWS

Keeping a link rather than a copy is a deliberate limitation. Certificates already live somewhere — the certification tracker from Day 85, a shared drive, the provider’s own portal — and a second copy here would need its own retention policy for no additional assurance.

Corrections

A completion recorded against the wrong person, or with the wrong date, is corrected by a new record that supersedes it, and both stay. Editing in place would produce a training record that cannot be relied on, which is the only thing this system produces.

Next: the gap report, and why it is about roles rather than people.

All posts