Merge pull request #5 from parvathyabnair/new-translations

[EDITED] Release v1.3.1 documentation updates

Author: suraj-yadav0

docs/user/user-manual/dashboard.md

@@ -31,10 +31,27 @@ Located at the top of the screen.
 
 ### Features:
 * **Menu Icon:** Opens the side navigation menu.
-* **Account Name:** Displays the active user account.
+* **Account Name / Title:** Displays "Dashboard" and the currently active date range filter (e.g., "This Month").
+* **Filter Icon (Sliders):** Opens the Date Range filter dropdown to adjust the time period of the displayed data.
 * **Add Icon (Clock with +):** Used to quickly create a new timesheet entry.
-* **Notification Icon :** Displays alerts and updates.
-* **Info Icon:** Provides additional information about dashboard chart guide.
+* **Notification Icon:** Displays alerts and updates.
+* **Info Icon:** Provides additional information about the dashboard chart guid
+
+---
+
+## Date Range Filter
+A new filtering feature allows users to control the time period for the data displayed across the entire dashboard. 
+
+* **Default View:** By default, the dashboard displays data for **This Month**.
+* **Filter Options:** Clicking the Filter Icon in the header opens a "Date Range" dropdown menu with the following predefined options:
+    * No Filter (All Time)
+    * Today
+    * This Week
+    * This Month
+    * This Quarter
+    * This Year
+    * Custom Range...
+* **Custom Date Range:** Selecting "Custom Range..." opens a dedicated dialog box. Users can specify an exact time period by selecting a **From:** date and a **To:** date using the date pickers. Clicking **Apply Range** updates the dashboard to reflect this custom period, while clicking **Cancel** dismisses the dialog without making changes.
 
 ---
 
@@ -55,7 +72,7 @@ The Priority Matrix categorizes tasks based on urgency and importance. It is org
 * **Don’t Do (Not Urgent & Not Important):** Tasks that are unnecessary (Grey tile).
 
 ### Time Display:
-Each category displays total time spent (e.g., `0H`), helping users evaluate productivity and time allocation.
+Each category displays total time spent (e.g., `98H`), helping users evaluate productivity and time allocation for the selected date range.
 
 ---
 

i18n/nl/docusaurus-plugin-content-docs/current/user/user-manual/dashboard.md

@@ -1,97 +1,54 @@
 ---
-title: Dashboard
-sidebar_label: Dashboard
-description: Een overzicht van het Time Management App Dashboard, met de Prioriteitenmatrix, tijdsverdelingsgrafieken en snelle navigatie voor projecten en taken.
+title: Technische referentie dashboardmodule
+sidebar_label: Dashboardmodule
 ---
 
-# Dashboard
+# Technische referentie dashboardmodule
 
-## Introductie
-Het **Dashboard** is het hoofdscherm van de Time Management-applicatie. Het biedt een snel overzicht van taken, projecten en tijdsverdeling op basis van prioriteit.
+De Dashboard Module biedt geconsolideerde, op zoekopdrachten gebaseerde analytische inzichten met betrekking tot productiviteit, geregistreerde werkuren, actieve taken en prioriteringsstatistieken.
 
-Dit scherm stelt gebruikers in staat om:
-* Taken te identificeren die onmiddellijke aandacht vereisen.
-* Werk efficiënt te organiseren.
-* De bestede tijd aan activiteiten en projecten te monitoren.
+## Codebase-kaart
 
