RIAT Network Documentation

This site documents the RIAT network deployment: topology, device configurations, IP allocations, setup procedures, and automation.

Quick reference

Area	Summary
Subnets	7 defined — see IPAM
VLANs	7 VLANs — see VLANs
Internet uplinks	3 connections — see Internet Connections

Data files

All structured data lives under data/ and is the single source of truth:

File	Purpose
data/ipam.yaml	Subnet definitions and IP allocations
data/devices.yaml	Device inventory (firewalls, switches, APs, etc.)
data/vlans.yaml	VLAN definitions and trunk membership

Scripts in scripts/ and Ansible inventory in ansible/inventory/ are generated from these files.

Structure

riat/
├── data/          # Single source of truth (YAML)
├── docs/          # This documentation (MkDocs source)
├── ansible/       # Ansible playbooks and inventory
└── scripts/       # Python tools (UV-managed)