# di0g0pimenta/todo-app-electron architecture

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

- Interactive diagram: https://gitdiagram.com/di0g0pimenta/todo-app-electron
- Repository: https://github.com/di0g0pimenta/todo-app-electron

## Overview

ToDo Calendar Electron is a local-first desktop task manager. Users create, edit, complete, delete, search, and view tasks by date through the Angular interface; task operations cross a restricted preload/IPC bridge to SQLite. The app also provides calendar navigation and native reminders. The graph preserves these documented capabilities, but some links rely on README architecture statements because IPC, preload, and task-list implementation details were not excerpted.

Main entry points: [`src/app/app.component.ts`](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/app.component.ts) (Task dashboard), [`electron/database.js`](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/database.js) (Task persistence), [`electron/main.js`](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/main.js) (Electron main), [`electron/notifications.js`](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/notifications.js) (Reminder scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Task interface"]
  node_app["Task dashboard<br/>[app.component.ts]"]
  node_calendar["Calendar view"]
  node_tasklist["Task list"]
  node_modal["Task editor"]
  node_dateutils["Date utilities<br/>[date-utils.ts]"]
  node_uivalidation["Input validation<br/>[todo-validation.ts]"]
  node_model["Task model<br/>[todo.ts]"]
  node_service["Todo service<br/>[todo.service.ts]"]
end

subgraph group_bridge["Secure IPC"]
  node_preload["Preload bridge<br/>[preload.js]"]
  node_ipc["IPC handlers<br/>[ipc.js]"]
  node_main["Electron main<br/>[main.js]"]
end

subgraph group_storage["Local persistence"]
  node_database["Task persistence<br/>[database.js]"]
  node_sqlite[("SQLite database")]
  node_dbvalidation["Storage validation<br/>[todo-validation.js]"]
end

subgraph group_reminders["Reminder delivery"]
  node_notification["Reminder scheduler<br/>[notifications.js]"]
  node_osnotifications["Native notifications"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_calendar
node_app -->|"renders"| node_tasklist
node_app -->|"renders"| node_modal
node_calendar -->|"uses dates"| node_dateutils
node_modal -->|"validates input"| node_uivalidation
node_app -->|"manages tasks"| node_service
node_service -->|"calls API"| node_preload
node_preload -->|"invokes channels"| node_ipc
node_main -->|"registers handlers"| node_ipc
node_ipc -->|"dispatches operations"| node_database
node_main -->|"initializes"| node_database
node_database -->|"reads and writes"| node_sqlite
node_database -->|"normalizes tasks"| node_dbvalidation
node_main -->|"starts scheduler"| node_notification
node_notification -->|"reads tasks"| node_database
node_notification -->|"shows reminders"| node_osnotifications

click node_app "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/app.component.ts"
click node_calendar "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/calendar/calendar.component.ts"
click node_tasklist "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/task-list/task-list.component.ts"
click node_modal "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/task-modal/task-modal.component.ts"
click node_dateutils "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/utils/date-utils.ts"
click node_uivalidation "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/utils/todo-validation.ts"
click node_model "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/models/todo.ts"
click node_service "https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/services/todo.service.ts"
click node_preload "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/preload.js"
click node_ipc "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/ipc.js"
click node_main "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/main.js"
click node_database "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/database.js"
click node_sqlite "https://github.com/di0g0pimenta/todo-app-electron/tree/main/data"
click node_dbvalidation "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/shared/todo-validation.js"
click node_notification "https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/notifications.js"

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_calendar,node_tasklist,node_modal,node_dateutils,node_uivalidation,node_model,node_service,node_user toneBlue
class node_preload,node_ipc,node_main toneAmber
class node_database,node_sqlite,node_dbvalidation toneMint
class node_notification,node_osnotifications toneRose
```

## Components

### Task interface

- [Task dashboard](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/app.component.ts): `src/app/app.component.ts`
- [Calendar view](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/calendar/calendar.component.ts): `src/app/components/calendar/calendar.component.ts`
- [Task list](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/task-list/task-list.component.ts): `src/app/components/task-list/task-list.component.ts`
- [Task editor](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/components/task-modal/task-modal.component.ts): `src/app/components/task-modal/task-modal.component.ts`
- [Date utilities](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/utils/date-utils.ts): `src/app/utils/date-utils.ts`
- [Input validation](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/utils/todo-validation.ts): `src/app/utils/todo-validation.ts`
- [Task model](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/models/todo.ts): `src/app/models/todo.ts`
- [Todo service](https://github.com/di0g0pimenta/todo-app-electron/blob/main/src/app/services/todo.service.ts): `src/app/services/todo.service.ts`

### Secure IPC

- [Preload bridge](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/preload.js): `electron/preload.js`
- [IPC handlers](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/ipc.js): `electron/ipc.js`
- [Electron main](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/main.js): `electron/main.js`

### Local persistence

- [Task persistence](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/database.js): `electron/database.js`
- [SQLite database](https://github.com/di0g0pimenta/todo-app-electron/tree/main/data): `data`
- [Storage validation](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/shared/todo-validation.js): `electron/shared/todo-validation.js`

### Reminder delivery

- [Reminder scheduler](https://github.com/di0g0pimenta/todo-app-electron/blob/main/electron/notifications.js): `electron/notifications.js`
- **Native notifications**

### Other components

- **User**

## Connections

- User → Task dashboard: uses (evidence: `README.md`)
- Task dashboard → Calendar view: renders (evidence: `src/app/app.component.ts`)
- Task dashboard → Task list: renders (evidence: `src/app/app.component.ts`)
- Task dashboard → Task editor: renders (evidence: `src/app/app.component.ts`)
- Calendar view → Date utilities: uses dates (evidence: `src/app/components/calendar/calendar.component.ts`)
- Task editor → Input validation: validates input (evidence: `src/app/components/task-modal/task-modal.component.ts`)
- Task dashboard → Todo service: manages tasks (evidence: `src/app/app.component.ts`)
- Todo service → Preload bridge: calls API (evidence: `README.md`)
- Preload bridge → IPC handlers: invokes channels (evidence: `README.md`)
- Electron main → IPC handlers: registers handlers (evidence: `electron/main.js`)
- IPC handlers → Task persistence: dispatches operations (evidence: `electron/ipc.js`)
- Electron main → Task persistence: initializes (evidence: `electron/main.js`)
- Task persistence → SQLite database: reads and writes (evidence: `electron/database.js`)
- Task persistence → Storage validation: normalizes tasks (evidence: `electron/database.js`)
- Electron main → Reminder scheduler: starts scheduler (evidence: `electron/main.js`)
- Reminder scheduler → Task persistence: reads tasks (evidence: `electron/notifications.js`)
- Reminder scheduler → Native notifications: shows reminders (evidence: `electron/notifications.js`)
