Files
EVOLV/wiki/manuals/node-red/messages-and-editor-structure.md
znetsixe 5ae8788fd7 wiki: crisp overhaul — no decoration emoji, all 9 master pages refactored
Source-tree mirror of EVOLV.wiki.git refactor (27a42ee on wiki.git):

- 7 master pages rewritten with clean design (Home, Architecture,
  Topology-Patterns, Topic-Conventions, Telemetry, Getting-Started,
  Glossary). Tables and Mermaid for visuals, gitea alert callouts for
  warnings, shields badges for metadata only. No emoji as decoration.
- Archive.md becomes a removal-changelog pointing readers to git
  history and to the successor pages.
- _Sidebar.md updated to navigate the new flat-name layout.
- Concept / finding / manual pages: uniform mini-header (badges +
  "reference page" callout) added without rewriting domain content.
- Every internal link now uses the flat naming that resolves on the
  live gitea wiki (Concept-ASM-Models, Finding-BEP-..., etc.).

On wiki.git: 29 Archive-* pages hard-deleted (the git history
preserves them; Archive.md documents the removal).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 22:24:51 +02:00

34 lines
1.3 KiB
Markdown

# Node-RED Messages and Editor/Runtime Structure (EVOLV Summary)
![code-ref](https://img.shields.io/badge/code--ref-9ab9f6b-blue) ![type](https://img.shields.io/badge/type-manual_(third-party)-orange)
> [!NOTE]
> Reference page. Maintained for context; not regenerated by code. See [Home](Home) for current top-level navigation.
Sources:
- Messages: https://nodered.org/docs/user-guide/messages
- Edit dialog and node definition: https://nodered.org/docs/creating-nodes/edit-dialog
## Message Shape
- Standard message object is usually `msg`.
- `msg.payload` is the default value channel.
- `msg.topic` is used for routing/intent labeling.
## EVOLV Topic Routing
- EVOLV runtime wrappers route commands by `msg.topic` in `src/nodeClass.js`.
- Keep topic names stable unless a migration is defined (flow compatibility).
## Editor/Runtime Parity
- In `.html`, `RED.nodes.registerType(... defaults ...)` defines persisted config fields.
- Runtime parser in `src/nodeClass.js` must read and normalize the same fields.
- If a field is added/renamed in editor defaults, update runtime mapping and tests in the same change.
## Multi-Output Node Rule
- Runtime `node.send([out1, out2, out3])` must align with declared `outputs` in `.html`.
- If output meaning is `process`, `dbase`, `parent`, maintain stable index mapping across all message paths.