bogdan Initial commit

7bb6a82 2 weeks ago History

# Node-RED Custom Nodes

## Repository layout

Adaptoarele sunt grupate in folderul `adapters/`, separat de celelalte noduri custom din workspace.

Nodurile care nu sunt adaptoare raman la radacina, de exemplu:

- `msg-status`
- `presence-detector`

In interiorul `adapters/`, adaptoarele sunt organizate pe tip de device, nu pe model.

Structura standard pentru un device type este:

- `adapters/<device-type>/homebus-adapter`
- `adapters/<device-type>/homekit-adapter`
- `adapters/<device-type>/energy-adapter` atunci cand exista telemetrie energetica dedicata
- `adapters/<device-type>/models` pentru documentatie sau note per model

Exemple curente:

- `adapters/smart-socket/...`
- `adapters/contact-sensor/...`
- `adapters/water-leak-sensor/...`
- `adapters/smoke-detector/...`
- `adapters/presence-sensor/...`

Scopul acestei structuri este sa permitem mai multe modele Zigbee sub acelasi tip de device, fara sa mai multiplicam layout-ul proiectului la nivel de folder radacina.

## Deploy targets

SSH target-urile folosite pentru deploy din acest workspace sunt:

- `testing`: `node-red@192.168.2.104`
- `production`: `node-red@192.168.2.101`
- `legacy`: `pi@192.168.2.133`

Verificate prin SSH la data de `2026-03-11`.

## Service control

Pe `testing` și `production`, user-ul `node-red` poate controla direct serviciul Node-RED, fără `sudo`:

```bash
systemctl restart node-red
systemctl is-active node-red
```

Numele unității de serviciu este:

```bash
node-red.service
```

## Notes

- `deploy.sh` folosește implicit target-ul de `testing`.
- `deploy.sh` accepta cai relative de forma `adapters/device-type/adapter`, de exemplu `adapters/smart-socket/homebus-adapter`.
- Pentru hosturile `testing` și `production`, user-ul SSH folosit efectiv este `node-red`.
- După deploy pe `testing` și `production`, restart-ul standard este `systemctl restart node-red`.
- Hostul `legacy` rămâne accesat cu user-ul `pi`.
- `legacy` este în curs de dezafectare.
- Nu se face deploy pe `legacy` decât în situații speciale.

## Current verification

Verificat la data de `2026-03-11`:

- `testing` `192.168.2.104`: restart-ul `node-red` funcționează direct ca user `node-red`
- `production` `192.168.2.101`: restart-ul `node-red` funcționează direct ca user `node-red`
- `production` rulează `node-red-contrib-z2m-zg-204zv-homebus@0.0.20`

## Additional documentation

Documentația detaliată pentru adaptoarele HomeKit și integrarea cu `node-red-contrib-homekit-bridged` este în:

- [.doc/homekit-adapter-development-guide.md](/Users/bogdan/Documents/Workspaces/Home/NodeRed/myNodes/.doc/homekit-adapter-development-guide.md)