# amicusnextc-ui/amicus-checkin- architecture

> Architecture diagram of the GitHub repository amicusnextc-ui/amicus-checkin-, 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/amicusnextc-ui/amicus-checkin-
- Repository: https://github.com/amicusnextc-ui/amicus-checkin-

## Overview

Amicus Check-In is a Sunday attendance and student-management web app for a church education program. Families and staff use public kiosk, checkout, registration, and token-linked forms, while staff and directors use authenticated management pages. The primary flow records check-ins and checkouts, then supports attendance review and weekly wrap-up through serverless APIs backed by Notion. Scheduled GitHub Actions also handle reconciliation, reminders, and grade advancement. API-to-Notion and page-to-API links follow the README; unsampled implementation details are not inferred.

Main entry points: [`index.html`](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/index.html) (Check-in Kiosks), [`staff.html`](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/staff.html) (Staff Console), [`director.html`](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/director.html) (Director Dashboard), [`api/roster.js`](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/roster.js) (Student Roster)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance &amp; Kiosk"]
  node_kiosk["Check-in Kiosks<br/>[index.html]"]
  node_youth["Youth Kiosk<br/>[youth.html]"]
  node_checkout_page["Checkout Page"]
  node_checkin_api["Check-in<br/>[checkin.js]"]
  node_checkout_api["Checkout<br/>[checkout.js]"]
  node_status_api["Attendance Status<br/>[check-status.js]"]
  node_today_api["Today's Attendance"]
  node_attendance_api["Attendance Records<br/>[attendance.js]"]
  node_visitor_api["Visitor Check-in<br/>[visitor-checkin.js]"]
end

subgraph group_management["Staff Management"]
  node_staff_page["Staff Console<br/>[staff.html]"]
  node_director_page["Director Dashboard<br/>[director.html]"]
  node_admin_page["Admin Tools<br/>[admin.html]"]
  node_auth_api["Staff Authentication<br/>[staff-auth.js]"]
  node_staff_list["Staff List<br/>[staff-list.js]"]
  node_summary_api["Weekly Summary<br/>[weekly-summary.js]"]
end

subgraph group_student["Student &amp; Family"]
  node_search_api["Student Search<br/>[search-student.js]"]
  node_roster_api["Student Roster<br/>[roster.js]"]
  node_register["Registration<br/>[register.html]"]
  node_parent_info["Parent Info Form<br/>[parent-info.html]"]
  node_liability["Liability Form<br/>[liability.html]"]
  node_student_update["Student Updates<br/>[update-student.js]"]
end

subgraph group_automation["Scheduled Operations"]
  node_actions["GitHub Actions<br/>[workflows]"]
end

node_families(("Families"))
node_staff(("Staff"))
node_notion[("Notion Databases")]
node_resend["Resend Email"]

