Skip to content

docs(fullstack): synchronize architecture and add hardware BOM - #382

Merged
GiZano merged 4 commits into
mainfrom
docs/wiki-update
Sep 3, 2026
Merged

docs(fullstack): synchronize architecture and add hardware BOM#382
GiZano merged 4 commits into
mainfrom
docs/wiki-update

Conversation

@GiZano

@GiZano GiZano commented Sep 3, 2026

Copy link
Copy Markdown
Owner

Overview

This PR fully synchronizes the project documentation (README, Whitepaper, and Project Website) with the latest QuakeGuard v2.0.1 architecture, specifically reflecting the adoption of the Cloudflare HTTPS tunnel and the extended 300-second anti-replay window. It also adds a critical cross-reference to the newly generated hardware Bill of Materials (BOM) in the GitHub Wiki.

Changes Made

  • README.md: Updated the anti-replay window references from 60s to 300s to match the actual backend/src/security.py implementation. Added a link to the PCB BOM under the hardware image.
  • docs/whitepaper/02-hardware.typ: Added a dedicated bullet point mentioning the availability of the exact KiCad-derived BOM in the official Wiki.
  • docs/web/quakeguard.html: Enriched the "Proprietary Hardware (v2.0.1)" section with a direct HTML link to the Wiki BOM page.
  • (Note: The Wiki itself has been independently updated via the QuakeGuard.wiki.git repository, adding the BOM and Triangulation algorithm pages).

Impact & Next Steps

These changes ensure 100% coherence across all technical documentation surfaces prior to the final v2.0.1 Zenodo archival, preventing any ambiguities regarding hardware requirements or security thresholds. No subsequent architectural issues are unblocked by this PR, but it provides a clean baseline for future releases.

Testing Performed

  • Verified README.md markdown rendering locally.
  • Validated that all internal links to the Wiki successfully resolve to the live pages.
  • Ensured the web UI modifications do not break the docs/web/quakeguard.html structure.

Related Issues

Closes # (N/A)

@GiZano
GiZano requested a review from riccardo0731 as a code owner September 3, 2026 13:50
@GiZano GiZano changed the title [docs] Synchronize architecture and add hardware BOM docs(fullstack): synchronize architecture and add hardware BOM Sep 3, 2026
@sonarqubecloud

sonarqubecloud Bot commented Sep 3, 2026

Copy link
Copy Markdown

@GiZano
GiZano merged commit f082181 into main Sep 3, 2026
6 checks passed
@GiZano
GiZano deleted the docs/wiki-update branch September 3, 2026 14:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant