Smart-Dashboard/README.md

Normalisierte Datenbankstruktur für Somfy Tahoma

Übersicht

Die Datenbank wurde von einer denormalisierten Struktur (mit JSON in parameters) in eine vollständig normalisierte relationale Struktur überführt.

Datenbankschema

Haupttabellen

actors

Speichert alle Aktoren (Geräte mit Steuerungsfunktion)

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
type	VARCHAR(50)	Gerätetyp (z.B. RollerShutter)
name	VARCHAR(70)	Name des Geräts
parameters	TEXT (nullable)	Optionale Meta-Informationen
url	VARCHAR(100) UNIQUE	Tahoma Device URL

sensors

Speichert alle Sensoren (Geräte die Werte melden)

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
type	VARCHAR(50)	Sensortyp (z.B. TemperatureSensor)
name	VARCHAR(70)	Name des Sensors
parameters	TEXT (nullable)	Optionale Meta-Informationen
url	VARCHAR(100) UNIQUE	Tahoma Device URL

Aktor-Detailtabellen

actor_commands

Speichert alle verfügbaren Commands für jeden Aktor

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
actor_id	INT (FK → actors.id)	Referenz zum Aktor
command_name	VARCHAR(100)	Name des Commands (z.B. setPosition, open)

Beispieldaten:

actor_id | command_name
---------|-------------
1        | open
1        | close
1        | setPosition
2        | on
2        | off

command_parameters

Speichert die Parameter für jeden Command

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
command_id	INT (FK → actor_commands.id)	Referenz zum Command
parameter_name	VARCHAR(100)	Name des Parameters (z.B. position)
parameter_type	VARCHAR(50)	Datentyp (z.B. integer, string)
min_value	DECIMAL(10,2)	Minimaler Wert (nullable)
max_value	DECIMAL(10,2)	Maximaler Wert (nullable)
possible_values	TEXT	JSON Array mit möglichen Werten (nullable)

Beispieldaten:

command_id | parameter_name | parameter_type | min_value | max_value
-----------|----------------|----------------|-----------|----------
3          | position       | integer        | 0         | 100

actor_states

Speichert die aktuellen States von Aktoren

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
actor_id	INT (FK → actors.id)	Referenz zum Aktor
state_name	VARCHAR(100)	Name des State (z.B. core:ClosureState)
state_type	INT	State-Typ Code aus Tahoma API
current_value	VARCHAR(255)	Aktueller Wert
unit	VARCHAR(20)	Einheit (nullable)
last_updated	TIMESTAMP	Zeitpunkt der letzten Aktualisierung

Sensor-Detailtabellen

sensor_states

Speichert alle verfügbaren States für jeden Sensor

Spalte	Typ	Beschreibung
id	INT (PK, AUTO_INCREMENT)	Eindeutige ID
sensor_id	INT (FK → sensors.id)	Referenz zum Sensor
state_name	VARCHAR(100)	Name des State (z.B. core:TemperatureState)
state_type	INT	State-Typ Code aus Tahoma API
current_value	VARCHAR(255)	Aktueller Wert
unit	VARCHAR(20)	Einheit (z.B. °C, %) (nullable)
last_updated	TIMESTAMP	Zeitpunkt der letzten Aktualisierung

Beispieldaten:

sensor_id | state_name              | state_type | current_value | unit
----------|-------------------------|------------|---------------|------
1         | core:TemperatureState   | 1          | 21.5          | °C
2         | core:LuminanceState     | 1          | 350           | lux

Beziehungen (Foreign Keys)

actors (1) ──< (N) actor_commands
              └──< (N) command_parameters

actors (1) ──< (N) actor_states

sensors (1) ──< (N) sensor_states

Alle Foreign Keys mit ON DELETE CASCADE → Wenn ein Aktor/Sensor gelöscht wird, werden automatisch alle zugehörigen Commands, Parameter und States gelöscht.

Hilfreiche Views

view_actors_with_commands

Zeigt alle Aktoren mit ihren Commands und Parametern in einer flachen Ansicht

SELECT * FROM view_actors_with_commands WHERE actor_name = 'Wohnzimmer Rollo';

view_sensors_with_states

Zeigt alle Sensoren mit ihren aktuellen States

SELECT * FROM view_sensors_with_states WHERE sensor_type = 'TemperatureSensor';

view_all_devices

Zeigt eine Übersicht aller Geräte (Aktoren und Sensoren)

SELECT * FROM view_all_devices ORDER BY name;

Beispiel-Queries

Alle Commands eines bestimmten Aktors anzeigen

SELECT 
    a.name as aktor_name,
    ac.command_name,
    cp.parameter_name,
    cp.min_value,
    cp.max_value
FROM actors a
JOIN actor_commands ac ON a.id = ac.actor_id
LEFT JOIN command_parameters cp ON ac.id = cp.command_id
WHERE a.name = 'Wohnzimmer Rollo';

Alle Temperatursensoren mit aktuellem Wert

SELECT 
    s.name as sensor_name,
    ss.current_value as temperatur,
    ss.unit,
    ss.last_updated
FROM sensors s
JOIN sensor_states ss ON s.id = ss.sensor_id
WHERE s.type = 'TemperatureSensor'
  AND ss.state_name LIKE '%Temperature%';

Alle Aktoren eines bestimmten Typs

SELECT 
    name,
    type,
    COUNT(DISTINCT ac.id) as anzahl_commands
FROM actors a
LEFT JOIN actor_commands ac ON a.id = ac.actor_id
WHERE a.type = 'RollerShutter'
GROUP BY a.id, a.name, a.type;

Commands ohne Parameter finden

SELECT 
    a.name as aktor,
    ac.command_name
FROM actors a
JOIN actor_commands ac ON a.id = ac.actor_id
LEFT JOIN command_parameters cp ON ac.id = cp.command_id
WHERE cp.id IS NULL;

Vorteile der normalisierten Struktur

1. Keine Datenduplizierung: Jeder Command und Parameter wird nur einmal gespeichert
2. Einfache Queries: SQL-Joins statt JSON-Parsing
3. Flexible Erweiterung: Neue Spalten können einfach hinzugefügt werden
4. Referentielle Integrität: Foreign Keys garantieren Konsistenz
5. Performance: Indizes auf relevanten Spalten für schnelle Suchen
6. Typsicherheit: Min/Max als DECIMAL statt String

Migration von alter zu neuer Struktur

Falls Sie bereits Daten in der alten Struktur haben:

-- Backup erstellen
CREATE TABLE actors_old AS SELECT * FROM actors;
CREATE TABLE sensors_old AS SELECT * FROM sensors;

-- Alte Tabellen löschen
DROP TABLE actors;
DROP TABLE sensors;

-- Neue Struktur erstellen (database_schema.sql ausführen)
SOURCE database_schema.sql;

-- Python-Script ausführen um Daten neu zu importieren

Wartung

Regelmäßige Aktualisierung der States

Das Script kann regelmäßig ausgeführt werden. Bei CLEAR_TABLES = True werden alle Daten neu importiert. Bei CLEAR_TABLES = False können Updates implementiert werden.

Veraltete Geräte entfernen

-- Geräte finden die nicht mehr in der Tahoma Box vorhanden sind
-- (nach erneutem Import)

Index-Optimierung prüfen

SHOW INDEX FROM actors;
SHOW INDEX FROM actor_commands;