node_families -->|"use"| node_kiosk
node_families -->|"use"| node_youth
node_families -->|"use"| node_checkout_page
node_staff -->|"use"| node_staff_page
node_staff -->|"use"| node_director_page
node_staff -->|"use"| node_admin_page
node_kiosk -->|"fetches"| node_search_api
node_kiosk -->|"fetches"| node_status_api
node_kiosk -->|"fetches"| node_checkin_api
node_kiosk -->|"fetches"| node_checkout_api
node_kiosk -->|"fetches"| node_roster_api
node_kiosk -->|"fetches"| node_today_api
node_kiosk -->|"fetches"| node_student_update
node_kiosk -->|"fetches"| node_visitor_api
node_youth -->|"fetches"| node_roster_api
node_youth -->|"fetches"| node_checkin_api
node_youth -->|"fetches"| node_today_api
node_youth -->|"fetches"| node_visitor_api
node_checkout_page -->|"fetches"| node_roster_api
node_checkout_page -->|"fetches"| node_checkout_api
node_checkout_page -->|"fetches"| node_today_api
node_staff_page -->|"fetches"| node_auth_api
node_staff_page -->|"fetches"| node_roster_api
node_staff_page -->|"fetches"| node_attendance_api
node_staff_page -->|"fetches"| node_today_api
node_staff_page -->|"fetches"| node_checkin_api
node_staff_page -->|"fetches"| node_checkout_api
node_staff_page -->|"fetches"| node_student_update
node_staff_page -->|"fetches"| node_summary_api
node_director_page -->|"fetches"| node_auth_api
node_director_page -->|"fetches"| node_staff_list
node_director_page -->|"fetches"| node_roster_api
node_director_page -->|"fetches"| node_attendance_api
node_director_page -->|"fetches"| node_today_api
node_director_page -->|"fetches"| node_student_update
node_director_page -->|"fetches"| node_summary_api
node_admin_page -->|"fetches"| node_today_api
node_admin_page -->|"fetches"| node_checkin_api
node_admin_page -->|"fetches"| node_checkout_api
node_families -->|"use"| node_register
node_families -->|"use"| node_parent_info
node_families -->|"use"| node_liability
node_register -->|"fetches"| node_student_update
node_parent_info -->|"fetches"| node_roster_api
node_parent_info -->|"fetches"| node_student_update
node_liability -->|"fetches"| node_roster_api
node_liability -->|"fetches"| node_search_api
node_liability -->|"fetches"| node_student_update

