# jsiekham/evergrace-app architecture

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

- Interactive diagram: https://gitdiagram.com/jsiekham/evergrace-app
- Repository: https://github.com/jsiekham/evergrace-app

## Overview

EverGrace is a senior-friendly martial-arts training platform with member learning and progress tracking, an administrative console, and optional email, billing, and video-hosting integrations. Members complete a health check-in, receive a recommended track, sign in, then discover and play tier-gated lessons while recording progress and preferences. Staff manage the catalog and content; publishing and video-ready events can notify followers. The graph includes core service and persistence layers. Unsampled page internals are represented from README capabilities; those relationships cite the README rather than implying source inspection.

Main entry points: [`src/lib/db.ts`](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/db.ts) (Application database), [`src/lib/auth.ts`](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/auth.ts) (Authentication), [`src/actions/member.ts`](https://github.com/jsiekham/evergrace-app/blob/main/src/actions/member.ts) (Member actions), [`src/app/admin/page.tsx`](https://github.com/jsiekham/evergrace-app/blob/main/src/app/admin/page.tsx) (Admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_member["Member experience"]
  node_onboarding["Health check-in<br/>[page.tsx]"]
  node_member_login["Member login<br/>[page.tsx]"]
  node_dashboard["Member dashboard<br/>[page.tsx]"]
  node_library["Video library<br/>[page.tsx]"]
  node_player["Lesson player<br/>[page.tsx]"]
end

subgraph group_admin["Staff console"]
  node_admin_pages["Admin console<br/>[page.tsx]"]
  node_admin_content["Content management<br/>[admin-content.ts]"]
  node_admin_video["Video management<br/>[admin-video.ts]"]
  node_reports["Reports and roster<br/>[page.tsx]"]
end

subgraph group_services["Application services"]
  node_onboarding_action["Track and signup<br/>[onboarding.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_auth_callback["Magic-link callback<br/>[route.ts]"]
  node_member_actions["Member actions<br/>[member.ts]"]
  node_queries["Read queries<br/>[queries.ts]"]
  node_domain["Access and track rules<br/>[domain.ts]"]
  node_notifications["Follower notifications<br/>[notifications.ts]"]
  node_media["Video hosting<br/>[media.ts]"]
  node_billing["Plan changes<br/>[billing.ts]"]
end

subgraph group_integrations["Integrations and state"]
  node_db[("Application database<br/>[db.ts]")]
  node_mux_hook["Mux asset webhook<br/>[route.ts]"]
  node_stripe_hook["Stripe webhook<br/>[route.ts]"]
  node_email["Email delivery<br/>[mail.ts]"]
end

node_visitor(("Member"))
node_staff(("Staff"))
node_stripe(("Stripe"))
node_mux(("Mux"))

node_visitor -->|"starts check-in"| node_onboarding
node_onboarding -->|"submits answers"| node_onboarding_action
node_onboarding_action -->|"scores track"| node_domain
node_onboarding_action -->|"creates account"| node_db
node_visitor -->|"signs in"| node_member_login
node_member_login -->|"requests magic link"| node_auth
node_auth -->|"sends link"| node_email
node_email -.->|"delivers link"| node_visitor
node_auth_callback -->|"validates token"| node_auth
node_auth -->|"stores sessions"| node_db
node_visitor -->|"views activity"| node_dashboard
node_dashboard -->|"loads aggregates"| node_queries
node_dashboard -->|"records check-ins"| node_member_actions
node_visitor -->|"browses lessons"| node_library
node_library -->|"loads catalog"| node_queries
node_visitor -->|"opens lesson"| node_player
node_player -->|"records progress"| node_member_actions
node_member_actions -->|"requires member"| node_auth
node_member_actions -->|"checks eligibility"| node_domain
node_member_actions -->|"writes activity"| node_db
node_queries -->|"reads records"| node_db
node_queries -->|"applies rules"| node_domain
node_staff -->|"manages platform"| node_admin_pages
node_admin_pages -->|"edits content"| node_admin_content
node_admin_pages -->|"manages videos"| node_admin_video
node_admin_pages -->|"reviews impact"| node_reports
node_admin_content -->|"updates content"| node_db
node_admin_content -->|"requires staff"| node_auth
node_admin_video -->|"updates catalog"| node_db
node_admin_video -->|"notifies on publish"| node_notifications
node_mux -->|"sends asset event"| node_mux_hook
node_mux_hook -->|"builds thumbnail URL"| node_media
node_mux_hook -->|"updates ready asset"| node_db
node_mux_hook -->|"fans out notices"| node_notifications
node_notifications -->|"stores notices"| node_db
node_stripe -->|"sends billing event"| node_stripe_hook
node_stripe_hook -->|"applies plan"| node_billing
node_billing -->|"updates subscription"| node_db

click node_onboarding "https://github.com/jsiekham/evergrace-app/blob/main/src/app/onboarding/page.tsx"
click node_onboarding_action "https://github.com/jsiekham/evergrace-app/blob/main/src/actions/onboarding.ts"
click node_member_login "https://github.com/jsiekham/evergrace-app/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/auth.ts"
click node_auth_callback "https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/auth/callback/route.ts"
click node_dashboard "https://github.com/jsiekham/evergrace-app/blob/main/src/app/dashboard/page.tsx"
click node_library "https://github.com/jsiekham/evergrace-app/blob/main/src/app/library/page.tsx"
click node_player "https://github.com/jsiekham/evergrace-app/blob/main/src/app/library/%5BvideoId%5D/page.tsx"
click node_member_actions "https://github.com/jsiekham/evergrace-app/blob/main/src/actions/member.ts"
click node_queries "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/queries.ts"
click node_domain "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/domain.ts"
click node_admin_pages "https://github.com/jsiekham/evergrace-app/blob/main/src/app/admin/page.tsx"
click node_admin_content "https://github.com/jsiekham/evergrace-app/blob/main/src/actions/admin-content.ts"
click node_admin_video "https://github.com/jsiekham/evergrace-app/blob/main/src/actions/admin-video.ts"
click node_reports "https://github.com/jsiekham/evergrace-app/blob/main/src/app/admin/reports/page.tsx"
click node_db "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/db.ts"
click node_notifications "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/notifications.ts"
click node_mux_hook "https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/mux/webhook/route.ts"
click node_media "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/media.ts"
click node_stripe_hook "https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/stripe/webhook/route.ts"
click node_billing "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/billing.ts"
click node_email "https://github.com/jsiekham/evergrace-app/blob/main/src/lib/mail.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_onboarding,node_member_login,node_dashboard,node_library,node_player toneBlue
class node_admin_pages,node_admin_content,node_admin_video,node_reports toneAmber
class node_onboarding_action,node_auth,node_auth_callback,node_member_actions,node_queries,node_domain,node_notifications,node_media,node_billing toneMint
class node_db,node_mux_hook,node_stripe_hook,node_email toneRose
class node_visitor,node_staff,node_stripe,node_mux toneIndigo
```

## Components

### Member experience

- [Health check-in](https://github.com/jsiekham/evergrace-app/blob/main/src/app/onboarding/page.tsx): `src/app/onboarding/page.tsx`
- [Member login](https://github.com/jsiekham/evergrace-app/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Member dashboard](https://github.com/jsiekham/evergrace-app/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Video library](https://github.com/jsiekham/evergrace-app/blob/main/src/app/library/page.tsx): `src/app/library/page.tsx`
- [Lesson player](https://github.com/jsiekham/evergrace-app/blob/main/src/app/library/%5BvideoId%5D/page.tsx): `src/app/library/[videoId]/page.tsx`

### Staff console

- [Admin console](https://github.com/jsiekham/evergrace-app/blob/main/src/app/admin/page.tsx): `src/app/admin/page.tsx`
- [Content management](https://github.com/jsiekham/evergrace-app/blob/main/src/actions/admin-content.ts): `src/actions/admin-content.ts`
- [Video management](https://github.com/jsiekham/evergrace-app/blob/main/src/actions/admin-video.ts): `src/actions/admin-video.ts`
- [Reports and roster](https://github.com/jsiekham/evergrace-app/blob/main/src/app/admin/reports/page.tsx): `src/app/admin/reports/page.tsx`

### Application services

- [Track and signup](https://github.com/jsiekham/evergrace-app/blob/main/src/actions/onboarding.ts): `src/actions/onboarding.ts`
- [Authentication](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Magic-link callback](https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/auth/callback/route.ts): `src/app/api/auth/callback/route.ts`
- [Member actions](https://github.com/jsiekham/evergrace-app/blob/main/src/actions/member.ts): `src/actions/member.ts`
- [Read queries](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/queries.ts): `src/lib/queries.ts`
- [Access and track rules](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/domain.ts): `src/lib/domain.ts`
- [Follower notifications](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/notifications.ts): `src/lib/notifications.ts`
- [Video hosting](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/media.ts): `src/lib/media.ts`
- [Plan changes](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/billing.ts): `src/lib/billing.ts`

### Integrations and state

- [Application database](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Mux asset webhook](https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/mux/webhook/route.ts): `src/app/api/mux/webhook/route.ts`
- [Stripe webhook](https://github.com/jsiekham/evergrace-app/blob/main/src/app/api/stripe/webhook/route.ts): `src/app/api/stripe/webhook/route.ts`
- [Email delivery](https://github.com/jsiekham/evergrace-app/blob/main/src/lib/mail.ts): `src/lib/mail.ts`

### Other components

- **Member**
- **Staff**
- **Stripe**
- **Mux**

## Connections

- Member → Health check-in: starts check-in (evidence: `README.md`)
- Health check-in → Track and signup: submits answers (evidence: `README.md`)
- Track and signup → Access and track rules: scores track (evidence: `src/actions/onboarding.ts`)
- Track and signup → Application database: creates account (evidence: `src/actions/onboarding.ts`)
- Member → Member login: signs in (evidence: `README.md`)
- Member login → Authentication: requests magic link (evidence: `README.md`)
- Authentication → Email delivery: sends link (evidence: `src/lib/auth.ts`)
- Email delivery → Member: delivers link
- Magic-link callback → Authentication: validates token (evidence: `src/app/api/auth/callback/route.ts`)
- Authentication → Application database: stores sessions (evidence: `src/lib/auth.ts`)
- Member → Member dashboard: views activity (evidence: `README.md`)
- Member dashboard → Read queries: loads aggregates (evidence: `README.md`)
- Member dashboard → Member actions: records check-ins (evidence: `README.md`)
- Member → Video library: browses lessons (evidence: `README.md`)
- Video library → Read queries: loads catalog (evidence: `README.md`)
- Member → Lesson player: opens lesson (evidence: `README.md`)
- Lesson player → Member actions: records progress (evidence: `README.md`)
- Member actions → Authentication: requires member (evidence: `src/actions/member.ts`)
- Member actions → Access and track rules: checks eligibility (evidence: `src/actions/member.ts`)
- Member actions → Application database: writes activity (evidence: `src/actions/member.ts`)
- Read queries → Application database: reads records (evidence: `src/lib/queries.ts`)
- Read queries → Access and track rules: applies rules (evidence: `src/lib/queries.ts`)
- Staff → Admin console: manages platform (evidence: `README.md`)
- Admin console → Content management: edits content
- Admin console → Video management: manages videos (evidence: `README.md`)
- Admin console → Reports and roster: reviews impact (evidence: `README.md`)
- Content management → Application database: updates content (evidence: `src/actions/admin-content.ts`)
- Content management → Authentication: requires staff (evidence: `src/actions/admin-content.ts`)
- Video management → Application database: updates catalog
- Video management → Follower notifications: notifies on publish (evidence: `README.md`)
- Mux → Mux asset webhook: sends asset event (evidence: `README.md`)
- Mux asset webhook → Video hosting: builds thumbnail URL (evidence: `src/app/api/mux/webhook/route.ts`)
- Mux asset webhook → Application database: updates ready asset (evidence: `src/app/api/mux/webhook/route.ts`)
- Mux asset webhook → Follower notifications: fans out notices (evidence: `src/app/api/mux/webhook/route.ts`)
- Follower notifications → Application database: stores notices (evidence: `src/lib/notifications.ts`)
- Stripe → Stripe webhook: sends billing event (evidence: `README.md`)
- Stripe webhook → Plan changes: applies plan (evidence: `src/app/api/stripe/webhook/route.ts`)
- Plan changes → Application database: updates subscription (evidence: `src/lib/billing.ts`)