----
-
-## Dashboard Overzicht
-Het Dashboard bestaat uit de volgende hoofdsecties:
-1. Kopsectie (Bovenste Balk)
-2. Melding Ongeslagen Concepten (Unsaved Drafts)
-3. Prioriteitenmatrix
-4. Navigatietabbladen (Overzicht, Projecten, Taken)
-5. Snelle Actieknop
-
----
-
-## Kopsectie
-Bevindt zich bovenaan het scherm.
-
-### Kenmerken:
-* **Menu-icoon :** Opent het zijnavigatiemenu.
-* **Accountnaam:** Toont het actieve gebruikersaccount.
-* **Toevoegen-icoon (Klok met +):** Wordt gebruikt om snel een nieuwe urenstaat-invoer (timesheet entry) aan te maken.
-* **Meldingen-icoon :** Toont waarschuwingen en updates.
-* **Info-icoon :** Biedt aanvullende informatie over de dashboardgrafiekengids.
-
----
-
-## Melding Ongeslagen Concepten
-Bij het starten van de app kan een pop-up **Ongeslagen Concepten Gevonden** verschijnen als er niet-ingediend werk is.
-* Stelt de gebruiker op de hoogte van niet-ingediend werk uit een vorige sessie (bijv. Urenstaten, Projectupdates).
-* Spoort de gebruiker aan om de betreffende formulieren te openen om hun wijzigingen te herstellen.
-
----
-
-## Prioriteitenmatrix
-De Prioriteitenmatrix categoriseert taken op basis van urgentie en belangrijkheid. Het is visueel georganiseerd met **URGENT** (Dringend) en **NOT URGENT** (Niet Dringend) op de bovenste as, en **IMPORTANT** (Belangrijk) en **NOT IMPORTANT** (Niet Belangrijk) op de zij-as.
-
-### Categorieën:
-* **Eerst Doen (Dringend & Belangrijk):** Taken die onmiddellijke aandacht vereisen (Rode tegel).
-* **Vervolgens Doen (Niet Dringend & Belangrijk):** Belangrijke taken die kunnen worden ingepland (Blauwe tegel).
-* **Later Doen (Dringend & Niet Belangrijk):** Taken die kunnen worden uitgesteld of gedelegeerd (Groene tegel).
-* **Niet Doen (Niet Dringend & Niet Belangrijk):** Taken die onnodig zijn (Grijze tegel).
-
-### Tijdweergave:
-Elke categorie toont de totale bestede tijd (bijv. `0H`), wat gebruikers helpt bij het evalueren van productiviteit en tijdsbesteding.
-
----
+| Laag | Pad | Doel |
+|---|---|---|
+| **Frontend-UI** | `qml/features/dashboard/` | Analysepanelen, grafieken en prioriteitswidgets |
+| **State & Logica** | `models/Main.js` | Projecties, aggregaties en diagrambindingen voor databasequery's |
 
-## Navigatietabbladen
-Onder de Prioriteitenmatrix is het dashboard verdeeld in drie primaire tabbladen: **Overzicht**, **Projecten** en **Taken**.
+## Metrieken en SQL-projecties
 
-### 1. Tabblad Overzicht
-Toont visuele grafieken voor urenregistratie.
-* **Meest Tijdrovende Projecten (Donutgrafiek):** Visuele weergave van de tijdsverdeling over projecten. Grotere segmenten duiden op een hoger tijdsgebruik.
-* **Percentagewaarde:** Het exacte aandeel van de totale geregistreerde tijd dat aan dit specifieke project is toegewezen (bijv. "51,8%").
-### 2. Tabblad Projecten
-Toont gedetailleerde informatie over gebruikersprojecten, samen met een hoofdtotaal van de gelogde uren over alle projecten.
-* **Bestede Tijd per Project (Staafdiagram):** Toont de bestede tijd per project. De assen maken een visuele vergelijking van de inspanning over projecten mogelijk. Bevat **"Toon volgende 10"** en **"Toon minder"** knoppen zijn onderaan beschikbaar om de projectenlijst uit te breiden.
+Het dashboard geeft visuele statistieken weer met behulp van analytische SQLite-query's (met behulp van standaard QML LocalStorage-bindingen) in plaats van deze op een backend te berekenen.
 
-### 3. Tabblad Taken
-Een speciaal tabblad voor het beheren en bekijken van individuele taken.* 
+### 1. Categorisering van de Eisenhower-matrix
+Classificeert actieve taken en activiteiten op basis van urgentie en belang:
+```sql
+SELECT id, summary, res_model, res_id, date_deadline
+FROM mail_activity_app
+WHERE done = 0 AND eisenhower_priority = ?;
+```
 
