# asaad-siddiqui/ncct-cooperative-training-field-kit architecture

> Architecture diagram of the GitHub repository asaad-siddiqui/ncct-cooperative-training-field-kit, 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/asaad-siddiqui/ncct-cooperative-training-field-kit
- Repository: https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit

## Overview

Co Step is a browser-based cooperative-training workflow prototype for trainers and coordinators. The user starts at the overview, records synthetic attendance, completes a lesson and quiz, simulates syncing, reviews the cohort roster, then checks a sample certificate locally. Its central application also manages browser-local demo state and optional QR scanning; a guided tour can drive the same workflow. The README documents the major stages, while the excerpts show the main application and tour wiring. Several feature implementations share src/main.js, so their internal calls are not separately evidenced.

Main entry points: [`src/main.js`](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js) (Browser local state), [`src/guided-tour.js`](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/guided-tour.js) (Guided tour)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App Experience"]
  node_app["Application<br/>[main.js]"]
  node_overview["Overview<br/>[main.js]"]
end

subgraph group_training["Training Workflow"]
  node_attendance["Attendance check-in<br/>[main.js]"]
  node_qr["QR scanning<br/>[main.js]"]
  node_lesson["Short lesson<br/>[main.js]"]
  node_quiz["Knowledge check<br/>[main.js]"]
end

subgraph group_records["Demo Records"]
  node_localstate[("Browser local state<br/>[main.js]")]
  node_activityqueue["Activity queue<br/>[main.js]"]
  node_simulatedsync["Simulated sync<br/>[main.js]"]
  node_roster["Cohort roster<br/>[main.js]"]
  node_eligibility["Completion eligibility<br/>[main.js]"]
  node_certificate["Sample certificate<br/>[main.js]"]
  node_verification["Local verification<br/>[main.js]"]
end

subgraph group_guidance["Guided Walkthrough"]
  node_tour["Guided tour<br/>[guided-tour.js]"]
end

node_trainer(("Trainer / coordinator"))

node_trainer -->|"uses"| node_app
node_app -->|"renders"| node_overview
node_trainer -->|"records"| node_attendance
node_attendance -->|"stores event"| node_localstate
node_trainer -.->|"may scan"| node_qr
node_trainer -->|"reads"| node_lesson
node_trainer -->|"submits"| node_quiz
node_quiz -->|"stores result"| node_localstate
node_localstate -->|"holds pending"| node_activityqueue
node_trainer -->|"runs"| node_simulatedsync
node_simulatedsync -->|"marks synced"| node_activityqueue
node_trainer -->|"reviews"| node_roster
node_roster -->|"reads records"| node_localstate
node_localstate -->|"checks completion"| node_eligibility
node_eligibility -->|"permits issue"| node_certificate
node_trainer -->|"checks record"| node_verification
node_verification -->|"looks up record"| node_localstate
node_trainer -->|"starts"| node_tour
node_tour -->|"drives workflow"| node_app
node_app -->|"creates and renders"| node_tour

click node_app "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_overview "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_attendance "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_qr "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_lesson "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_quiz "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_localstate "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_activityqueue "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_simulatedsync "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_roster "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_eligibility "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_certificate "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_verification "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js"
click node_tour "https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/guided-tour.js"

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_app,node_overview toneBlue
class node_attendance,node_qr,node_lesson,node_quiz toneAmber
class node_localstate,node_activityqueue,node_simulatedsync,node_roster,node_eligibility,node_certificate,node_verification toneMint
class node_tour toneRose
class node_trainer toneIndigo
```

## Components

### App Experience

- [Application](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Overview](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`

### Training Workflow

- [Attendance check-in](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [QR scanning](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Short lesson](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Knowledge check](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`

### Demo Records

- [Browser local state](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Activity queue](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Simulated sync](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Cohort roster](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Completion eligibility](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Sample certificate](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`
- [Local verification](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/main.js): `src/main.js`

### Guided Walkthrough

- [Guided tour](https://github.com/asaad-siddiqui/ncct-cooperative-training-field-kit/blob/main/src/guided-tour.js): `src/guided-tour.js`

### Other components

- **Trainer / coordinator**

## Connections

- Trainer / coordinator → Application: uses (evidence: `README.md`)
- Application → Overview: renders (evidence: `src/main.js`)
- Trainer / coordinator → Attendance check-in: records (evidence: `README.md`)
- Attendance check-in → Browser local state: stores event (evidence: `README.md`)
- Trainer / coordinator → QR scanning: may scan (evidence: `README.md`)
- Trainer / coordinator → Short lesson: reads (evidence: `README.md`)
- Trainer / coordinator → Knowledge check: submits (evidence: `README.md`)
- Knowledge check → Browser local state: stores result (evidence: `README.md`)
- Browser local state → Activity queue: holds pending (evidence: `README.md`)
- Trainer / coordinator → Simulated sync: runs (evidence: `README.md`)
- Simulated sync → Activity queue: marks synced (evidence: `README.md`)
- Trainer / coordinator → Cohort roster: reviews (evidence: `README.md`)
- Cohort roster → Browser local state: reads records (evidence: `README.md`)
- Browser local state → Completion eligibility: checks completion (evidence: `README.md`)
- Completion eligibility → Sample certificate: permits issue (evidence: `README.md`)
- Trainer / coordinator → Local verification: checks record (evidence: `README.md`)
- Local verification → Browser local state: looks up record (evidence: `src/main.js`)
- Trainer / coordinator → Guided tour: starts (evidence: `README.md`)
- Guided tour → Application: drives workflow (evidence: `README.md`)
- Application → Guided tour: creates and renders (evidence: `src/main.js`)
