CPD Resource Library
Feature Overview
A categorised library of curated CPD resources (guides, videos) and PPP-authored clinical forms, shown to CPD users and maintained by Super Admin.
Open Questions
All questions have been answered.
Acceptance Criteria
- ✅
cpd.resource-library.scope— at launch the library holds curated CPD resources grouped by category, plus a PPP Clinical Forms section of 10 forms covering the four PLRs (Cultural Safety, Health Inequities, Professionalism, Ethical Practice). - ✅
cpd.resource-library.admin-editable— Super Admin adds, edits, and deactivates entries from the admin console; deactivated entries are hidden from doctors but kept on existing records. Editor lives in the Super Admin settings — seesuper-admin.md. ‡ - ✅
cpd.resource-library.db-backed— content is database-backed (migrated off the hardcodedresourceData.ts) and read over tRPC. ‡ - ✅
cpd.resource-library.forms-seed— the 10 clinical forms are seeded with aformSlugmapped to the download allowlist; files in Azure Blob atcpd-forms/<slug>.docx. ‡ - ✅
cpd.resource-library.sponsorship-disclosure— a resource carries an optional plain-languagesponsorshipDisclosure(Super Admin-editable via the resource form). When set, the resource renders a "Sponsored content: …" disclosure label to members alongside its title; when unset (the default, and every pre-#11047 resource), no label renders. This satisfies AC1/AC2 of the policy→code conformance gap found by the #11022 audit: the Conflict of Interest and Maintenance of Independence Policy's Commercial Sponsorship Management section claims present-tense platform behaviour — "Sponsorship arrangements are disclosed on platform before member access" and "Plain-language conflict statements for all sponsored content" — for which no data model previously existed. ‡ - ✅
cpd.resource-library.sponsorship-pre-access-gate— AC3 of the #11022 audit: clicking a sponsored resource's title intercepts the click and shows a confirmation dialog ("Sponsored content", the plain-language disclosure, Cancel/Continue) that the member must explicitly acknowledge before the resource opens in a new tab. Cancelling never opens it. Non-sponsored resources (sponsorshipDisclosureunset — the default, and every pre-#11047 resource) are completely unaffected: no dialog, same<Link target="_blank">navigation as before. ‡ Still not addressed (unrelated to this AC): AC4's tense reconciliation (marketing copy vs policy copy) — the marketing "will be disclosed" language was already stale/orphaned at #11047 audit time (Info0.tsx:196-200cited in #11047 no longer exists; the live copy isinstances/marketing/src/landing/pages/Information/contents/ConflictOfInterestPolicy.tsx, which is itself in the present tense the policy expects).
Open GitHub Issues
Open issues on label:feature:cpd-resource-library — no open issues. Fetched at: 2026-10-13T07:29:49Z — live list on GitHub.
Change Log
| Date | Change | PR/Issue | Reason |
|---|---|---|---|
| 2026-08-29 | Close three post-merge bypasses of the sponsored-resource pre-access gate found in a second review of #11971 — a middle-click/right-click "open in new tab" bypass (the anchor's href stayed live regardless of gate state; the gated link now renders no href until confirmed), a bare, ungated link in the Recently Viewed history tab (now resolves each row's live resource and gates it the same as the primary views, failing closed rather than open when a resource's current status can't be resolved), and a blocked-popup visit incorrectly counted as a completed visit. Also fixes a divergent/inaccurate aria-label on the gated link surfaced by the review's design pass (CLAUDE.md #7773). | #11974, #11972, #11952, #11047, #11022 | The pre-access confirmation gate (AC cpd.resource-library.sponsorship-pre-access-gate) is satisfied on the happy path but the gate mechanism itself had real holes — this fixes the mechanism, it does not change what the AC promises (clicking a sponsored resource's title still requires explicit acknowledgement before it opens; non-sponsored resources remain unaffected). |
| 2026-08-29 | Add a pre-access confirmation dialog gating sponsored resources — clicking a sponsored resource's title now requires explicit member acknowledgement before it opens; non-sponsored resources are unaffected. Ships AC3 of #11047 (the pre-access gate deferred as follow-up in #11951). | #11971, #11952, #11047, #11022 | The Conflict of Interest and Maintenance of Independence Policy's Commercial Sponsorship Management section requires disclosures "before member access" — #11951 shipped the inline label (visible before the click) but nothing blocked the click itself; this closes that gap with a real interstitial. |
| 2026-08-29 | Add optional sponsorshipDisclosure field to ppp_resources; renders a "Sponsored content: ..." label on the member-facing library when set. Covers AC1/AC2 of #11047; AC3 (pre-access gate) and AC4 (marketing tense reconciliation, found already resolved) are explicitly scoped out as follow-up/not-needed. | #11951, #11047, #11022 | The Conflict of Interest and Maintenance of Independence Policy's Commercial Sponsorship Management section claimed present-tense platform behaviour ("sponsorship arrangements are disclosed on platform", "plain-language conflict statements for all sponsored content") for which no data model existed — found by the #11022 policy-to-code conformance audit. |
| 2026-07-12 | Update stale code-paths in front-matter and AC citations after admin-org bounded-context reorg (ADR-0003). | #10517, #10488 | ADR-0003 reorg moved CPDResourceLibrary under admin-org/support, ResourceLibrarySettings under admin-org/settings/modules (now a directory), resourceLibrary router under cpd/, and getFormDownloadUrl under admin-and-org/support/. The spec's code-paths and inline abbr citations pointed to the old pre-reorg locations — path-citation drift only, no behaviour change. |