42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# 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
|