Home

Welcome to the ProjectPulse Wiki

Mission: A local-first, zero-server project governance workstation and bi-directional Excel synchronization engine built in pure Vanilla HTML5, JavaScript, and CSS (~80,800 LOC).

Welcome to the official, authoritative engineering and user documentation for ProjectPulse. This wiki provides complete architectural specifications, functional catalogues, operational runbooks, data persistence designs, and performance engineering standards.

---

🧭 Wiki Directory

Section	Focus Areas	Key Contents
🏛️ Architecture-and-System-Design	System & Technical Architecture	5 Core Archify Mermaid diagrams: System Architecture, Governance Workflow, Excel Sync Sequence, Data Flow Pipeline, Workstation Lifecycle.
🚀 Getting-Started-and-User-Guide	Setup & Operational Runbook	Zero-build local execution, 20 curated UI themes, keyboard shortcuts, project setup, and daily workflows.
📊 Operational-Views-and-Feature-Catalogue	Functional Deep Dive	Comprehensive guide to all 10 operational views: Dashboard, Gantt, Deliveries (PDN), Scheduler, RAID, Team Hub, Defects, EVM.
💾 Excel-Sync-and-Persistence-Engine	State & Storage Tier	Global state schema (P), dual-tier persistence (localStorage & IndexedDB), and bi-directional SheetJS Excel engine.
⚡ Performance-and-Microinteraction-Architecture	UX & Engineering Standards	Zero-flicker interaction design, viewport-clamped tooltips, SVG/Canvas hybrid rendering, and 5-strategy column autofit.

---

⚡ Core System Principles

1. Local-First & Air-Gapped: Runs entirely within the browser client sandbox. Zero data leaves the local machine, eliminating cloud latency, API downtime, and compliance risks.
2. Pure Vanilla Engineering: Zero node_modules or runtime build steps required. Fast load times, predictable execution, and minimal memory overhead.
3. Bi-Directional Spreadsheet Fidelity: Seamlessly ingest and generate multi-sheet Excel workbooks (.xlsx) without data loss, formula corruption, or schema divergence.
4. Native Embedded Visualizations: All architectural models are rendered as native vector Mermaid charts with zero broken links or external viewer dependencies.
5. Deterministic Durability: Dual-engine storage with debounced write-behind caching ensures immediate recovery on unexpected tab closure or system reboots.