Files

defiQUG 61841b8291 feat(it-ops): live inventory, drift API, Keycloak IT role, portal sync hint

- Add scripts/it-ops (Proxmox collector, IPAM drift, export orchestrator)
- Add sankofa-it-read-api stub with optional CORS and refresh
- Add systemd examples for read API, weekly inventory export, timer
- Add live-inventory-drift GitHub workflow (dispatch + weekly)
- Add IT controller spec, runbooks, Keycloak ensure-it-admin-role script
- Note IT_READ_API env on portal sync completion output

Made-with: Cursor

2026-04-09 01:20:00 -07:00

AI_AGENTS_57XX_DEPLOYMENT_PLAN.md

Docs: validate MCP + identify curl examples, inventory_ratio convention, Redis key schema

2026-02-26 11:03:27 -08:00

AI_AGENTS_57XX_DEPLOYMENT_TASKS.md

chore: sync all changes to Gitea

2026-03-02 11:37:34 -08:00

AI_AGENTS_57XX_MCP_ADDENDUM.md

chore: update submodule references and documentation

2026-03-04 02:03:08 -08:00

AI_AGENTS_57XX_MCP_CONTRACTS_AND_CHAINS.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

ARCHITECTURAL_INTENT.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

ARCHITECTURE_FLEXIBILITY_MEMO.md

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

2026-02-12 15:46:57 -08:00

BRAND_RELATIONSHIP.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

COMPREHENSIVE_INFRASTRUCTURE_REVIEW.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

DBIS_NODE_ROLE_MATRIX.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

DBIS_PHASE2_PROXMOX_SOVEREIGNIZATION_ROADMAP.md

Finalize DBIS infra verification and runtime baselines

2026-03-28 19:18:32 -07:00

DBIS_WEB_AND_INSTITUTION_MASTER_BLUEPRINT.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

DOMAIN_STRUCTURE.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

EXPECTED_WEB_CONTENT.md

feat(sankofa): public web CT 7806, portal NPM/DNS defaults, Keycloak redirect helper

2026-03-29 13:41:02 -07:00

NETWORK_ARCHITECTURE.md

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

2026-02-12 15:46:57 -08:00

NON_GOALS.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

ORCHESTRATION_DEPLOYMENT_GUIDE.md

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

2026-02-12 15:46:57 -08:00

PHOENIX_API_RAILING_TASKS.md

docs: mark PHOENIX_API_RAILING_TASKS 4.2 and 5.4 complete; API task list status

2026-03-11 13:02:48 -07:00

PHOENIX_E2E_PORTAL_API_RAILING.md

Phoenix Deploy API: alert webhook, .env.example, Site24x7 and E2E docs

2026-03-11 13:00:53 -07:00

PHOENIX_SYSTEM_BOUNDARY_STATEMENT.md

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

2026-02-12 15:46:57 -08:00

PHYSICAL_HARDWARE_INVENTORY.md

Finalize DBIS infra verification and runtime baselines

2026-03-28 19:18:32 -07:00

PROXMOX_CLUSTER_ARCHITECTURE.md

Complete markdown files cleanup and organization

2026-01-06 01:46:25 -08:00

PROXMOX_COMPREHENSIVE_REVIEW.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

PROXMOX_HA_CLUSTER_ROADMAP.md

chore: sync all changes to Gitea

2026-03-02 11:37:34 -08:00

PROXMOX_HOSTS_COMPLETE_HARDWARE_CONFIG.md

Sync all local changes: docs, config, scripts, submodule refs, verification evidence

2026-02-21 15:46:06 -08:00

PUBLIC_SECTOR_TENANCY_MARKETPLACE_AND_DEPLOYMENT_BASELINE.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

R630_13_NODE_DOD_HA_MASTER_PLAN.md

chore: update submodule references and documentation

2026-03-04 02:03:08 -08:00

README.md

docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates

2026-02-12 15:46:57 -08:00

SANKOFA_IT_OPERATIONS_CONTROLLER_SPEC.md

feat(it-ops): live inventory, drift API, Keycloak IT role, portal sync hint

2026-04-09 01:20:00 -07:00

SANKOFA_PHOENIX_CANONICAL_BOUNDARIES_AND_TAXONOMY.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

SANKOFA_PHOENIX_COMPLETE_PHASED_EXECUTION_PLAN.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

SANKOFA_PHOENIX_PHASE4_MIGRATION_RUNBOOK.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

SANKOFA_PHOENIX_REMAINING_TASKS.md

chore: sync docs, config schemas, scripts, and meta task alignment

2026-03-31 22:31:39 -07:00

SERVICE_DESCRIPTIONS.md

docs(02-architecture): hostname model, intent, and architecture updates

2026-03-27 18:47:18 -07:00

VMID_ALLOCATION_FINAL.md

chore: sync all changes to Gitea

2026-03-02 11:37:34 -08:00

README.md

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 ⭐⭐⭐ - Complete network architecture with 6×/28 blocks, VLANs, NAT pools
ORCHESTRATION_DEPLOYMENT_GUIDE.md ⭐⭐⭐ - Enterprise-grade deployment orchestration guide
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

../03-deployment/ - Deployment guides
../04-configuration/ - Configuration guides
../05-network/ - Network infrastructure details
../07-ccip/ - CCIP deployment specification

README.md Unescape Escape

Architecture & Design

Documents

Quick Reference

Related Documentation

README.md