How loopskey/loopskey-monorepo works
Loopskey is a multi-role CPD platform whose API supports learning discovery, credential and PDU tracking, provider publishing, organization compliance, and platform administration. The documented user journey is role-specific: professionals find learning and track progress; providers publish content; organizations manage members and compliance; administrators oversee users, content, and taxonomy. The ingestion subsystem adds a source-to-batch submission and review workflow. Connections are limited to README statements and shown source calls; unsampled feature internals are represented only at their existing directory paths.
Main entry points: front Web application · ingestion-batch-runner.service.ts Batch runner · main.ts Core API · AdminIngestionTab.tsx Ingestion console
Components 22
Access and platform
- Web application
apps/front - Core API
apps/api/src/main.ts - Authentication
apps/api/src/modules/auth/services - Object storage
apps/api/src/infrastructure/storage/object-storage.port.ts - Local storage adapter
apps/api/src/infrastructure/storage/local-object-storage.adapter.ts
Learning and credentials
- Learning catalog
apps/api/src/modules/course - Learning activity
apps/api/src/modules/content-interaction - Credentials and PDU
apps/api/src/modules/professional
Organizations and administration
- Association management
apps/api/src/modules/association - Organization management
apps/api/src/modules/organization - Platform administration
apps/api/src/modules/admin
Content ingestion
- Ingestion console
apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx - Ingestion endpoints
apps/api/src/modules/ingestion/controllers - Batch runner
apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts - Podcast ingestion
apps/api/src/modules/ingestion/controllers/podcast-ingestion.controller.ts - Course ingestion
apps/api/src/modules/ingestion/services/course-ingestion.service.ts - Ingestion review
apps/api/src/modules/ingestion/services/ingestion-admin.service.ts - Published-item handler
apps/api/src/modules/ingestion/handlers/ingestion-item-published.handler.ts
Other components
- Professional
- Provider
- Organization
- Administrator
Connections 21
- Professional → Web application: uses
- Provider → Web application: uses
- Organization → Web application: uses
- Administrator → Web application: uses
- Web application → Core API: calls
- Core API → Authentication: provides access
- Professional → Learning catalog: discovers learning
- Professional → Learning activity: tracks progress
- Professional → Credentials and PDU: manages credentials
- Provider → Learning catalog: publishes content
- Organization → Organization management: manages members
- Organization → Association management: manages compliance
- Administrator → Platform administration: manages platform
- Administrator → Ingestion console: reviews content
- Ingestion console → Ingestion endpoints: manages sources
- Podcast ingestion → Batch runner: runs batch
apps/api/src/modules/ingestion/controllers/podcast-ingestion.controller.ts - Ingestion endpoints → Batch runner: dispatches batches
- Batch runner → Course ingestion: processes courses
- Ingestion review → Course ingestion: uses course service
apps/api/src/modules/ingestion/services/ingestion-admin.service.ts - Published-item handler → Object storage: checks item data
- Local storage adapter → Object storage: implements
apps/api/src/infrastructure/storage/local-object-storage.adapter.ts