# kirakrabu/todolist architecture

> Architecture diagram of the GitHub repository kirakrabu/todolist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kirakrabu/todolist
- Repository: https://github.com/kirakrabu/todolist

## Overview

##### Project type and purpose
- This is a desktop application written in C# using Windows Forms.
- Purpose: A “Daily Planner” with a splash screen (Form2) and a planner interface (Form1).
- There is also a console-based reference implementation in C++ (ToDoListCpp), but the primary deliverable is the WinForms app (To Do List.exe).

##### File structure
- Top-level files:
- Form2.Designer.cs / Form2.cs – splash screen UI and logic
- Form1.Designer.cs / Form1.cs – main planner UI and event handlers
- README.md – project description & UI behavior
- To Do List.exe – compiled WinForms executable
- ToDoListCpp – legacy/reference console code
- No external database config – storage is likely file-based (e.g., XML/JSON/serialization).

##### README for additional insights
- Workflow: Splash → “Начать планировать” → Main planner.
- Main form features:
- Task text field
- Notes text field
- Deadline date picker
- Save, Delete, Edit, Exit buttons
- Data grid/table showing saved tasks

##### Elements
- Clear labels:
- “SplashForm (Form2)”
- “PlannerForm (Form1)”
- “BusinessLogic (Form1.cs event handlers)”
- “Local File Store (tasks.json/xml)”
- “Legacy: ToDoListCpp” (optional)
- UI → BusinessLogic (on button clicks)
- BusinessLogic → File Store (read/write)
- File Store → UI (on startup/load)
- Green for persistence

## Diagram (Mermaid)

```mermaid
flowchart TB
  subgraph "UI Layer"
    SplashForm["SplashForm (Form2)"]:::ui
    subgraph "PlannerForm (Form1)"
      IF["InputFields\n(TextBoxes)"]:::ui
      DP["DatePicker\n(DateTimePicker)"]:::ui
      DG["DataGridView\n(DataGridView)"]:::ui
      BP["ButtonPanel\n(Buttons)"]:::ui
    end
  end

  BusinessLogic["BusinessLogic\n(Form1.cs handlers)"]:::logic
  Persistence["Local File Store\n(tasks.json/xml)"]:::persistence

  subgraph "Artifacts"
    README["README.md"]:::doc
    Executable["To Do List.exe"]:::exec
    Legacy["Legacy: ToDoListCpp"]:::legacy
  end

  SplashForm -->|"Начать планировать"| IF
  IF -->|"User actions"| BusinessLogic
  BP -->|"Button clicks\n(Save/Delete/Edit/Exit)"| BusinessLogic
  BusinessLogic -->|"Read/Write tasks"| Persistence
  Persistence -->|"LoadTasks result"| IF

  click SplashForm "https://github.com/kirakrabu/todolist/blob/main/Form2.Designer.cs"
  click SplashForm "https://github.com/kirakrabu/todolist/blob/main/Form2.cs"
  click IF "https://github.com/kirakrabu/todolist/blob/main/Form1.Designer.cs"
  click BusinessLogic "https://github.com/kirakrabu/todolist/blob/main/Form1.cs"
  click README "https://github.com/kirakrabu/todolist/blob/main/README.md"
  click Executable "https://github.com/kirakrabu/todolist/blob/main/To Do List.exe"
  click Legacy "https://github.com/kirakrabu/todolist/tree/main/ToDoListCpp"

  classDef ui fill:#cce5ff,stroke:#004085
  classDef logic fill:#fff3cd,stroke:#856404
  classDef persistence fill:#d4edda,stroke:#155724
  classDef doc fill:#e2e3e5,stroke:#6c757d
  classDef exec fill:#d1ecf1,stroke:#0c5460
  classDef legacy fill:#e2e3e5,stroke:#6c757d,stroke-dasharray: 5 5
```
