Add "Home"

Home.md

@@ -0,0 +1,92 @@
+# monster
+
+Custom Node-RED node for multi-parameter biological process monitoring with automated water sampling.
+
+## Overview
+
+| Property | Value |
+|----------|-------|
+| **Version** | 1.0.5 |
+| **Category** | Monitoring |
+| **Inputs** | 1 |
+| **Outputs** | 3 (process / dbase / parent) |
+| **Part of** | [EVOLV](https://gitea.wbd-rd.nl/RnD/EVOLV) |
+
+## Purpose
+
+The `monster` node manages automated water sampling systems for biological process monitoring. It handles:
+
+- **Sampling schedules** with configurable intervals
+- **Volume/weight constraints** for sample collection
+- **Rain event scaling** - adjusts sampling during rain events
+- **Aquon integration** - auto-populates parameter specs from the Aquon laboratory standard
+- **Flow-proportional** sampling support
+
+## Configuration
+
+### Sampling
+
+| Field | Unit | Description |
+|-------|------|-------------|
+| `samplingtime` | h | Base sampling interval |
+| `minvolume` | L | Minimum sample volume |
+| `maxweight` | kg | Maximum sample weight |
+| `emptyWeightBucket` | kg | Empty bucket tare weight |
+
+### Hydraulic Bounds
+
+| Field | Unit | Description |
+|-------|------|-------------|
+| `nominalFlowMin` | m3/h | Minimum nominal flow |
+| `flowMax` | m3/h | Maximum flow capacity |
+
+### Rain Scaling
+
+| Field | Unit | Description |
+|-------|------|-------------|
+| `maxRainRef` | mm | Maximum rain reference for scaling |
+| `minSampleIntervalSec` | s | Minimum interval between samples during rain |
+
+### Aquon Integration
+
+| Field | Description |
+|-------|-------------|
+| `aquon_sample_name` | Dropdown selection from Aquon standard sample types |
+
+When an Aquon sample is selected, parameter specifications are automatically applied.
+
+## Important Integration Notes
+
+**Measurement assetType:** When connecting `measurement` nodes to `monster`, the measurement's `assetType` must be exactly `"flow"` (not `"flow-electromagnetic"` or other variants). The monster node queries for this exact string.
+
+## Inputs and Outputs
+
+### Input (Port 0)
+Flow measurements, rain data, control commands.
+
+### Output Port 0 - Process Data
+Sampling state, current volume, next sample time, parameter readings.
+
+### Output Port 1 - InfluxDB Telemetry
+Sampling events and parameter time-series data.
+
+### Output Port 2 - Registration
+Parent communication and measurement node registration.
+
+## Dependencies
+
+- [generalFunctions](https://gitea.wbd-rd.nl/RnD/generalFunctions) (MenuManager, configManager)
+
+## Technical Requirements
+
+- Node.js >= 18
+- Node-RED >= 3.x
+- `measurement` node(s) with `assetType: "flow"` for flow-proportional sampling
+
+## Testing
+
+```bash
+node --test test/basic/*.test.js
+node --test test/integration/*.test.js
+node --test test/edge/*.test.js
+```