Merge branch 'main' of git.stroblme.de:Fluksio/app

docs/reference/configuration.md

@@ -88,6 +88,13 @@ remember it is fixed at build time: changing it means rebuilding that image.
 |---|---|---|
 | `ENVIRONMENT` | `local` | `local`, `staging` or `production` |
 | `PRIVATE_API_ENABLED` | `false` | unauthenticated test-only endpoints; needs `ENVIRONMENT=local` too |
+| `TZ` | `UTC` | the timezone every schedule is written in |
+
+`TZ` is the container's own, not a setting the code reads: an `inject` or a
+`delay` with a cron expression fires on local time. Left at `UTC`, "off at
+02:00" means two in the morning UTC, which in most of the world is neither two
+o'clock nor the same hour in summer as in winter. Set it to where the
+installation is.
 
 `production` closes `/docs`, `/redoc` and the OpenAPI document, because the
 schema enumerates every endpoint the installation serves — including the paths

docs/reference/node-types.md

@@ -40,8 +40,15 @@ A node with *outputs only* subscribes; a node with *inputs* publishes.
 | `qos` | `0` | 0, 1 or 2 |
 | `retain` | `false` | on published messages |
 | `keepalive` | `60` | seconds |
+| `json_key` | — | key to lift out of an object payload; one for every port, or `{"port": "key"}` |
 
-Nodes sharing a broker share one connection.
+A topic may be a filter: `+` matches one level, `#` the rest. Everything a
+filter matches lands on the same port, so use one port per topic where the
+difference matters.
+
+`json_key` is for a device that wraps its reading — Victron publishes
+`{"value": 47}` on every path. Without it, a payload object is unwrapped only
+when it happens to carry the port's own name as a key.
 
 ### HTTP
 
@@ -56,6 +63,8 @@ Outputs only makes it a **webhook**: the engine mounts a route at
 | `method` | `POST` | `GET` or `POST` |
 | `timeout` | `30` | seconds, sender mode |
 | `headers` | `{}` | |
+| `query` | `{}` | fixed query parameters; a value may be a secret reference |
+| `send_inputs` | `true` | off when the inputs only trigger the request |
 | `secret` | — | shared secret appended to the webhook URL; takes a secret reference |
 
 !!! warning "A webhook with no secret is open to anyone who can reach the host."
@@ -137,7 +146,7 @@ presses.
 
 | Setting | Default | Notes |
 |---|---|---|
-| `delay` | `0` | seconds to hold each message |
+| `delay` | `0` | seconds to hold each message, fractional |
 | `interval` | `0` | minimum seconds between forwards |
 | `mapping` | `{}` | input port → output port; paired in order when empty |
 | `cron` | — | five-field expression |
@@ -162,10 +171,18 @@ received.
 | `then` | `false` | sent when the wait expires; empty sends nothing |
 | `wait` | `60` | seconds of quiet before the second value |
 | `extend` | `true` | a value arriving during the wait starts it over |
+| `passthrough` | `false` | send the incoming value instead of `first` |
+| `wait_port` | — | an input carrying the wait, when it differs per message |
 
 The shape this exists for: *the door opened — turn the light on, and off again
 in two minutes unless it opens again.*
 
+`wait_port` covers the case where how long to wait is itself a value: a
+rollershutter takes 26 seconds up and 28 down, so the node that decides the
+direction says how long to run for as well. A wait of zero or less sends
+nothing afterwards — and still cancels whatever the last message scheduled,
+which is how a *stop* is commanded exactly once.
+
 ## Logic
 
 ### Switch