# Architecture & Design

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

This directory contains core architecture and design documents.

## Documents

- **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** ⭐⭐⭐ - Complete network architecture with 6×/28 blocks, VLANs, NAT pools
- **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** ⭐⭐⭐ - Enterprise-grade deployment orchestration guide
- **[VMID_ALLOCATION_FINAL.md](VMID_ALLOCATION_FINAL.md)** ⭐⭐⭐ - Complete VMID allocation registry (11,000 VMIDs)

## Quick Reference

**Network Architecture:**
- 6× /28 public IP blocks with role-based NAT pools
- 19 VLANs with complete subnet plan
- Hardware role assignments (2× ER605, 3× ES216G, 1× ML110, 4× R630)

**Deployment Orchestration:**
- Phase-by-phase deployment workflow
- CCIP fleet deployment matrix (41-43 nodes)
- Proxmox cluster orchestration

## Related Documentation

- **[../03-deployment/](../03-deployment/)** - Deployment guides
- **[../04-configuration/](../04-configuration/)** - Configuration guides
- **[../05-network/](../05-network/)** - Network infrastructure details
- **[../07-ccip/](../07-ccip/)** - CCIP deployment specification