# alkawty/task-manager architecture

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

- Interactive diagram: https://gitdiagram.com/alkawty/task-manager
- Repository: https://github.com/alkawty/task-manager

## Overview

This is a small Windows console task manager. The user selects an action from the menu to list, add, edit, delete, or filter completed tasks; changes are persisted to a text file. The graph separates menu dispatch, task operations, the in-memory task model, and file persistence. The excerpt shows menu dispatch and several operations calling persistence, but portions are omitted, so unshown relationships are not inferred.

Main entry points: [`Task Manager.cpp`](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp) (Main menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Console interface"]
  node_menu["Main menu<br/>[Task Manager.cpp]"]
  node_header["Header display<br/>[Task Manager.cpp]"]
end

subgraph group_tasks["Task management"]
  node_add["Add task<br/>[Task Manager.cpp]"]
  node_list["List tasks<br/>[Task Manager.cpp]"]
  node_edit["Edit task<br/>[Task Manager.cpp]"]
  node_delete["Delete task<br/>[Task Manager.cpp]"]
  node_completed["Completed filter<br/>[Task Manager.cpp]"]
  node_taskmodel["Task model<br/>[Task Manager.cpp]"]
  node_taskdata[("In-memory tasks<br/>[Task Manager.cpp]")]
end

subgraph group_persistence["Persistence"]
  node_fileio["File persistence<br/>[Task Manager.cpp]"]
  node_taskfile["tasks.txt"]
end

node_user(("User"))

node_user -->|"chooses action"| node_menu
node_menu -->|"displays"| node_header
node_menu -->|"dispatches"| node_list
node_menu -->|"dispatches"| node_add
node_menu -->|"dispatches"| node_edit
node_menu -->|"dispatches"| node_delete
node_menu -->|"dispatches"| node_completed
node_menu -->|"loads at start"| node_fileio
node_add -->|"adds task"| node_taskdata
node_add -->|"saves"| node_fileio
node_edit -->|"updates task"| node_taskdata
node_edit -->|"saves"| node_fileio
node_delete -->|"removes task"| node_taskdata
node_list -.->|"reads tasks"| node_taskdata
node_completed -->|"filters tasks"| node_taskdata
node_taskdata -.->|"holds"| node_taskmodel
node_fileio -->|"reads and writes"| node_taskfile

click node_menu "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_header "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_add "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_list "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_edit "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_delete "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_completed "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_taskmodel "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_taskdata "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"
click node_fileio "https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp"

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_menu,node_header,node_user toneBlue
class node_add,node_list,node_edit,node_delete,node_completed,node_taskmodel,node_taskdata toneAmber
class node_fileio,node_taskfile toneMint
```

## Components

### Console interface

- [Main menu](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [Header display](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`

### Task management

- [Add task](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [List tasks](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [Edit task](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [Delete task](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [Completed filter](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [Task model](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- [In-memory tasks](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`

### Persistence

- [File persistence](https://github.com/alkawty/task-manager/blob/main/Task%20Manager.cpp): `Task Manager.cpp`
- **tasks.txt**

### Other components

- **User**

## Connections

- User → Main menu: chooses action (evidence: `Task Manager.cpp`)
- Main menu → Header display: displays (evidence: `Task Manager.cpp`)
- Main menu → List tasks: dispatches (evidence: `Task Manager.cpp`)
- Main menu → Add task: dispatches (evidence: `Task Manager.cpp`)
- Main menu → Edit task: dispatches (evidence: `Task Manager.cpp`)
- Main menu → Delete task: dispatches (evidence: `Task Manager.cpp`)
- Main menu → Completed filter: dispatches (evidence: `Task Manager.cpp`)
- Main menu → File persistence: loads at start (evidence: `Task Manager.cpp`)
- Add task → In-memory tasks: adds task (evidence: `Task Manager.cpp`)
- Add task → File persistence: saves (evidence: `Task Manager.cpp`)
- Edit task → In-memory tasks: updates task (evidence: `Task Manager.cpp`)
- Edit task → File persistence: saves (evidence: `Task Manager.cpp`)
- Delete task → In-memory tasks: removes task (evidence: `Task Manager.cpp`)
- List tasks → In-memory tasks: reads tasks (evidence: `Task Manager.cpp`)
- Completed filter → In-memory tasks: filters tasks (evidence: `Task Manager.cpp`)
- In-memory tasks → Task model: holds (evidence: `Task Manager.cpp`)
- File persistence → tasks.txt: reads and writes (evidence: `Task Manager.cpp`)
