Files
archie/internal/webui/api_setup.go
T
sam 432cbf0846 feat(ui): give organisation, instance and account clear homes
The Access area mixed organisation, instance and personal settings under
one name. Split them: /org is the organisation's own area (members,
identities, connections, models, schedules, playbooks), /settings is
instance administration only, and personal security stays in the account
menu. Setup checklist steps now link to the page that fixes them.
2026-10-17 09:01:41 +11:00

68 lines
2.0 KiB
Go

package webui
import (
"net/http"
"strings"
)
// SetupStep is one item in the dashboard's getting-started checklist. Path is
// the page that owns the configuration the step is about, so an operator can
// follow the step to where it is fixed rather than guess a settings page.
type SetupStep struct {
Title string `json:"title"`
Detail string `json:"detail,omitempty"`
Done bool `json:"done"`
Path string `json:"path,omitempty"`
}
// handleSetup reports which setup steps are still missing, from live state.
func (s *Server) handleSetup(w http.ResponseWriter, r *http.Request) {
steps := []SetupStep{}
// Every step is read from the configuration projection this process
// renders, so the checklist works the same whether configuration is
// held here or published by its owner.
view, found, err := s.configSource()(r.Context())
if err != nil || !found {
// No configuration available: report nothing rather than
// guessing, so the dashboard simply omits the panel.
writeJSON(w, map[string]any{"steps": steps})
return
}
// The operator's name is deployment data, configured once in [chat]. The
// dashboard greets with it rather than hardcoding a name, which would be
// wrong on every deployment but one.
operator := view.Chat.Operator
steps = append(steps, SetupStep{
Title: "Identity",
Detail: "Account Archie commits as.",
Done: strings.TrimSpace(view.Identity.BotUser) != "",
Path: "/org/agents",
})
steps = append(steps, SetupStep{
Title: "Chat channel",
Detail: "Chat and approvals.",
Done: view.Chat.ChannelConfigured,
Path: "/settings/channels",
})
// Only meaningful once there is somewhere to run work.
if count, err := s.Store.StatusCounts(r.Context()); err == nil {
total := 0
for _, n := range count {
total += n
}
steps = append(steps, SetupStep{
Title: "First task",
Detail: "Describe one above.",
Done: total > 0,
Path: "/tasks",
})
}
writeJSON(w, map[string]any{"steps": steps, "operator": operator})
}