AeroAlign/docs/AIRCRAFT_PROFILE_MODEL.md

Aircraft Profile Model

Zweck

Diese Datei ist die verbindliche Fachvorgabe fuer das Modul, das AeroAlign und CoG gemeinsam bedienen soll.

Sie legt fest:

• welche Flugzeugprofile es gibt
• welche Flaechenarten unterschieden werden
• welche Workflows pro Profil aktiv sind
• welche Spezialfaelle ausdruecklich anders behandelt werden

Begriffe

Feste Flaechen

Feste, nicht verstellte aerodynamische Referenzflaechen.

Beispiele:

• Tragflaeche
• Dämpfungsflosse Hoehenleitwerk
• Dämpfungsflosse Seitenleitwerk
• feste Canard-Flaeche

Bewegliche Flaechen

Aktiv angelenkte Flaechen oder Klappen.

Beispiele:

• Querruder
• Hoehenruder
• Seitenruder
• Wölbklappe
• Spoiler
• Taileron
• Pendelleitwerk

Referenzflaeche

Die Flaeche, gegen die eine andere Flaeche gemessen wird.

Regel:

Bewegliche Flaechen werden gegen ihre zugehoerige feste Referenz gemessen, nicht pauschal gegen andere bewegliche Flaechen.

Grundsaetze

1. EWD / Referenzgeometrie ist ein eigener Workflow.
2. CG / Schwerpunkt ist ein eigener Workflow.
3. Ruder- und Klappeneinstellung ist ein eigener Workflow.
4. 90 Grad Servoarm ist keine universelle Fachregel und darf nur als optionale Montagehilfe behandelt werden.
5. Pendelleitwerk und Taileron sind keine normalen Hoehenruder.

Profiltypen

1. classic

Klassisches Flaechenflugzeug mit:

• Tragflaeche
• Dämpfungsflosse Hoehenleitwerk
• Hoehenruder
• Dämpfungsflosse Seitenleitwerk
• Seitenruder
• Querruder

Aktive Workflows:

• reference
• surfaces
• cog
• spaeter throw

MVP-Status:

• dies ist das primäre Startprofil fuer das System

2. jet_taileron

Jet mit kombiniertem Hoehen-/Querruder an beweglichen Heckflaechen.

Merkmale:

• keine klassische Trennung zwischen Hoehenruder und Querruder hinten
• linke und rechte Tailerons muessen symmetrisch und differenziert pruefbar sein

Aktive Workflows:

• reference
• surfaces
• cog
• spaeter mixing_check

Sonderregel:

Tailerons werden nicht wie normale Hoehenruder gegen eine Dämpfungsflosse behandelt.

3. stabilator

All-flying stabilizer oder Pendelhöhenleitwerk.

Merkmale:

• gesamte Flaeche bewegt sich
• keine feste Dämpfungsflosse als lokale Referenzflaeche

Aktive Workflows:

• reference
• surfaces
• cog

Sonderregel:

Die bewegliche Gesamtflaeche wird gegen eine externe Referenz gemessen, typischerweise Tragflaeche oder definierte Vorrichtung.

4. glider_flap

Segler mit Querrudern, Wölbklappen und oft mehreren Flugphasen.

Merkmale:

• Grundneutralstellung kann je nach Flugphase bewusst nicht null sein
• Butterfly, Speed, Thermik und Cruise koennen unterschiedliche Sollwerte haben

Aktive Workflows:

• reference
• surfaces
• cog
• spaeter flight_mode_offsets

5. delta_elevon

Delta oder Nurfluegel mit kombinierten Elevons.

Merkmale:

• keine klassische EWD wie beim Leitwerksflugzeug
• linke und rechte Elevons sind kombinierte Hoehen-/Querruderflaechen

Aktive Workflows:

• reference
• surfaces
• cog

Sonderregel:

Es gibt keine klassische Leitwerksreferenz. Das Profil darf keine Leitwerkslogik erzwingen.

Flaechentypen fuer das Datenmodell

Das Modul soll mindestens folgende Typen unterscheiden:

• wing_reference
• tailplane_fixed
• fin_fixed
• aileron
• elevator
• rudder
• flap
• spoiler
• taileron
• stabilator
• elevon
• canard_fixed
• canard_control

Workflow-Freigabe pro Profil

Profil	Reference	Surfaces	CoG	Throw später	Speziallogik
classic	ja	ja	ja	ja	gering
jet_taileron	ja	ja	ja	ja	hoch
stabilator	ja	ja	ja	ja	hoch
glider_flap	ja	ja	ja	ja	mittel
delta_elevon	ja	ja	ja	ja	hoch

Messregeln pro Flaechenart

Querruder

Gegen:

• linke oder rechte Tragflaechenreferenz

Hoehenruder

Gegen:

• Dämpfungsflosse Hoehenleitwerk

Seitenruder

Gegen:

• Dämpfungsflosse Seitenleitwerk

Wölbklappen

Gegen:

• zugehoerige Tragflaechenreferenz

Hinweis:

Die Sollstellung muss nicht 0.0 sein.

Taileron

Gegen:

• profilabhaengige Heckreferenz oder externe Referenz

Stabilator

Gegen:

• externe Referenzflaeche

Nicht gegen:

• nicht vorhandene Dämpfungsflosse

UI-Folgen

Die UI darf nicht einfach fuer alle Modelle dieselben Labels oder Buttons anzeigen.

Pflicht:

• Profilwahl beim Anlegen des Modells
• sprechende Flaechenrollen
• nur die fuer das Profil gueltigen Workflows anzeigen
• Sonderflaechen mit eigenen Begriffen benennen

Beispiele:

• Elevator nur bei classic
• Stabilator bei stabilator
• Taileron Left/Right bei jet_taileron
• Flap Left/Right bei glider_flap

MVP-Grenze

Fuer den ersten echten Produktstand soll das Modul fachlich vorbereitet sein, aber operativ auf classic optimiert werden.

MVP in der Praxis:

• klassische Tragflaeche
• Dämpfungsflosse Hoehenleitwerk
• Hoehenruder
• Querruder links/rechts
• Seitenruder optional
• CoG-Messung

Andere Profile muessen im Datenmodell vorgesehen sein, auch wenn sie anfangs noch nicht vollstaendig in der UI freigeschaltet sind.

Verbindliche Anweisung fuer die weitere Implementierung

1. Keine harte Verdrahtung auf nur elevator, aileron, rudder.
2. Workflow-Entscheidungen muessen profilabhaengig sein.
3. EWD, CG und surface setup bleiben getrennte Modi.
4. Dämpfungsflosse ist der Standardbegriff fuer den feststehenden Leitwerksteil.
5. 90 Grad Servoarm darf nie als alleinige Sollbedingung modelliert werden.