From 85b1055df54ece2f5fb0af82ea3b8ddfc66cca09 Mon Sep 17 00:00:00 2001
From: oppiliappan <me@oppi.li>
Date: Thu, 18 Jun 2026 12:31:37 +0000
Subject: [PATCH] appview/models: add onboarding stages and model

Signed-off-by: oppiliappan <me@oppi.li>
---
 appview/models/onboarding.go | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file(s) changed, 60 insertion(s)(+), 0 deletion(s)(-)

diff --git a/appview/models/onboarding.go b/appview/models/onboarding.go
new file mode 100644
--- /dev/null
+++ b/appview/models/onboarding.go
@@ -0,0 +1,60 @@
+package models
+
+import (
+	"time"
+)
+
+type OnboardingStatus string
+
+const (
+	OnboardingInProgress OnboardingStatus = "in_progress"
+	OnboardingCompleted  OnboardingStatus = "completed"
+	OnboardingSkipped    OnboardingStatus = "skipped"
+)
+
+// onboarding steps, in order. Done is a sentinel that marks completion.
+const (
+	OnboardingStepProfile = 0
+	OnboardingStepSocial  = 1
+	OnboardingStepKeys    = 2
+	OnboardingStepRepo    = 3
+	OnboardingStepDone    = 4
+)
+
+type Onboarding struct {
+	Did     string
+	Step    int
+	Status  OnboardingStatus
+	Created time.Time
+	Updated time.Time
+}
+
+// OnboardingProgress feeds the "resume onboarding" banner/panel. Active is false
+// when there is nothing to resume (no in-progress onboarding).
+type OnboardingProgress struct {
+	Active  bool
+	Step    int
+	Total   int
+	Percent int
+}
+
+// Progress derives display progress for the resume banner/panel. It is nil-safe,
+// so callers can pass the result of GetOnboarding directly.
+func (o *Onboarding) Progress() OnboardingProgress {
+	if o == nil || o.Status != OnboardingInProgress {
+		return OnboardingProgress{}
+	}
+	// Percent reflects completed steps out of the total, so the bar only fills
+	// as steps are finished (e.g. on the last step it is not yet 100%).
+	total := OnboardingStepDone
+	percent := o.Step * 100 / total
+	if percent > 100 {
+		percent = 100
+	}
+	return OnboardingProgress{
+		Active:  true,
+		Step:    o.Step,
+		Total:   total,
+		Percent: percent,
+	}
+}

--
tangled.sh