# esvillamor/classtapmark architecture

> Architecture diagram of the GitHub repository esvillamor/classtapmark, 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/esvillamor/classtapmark
- Repository: https://github.com/esvillamor/classtapmark

## Overview

ClassTapMark is an offline-first classroom records and school-form application for teachers. The principal workflow is to manage a class and learner records, maintain attendance and academic records, then prepare classroom summaries and school forms. The README says records remain in browser localStorage. The graph preserves the major form, grade-sheet, class-record, and awards areas named by the source tree; several form modules are obfuscated or unsampled, so their internal relationships are not asserted.

Main entry points: [`index.html`](https://github.com/esvillamor/classtapmark/blob/main/index.html) (ClassTapMark), [`gradesheet/gradesheet.js`](https://github.com/esvillamor/classtapmark/blob/main/gradesheet/gradesheet.js) (Grade Sheet), [`SF5.js`](https://github.com/esvillamor/classtapmark/blob/main/SF5.js) (School Form 5), [`SF1.js`](https://github.com/esvillamor/classtapmark/blob/main/SF1.js) (Attendance Form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_classroom["Classroom Records"]
  node_attendance["Attendance Form<br/>[SF1.js]"]
  node_learner["Learner Profiles<br/>[SF1.js]"]
end

subgraph group_academic["Academic Records"]
  node_classrecord["Class Record<br/>[pace.js]"]
  node_gradesheet["Grade Sheet<br/>[gradesheet.js]"]
  node_kgradesheet["Kinder Grade Sheet<br/>[kGradeSheet.js]"]
  node_awards["Awards<br/>[awards.js]"]
end

subgraph group_forms["School Forms"]
  node_sf9["School Form 9<br/>[sf9.js]"]
  node_sf1pdf["SF1 Export<br/>[SF1pdf.js]"]
  node_sf2["School Form 2<br/>[SF2.js]"]
  node_sf3["School Form 3<br/>[SF3.js]"]
  node_sf3pdf["SF3 Export<br/>[SF3pdf.js]"]
  node_sf5["School Form 5<br/>[SF5.js]"]
  node_sf5export["SF5 Export<br/>[SF5pdf.js]"]
  node_sf8["School Form 8 Export<br/>[SF8pdf.js]"]
  node_sf10["School Form 10<br/>[SF10.js]"]
end

subgraph group_runtime["Offline Runtime"]
  node_app["ClassTapMark<br/>[index.html]"]
  node_storage[("Browser Records")]
  node_serviceworker["Offline Service Worker<br/>[sw.js]"]
end

node_teacher(("Teacher"))

node_teacher -->|"uses"| node_app
node_app -.->|"manages attendance"| node_attendance
node_app -.->|"manages learners"| node_learner
node_app -.->|"maintains records"| node_classrecord
node_app -.->|"records grades"| node_gradesheet
node_app -.->|"records grades"| node_kgradesheet
node_app -.->|"prepares forms"| node_sf9
node_app -.->|"prepares forms"| node_sf1pdf
node_app -.->|"prepares forms"| node_sf2
node_app -.->|"prepares forms"| node_sf3
node_app -.->|"prepares forms"| node_sf3pdf
node_app -.->|"prepares forms"| node_sf5
node_app -.->|"exports form"| node_sf5export
node_app -.->|"prepares forms"| node_sf8
node_app -.->|"prepares forms"| node_sf10
node_app -.->|"calculates awards"| node_awards
node_attendance -.->|"stores records"| node_storage
node_learner -.->|"stores profiles"| node_storage
node_classrecord -->|"reads and writes"| node_storage
node_gradesheet -.->|"stores grades"| node_storage
node_kgradesheet -->|"stores summaries"| node_storage
node_awards -->|"reads snapshot"| node_gradesheet
node_sf5 -->|"reads snapshot"| node_gradesheet
node_sf5 -->|"stores admin data"| node_storage

click node_app "https://github.com/esvillamor/classtapmark/blob/main/index.html"
click node_attendance "https://github.com/esvillamor/classtapmark/blob/main/SF1.js"
click node_learner "https://github.com/esvillamor/classtapmark/blob/main/SF1.js"
click node_classrecord "https://github.com/esvillamor/classtapmark/blob/main/classrecord/pace.js"
click node_gradesheet "https://github.com/esvillamor/classtapmark/blob/main/gradesheet/gradesheet.js"
click node_kgradesheet "https://github.com/esvillamor/classtapmark/blob/main/kgradesheet/kGradeSheet.js"
click node_awards "https://github.com/esvillamor/classtapmark/blob/main/Awards/awards.js"
click node_sf9 "https://github.com/esvillamor/classtapmark/blob/main/SF9/sf9.js"
click node_sf1pdf "https://github.com/esvillamor/classtapmark/blob/main/SF1pdf.js"
click node_sf2 "https://github.com/esvillamor/classtapmark/blob/main/SF2.js"
click node_sf3 "https://github.com/esvillamor/classtapmark/blob/main/SF3.js"
click node_sf3pdf "https://github.com/esvillamor/classtapmark/blob/main/SF3pdf.js"
click node_sf5 "https://github.com/esvillamor/classtapmark/blob/main/SF5.js"
click node_sf5export "https://github.com/esvillamor/classtapmark/blob/main/SF5pdf.js"
click node_sf8 "https://github.com/esvillamor/classtapmark/blob/main/SF8pdf.js"
click node_sf10 "https://github.com/esvillamor/classtapmark/blob/main/SF10.js"
click node_serviceworker "https://github.com/esvillamor/classtapmark/blob/main/sw.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_attendance,node_learner toneBlue
class node_classrecord,node_gradesheet,node_kgradesheet,node_awards toneAmber
class node_sf9,node_sf1pdf,node_sf2,node_sf3,node_sf3pdf,node_sf5,node_sf5export,node_sf8,node_sf10 toneMint
class node_app,node_storage,node_serviceworker toneRose
class node_teacher toneIndigo
```

## Components

### Classroom Records

- [Attendance Form](https://github.com/esvillamor/classtapmark/blob/main/SF1.js): `SF1.js`
- [Learner Profiles](https://github.com/esvillamor/classtapmark/blob/main/SF1.js): `SF1.js`

### Academic Records

- [Class Record](https://github.com/esvillamor/classtapmark/blob/main/classrecord/pace.js): `classrecord/pace.js`
- [Grade Sheet](https://github.com/esvillamor/classtapmark/blob/main/gradesheet/gradesheet.js): `gradesheet/gradesheet.js`
- [Kinder Grade Sheet](https://github.com/esvillamor/classtapmark/blob/main/kgradesheet/kGradeSheet.js): `kgradesheet/kGradeSheet.js`
- [Awards](https://github.com/esvillamor/classtapmark/blob/main/Awards/awards.js): `Awards/awards.js`

### School Forms

- [School Form 9](https://github.com/esvillamor/classtapmark/blob/main/SF9/sf9.js): `SF9/sf9.js`
- [SF1 Export](https://github.com/esvillamor/classtapmark/blob/main/SF1pdf.js): `SF1pdf.js`
- [School Form 2](https://github.com/esvillamor/classtapmark/blob/main/SF2.js): `SF2.js`
- [School Form 3](https://github.com/esvillamor/classtapmark/blob/main/SF3.js): `SF3.js`
- [SF3 Export](https://github.com/esvillamor/classtapmark/blob/main/SF3pdf.js): `SF3pdf.js`
- [School Form 5](https://github.com/esvillamor/classtapmark/blob/main/SF5.js): `SF5.js`
- [SF5 Export](https://github.com/esvillamor/classtapmark/blob/main/SF5pdf.js): `SF5pdf.js`
- [School Form 8 Export](https://github.com/esvillamor/classtapmark/blob/main/SF8pdf.js): `SF8pdf.js`
- [School Form 10](https://github.com/esvillamor/classtapmark/blob/main/SF10.js): `SF10.js`

### Offline Runtime

- [ClassTapMark](https://github.com/esvillamor/classtapmark/blob/main/index.html): `index.html`
- **Browser Records**
- [Offline Service Worker](https://github.com/esvillamor/classtapmark/blob/main/sw.js): `sw.js`

### Other components

- **Teacher**

## Connections

- Teacher → ClassTapMark: uses (evidence: `README.md`)
- ClassTapMark → Attendance Form: manages attendance
- ClassTapMark → Learner Profiles: manages learners
- ClassTapMark → Class Record: maintains records
- ClassTapMark → Grade Sheet: records grades
- ClassTapMark → Kinder Grade Sheet: records grades
- ClassTapMark → School Form 9: prepares forms
- ClassTapMark → SF1 Export: prepares forms
- ClassTapMark → School Form 2: prepares forms
- ClassTapMark → School Form 3: prepares forms
- ClassTapMark → SF3 Export: prepares forms
- ClassTapMark → School Form 5: prepares forms
- ClassTapMark → SF5 Export: exports form
- ClassTapMark → School Form 8 Export: prepares forms
- ClassTapMark → School Form 10: prepares forms
- ClassTapMark → Awards: calculates awards
- Attendance Form → Browser Records: stores records (evidence: `README.md`)
- Learner Profiles → Browser Records: stores profiles (evidence: `README.md`)
- Class Record → Browser Records: reads and writes (evidence: `classrecord/pace.js`)
- Grade Sheet → Browser Records: stores grades (evidence: `README.md`)
- Kinder Grade Sheet → Browser Records: stores summaries (evidence: `kgradesheet/kGradeSheet.js`)
- Awards → Grade Sheet: reads snapshot (evidence: `Awards/awards.js`)
- School Form 5 → Grade Sheet: reads snapshot (evidence: `SF5.js`)
- School Form 5 → Browser Records: stores admin data (evidence: `SF5.js`)
