# Architecture & Design

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

---

This directory contains core architecture and design documents.

## Documents

- **[CLIENT_DIVISION_TERMINOLOGY.md](CLIENT_DIVISION_TERMINOLOGY.md)** ⭐⭐⭐ - Canonical Phoenix / Sankofa / Gitea client and division terminology; reserved-word policy for `realm`, `tenant`, and `site`
- **[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

**Client / Division Model:**
- `Client` = GitHub Enterprise = Azure billing profile = current Gitea Organization
- `Division` = generic subdivision below Client
- `Tenant` = technical isolation only
- `Site` = infrastructure location only

## 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