nextcloud-collabora-nodered/README.md

# nextcloud-collabora-nodered

Node-RED sidecar (port **1881**) för Nextcloud Office + Collabora CODE — WebDAV, richdocuments OCS och `/cool` REST.

**Version 1.0 — 22 augusti 2026**

## Miljö (cloud / 192.168.1.26)

| Tjänst | Adress |
|--------|--------|
| Nextcloud | https://cloud.hannesahlin.se |
| CODE (intern) | http://172.17.0.2:9980 (container `code` på Docker `bridge`) |
| Sidecar Node-RED | http://192.168.1.26:1881 |
| Befintlig OCS Node-RED | http://192.168.1.26:1880 (orört) |
| Gitea | https://kode.hannesahlin.se |

Detaljer: [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md)

## Snabbstart (Ubuntu)

```bash
git clone https://kode.hannesahlin.se/<user>/nextcloud-collabora-nodered.git /home/ncadmin/nextcloud-collabora-nodered
cd /home/ncadmin/nextcloud-collabora-nodered
cp .env.example .env
chmod +x install.sh
./install.sh
```

`install.sh` verifierar att CODE redan kör, ansluter sidecar till Docker `bridge`, och testar `/hosting/capabilities`.

## Överföring från Windows

```bash
./package.sh
scp artifacts/nextcloud-collabora-nodered-1.0.0.tar.gz ncadmin@192.168.1.26:/home/ncadmin/
```

På servern:

```bash
mkdir -p ~/nextcloud-collabora-nodered
tar -xzf ~/nextcloud-collabora-nodered-1.0.0.tar.gz -C ~/nextcloud-collabora-nodered
cd ~/nextcloud-collabora-nodered && ./install.sh
```

## Noder

| Nod | Syfte |
|-----|-------|
| `nc-collab-config` | Miljö + app-lösenord |
| `collabora-bridge` | Agent-pipelines (börja här) |
| `nc-office` | richdocuments OCS |
| `collabora-convert` | `/cool/convert-to` (låg nivå) |
| `collabora-extract` | `/cool/extract-document-structure` |
| `collabora-transform` | `/cool/transform-document-structure` |
| `collabora-wopi` | discovery, capabilities, editor-URL |

## Dokumentation

- [docs/AGENT-MANUAL.md](docs/AGENT-MANUAL.md) — assistentmanual
- [docs/INFRASTRUCTURE.md](docs/INFRASTRUCTURE.md) — Docker/nätverk på servern

## Gränser

- Skriver till `/Dokument/OfficeOut/` som standard
- Port 9980 exponeras **inte** utanför loopback på host
- Sidecar når CODE via Docker **`bridge`** (`172.17.0.2`), inte `host.docker.internal`
- `nextcloud-node-red:1880` och odds-scraper **orörda**

## Git push (Gitea)

```bash
git remote add origin https://kode.hannesahlin.se/<user>/nextcloud-collabora-nodered.git
# eller SSH: git@kode.hannesahlin.se:<user>/nextcloud-collabora-nodered.git  (port 2222)
git push -u origin main
```

Skapa tomt repo i Gitea UI först om det behövs.

## Licens

MIT