click node_kiosk "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/index.html"
click node_youth "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/youth.html"
click node_checkout_page "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/staff-checkout.html"
click node_checkin_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/checkin.js"
click node_checkout_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/checkout.js"
click node_status_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/check-status.js"
click node_today_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/attendance-today.js"
click node_attendance_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/attendance.js"
click node_search_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/search-student.js"
click node_roster_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/roster.js"
click node_visitor_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/visitor-checkin.js"
click node_staff_page "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/staff.html"
click node_director_page "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/director.html"
click node_admin_page "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/admin.html"
click node_auth_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/staff-auth.js"
click node_staff_list "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/staff-list.js"
click node_summary_api "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/weekly-summary.js"
click node_register "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/register.html"
click node_parent_info "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/parent-info.html"
click node_liability "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/liability.html"
click node_student_update "https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/update-student.js"
click node_actions "https://github.com/amicusnextc-ui/amicus-checkin-/tree/main/.github/workflows"

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_kiosk,node_youth,node_checkout_page,node_checkin_api,node_checkout_api,node_status_api,node_today_api,node_attendance_api,node_visitor_api toneBlue
class node_staff_page,node_director_page,node_admin_page,node_auth_api,node_staff_list,node_summary_api,node_notion toneAmber
class node_search_api,node_roster_api,node_register,node_parent_info,node_liability,node_student_update toneMint
class node_actions toneRose
class node_families,node_staff,node_resend toneIndigo
```

## Components

### Attendance & Kiosk

- [Check-in Kiosks](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/index.html): `index.html`
- [Youth Kiosk](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/youth.html): `youth.html`
- [Checkout Page](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/staff-checkout.html): `staff-checkout.html`
- [Check-in](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/checkin.js): `api/checkin.js`
- [Checkout](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/checkout.js): `api/checkout.js`
- [Attendance Status](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/check-status.js): `api/check-status.js`
- [Today's Attendance](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/attendance-today.js): `api/attendance-today.js`
- [Attendance Records](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/attendance.js): `api/attendance.js`
- [Visitor Check-in](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/visitor-checkin.js): `api/visitor-checkin.js`

### Staff Management

- [Staff Console](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/staff.html): `staff.html`
- [Director Dashboard](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/director.html): `director.html`
- [Admin Tools](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/admin.html): `admin.html`
- [Staff Authentication](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/staff-auth.js): `api/staff-auth.js`
- [Staff List](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/staff-list.js): `api/staff-list.js`
- [Weekly Summary](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/weekly-summary.js): `api/weekly-summary.js`

### Student & Family

- [Student Search](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/search-student.js): `api/search-student.js`
- [Student Roster](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/roster.js): `api/roster.js`
- [Registration](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/register.html): `register.html`
- [Parent Info Form](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/parent-info.html): `parent-info.html`
- [Liability Form](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/liability.html): `liability.html`
- [Student Updates](https://github.com/amicusnextc-ui/amicus-checkin-/blob/main/api/update-student.js): `api/update-student.js`

### Scheduled Operations

- [GitHub Actions](https://github.com/amicusnextc-ui/amicus-checkin-/tree/main/.github/workflows): `.github/workflows`

### Other components

- **Families**
- **Staff**
- **Notion Databases**
- **Resend Email**

## Connections

- Families → Check-in Kiosks: use (evidence: `README.md`)
- Families → Youth Kiosk: use (evidence: `README.md`)
- Families → Checkout Page: use (evidence: `README.md`)
- Staff → Staff Console: use (evidence: `README.md`)
- Staff → Director Dashboard: use (evidence: `README.md`)
- Staff → Admin Tools: use (evidence: `README.md`)
- Check-in Kiosks → Student Search: fetches (evidence: `README.md`)
- Check-in Kiosks → Attendance Status: fetches (evidence: `README.md`)
- Check-in Kiosks → Check-in: fetches (evidence: `README.md`)
- Check-in Kiosks → Checkout: fetches (evidence: `README.md`)
- Check-in Kiosks → Student Roster: fetches (evidence: `README.md`)
- Check-in Kiosks → Today's Attendance: fetches (evidence: `README.md`)
- Check-in Kiosks → Student Updates: fetches (evidence: `README.md`)
- Check-in Kiosks → Visitor Check-in: fetches (evidence: `README.md`)
- Youth Kiosk → Student Roster: fetches (evidence: `README.md`)
- Youth Kiosk → Check-in: fetches (evidence: `README.md`)
- Youth Kiosk → Today's Attendance: fetches (evidence: `README.md`)
- Youth Kiosk → Visitor Check-in: fetches (evidence: `README.md`)
- Checkout Page → Student Roster: fetches (evidence: `README.md`)
- Checkout Page → Checkout: fetches (evidence: `README.md`)
- Checkout Page → Today's Attendance: fetches (evidence: `README.md`)
- Staff Console → Staff Authentication: fetches (evidence: `README.md`)
- Staff Console → Student Roster: fetches (evidence: `README.md`)
- Staff Console → Attendance Records: fetches (evidence: `README.md`)
- Staff Console → Today's Attendance: fetches (evidence: `README.md`)
- Staff Console → Check-in: fetches (evidence: `README.md`)
- Staff Console → Checkout: fetches (evidence: `README.md`)
- Staff Console → Student Updates: fetches (evidence: `README.md`)
- Staff Console → Weekly Summary: fetches (evidence: `README.md`)
- Director Dashboard → Staff Authentication: fetches (evidence: `README.md`)
- Director Dashboard → Staff List: fetches (evidence: `README.md`)
- Director Dashboard → Student Roster: fetches (evidence: `README.md`)
- Director Dashboard → Attendance Records: fetches (evidence: `README.md`)
- Director Dashboard → Today's Attendance: fetches (evidence: `README.md`)
- Director Dashboard → Student Updates: fetches (evidence: `README.md`)
- Director Dashboard → Weekly Summary: fetches (evidence: `README.md`)
- Admin Tools → Today's Attendance: fetches (evidence: `README.md`)
- Admin Tools → Check-in: fetches (evidence: `README.md`)
- Admin Tools → Checkout: fetches (evidence: `README.md`)
- Families → Registration: use (evidence: `README.md`)
- Families → Parent Info Form: use (evidence: `README.md`)
- Families → Liability Form: use (evidence: `README.md`)
- Registration → Student Updates: fetches (evidence: `README.md`)
- Parent Info Form → Student Roster: fetches (evidence: `README.md`)
- Parent Info Form → Student Updates: fetches (evidence: `README.md`)
- Liability Form → Student Roster: fetches (evidence: `README.md`)
- Liability Form → Student Search: fetches (evidence: `README.md`)
- Liability Form → Student Updates: fetches (evidence: `README.md`)
