# mattjones853/opstraining architecture

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

## Overview

This is a browser-based training tracker for Trade Ops and Fund Ops. Trainees review shift-filtered daily work, record completion, ratings and reflections, then consult task history, SOPs and generated AI summaries. The task and SOP catalogs provide the operational content; browser storage holds settings and daily entries, with an optional file export/sync path for Claude. The graph follows the sampled global-module calls; SOP and task data are represented as catalogs rather than individual procedures. Source excerpts are partial, and no README was provided.

Main entry points: [`app/js/storage.js`](https://github.com/mattjones853/opstraining/blob/main/app/js/storage.js) (Progress storage), [`app/js/app.js`](https://github.com/mattjones853/opstraining/blob/main/app/js/app.js) (App router), [`app/js/views/daily.js`](https://github.com/mattjones853/opstraining/blob/main/app/js/views/daily.js) (Daily view), [`app/js/views/detail.js`](https://github.com/mattjones853/opstraining/blob/main/app/js/views/detail.js) (Task detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Training workflow"]
  node_app["App router<br/>[app.js]"]
  node_daily["Daily view<br/>[daily.js]"]
  node_tasksview["Task list<br/>[tasks.js]"]
  node_detail["Task detail<br/>[detail.js]"]
  node_settings["Settings view<br/>[settings.js]"]
  node_ui["UI helpers<br/>[ui.js]"]
end

subgraph group_content["Training content"]
  node_taskcatalog["Task catalog<br/>[tasks.js]"]
  node_sopcatalog["SOP catalog<br/>[sops.js]"]
  node_ainotes["AI note catalog<br/>[notes.js]"]
end

subgraph group_state["Progress and state"]
  node_storage["Progress storage<br/>[storage.js]"]
  node_browserstore[("Browser local storage<br/>[storage.js]")]
end

subgraph group_exchange["Export and sync"]
  node_sync["File sync<br/>[sync.js]"]
  node_entriesfile["Entries JSON<br/>[entries.json]"]
end

node_trainee(("Trainee"))
node_claude(("Claude desktop"))

node_trainee -->|"records progress"| node_daily
node_app -->|"routes to"| node_daily
node_app -->|"routes to"| node_tasksview
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_settings
node_app -->|"reads settings"| node_storage
node_app -->|"uses helpers"| node_ui
node_daily -->|"renders tasks"| node_taskcatalog
node_daily -->|"reads and updates"| node_storage
node_daily -->|"uses helpers"| node_ui
node_daily -->|"requests save"| node_sync
node_tasksview -->|"filters tasks"| node_taskcatalog
node_tasksview -->|"reads ratings"| node_storage
node_tasksview -->|"uses helpers"| node_ui
node_detail -->|"looks up task"| node_taskcatalog
node_detail -->|"reads SOP"| node_sopcatalog
node_detail -->|"reads history"| node_storage
node_detail -->|"renders markdown"| node_ui
node_storage -->|"reads and writes"| node_browserstore
node_storage -->|"exports task data"| node_taskcatalog
node_storage -->|"reads notes"| node_ainotes
node_settings -->|"updates settings"| node_storage
node_settings -->|"controls sync"| node_sync
node_settings -->|"refreshes header"| node_app
node_sync -->|"exports entries"| node_storage
node_sync -->|"writes JSON"| node_entriesfile
node_sync -.->|"makes entries available"| node_claude

click node_app "https://github.com/mattjones853/opstraining/blob/main/app/js/app.js"
click node_daily "https://github.com/mattjones853/opstraining/blob/main/app/js/views/daily.js"
click node_tasksview "https://github.com/mattjones853/opstraining/blob/main/app/js/views/tasks.js"
click node_detail "https://github.com/mattjones853/opstraining/blob/main/app/js/views/detail.js"
click node_settings "https://github.com/mattjones853/opstraining/blob/main/app/js/views/settings.js"
click node_ui "https://github.com/mattjones853/opstraining/blob/main/app/js/ui.js"
click node_taskcatalog "https://github.com/mattjones853/opstraining/blob/main/app/data/tasks.js"
click node_sopcatalog "https://github.com/mattjones853/opstraining/blob/main/app/data/sops.js"
click node_ainotes "https://github.com/mattjones853/opstraining/blob/main/app/data/notes.js"
click node_storage "https://github.com/mattjones853/opstraining/blob/main/app/js/storage.js"
click node_browserstore "https://github.com/mattjones853/opstraining/blob/main/app/js/storage.js"
click node_sync "https://github.com/mattjones853/opstraining/blob/main/app/js/sync.js"
click node_entriesfile "https://github.com/mattjones853/opstraining/blob/main/app/data/entries.json"

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_daily,node_tasksview,node_detail,node_settings,node_ui toneBlue
class node_taskcatalog,node_sopcatalog,node_ainotes toneAmber
class node_storage,node_browserstore toneMint
class node_sync,node_entriesfile toneRose
class node_trainee,node_claude toneIndigo
```

## Components

### Training workflow

- [App router](https://github.com/mattjones853/opstraining/blob/main/app/js/app.js): `app/js/app.js`
- [Daily view](https://github.com/mattjones853/opstraining/blob/main/app/js/views/daily.js): `app/js/views/daily.js`
- [Task list](https://github.com/mattjones853/opstraining/blob/main/app/js/views/tasks.js): `app/js/views/tasks.js`
- [Task detail](https://github.com/mattjones853/opstraining/blob/main/app/js/views/detail.js): `app/js/views/detail.js`
- [Settings view](https://github.com/mattjones853/opstraining/blob/main/app/js/views/settings.js): `app/js/views/settings.js`
- [UI helpers](https://github.com/mattjones853/opstraining/blob/main/app/js/ui.js): `app/js/ui.js`

### Training content

- [Task catalog](https://github.com/mattjones853/opstraining/blob/main/app/data/tasks.js): `app/data/tasks.js`
- [SOP catalog](https://github.com/mattjones853/opstraining/blob/main/app/data/sops.js): `app/data/sops.js`
- [AI note catalog](https://github.com/mattjones853/opstraining/blob/main/app/data/notes.js): `app/data/notes.js`

### Progress and state

- [Progress storage](https://github.com/mattjones853/opstraining/blob/main/app/js/storage.js): `app/js/storage.js`
- [Browser local storage](https://github.com/mattjones853/opstraining/blob/main/app/js/storage.js): `app/js/storage.js`

### Export and sync

- [File sync](https://github.com/mattjones853/opstraining/blob/main/app/js/sync.js): `app/js/sync.js`
- [Entries JSON](https://github.com/mattjones853/opstraining/blob/main/app/data/entries.json): `app/data/entries.json`

### Other components

- **Trainee**
- **Claude desktop**

## Connections

- Trainee → Daily view: records progress (evidence: `app/js/views/daily.js`)
- App router → Daily view: routes to (evidence: `app/js/app.js`)
- App router → Task list: routes to (evidence: `app/js/app.js`)
- App router → Task detail: routes to (evidence: `app/js/app.js`)
- App router → Settings view: routes to (evidence: `app/js/app.js`)
- App router → Progress storage: reads settings (evidence: `app/js/app.js`)
- App router → UI helpers: uses helpers (evidence: `app/js/app.js`)
- Daily view → Task catalog: renders tasks (evidence: `app/js/views/daily.js`)
- Daily view → Progress storage: reads and updates (evidence: `app/js/views/daily.js`)
- Daily view → UI helpers: uses helpers (evidence: `app/js/views/daily.js`)
- Daily view → File sync: requests save (evidence: `app/js/views/daily.js`)
- Task list → Task catalog: filters tasks (evidence: `app/js/views/tasks.js`)
- Task list → Progress storage: reads ratings (evidence: `app/js/views/tasks.js`)
- Task list → UI helpers: uses helpers (evidence: `app/js/views/tasks.js`)
- Task detail → Task catalog: looks up task (evidence: `app/js/views/detail.js`)
- Task detail → SOP catalog: reads SOP (evidence: `app/js/views/detail.js`)
- Task detail → Progress storage: reads history (evidence: `app/js/views/detail.js`)
- Task detail → UI helpers: renders markdown (evidence: `app/js/views/detail.js`)
- Progress storage → Browser local storage: reads and writes (evidence: `app/js/storage.js`)
- Progress storage → Task catalog: exports task data (evidence: `app/js/storage.js`)
- Progress storage → AI note catalog: reads notes (evidence: `app/js/storage.js`)
- Settings view → Progress storage: updates settings (evidence: `app/js/views/settings.js`)
- Settings view → File sync: controls sync (evidence: `app/js/views/settings.js`)
- Settings view → App router: refreshes header (evidence: `app/js/views/settings.js`)
- File sync → Progress storage: exports entries (evidence: `app/js/sync.js`)
- File sync → Entries JSON: writes JSON (evidence: `app/js/sync.js`)
- File sync → Claude desktop: makes entries available
