# TASK: Phase 2 — Monitoring Warnings, Dashboard Alerts & Notification System
**Version target:** 0.7.1
**Repos:** `deploy-felhom-compose` (controller) + `felhom.eu` (notification-relay on k3s)
## Overview
Three workstreams in this phase:
1. **Monitoring page warnings** — Show healthcheck ping configuration status, warn about missing UUIDs
2. **Dashboard alert system** — Persistent in-app banners for active issues/warnings
3. **Notification system** — Central email relay on k3s + customer-side preferences UI
---
## 1. Monitoring Page: Healthcheck Ping Status
### 1.1 Problem
The monitoring page shows system metrics but doesn't indicate whether healthcheck pings are actually configured. If a ping UUID is empty or `CHANGEME`, the pinger silently skips it — the customer has no visibility into whether remote monitoring is working.
### 1.2 New section: "Távoli monitoring" (Remote Monitoring)
Add a new section to `monitoring.html` **between** "Rendszer áttekintés" and "Rendszer metrikák" (section 1 and 2). This section is server-rendered (not JS/API — ping config is static and known at page load).
Display a table showing each healthcheck ping's configuration status:
| Ellenőrzés | UUID státusz | Gyakoriság |
|---|---|---|
| 💓 Életjel (Heartbeat) | ✅ Beállítva | 5 percenként |
| 🖥️ Rendszer állapot | ✅ Beállítva | 5 percenként |
| 🗄️ Adatbázis mentés | ⚠️ Nincs beállítva | Naponta 02:30 |
| 💾 Biztonsági mentés | ✅ Beállítva | Naponta 03:00 |
| 🔍 Mentés integritás | ⚠️ Nincs beállítva | Hetente (vasárnap) |
**Logic for each row:**
- Read `monitoring.ping_uuids.*` from config
- UUID is "configured" if: non-empty AND doesn't start with `CHANGEME`
- If configured: show `✅ Beállítva` (green text)
- If not configured: show `⚠️ Nincs beállítva` (yellow/orange warning text)
- If monitoring is disabled entirely (`monitoring.enabled = false`): show a single warning banner instead of the table: "A távoli monitoring ki van kapcsolva. Az üzemeltető nem kap értesítést hibák esetén."
**Summary banner above the table:**
- All configured: green banner — "✅ Minden távoli monitoring aktív — az üzemeltető értesítést kap hibák esetén."
- Some missing: yellow banner — "⚠️ Egyes monitoring ellenőrzések nincsenek beállítva. Kérd az üzemeltetőt a konfiguráláshoz."
- Monitoring disabled: red/orange banner — as above
### 1.3 Data flow
Add a new template data struct for the monitoring handler:
```go
type MonitoringPageData struct {
// Existing fields...
SystemInfo *system.Info
ActivePage string
// New: healthcheck ping status
MonitoringEnabled bool
PingStatus []PingStatusItem
AllPingsConfigured bool
}
type PingStatusItem struct {
Label string // Hungarian display name
Icon string // emoji
Configured bool // UUID is valid
Schedule string // "5 percenként" / "Naponta 02:30" etc.
}
```
Build `PingStatus` slice in the handler from `cfg.Monitoring.PingUUIDs`:
```go
pings := []PingStatusItem{
{Label: "Életjel (Heartbeat)", Icon: "💓", Configured: isConfigured(cfg.Monitoring.PingUUIDs.Heartbeat), Schedule: "5 percenként"},
{Label: "Rendszer állapot", Icon: "🖥️", Configured: isConfigured(cfg.Monitoring.PingUUIDs.SystemHealth), Schedule: "5 percenként"},
{Label: "Adatbázis mentés", Icon: "🗄️", Configured: isConfigured(cfg.Monitoring.PingUUIDs.DBDump), Schedule: "Naponta " + cfg.Backup.DBDumpSchedule},
{Label: "Biztonsági mentés", Icon: "💾", Configured: isConfigured(cfg.Monitoring.PingUUIDs.Backup), Schedule: "Naponta " + cfg.Backup.ResticSchedule},
{Label: "Mentés integritás", Icon: "🔍", Configured: isConfigured(cfg.Monitoring.PingUUIDs.BackupIntegrity), Schedule: "Hetente (vasárnap)"},
}
func isConfigured(uuid string) bool {
return uuid != "" && !strings.HasPrefix(uuid, "CHANGEME")
}
```
### 1.4 CSS
Reuse existing `.settings-row` / `.sysinfo-row` pattern for the table. Add:
- `.ping-status-ok` — green text (same as `.state-text-green`)
- `.ping-status-warn` — orange/yellow text
- `.monitoring-banner` — full-width banner with icon, green/yellow/red variants
---
## 2. Dashboard Alert System
### 2.1 Concept
Display persistent alert banners at the top of the main content area (below page header, above page content). Alerts are generated from the latest health check results and other events. They show on ALL pages, not just monitoring.
### 2.2 Alert sources
The controller already runs health checks every 5 minutes (`RunHealthCheck`). The resulting `HealthReport` contains `Issues` (critical) and `Warnings` (non-critical). Use these directly.
Additionally, generate alerts for:
- Missing healthcheck ping UUIDs (from section 1 above)
- Backup not configured (`backup.enabled = false`)
- Hub reporting not configured when it should be
- Recent backup failures (from backup manager state)
### 2.3 Implementation: Alert Manager
Create `internal/web/alerts.go`:
```go
type Alert struct {
ID string // unique, for dismiss tracking
Level string // "error", "warning", "info"
Message string // Hungarian text
Link string // optional link to relevant page (e.g., "/monitoring", "/backups")
LinkText string // "Részletek" etc.
}
type AlertManager struct {
mu sync.RWMutex
alerts []Alert
logger *log.Logger
}
```
**Alert generation** runs after each health check cycle (every 5 min):
```go
func (am *AlertManager) Refresh(healthReport *HealthReport, cfg *config.Config, backupMgr *backup.Manager) {
var alerts []Alert
// From health check issues
for _, issue := range healthReport.Issues {
alerts = append(alerts, Alert{
ID: "health-" + hash(issue), Level: "error",
Message: issue, Link: "/monitoring", LinkText: "Rendszermonitor",
})
}
// From health check warnings
for _, w := range healthReport.Warnings {
alerts = append(alerts, Alert{
ID: "health-" + hash(w), Level: "warning",
Message: w, Link: "/monitoring", LinkText: "Rendszermonitor",
})
}
// Missing ping UUIDs
missingCount := countMissingPings(cfg)
if missingCount > 0 {
alerts = append(alerts, Alert{
ID: "pings-missing", Level: "warning",
Message: fmt.Sprintf("%d monitoring ellenőrzés nincs beállítva", missingCount),
Link: "/monitoring", LinkText: "Rendszermonitor",
})
}
// Backup disabled
if !cfg.Backup.Enabled {
alerts = append(alerts, Alert{
ID: "backup-disabled", Level: "warning",
Message: "A biztonsági mentés nincs bekapcsolva",
Link: "/settings", LinkText: "Beállítások",
})
}
am.mu.Lock()
am.alerts = alerts
am.mu.Unlock()
}
```
### 2.4 Template integration
In `layout_start` template (or a new `alerts` partial), render alerts above the page content:
```html
{{if .Alerts}}
{{range .Alerts}}
{{if eq .Level "error"}}🔴{{else if eq .Level "warning"}}🟡{{else}}ℹ️{{end}}
{{.Message}}
{{if .Link}}
{{.LinkText}} →{{end}}
{{end}}