# nauticalinsightsai-boop/pms architecture

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

- Interactive diagram: https://gitdiagram.com/nauticalinsightsai-boop/pms
- Repository: https://github.com/nauticalinsightsai-boop/pms

## Overview

PMS is a project-management certification and services platform with a public marketing/enrollment site and a separate admin dashboard. The main learner journey is to explore certifications, choose an offering and region, then start checkout; other product branches cover scholarships, consultations, booking portals, and content publishing. The dashboard also manages CMS content and booking/interaction operations. Connections below are limited to README statements and shown source references; unsampled route wiring is not inferred.

Main entry points: [`dashboard/frontend/app/dashboard/page.tsx`](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/app/dashboard/page.tsx) (Admin dashboard), [`frontend/app/(site)/certifications/page.tsx`](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/app/(site)/certifications/page.tsx) (Certification catalogue), [`frontend/lib/enrollment-routes.ts`](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/lib/enrollment-routes.ts) (Enrollment routes), [`frontend/components/pages/PMService.tsx`](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/components/pages/PMService.tsx) (Services content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Learning Site"]
  node_certifications["Certification catalogue<br/>[page.tsx]"]
  node_programme_pages["Programme pages"]
  node_enrollment["Enrollment routes"]
  node_region["Region selection<br/>[RegionContext.tsx]"]
  node_services_page["Services content<br/>[PMService.tsx]"]
end

subgraph group_commerce["Enrollment and Booking"]
  node_checkout_create["Checkout creation<br/>[route.ts]"]
  node_checkout_membership["Membership checkout<br/>[route.ts]"]
  node_checkout_deposit["Seat deposits<br/>[route.ts]"]
  node_scholarship["Scholarship enrollment<br/>[route.ts]"]
  node_pricing["Enrollment pricing policy"]
  node_booking_portal["Channel portals<br/>[page.tsx]"]
  node_channel_repository[("Portal repository<br/>[repository.ts]")]
end

subgraph group_admin["Dashboard Operations"]
  node_channel_admin_api["Portal publishing API<br/>[route.ts]"]
  node_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_interactions["Interaction operations<br/>[route.ts]"]
  node_cms_admin["CMS editors<br/>[WebsiteData.tsx]"]
end

subgraph group_content["Content Platform"]
  node_cms_api["CMS API<br/>[route.ts]"]
  node_published_data[("Published site data")]
  node_site_content["Shared content schemas<br/>[services.ts]"]
end

node_learner(("Prospective learner"))
node_stripe["Stripe"]
node_admin_user(("Administrator"))

node_learner -->|"explores"| node_certifications
node_certifications -.->|"views offerings"| node_programme_pages
node_learner -.->|"starts enrollment"| node_enrollment
node_enrollment -.->|"starts checkout"| node_checkout_create
node_checkout_create -.->|"creates session"| node_stripe
node_checkout_membership -.->|"creates session"| node_stripe
node_checkout_deposit -.->|"creates session"| node_stripe
node_scholarship -.->|"creates checkout"| node_stripe
node_admin_user -->|"manages"| node_dashboard
node_dashboard -.->|"publishes portals"| node_channel_admin_api
node_channel_admin_api -->|"reads and writes"| node_channel_repository
node_learner -->|"opens portal"| node_booking_portal
node_dashboard -.->|"manages interactions"| node_interactions
node_cms_admin -.->|"edits content"| node_cms_api
node_published_data -->|"uses schema"| node_site_content
node_services_page -->|"loads configuration"| node_site_content
node_learner -.->|"explores services"| node_services_page

click node_certifications "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/app/(site)/certifications/page.tsx"
click node_programme_pages "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/components/ProgrammePreviewExplorer.tsx"
click node_enrollment "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/lib/enrollment-routes.ts"
click node_region "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/contexts/RegionContext.tsx"
click node_checkout_create "https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/create/route.ts"
click node_checkout_membership "https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/membership/route.ts"
click node_checkout_deposit "https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/seat-deposit/route.ts"
click node_scholarship "https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/scholarship/checkout/route.ts"
click node_pricing "https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/lib/enrollment-pricing-policy.ts"
click node_booking_portal "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/app/go/%5Bchannel%5D/page.tsx"
click node_channel_admin_api "https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/app/api/channel-landing-pages/route.ts"
click node_channel_repository "https://github.com/nauticalinsightsai-boop/pms/blob/main/packages/booking-crm/src/channel-landing-pages/repository.ts"
click node_dashboard "https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/app/dashboard/page.tsx"
click node_interactions "https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/backend/app/api/interactions/route.ts"
click node_cms_admin "https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/components/pages/admin/WebsiteData.tsx"
click node_cms_api "https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/backend/app/api/cms/website-data/route.ts"
click node_published_data "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/services/WebsiteDataService.ts"
click node_services_page "https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/components/pages/PMService.tsx"
click node_site_content "https://github.com/nauticalinsightsai-boop/pms/blob/main/packages/site-content/src/services.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_certifications,node_programme_pages,node_enrollment,node_region,node_services_page toneBlue
class node_checkout_create,node_checkout_membership,node_checkout_deposit,node_scholarship,node_pricing,node_booking_portal,node_channel_repository toneAmber
class node_channel_admin_api,node_dashboard,node_interactions,node_cms_admin toneMint
class node_cms_api,node_published_data,node_site_content toneRose
class node_learner,node_stripe,node_admin_user toneIndigo
```

## Components

### Public Learning Site

- [Certification catalogue](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/app/(site)/certifications/page.tsx): `frontend/app/(site)/certifications/page.tsx`
- [Programme pages](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/components/ProgrammePreviewExplorer.tsx): `frontend/components/ProgrammePreviewExplorer.tsx`
- [Enrollment routes](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/lib/enrollment-routes.ts): `frontend/lib/enrollment-routes.ts`
- [Region selection](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/contexts/RegionContext.tsx): `frontend/contexts/RegionContext.tsx`
- [Services content](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/components/pages/PMService.tsx): `frontend/components/pages/PMService.tsx`

### Enrollment and Booking

- [Checkout creation](https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/create/route.ts): `backend/app/api/checkout/create/route.ts`
- [Membership checkout](https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/membership/route.ts): `backend/app/api/checkout/membership/route.ts`
- [Seat deposits](https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/checkout/seat-deposit/route.ts): `backend/app/api/checkout/seat-deposit/route.ts`
- [Scholarship enrollment](https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/app/api/scholarship/checkout/route.ts): `backend/app/api/scholarship/checkout/route.ts`
- [Enrollment pricing policy](https://github.com/nauticalinsightsai-boop/pms/blob/main/backend/lib/enrollment-pricing-policy.ts): `backend/lib/enrollment-pricing-policy.ts`
- [Channel portals](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/app/go/%5Bchannel%5D/page.tsx): `frontend/app/go/[channel]/page.tsx`
- [Portal repository](https://github.com/nauticalinsightsai-boop/pms/blob/main/packages/booking-crm/src/channel-landing-pages/repository.ts): `packages/booking-crm/src/channel-landing-pages/repository.ts`

### Dashboard Operations

- [Portal publishing API](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/app/api/channel-landing-pages/route.ts): `dashboard/frontend/app/api/channel-landing-pages/route.ts`
- [Admin dashboard](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/app/dashboard/page.tsx): `dashboard/frontend/app/dashboard/page.tsx`
- [Interaction operations](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/backend/app/api/interactions/route.ts): `dashboard/backend/app/api/interactions/route.ts`
- [CMS editors](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/frontend/components/pages/admin/WebsiteData.tsx): `dashboard/frontend/components/pages/admin/WebsiteData.tsx`

### Content Platform

- [CMS API](https://github.com/nauticalinsightsai-boop/pms/blob/main/dashboard/backend/app/api/cms/website-data/route.ts): `dashboard/backend/app/api/cms/website-data/route.ts`
- [Published site data](https://github.com/nauticalinsightsai-boop/pms/blob/main/frontend/services/WebsiteDataService.ts): `frontend/services/WebsiteDataService.ts`
- [Shared content schemas](https://github.com/nauticalinsightsai-boop/pms/blob/main/packages/site-content/src/services.ts): `packages/site-content/src/services.ts`

### Other components

- **Prospective learner**
- **Stripe**
- **Administrator**

## Connections

- Prospective learner → Certification catalogue: explores (evidence: `README.md`)
- Certification catalogue → Programme pages: views offerings
- Prospective learner → Enrollment routes: starts enrollment
- Enrollment routes → Checkout creation: starts checkout
- Checkout creation → Stripe: creates session (evidence: `README.md`)
- Membership checkout → Stripe: creates session (evidence: `README.md`)
- Seat deposits → Stripe: creates session (evidence: `README.md`)
- Scholarship enrollment → Stripe: creates checkout
- Administrator → Admin dashboard: manages (evidence: `README.md`)
- Admin dashboard → Portal publishing API: publishes portals
- Portal publishing API → Portal repository: reads and writes (evidence: `dashboard/frontend/app/api/channel-landing-pages/route.ts`)
- Prospective learner → Channel portals: opens portal (evidence: `README.md`)
- Admin dashboard → Interaction operations: manages interactions
- CMS editors → CMS API: edits content
- Published site data → Shared content schemas: uses schema (evidence: `frontend/services/WebsiteDataService.ts`)
- Services content → Shared content schemas: loads configuration (evidence: `frontend/components/pages/PMService.tsx`)
- Prospective learner → Services content: explores services
