# floresta-corp/true-khmer-web architecture

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

- Interactive diagram: https://gitdiagram.com/floresta-corp/true-khmer-web
- Repository: https://github.com/floresta-corp/true-khmer-web

## Overview

True Khmer is a community platform for member profiles, discussion, events, volunteering, Launchpad opportunities, education, editorial content, and partner organisations, with administrative tools for managing the platform. A typical member journey is to authenticate, explore a community offering, apply or register, then manage related activity in their personal space. The tree shows clear feature and API boundaries, but most runtime wiring was not sampled; links between those subsystems are therefore shown as unverified rather than asserted as direct calls.

Main entry points: [`app/api/events/events.server.ts`](https://github.com/floresta-corp/true-khmer-web/blob/develop/app/api/events/events.server.ts) (Events), [`app/api/education`](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/education) (Courses and classes), [`app/routes/auth`](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/auth) (Authentication), [`app/routes/onboarding`](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/onboarding) (Profile onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and member space"]
  node_auth["Authentication"]
  node_onboarding["Profile onboarding"]
  node_profile["Profile and space"]
  node_saved["Saved items"]
  node_tickets["Tickets"]
end

subgraph group_community["Community content"]
  node_forum["Forum"]
  node_blog["Editorial content"]
  node_partners["Partner directory"]
end

subgraph group_opportunities["Opportunities and events"]
  node_volunteer["Volunteering"]
  node_launchpad["Launchpad"]
  node_events["Events<br/>[events.server.ts]"]
end

subgraph group_learning["Learning"]
  node_education["Courses and classes"]
  node_certificates["Certificates"]
end

subgraph group_operations["Platform administration"]
  node_admin_platform["Administration"]
  node_moderation["Content moderation"]
  node_notifications["Notifications"]
  node_oauth["OAuth clients<br/>[oauth.server.ts]"]
end

node_member(("Member"))
node_admin(("Administrator"))
node_plumpi["Plumpi ticketing"]

node_member -.->|"signs in"| node_auth
node_member -.->|"sets up profile"| node_onboarding
node_member -.->|"discusses"| node_forum
node_member -.->|"reads content"| node_blog
node_member -.->|"finds partners"| node_partners
node_member -.->|"applies"| node_volunteer
node_member -.->|"applies"| node_launchpad
node_member -.->|"registers"| node_events
node_member -.->|"takes courses"| node_education
node_education -.->|"earns certificates"| node_certificates
node_member -.->|"manages activity"| node_profile
node_member -.->|"saves items"| node_saved
node_member -.->|"views tickets"| node_tickets
node_events -.->|"ticketing may use"| node_plumpi
node_admin -.->|"manages platform"| node_admin_platform
node_admin -.->|"reviews content"| node_moderation
node_admin -.->|"sends updates"| node_notifications

click node_auth "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/auth"
click node_onboarding "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/onboarding"
click node_profile "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/myspace"
click node_saved "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/saved-items"
click node_tickets "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/my-tickets"
click node_forum "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/forum"
click node_blog "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/blog"
click node_partners "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/partner"
click node_volunteer "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/volunteer"
click node_launchpad "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/launchpad"
click node_events "https://github.com/floresta-corp/true-khmer-web/blob/develop/app/api/events/events.server.ts"
click node_education "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/education"
click node_certificates "https://github.com/floresta-corp/true-khmer-web/blob/develop/app/features/education/lib/certificate-pdf.client.ts"
click node_admin_platform "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/admin"
click node_moderation "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/features/admin/manage-content"
click node_notifications "https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/notifications"
click node_oauth "https://github.com/floresta-corp/true-khmer-web/blob/develop/app/api/oauth/oauth.server.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_auth,node_onboarding,node_profile,node_saved,node_tickets toneBlue
class node_forum,node_blog,node_partners toneAmber
class node_volunteer,node_launchpad,node_events toneMint
class node_education,node_certificates toneRose
class node_admin_platform,node_moderation,node_notifications,node_oauth,node_member,node_admin,node_plumpi toneIndigo
```

## Components

### Identity and member space

- [Authentication](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/auth): `app/routes/auth`
- [Profile onboarding](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/routes/onboarding): `app/routes/onboarding`
- [Profile and space](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/myspace): `app/api/myspace`
- [Saved items](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/saved-items): `app/api/saved-items`
- [Tickets](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/my-tickets): `app/api/my-tickets`

### Community content

- [Forum](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/forum): `app/api/forum`
- [Editorial content](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/blog): `app/api/blog`
- [Partner directory](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/partner): `app/api/partner`

### Opportunities and events

- [Volunteering](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/volunteer): `app/api/volunteer`
- [Launchpad](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/launchpad): `app/api/launchpad`
- [Events](https://github.com/floresta-corp/true-khmer-web/blob/develop/app/api/events/events.server.ts): `app/api/events/events.server.ts`

### Learning

- [Courses and classes](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/education): `app/api/education`
- [Certificates](https://github.com/floresta-corp/true-khmer-web/blob/develop/app/features/education/lib/certificate-pdf.client.ts): `app/features/education/lib/certificate-pdf.client.ts`

### Platform administration

- [Administration](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/admin): `app/api/admin`
- [Content moderation](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/features/admin/manage-content): `app/features/admin/manage-content`
- [Notifications](https://github.com/floresta-corp/true-khmer-web/tree/develop/app/api/notifications): `app/api/notifications`
- [OAuth clients](https://github.com/floresta-corp/true-khmer-web/blob/develop/app/api/oauth/oauth.server.ts): `app/api/oauth/oauth.server.ts`

### Other components

- **Member**
- **Administrator**
- **Plumpi ticketing**

## Connections

- Member → Authentication: signs in
- Member → Profile onboarding: sets up profile
- Member → Forum: discusses
- Member → Editorial content: reads content
- Member → Partner directory: finds partners
- Member → Volunteering: applies
- Member → Launchpad: applies
- Member → Events: registers
- Member → Courses and classes: takes courses
- Courses and classes → Certificates: earns certificates
- Member → Profile and space: manages activity
- Member → Saved items: saves items
- Member → Tickets: views tickets
- Events → Plumpi ticketing: ticketing may use
- Administrator → Administration: manages platform
- Administrator → Content moderation: reviews content
- Administrator → Notifications: sends updates
