# priyankam319/ergonomic-assessment architecture

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

## Overview

Ergonomic Assessment Web App runs RULA and REBA posture assessments from webcam video, then presents results and downloadable reports. The principal flow is user-selected method → camera and pose landmarks → timed recording → method-specific scoring → session history and results. The README also describes coaching, analytics, risk profiles, and stretch tips; these are represented as documented capabilities, but their internal wiring is not established by the sampled excerpts. The main implementation is concentrated in app.js, so several components share that path.

Main entry points: [`app.js`](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js) (App interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assessment["Assessment"]
  node_app["App interface<br/>[app.js]"]
  node_camera["Webcam capture<br/>[app.js]"]
  node_pose["Pose landmarks<br/>[app.js]"]
  node_recording["Timed recording<br/>[app.js]"]
  node_scoring["RULA / REBA scoring<br/>[app.js]"]
  node_results["Assessment results<br/>[app.js]"]
  node_history["Session history<br/>[app.js]"]
end

subgraph group_insights["Insights"]
  node_coaching["AI coaching<br/>[app.js]"]
  node_analytics["Analytics<br/>[app.js]"]
  node_risk["Risk profile<br/>[app.js]"]
  node_stretch["Stretch tips<br/>[app.js]"]
end

subgraph group_reporting["Reporting"]
  node_report["Report generation<br/>[app.js]"]
  node_download["HTML download<br/>[app.js]"]
end

subgraph group_integrations["Integrations"]
  node_browser["Browser camera"]
  node_mediapipe["MediaPipe Pose"]
  node_openrouter["OpenRouter API"]
end

node_user(("User"))

node_user -->|"selects method"| node_app
node_app -->|"starts capture"| node_camera
node_camera -->|"requests stream"| node_browser
node_app -->|"configures pose"| node_mediapipe
node_pose -.->|"records landmarks"| node_recording
node_recording -->|"scores recording"| node_scoring
node_scoring -->|"updates results"| node_results
node_results -->|"saves session"| node_history
node_app -.->|"provides coaching"| node_coaching
node_app -.->|"shows analytics"| node_analytics
node_app -->|"shows risk profile"| node_risk
node_app -.->|"offers stretch tips"| node_stretch
node_app -->|"requests AI text"| node_openrouter
node_app -->|"generates report"| node_report
node_report -->|"builds HTML"| node_download

click node_app "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_camera "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_pose "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_recording "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_scoring "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_results "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_history "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_coaching "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_analytics "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_risk "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_stretch "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_report "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js"
click node_download "https://github.com/priyankam319/ergonomic-assessment/blob/main/app.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_camera,node_pose,node_recording,node_scoring,node_results,node_history,node_user toneBlue
class node_coaching,node_analytics,node_risk,node_stretch toneAmber
class node_report,node_download toneMint
class node_browser,node_mediapipe,node_openrouter toneRose
```

## Components

### Assessment

- [App interface](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Webcam capture](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Pose landmarks](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Timed recording](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [RULA / REBA scoring](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Assessment results](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Session history](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`

### Insights

- [AI coaching](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Analytics](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Risk profile](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [Stretch tips](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`

### Reporting

- [Report generation](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`
- [HTML download](https://github.com/priyankam319/ergonomic-assessment/blob/main/app.js): `app.js`

### Integrations

- **Browser camera**
- **MediaPipe Pose**
- **OpenRouter API**

### Other components

- **User**

## Connections

- User → App interface: selects method (evidence: `README.md`)
- App interface → Webcam capture: starts capture (evidence: `app.js`)
- Webcam capture → Browser camera: requests stream (evidence: `app.js`)
- App interface → MediaPipe Pose: configures pose (evidence: `app.js`)
- Pose landmarks → Timed recording: records landmarks (evidence: `app.js`)
- Timed recording → RULA / REBA scoring: scores recording (evidence: `app.js`)
- RULA / REBA scoring → Assessment results: updates results (evidence: `app.js`)
- Assessment results → Session history: saves session (evidence: `app.js`)
- App interface → AI coaching: provides coaching (evidence: `app.js`)
- App interface → Analytics: shows analytics (evidence: `app.js`)
- App interface → Risk profile: shows risk profile (evidence: `app.js`)
- App interface → Stretch tips: offers stretch tips (evidence: `app.js`)
- App interface → OpenRouter API: requests AI text (evidence: `app.js`)
- App interface → Report generation: generates report (evidence: `app.js`)
- Report generation → HTML download: builds HTML (evidence: `app.js`)