-* **Zoekbalk:** Maakt het snel opzoeken van projecten mogelijk ("Zoek projecten...").
-* **Sorteeropties:**
-    * **Meeste Tijd:** Sorteer op de hoogste bestede tijd.
-    * **Taken:** Sorteer op het aantal taken.
-    * **A–Z:** Alfabetische sortering.
-* **Projectenlijst:** Toont individuele projecten met hun specifieke aantallen taken, totale bestede tijd en een visuele voortgangsindicator.
+### 2. Projectgewijs geregistreerde tijd (Top 10 projecten)
+Verzamelt het totale aantal gelogde uren van `account_analytic_line_app`, gegroepeerd op projectnaam:
+```sql
+SELECT p.name AS project_name, SUM(t.unit_amount) AS total_hours
+FROM account_analytic_line_app t
+JOIN project_project_app p ON t.project_id = p.id
+GROUP BY t.project_id
+ORDER BY total_hours DESC
+LIMIT 10;
+```
 
-**Weergave Projectdetails:**
-Tikken op een specifiek project in de lijst navigeert naar een gedetailleerde weergave voor dat project, die het volgende omvat:
-* Een samenvattende koptekst die de `TOTALE` tijd, `GEMIDDELDE` tijd, het totale aantal `TAKEN` en de `TOPTAAK` toont.
-* Een specifiek staafdiagram dat de bestede tijd uitsplitst naar individuele taken binnen dat project.
-* Een lijst met individuele taken met hun percentage van de projecttijd, het totale aantal uren en een navigatiepijl voor verdere details.
+### 3. Voortgang van voltooiing van taken
+Berekent de algehele voortgang van taken die aan een project zijn gekoppeld:
+```sql
+SELECT 
+    COUNT(CASE WHEN stage_id = ? THEN 1 END) AS completed_tasks,
+    COUNT(id) AS total_tasks
+FROM project_task_app
+WHERE project_id = ?;
+```
 
 ---
 
-## Snelle Actieknop
-Een zwevende actieknop (cyaan cirkel met een menu-icoon) in de rechterbenedenhoek van het scherm.
+## Synchronisatiemechanisme en netwerkprotocol
 
-### Functies:
-* Een nieuwe taak toevoegen.
-* Een urenstaat-invoer aanmaken.
-* Een activiteit loggen.
+Het dashboard draait volledig client-side op de lokale SQLite-replicadatabase. Het initieert zelf geen externe HTTP/XML-RPC-verzoeken. Gegevensupdates worden op natuurlijke wijze doorgegeven aan het dashboard wanneer synchronisatietaken op de achtergrond de onderliggende SQL-tabellen bijwerken.

i18n/nl/docusaurus-plugin-content-docs/version-1.3.1.json

