Asset Register

Collects interface names, MAC addresses and non-loopback IPv4 addresses for the inventory payload. The code is shown as a complete function; its psutil dependency is imported elsewhere.

Source: agent/agent_core.py

def collect_network_interfaces():
    items = []
    for iface, addrs in psutil.net_if_addrs().items():
        mac = None
        ips = []
        for a in addrs:
            if getattr(a.family, "name", "") in ("AF_LINK", "AF_PACKET"):
                mac = a.address
            if getattr(a.family, "name", "") == "AF_INET" and not a.address.startswith("127."):
                ips.append(a.address)
        if mac or ips:
            items.append({"name": iface, "mac": mac, "ips": ips})
    return items

Excerpt from the inventory endpoint after device authentication and identity checks. Merges the incoming report with the previous payload and retains software or network inventory when that section was not successfully collected.

Source: server/app/api/agents.py

    previous = latest_payloads(db, [device.device_id]).get(device.device_id, {})
    incoming = body.model_dump(mode="json", exclude_unset=True, exclude_none=True)
    payload = dict(previous)
    payload.update(incoming)
    preserved = []
    for section in ("software", "network"):
        if not body.section_succeeded(section):
            preserved.append(section)
            if section in previous:
                payload[section] = previous[section]
            else:
                payload.pop(section, None)

Excerpt from list_devices. Applies the search term across hostname, device ID, serial number, model, operating system, IP and manufacturer fields. The surrounding function provides the database query and pagination.

Source: server/app/api/devices.py

    if query:
        like = f"%{query}%"
        q = q.filter(or_(
            models.Device.hostname.like(like),
            models.Device.device_id.like(like),
            models.Device.serial_number.like(like),
            models.Device.model.like(like),
            models.Device.os_family.ilike(like), models.Device.os_version.ilike(like),
            models.Device.last_ip.ilike(like), models.Device.manufacturer.ilike(like),
        ))

Maps time since the last report to Unknown, Online, Warning or Stale labels. This indicates reporting recency rather than a live connectivity test; minutesSince is defined elsewhere in the same file.

Source: web/src/pages/DevicesPage.jsx

function getStatus(lastSeenAt) {
  const mins = minutesSince(lastSeenAt);
  if (mins === null) return { label: "Unknown", severity: "default" };
  if (mins <= 60) return { label: "Online", severity: "success" };
  if (mins <= 24 * 60) return { label: "Warning", severity: "warning" };
  return { label: "Stale", severity: "error" };
}