Files
redis-gui-foundation/plans/2026-03-27-hac-15-desktop-build-smoke.md
Senior Frontend Engineer b6cbe5a47e docs(project): refresh baseline verification artifacts
Check in the PM product requirements, refreshed QA acceptance evidence, shared execution split plans, and current-phase status notes so the repo matches the current delivery baseline.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-03-31 10:15:39 +00:00

2.1 KiB

HAC-15 Desktop Build, Packaging, And Smoke Plan

Date: 2026-03-27 UTC Owner: Senior Backend Engineer Issue: HAC-15

Goal

Make the desktop repository usable through one stable build path, one stable package path, and one repeatable local Redis smoke path.

Current Findings

  • The original tauri.conf.json pre-build and pre-dev commands assumed the wrong working directory and caused tauri build to fail before the real Rust/Tauri flow began.
  • The repo already had a valid desktop frontend build and a validated shared Rust backend core, but no stable pnpm workspace setup for the desktop shell.
  • QA had explicit blockers around missing seed data, missing Docker or smoke automation, and missing reusable build instructions.

Changes In This Pass

  1. Standardize the workspace on pnpm by adding packageManager, pnpm-workspace.yaml, and root desktop scripts.
  2. Fix Tauri beforeDevCommand and beforeBuildCommand so they execute against the desktop workspace directly.
  3. Add a Docker-backed Redis fixture with start, seed, and stop scripts.
  4. Add a local desktop smoke runbook and refresh README and QA evidence docs around the new commands and fixture path.

Verification

  • Passed: cargo test -p redis-core
  • Passed: pnpm install --lockfile-only
  • Passed: pnpm run desktop:build
  • Passed: ./scripts/redis-fixture/start.sh
  • Passed: ./scripts/redis-fixture/seed.sh
  • Passed: ./scripts/redis-fixture/stop.sh
  • Passed: pkg-config --modversion gtk+-3.0
  • Passed: pkg-config --modversion webkit2gtk-4.1
  • Passed: pkg-config --modversion libsoup-3.0
  • Passed: pnpm run desktop:tauri:build
  • Evidence: Linux package artifacts were emitted under target/release/bundle/, including .deb and .rpm

Remaining Risk

  • HAC-15 exit criteria are satisfied for the documented stable Linux path, but macOS and Windows packaging remain outside this issue's validated evidence set.
  • The separate pnpm run desktop:tauri:build:all path still has AppImage-stage risk and should not replace the stable QA packaging command.
  • End-to-end GUI smoke evidence still depends on a human-run desktop session with screenshots or QA snapshot capture.