@@ -0,0 +1,26 @@
+{
+  "version.label": {
+    "message": "Volgende 🚧",
+    "description": "The label for version current"
+  },
+  "sidebar.docs.category.Functional": {
+    "message": "Functioneel",
+    "description": "The label for category 'Functional' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.User Manual": {
+    "message": "Gebruikershandleiding",
+    "description": "The label for category 'User Manual' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Technical": {
+    "message": "Technisch",
+    "description": "The label for category 'Technical' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Module Implementations": {
+    "message": "Module-implementaties",
+    "description": "The label for category 'Module Implementations' in sidebar 'docs'"
+  },
+  "sidebar.docs.category.Contributor": {
+    "message": "Bijdrager",
+    "description": "The label for category 'Contributor' in sidebar 'docs'"
+  }
+}

i18n/nl/docusaurus-plugin-content-docs/version-1.3.1/contributing/app-translation-guide.md

@@ -0,0 +1,172 @@
+---
+title: Handleiding voor App-vertaling en lokalisatie
+sidebar_label: App-vertaling
+description: Een stapsgewijze handleiding voor bijdragers om de interface van de Time Management App te vertalen in verschillende talen.
+---
+
+# Handleiding voor App-vertaling en lokalisatie
+
+Deze handleiding biedt stapsgewijze instructies voor het vertalen van de interface van de **Time Management App** zelf (de client-applicatie gebouwd met QML en Python) naar uw taal.
+
+Het vertaalsysteem van de app is gebaseerd op **gettext**. Vertalers bewerken `.po` (Portable Object)-bestanden met vertaalparen, die automatisch worden gecompileerd naar binaire `.mo`/`.gmo`-bestanden tijdens het bouwproces.
+
+---
+
+## 1. Mappenstructuur en vertaalbestanden
+
+Alle vertaalgerelateerde bestanden bevinden zich in de map `po/` in de root van de repository:
+
+```text
+timemanagement/
+├── po/
+│   ├── CMakeLists.txt        # Integratie van het bouwsysteem voor vertalingen
+│   ├── ubtms.pot             # Vertaalsjabloon (bevat alle onvertaalde strings)
+│   └── nl.po                 # Nederlands vertaalbestand (voorbeeld van de huidige vertaling)
+```
+
+* **`ubtms.pot`**: Het centrale sjabloonbestand dat rechtstreeks uit de codebase is geëxtraheerd. Het bevat alle originele Engelstalige strings.
+* **`<locale_code>.po`**: Taalspecifieke vertaalbestanden (bijv. `nl.po` voor het Nederlands, `es.po` voor het Spaans). Dit is het bestand dat u maakt of aanpast.
+
+---
+
+## 2. Vereisten
+
+Om bij te dragen aan de vertalingen, moeten de volgende hulpprogramma's geïnstalleerd zijn:
+
+1. **Gettext Utilities**: Command-line hulpprogramma's om vertalingen te initialiseren, samen te voegen en te compileren.
+   * **Ubuntu/Debian**:
+     ```bash
+     sudo apt update && sudo apt install gettext
+     ```
+2. **Teksteditor**: Een standaard teksteditor naar keuze (zoals VS Code, Vim, Gedit, enz.) om de vertaalbestanden te bewerken.
+3. **Clickable**: De bouwtool voor de applicatie, gebruikt om uw vertaling lokaal te compileren en te testen. Zie de **Getting Started**-handleiding voor details over de configuratie.
+
+---
+
+## 3. Vertaalworkflow
+
+### Stap 1: Het vertaalsjabloon (`ubtms.pot`) bijwerken
+Voordat u met de vertaling begint, compileert u het project eenmalig om er zeker van te zijn dat het vertaalsjabloon `po/ubtms.pot` is bijgewerkt met de nieuwste strings uit de broncode:
+
+```bash
+clickable build
+```
+*Opmerking: Het CMake-bouwsysteem voert automatisch het doel voor de extractie van de vertaling uit en analyseert alle QML- en desktopbestanden om `po/ubtms.pot` bij te werken.*
+
+### Stap 2: Uw vertaalbestand initialiseren of bijwerken
+
+#### Optie A: Een nieuwe taal starten
+Bepaal de tweeletterige taalcode (en optionele regio, bijv. `fr` voor Frans, `es` voor Spaans, `pt_BR` voor Braziliaans Portugees).
+Navigeer naar de map `po/` en initialiseer het vertaalbestand met `msginit`:
+
+```bash
+cd po
+msginit --locale=<locale_code> --input=ubtms.pot --output=<locale_code>.po
+```
+*Voorbeeld voor Spaans:*
+```bash
+msginit --locale=es --input=ubtms.pot --output=es.po
+```
+
+#### Optie B: Een bestaande taal bijwerken
+Als u nieuwe strings vertaalt die zijn toegevoegd aan een bestaande vertaling (bijv. het Nederlandse `nl.po`), voeg dan het bijgewerkte sjabloon samen met het vertaalbestand met `msgmerge`:
+
+```bash
+cd po
+msgmerge --update <locale_code>.po ubtms.pot
+```
+*Voorbeeld voor Nederlands:*
+```bash
+msgmerge --update nl.po ubtms.pot
+```
+Dit voegt eventuele nieuwe strings toe, markeert verwijderde strings als verouderd en markeert gewijzigde strings als `#, fuzzy` voor uw beoordeling.
+
+---
+
+### Stap 3: De strings vertalen
+Open uw `<locale_code>.po`-bestand in uw teksteditor.
+
+Vertaal voor elk item de bronstring (`msgid`) naar de vertaalde string (`msgstr`):
+
+```po
+msgid "Time Manager - Time Management Dashboard"
+msgstr "Tijdbeheer - Dashboard Tijdbeheer"
+```
+
+#### Belangrijke regels & best practices:
+1. **Behoud placeholders**: Laat parameters zoals `%1`, `%2` of `%3` intact. Ze vertegenwoordigen dynamische waarden die tijdens runtime worden ingevoegd.
+   * *Voorbeeld*: `i18n.dtr("ubtms", "You have %1 new notification(s)")` -> `Je hebt %1 nieuwe melding(en)`
+2. **Behoud escape sequences**: Tekens zoals `\n` (nieuwe regels) of `\t` (tabs) moeten in de vertaalde string behouden blijven.
+3. **Verwijder fuzzy-vlaggen**: Als u een string bijwerkt die is gemarkeerd met `#, fuzzy`, verwijder dan de commentaarregel met `#, fuzzy` nadat u hebt gecontroleerd of de vertaling correct is. Anders compileert het niet.
+
+---
+
+### Stap 4: Uw vertaling lokaal testen
+
+1. Bouw de applicatie met Clickable om het `.po`-vertaalbestand te compileren naar een binair `.mo`-bestand:
+   ```bash
+   clickable build
+   ```
+2. Voer de desktopversie van de applicatie uit met de gewenste taal geconfigureerd in de omgeving:
+   ```bash
+   LANG=<locale_code>.UTF-8 clickable desktop
+   ```
+   *Voorbeeld voor Nederlands:*
+   ```bash
+   LANG=nl_NL.UTF-8 clickable desktop
+   ```
+3. Controleer of alle vertaalde elementen correct in de interface verschijnen en of er geen lay-out- of tekstafkappingsproblemen zijn.
+
+---
+
+## 4. Richtlijnen voor ontwikkelaars (Strings markeren)
+
+Als u code (QML) schrijft en wilt zorgen dat de tekst vertaald kan worden, gebruik dan de volgende patronen:
+
+### In QML / JavaScript
+* **Standaardvertalingen**:
+  ```qml
+  title: i18n.dtr("ubtms", "Settings")
+  ```
+* **Vertalen met argumenten**:
+  ```qml
+  text: i18n.dtr("ubtms", "Account [%1]").arg(accountName)
+  ```
+* **Meervoudsvormen**:
+  Gebruik `i18n.tr` met meervoudsvormen bij het weergeven van hoeveelheden:
+  ```qml
+  // Syntaxis: i18n.tr(singular, plural, count)
+  text: i18n.tr("You have %1 task", "You have %1 tasks", count).arg(count)
+  ```
+
+### In Desktop Entry bestanden (`ubtms.desktop.in`)
+Voor desktopconfiguraties op systeemniveau geeft u de vertaalbare sleutels een prefix met een liggend streepje (underscore):
+```desktop
+_Name=Time Management
+```
+*Het bouwsysteem gebruikt `intltool` om deze desktop-sleutels te extraheren naar `ubtms.pot`.*
+
+---
+
+## 5. Uw bijdrage indienen (de PR maken)
+
+Zodra u de vertalingen hebt getest en hebt gecontroleerd of het `.po`-bestand correct is, bent u klaar om een Pull Request (PR) in te dienen:
+
+1. **Tijdelijke back-upbestanden opschonen**: Sommige editors maken tijdelijke back-upbestanden aan (bijv. `nl.po~` of `nl.po.bak`). Verwijder deze voordat u gaat committen.
+2. **Een Git-branch maken**:
+   ```bash
+   git checkout -b translation/add-<locale_code>
+   ```
+3. **Stagen en committen**:
+   ```bash
+   git add po/<locale_code>.po
+   git commit -m "translation: Add <Language_Name> translation"
+   ```
+4. **De branch pushen**:
+   ```bash
+   git push origin translation/add-<locale_code>
+   ```
+5. **De Pull Request openen**:
+   * Navigeer naar de originele repository op GitHub.
+   * Klik op **Compare & pull request**.
+   * Vul het PR-sjabloon in. Zorg ervoor dat u de toegevoegde of bijgewerkte taal beschrijft en bevestig dat u de app lokaal hebt gebouwd en getest.