# inflammationp/wbs-gantt architecture

> Architecture diagram of the GitHub repository inflammationp/wbs-gantt, 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/inflammationp/wbs-gantt
- Repository: https://github.com/inflammationp/wbs-gantt

## Overview

WBS-gantt is a desktop-oriented personal task manager organized around managing work by task and by date. Users navigate among a Gantt board, Today, Calendar, Logs, Management, and Settings; task schedules, progress, and strict-task logs are held in shared state and persisted locally. The README also describes temporary chores, habits, heatmaps, task status and pause handling, and reminders. The graph reflects documented capabilities and indexed module references; unsampled implementations are represented only at the directory or subsystem level.

Main entry points: [`src/App.tsx`](https://github.com/inflammationp/wbs-gantt/blob/main/src/App.tsx) (Application shell), [`src/store/useStore.ts`](https://github.com/inflammationp/wbs-gantt/blob/main/src/store/useStore.ts) (Shared app state), [`src/pages/GanttPage.tsx`](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/GanttPage.tsx) (Gantt board), [`src/pages/TodayPage.tsx`](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/TodayPage.tsx) (Today board)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["Application shell<br/>[App.tsx]"]
  node_gantt["Gantt board<br/>[GanttPage.tsx]"]
  node_today["Today board<br/>[TodayPage.tsx]"]
  node_calendar["Calendar<br/>[CalendarPage.tsx]"]
  node_logs["Logs workspace<br/>[LogsPage.tsx]"]
  node_management["Management<br/>[ManagePage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
  node_task_panels["Task and day panels"]
  node_gantt_chart["Gantt rendering<br/>[GanttChart.tsx]"]
  node_day_board["Daily routines<br/>[DayBoard.tsx]"]
  node_heatmap["Completion heatmap"]
end

subgraph group_domain["Planning domain"]
  node_task_domain["Task tree and status<br/>[tree.ts]"]
  node_day_tasks["Daily task obligations<br/>[dayTasks.ts]"]
  node_progress["Progress calculations<br/>[progress.ts]"]
  node_log_domain["Logs and notes<br/>[logs.ts]"]
  node_routines["Habits and chores<br/>[habits.ts]"]
  node_date_utils["Date calculations<br/>[dates.ts]"]
end

subgraph group_state["State and persistence"]
  node_store[("Shared app state<br/>[useStore.ts]")]
  node_storage[("Local data storage<br/>[storage.ts]")]
end

subgraph group_services["App services"]
  node_reminders["Reminder service<br/>[reminder.ts]"]
  node_updater["Update service<br/>[updater.ts]"]
  node_i18n["Language support<br/>[i18n.ts]"]
end

node_user(("Personal user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_gantt
node_app -->|"routes to"| node_today
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_logs
node_app -->|"routes to"| node_management
node_app -->|"routes to"| node_settings
node_app -->|"shows"| node_task_panels
node_gantt -->|"renders"| node_gantt_chart
node_gantt -->|"reads state"| node_store
node_today -->|"reads state"| node_store
node_today -->|"uses"| node_day_board
node_calendar -.->|"reads state"| node_store
node_logs -->|"reads state"| node_store
node_logs -->|"uses"| node_log_domain
node_management -->|"reads state"| node_store
node_management -->|"renders"| node_heatmap
node_store -->|"persists data"| node_storage
node_storage -->|"normalizes logs"| node_log_domain
node_day_board -->|"uses"| node_day_tasks
node_day_board -->|"uses"| node_routines
node_day_tasks -->|"derives status"| node_task_domain
node_day_tasks -->|"calculates progress"| node_progress
node_task_domain -->|"calculates progress"| node_progress
node_routines -->|"uses dates"| node_date_utils
node_store -->|"configures"| node_reminders
node_store -->|"checks updates"| node_updater
node_app -->|"translates UI"| node_i18n
node_gantt -->|"uses hierarchy"| node_task_domain

click node_app "https://github.com/inflammationp/wbs-gantt/blob/main/src/App.tsx"
click node_gantt "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/GanttPage.tsx"
click node_today "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/TodayPage.tsx"
click node_calendar "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/CalendarPage.tsx"
click node_logs "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/LogsPage.tsx"
click node_management "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/ManagePage.tsx"
click node_settings "https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/SettingsPage.tsx"
click node_task_panels "https://github.com/inflammationp/wbs-gantt/blob/main/src/components/TaskDetailPanel.tsx"
click node_gantt_chart "https://github.com/inflammationp/wbs-gantt/blob/main/src/components/gantt/GanttChart.tsx"
click node_day_board "https://github.com/inflammationp/wbs-gantt/blob/main/src/components/DayBoard.tsx"
click node_heatmap "https://github.com/inflammationp/wbs-gantt/blob/main/src/components/CompletionHeatmap.tsx"
click node_store "https://github.com/inflammationp/wbs-gantt/blob/main/src/store/useStore.ts"
click node_storage "https://github.com/inflammationp/wbs-gantt/blob/main/src/store/storage.ts"
click node_task_domain "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/tree.ts"
click node_day_tasks "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/dayTasks.ts"
click node_progress "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/progress.ts"
click node_log_domain "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/logs.ts"
click node_routines "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/habits.ts"
click node_date_utils "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/dates.ts"
click node_reminders "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/reminder.ts"
click node_updater "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/updater.ts"
click node_i18n "https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/i18n.ts"

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_gantt,node_today,node_calendar,node_logs,node_management,node_settings,node_task_panels,node_gantt_chart,node_day_board,node_heatmap,node_user toneBlue
class node_task_domain,node_day_tasks,node_progress,node_log_domain,node_routines,node_date_utils toneAmber
class node_store,node_storage toneMint
class node_reminders,node_updater,node_i18n toneRose
```

## Components

### User experience

- [Application shell](https://github.com/inflammationp/wbs-gantt/blob/main/src/App.tsx): `src/App.tsx`
- [Gantt board](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/GanttPage.tsx): `src/pages/GanttPage.tsx`
- [Today board](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/TodayPage.tsx): `src/pages/TodayPage.tsx`
- [Calendar](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/CalendarPage.tsx): `src/pages/CalendarPage.tsx`
- [Logs workspace](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/LogsPage.tsx): `src/pages/LogsPage.tsx`
- [Management](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/ManagePage.tsx): `src/pages/ManagePage.tsx`
- [Settings](https://github.com/inflammationp/wbs-gantt/blob/main/src/pages/SettingsPage.tsx): `src/pages/SettingsPage.tsx`
- [Task and day panels](https://github.com/inflammationp/wbs-gantt/blob/main/src/components/TaskDetailPanel.tsx): `src/components/TaskDetailPanel.tsx`
- [Gantt rendering](https://github.com/inflammationp/wbs-gantt/blob/main/src/components/gantt/GanttChart.tsx): `src/components/gantt/GanttChart.tsx`
- [Daily routines](https://github.com/inflammationp/wbs-gantt/blob/main/src/components/DayBoard.tsx): `src/components/DayBoard.tsx`
- [Completion heatmap](https://github.com/inflammationp/wbs-gantt/blob/main/src/components/CompletionHeatmap.tsx): `src/components/CompletionHeatmap.tsx`

### Planning domain

- [Task tree and status](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/tree.ts): `src/lib/tree.ts`
- [Daily task obligations](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/dayTasks.ts): `src/lib/dayTasks.ts`
- [Progress calculations](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/progress.ts): `src/lib/progress.ts`
- [Logs and notes](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/logs.ts): `src/lib/logs.ts`
- [Habits and chores](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/habits.ts): `src/lib/habits.ts`
- [Date calculations](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/dates.ts): `src/lib/dates.ts`

### State and persistence

- [Shared app state](https://github.com/inflammationp/wbs-gantt/blob/main/src/store/useStore.ts): `src/store/useStore.ts`
- [Local data storage](https://github.com/inflammationp/wbs-gantt/blob/main/src/store/storage.ts): `src/store/storage.ts`

### App services

- [Reminder service](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/reminder.ts): `src/lib/reminder.ts`
- [Update service](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/updater.ts): `src/lib/updater.ts`
- [Language support](https://github.com/inflammationp/wbs-gantt/blob/main/src/lib/i18n.ts): `src/lib/i18n.ts`

### Other components

- **Personal user**

## Connections

- Personal user → Application shell: uses
- Application shell → Gantt board: routes to (evidence: `src/App.tsx`)
- Application shell → Today board: routes to (evidence: `src/App.tsx`)
- Application shell → Calendar: routes to (evidence: `src/App.tsx`)
- Application shell → Logs workspace: routes to (evidence: `src/App.tsx`)
- Application shell → Management: routes to (evidence: `src/App.tsx`)
- Application shell → Settings: routes to (evidence: `src/App.tsx`)
- Application shell → Task and day panels: shows (evidence: `src/App.tsx`)
- Gantt board → Gantt rendering: renders (evidence: `src/pages/GanttPage.tsx`)
- Gantt board → Shared app state: reads state (evidence: `src/pages/GanttPage.tsx`)
- Today board → Shared app state: reads state
- Today board → Daily routines: uses (evidence: `src/components/DayBoard.tsx`)
- Calendar → Shared app state: reads state
- Logs workspace → Shared app state: reads state (evidence: `src/pages/LogsPage.tsx`)
- Logs workspace → Logs and notes: uses (evidence: `src/pages/LogsPage.tsx`)
- Management → Shared app state: reads state (evidence: `src/pages/ManagePage.tsx`)
- Management → Completion heatmap: renders (evidence: `src/pages/ManagePage.tsx`)
- Shared app state → Local data storage: persists data (evidence: `src/store/useStore.ts`)
- Local data storage → Logs and notes: normalizes logs (evidence: `src/store/storage.ts`)
- Daily routines → Daily task obligations: uses (evidence: `src/components/DayBoard.tsx`)
- Daily routines → Habits and chores: uses (evidence: `src/components/DayBoard.tsx`)
- Daily task obligations → Task tree and status: derives status (evidence: `src/lib/dayTasks.ts`)
- Daily task obligations → Progress calculations: calculates progress (evidence: `src/lib/dayTasks.ts`)
- Task tree and status → Progress calculations: calculates progress (evidence: `src/lib/tree.ts`)
- Habits and chores → Date calculations: uses dates (evidence: `src/lib/habits.ts`)
- Shared app state → Reminder service: configures (evidence: `src/store/useStore.ts`)
- Shared app state → Update service: checks updates (evidence: `src/store/useStore.ts`)
- Application shell → Language support: translates UI (evidence: `src/App.tsx`)
- Gantt board → Task tree and status: uses hierarchy (evidence: `src/pages/GanttPage.tsx`)
