TorresVault Documentation

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

===== TorresVault 2.0 Roadmap =====

This roadmap outlines the future direction of the entire **TorresVault ecosystem**, including
virtualization, storage, networking, automation, AI integration, and home systems.  
It is a **living document** and expands as hardware evolves or new goals are defined.

----

==== 1. Overview / Vision ====

TorresVault 2.0 is the next-generation, fully modernized home infrastructure stack built on:

* Highly reliable **Proxmox cluster**
  * Dedicated **hardware NAS**
  * Unified **10Gbps network backbone**
  * Fully automated **Home Assistant ecosystem**
  * Local-first **AI (Jarvis) integration**
  * Scalable **Pixel Light Show** platform
  * A clean, organized, self-documenting **TorresVault Documentation Wiki**

The final goal:  
**A resilient, enterprise-grade home-lab + smart-home + lighting-control platform supporting all family systems with minimal maintenance and maximum reliability.**

----

==== 2. Phase 1 — NAS + Proxmox Hybrid Upgrade ====

**Status:** Planned for next build cycle

===== New Hardware =====

* **ASRock Rack X570D4U**
    * IPMI remote management (finally!)
    * Dual Intel X550 10GbE
    * ECC RAM support
    * Perfect for NAS + virtualization hybrid workloads

* **AMD CPU Platform**
    * Lower power usage than Intel
    * Better performance-per-watt
    * Strong virtualization capability

* **Storage**
    * 16 × **6 TB SAS enterprise drives**
    * 2 × HBAs (LSI 9201-8i or flashed 9211 IT mode)
    * ZFS RAIDZ2 or RAIDZ1 depending on layout
    * NVMe SLOG + L2ARC options (future)

* **Chassis**
    * **Fractal Design Define 7 XL**
    * Heavy, silent, amazing cable management
    * “Showpiece” machine — hood-lift worthy

===== Goals =====

* Replace pve1 or become a dedicated NAS+Compute hybrid
  * Move TrueNAS VM to **dedicated hardware**
  * Containerize or virtualize high-IO apps on NVMe tiers
  * Offload backup storage from the old 1TB drive farm

----
==== 3. Phase 1.5 — Transition to Mini-PC Proxmox Cluster ====

**Status:** Approved / Planned Change

The two MINISFORUM UM890 Pro units will replace the aging pve1 and pve2 hosts.  
This dramatically reduces power usage while increasing compute capacity.

===== New Proxmox Cluster Layout =====

* **Node 1:** UM890 Pro — 8-core Ryzen 9 class CPU, NVMe storage
  * **Node 2:** UM890 Pro — identical hardware for matching performance
  * **Node 3 (optional later):** Lightweight quorum node (Raspberry Pi 5 or small SFF PC)

===== Why the Change =====

* >80% reduction in power consumption compared to the i5-2500 & i5-4570 towers  
  * Modern PCIe/NVMe performance  
  * Faster virtualization, faster ZFS caching, better everything  
  * Far smaller footprint  
  * Less heat in the rack  
  * Perfect platform for running modern homelab workloads

===== Proxmox Cluster Behavior =====

* Both UM890 Pros run the main VM workloads  
  * The new NAS remains separate and provides storage via:
    * NFS  
    * SMB  
    * iSCSI (optional)
  * PBS stays dedicated and is NOT backed up (as intended)

===== Kubernetes Placement =====

Kubernetes will **NOT** run as baremetal on the Mini PCs.  
Instead:

* Kubernetes runs **as VMs inside Proxmox**
  * Ensures rollback capability  
  * Keeps Proxmox in control of snapshots, HA, backups  
  * Lets you migrate nodes easily  
  * Improves failure domain separation

===== Expected Result =====

A much cleaner, modern, low-power Proxmox cluster:

* High performance  
  * Highly efficient  
  * Easy to maintain  
  * More reliable than the current hardware  
  * Built for long-term scaling

----

==== 5. Phase 4 — Network Upgrades (UniFi) ====

Planned UniFi evolution:

