# rjd72/artis-youth-soccer-training architecture

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

- Interactive diagram: https://gitdiagram.com/rjd72/artis-youth-soccer-training
- Repository: https://github.com/rjd72/artis-youth-soccer-training

## Overview

ARTIS is a youth soccer training academy website with online registration, renewals, waitlists, payment processing, and staff administration. The main participant workflow is to review available programs, submit a registration, pay by e-transfer or Stripe, and receive confirmation; renewal and waitlist routes provide alternative paths. Staff manage registrations and waitlist entries through the admin area. The graph includes the documented/source-indexed subsystem boundaries; several registration and renewal implementation files were not sampled, so their internal calls are not inferred.

Main entry points: [`lib/registration-options.ts`](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/registration-options.ts) (Availability service), [`app/register/page.tsx`](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/page.tsx) (Registration entry), [`db/index.ts`](https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/index.ts) (MySQL data store), [`db/schema.ts`](https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/schema.ts) (Application schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public website"]
  node_public_pages["Academy pages<br/>[page.tsx]"]
  node_site_navigation["Shared navigation<br/>[site-header.tsx]"]
  node_site_footer["Shared footer<br/>[site-footer.tsx]"]
  node_contact_form["Contact form<br/>[contact-form.tsx]"]
  node_contact_actions["Contact handling<br/>[actions.ts]"]
end

subgraph group_enrollment["Enrollment"]
  node_registration_page["Registration entry<br/>[page.tsx]"]
  node_program_selection["Program selection"]
  node_registration_submission["Registration submission<br/>[actions.ts]"]
  node_payment_choices["Payment options"]
  node_stripe_checkout["Stripe checkout"]
  node_renewal["Renewal flow"]
  node_waitlist["Waitlist flow"]
end

subgraph group_operations["Staff operations"]
  node_admin_portal["Admin portal<br/>[page.tsx]"]
  node_admin_registrations["Registration management<br/>[page.tsx]"]
  node_admin_waitlist["Waitlist management<br/>[page.tsx]"]
  node_admin_registration_actions["Registration actions<br/>[actions.ts]"]
  node_admin_waitlist_actions["Waitlist actions<br/>[actions.ts]"]
  node_registration_controls["Registration controls"]
  node_waitlist_controls["Waitlist controls"]
end

subgraph group_platform["Platform services"]
  node_auth_api["Authentication endpoint<br/>[route.ts]"]
  node_auth_service["Authentication service<br/>[auth.ts]"]
  node_stripe_webhook["Stripe webhook<br/>[route.ts]"]
  node_webhook_processing["Payment event processing"]
  node_confirmation_email["Registration email"]
  node_registration_options["Availability service"]
  node_database[("MySQL data store<br/>[index.ts]")]
  node_schema["Application schema<br/>[schema.ts]"]
  node_stripe_service["Stripe client<br/>[stripe.ts]"]
  node_admin_auth["Admin authorization<br/>[admin-auth.ts]"]
  node_admin_dashboard["Dashboard data<br/>[admin-dashboard.ts]"]
  node_admin_registration_data["Registration queries"]
  node_admin_waitlist_data["Waitlist queries<br/>[admin-waitlist.ts]"]
end

node_visitor(("Visitor / guardian"))

node_public_pages -->|"loads availability"| node_registration_options
node_public_pages -->|"renders"| node_site_navigation
node_public_pages -->|"renders"| node_site_footer
node_registration_page -->|"loads options"| node_registration_options
node_registration_page -->|"renders"| node_program_selection
node_registration_page -->|"renders"| node_site_navigation
node_registration_page -->|"renders"| node_site_footer
node_stripe_checkout -->|"queries"| node_database
node_stripe_checkout -->|"uses tables"| node_schema
node_stripe_checkout -->|"creates session"| node_stripe_service
node_stripe_webhook -->|"gets client"| node_stripe_service
node_stripe_webhook -->|"processes event"| node_webhook_processing
node_stripe_webhook -->|"sends confirmation"| node_confirmation_email
node_webhook_processing -->|"updates records"| node_database
node_webhook_processing -->|"uses tables"| node_schema
node_auth_api -->|"routes requests"| node_auth_service
node_auth_service -->|"uses connection"| node_database
node_auth_service -->|"uses auth tables"| node_schema
node_registration_options -->|"queries"| node_database
node_registration_options -->|"uses tables"| node_schema
node_registration_options -->|"synchronizes statuses"| node_registration_options
node_admin_portal -->|"checks access"| node_admin_auth
node_admin_portal -->|"loads dashboard"| node_admin_dashboard
node_admin_registrations -->|"loads records"| node_admin_registration_data
node_admin_registrations -->|"renders controls"| node_registration_controls
node_registration_controls -->|"invokes actions"| node_admin_registration_actions
node_admin_waitlist -->|"loads entries"| node_admin_waitlist_data
node_admin_waitlist -->|"renders controls"| node_waitlist_controls
node_waitlist_controls -->|"invokes actions"| node_admin_waitlist_actions
node_contact_form -->|"submits to"| node_contact_actions

click node_public_pages "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/page.tsx"
click node_site_navigation "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/components/site-header.tsx"
click node_site_footer "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/components/site-footer.tsx"
click node_registration_page "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/page.tsx"
click node_program_selection "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/program-selector.tsx"
click node_registration_submission "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/actions.ts"
click node_payment_choices "https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/payment"
click node_stripe_checkout "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/create-stripe-checkout-session.ts"
click node_renewal "https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/renew"
click node_waitlist "https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/waitlist"
click node_admin_portal "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/page.tsx"
click node_admin_registrations "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/page.tsx"
click node_admin_waitlist "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/page.tsx"
click node_auth_api "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/api/auth/%5B...all%5D/route.ts"
click node_auth_service "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/auth.ts"
click node_stripe_webhook "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/api/stripe/webhook/route.ts"
click node_webhook_processing "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/process-stripe-webhook-event.ts"
click node_confirmation_email "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/send-confirmed-stripe-registration-email.ts"
click node_registration_options "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/registration-options.ts"
click node_database "https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/index.ts"
click node_schema "https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/schema.ts"
click node_stripe_service "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/stripe.ts"
click node_admin_auth "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-auth.ts"
click node_admin_dashboard "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-dashboard.ts"
click node_admin_registration_data "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-registrations.ts"
click node_admin_waitlist_data "https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-waitlist.ts"
click node_admin_registration_actions "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/actions.ts"
click node_admin_waitlist_actions "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/actions.ts"
click node_registration_controls "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/confirm-e-transfer-control.tsx"
click node_waitlist_controls "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/waitlist-entry-actions.tsx"
click node_contact_form "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/contact/contact-form.tsx"
click node_contact_actions "https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/contact/actions.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_public_pages,node_site_navigation,node_site_footer,node_contact_form,node_contact_actions toneBlue
class node_registration_page,node_program_selection,node_registration_submission,node_payment_choices,node_stripe_checkout,node_renewal,node_waitlist toneAmber
class node_admin_portal,node_admin_registrations,node_admin_waitlist,node_admin_registration_actions,node_admin_waitlist_actions,node_registration_controls,node_waitlist_controls toneMint
class node_auth_api,node_auth_service,node_stripe_webhook,node_webhook_processing,node_confirmation_email,node_registration_options,node_database,node_schema,node_stripe_service,node_admin_auth,node_admin_dashboard,node_admin_registration_data,node_admin_waitlist_data toneRose
class node_visitor toneIndigo
```

## Components

### Public website

- [Academy pages](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/page.tsx): `app/page.tsx`
- [Shared navigation](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/components/site-header.tsx): `app/components/site-header.tsx`
- [Shared footer](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/components/site-footer.tsx): `app/components/site-footer.tsx`
- [Contact form](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/contact/contact-form.tsx): `app/contact/contact-form.tsx`
- [Contact handling](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/contact/actions.ts): `app/contact/actions.ts`

### Enrollment

- [Registration entry](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/page.tsx): `app/register/page.tsx`
- [Program selection](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/program-selector.tsx): `app/register/program-selector.tsx`
- [Registration submission](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/register/actions.ts): `app/register/actions.ts`
- [Payment options](https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/payment): `app/register/payment`
- [Stripe checkout](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/create-stripe-checkout-session.ts): `lib/create-stripe-checkout-session.ts`
- [Renewal flow](https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/renew): `app/register/renew`
- [Waitlist flow](https://github.com/rjd72/artis-youth-soccer-training/tree/main/app/register/waitlist): `app/register/waitlist`

### Staff operations

- [Admin portal](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Registration management](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/page.tsx): `app/admin/registrations/page.tsx`
- [Waitlist management](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/page.tsx): `app/admin/waitlist/page.tsx`
- [Registration actions](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/actions.ts): `app/admin/registrations/actions.ts`
- [Waitlist actions](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/actions.ts): `app/admin/waitlist/actions.ts`
- [Registration controls](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/registrations/confirm-e-transfer-control.tsx): `app/admin/registrations/confirm-e-transfer-control.tsx`
- [Waitlist controls](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/admin/waitlist/waitlist-entry-actions.tsx): `app/admin/waitlist/waitlist-entry-actions.tsx`

### Platform services

- [Authentication endpoint](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/api/auth/%5B...all%5D/route.ts): `app/api/auth/[...all]/route.ts`
- [Authentication service](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/auth.ts): `lib/auth.ts`
- [Stripe webhook](https://github.com/rjd72/artis-youth-soccer-training/blob/main/app/api/stripe/webhook/route.ts): `app/api/stripe/webhook/route.ts`
- [Payment event processing](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/process-stripe-webhook-event.ts): `lib/process-stripe-webhook-event.ts`
- [Registration email](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/send-confirmed-stripe-registration-email.ts): `lib/send-confirmed-stripe-registration-email.ts`
- [Availability service](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/registration-options.ts): `lib/registration-options.ts`
- [MySQL data store](https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/index.ts): `db/index.ts`
- [Application schema](https://github.com/rjd72/artis-youth-soccer-training/blob/main/db/schema.ts): `db/schema.ts`
- [Stripe client](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/stripe.ts): `lib/stripe.ts`
- [Admin authorization](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-auth.ts): `lib/admin-auth.ts`
- [Dashboard data](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-dashboard.ts): `lib/admin-dashboard.ts`
- [Registration queries](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-registrations.ts): `lib/admin-registrations.ts`
- [Waitlist queries](https://github.com/rjd72/artis-youth-soccer-training/blob/main/lib/admin-waitlist.ts): `lib/admin-waitlist.ts`

### Other components

- **Visitor / guardian**

## Connections

- Academy pages → Availability service: loads availability (evidence: `app/page.tsx`)
- Academy pages → Shared navigation: renders (evidence: `app/page.tsx`)
- Academy pages → Shared footer: renders (evidence: `app/page.tsx`)
- Registration entry → Availability service: loads options (evidence: `app/register/page.tsx`)
- Registration entry → Program selection: renders (evidence: `app/register/page.tsx`)
- Registration entry → Shared navigation: renders (evidence: `app/register/page.tsx`)
- Registration entry → Shared footer: renders (evidence: `app/register/page.tsx`)
- Stripe checkout → MySQL data store: queries (evidence: `lib/create-stripe-checkout-session.ts`)
- Stripe checkout → Application schema: uses tables (evidence: `lib/create-stripe-checkout-session.ts`)
- Stripe checkout → Stripe client: creates session (evidence: `lib/create-stripe-checkout-session.ts`)
- Stripe webhook → Stripe client: gets client (evidence: `app/api/stripe/webhook/route.ts`)
- Stripe webhook → Payment event processing: processes event (evidence: `app/api/stripe/webhook/route.ts`)
- Stripe webhook → Registration email: sends confirmation (evidence: `app/api/stripe/webhook/route.ts`)
- Payment event processing → MySQL data store: updates records (evidence: `lib/process-stripe-webhook-event.ts`)
- Payment event processing → Application schema: uses tables (evidence: `lib/process-stripe-webhook-event.ts`)
- Authentication endpoint → Authentication service: routes requests (evidence: `app/api/auth/[...all]/route.ts`)
- Authentication service → MySQL data store: uses connection (evidence: `lib/auth.ts`)
- Authentication service → Application schema: uses auth tables (evidence: `lib/auth.ts`)
- Availability service → MySQL data store: queries (evidence: `lib/registration-options.ts`)
- Availability service → Application schema: uses tables (evidence: `lib/registration-options.ts`)
- Availability service → Availability service: synchronizes statuses (evidence: `lib/registration-options.ts`)
- Admin portal → Admin authorization: checks access (evidence: `app/admin/page.tsx`)
- Admin portal → Dashboard data: loads dashboard (evidence: `app/admin/page.tsx`)
- Registration management → Registration queries: loads records (evidence: `app/admin/registrations/page.tsx`)
- Registration management → Registration controls: renders controls (evidence: `app/admin/registrations/page.tsx`)
- Registration controls → Registration actions: invokes actions (evidence: `app/admin/registrations/confirm-e-transfer-control.tsx`)
- Waitlist management → Waitlist queries: loads entries (evidence: `app/admin/waitlist/page.tsx`)
- Waitlist management → Waitlist controls: renders controls (evidence: `app/admin/waitlist/page.tsx`)
- Waitlist controls → Waitlist actions: invokes actions (evidence: `app/admin/waitlist/waitlist-entry-actions.tsx`)
- Contact form → Contact handling: submits to (evidence: `app/contact/contact-form.tsx`)
