Solutions

Start in the app at Help Wizard (Account). That page is the order for every left-menu item.

Solutions are pre-built dashboard templates with an optional sample sandbox. Use copies a dashboard and a device profile. If the plan's dashboard limit is already reached, Use stays on this page and shows that limit. On Free the sentence is "Dashboard limit (1) reached for your plan". Do not create that profile again. Sample devices stay in Solutions and do not count toward the plan. Connect the real device after Use, then bind it on the copied dashboard.

Available Pages

• Solutions — /solutions
• Solution Preview — /solutions/:id

What You Can Do

• Browse solutions
• Open a solution (lazy sandbox + Sample On/Off)
• Use a solution — clean dashboard copy + setup guide
• Publish a dashboard as a solution

Mental model

Place	What it is
Solutions	Forever sandbox. First open provisions demo devices + generator + sample alarm profile (lazy). Sample On/Off lives here only.
Dashboards (after Use)	Your real ops board. Open the copy, then bind the real device.

Solutions named HTTP, MQTT, WebSocket, CoAP, AMQP, LoRaWAN webhook, Gateway, Modbus, OPC UA, BACnet, and Sparkplug B are shipped examples. They cannot be deleted or edited. Turn Sample on. The dashboard stays empty until a reading arrives on that protocol. Use copies a dashboard you can edit. The sample device is not one of your meters.

Shift board, Energy desk, and Service and lamp are shipped examples of the operator widgets. They cannot be deleted or edited. Turn Sample on. The last hour is stored then, so the board is filled at once. Use copies a dashboard you can edit.

Reference stacks (hardware + connectivity)

Each catalog Solution has a reference stack doc: telemetry keys, connectivity profiles (4G DTU, ESP32 WiFi, Ethernet, native MQTT, …), datasheet-aligned notes, and wiring diagrams.

• Connectivity profiles — P1–P6 building blocks
• Reference stacks catalog — matrix of all Solutions
• Validation status — bench tested vs pending bench test
• Phase 4 + Analytics A · Phase 5 Analytics B · Phase 6 Analytics C
• Analytics hub — Metric Explorer, forecast, z-score, asset rollups, shared views
• Analytics industry profile — exceedance-first standards we compete on
• Field validation — Analytics API/UI smoke checklist

After Use, the dashboard setup banner links to the full stack doc when available.

Messing up a real dashboard does not remove the Solution sandbox. Open the Solution again anytime.

API Endpoints

Method	Path	Description
GET	/api/solutions	List all solutions.
GET	/api/solutions/:id	Get a single solution.
GET	/api/solutions/can-publish	Check if the current user may publish or delete solutions.
POST	/api/solutions/:id/ensure-sandbox	Lazy-provision demo devices + generator for this tenant (idempotent).
GET	/api/solutions/:id/sandbox	Sandbox status (provisioned, sample running).
POST	/api/solutions/:id/sample	Body { enabled: boolean } — Sample On/Off.
POST	/api/solutions/:id/use	Body { name } — copy clean dashboard + setup guide meta.
POST	/api/solutions	Create a new solution from a dashboard config (platform admin).
PATCH	/api/solutions/:id	Update metadata / optional pack_json (platform admin).
DELETE	/api/solutions/:id	Delete a solution. Requires platform admin permission.

Constraints

• Publishing, deleting, and managing solutions requires platform administrator permission (canPublishSolutions).
• Using a solution creates a new dashboard and requires providing a dashboard name.
• The solution preview is read-only for widget layout. Sample On/Off controls the sandbox generator only.
• Demo devices and generators are labeled Demo, do not consume device quota, and cannot be deleted from Devices / Data Generators.
• Pack definition comes from solutions.pack_json when present; otherwise the backend infers devices/keys from the dashboard template.