# ✅ Wdrożenie Solarman/Deye na PROD - Raport

## Data wdrożenia: 2026-02-05

## 🎯 Cel
Wdrożenie integracji Solarman (Deye Solar Inverter) z TEST na PROD bez użycia SSH.

## 📋 Co zostało wdrożone

### 1. **HACS (Home Assistant Community Store)**
- Rozmiar: 52 MB
- Źródło: TEST VM (101)
- Cel: PROD VM (100)
- Status: ✅ Skopiowany

### 2. **Solarman Integration**
- Wersja: 25.08.16
- Rozmiar: 1.7 MB
- GitHub: https://github.com/davidrapan/ha-solarman
- Status: ✅ Skopiowany
- Zawiera: 203 encje (94 sensors, 62 numbers, 18 selects, 15 switches, etc.)

### 3. **Konfiguracja**
- IP inwertera: 192.168.50.196
- Tytuł: "Inverter DEYE"
- Status: ✅ Skopiowana do `core.config_entries`

## 🛠️ Metoda wdrożenia

### Bezpośredni dostęp do dysków VM przez Proxmox

```bash
# 1. Mapowanie partycji LVM
kpartx -av /dev/pve/vm-101-disk-0  # TEST
kpartx -av /dev/pve/vm-100-disk-0  # PROD

# 2. Montowanie partycji danych (p8)
mount /dev/mapper/pve-vm--101--disk--0p8 /mnt/haos-test
mount /dev/mapper/pve-vm--100--disk--0p8 /mnt/haos-prod

# 3. Kopiowanie
cp -r /mnt/haos-test/supervisor/homeassistant/custom_components/hacs \
      /mnt/haos-prod/supervisor/homeassistant/custom_components/

cp -r /mnt/haos-test/supervisor/homeassistant/custom_components/solarman \
      /mnt/haos-prod/supervisor/homeassistant/custom_components/

# 4. Modyfikacja .storage/core.config_entries
jq '.data.entries += [<solarman_config>]' core.config_entries

# 5. Odmontowanie i restart
umount /mnt/haos-*
kpartx -d /dev/pve/vm-*-disk-0
qm reboot 100
```

### Dlaczego ta metoda?

❌ SSH addon nie był włączony na TEST i PROD  
❌ HA API nie pozwala na instalację custom components  
✅ Bezpośredni dostęp do filesystem przez Proxmox  
✅ Pełna kontrola nad plikami  
✅ Automatyzacja możliwa przez skrypty  

## 📂 Struktura plików HAOS

```
/mnt/haos-*/supervisor/homeassistant/
├── .storage/
│   ├── core.config_entries      # Konfiguracje integracji
│   ├── core.device_registry     # Rejestr urządzeń
│   ├── core.entity_registry     # Rejestr encji
│   ├── hacs.data               # Dane HACS
│   └── hacs.repositories       # Repozytoria HACS
├── custom_components/
│   ├── hacs/                   # 52 MB
│   └── solarman/               # 1.7 MB
├── configuration.yaml
└── home-assistant_v2.db        # Baza danych
```

## 🚀 Zautomatyzowany skrypt

Stworzono skrypt: `scripts/deploy-integration-offline.sh`

### Użycie:
```bash
# Domyślnie wdraża "solarman"
./scripts/deploy-integration-offline.sh

# Lub inna integracja
./scripts/deploy-integration-offline.sh <nazwa_integracji>
```

### Co robi:
1. ✅ Łączy się z Proxmox
2. ✅ Mapuje i montuje dyski VM
3. ✅ Kopiuje integrację + HACS
4. ✅ Dodaje konfigurację do config_entries
5. ✅ Odmontowuje dyski
6. ✅ Restartuje PROD VM

## ✅ Weryfikacja

Po wdrożeniu sprawdź w PROD:
1. Otwórz http://192.168.50.242:8123
2. Przejdź do: Settings → Devices & Services
3. Powinno być widoczne: "Inverter DEYE" (Solarman)
4. Sprawdź czy wszystkie 203 encje są dostępne

## 📊 Encje Solarman/Deye

### Główne kategorie:
- **Sensors (94)**: Energia, moc, napięcie, prąd, częstotliwość
- **Numbers (62)**: Ustawienia limitów, czasów, napięć
- **Selects (18)**: Tryby pracy (charge, discharge, grid)
- **Switches (15)**: Włączniki funkcji
- **Times (6)**: Harmonogramy ładowania
- **Binary Sensors (6)**: Statusy (błędy, ochrony)
- **Button (1)**: Reset liczników
- **Datetime (1)**: Czas systemowy

### Przykładowe sensory:
- Daily Production (kWh)
- Total Production (kWh)
- Battery SOC (%)
- Battery SOH (%)
- Grid Power (W)
- PV Power (W)
- Load Power (W)
- Battery Voltage (V)
- Battery Current (A)

## 🔧 Następne kroki

1. **Włącz SSH addon** (opcjonalnie):
   - Settings → Add-ons → Terminal & SSH
   - Hasło: QWer!@34
   - Umożliwi synchronizację przez `sync-test-to-prod.sh`

2. **Skonfiguruj backup**:
   ```bash
   crontab -e
   0 2 * * * /root/homeassistant-infra/scripts/backup-ha.sh
   ```

3. **Monitoruj działanie**:
   - Sprawdzaj logi w HA
   - Monitoruj połączenie z inverterem (192.168.50.196)
   - Weryfikuj poprawność danych

## 📝 Uwagi

- ⚠️ VM musi być wyłączona podczas bezpośredniego dostępu do dysków (możliwe również na żywo z ostrożnością)
- ⚠️ Zawsze używaj `sync` przed odmontowaniem
- ⚠️ Backup jest tworzony automatycznie przed każdą zmianą
- ✅ Integracja działa identycznie jak w TEST
- ✅ Wszystkie dane historyczne pozostają w TEST

## 🎉 Podsumowanie

**Status: ✅ SUKCES**

Integracja Solarman/Deye została wdrożona na PROD bez wykorzystania SSH, wykorzystując bezpośredni dostęp do filesystem przez Proxmox. Metoda ta jest:
- Niezawodna
- Automatyzowalna
- Bezpieczna (backup przed zmianami)
- Uniwersalna (działa dla każdej custom integration)

---
*Wygenerowano automatycznie: 2026-02-05*