Acknowledge and hand over alerts, incident timelines, and built-in database backups
- Alerts can be acknowledged (note, assignee, duration); acknowledged alerts are left out of what needs attention (sidebar, dashboard strip, cards) but stay raised and counted by /metrics - Incidents: each time an alert is raised and goes away is recorded (alert_acks, alert_incidents, incident_notes, migration 0032), with a timeline of acks, maintenance, changes, update runs, related alerts and notes; Incidents page and a digest section - Backups of Homelab Manager's own database: daily checked VACUUM INTO copies, retention, download, check, upload, delete, and restore staged and applied at start-up before the database opens (pre-restore copy kept); alerts and /metrics for stale or failing backups - Docs: README, BACKUP, DATABASE, NOTIFICATIONS, ROLES, API; tests Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7a5b623444
commit
2744a84719
41 files changed
+6573
-26
No files matched your search
@@ -0,0 +1,51 @@
|
||||
import { Router } from "express";
|
||||
import { z } from "zod";
|
||||
import { requireAuth, requireRole } from "../auth/middleware.js";
|
||||
import { recordAudit } from "../services/audit.js";
|
||||
import { addNote, getIncident, listIncidents, MAX_NOTE, removeNote } from "../services/incidents.js";
|
||||
import { asyncHandler } from "../utils/asyncHandler.js";
|
||||
|
||||
export const incidentsRouter = Router();
|
||||
|
||||
// Everyone signed in can read what happened — it is made of what the Alerts page, the server pages and the Maintenance page already show.
|
||||
// Writing a note is for operators.
|
||||
incidentsRouter.use(requireAuth);
|
||||
|
||||
const idOf = (v: string) => (/^\d+$/.test(v) ? Number(v) : NaN);
|
||||
|
||||
incidentsRouter.get("/", asyncHandler(async (_req, res) => {
|
||||
res.json({ incidents: await listIncidents() });
|
||||
}));
|
||||
|
||||
incidentsRouter.get("/:id", asyncHandler(async (req, res) => {
|
||||
const id = idOf(req.params.id);
|
||||
if (!Number.isInteger(id)) return res.status(400).json({ error: "invalid_id" });
|
||||
const detail = await getIncident(id);
|
||||
if (!detail) return res.status(404).json({ error: "not_found" });
|
||||
res.json(detail);
|
||||
}));
|
||||
|
||||
const noteSchema = z.object({ body: z.string().trim().min(1, "Write something first.").max(MAX_NOTE) });
|
||||
|
||||
incidentsRouter.post("/:id/notes", requireRole("operator"), asyncHandler(async (req, res) => {
|
||||
const id = idOf(req.params.id);
|
||||
const parsed = noteSchema.safeParse(req.body);
|
||||
if (!Number.isInteger(id) || !parsed.success) return res.status(400).json({ error: "invalid_body", message: parsed.success ? undefined : parsed.error.issues[0]?.message });
|
||||
const actor = req.currentUser!;
|
||||
const note = await addNote(id, actor.name ?? actor.email ?? actor.oidcSub, parsed.data.body);
|
||||
if (!note) return res.status(404).json({ error: "not_found" });
|
||||
await recordAudit({ actor, category: "incident", action: "note", targetType: "incident", targetId: id });
|
||||
res.status(201).json({ id: note.id });
|
||||
}));
|
||||
|
||||
incidentsRouter.delete("/:id/notes/:noteId", requireRole("operator"), asyncHandler(async (req, res) => {
|
||||
const id = idOf(req.params.id);
|
||||
const noteId = idOf(req.params.noteId);
|
||||
if (!Number.isInteger(id) || !Number.isInteger(noteId)) return res.status(400).json({ error: "invalid_id" });
|
||||
const actor = req.currentUser!;
|
||||
const outcome = await removeNote(id, noteId, { name: actor.name ?? actor.email ?? actor.oidcSub, isAdmin: actor.role === "admin" });
|
||||
if (outcome === "not_found") return res.status(404).json({ error: "not_found" });
|
||||
if (outcome === "forbidden") return res.status(403).json({ error: "forbidden", message: "A note can be removed by the person who wrote it, or an administrator." });
|
||||
await recordAudit({ actor, category: "incident", action: "note_removed", targetType: "incident", targetId: id });
|
||||
res.status(204).end();
|
||||
}));
|
||||
Reference in new issue
Block a user