Release/v1.2.9

.github/workflows/deploy-docs.yml

@@ -0,0 +1,60 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+      - website-customDeviceSimulation
+      - release/v1.2.9
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: website
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: website/package-lock.json
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build site
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: website/build
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -2,3 +2,8 @@ __pycache__
 build
 *.pot
 .agent
+voice_to_text/lib/
+.clickable
+website/node_modules
+website/.docusaurus
+website/build

CMakeLists.txt

@@ -57,6 +57,77 @@ install(DIRECTORY src DESTINATION ${DATA_DIR})
 
 install(DIRECTORY qml DESTINATION ${DATA_DIR})
 install(DIRECTORY models DESTINATION ${DATA_DIR})
+install(DIRECTORY voice_to_text DESTINATION ${DATA_DIR} PATTERN "model" EXCLUDE)
+
+
+# Map Clickable architecture to Pip platform tags
+if(CLICK_ARCH STREQUAL "arm64")
+    set(PIP_PLATFORM "manylinux2014_aarch64")
+elseif(CLICK_ARCH STREQUAL "amd64")
+    set(PIP_PLATFORM "manylinux2014_x86_64")
+else()
+    set(PIP_PLATFORM "manylinux2014_${CLICK_ARCH}")
+endif()
+
+# Detect Python version and ABI for pip dependencies
+execute_process(
+    COMMAND python3 -c "import sys; print('{}.{}'.format(sys.version_info.major, sys.version_info.minor))"
+    OUTPUT_VARIABLE PYTHON_VERSION
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+execute_process(
+    COMMAND python3 -c "import sys; print('cp{}{}'.format(sys.version_info.major, sys.version_info.minor))"
+    OUTPUT_VARIABLE PYTHON_ABI
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+
+# Dynamically download python dependencies during build
+if(CLICK_ARCH STREQUAL "armhf")
+    add_custom_command(
+        OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/voice_deps_installed.stamp
+        COMMAND rm -rf ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib
+        COMMAND mkdir -p ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib
+        COMMAND touch ${CMAKE_CURRENT_BINARY_DIR}/voice_deps_installed.stamp
+        COMMENT "Skipping voice-to-text Python dependencies on armhf (unsupported architecture)"
+    )
+else()
+    add_custom_command(
+        OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/voice_deps_installed.stamp
+        # Clean the build-time lib directory to ensure a fresh install
+        COMMAND rm -rf ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib
+        COMMAND mkdir -p ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib
+        # 1. Download all dependencies with the correct architecture/platform tags
+        COMMAND mkdir -p ${CMAKE_CURRENT_BINARY_DIR}/python_downloads
+        # Download binary packages (force aarch64)
+        # We use --no-deps to prevent it from trying to resolve pure-python dependencies with platform tags
+        COMMAND python3 -m pip download --dest ${CMAKE_CURRENT_BINARY_DIR}/python_downloads
+                --platform ${PIP_PLATFORM} --python-version ${PYTHON_VERSION} --implementation cp --abi ${PYTHON_ABI} --only-binary=:all: --no-deps
+                vosk==0.3.45 cffi==1.17.1 websockets==13.1 charset-normalizer==3.4.7
+        # Download pure-python packages (no platform tags needed as they are none-any)
+        COMMAND python3 -m pip download --dest ${CMAKE_CURRENT_BINARY_DIR}/python_downloads
+                certifi==2024.2.2 idna==3.13 requests==2.31.0 srt==3.5.3 tqdm==4.67.3 urllib3==1.26.18 pycparser
+
+        # 2. Install the downloaded packages into the target lib folder
+        # Phase 1: Binary ones (force platform). Use --no-deps to skip resolution of pure-python deps.
+        COMMAND python3 -m pip install --target ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib 
+                --no-index --find-links=${CMAKE_CURRENT_BINARY_DIR}/python_downloads
+                --platform ${PIP_PLATFORM} --python-version ${PYTHON_VERSION} --implementation cp --abi ${PYTHON_ABI} --only-binary=:all: --no-deps
+                vosk==0.3.45 cffi==1.17.1 websockets==13.1 charset-normalizer==3.4.7
+        # Phase 2: Pure-python ones. We also use --no-deps here to be safe and specific.
+        COMMAND python3 -m pip install --target ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib 
+                --no-index --find-links=${CMAKE_CURRENT_BINARY_DIR}/python_downloads --no-deps
+                certifi==2024.2.2 idna==3.13 requests==2.31.0 srt==3.5.3 tqdm==4.67.3 urllib3==1.26.18 pycparser
+
+        # 3. Bundle libatomic.so.1 (required by vosk on some arm64 devices)
+        # It's installed in the container via dependencies_target in clickable.yaml
+        COMMAND cp /usr/lib/${ARCH_TRIPLET}/libatomic.so.1 ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib/ || true
+        COMMAND touch ${CMAKE_CURRENT_BINARY_DIR}/voice_deps_installed.stamp
+        DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/voice_to_text/requirements.txt
+        COMMENT "Installing Python dependencies for voice to text (${CLICK_ARCH})"
+    )
+endif()
+add_custom_target(install_voice_deps ALL DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/voice_deps_installed.stamp)
+install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/voice_to_text/lib DESTINATION voice_to_text)
 
 # Translations
 file(GLOB_RECURSE I18N_SRC_FILES RELATIVE ${CMAKE_CURRENT_SOURCE_DIR}/po qml/*.qml qml/*.js)

README.md

@@ -1,102 +1,42 @@
-# Time Management 
+# TimeManagement
 
-Time Management 
+TimeManagement is a desktop and Ubuntu Touch project for task, timesheet, dashboard, and sync-oriented workflows.
 
-This guide explains how to install `clickable`, build the `TimeManagement` project, and run it on both desktop and Ubuntu Touch devices.
+## Documentation site
 
-## Prerequisites
+The project now includes a Docusaurus website in `website/` that is intended to become the main home for:
 
-- Ubuntu or Debian-based system
-- Git
-- Python 3
-- Docker (for cross-compilation and device builds)
+- product-facing overview content
+- user and setup documentation
+- technical architecture and repository guidance
+- contributor workflow documentation
 
-## Install Clickable
+Planned published URL:
 
-Follow the official steps to install `clickable`:
+- `https://citopenrep.github.io/timemanagement/`
 
-```bash
-# Install required dependencies
-sudo apt update
-sudo apt install git python3 python3-pip
-
-# Install Clickable using pip
-pip3 install --user clickable-ut
-
-# Add Clickable to your PATH
-echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc
-source ~/.bashrc
-```
-
-Verify installation:
+## Local docs development
 
 ```bash
-clickable --version
+cd website
+npm install
+npm run start
 ```
 
+## App build and run
 
-## Build the project
-To build the project, clone this repo and then you can run 
-
-```bash
-clickable desktop 
-```
-
-The above command will run the project on desktop
+For the current application workflow:
 
 ```bash
+clickable desktop
 clickable install
 ```
-to install the app on the connected device.
-
-## Refactor guardrails
-
-Phase 1 refactor guardrails and naming contract are documented here:
-
-- docs/refactor/phase-1-architecture-contract.md
-- docs/refactor/phase-1-naming-map.md
-- docs/refactor/phase-1-smoke-checklist.md
-
-Migration check helper:
-
-```bash
-./scripts/refactor_phase1_checks.sh report
-```
-
-
-## License
-
-/*
- * MIT License
- *
- * Copyright (c) 2025 CIT-Services
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
 
-## Contributing
+## Existing source docs
 
-- [Pull Request Guidelines](docs/PR-GUIDELINES.md)
-- [High Level Architecture](docs/HLD.drawio)
-- [Phase 1 Refactor Docs](docs/refactor/)
+The legacy Markdown docs in `docs/` remain available during the migration into the Docusaurus site.
 
-## References
-* https://clickable-ut.dev/en/latest/
-* Location of DB : ~/.clickable/home/.local/share/ubtms/Databases
+## Repository references
 
+- [Technical file organization](docs/TECHNICAL-FILE-ORGANIZATION.md)
+- [Pull request guidelines](docs/PR-GUIDELINES.md)

clickable.yaml

@@ -2,3 +2,7 @@ clickable_minimum_required: 8.0.0
 builder: cmake
 kill: qmlscene
 skip_review: true
+dependencies_target:
+  - libatomic1
+dependencies_host:
+  - python3-pip