# loopskey/loopskey-monorepo architecture

> Architecture diagram of the GitHub repository loopskey/loopskey-monorepo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/loopskey/loopskey-monorepo
- Repository: https://github.com/loopskey/loopskey-monorepo

## Overview

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: [`apps/front`](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/front) (Web application), [`apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts`](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts) (Batch runner), [`apps/api/src/main.ts`](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/main.ts) (Core API), [`apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx`](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx) (Ingestion console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and platform"]
  node_frontend["Web application"]
  node_api["Core API<br/>[main.ts]"]
  node_auth["Authentication"]
  node_object_storage["Object storage"]
  node_local_storage["Local storage adapter"]
end

subgraph group_learning["Learning and credentials"]
  node_catalog["Learning catalog"]
  node_engagement["Learning activity"]
  node_professional_records["Credentials and PDU"]
end

subgraph group_organizations["Organizations and administration"]
  node_association["Association management"]
  node_organization_ops["Organization management"]
  node_administration["Platform administration"]
end

subgraph group_ingestion["Content ingestion"]
  node_ingestion_ui["Ingestion console"]
  node_ingestion_api["Ingestion endpoints"]
  node_batch_runner["Batch runner"]
  node_podcast_ingestion["Podcast ingestion"]
  node_course_ingestion["Course ingestion"]
  node_ingestion_admin["Ingestion review"]
  node_outbox_handler["Published-item handler"]
end

node_professional(("Professional"))
node_provider(("Provider"))
node_organization(("Organization"))
node_admin(("Administrator"))

node_professional -->|"uses"| node_frontend
node_provider -->|"uses"| node_frontend
node_organization -->|"uses"| node_frontend
node_admin -->|"uses"| node_frontend
node_frontend -->|"calls"| node_api
node_api -->|"provides access"| node_auth
node_professional -->|"discovers learning"| node_catalog
node_professional -->|"tracks progress"| node_engagement
node_professional -->|"manages credentials"| node_professional_records
node_provider -->|"publishes content"| node_catalog
node_organization -->|"manages members"| node_organization_ops
node_organization -->|"manages compliance"| node_association
node_admin -->|"manages platform"| node_administration
node_admin -->|"reviews content"| node_ingestion_ui
node_ingestion_ui -.->|"manages sources"| node_ingestion_api
node_podcast_ingestion -->|"runs batch"| node_batch_runner
node_ingestion_api -.->|"dispatches batches"| node_batch_runner
node_batch_runner -.->|"processes courses"| node_course_ingestion
node_ingestion_admin -->|"uses course service"| node_course_ingestion
node_outbox_handler -.->|"checks item data"| node_object_storage
node_local_storage -->|"implements"| node_object_storage

click node_frontend "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/front"
click node_api "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/main.ts"
click node_auth "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/auth/services"
click node_catalog "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/course"
click node_engagement "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/content-interaction"
click node_professional_records "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/professional"
click node_association "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/association"
click node_organization_ops "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/organization"
click node_administration "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/admin"
click node_ingestion_ui "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx"
click node_ingestion_api "https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/ingestion/controllers"
click node_batch_runner "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts"
click node_podcast_ingestion "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/controllers/podcast-ingestion.controller.ts"
click node_course_ingestion "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/course-ingestion.service.ts"
click node_ingestion_admin "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/ingestion-admin.service.ts"
click node_outbox_handler "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/handlers/ingestion-item-published.handler.ts"
click node_object_storage "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/infrastructure/storage/object-storage.port.ts"
click node_local_storage "https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/infrastructure/storage/local-object-storage.adapter.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_api,node_auth,node_object_storage,node_local_storage toneBlue
class node_catalog,node_engagement,node_professional_records toneAmber
class node_association,node_organization_ops,node_administration toneMint
class node_ingestion_ui,node_ingestion_api,node_batch_runner,node_podcast_ingestion,node_course_ingestion,node_ingestion_admin,node_outbox_handler toneRose
class node_professional,node_provider,node_organization,node_admin toneIndigo
```

## Components

### Access and platform

- [Web application](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/front): `apps/front`
- [Core API](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/main.ts): `apps/api/src/main.ts`
- [Authentication](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/auth/services): `apps/api/src/modules/auth/services`
- [Object storage](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/infrastructure/storage/object-storage.port.ts): `apps/api/src/infrastructure/storage/object-storage.port.ts`
- [Local storage adapter](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/infrastructure/storage/local-object-storage.adapter.ts): `apps/api/src/infrastructure/storage/local-object-storage.adapter.ts`

### Learning and credentials

- [Learning catalog](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/course): `apps/api/src/modules/course`
- [Learning activity](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/content-interaction): `apps/api/src/modules/content-interaction`
- [Credentials and PDU](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/professional): `apps/api/src/modules/professional`

### Organizations and administration

- [Association management](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/association): `apps/api/src/modules/association`
- [Organization management](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/organization): `apps/api/src/modules/organization`
- [Platform administration](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/admin): `apps/api/src/modules/admin`

### Content ingestion

- [Ingestion console](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx): `apps/front/src/components/modules/AdminDashboard/AdminIngestionTab.tsx`
- [Ingestion endpoints](https://github.com/loopskey/loopskey-monorepo/tree/main/apps/api/src/modules/ingestion/controllers): `apps/api/src/modules/ingestion/controllers`
- [Batch runner](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts): `apps/api/src/modules/ingestion/services/ingestion-batch-runner.service.ts`
- [Podcast ingestion](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/controllers/podcast-ingestion.controller.ts): `apps/api/src/modules/ingestion/controllers/podcast-ingestion.controller.ts`
- [Course ingestion](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/course-ingestion.service.ts): `apps/api/src/modules/ingestion/services/course-ingestion.service.ts`
- [Ingestion review](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/services/ingestion-admin.service.ts): `apps/api/src/modules/ingestion/services/ingestion-admin.service.ts`
- [Published-item handler](https://github.com/loopskey/loopskey-monorepo/blob/main/apps/api/src/modules/ingestion/handlers/ingestion-item-published.handler.ts): `apps/api/src/modules/ingestion/handlers/ingestion-item-published.handler.ts`

### Other components

- **Professional**
- **Provider**
- **Organization**
- **Administrator**

## Connections

- 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 (evidence: `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 (evidence: `apps/api/src/modules/ingestion/services/ingestion-admin.service.ts`)
- Published-item handler → Object storage: checks item data
- Local storage adapter → Object storage: implements (evidence: `apps/api/src/infrastructure/storage/local-object-storage.adapter.ts`)
