PRJ-NETWORK-DIAGRAM-LIBRARY — Enterprise Network Diagrams

Project Summary

Project

Enterprise Network Diagram Library

Priority

P1

Status

Active — scaffolding

Owner

Evan Rosado

Stakeholders

InfoSec team, Network Engineering, Management

Format

D2 (source) → SVG/PNG (rendered via Kroki)

Repository

domus-infra-ops (diagrams), domus-captures (project governance)

Purpose

Replace ad-hoc Visio diagrams with version-controlled, docs-as-code network documentation. D2 source files produce consistent, themed diagrams that live alongside infrastructure documentation. Every diagram has a git history, is diffable, and renders automatically through the Antora build pipeline.

Diagram Layers

Layer OSI Scope Examples

L1 Physical

Physical

Rack elevations, IDF/MDF layouts, cable paths, datacenter floor plans

IDF closet layout, datacenter rack diagram, patch panel mapping

L2 Switching

Data Link

VLAN topology, trunk links, spanning tree domains, port channels, 802.1X enforcement points

VLAN map, STP root bridge topology, EtherChannel layout

L3 Routing

Network

Subnets, gateways, routing protocols, VPN tunnels, NAT boundaries

Core routing topology, VPN overlay, subnet allocation map

L4 Services

Transport

Firewall rule visualization, load balancer pools, NAT policies, port mappings

Firewall zone diagram, load balancer topology, NAT translation map

L7 Application

Application

Service dependencies, DNS/DHCP/RADIUS flows, SIEM data paths, mail flow, API call chains

ISE auth flow, SIEM ingestion pipeline, Abnormal Security mail flow, Monad ETL path

Existing D2 Diagrams (migration candidates)

Diagram Location

Home network topology

domus-captures: images/diagrams/d2/network/

ISE distributed deployment

domus-captures: images/diagrams/d2/architecture/

Rack switch mapping

domus-captures: images/diagrams/d2/network/

Research VLAN justification

domus-captures: images/diagrams/d2/network/

Monad architecture

domus-captures: images/diagrams/d2/architecture/

AD OU structure

domus-infra-ops: images/diagrams/

Infrastructure HA topology

domus-infra-ops: images/diagrams/.archive/

Delivery

  • Internal review: SVG rendered in Antora site (docs.domusdigitalis.dev or local build)

  • Presentation: PNG export for slides and email

  • Handoff: D2 source in git — team can read the text representation even without rendering

  • Updates: Edit D2 text → commit → auto-renders on build. No dragging boxes.

Metadata

Field Value

PRJ ID

PRJ-2026-04-network-diagram-library

Author

Evan Rosado

Created

2026-04-12

Updated

2026-04-12

Status

Active

Category

Network Documentation

Priority

P1

Tools

D2, Mermaid, Graphviz (via Kroki)

Theme

Catppuccin Mocha (Domus Antora UI)