Skip to content

Assets (CMDB)

Purpose

Central inventory of customer IT/OT assets: hardware, network identity, relationships, and enrichment from Edge discovery and (planned) Host Agents.

Boundaries

In scope	Out of scope
Asset CRUD, hierarchy, links	Full network topology UI (planned — `TODO.md`)
Merge by MAC from scanners/agents	Automatic CMDB sync to external tools (integrations separate)

Key components

Layer	Path
Backend domain	`Backend/internal/domain/assets/`
Frontend routes	`Frontend/src/` — assets module
Edge discovery ingest	`discovery` kind via Ingestor
Host Agent (planned)	`host_inventory` → MAC merge

Data

Assets table with tenant RLS, site scoping, source field (manual, edge scanner, host_agent, import).
Planned agent fields: has_agent, agent_host_id, agent_last_seen, agent_version.

Flow: discovery → asset

sequenceDiagram
    participant Edge as EdgeZu
    participant Ingest as Ingestor
    participant API as Cloud Backend
    participant DB as Azure SQL

    Edge->>Ingest: POST /v1/ingest kind=discovery
    Ingest->>DB: Persist event
    API->>DB: Process discovery → upsert Asset by MAC/IP

Debug scenarios

Issue	Where to look
Asset missing after scan	Ingestor logs; discovery payload; site mapping
Duplicate assets	Host Agent multi-NIC — asset merge
Wrong site	Edge device tenant vs asset site rules