# 1younesalloui/to-do-list architecture

> Architecture diagram of the GitHub repository 1younesalloui/to-do-list, 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/1younesalloui/to-do-list
- Repository: https://github.com/1younesalloui/to-do-list

## Overview

This is a Django productivity workspace with an Electron desktop wrapper. The principal workflow is task creation and planning through CRUD APIs, calendar and list views, with tasks persisted in SQLite; users can open task-linked documents, save content, and export it. Separate backend capabilities provide analytics and AI-assisted chat, summarization, and humanization. The README also describes a theme switcher. The sampled views and routes support the backend links; the README documents the product capabilities. The frontend templates and their API calls were not sampled, so those interactions are not asserted.

Main entry points: [`app/todo/urls.py`](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/urls.py) (App routes), [`app/todo/models.py`](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/models.py) (Task model), [`desktop-app/main.js`](https://github.com/1younesalloui/to-do-list/blob/main/desktop-app/main.js) (Electron client), [`app/templates/page.html`](https://github.com/1younesalloui/to-do-list/blob/main/app/templates/page.html) (Document editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_electron["Electron client<br/>[main.js]"]
  node_django_entry["Django process<br/>[manage.py]"]
end

subgraph group_experience["Workspace experience"]
  node_workspace_pages["Workspace pages<br/>[home.html]"]
  node_task_planner["Task planner<br/>[todo_list.html]"]
  node_calendar["Calendar planner<br/>[calendar.html]"]
  node_document_editor["Document editor<br/>[page.html]"]
  node_theme_system["Theme switcher<br/>[style.js]"]
end

subgraph group_backend["Django services"]
  node_project_routes["Project routes<br/>[urls.py]"]
  node_todo_routes["App routes<br/>[urls.py]"]
  node_task_service["Task CRUD<br/>[views.py]"]
  node_document_service["Document save<br/>[views.py]"]
  node_export_service["Document exports<br/>[views.py]"]
  node_analytics_service["Productivity analytics<br/>[views.py]"]
  node_ai_service["AI assistant<br/>[views.py]"]
end

subgraph group_storage["Persistence and integrations"]
  node_task_model["Task model<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[settings.py]")]
  node_groq["Groq API"]
end

node_user(("User"))

node_user -->|"opens"| node_electron
node_electron -->|"spawns"| node_django_entry
node_electron -->|"loads server"| node_project_routes
node_project_routes -->|"includes"| node_todo_routes
node_todo_routes -->|"routes to"| node_task_service
node_todo_routes -->|"routes to"| node_document_service
node_todo_routes -->|"routes to"| node_export_service
node_todo_routes -->|"routes to"| node_analytics_service
node_todo_routes -->|"routes to"| node_ai_service
node_todo_routes -->|"serves pages"| node_workspace_pages
node_todo_routes -->|"serves page"| node_task_planner
node_todo_routes -->|"serves page"| node_calendar
node_todo_routes -->|"serves page"| node_document_editor
node_user -.->|"plans tasks"| node_task_planner
node_user -.->|"plans dates"| node_calendar
node_user -.->|"edits content"| node_document_editor
node_task_service -->|"reads writes"| node_task_model
node_document_service -->|"saves content"| node_task_model
node_analytics_service -->|"queries tasks"| node_task_model
node_task_model -->|"persists in"| node_sqlite
node_user -->|"selects theme"| node_theme_system
node_ai_service -->|"requests completion"| node_groq
node_user -.->|"views metrics"| node_analytics_service
node_user -.->|"uses assistant"| node_ai_service
node_document_editor -.->|"exports document"| node_export_service

