docs(fullstack): single-repo docs hub, docs/web page and GitHub Pages sync

- Move whitepaper Typst sources into docs/whitepaper/
- Add docs/web/ as single source of truth for the QuakeGuard page
- Bump page content to v1.2.1 (Geo-Zoning & GNSS-Ready) in EN/IT dicts
- Update release.svg badge to v1.2.1
- Add deploy-gh-pages.yml workflow syncing docs/web to GiZano.github.io

Author: GiZano

.github/workflows/deploy-gh-pages.yml

@@ -0,0 +1,50 @@
+name: Deploy QuakeGuard Page to GitHub Pages Repo
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'docs/web/**'
+      - '.github/workflows/deploy-gh-pages.yml'
+  workflow_dispatch:
+
+jobs:
+  sync-pages:
+    name: Sync docs/web → GiZano.github.io
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout QuakeGuard
+      uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
+
+    - name: Checkout GiZano.github.io (site repo)
+      uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
+      with:
+        repository: GiZano/GiZano.github.io
+        ref: main
+        token: ${{ secrets.GIZANO_IO_PAT }}
+        path: site-repo
+
+    - name: Copy QuakeGuard page artifacts
+      run: |
+        cp docs/web/quakeguard.html       site-repo/projects/quakeguard.html
+        cp docs/web/quakeguard.css        site-repo/Style/quakeguard.css
+        cp docs/web/quakeguard.js         site-repo/Script/i18n/quakeguard.js
+        cp docs/web/quakeguard-demo.js    site-repo/Script/quakeguard-demo.js
+        cp -r docs/web/assets/quakeguard/. site-repo/assets/quakeguard/
+        cp -r docs/web/assets/badges/.     site-repo/assets/badges/
+
+    - name: Commit and push if changed
+      run: |
+        cd site-repo
+        git config user.name  "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+        if git diff --quiet; then
+          echo "No changes to deploy — skipping commit."
+          exit 0
+        fi
+
+        git add -A
+        git commit -m "docs(quakeguard): sync v1.2.1 page from QuakeGuard repo"
+        git push origin main

.gitignore

@@ -7,6 +7,11 @@
 # ------------------------------------------
 .env
 
+# ------------------------------------------
+# Project Notes (local tracker, not part of the repo)
+# ------------------------------------------
+TODO.md
+
 # ------------------------------------------
 # Python (Backend)
 # ------------------------------------------

docs/README.md

@@ -1,38 +1,39 @@
 # QuakeGuard — Documentation Hub
 
-This directory holds the authoritative technical documentation for QuakeGuard, authored in [Typst](https://typst.app/) and compiled into a single PDF technical report.
+Single source of truth for QuakeGuard documentation. Each subfolder has a single
+purpose:
+
+```
+docs/
+├── whitepaper/          # main.typ + 01-architecture..08-ai.typ + assets/ + PDF
+├── web/                 # quakeguard.html/css/js/demo.js + assets/ (see README)
+├── README.md            # this hub guide
+├── extract.sh           # LLM context export (stays at docs/ root)
+└── codebase_docs.txt    # generated by extract.sh (stays at docs/ root)
+```
 
 ## Contents
 
-| File | Covers |
-|------|--------|
-| `main.typ` | Document setup, cover page, table of contents (compiles all chapters) |
-| `01-architecture.typ` | System architecture & high-level topology (edge / backend / client) |
-| `02-hardware.typ` | ESP32-C3 edge node: DSP, STA/LTA, FreeRTOS, optional GNSS subsystem |
-| `03-security.typ` | ECDSA identity, provisioning handshake, payload authentication |
-| `04-broker.typ` | MQTT data plane, HiveMQ Cloud, internal MQTT bridge |
-| `05-backend.typ` | Redis Streams ingestion, worker, TimescaleDB, geo-zoning, alerts |
-| `06-mobile.typ` | React Native client: per-zone seismograph, GPS zone detection, themes |
-| `07-deployment.typ` | Local/development provisioning, scaling, simulation & stress testing |
-| `08-ai.typ` | On-premise AI Emergency Report service (Ollama) |
-| `assets/` | Logos and color palette used by the report |
-
-## Compiling the PDF
+| Directory | Covers |
+|-----------|--------|
+| [`whitepaper/`](whitepaper/README.md) | Typst sources for the technical report, compiled into `QuakeGuard_Technical_Report_v1.2.1.pdf` |
+| [`web/`](web/) | QuakeGuard page artifacts (html/css/js/demo + assets) synced to the `GiZano.github.io` Pages site via CI |
+
+## Compiling the whitepaper PDF
 
 Requires [Typst](https://typst.app/) (`typst` on PATH) and the Liberation Serif font family.
 
 ```bash
 cd docs
-typst compile main.typ QuakeGuard_Technical_Report_v1.2.1.pdf
+typst compile whitepaper/main.typ whitepaper/QuakeGuard_Technical_Report_v1.2.1.pdf
 ```
 
 The output PDF is a local build artifact and is intentionally **not** tracked in git.
 
-## Editing conventions
+## Editing the web page
 
-- Chapters are plain Typst with `[cite: 1]` markers that reference the original `codebase_docs.txt` source export (see `extract.sh`).
-- Keep each chapter self-contained; the build order is defined in `main.typ` via `#include`.
-- When a new release changes behaviour, update the affected chapters and bump the version string in `main.typ` (cover + page header) to match.
+Edit only inside `docs/web/`. A CI workflow (`deploy-gh-pages.yml`) syncs changes
+into the `GiZano/GiZano.github.io` Pages repo; never edit the site repo directly.
 
 ## `extract.sh`
 
@@ -41,4 +42,4 @@ The output PDF is a local build artifact and is intentionally **not** tracked in
 ```bash
 cd docs
 ./extract.sh
-```
+```