initial commit

2026-08-07 14:51:41 -05:00
commit 9251b3a196
604 changed files with 464448 additions and 0 deletions
@@ -0,0 +1,56 @@
+#pragma once
+
+#include "app_state.h"
+#include "db/db_keys.h"
+
+// First-Run provisioning walkthrough. On every boot the app walks a fixed
+// sequence of prerequisites and shows the first one that is missing:
+//
+//   1. Internet reachable?  -> WiFiSetupPage
+//   2. Email address set?   -> EmailAddressPage
+//   3. License key set?     -> LicenseKeyPage
+//   4. Everything satisfied -> Home
+//
+// "Internet reachable" means real connectivity (Ethernet, WiFi, or whatever
+// the OS provides) via NetworkManager::hasInternet(), NOT merely "a WiFi
+// link is up" -- so a device on Ethernet or a developer's MacBook never gets
+// trapped on the WiFi page.
+//
+// When the walkthrough starts (begin) and the very first step is missing
+// (no internet, no email, no license) the device is treated as brand-new and
+// the firstRunWalkthrough placeholder flag is raised. That flag will later
+// drive a first-run welcome walkthrough (TOS, quick user guide, ...); today
+// it is only set and logged.
+namespace radiantwave::provisioning {
+
+// Prerequisite steps in walkthrough priority order.
+enum class Step { Done, Internet, Email, License };
+
+// First unsatisfied step, given the current conditions.
+inline Step firstMissingStep(bool internetUp, bool hasEmail, bool hasLicense)
+{
+    if (!internetUp) return Step::Internet;
+    if (!hasEmail) return Step::Email;
+    if (!hasLicense) return Step::License;
+    return Step::Done;
+}
+
+// True when nothing is configured (no internet, no email, no license).
+// Signals a brand-new, never-provisioned device.
+inline bool indicatesFirstRun(bool internetUp, bool hasEmail, bool hasLicense)
+{
+    return !internetUp && !hasEmail && !hasLicense;
+}
+
+// Startup walkthrough. Evaluates the prerequisites and pushes the first
+// missing step's page (with provisioningMode set), or Home when everything
+// is satisfied. Home is always the end of the walkthrough.
+void begin(AppState& state);
+
+// Called by a walkthrough page when the user finishes or exits it. Pops the
+// current page, re-evaluates the prerequisites, and pushes the next missing
+// step's page (or Home). Internet is only re-probed when it was still
+// missing, so completing a step never blocks on a redundant check.
+void advance(AppState& state);
+
+} // namespace radiantwave::provisioning