# lghs/passport3 architecture

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

- Interactive diagram: https://gitdiagram.com/lghs/passport3
- Repository: https://github.com/lghs/passport3

## Overview

Passport3 is a member portal whose main workflow is a signed-in member viewing or changing account, membership, badge, and community information through route handlers backed by Authentik, Dolibarr, and app storage. It also provides distinct GitHub access requests, incident reporting, a shared task board, wishlist voting, and restricted administration with audit history. Arrows below follow excerpted calls or README-documented integrations; the tree and samples do not establish every route-to-service relationship.

Main entry points: [`src/lib/server/authentikAdmin.ts`](https://github.com/lghs/passport3/blob/main/src/lib/server/authentikAdmin.ts) (Authentik identity API), [`src/lib/server/auditLog.ts`](https://github.com/lghs/passport3/blob/main/src/lib/server/auditLog.ts) (Audit history), [`src/routes/+page.server.ts`](https://github.com/lghs/passport3/blob/main/src/routes/%2Bpage.server.ts) (Home dashboard), [`src/routes/github/+page.server.ts`](https://github.com/lghs/passport3/blob/main/src/routes/github/%2Bpage.server.ts) (GitHub access request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Member portal"]
  node_dashboard["Home dashboard<br/>[+page.server.ts]"]
  node_profile["Profile management<br/>[+page.server.ts]"]
  node_profile_ui["Profile interface<br/>[ProfileForm.svelte]"]
  node_directory["Member directory<br/>[+page.server.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Login and session routes<br/>[+server.ts]"]
  node_authentik["Authentik identity API<br/>[authentikAdmin.ts]"]
  node_badge["Badge management<br/>[+page.server.ts]"]
  node_github_flow["GitHub access request<br/>[+page.server.ts]"]
  node_github["GitHub organization service<br/>[githubApp.ts]"]
end

subgraph group_membership["Membership services"]
  node_dolibarr["Dolibarr membership<br/>[dolibarr.ts]"]
  node_cotisation["Subscriptions and invoices<br/>[+page.server.ts]"]
end

subgraph group_community["Community features"]
  node_incidents["Incident reporting<br/>[+page.server.ts]"]
  node_tasks_route["Task board actions<br/>[+page.server.ts]"]
  node_tasks["Task domain and history<br/>[tasks.ts]"]
  node_wishlist["Wishlist proposals<br/>[+page.server.ts]"]
end

subgraph group_operations["Administration"]
  node_audit["Audit history<br/>[auditLog.ts]"]
  node_admin["Admin panel<br/>[+page.server.ts]"]
  node_settings["Admin settings<br/>[+page.server.ts]"]
  node_db[("Application database<br/>[db.ts]")]
end

node_member(("Member"))
node_auth_service["Authentik"]
node_dolibarr_service["Dolibarr service"]
node_github_service["GitHub"]
node_mattermost["Mattermost"]

node_member -->|"views"| node_dashboard
node_dashboard -->|"loads identity data"| node_authentik
node_dashboard -->|"loads membership"| node_dolibarr
node_dashboard -->|"loads open tasks"| node_tasks
node_member -->|"manages account"| node_profile
node_profile_ui -.->|"submits changes"| node_profile
node_profile -->|"updates account"| node_authentik
node_profile -->|"records actions"| node_audit
node_member -->|"signs in"| node_auth_routes
node_auth_routes -.->|"authenticates"| node_auth_service
node_authentik -.->|"requests identity"| node_auth_service
node_member -->|"manages badge"| node_badge
node_badge -->|"reads or regenerates badge"| node_authentik
node_badge -->|"records regeneration"| node_audit
node_member -->|"views membership"| node_cotisation
node_cotisation -->|"reads and updates"| node_dolibarr
node_dolibarr -.->|"requests records"| node_dolibarr_service
node_member -->|"requests organization access"| node_github_flow
node_github_flow -->|"reads linked identity"| node_authentik
node_github_flow -->|"checks or invites"| node_github
node_github -.->|"uses organization API"| node_github_service
node_github_flow -->|"records access actions"| node_audit
node_member -->|"reports incident"| node_incidents
node_member -->|"manages tasks"| node_tasks_route
node_tasks_route -->|"creates and updates"| node_tasks
node_tasks_route -->|"lists assignees"| node_authentik
node_tasks -->|"reads and writes"| node_db
node_tasks_route -->|"records task actions"| node_audit
node_member -->|"votes on proposals"| node_wishlist
node_wishlist -->|"records changes"| node_audit
node_wishlist -->|"announces proposals"| node_mattermost
node_member -->|"browses members"| node_directory
node_admin -.->|"manages member accounts"| node_authentik
node_admin -->|"browses history"| node_audit
node_settings -->|"records settings changes"| node_audit
node_settings -.->|"configures announcements"| node_mattermost

click node_dashboard "https://github.com/lghs/passport3/blob/main/src/routes/%2Bpage.server.ts"
click node_profile "https://github.com/lghs/passport3/blob/main/src/routes/profile/%2Bpage.server.ts"
click node_profile_ui "https://github.com/lghs/passport3/blob/main/src/lib/components/ProfileForm.svelte"
click node_directory "https://github.com/lghs/passport3/blob/main/src/routes/trombinoscope/%2Bpage.server.ts"
click node_auth_routes "https://github.com/lghs/passport3/blob/main/src/routes/login/%2Bserver.ts"
click node_authentik "https://github.com/lghs/passport3/blob/main/src/lib/server/authentikAdmin.ts"
click node_badge "https://github.com/lghs/passport3/blob/main/src/routes/badge/%2Bpage.server.ts"
click node_github_flow "https://github.com/lghs/passport3/blob/main/src/routes/github/%2Bpage.server.ts"
click node_github "https://github.com/lghs/passport3/blob/main/src/lib/server/githubApp.ts"
click node_dolibarr "https://github.com/lghs/passport3/blob/main/src/lib/server/dolibarr.ts"
click node_cotisation "https://github.com/lghs/passport3/blob/main/src/routes/cotisation/%2Bpage.server.ts"
click node_incidents "https://github.com/lghs/passport3/blob/main/src/routes/incidents/%2Bpage.server.ts"
click node_tasks_route "https://github.com/lghs/passport3/blob/main/src/routes/tasks/%2Bpage.server.ts"
click node_tasks "https://github.com/lghs/passport3/blob/main/src/lib/server/tasks.ts"
click node_wishlist "https://github.com/lghs/passport3/blob/main/src/routes/wishlist/%2Bpage.server.ts"
click node_audit "https://github.com/lghs/passport3/blob/main/src/lib/server/auditLog.ts"
click node_admin "https://github.com/lghs/passport3/blob/main/src/routes/admin/users/%5Bpk%5D/%2Bpage.server.ts"
click node_settings "https://github.com/lghs/passport3/blob/main/src/routes/admin/settings/%2Bpage.server.ts"
click node_db "https://github.com/lghs/passport3/blob/main/src/lib/server/db.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_dashboard,node_profile,node_profile_ui,node_directory toneBlue
class node_auth_routes,node_authentik,node_badge,node_github_flow,node_github toneAmber
class node_dolibarr,node_cotisation toneMint
class node_incidents,node_tasks_route,node_tasks,node_wishlist toneRose
class node_audit,node_admin,node_settings,node_db,node_member,node_auth_service,node_dolibarr_service,node_github_service,node_mattermost toneIndigo
```

## Components

### Member portal

- [Home dashboard](https://github.com/lghs/passport3/blob/main/src/routes/%2Bpage.server.ts): `src/routes/+page.server.ts`
- [Profile management](https://github.com/lghs/passport3/blob/main/src/routes/profile/%2Bpage.server.ts): `src/routes/profile/+page.server.ts`
- [Profile interface](https://github.com/lghs/passport3/blob/main/src/lib/components/ProfileForm.svelte): `src/lib/components/ProfileForm.svelte`
- [Member directory](https://github.com/lghs/passport3/blob/main/src/routes/trombinoscope/%2Bpage.server.ts): `src/routes/trombinoscope/+page.server.ts`

### Identity and access

- [Login and session routes](https://github.com/lghs/passport3/blob/main/src/routes/login/%2Bserver.ts): `src/routes/login/+server.ts`
- [Authentik identity API](https://github.com/lghs/passport3/blob/main/src/lib/server/authentikAdmin.ts): `src/lib/server/authentikAdmin.ts`
- [Badge management](https://github.com/lghs/passport3/blob/main/src/routes/badge/%2Bpage.server.ts): `src/routes/badge/+page.server.ts`
- [GitHub access request](https://github.com/lghs/passport3/blob/main/src/routes/github/%2Bpage.server.ts): `src/routes/github/+page.server.ts`
- [GitHub organization service](https://github.com/lghs/passport3/blob/main/src/lib/server/githubApp.ts): `src/lib/server/githubApp.ts`

### Membership services

- [Dolibarr membership](https://github.com/lghs/passport3/blob/main/src/lib/server/dolibarr.ts): `src/lib/server/dolibarr.ts`
- [Subscriptions and invoices](https://github.com/lghs/passport3/blob/main/src/routes/cotisation/%2Bpage.server.ts): `src/routes/cotisation/+page.server.ts`

### Community features

- [Incident reporting](https://github.com/lghs/passport3/blob/main/src/routes/incidents/%2Bpage.server.ts): `src/routes/incidents/+page.server.ts`
- [Task board actions](https://github.com/lghs/passport3/blob/main/src/routes/tasks/%2Bpage.server.ts): `src/routes/tasks/+page.server.ts`
- [Task domain and history](https://github.com/lghs/passport3/blob/main/src/lib/server/tasks.ts): `src/lib/server/tasks.ts`
- [Wishlist proposals](https://github.com/lghs/passport3/blob/main/src/routes/wishlist/%2Bpage.server.ts): `src/routes/wishlist/+page.server.ts`

### Administration

- [Audit history](https://github.com/lghs/passport3/blob/main/src/lib/server/auditLog.ts): `src/lib/server/auditLog.ts`
- [Admin panel](https://github.com/lghs/passport3/blob/main/src/routes/admin/users/%5Bpk%5D/%2Bpage.server.ts): `src/routes/admin/users/[pk]/+page.server.ts`
- [Admin settings](https://github.com/lghs/passport3/blob/main/src/routes/admin/settings/%2Bpage.server.ts): `src/routes/admin/settings/+page.server.ts`
- [Application database](https://github.com/lghs/passport3/blob/main/src/lib/server/db.ts): `src/lib/server/db.ts`

### Other components

- **Member**
- **Authentik**
- **Dolibarr service**
- **GitHub**
- **Mattermost**

## Connections

- Member → Home dashboard: views (evidence: `README.md`)
- Home dashboard → Authentik identity API: loads identity data (evidence: `src/routes/+page.server.ts`)
- Home dashboard → Dolibarr membership: loads membership (evidence: `src/routes/+page.server.ts`)
- Home dashboard → Task domain and history: loads open tasks (evidence: `src/routes/+page.server.ts`)
- Member → Profile management: manages account (evidence: `README.md`)
- Profile interface → Profile management: submits changes
- Profile management → Authentik identity API: updates account (evidence: `src/routes/profile/+page.server.ts`)
- Profile management → Audit history: records actions (evidence: `src/routes/profile/+page.server.ts`)
- Member → Login and session routes: signs in (evidence: `README.md`)
- Login and session routes → Authentik: authenticates (evidence: `README.md`)
- Authentik identity API → Authentik: requests identity (evidence: `README.md`)
- Member → Badge management: manages badge (evidence: `README.md`)
- Badge management → Authentik identity API: reads or regenerates badge (evidence: `src/routes/badge/+page.server.ts`)
- Badge management → Audit history: records regeneration (evidence: `src/routes/badge/+page.server.ts`)
- Member → Subscriptions and invoices: views membership (evidence: `README.md`)
- Subscriptions and invoices → Dolibarr membership: reads and updates (evidence: `src/routes/cotisation/+page.server.ts`)
- Dolibarr membership → Dolibarr service: requests records (evidence: `README.md`)
- Member → GitHub access request: requests organization access (evidence: `README.md`)
- GitHub access request → Authentik identity API: reads linked identity (evidence: `src/routes/github/+page.server.ts`)
- GitHub access request → GitHub organization service: checks or invites (evidence: `src/routes/github/+page.server.ts`)
- GitHub organization service → GitHub: uses organization API (evidence: `README.md`)
- GitHub access request → Audit history: records access actions (evidence: `src/routes/github/+page.server.ts`)
- Member → Incident reporting: reports incident (evidence: `README.md`)
- Member → Task board actions: manages tasks (evidence: `README.md`)
- Task board actions → Task domain and history: creates and updates (evidence: `src/routes/tasks/+page.server.ts`)
- Task board actions → Authentik identity API: lists assignees (evidence: `src/routes/tasks/+page.server.ts`)
- Task domain and history → Application database: reads and writes (evidence: `src/lib/server/tasks.ts`)
- Task board actions → Audit history: records task actions (evidence: `README.md`)
- Member → Wishlist proposals: votes on proposals (evidence: `README.md`)
- Wishlist proposals → Audit history: records changes (evidence: `src/routes/wishlist/+page.server.ts`)
- Wishlist proposals → Mattermost: announces proposals (evidence: `src/routes/wishlist/+page.server.ts`)
- Member → Member directory: browses members (evidence: `README.md`)
- Admin panel → Authentik identity API: manages member accounts (evidence: `README.md`)
- Admin panel → Audit history: browses history (evidence: `README.md`)
- Admin settings → Audit history: records settings changes (evidence: `src/routes/admin/settings/+page.server.ts`)
- Admin settings → Mattermost: configures announcements (evidence: `README.md`)
