# kiii28/gruptask-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/kiii28/gruptask-tracker
- Repository: https://github.com/kiii28/gruptask-tracker

## Overview

GroupTask Tracker is a static web task board backed by a Flask REST API. The main workflow is: users register and verify by OTP or sign in, create or join a project, invite collaborators, then create and update tasks on its board; project progress reflects completed tasks. The backend keeps users, projects, memberships, tasks, and sessions in process memory, so state resets on restart and is not shared across instances. The README documents the frontend/API contract and optional email and Google login; frontend implementation details were not sampled.

Main entry points: [`frontend/index.html`](https://github.com/kiii28/gruptask-tracker/blob/main/frontend/index.html) (Web interface), [`backend/app.py`](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py) (In-memory application state), [`frontend/config.js`](https://github.com/kiii28/gruptask-tracker/blob/main/frontend/config.js) (API address config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_frontend["Web interface<br/>[index.html]"]
  node_api_config["API address config<br/>[config.js]"]
end

subgraph group_identity["Identity and profile"]
  node_auth["Registration and sessions<br/>[app.py]"]
  node_profile["Profile management<br/>[app.py]"]
end

subgraph group_collab["Project collaboration"]
  node_projects["Project management<br/>[app.py]"]
  node_membership["Member search and invites<br/>[app.py]"]
  node_invitations["Invitation responses<br/>[app.py]"]
end

subgraph group_tasks["Task board"]
  node_board["Project board view<br/>[app.py]"]
  node_task_ops["Task assignment and status<br/>[app.py]"]
  node_progress["Progress calculation<br/>[app.py]"]
end

subgraph group_runtime["Runtime services"]
  node_state[("In-memory application state<br/>[app.py]")]
  node_email["SMTP email service"]
  node_google["Google sign-in"]
  node_health["Health and config endpoints<br/>[app.py]"]
end

node_person(("User"))

node_person -->|"uses"| node_frontend
node_frontend -->|"loads API address"| node_api_config
node_frontend -->|"requests auth"| node_auth
node_frontend -->|"requests profile"| node_profile
node_frontend -->|"requests projects"| node_projects
node_frontend -->|"searches and invites"| node_membership
node_frontend -->|"responds to invites"| node_invitations
node_frontend -->|"loads board"| node_board
node_frontend -->|"updates tasks"| node_task_ops
node_frontend -->|"checks service"| node_health
node_auth -->|"reads and writes"| node_state
node_profile -.->|"reads and writes"| node_state
node_projects -->|"reads and writes"| node_state
node_membership -->|"reads and writes"| node_state
node_invitations -->|"reads and writes"| node_state
node_board -->|"reads board data"| node_state
node_task_ops -.->|"reads and writes"| node_state
node_task_ops -->|"updates progress"| node_progress
node_auth -->|"sends OTP"| node_email
node_membership -->|"sends invitations"| node_email
node_frontend -.->|"offers Google sign-in"| node_google
node_auth -.->|"verifies sign-in"| node_google

click node_frontend "https://github.com/kiii28/gruptask-tracker/blob/main/frontend/index.html"
click node_api_config "https://github.com/kiii28/gruptask-tracker/blob/main/frontend/config.js"
click node_auth "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_profile "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_projects "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_membership "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_invitations "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_board "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_task_ops "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_progress "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_state "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"
click node_health "https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py"

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_frontend,node_api_config,node_person toneBlue
class node_auth,node_profile toneAmber
class node_projects,node_membership,node_invitations toneMint
class node_board,node_task_ops,node_progress toneRose
class node_state,node_email,node_google,node_health toneIndigo
```

## Components

### Web client

- [Web interface](https://github.com/kiii28/gruptask-tracker/blob/main/frontend/index.html): `frontend/index.html`
- [API address config](https://github.com/kiii28/gruptask-tracker/blob/main/frontend/config.js): `frontend/config.js`

### Identity and profile

- [Registration and sessions](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- [Profile management](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`

### Project collaboration

- [Project management](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- [Member search and invites](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- [Invitation responses](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`

### Task board

- [Project board view](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- [Task assignment and status](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- [Progress calculation](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`

### Runtime services

- [In-memory application state](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`
- **SMTP email service**
- **Google sign-in**
- [Health and config endpoints](https://github.com/kiii28/gruptask-tracker/blob/main/backend/app.py): `backend/app.py`

### Other components

- **User**

## Connections

- User → Web interface: uses (evidence: `README.md`)
- Web interface → API address config: loads API address (evidence: `README.md`)
- Web interface → Registration and sessions: requests auth (evidence: `README.md`)
- Web interface → Profile management: requests profile (evidence: `README.md`)
- Web interface → Project management: requests projects (evidence: `README.md`)
- Web interface → Member search and invites: searches and invites (evidence: `README.md`)
- Web interface → Invitation responses: responds to invites (evidence: `README.md`)
- Web interface → Project board view: loads board (evidence: `README.md`)
- Web interface → Task assignment and status: updates tasks (evidence: `README.md`)
- Web interface → Health and config endpoints: checks service (evidence: `README.md`)
- Registration and sessions → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Profile management → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Project management → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Member search and invites → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Invitation responses → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Project board view → In-memory application state: reads board data (evidence: `backend/app.py`)
- Task assignment and status → In-memory application state: reads and writes (evidence: `backend/app.py`)
- Task assignment and status → Progress calculation: updates progress (evidence: `README.md`)
- Registration and sessions → SMTP email service: sends OTP (evidence: `README.md`)
- Member search and invites → SMTP email service: sends invitations (evidence: `README.md`)
- Web interface → Google sign-in: offers Google sign-in (evidence: `README.md`)
- Registration and sessions → Google sign-in: verifies sign-in (evidence: `README.md`)
