Init: README + template structuur

2026-08-20 22:48:14 +00:00
commit 5369618b46
1 changed files with 39 additions and 0 deletions
@@ -0,0 +1,39 @@
+# EMS² Widget Templates
+
+Community widget-templates voor EMS². Sjablonen worden via de
+Template Gallery in de dashboard-editor geladen (Gitea = remote source).
+
+## Structuur
+
+```
+templates/
+  yaml/{type}/{id}.yaml   — YAML-widgetdefinities (config-only widgets)
+  jsx/{type}/{id}.jsx     — JSX-widgetcomponenten (custom UI)
+```
+
+Elk bestand heeft YAML-frontmatter:
+
+```yaml
+---
+label: Naam van de template
+description: Korte omschrijving
+type: price-current        # widget type (registry)
+author: maik
+---
+```
+
+## Types (widgetRegistry)
+
+| type           | omschrijving                          |
+|----------------|---------------------------------------|
+| price-current  | Huidige elektriciteitsprijs           |
+| price-chart    | Prijsgrafiek (dag/uur)                |
+| battery-soc    | Batterij laadstatus                   |
+| pv-power       | PV-vermogen                           |
+| kpi            | KPI-kaart (label + waarde)            |
+| energy-flow    | Energie-flow visualisatie             |
+
+## Submit
+
+Nieuwe templates via de app: Template Gallery → Submit (opent een PR).
+Beheer (approve/edit) via admin-UI.