* Add **10GbE aggregation** for servers & NAS  
  * Replace or reposition switches for:
    * Cleaner rack layout  
    * Better port distribution  
  * Define production VLANs:
    * `stark_user`
    * `stark_IOT`
    * `IOT+`
    * `Torres Family Lights`
    * Guest
    * Future: Management VLAN (for servers/switches)

* Add new UPS and integrate with **NUT**:
    * One UPS in Hall Closet → pve1 / new NAS
    * One UPS in Office → pve2 / Mini PCs
    * NUT central server on RPi
    * Auto-shutdown cascade for everything

----

==== 6. Phase 5 — Home Assistant 2.0 ====

You've already done incredible work on the dashboards.  
Next step is **automation architecture**.

===== Goals =====

* Full-room BLE-based presence detection (Pi Zero + ESPHome)
  * Replace all Amazon Echo devices with **Home Assistant Voice**
  * Expand WLED presence indicators (car, office, living room)
  * Unified theme for all dashboards:
    * Downstairs
    * Upstairs
    * Outside
    * Settings
    * Sports
    * FPP Control

* Build a **Home Assistant hardware diagram** to document:
    * Sensors
    * Automations
    * ESP devices
    * BLE beacons
    * Zigbee network (future: Sonoff ZBDongle)

* Move more automations from YAML → Blueprint → UI-friendly format

----

==== 7. Phase 6 — Jarvis AI System (Local-First AI) ====

===== Core Goals =====

* GPU-accelerated local LLM (RTX 3060 or better)
  * Voice-to-intent pipeline:
    * Piper TTS
    * FasterWhisper STT
    * HA Voice → Local AI → n8n → Automations
  * All AI workloads **local-first**
  * Create a **TorresVault AI Architecture Diagram**
  * Build the **Jarvis Manual** (20–40 pages)
    * System design
    * Diagrams
    * API flows
    * “How it works”

===== Hardware Options =====

* Dedicated Mini PC with GPU
  * repurposed workstation tower
  * Low-power yet GPU-capable solution

----

==== 8. Phase 7 — Torres Family Lights 2.0 ====

===== Goals =====

* Add new props:
    * Snowflakes
    * New rooflines
    * Revised matrix layout
  * Expand WLED integration in Home Assistant:
    * Car checks
    * Notifications
    * Fault lighting
  * Improve FPP integrations:
    * Start/Stop show from dashboard
    * Automated sequence rotation
    * Failure alerts
  * New public-facing features on torresfamilylights.com:
    * Guest map
    * Better guestbook
    * Auto-published Facebook updates

===== 2026–2027 Show Vision =====

* Larger mega-tree  
  * Cleaner pixel runs  
  * Higher-density props  
  * Full-home coordination

----

==== 9. Phase 8 — Documentation & Automation ====

===== Wiki Enhancements =====

* Add Proxmox runbooks:
    * Restore VM  
    * Backup strategy  
    * Cluster networking  
    * PBS troubleshooting  
    * Disk replacement procedure  
    * Migration workflow

* Add Home Assistant runbooks:
    * Motion lighting blueprint reference  
    * BLE tracking devices list  
    * Dashboard style reference

* Add network documentation:
    * VLAN layout  
    * Subnet overview  
    * DHCP mapping  
    * WiFi AP map

===== Automation Enhancements =====

* Git backup of all YAML  
  * Automated export of diagrams  
  * Auto-sync wiki → Git for versioning  
  * Inventory page for all hardware (rack, desk, office)

----

==== 10. Long-Term Future (Stretch Goals) ====

* Dedicated 42U rack in garage or closet
  * 25GbE backbone
  * Ceph cluster (3-node)
  * Full container conversion of all apps
  * Multi-zone presence-aware smart home
  * Cloudflare Zero Trust for external access
  * Family profiles with custom automation logic
  * GPU-powered AI video analytics (local)

----

===== End of Roadmap =====

This roadmap evolves as TorresVault grows.  
Update it anytime hardware changes or new ideas come up!

Edit summary