diff --git a/incident_card.go b/incident_card.go new file mode 100644 index 0000000..25b6281 --- /dev/null +++ b/incident_card.go @@ -0,0 +1,114 @@ +package mujica + +import ( + "fmt" + "time" + + "github.com/egoist/mygo/ui" + + "mujicaui/internal" + "mujicaui/theme" +) + +// IncidentStatus is where an incident stands. The zero value is IncidentInvestigating. +type IncidentStatus int + +const ( + IncidentInvestigating IncidentStatus = iota + IncidentIdentified + IncidentMonitoring + IncidentResolved +) + +// IncidentImpact is how badly users are affected. The zero value is ImpactNone. +type IncidentImpact int + +const ( + ImpactNone IncidentImpact = iota + ImpactMinor + ImpactMajor + ImpactCritical +) + +// IncidentUpdate is one timeline entry, oldest first. +type IncidentUpdate struct { + At time.Time + Status IncidentStatus + Text string +} + +// Incident is what the caller reports about an incident. +type Incident struct { + Title string + Status IncidentStatus + Impact IncidentImpact + Started time.Time + Updates []IncidentUpdate +} + +// IncidentCard shows an incident's title, status, impact and update timeline. +func IncidentCard(c *ui.Context, inc Incident) *ui.Element { + if inc.Title == "" { + panic("mujica: IncidentCard needs a Title") + } + status := incidentStatusWord(c, inc.Status) + if inc.Impact < ImpactNone || inc.Impact > ImpactCritical { + panic(fmt.Sprintf("mujica: unknown IncidentImpact %d", int(inc.Impact))) + } + k := Tokens(c) + u := Density(c).Unit() + sev := [...]Severity{SeverityInfo, SeverityWarning, SeverityError, SeverityError}[inc.Impact] + impact := msg(c, [...]string{"incident_card.none", "incident_card.minor", "incident_card.major", "incident_card.critical"}[inc.Impact]) + card := agentCard(c).Label(inc.Title + ", " + status) + card.Children(func() { + ui.Row(c).Gap(u * 2).AlignItems(ui.Center).Children(func() { + devtoolsTitle(c, inc.Title).Grow(1).Shrink(1) + if inc.Status == IncidentResolved { + devtoolsSeverity(c, SeveritySuccess, status) + } else { + devtoolsSeverity(c, SeverityWarning, status) + } + }) + ui.Row(c).Gap(u * 3).AlignItems(ui.Center).Children(func() { + devtoolsSeverity(c, sev, fmt.Sprintf(msg(c, "incident_card.impact"), impact)) + if !inc.Started.IsZero() { + agentCaption(c, fmt.Sprintf(msg(c, "incident_card.started"), inc.Started.Format("2006-01-02 15:04"))) + } + }) + for i, up := range inc.Updates { + incidentUpdate(c, k, up, i == len(inc.Updates)-1) + } + }) + return card +} + +// incidentUpdate draws one timeline entry on a diamond rail. +func incidentUpdate(c *ui.Context, k theme.Tokens, up IncidentUpdate, last bool) { + u := Density(c).Unit() + ui.Row(c).Gap(u * 3).AlignItems(ui.Stretch).Children(func() { + ui.Box(c).Width(12).Shrink(0).Draw(func(p *ui.Painter, r ui.Rect) { + cx := internal.Snap(p, r.X+r.W/2) + cy := internal.Snap(p, r.Y+9) + if !last { + p.Line(cx, cy+5, cx, r.Y+r.H, 1, k.ControlBorder) + } + p.FillPath(internal.Diamond(cx, cy, 9), k.Ornament) + }) + ui.Column(c).Grow(1).Shrink(1).Gap(u / 2).Padding(0, 0, u*2, 0).Children(func() { + ui.Row(c).Gap(u * 2).Children(func() { + ui.Text(c, incidentStatusWord(c, up.Status)).FontWeight(600) + if !up.At.IsZero() { + agentCaption(c, up.At.Format("15:04")) + } + }) + ui.Text(c, up.Text).TextColor(k.TextMuted) + }) + }) +} + +func incidentStatusWord(c *ui.Context, s IncidentStatus) string { + if s < IncidentInvestigating || s > IncidentResolved { + panic(fmt.Sprintf("mujica: unknown IncidentStatus %d", int(s))) + } + return msg(c, [...]string{"incident_card.investigating", "incident_card.identified", "incident_card.monitoring", "incident_card.resolved"}[s]) +} diff --git a/incident_card_test.go b/incident_card_test.go new file mode 100644 index 0000000..98fa5f1 --- /dev/null +++ b/incident_card_test.go @@ -0,0 +1,55 @@ +package mujica + +import ( + "testing" + "time" + + "github.com/egoist/mygo/ui" +) + +func incidentSample() Incident { + t0 := time.Date(2026, 10, 5, 21, 4, 0, 0, time.UTC) + return Incident{Title: "Checkout errors in eu-west", Status: IncidentMonitoring, Impact: ImpactMajor, Started: t0, + Updates: []IncidentUpdate{ + {At: t0, Status: IncidentInvestigating, Text: "Error rate rose to 8%."}, + {At: t0.Add(12 * time.Minute), Status: IncidentIdentified, Text: "A bad config push to the payment proxy."}, + {At: t0.Add(30 * time.Minute), Status: IncidentMonitoring, Text: "Rolled back; errors are falling."}, + }} +} + +func TestIncidentCardShowsStatusImpactTimeline(t *testing.T) { + inc := incidentSample() + tt := ui.NewTester(func(c *ui.Context) { + Use(c, Settings{}) + IncidentCard(c, inc) + }, 560, 500) + for _, s := range []string{"Checkout errors in eu-west", "Monitoring", "Impact: major", "Started 2026-10-05 21:04", + "Investigating", "21:16", "Rolled back; errors are falling."} { + if !tt.HasText(s) { + t.Fatalf("missing %q in %q", s, tt.Texts()) + } + } + inc.Status = IncidentResolved + tt.Frame() + if !tt.HasText("Resolved") { + t.Fatal("status did not update") + } +} + +func TestIncidentCardRejectsUnknownStatus(t *testing.T) { + defer func() { + if recover() == nil { + t.Fatal("no panic") + } + }() + ui.NewTester(func(c *ui.Context) { + Use(c, Settings{}) + IncidentCard(c, Incident{Title: "x", Status: 9}) + }, 200, 200) +} + +func TestIncidentCardSnapshot(t *testing.T) { + snapshot(t, "incident_card", 540, 360, func(c *ui.Context) { + ui.Column(c).Padding(16).Children(func() { IncidentCard(c, incidentSample()) }) + }) +} diff --git a/messages_devtools.go b/messages_devtools.go index 5d9d5a6..a1373e8 100644 --- a/messages_devtools.go +++ b/messages_devtools.go @@ -11,13 +11,33 @@ func init() { "stat_card.change": {"Change %s", "变化 %s"}, "devtools.ago": {"%s ago", "%s 前"}, - "alert_list.info": {"Info", "提示"}, - "alert_list.warning": {"Warning", "警告"}, - "alert_list.critical": {"Critical", "严重"}, - "alert_list.ack": {"Acknowledge", "确认"}, - "alert_list.acked": {"Acknowledged", "已确认"}, - "alert_list.silence": {"Silence 1 h", "静默 1 小时"}, - "alert_list.silenced": {"Silenced until %s", "静默至 %s"}, - "alert_list.empty": {"No alerts", "没有告警"}, + "alert_list.info": {"Info", "提示"}, + "alert_list.warning": {"Warning", "警告"}, + "alert_list.critical": {"Critical", "严重"}, + "alert_list.ack": {"Acknowledge", "确认"}, + "alert_list.acked": {"Acknowledged", "已确认"}, + "alert_list.silence": {"Silence 1 h", "静默 1 小时"}, + "alert_list.silenced": {"Silenced until %s", "静默至 %s"}, + "incident_card.investigating": {"Investigating", "调查中"}, + "incident_card.identified": {"Identified", "已定位"}, + "incident_card.monitoring": {"Monitoring", "观察中"}, + "incident_card.resolved": {"Resolved", "已解决"}, + "incident_card.none": {"none", "无"}, + "incident_card.minor": {"minor", "轻微"}, + "incident_card.major": {"major", "严重"}, + "incident_card.critical": {"critical", "致命"}, + "incident_card.impact": {"Impact: %s", "影响:%s"}, + "incident_card.started": {"Started %s", "开始于 %s"}, + + "service_status.operational": {"Operational", "正常"}, + "service_status.degraded": {"Degraded", "降级"}, + "service_status.outage": {"Outage", "中断"}, + "service_status.all_ok": {"All systems operational", "所有服务正常"}, + "service_status.some_degraded": {"Some services degraded", "部分服务降级"}, + "service_status.some_down": {"Some services down", "部分服务中断"}, + "service_status.counts": {"%d up · %d degraded · %d down", "%d 正常 · %d 降级 · %d 中断"}, + "service_status.empty": {"No services", "没有服务"}, + + "alert_list.empty": {"No alerts", "没有告警"}, }) } diff --git a/service_status.go b/service_status.go new file mode 100644 index 0000000..e2a9c91 --- /dev/null +++ b/service_status.go @@ -0,0 +1,91 @@ +package mujica + +import ( + "fmt" + + "github.com/egoist/mygo/ui" + + "mujicaui/theme" +) + +// ServiceHealth is a service's state. The zero value is ServiceOperational. +type ServiceHealth int + +const ( + ServiceOperational ServiceHealth = iota + ServiceDegraded + ServiceOutage +) + +// ServiceItem is one service the caller reports. +type ServiceItem struct { + Name string + Health ServiceHealth + // Note explains a degraded or down service. + Note string +} + +// ServiceStatusOptions configure a ServiceStatus. +type ServiceStatusOptions struct { + // MaxHeight caps the scrolling list; zero means 360. + MaxHeight float32 +} + +// ServiceStatus lists services as operational, degraded or down, under an overall summary. +func ServiceStatus(c *ui.Context, services []ServiceItem, opts ServiceStatusOptions) *ui.Element { + if opts.MaxHeight < 0 { + panic("mujica: ServiceStatus MaxHeight is negative") + } + worst, counts := ServiceOperational, [3]int{} + for i, s := range services { + if s.Name == "" || s.Health < ServiceOperational || s.Health > ServiceOutage { + panic(fmt.Sprintf("mujica: ServiceStatus service %d needs a Name and a known Health", i)) + } + worst = max(worst, s.Health) + counts[s.Health]++ + } + maxH := opts.MaxHeight + if maxH == 0 { + maxH = 360 + } + k := Tokens(c) + u := Density(c).Unit() + summary := msg(c, [...]string{"service_status.all_ok", "service_status.some_degraded", "service_status.some_down"}[worst]) + col := ui.Column(c).Shrink(0).Gap(u * 2).Label(summary) + col.Children(func() { + ui.Row(c).Gap(u * 3).AlignItems(ui.Center).Padding(u*3).Radius(theme.CardRadius).Border(theme.BorderWidth, k.Border). + Background(k.Surface).Role(ui.RoleStatus).Label(summary).Children(func() { + devtoolsSeverity(c, serviceSeverity(worst), summary) + ui.Box(c).Grow(1) + agentCaption(c, fmt.Sprintf(msg(c, "service_status.counts"), counts[0], counts[1], counts[2])) + }) + if len(services) == 0 { + agentCaption(c, msg(c, "service_status.empty")) + return + } + agentRows(c, len(services), func(i int) { + s := services[i] + word := serviceWord(c, s.Health) + ui.Row(c).Key(i).Gap(u * 3).AlignItems(ui.Center).MinHeight(Density(c).ControlHeight()).Padding(u, u*3). + Label(s.Name + ", " + word).Children(func() { + ui.Column(c).Grow(1).Shrink(1).Children(func() { + ui.Text(c, s.Name).SingleLine() + if s.Note != "" { + agentCaption(c, s.Note) + } + }) + devtoolsSeverity(c, serviceSeverity(s.Health), word) + }) + }).Shrink(1).MaxHeight(maxH).Background(k.Surface).Border(theme.BorderWidth, k.Border). + Radius(theme.CardRadius).Dividers(theme.BorderWidth, k.Border) + }) + return col +} + +func serviceSeverity(h ServiceHealth) Severity { + return [...]Severity{SeveritySuccess, SeverityWarning, SeverityError}[h] +} + +func serviceWord(c *ui.Context, h ServiceHealth) string { + return msg(c, [...]string{"service_status.operational", "service_status.degraded", "service_status.outage"}[h]) +} diff --git a/service_status_test.go b/service_status_test.go new file mode 100644 index 0000000..6d9a07b --- /dev/null +++ b/service_status_test.go @@ -0,0 +1,57 @@ +package mujica + +import ( + "fmt" + "testing" + + "github.com/egoist/mygo/ui" +) + +var servicesSample = []ServiceItem{ + {Name: "API", Health: ServiceOperational}, + {Name: "Search", Health: ServiceDegraded, Note: "Indexing is slow"}, + {Name: "Payments", Health: ServiceOutage, Note: "Provider unreachable"}, +} + +func TestServiceStatusSummaryAndRows(t *testing.T) { + services := servicesSample + tt := ui.NewTester(func(c *ui.Context) { + Use(c, Settings{}) + ServiceStatus(c, services, ServiceStatusOptions{}) + }, 520, 400) + for _, s := range []string{"Some services down", "1 up · 1 degraded · 1 down", "Degraded", "Outage", "Provider unreachable"} { + if !tt.HasText(s) { + t.Fatalf("missing %q in %q", s, tt.Texts()) + } + } + services = servicesSample[:1] + tt.Frame() + if !tt.HasText("All systems operational") { + t.Fatalf("all ok: %q", tt.Texts()) + } + services = nil + tt.Frame() + if !tt.HasText("No services") { + t.Fatal("empty") + } +} + +func TestServiceStatusManyVirtualized(t *testing.T) { + many := make([]ServiceItem, 100000) + for i := range many { + many[i] = ServiceItem{Name: fmt.Sprint("svc ", i)} + } + tt := ui.NewTester(func(c *ui.Context) { + Use(c, Settings{}) + ServiceStatus(c, many, ServiceStatusOptions{}) + }, 520, 400) + if n := len(tt.Texts()); n > 300 { + t.Fatalf("%d texts", n) + } +} + +func TestServiceStatusSnapshot(t *testing.T) { + snapshot(t, "service_status", 520, 280, func(c *ui.Context) { + ui.Column(c).Padding(16).Children(func() { ServiceStatus(c, servicesSample, ServiceStatusOptions{}) }) + }) +} diff --git a/testdata/snapshots/darwin/incident_card-dark.png b/testdata/snapshots/darwin/incident_card-dark.png new file mode 100644 index 0000000..464c306 Binary files /dev/null and b/testdata/snapshots/darwin/incident_card-dark.png differ diff --git a/testdata/snapshots/darwin/incident_card-light.png b/testdata/snapshots/darwin/incident_card-light.png new file mode 100644 index 0000000..0a9a822 Binary files /dev/null and b/testdata/snapshots/darwin/incident_card-light.png differ diff --git a/testdata/snapshots/darwin/service_status-dark.png b/testdata/snapshots/darwin/service_status-dark.png new file mode 100644 index 0000000..20be965 Binary files /dev/null and b/testdata/snapshots/darwin/service_status-dark.png differ diff --git a/testdata/snapshots/darwin/service_status-light.png b/testdata/snapshots/darwin/service_status-light.png new file mode 100644 index 0000000..0f232c8 Binary files /dev/null and b/testdata/snapshots/darwin/service_status-light.png differ