From fba399670d5eb27284088ab491265b28b5bcb9ae Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Fri, 23 Oct 2026 10:52:17 -0700 Subject: [PATCH] case 4690 - dev docs: build VM deprecated, releases built on the workstation (backup laptop as fallback) Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 +- devdocs/build/BUILD.md | 4 +++- devdocs/build/DEV-VM-SETUP.md | 2 ++ devdocs/modernization/NET10-PORT.md | 2 +- devdocs/modernization/PROJECT-OVERVIEW.md | 2 +- devdocs/modernization/ROADMAP.md | 2 +- 6 files changed, 9 insertions(+), 5 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 986e1029..3f11800d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -95,4 +95,4 @@ dotnet publish server\AyaNova\AyaNova.csproj -c Release -r linux-x64 --no-self-c | `devdocs/modernization/CODEBASE-REFERENCE.md` | Stack, structure, configuration, API conventions | | `devdocs/modernization/TESTING.md` | Test suites and their state | | `devdocs/build/BUILD.md` | Release build, packaging, version numbers | -| `devdocs/build/DEV-VM-SETUP.md` | Rebuilding the Windows build VM from scratch | +| `devdocs/build/DEV-VM-SETUP.md` | Deprecated build VM plan; its tool list still serves for setting up a build machine. Releases are built on the workstation | diff --git a/devdocs/build/BUILD.md b/devdocs/build/BUILD.md index 2df83da8..439908da 100644 --- a/devdocs/build/BUILD.md +++ b/devdocs/build/BUILD.md @@ -3,7 +3,9 @@ How a full release is built: tools, folder layout, what `build-release.bat` does, and where version numbers live. Written for .NET 8 (8.2.4); updated for .NET 10 (8.3.0). -To set up a machine that can run this from scratch, see `DEV-VM-SETUP.md`. +Releases are built on the workstation; the backup laptop is the fallback. To set up a machine +that can run this from scratch, use the tool list and install commands in `DEV-VM-SETUP.md` +(the VM itself is deprecated). ## What gets built diff --git a/devdocs/build/DEV-VM-SETUP.md b/devdocs/build/DEV-VM-SETUP.md index 0ea25f29..e11fd3d5 100644 --- a/devdocs/build/DEV-VM-SETUP.md +++ b/devdocs/build/DEV-VM-SETUP.md @@ -1,5 +1,7 @@ # AyaNova v8 build VM setup +> **Deprecated (October 2026).** The plan to develop and build entirely in a VM was dropped: it could not cover the QuickBooks (QBI) project and some other parts. Releases are built directly on the workstation, with the backup laptop as the fallback (see `../modernization/PROJECT-OVERVIEW.md`). The tool list and install commands below are still a usable checklist for setting up either machine. + > **Purpose**: Step-by-step instructions to create a portable Windows virtual machine containing the complete AyaNova v8 build environment. This VM can run on Windows or Linux hosts. Written February 2026 for the .NET 8 build; updated October 2026 for the .NET 10 port (AyaNova 8.3.0): the .NET 10 SDK replaces the .NET 8 SDK. diff --git a/devdocs/modernization/NET10-PORT.md b/devdocs/modernization/NET10-PORT.md index ce74388c..ac19df1c 100644 --- a/devdocs/modernization/NET10-PORT.md +++ b/devdocs/modernization/NET10-PORT.md @@ -146,7 +146,7 @@ suite is waiting on (case 4653, case 4654, the contract issue). - Windows LAN: `lan.iss` prompts for the ASP.NET Core Hosting Bundle. Text and link updated to .NET 10 (2026-10-23); installer test still in section 4 - Windows standalone and the launcher are self-contained: no runtime needed on the customer's machine - [ ] Customer manual (`docs/`): system requirements and upgrade instructions for self-hosted customers. Report browser move (section 3): manual already updated in the same commit (`ops-config-report-render-browser-path.md`, `ops-install-linux-server.md`, `ops-upgrade-linux-server.md`, `ops-upgrade-linux-desktop.md`). The pre-8.2.0 upgrade scripts on the two upgrade pages still install `aspnetcore-runtime-8.0`: update with the .NET 10 runtime instructions -- [ ] Build VM: install the .NET 10 SDK (`winget install --id Microsoft.DotNet.SDK.10 -e --source winget`; the .NET 8 SDK is no longer needed). `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` updated (2026-10-23); the VM itself still to do +- [ ] Build machines: the workstation already has the .NET 10 SDK (10.0.103). The backup laptop needs it before it can build 8.3.0 (`winget install --id Microsoft.DotNet.SDK.10 -e --source winget`; the .NET 8 SDK is no longer needed). `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` updated (2026-10-23). The build VM is deprecated (John, 2026-10-23): n/a - [ ] Final gate runs on the finished code - [ ] Merge, per repo: ```powershell diff --git a/devdocs/modernization/PROJECT-OVERVIEW.md b/devdocs/modernization/PROJECT-OVERVIEW.md index 59e7874c..c31d2496 100644 --- a/devdocs/modernization/PROJECT-OVERVIEW.md +++ b/devdocs/modernization/PROJECT-OVERVIEW.md @@ -48,7 +48,7 @@ Ground Zero's own test droplet first, then customers through the day by time zon - **Workstation:** Beelink SER9 Pro+, 32 GB, Windows 11 Pro. Backup: ThinkPad X13 Gen 3 - **Editors:** VS Code for everything except QBI, which needs Visual Studio for the Windows Forms designer -- **Build VM:** a complete Windows 11 build environment in VirtualBox, exported and backed up to several drives (`devdocs/build/DEV-VM-SETUP.md`) +- **Builds:** releases are built on the workstation; the backup laptop is the fallback. A VirtualBox build VM (`devdocs/build/DEV-VM-SETUP.md`) was set up in early 2026 but is deprecated: going fully virtual could not cover QBI and some other parts - **Source control:** Git on a self-hosted Gitea on DigitalOcean. Moved from SVN in early 2026 - **Location:** off-grid, Starlink internet, solar power. The workstation is not left running overnight in winter, so do not plan work that depends on overnight runs on it diff --git a/devdocs/modernization/ROADMAP.md b/devdocs/modernization/ROADMAP.md index 7b728ef4..beffede1 100644 --- a/devdocs/modernization/ROADMAP.md +++ b/devdocs/modernization/ROADMAP.md @@ -7,7 +7,7 @@ the original plan (February–March 2026). Statuses are as of October 2026; any | Step | What | Status | |---|---|---| | — | SVN → Git, self-hosted Gitea | ✅ Done | -| — | Build process documented; Docker builds for front end and docs; Windows build VM exported and backed up | ✅ Done | +| — | Build process documented; Docker builds for front end and docs; Windows build VM exported and backed up (VM later deprecated: builds run on the workstation, see `devdocs/build/BUILD.md`) | ✅ Done | | A1 | E2E tests with Cypress 9.7.0, targeting remote devtest servers, with version validation and environment-based config | **[unverified]**: the suite exists in `raven-test\e2e` (last commit 2026-02-22), but the March notes listed it as both done and in progress | | A2 | Fix the outdated integration tests in `raven-test-integration` | ✅ Done, March 2026: compiles on `net8.0`, broken tests removed or rewritten | | A3 | Data-list filter and sort integration tests | ✅ Done, March 2026, together with Tier 1–3 gap coverage. `raven-test-integration\DataList\DataListOperations.cs` holds 15 real tests, not stubs |