Trixy7/.claude/project-knowledge/data-models.md

Datenmodelle

Revision: r2 Source: CLAUDE.md, Code-Analyse Last updated: 2026-04-10 14:00

---

Konfigurationsstrukturen

ServerConfig

@dataclass
class ServerConfig:
    network: NetworkConfig
    security: SecurityConfig
    audio: AudioConfig
    wakeword: WakewordConfig
    voice_recognition: VoiceRecognitionConfig
    conversation: ConversationConfig
    plugins: PluginConfig
    logging: LoggingConfig
    satellites_directory: str = "satellites"
    assets_directory: str = "assets"
    models_directory: str = "models"
    profile: str = "default"

NetworkConfig

@dataclass
class NetworkConfig:
    command_port: int = 2101
    audio_input_port: int = 2102
    audio_output_port: int = 2103
    music_port: int = 2104
    bind_address: str = "0.0.0.0"
    max_connections: int = 100

ClientConfig (Auszug aus client_config.json)

@dataclass
class ClientConfig:
    server: ServerConnectionConfig    # host, port, timeouts
    audio: ClientAudioConfig          # sample_rate, channels, bit_depth, volume, mute, devices
    wakeword: ClientWakewordConfig    # models, threshold, directory
    identity: SatelliteIdentityConfig # room, alias, MAC
    logging: ClientLoggingConfig
    assets_directory: str = "assets"
    profile: str = "default"

Audio-relevante Felder in client_config.json:

• output_volume: 80, output_muted: false
• input_volume: 80, input_muted: false
• output_combine_sink_name: "trixy_combined"
• input_mix_sink_name: "trixy_mics_combined"
• config_listener_enabled: false

InstallerConfig (make_installer)

@dataclass
class InstallerConfig:
    # Modus
    mode: str = "server"           # server, client, standalone
    version: str = "1.0.0"
    source_archive: str = ""

    # System (F1)
    hostname: str = "trixyone"
    username: str = "pi"
    install_path: str = "/home/pi/trixy"
    autostart: bool = True
    install_service: bool = True
    auto_regist: bool = True

    # Server WiFi-Hotspot (F2)
    wifi_enabled: bool = True
    wifi_ssid: str = "trixyone_srv"
    wifi_password: str = "trixy2026!"
    wifi_channel: int = 6
    ap_ip: str = "10.10.10.1"
    dhcp_range_start: str = "10.10.10.10"
    dhcp_range_end: str = "10.10.10.50"

    # Client/Standalone WLAN (F2)
    wifi_connect: bool = False
    wifi_connect_ssid: str = ""
    wifi_connect_password: str = ""
    wifi_fallback_enabled: bool = False
    wifi_fallback_ssid: str = ""
    wifi_fallback_password: str = ""
    wifi_auto_switchback: bool = True
    wifi_switchback_interval: int = 30

    # Client Server-Verbindung (F2)
    server_host: str = "10.10.10.1"
    server_port: int = 2101
    room: str = ""
    alias: str = ""

    # Plugins (F3)
    selected_plugins: list[str]
    nlp_backend: str = "llama_cpp"
    ollama_host: str = "http://localhost:11434"
    download_models: bool = False

    # Vereinbarung (F5)
    agreement_accepted: bool = False

TrainerConfig

@dataclass
class TrainerConfig:
    wakeword: WakewordTrainerConfig
    voice_recognition: VoiceRecognitionTrainerConfig
    audio_processing: AudioProcessingConfig
    data: DataConfig
    output: OutputConfig
    device: str = "auto"  # auto, cpu, cuda, mps
    num_workers: int = 4
    seed: int = 42

Trainer Datenmodelle

TrainerInfo

@dataclass
class TrainerInfo:
    trainer_id: str
    name: str
    description: str
    version: str
    author: str
    model_type: str      # z.B. "wakeword", "intent"
    trainer_type: str     # z.B. "core", "plugin"

TrainingProgress

@dataclass
class TrainingProgress:
    state: str           # idle, training, paused, completed, failed
    epoch: int
    total_epochs: int
    loss: float
    accuracy: float
    vram_usage: float
    eta_seconds: float
    history: list[dict]  # Loss/Accuracy pro Epoch

Event-Daten

EventData (Basis)

@dataclass
class EventData:
    event_id: str          # UUID
    timestamp: datetime
    source: str            # Quelle (z.B. Service-Name)
    cancelled: bool
    metadata: dict[str, Any]

    def cancel() -> None
    def is_cancelled() -> bool
    @classmethod
    def event_name() -> str  # Klassenname in snake_case

Wichtige Event-Daten

Klasse	Felder
WakewordReceived	satellite_id, wakeword_model, confidence, audio_level
SpeechRecognized	satellite_id, text, confidence, language, alternatives
IntentReceived	satellite_id, intent, confidence, slots, original_text
RawAudioInputReceived	satellite_id, audio_data, sample_rate, duration_seconds

Satellite-Daten

class Satellite:
    id: str
    room_id: str
    mac_address: str
    alias: str
    ip_address: str
    state: ConnectionState  # DISCONNECTED, CONNECTING, CONNECTED, AUTHENTICATED
    conversation_id: str | None
    connected_at: datetime | None
    last_heartbeat: datetime | None
    version: str

---

See also: apis.md, integrations.md