# esade-swdev-2026/task-manager architecture

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

- Interactive diagram: https://gitdiagram.com/esade-swdev-2026/task-manager
- Repository: https://github.com/esade-swdev-2026/task-manager

## Overview

Task Manager is a terminal application for maintaining personal tasks in a selectable CSV file. Users invoke commands to create, inspect, search, edit, complete, reopen, or delete tasks; read-only views include today, due-soon, calendar, and summary. The CLI coordinates task operations, persistence, and presentation. Task rules and validation form the internal domain layer. The README documents the major user-facing capabilities; unsampled command implementations are represented at their known module path, without assuming unshown call details.

Main entry points: [`src/task_manager/cli.py`](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py) (Command dispatcher), [`src/task_manager/tasks.py`](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/tasks.py) (Task operations), [`src/task_manager/models.py`](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/models.py) (Task model), [`src/task_manager/edit_tasks.py`](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/edit_tasks.py) (Task editing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["CLI interface"]
  node_cli["Command dispatcher<br/>[cli.py]"]
  node_listing["List and search<br/>[cli.py]"]
  node_lifecycle["Task lifecycle<br/>[cli.py]"]
  node_today_view["Today and upcoming<br/>[cli.py]"]
  node_calendar_view["Calendar view<br/>[cli.py]"]
  node_summary_view["Task summary<br/>[cli.py]"]
  node_weekly_view["Weekly review<br/>[cli.py]"]
end

subgraph group_domain["Task domain"]
  node_task_model["Task model<br/>[models.py]"]
  node_validation["Input validation<br/>[validation.py]"]
  node_task_rules["Task operations<br/>[tasks.py]"]
  node_editing["Task editing<br/>[edit_tasks.py]"]
  node_recurrence["Recurring tasks<br/>[tasks.py]"]
end

subgraph group_persistence["CSV persistence"]
  node_csv_store[("CSV task store<br/>[storage.py]")]
end

subgraph group_views["Task views"]
  node_rendering["Text formatting<br/>[formatting.py]"]
end

node_user(("Terminal user"))

node_user -->|"runs commands"| node_cli
node_cli -->|"loads and saves"| node_csv_store
node_cli -->|"invokes operations"| node_task_rules
node_cli -->|"invokes edits"| node_editing
node_cli -->|"formats output"| node_rendering
node_csv_store -->|"reads and writes"| node_task_model
node_csv_store -->|"creates tasks"| node_task_rules
node_task_rules -->|"normalizes input"| node_validation
node_task_rules -->|"builds task"| node_task_model
node_validation -->|"raises domain errors"| node_task_model
node_editing -->|"creates edited task"| node_task_rules
node_editing -->|"updates task"| node_task_model
node_cli -->|"handles list and search"| node_listing
node_cli -->|"handles task changes"| node_lifecycle
node_cli -->|"supports repeats"| node_recurrence
node_cli -->|"selects due tasks"| node_today_view
node_cli -->|"renders monthly view"| node_calendar_view
node_cli -->|"reports statistics"| node_summary_view
node_cli -->|"shows weekly review"| node_weekly_view
node_rendering -->|"checks overdue status"| node_task_rules

click node_cli "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_task_model "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/models.py"
click node_validation "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/validation.py"
click node_task_rules "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/tasks.py"
click node_editing "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/edit_tasks.py"
click node_csv_store "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/storage.py"
click node_listing "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_lifecycle "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_recurrence "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/tasks.py"
click node_today_view "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_calendar_view "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_summary_view "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_weekly_view "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py"
click node_rendering "https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/formatting.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_cli,node_listing,node_lifecycle,node_today_view,node_calendar_view,node_summary_view,node_weekly_view,node_user toneBlue
class node_task_model,node_validation,node_task_rules,node_editing,node_recurrence toneAmber
class node_csv_store toneMint
class node_rendering toneRose
```

## Components

### CLI interface

- [Command dispatcher](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [List and search](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [Task lifecycle](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [Today and upcoming](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [Calendar view](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [Task summary](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`
- [Weekly review](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/cli.py): `src/task_manager/cli.py`

### Task domain

- [Task model](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/models.py): `src/task_manager/models.py`
- [Input validation](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/validation.py): `src/task_manager/validation.py`
- [Task operations](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/tasks.py): `src/task_manager/tasks.py`
- [Task editing](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/edit_tasks.py): `src/task_manager/edit_tasks.py`
- [Recurring tasks](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/tasks.py): `src/task_manager/tasks.py`

### CSV persistence

- [CSV task store](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/storage.py): `src/task_manager/storage.py`

### Task views

- [Text formatting](https://github.com/esade-swdev-2026/task-manager/blob/main/src/task_manager/formatting.py): `src/task_manager/formatting.py`

### Other components

- **Terminal user**

## Connections

- Terminal user → Command dispatcher: runs commands (evidence: `README.md`)
- Command dispatcher → CSV task store: loads and saves (evidence: `src/task_manager/cli.py`)
- Command dispatcher → Task operations: invokes operations (evidence: `src/task_manager/cli.py`)
- Command dispatcher → Task editing: invokes edits (evidence: `src/task_manager/cli.py`)
- Command dispatcher → Text formatting: formats output (evidence: `src/task_manager/cli.py`)
- CSV task store → Task model: reads and writes (evidence: `src/task_manager/storage.py`)
- CSV task store → Task operations: creates tasks (evidence: `src/task_manager/storage.py`)
- Task operations → Input validation: normalizes input (evidence: `src/task_manager/tasks.py`)
- Task operations → Task model: builds task (evidence: `src/task_manager/tasks.py`)
- Input validation → Task model: raises domain errors (evidence: `src/task_manager/validation.py`)
- Task editing → Task operations: creates edited task (evidence: `src/task_manager/edit_tasks.py`)
- Task editing → Task model: updates task (evidence: `src/task_manager/edit_tasks.py`)
- Command dispatcher → List and search: handles list and search (evidence: `README.md`)
- Command dispatcher → Task lifecycle: handles task changes (evidence: `README.md`)
- Command dispatcher → Recurring tasks: supports repeats (evidence: `README.md`)
- Command dispatcher → Today and upcoming: selects due tasks (evidence: `README.md`)
- Command dispatcher → Calendar view: renders monthly view (evidence: `README.md`)
- Command dispatcher → Task summary: reports statistics (evidence: `README.md`)
- Command dispatcher → Weekly review: shows weekly review (evidence: `src/task_manager/cli.py`)
- Text formatting → Task operations: checks overdue status (evidence: `src/task_manager/formatting.py`)
