Skip to content

Bra1n — Asset Documentation

Bra1n is m1nd's asset documentation system — a structured inventory for all your network infrastructure with relational links and monitor integration.

Asset Types

TypeDescriptionExample
SitesPhysical or logical locations"London DC", "Branch Office A"
LocationsAreas within a site"Server Room", "Floor 2"
EndpointsNetwork devices and hostsRouters, switches, servers
AssetsPhysical hardwareUPS, rack, cabling
ApplicationsSoftware servicesDNS server, web proxy
SubnetsIP address ranges10.0.1.0/24, 192.168.0.0/16

Relational Model

Assets are linked hierarchically:

  • Sites contain Locations
  • Endpoints belong to Sites and optionally Locations
  • Subnets are associated with Sites
  • Applications link to Sites
  • Assets link to Sites and Locations
  • Endpoints can reference Credentials for SNMP/SSH access

Key Features

Short IDs

Human-readable asset identifiers for quick reference:

  • EP-001 (Endpoint)
  • ST-003 (Site)
  • SN-012 (Subnet)

Search across all Bra1n asset types from the topbar — finds endpoints, sites, subnets, and more in one query.

Monitor Integration

  • Endpoint detail shows all linked monitors with live status
  • Monitor auto-fill — selecting a Bra1n endpoint auto-populates IP, name, location, and check type
  • Bidirectional links — navigate from monitor to endpoint and back

V1sion Integration

  • Link V1sion topology nodes to Bra1n endpoints
  • Create new endpoints directly from the topology canvas
  • Brain dot indicator on V1sion nodes shows link status

CRUD Operations

All asset types support full create, read, update, and delete operations from the web UI:

  • Grid/List views with filtering and sorting
  • Detail panel with full asset information
  • Add/Edit forms with foreign key lookups (site, location, credential)
  • Single delete with confirmation dialog
  • Bulk delete with multi-select and confirmation
  • Credential management with write-only secret fields (community strings, passwords, SNMP keys)

Released under the MIT License.