# 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](architecture.md), [apis.md](apis.md)