CPD Automations
Feature Overview
Scoring rules that convert PPP platform interactions (Logbook cases, WBAs, Reflections, Audits, MCR, MSF, PPP360) into CPD points for full-platform users. Matt explicitly split this out from CPD Home on 22–23 Apr: CPD Home is the user-facing dashboard; CPD Automations is the engine.
Source
- CPD Automations Notion page (blank at time of writing — Matt to populate after full platform-interactions list is agreed)
- 23 Apr 2026 catchup transcript
Status — pending scope call
Matt needs the full list of platform interactions (user ↔ consultant ↔ non-consultant) before mapping them to AMC categories + points. That call is explicitly on the agenda (22 Apr Notion comment: "let's do a call on all interactions between users consultants and non consultants and I can review to see if they could trigger CPD activities/hours").
Until then, the live auto-scoring behaviour is the existing handler in cpdUserActivityHandler.ts:
| Trigger | Condition | Who earns | AMC activity | Category | Points (default / max/yr) |
|---|---|---|---|---|---|
| Logbook — consultant present for case (Supervision branch) | Present-for-case involvement, verified | Consultant | Supervision of surgical trainees | Performance Review (Others) + Education | ⚠️ see note / max 15 |
| Logbook — consultant present for case (Teaching branch) | Present-for-case involvement, verified | Consultant | Teaching to trainees / undergraduates | Performance Review (Others) + Education | ⚠️ see note / max 20 |
⚠️ What the two Logbook rows actually do today (read-only code check, 2026-10-03 — Task 8 refresh): "present for case" is the hard-coded
PRESENT_FOR_CASE_INVOLVEMENT_OPTIONS=S-S/S-U/S-H(packages-shared/ppp/src/constants/logbook/involvement.ts); points areMath.round(operativeTime ÷ 60)per verified case when operative time is recorded (no minute banking; a case under 30 min earns 0 and the minutes are lost), otherwise a flat 1; and the 15 / 20 "max" values only steered which of the two activities is picked until #12742 — they are now enforced per CPD year. Matt's current rules differ on all three — seecpd.automations.consultant-supervising-qualifying-lois,cpd.automations.per-hour-minute-bankingandcpd.automations.supervision-teaching-yearly-capsbelow (drift → #12725; caps built, #12742). Credit once per operation, the consultant's own log wins: when the consultant also logged the same operation themselves (the two logbook rows share asurgicalCaseId), signing off the trainee's case adds no further credit, whatever their own LoI earned (Rob, 4 Oct 2026, #12814). | Reflection shared | Verified by consultant | Reflection owner | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap | | WBA — trainee submits | Verified by consultant | Trainee | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap | | Audit event | Verified + feedback received | Audit owner | Peer Review of Cases/Charts with Feedback | Reviewing Perf (Self) | 1 / no cap |
Either/or NOT both (Matt's CPD Sheet, 5 May): for the consultant present-for-case logbook flow, points credit one of the two branches (Supervision OR Teaching) per case — never both. Branch chosen by the auto-bucket category resolver (deficit-driven, fewest hours, ties → first listed).
Points rule (all rows) — as built in the legacy verify path: if operativeTime (minutes) exists, points = round(minutes ÷ 60). Else default 1. AMC "1 hour = 1 point". Superseded for supervising/teaching credit by Matt 2026-06-24 / 2026-07-21 (#9200): per whole hour with every minute banked — see cpd.automations.per-hour-minute-banking.
Single source of truth: the Logbook supervision/teaching rows above are implemented per the multi-user / supervisory-credit acceptance criteria in
cpd-activities.md(#7456derived-credit record,#7457computeSupervisoryCredit), capped at the 15h supervised-training requirement defined incpd.md. This table is the engine-level overview only — it does not redefine those ACs.
Matt's 23 Apr refinement (parked for later): rounding loses fractional hours. Proposal: backend accrues residual minutes; converts to a point only when total reaches an hour. Agreed: refine later, not at MVP. Superseded 2026-06-24 → 2026-07-21: Matt made minute banking the rule on #9200 ("CPD is per hour; collected from operative minutes; to be counted upon hour complete; but stored on minutes and conversion when multiples of 60 (mins) reached"; restated 2026-07-21 "Hours - convert at the hour but are stored by the minute"). Built for the self-LoI path (cpd.multi-user.self-loi-credit.minute-banking in cpd-activities.md); not yet in the consultant sign-off path (#12725).
Now auto-scored (was a gap — wired in #5704)
MCR, standalone MSF, and PPP 360 Review now auto-score on verify/completion as cpd.manual.msf-structured-framework — see § Auto-scoring — multisource feedback for the ACs and code references. (Originally parked — Matt 22 Apr: "I believe yes [add auto-scoring]; let me map once I get a complete list of platform interactions.")
By design — NOT CPD (deliberate exclusions)
These platform interactions are intentionally not auto-scored as CPD — documented here so the boundary is explicit and nobody later wires them in by mistake (they belong to other telemetry pipelines):
- Timesheet entries (feed fatigue/wellbeing telemetry, not CPD)
- Wellness questionnaires (feed PPP Pulse, not CPD)
Open Questions (Matt)
| # | Question | Why it is open | Ref |
|---|---|---|---|
| Q6 | Does a registrar's TaT (Training another Trainee) logbook case still need the consultant to verify it before the teaching CPD credit lands? | Your CPD Sheet (5 May) marks cpd.auto.reg-logbook-teaching "Verification: Yes". Your 21 Jul #9200 ratification ("TaT needs to be added back … YES"; "select lowest bucket to automatically attribute activities to Surgical logbook entry") doesn't mention verification. The #9200 build credits TaT as soon as the case is logged (status verified), with no consultant step. | #9200, Matt's CPD Sheet |
| Q7 | When a consultant has already reached a yearly cap (Supervision 15h / Teaching 20h), should extra supervising minutes be dropped, moved to the other activity, or banked? | You confirmed the caps (5 May sheet; 29 Jul call "16 … in the final column maximum per year"). You haven't said what happens to hours past them. #12742 needs the answer. | #12742 |
Earlier questions Q1–Q5 are answered — see Closed Questions below.
Closed Questions (5) — click to expand
| # | Question | Resolution |
|---|---|---|
| Q1 | Full list of platform interactions (users / consultants / non-consultants) — the call | Resolved (Matt, 5 May): Full platform interactions list answered by Matt's CPD Sheet (Drive 1UYu1ts2RRjT3tb-QZdU8eW-cD2EQmxFHUFqAFabq_v8, "Working Sheet" tab). 12 in-app interactions defined for Registrar + Consultant flows across WBA / Logbook / Reflection / Feedback / Audit, plus 6 explicit "no CPD" rules. Currently auto-scored: 4. Remaining 8 are tracked in implementation issue #5679. See Full Interaction Catalogue below. |
| Q3 | Current maxes (20 for TaT/Supervision) — still correct per AMC, or follow Governing Document more closely? | Resolved (Matt, 5 May): Supervision of surgical trainees max = 15 hrs/yr (1 per hour). Teaching to trainees / undergraduates max = 20 hrs/yr (1 per hour). Source: Matt's CPD Sheet. The current code in cpdUserActivityHandler.ts has these inverted (says "1 / 20 (15 fallback)" for Supervision) — bug to fix in implementation issue #5679. |
| Q4 | "No cap" rows — confirm AMC accepts unlimited points, or add caps? | Resolved (Matt, 5 May): Confirmed by Matt's CPD Sheet — Reflection / WBA / Audit / Peer Review of cases = "No Max" (uncapped). Sheet uses "No Max" where AMC doesn't specify a cap. Where AMC does specify a cap (e.g. Council meetings = 30, eLearning = 20, ASERNIP-S = 10), those caps are now in scope for implementation. See Full Interaction Catalogue below. |
| Q2 | MCR (Multi-Consultant Report) and PPP 360 Review — AMC category + cap? | Resolved (5 May, after CPD Sheet review): MCR, MSF, and PPP 360 are all PPP-specific names for the AMC concept "Multisource feedback using a structured framework". All three map to the same row in Matt's CPD Sheet — cpd.manual.msf-structured-framework: Performance Review – Self / Performance Review – Others, 1 per activity, No Max. Each instrument counts as a separate activity (running an MCR + an MSF in the same year = 2 entries, 2 points). Surfaced in product as 3 distinct activity types so doctors recognise their own tooling, but they share the same AMC rule. |
| Q5 | Residual-minute accrual proposal — adopt now or defer? | Resolved (Matt, 23 Apr): Defer. "Refine later, not at MVP." Current rule stays: if operativeTime (minutes) exists, points = round(minutes ÷ 60); else default 1. Residual-minute accumulation is a post-MVP refinement only. ⚠️ SUPERSEDED 2026-06-24 / 2026-07-21 (Matt, #9200): minute banking is now the rule — see cpd.automations.per-hour-minute-banking. |
Full Interaction Catalogue (Matt's CPD Sheet)
Source of truth: Matt's CPD Sheet — "Working Sheet" tab. Each row below is a contracted AC keyed by an AC ID.
In-app actions that score CPD (12 rows)
Rule: where Matt's "Notes" column says "Either/or NOT Both" (Logbook present-for-case), only one branch may fire per case — the auto-bucket category resolver (deficit-driven, fewest hours, ties→first) decides which.
| AC ID | User Type | In-app action | Verification | CPD Activity | Primary Category | Alternate Categories | Points | Max/yr |
|---|---|---|---|---|---|---|---|---|
cpd.auto.reg-wba-submit | Registrar | WBA — upload + optional reflection + assessed by consultant | Yes | Peer review of cases / charts with feedback | Audit | Performance Review – Self | 1 per entry | No Max |
cpd.auto.cons-wba-assess | Consultant | WBA — assess registrar's WBA | No | Supervision of surgical trainees (Teaching once at cap) | Review of Performance; Education | — | 0.5 h per sign-off (#12712) | 15 h Supervision / 20 h Teaching per year |
cpd.auto.reg-logbook-teaching | Registrar | Logbook — upload item with Level of Involvement = T + verified | Yes | Teaching to trainees / undergraduates | Performance Review – Others | Education | 1 per hour | 20 |
cpd.auto.cons-logbook-supervision ⚠️ drift | Consultant | Logbook — assess registrar's logbook + present for case (Supervision) | No | Supervision of surgical trainees | Performance Review – Others | Education | 1 per hour | 15 |
cpd.auto.cons-logbook-teaching ⚠️ drift | Consultant | Logbook — assess registrar's logbook + present for case (Teaching) | No | Teaching to trainees / undergraduates | Performance Review – Others | Education | 1 per hour | 20 |
cpd.auto.cons-logbook-feedback | Consultant | Logbook — assess registrar's logbook + give feedback | No | Peer review of cases / charts with feedback | Audit | Performance Review – Others | 1 per involvement | No Max |
cpd.auto.reg-reflection-shared | Registrar | Reflection — personal reflection + share to consultant + receive fb | Yes | Peer review of cases / charts with feedback | Audit | Performance Review – Self | 1 per entry | No Max |
cpd.auto.reg-feedback-given | Registrar | Feedback — give feedback to consultant / registrar | Yes | Structured conversation with a peer | Performance Review – Others | — | 1 per involvement | No Max |
cpd.auto.cons-reflection-shared | Consultant | Reflection — personal reflection + share to consultant + receive fb | Yes | Peer review of cases / charts with feedback | Audit | Performance Review – Self | 1 per entry | No Max |
cpd.auto.cons-feedback-given | Consultant | Feedback — give feedback to consultant / registrar | Yes | Structured conversation with a peer | Performance Review – Others | — | 1 per involvement | No Max |
cpd.auto.reg-audit-verified | Registrar | Audit — upload + verified by other user + receive feedback | Yes | Peer review of cases / charts with feedback | Audit | Performance Review – Self | 1 per entry | No Max |
cpd.auto.cons-audit-verified | Consultant | Audit — upload + verified by other user + receive feedback | Yes | Peer review of cases / charts with feedback | Audit | Performance Review – Self | 1 per entry | No Max |
In-app actions that DO NOT score CPD (6 rows)
| AC ID | User Type | In-app action | Reason from sheet |
|---|---|---|---|
cpd.auto.no-reg-wba-base | Registrar | WBA — upload + assessed (without reflection share path) | Registrar does not get CPD for this (covered by row 1) |
cpd.auto.no-reg-logbook-non-teaching | Registrar | Logbook — upload + verified (involvement ≠ T) | Registrar gets CPD only when level of involvement is T |
cpd.auto.no-reg-reflection-private | Registrar | Reflection — personal reflection only (no share) | No CPD until shared + feedback received |
cpd.auto.no-cons-reflection-private | Consultant | Reflection — personal reflection only (no share) | No CPD until shared + feedback received |
cpd.auto.no-reg-audit-bare | Registrar | Audit — upload only (no verification, no feedback) | No CPD until verified + feedback received |
cpd.auto.no-cons-audit-bare | Consultant | Audit — upload only (no verification, no feedback) | No CPD until verified + feedback received |
Manual upload activities (50 rows)
Rule: each row creates an entry in the master CPD activity master list; user uploads evidence; activity is verified by an accreditor before points credit. Points and Max/yr exactly as per Matt's CPD Sheet.
| AC ID | Activity | Primary Category | Alternate Category 1 | Alternate Category 2 | Points | Max/yr |
|---|---|---|---|---|---|---|
cpd.manual.specialty-society-audit | Specialty Society Audit | Audit | — | — | 1 per activity | No Max |
cpd.manual.specialty-group-audit | Specialty Group Audit | Audit | — | — | 1 per activity | No Max |
cpd.manual.clinical-unit-audit | Clinical Unit Audit | Audit | — | — | 1 per activity | No Max |
cpd.manual.locum-logbook | Locum Logbook | Audit | — | — | 1 per activity | No Max |
cpd.manual.malt-with-peer-review | MALT with peer review | Audit | — | — | 1 per activity | No Max |
cpd.manual.total-practice-audit | Total Practice Audit | Audit | — | — | 1 per activity | No Max |
cpd.manual.selected-audit-surgical-practice | Selected audit from surgical practice | Audit | — | — | 1 per activity | No Max |
cpd.manual.org-review-surgical-services | Organisation review of surgical services | Audit | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.patient-feedback-action-plan | Patient feedback including action plan | Audit | Performance Review – Self | — | 1 per activity | No Max |
cpd.manual.peer-review-of-reports | Peer review of reports | Audit | Performance Review – Self | Performance Review – Others | 1 per activity | No Max |
cpd.manual.peer-review-cases-charts | Peer review of cases / charts with feedback | Audit | Performance Review – Self | Performance Review – Others | 1 per activity | No Max |
cpd.manual.structured-conversation-peer | Structured conversation with a peer | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.anzasm-surgical-case-form | ANZASM surgical case form | Audit of Surgical Mortality | — | — | 1 per activity | No Max |
cpd.manual.anzasm-first-line-assessment | ANZASM first line assessment | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.anzasm-second-line-assessment | ANZASM second line assessment | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.committee-meetings-educational | Committee meetings with educational content, such as guideline development | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.morbidity-mortality-meetings | Mortality and Morbidity meetings | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.mentoring-mentor | Participation in a structured mentoring program — mentor | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.mentoring-mentee | Participation in a structured mentoring program — mentee | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.practice-visitor | Practice visitor | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.recipient-practice-visit | Recipient of a structured practice visit by a peer | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.cpd-coach-being-coached | CPD Coach (being coached) | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.cpd-coach-as-coach | CPD Coach (as coach) | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.meetings-administrators | Meetings with administrators / management | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.meetings-adverse-events | Meetings reviewing adverse events | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.annual-individual-dept-review | Participation in an annual individual or department performance review | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.reviewer-trauma-verification | Reviewer Trauma verification | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.peer-discussions-critical-incidents | Peer discussions of critical incidents, safety and quality reviews | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.referring-doctor-satisfaction | Referring doctor's satisfaction survey | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.examiner-racs-amc-uni | Examiner RACS, AMC, university | Performance Review – Others | — | — | 1 per activity | No Max |
cpd.manual.surgical-attachment-peer | Surgical attachment with peer | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.patient-care-satisfaction | Patient care satisfaction survey | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.msf-structured-framework | Multisource feedback using a structured framework | Performance Review – Self | Performance Review – Others | — | 1 per activity | No Max |
cpd.manual.comprehensive-health-gp | Comprehensive health assessment with your GP | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.post-operative-questionnaire | Post-operative satisfaction questionnaire | Performance Review – Self | — | — | 1 per activity | No Max |
cpd.manual.supervision-surgical-trainees | Supervision of surgical trainees | Performance Review – Others | Education | — | 1 per hour | 15 |
cpd.manual.asernip-s | Participation in ASERNIP-S review, a clinical trial or organised clinical research | Performance Review – Self | Performance Review – Others | Education | 1 per hour | 10 |
cpd.manual.referee-journal-article | Acting as a referee for a journal article | Performance Review – Others | Education | — | 5 per activity | 15 |
cpd.manual.publication-book | Publication of a surgical / medical book | Performance Review – Self | Performance Review – Others | Education | 30 per activity | No Max |
cpd.manual.publication-journal-chapter | Publication in a refereed journal / chapter in surgical/medical book | Performance Review – Self | Performance Review – Others | Education | 15 per activity | 30 |
cpd.manual.hospital-clinical-meeting | Hospital clinical meeting attendance | Performance Review – Self | Performance Review – Others | Education | 1 per hour | No Max |
cpd.manual.presentation-scientific-meeting | Presentation to surgical / medical peers at a scientific meeting | Performance Review – Self | Performance Review – Others | Education | 10 per activity | 20 |
cpd.manual.small-group-learning | Structured and approved small group learning e.g. Journal Club | Performance Review – Self | Performance Review – Others | Education | 1 per hour | 10 |
cpd.manual.volunteer-services | Participation in volunteer services | Performance Review – Self | Performance Review – Others | Education | 1 per hour | 20 |
cpd.manual.surgical-meetings-mm-mdt | Surgical meetings including M&M, multidisciplinary etc | Performance Review – Self | Performance Review – Others | Education | 1 per hour | No Max |
cpd.manual.attendance-scientific-meetings | Attendance at scientific meetings | Education | — | — | 1 per hour | No Max |
cpd.manual.attendance-racs-courses | Attendance at RACS courses / workshops | Education | — | — | 1 per hour | No Max |
cpd.manual.attendance-specialty-society-courses | Attendance at Specialty Society courses / workshops | Education | — | — | 1 per hour | No Max |
cpd.manual.attendance-specialty-association-meeting | Attendance at Specialty Association or Society scientific meeting | Education | — | — | 1 per hour | No Max |
cpd.manual.cultural-competence-safety | Cultural Competence and Cultural Safety | Education | — | — | 1 per hour | No Max |
cpd.manual.development-educational-material | Development of educational material | Education | — | — | 1 per hour | 15 |
cpd.manual.elearning | eLearning | Education | — | — | 1 per hour | 20 |
cpd.manual.journal-reading | Journal reading / researching clinical information / informal discussions | Education | — | — | 1 per hour | 20 |
cpd.manual.other-courses-nontechnical | Other courses / workshops that focus on non-technical competencies | Education | — | — | 1 per hour | No Max |
cpd.manual.other-interactive-clinical-workshops | Other approved interactive surgical or clinical workshops | Education | — | — | 1 per hour | No Max |
cpd.manual.overseas-meetings-recognised | Overseas meetings with CPD-recognised national body | Education | — | — | 1 per hour | No Max |
cpd.manual.tertiary-courses | Participation in other courses at tertiary institutions or another recognised provider | Education | — | — | 1 per hour | 20 |
cpd.manual.presentation-other-health-prof | Presentation to other health professionals' / community groups | Education | — | — | 1 per hour | No Max |
cpd.manual.specialty-group-meetings-racs | Specialty group meetings including RACS | Education | — | — | 1 per hour | No Max |
cpd.manual.council-board-committee-meetings | Council / board committee meetings | Education | — | — | 1 per hour | 30 |
cpd.manual.teaching-on-courses-workshops | Teaching on courses / workshops | Education | — | — | 1 per hour | 30 |
cpd.manual.teaching-racs-courses | Teaching on RACS courses / workshops | Education | — | — | 1 per hour | 30 |
cpd.manual.teaching-specialty-society-courses | Teaching on specialty societies' courses / workshops | Education | — | — | 1 per hour | 20 |
cpd.manual.teaching-trainees-undergraduates | Teaching to trainees / undergraduates | Performance Review – Others | Education | — | 1 per hour | 20 |
Note on row count. Sheet contains 51 manual-upload data rows; this catalogue lists 51 rows here (counting
Hospital clinical meetingonce even though the sheet has a duplicate "Time required" annotation in column M). Engineering will verify before migration.
Acceptance Criteria
Status: Q1 (the interactions list) was answered by Matt's CPD Sheet on 5 May; the full catalogue above is the contract. The built rules are listed here. The supervising/teaching rules were refreshed on 2026-10-03 against Matt's #9200 ratification (Task 8, #11192).
Auto-scoring — built rules
✅ Logbook case where consultant is marked "present for case" and the involvement is verified → consultant earns 1 CPD point (Reviewing Performance of Others + Education; max 20/yr; Teaching fallback at 15)— retired 2026-10-03. This had the caps the wrong way round (Matt's CPD Sheet, 5 May: Supervision 15, Teaching 20 — Q3). It also described a flat point, which Matt's #9200 rules have since replaced. It is replaced by the three ACs below.- ✅
cpd.automations.consultant-supervising-qualifying-lois— when a consultant verifies a non-consultant's logbook case, the consultant earns supervising/teaching CPD credit only when their involvement is one of the Levels of Involvement Matt ratified as supervising:PPT(Performed in part by non consultant),S-S(Supervising, scrubbed) andS-U(Supervising, in theatre).S-H(Supervising, in hospital) andPCC(Performed with consultant colleague) earn nothing. The qualifying set comes from the same admin-editableearns_cpd_creditflag the self-LoI path reads (cpd.multi-user.self-loi-credit.qualifying-loisincpd-activities.md). The credit goes to Supervision of Surgical Trainees or Teaching to Trainees / Undergraduates, using the "select lowest bucket" resolver. One operation credits the consultant once (#12814, Rob 4 Oct 2026): a signed-off case is not banked when the consultant logged their own entry for the same operation (same surgical-case parent). Their own log wins. † Built in #12725: the verify path now delegates tosyncSignOffSupervisionCredit, which qualifies offearns_cpd_credit(S-H earns nothing, PPT does). Recomputing a consultant's year also removes their pre-#12725 sign-off rows, so each signed-off case is credited once. Double credit when the consultant also logs the same operation is not covered here. It is still open: Q-signoff-cpd-double-credit → #12814. ‡ - ✅
cpd.automations.per-hour-minute-banking— supervising/teaching CPD from a logbook case is earned per whole hour of operative time. Every minute is stored, and a remainder under an hour is banked and carried to the next case in the same CPD year. For example, a 125-minute case earns 2 hours with 5 minutes banked. This applies to every supervising/teaching auto-credit path, including consultant sign-off. CONTRADICTS the retired 23 Apr "defer residual minutes" decision (Q5) and theround(minutes ÷ 60)rule below. † Built in the self-LoI path (selfSupervisionCreditService,cpd_supervision_minute_bank). Built in #12725 for the consultant sign-off path too: signed-off cases join the assessor's banking pool viasyncSignOffSupervisionCredit. ‡ - ✅
cpd.automations.supervision-teaching-yearly-caps— auto-scored Supervision of Surgical Trainees credit is capped at 15 hours per CPD year and Teaching to Trainees / Undergraduates at 20 hours per CPD year. No auto path can take a doctor past either cap in a year. † Enforced (#12742) byallocateCappedCpdCrediton both auto paths — the self-supervision credit and the legacy verified-TaT branch. It sums the doctor's points per activity in the case's CPD year only, clips a credit to the room left, sends the overflow to the other activity if it has room, and credits nothing once both are full. What should happen to hours past the cap (dropped today, or banked) is still Open Question Q7. ‡ - ✅ Reflection shared and verified by a consultant → reflection owner earns 1 CPD point (Reviewing Performance of Self; no annual cap)
- ✅ WBA submitted by trainee and verified by consultant → trainee earns 1 CPD point (Reviewing Performance of Self; no annual cap)
- ✅ Audit event verified with feedback received → audit owner earns 1 CPD point (Reviewing Performance of Self; no annual cap)
- ✅ If the source record is a logbook case with
operativeTime(minutes), points =round(minutes ÷ 60)— implements AMC "1 hour = 1 point" rule. Superseded for supervising/teaching credit bycpd.automations.per-hour-minute-banking(Matt, 2026-06-24 / 2026-07-21). This is still the built rule for the other verify-path rows. - ✅ If
operativeTimeis absent, default = 1 point - ✅ Auto-scored points appear in the user's CPD activity log alongside manually entered activities
- ✅ Auto-scored points count toward the annual 50h target and category totals on CPD Home dashboard
Auto-scoring — multisource feedback (MCR / MSF / PPP 360)
All three map to AMC's "Multisource feedback using a structured framework" — Performance Review – Self / Performance Review – Others, 1 per activity, No Max. Each instrument is logged separately (an MCR and a PPP 360 in the same year = 2 entries) but they share the same AMC rule. Wired up in #5704 (verified in code 27 May).
- ✅ MCR completion → auto-scores
cpd.manual.msf-structured-frameworkfor the MCR subject on verify ‡ - ✅ MSF standalone (QMF) → auto-scores
cpd.manual.msf-structured-frameworkfor the MSF subject on verify ‡ - ✅ PPP 360 Review → auto-scores
cpd.manual.msf-structured-frameworkfor the PPP 360 subject on completion ‡
Scoring integrity
- ✅ Timesheet entries do NOT generate CPD points (feeds fatigue telemetry only)
- ✅ Wellness questionnaire submissions do NOT generate CPD points (feeds PPP Pulse only)
✅ Points cap enforced per interaction type per year (max 20 for Supervision; no-cap rows confirmed by AMC — Q4)— retired 2026-10-03. It was marked built, but no auto path enforces a cap, and "20 for Supervision" was the wrong way round (Q3: Supervision 15). Replaced bycpd.automations.supervision-teaching-yearly-caps(⚠️ drift, #12742). The no-cap rows stay uncapped (Q4).⏳ Residual-minute accrual — defer decision to Q5— superseded bycpd.automations.per-hour-minute-banking(Matt, 2026-06-24 / 2026-07-21).
Change Log
| Date | Change | PR/Issue | Reason |
|---|---|---|---|
| 2026-10-04 | cpd.automations.supervision-teaching-yearly-caps flips from drift to built. Auto-scored Supervision of Surgical Trainees credit is now capped at 15 h and Teaching to Trainees / Undergraduates at 20 h per CPD year, on both auto paths (the self-supervision credit and the legacy verified-TaT branch). The held hours are summed for the case's CPD year only, a credit is clipped to the room left, overflow goes to the other activity, and nothing is credited once both are full. | #12840, #12742, #11192 | Matt's CPD Sheet (2026-05-05, Q3) and the 2026-07-29 Dev Session ("put caps in"). The code only used the 15 / 20 values to choose between the two activities and summed all years. What happens to hours past the cap is still Open Question Q7, so they are dropped rather than banked. @regression @issue-12742 scenarios run the allocator in-process. |
| 2026-10-04 | A consultant who signs off a trainee's case for an operation they also logged themselves (same surgicalCaseId) is no longer credited twice: the own log wins and the sign-off adds no extra supervising CPD. | #12814, #11192 | Rob decided on 4 Oct 2026 (comment on #12814): credit once; the consultant's own log wins. This closes Q-signoff-cpd-double-credit in logbook.md. Interpretation to confirm: any own log of the same operation suppresses the sign-off credit, even when that own entry's LoI earned nothing. |
| 2026-10-04 | WBA sign-off credits the assessing consultant a fixed 0.5 h under Supervision (Teaching once Supervision is at its 15 h yearly cap) and credits the trainee's "WBA assessed by consultant". An activity's operative time now overrides the fixed credit only for logbook records. | #12712, #11194 | Rob's decision on #12712 (2026-10-04). signOffWba had stopped triggering the CPD handler (PR #12570). SUPERVISION_MAX_PER_YEAR is exported so the handler and the self-supervision credit service share one cap. |
| 2026-10-03 | Consultant sign-off supervising credit is built. cpd.automations.consultant-supervising-qualifying-lois and cpd.automations.per-hour-minute-banking flip from drift to built. Sign-off credit qualifies off the admin earns_cpd_credit flag (PPT/S-S/S-U; S-H earns nothing) and banks per operative hour through syncSignOffSupervisionCredit. Legacy pre-#12725 sign-off rows are removed on recompute. The no-double-credit criterion is split to #12814 (open). | #12725 | Spec-drift gate on #12774. The change touches selfSupervisionCreditService, which belongs to this spec. |
| 2026-10-03 | Task 8 spec refresh, resolving the Task 4 handoff on #12720. Retired the built-rules bullet that had the caps the wrong way round ("max 20/yr; Teaching fallback at 15"; Matt''s Q3 says Supervision 15 / Teaching 20) and the "Points cap enforced per year" bullet, which was marked built but no path enforces a cap. Added three ACs, all marked drift: cpd.automations.consultant-supervising-qualifying-lois (PPT/S-S/S-U count; S-H and PCC don''t; #12725), cpd.automations.per-hour-minute-banking (supersedes the 23 Apr Q5 "defer" decision; #12725) and cpd.automations.supervision-teaching-yearly-caps (#12742). Corrected the overview note, which said "1 per hour": the code awards round(operativeTime/60) per case, or a flat 1 with no operative time. Added Open Questions Q6 (does TaT credit still need consultant verification?) and Q7 (what happens to hours past a cap?). Status set to partial-drift; code-paths now include the resolver and the self-supervision credit service. | #11192, #9200, #12725, #12742, #12720 | Async Task spec refresh (#11192). The newest dated Matt statement wins. Minute banking: 2026-04-23 "defer" is superseded by #9200 (2026-06-24, restated 2026-07-21). Qualifying LoIs: #9200 2026-07-21. Caps: Matt''s CPD Sheet 2026-05-05, reaffirmed on the 2026-07-29 Dev Session (~00:28:01). Spec-only, no BDD (the scenario requirement is on each fix issue). |
| 2026-05-27 | Mark MCR, standalone MSF, and PPP 360 Review as auto-scored (cpd.manual.msf-structured-framework) — verified merged in code. | #5704 | Rob noted #5704 is merged; confirmed in cpdUserActivityHandler.ts (MCR/MSF) and ppp360CpdHandler.ts (PPP 360). Flipped the ⏳ ACs to ✅, fixed the stale "gaps" framing, and clarified the "by design — NOT CPD" exclusions. |
| 2026-05-05 | Fix inverted supervision/teaching AMC caps (15/20 → corrected); add seedCpdActivities.ts seeding 64 manual activities from Matt's CPD Sheet. | #5679 | Bug in cpdUserActivityHandler had supervision capped at 20 hrs/yr and teaching at 15 hrs/yr — per Matt's CPD Sheet Q3, supervision is 15 and teaching is 20. |
| 2026-04-23 | Spec created by splitting automation content out of cpd-home.md | this PR | Matt confirmed CPD Home and CPD Automations are two separate features on the 23 Apr call |