# yesdisown/flowforces architecture

> Architecture diagram of the GitHub repository yesdisown/flowforces, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yesdisown/flowforces
- Repository: https://github.com/yesdisown/flowforces

## Overview

FlowForces is a browser-based Codeforces practice timer: a user connects a handle, starts a timed session, works through recommended problems, and receives a session review. The frontend loads profile and problem data from Codeforces, tracks attempts and learning state in browser storage, and presents an end-of-session summary with trends and a shareable card. The excerpts show the main session and review behavior; some wiring is inferred only from shared globals and is therefore omitted where a direct relationship is not visible.

Main entry points: [`frontend/session.js`](https://github.com/yesdisown/flowforces/blob/main/frontend/session.js) (Timed session), [`frontend/app.js`](https://github.com/yesdisown/flowforces/blob/main/frontend/app.js) (App controls), [`frontend/core.js`](https://github.com/yesdisown/flowforces/blob/main/frontend/core.js) (Profile loading), [`frontend/summary.js`](https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js) (Session review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_practice["Practice workflow"]
  node_app["App controls<br/>[app.js]"]
  node_profile["Profile loading<br/>[core.js]"]
  node_topics["Topic selection<br/>[core.js]"]
  node_session["Timed session<br/>[session.js]"]
  node_recommend["Problem selection<br/>[session.js]"]
  node_submission["Submission checks<br/>[session.js]"]
end

subgraph group_learning["Learning state"]
  node_learningstate["Rating and reviews<br/>[session.js]"]
  node_upsolve["Upsolve list<br/>[core.js]"]
end

subgraph group_review["Review and insights"]
  node_summary["Session review<br/>[summary.js]"]
  node_analytics["Performance insights<br/>[summary.js]"]
  node_sharecard["Share card<br/>[summary.js]"]
end

subgraph group_platform["Browser services"]
  node_codeforces["Codeforces API"]
  node_storage[("Browser storage")]
end

node_user(("User"))

node_user -->|"starts session"| node_app
node_app -->|"ensures handle"| node_profile
node_profile -->|"fetches profile"| node_codeforces
node_profile -->|"loads saved state"| node_storage
node_user -->|"selects topics"| node_topics
node_app -->|"starts and controls"| node_session
node_session -->|"chooses problems"| node_recommend
node_session -->|"checks submissions"| node_submission
node_submission -->|"requests status"| node_codeforces
node_session -->|"records outcomes"| node_learningstate
node_learningstate -->|"persists progress"| node_storage
node_session -->|"adds unsolved"| node_upsolve
node_user -->|"ends session"| node_summary
node_summary -->|"computes insights"| node_analytics
node_summary -->|"saves session history"| node_storage
node_user -->|"saves card"| node_sharecard

click node_app "https://github.com/yesdisown/flowforces/blob/main/frontend/app.js"
click node_profile "https://github.com/yesdisown/flowforces/blob/main/frontend/core.js"
click node_topics "https://github.com/yesdisown/flowforces/blob/main/frontend/core.js"
click node_session "https://github.com/yesdisown/flowforces/blob/main/frontend/session.js"
click node_recommend "https://github.com/yesdisown/flowforces/blob/main/frontend/session.js"
click node_submission "https://github.com/yesdisown/flowforces/blob/main/frontend/session.js"
click node_learningstate "https://github.com/yesdisown/flowforces/blob/main/frontend/session.js"
click node_upsolve "https://github.com/yesdisown/flowforces/blob/main/frontend/core.js"
click node_summary "https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js"
click node_analytics "https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js"
click node_sharecard "https://github.com/yesdisown/flowforces/blob/main/frontend/summary.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_profile,node_topics,node_session,node_recommend,node_submission,node_user toneBlue
class node_learningstate,node_upsolve toneAmber
class node_summary,node_analytics,node_sharecard toneMint
class node_codeforces,node_storage toneRose
```

## Components

### Practice workflow

- [App controls](https://github.com/yesdisown/flowforces/blob/main/frontend/app.js): `frontend/app.js`
- [Profile loading](https://github.com/yesdisown/flowforces/blob/main/frontend/core.js): `frontend/core.js`
- [Topic selection](https://github.com/yesdisown/flowforces/blob/main/frontend/core.js): `frontend/core.js`
- [Timed session](https://github.com/yesdisown/flowforces/blob/main/frontend/session.js): `frontend/session.js`
- [Problem selection](https://github.com/yesdisown/flowforces/blob/main/frontend/session.js): `frontend/session.js`
- [Submission checks](https://github.com/yesdisown/flowforces/blob/main/frontend/session.js): `frontend/session.js`

### Learning state

- [Rating and reviews](https://github.com/yesdisown/flowforces/blob/main/frontend/session.js): `frontend/session.js`
- [Upsolve list](https://github.com/yesdisown/flowforces/blob/main/frontend/core.js): `frontend/core.js`

### Review and insights

- [Session review](https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js): `frontend/summary.js`
- [Performance insights](https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js): `frontend/summary.js`
- [Share card](https://github.com/yesdisown/flowforces/blob/main/frontend/summary.js): `frontend/summary.js`

### Browser services

- **Codeforces API**
- **Browser storage**

### Other components

- **User**

## Connections

- User → App controls: starts session (evidence: `frontend/app.js`)
- App controls → Profile loading: ensures handle (evidence: `frontend/app.js`)
- Profile loading → Codeforces API: fetches profile (evidence: `frontend/core.js`)
- Profile loading → Browser storage: loads saved state (evidence: `frontend/core.js`)
- User → Topic selection: selects topics (evidence: `frontend/core.js`)
- App controls → Timed session: starts and controls (evidence: `frontend/app.js`)
- Timed session → Problem selection: chooses problems (evidence: `frontend/session.js`)
- Timed session → Submission checks: checks submissions (evidence: `frontend/session.js`)
- Submission checks → Codeforces API: requests status (evidence: `frontend/session.js`)
- Timed session → Rating and reviews: records outcomes (evidence: `frontend/session.js`)
- Rating and reviews → Browser storage: persists progress (evidence: `frontend/session.js`)
- Timed session → Upsolve list: adds unsolved (evidence: `frontend/session.js`)
- User → Session review: ends session
- Session review → Performance insights: computes insights (evidence: `frontend/summary.js`)
- Session review → Browser storage: saves session history (evidence: `frontend/summary.js`)
- User → Share card: saves card (evidence: `frontend/summary.js`)