click node_electron "https://github.com/1younesalloui/to-do-list/blob/main/desktop-app/main.js"
click node_django_entry "https://github.com/1younesalloui/to-do-list/blob/main/app/manage.py"
click node_project_routes "https://github.com/1younesalloui/to-do-list/blob/main/app/app/urls.py"
click node_todo_routes "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/urls.py"
click node_workspace_pages "https://github.com/1younesalloui/to-do-list/blob/main/app/templates/home.html"
click node_task_planner "https://github.com/1younesalloui/to-do-list/blob/main/app/templates/to_do_list/todo_list.html"
click node_calendar "https://github.com/1younesalloui/to-do-list/blob/main/app/templates/to_do_list/calendar.html"
click node_document_editor "https://github.com/1younesalloui/to-do-list/blob/main/app/templates/page.html"
click node_theme_system "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/static/js/style.js"
click node_task_service "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py"
click node_document_service "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py"
click node_export_service "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py"
click node_analytics_service "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py"
click node_ai_service "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py"
click node_task_model "https://github.com/1younesalloui/to-do-list/blob/main/app/todo/models.py"
click node_sqlite "https://github.com/1younesalloui/to-do-list/blob/main/app/app/settings.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_electron,node_django_entry,node_user toneBlue
class node_workspace_pages,node_task_planner,node_calendar,node_document_editor,node_theme_system toneAmber
class node_project_routes,node_todo_routes,node_task_service,node_document_service,node_export_service,node_analytics_service,node_ai_service toneMint
class node_task_model,node_sqlite,node_groq toneRose
```

## Components

### Desktop shell

- [Electron client](https://github.com/1younesalloui/to-do-list/blob/main/desktop-app/main.js): `desktop-app/main.js`
- [Django process](https://github.com/1younesalloui/to-do-list/blob/main/app/manage.py): `app/manage.py`

### Workspace experience

- [Workspace pages](https://github.com/1younesalloui/to-do-list/blob/main/app/templates/home.html): `app/templates/home.html`
- [Task planner](https://github.com/1younesalloui/to-do-list/blob/main/app/templates/to_do_list/todo_list.html): `app/templates/to_do_list/todo_list.html`
- [Calendar planner](https://github.com/1younesalloui/to-do-list/blob/main/app/templates/to_do_list/calendar.html): `app/templates/to_do_list/calendar.html`
- [Document editor](https://github.com/1younesalloui/to-do-list/blob/main/app/templates/page.html): `app/templates/page.html`
- [Theme switcher](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/static/js/style.js): `app/todo/static/js/style.js`

### Django services

- [Project routes](https://github.com/1younesalloui/to-do-list/blob/main/app/app/urls.py): `app/app/urls.py`
- [App routes](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/urls.py): `app/todo/urls.py`
- [Task CRUD](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py): `app/todo/views.py`
- [Document save](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py): `app/todo/views.py`
- [Document exports](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py): `app/todo/views.py`
- [Productivity analytics](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py): `app/todo/views.py`
- [AI assistant](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/views.py): `app/todo/views.py`

### Persistence and integrations

- [Task model](https://github.com/1younesalloui/to-do-list/blob/main/app/todo/models.py): `app/todo/models.py`
- [SQLite database](https://github.com/1younesalloui/to-do-list/blob/main/app/app/settings.py): `app/app/settings.py`
- **Groq API**

### Other components

- **User**

## Connections

- User → Electron client: opens (evidence: `README.md`)
- Electron client → Django process: spawns (evidence: `desktop-app/main.js`)
- Electron client → Project routes: loads server (evidence: `desktop-app/main.js`)
- Project routes → App routes: includes (evidence: `app/app/urls.py`)
- App routes → Task CRUD: routes to (evidence: `app/todo/urls.py`)
- App routes → Document save: routes to (evidence: `app/todo/urls.py`)
- App routes → Document exports: routes to (evidence: `app/todo/urls.py`)
- App routes → Productivity analytics: routes to (evidence: `app/todo/urls.py`)
- App routes → AI assistant: routes to (evidence: `app/todo/urls.py`)
- App routes → Workspace pages: serves pages
- App routes → Task planner: serves page
- App routes → Calendar planner: serves page
- App routes → Document editor: serves page
- User → Task planner: plans tasks (evidence: `README.md`)
- User → Calendar planner: plans dates (evidence: `README.md`)
- User → Document editor: edits content (evidence: `README.md`)
- Task CRUD → Task model: reads writes (evidence: `app/todo/views.py`)
- Document save → Task model: saves content (evidence: `app/todo/views.py`)
- Productivity analytics → Task model: queries tasks (evidence: `app/todo/views.py`)
- Task model → SQLite database: persists in (evidence: `app/app/settings.py`)
- User → Theme switcher: selects theme (evidence: `app/todo/static/js/style.js`)
- AI assistant → Groq API: requests completion (evidence: `app/todo/views.py`)
- User → Productivity analytics: views metrics (evidence: `README.md`)
- User → AI assistant: uses assistant (evidence: `README.md`)
- Document editor → Document exports: exports document (evidence: `README.md`)
