Trixy7/.claude/project-knowledge/modules.md

Module

Revision: r1 Source: CLAUDE.md, Directory Structure Last updated: 2026-01-31 12:35

---

Verzeichnisstruktur

trixy7/source/
├── main.py                    # CLI-Einstiegspunkt
├── config/                    # JSON-Konfigurationsdateien
├── trixy_core/                # Kernframework
├── plugins/                   # Benutzer-Plugins
├── models/                    # ML-Modelle
├── trainer/                   # Trainingsdaten und Trainer
├── assets/                    # Audio-Dateien, Profile
├── satellites/                # Registrierte Satellite-JSON
├── certs/                     # SSL-Zertifikate
└── logs/                      # Anwendungslogs

trixy_core Module

trixy_core.utils

Zweck: Hilfsfunktionen und Konstanten

Datei	Inhalt
debug.py	pinfo(), pdebug(), perror(), pwarn() - Farbcodierte Ausgabe
version.py	VERSION, PROTOCOL_VERSION Konstanten

trixy_core.service

Zweck: Service-Container und Lebenszyklus-Management

Datei	Inhalt
enums.py	ServicePriority, ServiceGroup, ServiceState
iservice.py	IService abstrakte Basisklasse
service_container.py	ServiceContainer mit Abhängigkeitsauflösung

trixy_core.events

Zweck: Event-System (Pub/Sub)

Datei	Inhalt
enums.py	EventPriority
decorators.py	@TrixyEvent, @event_handler
eventmanager.py	EventManager
event_data/base.py	EventData Basisklasse
event_data/basic.py	SatelliteConnected, WakewordReceived, etc.

trixy_core.config

Zweck: Konfigurationsmanagement mit Typisierung

Datei	Inhalt
config_manager.py	ConfigManager mit File-Watching
datasets/server.py	ServerConfig Dataclass
datasets/client.py	ClientConfig Dataclass
datasets/standalone.py	StandaloneConfig Dataclass
datasets/trainer.py	TrainerConfig Dataclass

trixy_core.network

Zweck: Netzwerkprotokoll und Verschlüsselung

Datei	Inhalt
protocol.py	TrixyProtocol, ProtocolFlags
encryption.py	TrixyEncryption (AES-256-GCM)
cmd/base.py	CommandMessage Basisklasse
cmd/satellite.py	SatelliteConnect, SatelliteAccepted, etc.
cmd/wakeword.py	WakewordDetected, WakewordSelected, etc.
cmd/recording.py	RecordingStart, RecordingStop, etc.
cmd/system.py	SystemReboot, SystemStatus, etc.

trixy_core.satellite

Zweck: Satellite-Verwaltung und Registrierung

Datei	Inhalt
satellite.py	Satellite Klasse, ConnectionState
satellite_manager.py	SatelliteManager (Registry)
registration_manager.py	RegistrationManager (60s Timeout)

trixy_core.plugins

Zweck: Plugin-System

Datei	Inhalt
trixy_plugin.py	TrixyPlugin Basisklasse
plugin_manager.py	PluginManager (Laden, Enable/Disable)

Anwendungsklassen

Datei	Klasse	Zweck
application.py	IApplication	Abstrakte Basis
server.py	ServerApplication	Server-Modus
client.py	ClientApplication	Client/Satellite-Modus
standalone.py	StandaloneApplication	Standalone-Modus
trainer.py	TrainerApplication	ML-Training

---

See also: architecture.md, apis.md