diff --git a/README.md b/README.md
index ebec010..b4ef7ca 100644
--- a/README.md
+++ b/README.md
@@ -106,17 +106,30 @@ Ping-only (no node_exporter): **pbs** (10.10.10.3)
## Pages
### Dashboard (`/`)
+- **Needs attention** at the top gathers what every page would flag into two lists, each line linking to
+ where it is fixed:
+ - *Broken now*: active alerts (one line, with the devices), an outlet that is off but feeds a device,
+ frozen outlet readings, and cables not where the cutsheet says.
+ - *Tidy up*: UniFi port names pointing at the wrong device or at an empty port, live links not on the
+ cutsheet, labels to print, powered outlets with no device assigned, and rack items that overlap or sit
+ outside the rack.
+
+ Served by `GET /api/attention` (`attention.py`) and refreshed with the rest of the page.
- Device search (see Device pages below)
-- Active alerts first, then the WAN / Fiber panel, hosts, UniFi devices, and recently resolved alerts
-- Real-time host status grid with per-NIC link state (UP / DOWN / degraded)
-- WAN / Fiber panel: WAN and PON state, Rx/Tx power, optics temperature, throughput, errors, gateway uptime and last restart, 7-day Rx trend, recent WAN outages
-- UniFi device table (switches, APs, gateway)
- Active alerts table with severity, target, consecutive failures, ticket link
+- WAN / Fiber panel: WAN and PON state, Rx/Tx power, optics temperature, throughput, errors, gateway uptime and last restart, 7-day Rx trend, recent WAN outages
+- Hosts with per-NIC link state; NICs marked unused fold into a "+N unused" line
+- UniFi devices as a compact list (name and model; offline ones turn red with a suppress button)
+- Recently resolved alerts, folded until opened
- Follow-up flags (see Follow-up below): a ⏳ badge on alerts active for days, a "ticket closed" badge when the
ticket was closed but the alert is still active, and a Needs Follow-up panel of tickets left open after their
alert cleared. A "TO FOLLOW UP" chip in the status bar counts them all.
-- Quick-suppress modal: apply timed or manual suppression from any alert row
-- Auto-refreshes every 30 seconds via `/api/status` + `/api/network`
+- Quick-suppress modal: apply timed or manual suppression from any alert row or host card
+- Auto-refreshes every 30 seconds via `/api/status` + `/api/network` + `/api/attention`
+
+The header spells out the name; the navigation keeps Dashboard, Topology, Rack and Cutsheet in view, with
+Alert history and Suppressions under **More** (and in the command palette, Ctrl+K). On a phone the drawer
+holds every page and Start maintenance.
### Alert history (`/events`)
Every alert Gandalf raised in the last 24 hours to 90 days, including ones that cleared before anyone
@@ -185,9 +198,11 @@ The rack front, drawn from the rack units set on cutsheet items, top first.
The whole network as the switches see it now, top down: the internet, the modem, the gateway, then
each switch by how many hops it is from the gateway, the gear and unknown devices below them, and the
servers along the bottom. Power gear (PDU, UPS, power strip) sits in a rail on the right.
-- **What needs a look** is listed above the diagram: devices down, degraded or with active alerts,
- cables down or last seen elsewhere, ports named after the wrong device, and cables with errors.
- Click one to jump to it. With nothing to report it says all clear. Problem cables are drawn in full
+- **What needs a look** sits above the diagram as one line ("7 to look at" and the first two):
+ devices down, degraded or with active alerts, cables down or last seen elsewhere, ports named after
+ the wrong device, and cables with errors. Open it to list them all and click one to jump to it; it
+ remembers whether it was open. With nothing to report it says all clear. The how-to hides behind the
+ **?** next to the page intro. Problem cables are drawn in full
colour with a glow and always shown, whatever the filters; healthy cables are drawn quietly.
- **A card per device**, all the same height so the whole network reads at a glance: name, state
(coloured edge and dot), and a picture: UniFi gear shows its real faceplate (the same drawings as the
@@ -339,8 +354,13 @@ entry in `FACEPLATES`.
Where every cable is meant to go, checked against what Gandalf actually sees. Anyone who can log in
can view it; only the `admin` group can edit, and every change is logged with who made it and when.
+The page has five tabs, each with its count: **Cables**, **To do** (undocumented links, port names
+in UniFi, labels to make), **Patch panels**, **Inventory** and **History**. A link to a section, cable
+or item (`/cutsheet#cable-7`, `#cs-portnames-section`) opens the tab that holds it, and
+`/cutsheet?problems=1` opens the cables with problems. Printing prints every tab.
+
- **Inventory**: things discovery can't see: patch panels, wall jacks, shelves, and rack positions
- for devices (use a device's exact Gandalf name). Panels and jacks are passive: a cable on a
+ for devices (use a device's exact Gandalf name). The rack page draws them. Panels and jacks are passive: a cable on a
port's front continues through the same port's rear.
- **Cables**: two endpoints each (device or item, port, and front/rear for panels and jacks), plus
ID, type, length, color, status (`planned`, `installed`, `dark`, `retired`) and notes. Leave the
diff --git a/app.py b/app.py
index 27ff38a..3421f8a 100644
--- a/app.py
+++ b/app.py
@@ -22,6 +22,7 @@ from urllib.parse import quote, urlparse
from flask import Flask, jsonify, make_response, redirect, render_template, request, send_file, url_for
+import attention
import cutsheet
import db
import devices
@@ -1335,6 +1336,32 @@ def api_topology():
return jsonify(_topology_graph(events, sheet, feeds))
+@app.route('/api/attention')
+@require_auth
+def api_attention():
+ """Everything that needs looking at, from every page, for the dashboard (see attention.build)."""
+ return jsonify(_attention())
+
+
+def _attention() -> dict:
+ events = db.get_active_events(limit=_PAGE_LIMIT)
+ _annotate_suppressions(events, db.get_active_suppressions())
+ view, racks, feeds = None, {}, []
+ try:
+ view = _cutsheet_view()
+ feeds = db.get_power_feeds()
+ all_racks = _racks(view['items'])
+ for rack in all_racks:
+ here = [i for i in view['items'] if not i.get('shelf')
+ and (i.get('rack') or all_racks[0]['name']) == rack['name']]
+ racks[rack['name']] = cutsheet.rack_layout(here, rack['units'])
+ except Exception as e:
+ logger.error(f'Cutsheet unavailable for the attention list: {e}')
+ sheet = {'items': (view or {}).get('items') or [], 'cables': (view or {}).get('cables') or []}
+ power = _topology_graph(events, sheet, feeds).get('power') or []
+ return attention.build(events, power, view, racks)
+
+
def _topology_graph(events: list, sheet: dict, feeds: list) -> dict:
return topology.build_graph(
_state_json('network_snapshot'), _state_json('link_stats'), _state_json('modem_stats'),
diff --git a/attention.py b/attention.py
new file mode 100644
index 0000000..fc00f65
--- /dev/null
+++ b/attention.py
@@ -0,0 +1,122 @@
+"""What needs looking at, gathered from every page into one list for the dashboard.
+
+Two groups: 'broken' is something not working right now; 'tidy' is housekeeping, where
+the network works but the records or names don't match it. Each entry links to the page
+where it is fixed. Pure functions, so the rules are easy to test.
+"""
+from typing import Dict, List, Optional
+
+GROUPS = ('broken', 'tidy')
+
+
+def _plural(n: int, one: str, many: Optional[str] = None) -> str:
+ return f'{n} {one if n == 1 else (many or one + "s")}'
+
+
+def _entry(group: str, severity: str, text: str, href: str, detail: str = '') -> dict:
+ return {'group': group, 'severity': severity, 'text': text, 'href': href, 'detail': detail}
+
+
+def _alerts(events: List[dict]) -> List[dict]:
+ live = [e for e in events if not e.get('is_suppressed') and e.get('severity') != 'info']
+ if not live:
+ return []
+ critical = sum(1 for e in live if e.get('severity') == 'critical')
+ targets = sorted({str(e.get('target_name') or '') for e in live if e.get('target_name')}, key=str.lower)
+ text = _plural(len(live), 'active alert')
+ if critical:
+ text += f' ({critical} critical)'
+ shown = ', '.join(targets[:4]) + (f' and {len(targets) - 4} more' if len(targets) > 4 else '')
+ return [_entry('broken', 'bad' if critical else 'warn', text, '#events-table-wrap', shown)]
+
+
+def _power(power: List[dict]) -> List[dict]:
+ out = []
+ for src in power or []:
+ name = src.get('node') or ''
+ if src.get('stale_since'):
+ out.append(_entry('broken', 'warn', f'{name}: outlet watts are frozen', '/topology',
+ 'UniFi keeps sending the same per-outlet readings; the total is still live. '
+ 'Restarting the unit usually clears it.'))
+ for o in src.get('outlets') or []:
+ if not o.get('on') and o.get('target'):
+ out.append(_entry('broken', 'bad', f'{name} outlet {o.get("index")} is off, and it feeds {o["target"]}',
+ '/topology'))
+ idle = []
+ for src in power or []:
+ for o in src.get('outlets') or []:
+ # Drawing real power, but nothing in Gandalf says what is plugged in
+ if o.get('on') and not o.get('target') and o.get('match') != 'cleared' and (o.get('power_w') or 0) >= 5:
+ idle.append(f'{src.get("node")} {o.get("index")}')
+ if idle:
+ out.append(_entry('tidy', 'info', f'{_plural(len(idle), "powered outlet")} with no device assigned',
+ '/topology', ', '.join(idle[:6]) + (' ...' if len(idle) > 6 else '')))
+ return out
+
+
+def _cutsheet(view: dict) -> List[dict]:
+ out = []
+ cables = [c for c in view.get('cables') or [] if c.get('status') != 'retired']
+ bad = [c for c in cables if c.get('problem')]
+ if bad:
+ names = ', '.join(c.get('label') or f'#{c["id"]}' for c in bad[:5])
+ out.append(_entry('broken', 'bad', f'{_plural(len(bad), "cable")} not where the cutsheet says',
+ '/cutsheet?problems=1#cs-cables-section', names))
+
+ names = view.get('port_names') or []
+ wrong = [r for r in names if r.get('kind') in ('wrong', 'moved')]
+ if wrong:
+ out.append(_entry('tidy', 'warn', f'{_plural(len(wrong), "UniFi port name")} pointing at the wrong device',
+ '/cutsheet#cs-portnames-section',
+ ', '.join(f'{r["switch"]} port {r["port_idx"]} "{r["port_name"]}"' for r in wrong[:3])))
+ empty = [r for r in names if r.get('kind') == 'empty']
+ if empty:
+ out.append(_entry('tidy', 'info', f'{_plural(len(empty), "named port")} with nothing plugged in',
+ '/cutsheet#cs-portnames-section',
+ ', '.join(f'"{r["port_name"]}"' for r in empty[:4])))
+
+ missing = view.get('suggestions') or []
+ if missing:
+ out.append(_entry('tidy', 'info', f'{_plural(len(missing), "live link")} not on the cutsheet',
+ '/cutsheet#cs-suggest-section'))
+
+ labels = view.get('labels') or {}
+ todo = len(labels.get('cables') or []) + len(labels.get('ports') or [])
+ if todo:
+ out.append(_entry('tidy', 'info', f'{_plural(todo, "label")} to print and stick on',
+ '/cutsheet#cs-labels-section'))
+ return out
+
+
+def _rack(issues: Dict[str, dict]) -> List[dict]:
+ out = []
+ for rack, r in (issues or {}).items():
+ for o in r.get('overlaps') or []:
+ out.append(_entry('tidy', 'warn', f'{o["name"]} overlaps {", ".join(o["with"])} at {o["units"]}',
+ '/cutsheet#cs-items-section', rack))
+ for o in r.get('outside') or []:
+ out.append(_entry('tidy', 'warn', f'{o["name"]} at {o["units"]} is outside {rack}',
+ '/cutsheet#cs-items-section'))
+ return out
+
+
+def build(events: List[dict], power: List[dict], cutsheet_view: Optional[dict],
+ rack_issues: Optional[Dict[str, dict]] = None) -> dict:
+ """{'broken': [entry], 'tidy': [entry]}, worst first within each group.
+
+ events: active alerts, annotated with 'is_suppressed'. power: topology.build_power output.
+ cutsheet_view: the cutsheet API view (cables with 'problem', suggestions, port_names,
+ labels), or None when the cutsheet couldn't be loaded. rack_issues: {rack: rack_layout()}.
+ Entry: {group, severity: bad|warn|info, text, href, detail}.
+ """
+ entries = _alerts(events) + _power(power)
+ if cutsheet_view is not None:
+ entries += _cutsheet(cutsheet_view)
+ entries += _rack(rack_issues or {})
+ rank = {'bad': 0, 'warn': 1, 'info': 2}
+ out = {g: [] for g in GROUPS}
+ for e in entries:
+ out[e['group']].append(e)
+ for g in GROUPS:
+ out[g].sort(key=lambda e: rank[e['severity']])
+ return out
diff --git a/static/app.js b/static/app.js
index 4c50b1b..86a6fe1 100644
--- a/static/app.js
+++ b/static/app.js
@@ -43,6 +43,7 @@ async function refreshAll() {
lt.api.get('/api/network'),
lt.api.get('/api/status'),
refreshModem(),
+ refreshAttention(),
]);
if (netResult.status === 'fulfilled') {
const net = netResult.value;
@@ -68,6 +69,40 @@ async function refreshAll() {
}
}
+// ── Needs attention ───────────────────────────────────────────────────
+const ATTENTION_GROUPS = [
+ { key: 'broken', title: 'Broken now', clear: 'Nothing broken' },
+ { key: 'tidy', title: 'Tidy up', clear: 'Records match the network' },
+];
+
+async function refreshAttention() {
+ const body = document.getElementById('attention-body');
+ if (!body) return;
+ try {
+ renderAttention(body, await lt.api.get('/api/attention'));
+ } catch (e) {
+ body.innerHTML = `
Couldn't gather the list: ${lt.escHtml(e.message || e)}
@@ -81,43 +86,37 @@
class="lt-brand-title lt-glitch"
data-text="GANDALF"
aria-label="GANDALF home">GANDALF
- Network Monitor // LotusGuild
+ Global Advanced Network Detection And Link Facilitator
-
+
@@ -229,7 +228,7 @@
|
- GANDALF | TDS v1.2
+ GANDALF: Global Advanced Network Detection And Link Facilitator | TDS v1.2
{% if user.groups and 'admin' in user.groups and not maintenance %}
@@ -331,6 +330,7 @@
+
GANDALF: Global Advanced Network Detection And Link Facilitator. It watches the UniFi switches and the hosts' links, works out what is plugged in where, and raises a ticket when something breaks.
Shortcut
Action
@@ -417,6 +417,20 @@
]);
}
+ // ── More menu: close on a click elsewhere or Escape ───────────────────
+ document.addEventListener('click', function(e) {
+ document.querySelectorAll('.g-nav-more[open]').forEach(function(d) {
+ if (!d.contains(e.target)) d.removeAttribute('open');
+ });
+ });
+ document.addEventListener('keydown', function(e) {
+ if (e.key !== 'Escape') return;
+ document.querySelectorAll('.g-nav-more[open]').forEach(function(d) {
+ d.removeAttribute('open');
+ d.querySelector('summary').focus();
+ });
+ });
+
// ── Global footer + key actions ───────────────────────────────────────
document.addEventListener('click', function(e) {
const btn = e.target.closest('[data-action]');
diff --git a/templates/cutsheet.html b/templates/cutsheet.html
index 6bc5598..42d8930 100644
--- a/templates/cutsheet.html
+++ b/templates/cutsheet.html
@@ -5,7 +5,7 @@
Cutsheet
-
Where every cable is meant to go, checked against what Gandalf sees on the network.
+
Where every cable is meant to go, checked against the live network.
{% if can_edit %}
@@ -17,111 +17,119 @@
-
+
+
+
+
+
+
+
-
-
-
Cables
- 0
-
-
-
-
-
-
-
-
-
-
-
-
Undocumented links
- 0
-
-
Switch ports with a live link that no cable record mentions. Adding one pre-fills what Gandalf already knows; insert the patch panel hop if the cable runs through one.
-
-
-
-
-
-
Port names in UniFi
- 0
-
-
Switch port names that no longer fit what is plugged in, as a checklist. Rename them in UniFi: Gandalf only reports them and never changes UniFi.
-
-
-
-
-
-
Patch panels
-
- {% if can_edit %}
-
- ╚╝
-
Trace a cord
-
-
Find which switch port a panel port's cord goes to: start, then unplug that cord at the panel.
- Gandalf watches every switch port and shows the one that drops. Plug it back in afterwards. The device on it
- loses its link for those few seconds.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
Cables
+ 0
-
- {% endif %}
-
-
+
+
+
+
+
+
+
+
+
-
-
-
Labels to make
- 0
-
-
-
Type these on the label maker. Cable IDs go on both ends of the cord; panel labels go on the port. Tick each one once it's stuck on.
-
-
+
+
+
+
Undocumented links
+ 0
+
+
Live switch ports no cable record mentions. Add pre-fills what Gandalf knows.
Names that no longer fit what is plugged in. Rename them in UniFi; Gandalf never changes UniFi.
+
+
-
-
-
Inventory
- 0
-
-
Things Gandalf can't discover: patch panels, wall jacks, shelves, and rack positions for devices.
-
-
+
+
+
Labels to make
+ 0
+
+
+
Cable IDs go on both ends of the cord, panel labels on the port. Tick each once it's stuck on.
+
+
+
-
-
-
History
-
-
-
+
+
+
+
Patch panels
+
+ {% if can_edit %}
+
+ ╚╝
+
Trace a cord
+
+
Press Start, then unplug the panel port's cord: the switch port that drops is where it goes.
+ The device on it loses its link until you plug it back in.
{% for e in recent_resolved %}
{%- set dot_cls = 'lt-timeline-item--green' if e.severity == 'info' else 'lt-timeline-item--dim' -%}
@@ -361,7 +292,7 @@
The rack front, drawn from the rack units on the cutsheet with live port state. Hover a port to light up every port on the same cable run; click it to open the port or the cable.
+
The rack, drawn from the cutsheet with live port state.
+ ?Hover a port to light up every port on the same cable run; click it to open the port or the cable.
Every device and cable as the switches see them right now. Drag to pan, scroll or pinch to zoom. Hover a device to trace its path to the internet and its power (on a touch screen, tap it once to trace and again to open it); click a cable for its details, or a group of unknown devices to open it.
+
Every device and cable, as the switches see them now.
+ ?Drag to pan; scroll or pinch to zoom. Hover a device to trace its path to the internet and its power (on a touch screen, tap once to trace and again to open it). Click a cable for its details, or a group of unknown devices to open it.
diff --git a/tests/test_app.py b/tests/test_app.py
index e87b70e..e7eae05 100644
--- a/tests/test_app.py
+++ b/tests/test_app.py
@@ -95,10 +95,12 @@ class TestPagesAndNav:
def test_home_section_order(self, client):
html = client.get('/', headers=AUTH).get_data(as_text=True)
order = [html.index(m) for m in (
- 'id="device-search"', 'Alert Queue', 'WAN / Fiber', 'g-section-title">Hosts<',
- 'Device Inventory',
+ 'id="attention"', 'id="device-search"', 'Alert Queue', 'WAN / Fiber', 'g-section-title">Hosts<',
+ 'id="unifi-grid"',
)]
assert order == sorted(order)
+ # The needs-attention list replaced the stat cards
+ assert 'lt-stat-card' not in html
def test_dashboard_topology_moved_to_its_own_page(self, client):
html = client.get('/', headers=AUTH).get_data(as_text=True)
@@ -792,3 +794,52 @@ class TestPowerFeedApi:
resp = client.put('/api/topology/power/RPDU/7', data='target=large1', headers=AUTH,
content_type='application/x-www-form-urlencoded')
assert resp.status_code == 400
+
+
+class TestAttention:
+ def test_needs_auth(self, client):
+ assert client.get('/api/attention').status_code == 401
+
+ def test_gathers_every_page(self, client):
+ gandalf._cutsheet_schema_ready = True
+ ev = {'id': 1, 'event_type': 'host_down', 'severity': 'critical', 'target_name': 'large1',
+ 'target_detail': '', 'description': ''}
+ with patch.object(gandalf.db, 'cutsheet_load', return_value={'items': [], 'cables': [], 'port_labels': []}), \
+ patch.object(gandalf.db, 'get_active_events', return_value=[ev]), \
+ patch.object(gandalf.db, 'get_power_feeds', return_value=[]), \
+ patch.object(gandalf.db, 'cutsheet_racks', return_value=[]), \
+ patch.object(gandalf.db, 'check_suppressed', return_value=False):
+ data = client.get('/api/attention', headers=AUTH).get_json()
+ assert set(data) == {'broken', 'tidy'}
+ assert data['broken'][0]['text'] == '1 active alert (1 critical)'
+
+ def test_survives_a_cutsheet_failure(self, client):
+ gandalf._cutsheet_schema_ready = True
+ with patch.object(gandalf.db, 'cutsheet_load', side_effect=RuntimeError('db down')):
+ resp = client.get('/api/attention', headers=AUTH)
+ assert resp.status_code == 200
+ assert set(resp.get_json()) == {'broken', 'tidy'}
+
+ def test_dashboard_has_the_list_and_says_what_gandalf_stands_for(self, client):
+ html = client.get('/', headers=AUTH).get_data(as_text=True)
+ assert 'id="attention-body"' in html
+ assert 'Global Advanced Network Detection And Link Facilitator' in html
+
+
+class TestCalmDashboard:
+ def test_unused_nics_fold_into_one_line(self, client):
+ snap = json.dumps({'hosts': {'large1': {'ip': '10.0.0.2', 'status': 'up', 'source': 'prometheus',
+ 'interfaces': {'eth0': 'up', 'eth1': 'unused', 'eth2': 'unused'}}},
+ 'unifi': []})
+ state = dict(STATE, network_snapshot=snap)
+ with patch.object(gandalf.db, 'get_state', side_effect=lambda k, d=None: state.get(k, d)):
+ html = client.get('/', headers=AUTH).get_data(as_text=True)
+ assert '>eth0<' in html and '>eth1<' not in html
+ assert '+2 unused' in html
+
+ def test_resolved_alerts_are_folded(self, client):
+ ev = {'target_name': 'large1', 'target_detail': '', 'severity': 'warning', 'event_type': 'host_down',
+ 'first_seen': '2026-11-15 01:00:00 UTC', 'resolved_at': '2026-11-15 02:00:00 UTC'}
+ with patch.object(gandalf.db, 'get_recent_resolved', return_value=[ev]):
+ html = client.get('/', headers=AUTH).get_data(as_text=True)
+ assert '' in html
diff --git a/tests/test_attention.py b/tests/test_attention.py
new file mode 100644
index 0000000..5703e06
--- /dev/null
+++ b/tests/test_attention.py
@@ -0,0 +1,86 @@
+"""The dashboard's "Needs attention" list (attention.py)."""
+import attention
+
+
+def _alert(target, severity='critical', **kw):
+ return dict({'target_name': target, 'severity': severity, 'is_suppressed': False}, **kw)
+
+
+def _outlet(index, on=True, target=None, power_w=10.0, match=None):
+ return {'index': index, 'on': on, 'target': target, 'power_w': power_w,
+ 'match': match or ('name' if target else 'none')}
+
+
+class TestAlerts:
+ def test_one_line_for_all_alerts_with_the_targets(self):
+ out = attention.build([_alert('pbs'), _alert('24RJ45-POE', 'warning')], [], None)
+ [line] = out['broken']
+ assert line['text'] == '2 active alerts (1 critical)'
+ assert line['severity'] == 'bad'
+ assert line['detail'] == '24RJ45-POE, pbs'
+ assert line['href'] == '#events-table-wrap'
+
+ def test_suppressed_and_info_alerts_are_left_out(self):
+ events = [_alert('pbs', is_suppressed=True), _alert('large1', 'info')]
+ assert attention.build(events, [], None)['broken'] == []
+
+ def test_warnings_only_is_amber(self):
+ [line] = attention.build([_alert('x', 'warning')], [], None)['broken']
+ assert line['severity'] == 'warn' and line['text'] == '1 active alert'
+
+
+class TestPower:
+ def test_frozen_readings_and_an_off_outlet_feeding_a_device(self):
+ power = [{'node': 'RPDU', 'stale_since': '2026-11-15 05:26:54 UTC',
+ 'outlets': [_outlet(19, on=False, target='pbs'), _outlet(3, on=False)]}]
+ broken = attention.build([], power, None)['broken']
+ assert [b['text'] for b in broken] == ['RPDU outlet 19 is off, and it feeds pbs',
+ 'RPDU: outlet watts are frozen']
+
+ def test_powered_outlets_with_nothing_assigned(self):
+ power = [{'node': 'RPDU', 'outlets': [
+ _outlet(1, target='large1'), _outlet(2, power_w=40), _outlet(3, power_w=1),
+ _outlet(4, power_w=40, match='cleared'), _outlet(5, on=False, power_w=0)]}]
+ [line] = attention.build([], power, None)['tidy']
+ assert line['text'] == '1 powered outlet with no device assigned'
+ assert line['detail'] == 'RPDU 2'
+
+
+class TestCutsheet:
+ VIEW = {
+ 'cables': [{'id': 1, 'label': 'C01', 'status': 'installed', 'problem': True},
+ {'id': 2, 'label': 'C02', 'status': 'retired', 'problem': True},
+ {'id': 3, 'label': 'C03', 'status': 'installed', 'problem': False}],
+ 'suggestions': [{}, {}, {}],
+ 'port_names': [{'kind': 'wrong', 'switch': 'POE', 'port_idx': 11, 'port_name': 'Large1 Management'},
+ {'kind': 'empty', 'switch': 'POE', 'port_idx': 20, 'port_name': 'WAP'},
+ {'kind': 'unnamed', 'switch': 'POE', 'port_idx': 4, 'port_name': 'Port 4'}],
+ 'labels': {'cables': [{}, {}], 'ports': [{}]},
+ }
+
+ def test_every_cutsheet_todo(self):
+ out = attention.build([], [], self.VIEW)
+ assert [b['text'] for b in out['broken']] == ['1 cable not where the cutsheet says']
+ assert out['broken'][0]['detail'] == 'C01'
+ assert out['broken'][0]['href'].startswith('/cutsheet?problems=1')
+ tidy = {t['text']: t for t in out['tidy']}
+ assert set(tidy) == {'1 UniFi port name pointing at the wrong device', '1 named port with nothing plugged in',
+ '3 live links not on the cutsheet', '3 labels to print and stick on'}
+ assert tidy['1 UniFi port name pointing at the wrong device']['detail'] == 'POE port 11 "Large1 Management"'
+ # Worst first
+ assert out['tidy'][0]['severity'] == 'warn'
+
+ def test_unnamed_ports_alone_are_not_worth_a_line(self):
+ view = {'port_names': [{'kind': 'unnamed', 'switch': 'POE', 'port_idx': 4, 'port_name': 'Port 4'}]}
+ assert attention.build([], [], view) == {'broken': [], 'tidy': []}
+
+
+class TestRack:
+ def test_overlaps_and_items_outside_the_rack(self):
+ racks = {'Rack 1': {'overlaps': [{'name': 'NAS', 'units': 'U5-6', 'with': ['storage-01']}],
+ 'outside': [{'name': 'Shelf', 'units': 'U43'}]}}
+ texts = [t['text'] for t in attention.build([], [], None, racks)['tidy']]
+ assert texts == ['NAS overlaps storage-01 at U5-6', 'Shelf at U43 is outside Rack 1']
+
+ def test_nothing_to_report(self):
+ assert attention.build([], [], {}, {}) == {'broken': [], 'tidy': []}