Documentatie in bèta. Sommige tekst en afbeeldingen zullen worden herwerkt naarmate de app zich nestelt in 1.0. Als een sectie verouderd is, markeer deze dan via de feedbackformulier.

Ondersteuningsbundels

Een ondersteuningsbundel is een enkele ZIP die de staat van de bridge weergeeft op het moment dat er iets misging. Het is het enige artefact waar we naar zullen vragen bij het beoordelen van een ticket. Op deze pagina wordt beschreven wat er precies in zit, zodat u weet wat u verzendt.

Hoe exporteer je er een?

  1. Open FFB-Bridge en navigeer naar Diagnostiek.
  2. Klik Ondersteuningsbundel exporteren (rechtsboven).
  3. Na een korte vertraging toont een banner de bestandsnaam en -grootte, met Onthullen en Feedbackformulier openen knoppen.
  4. Klik Feedbackformulier openen — de feedbackpagina wordt geopend met uw bundel al bijgevoegd.
FFB-Bridge Diagnostics-pagina na het exporteren van een ondersteuningsbundel, met de resultaatbanner met Reveal- en Open-feedback-form-acties
Figure 1. Exportstroom: knop Diagnostische pagina, vervolgens de banner met bestandsnaam en acties Onthullen/openen feedbackformulier.

Wat zit er in de bundel

Een bundel is een gewone ZIP. De onderstaande bestandsnamen vormen de volledige toelatingslijst; de bundel ook nooit iets buiten deze set bevatten.

sysinfo.txt

Systeemmetadata. Platte tekst, sleutel:waarderegels. Velden:

  • os — “windows” of “linux”.
  • os-version — kernelversie of Windows-buildstring.
  • distro — on Linux, /etc/os-release PRETTY_NAME.
  • cpu-model, cpu-cores — from /proc/cpuinfo of Win32_Processor.
  • ram-total-mb — from /proc/meminfo of Win32_ComputerSystem.
  • dotnet-version — runtime-versie van het gebundelde .NET.
  • platform — expliciete sleutel voor de Linux-vs-Windows-tak.
  • locale — huidige gebruikerslandinstelling.
  • bridge-version, build-hash — bridge-versie en git SHA tijdens het bouwen.

sessie.log

Volledig gebeurtenislogboek voor de huidige sessie. Dezelfde inhoud als de logboekstrook op de Diagnostische pagina, maar inclusief alles vanaf de lancering, niet alleen wat zichtbaar is. UTF-8.

last-crash.log

Als de vorige lancering is gecrasht, komt het crashlog hier terecht. Stacktrace, threaddumps, de laatste paar logregels voor de crash. Afwezig als de sessie niet is gecrasht.

dokter.json

Meest recente Doctor-paginascan in machinaal leesbare vorm. Elke rij bevat de naam van de cheque, de status (geslaagd/waarschuwing/mislukt/n.v.t.) en de onbewerkte detailreeks. Hierdoor kunnen we uw doktersstatus zien zonder dat u schermafbeeldingen hoeft te plakken.

tuneables.yaml

De waarden van het actieve afstemmingsprofiel op het moment van exporteren. Hetzelfde schema als een opgeslagen profiel. Wordt gebruikt om de exacte krachtconfiguratie waarmee u vloog te reproduceren.

simconnect-config.xml

MSFS's SimConnect.xml als de brug er één kon lezen, met welke dan ook <Password> inzendingen gestript. Afwezig als u zich tijdens de export in X-Plane of Mock bevond.

Wat zit er NIET in de bundel

De ondersteuningsbundelbouwer gebruikt een strikte toelatingslijst met bestandsnamen. Het zal niets bevatten buiten die lijst, zelfs als er iets dat overeenkomt in dezelfde map aanwezig is. In het bijzonder:

  • Geen opgeslagen wachtwoorden of inloggegevens. De brug slaat niets op.
  • Geen profielbestanden anders dan de actieve.
  • Geen systeemlogboeken, journaals of iets anders buiten de eigen gegevensmappen van de bridge.
  • Geen netwerkpakketopnamen.
  • Geen cloudtokens (de bridge gebruikt er geen).

Verwerking aan de serverzijde

Wanneer u een bundel aan een feedbackrapport koppelt, parseert de intakemedewerker van de site deze om nuttige indexeerbare gegevens in onze database te extraheren:

  • Systeeminformatie in een samenvattende rij voor groepering (“hoeveel rapporten van deze distro?”).
  • Waarschuwings- en foutregels uit het logboek, met stabiele foutsignaturen, zodat we in één oogopslag kunnen zien hoeveel mensen dezelfde bug tegenkomen.
  • Resultaten van dokterscontroles voor een overzicht van wat er in de gebruikersbasis misgaat.
  • De letterlijke bestandstekst van elk item op de toelatingslijst, opgeslagen zodat we de context opnieuw kunnen lezen tijdens de triage.

De onbewerkte bundel zelf wordt gedurende een korte periode (standaard 30 dagen) bewaard, zodat we deze opnieuw kunnen parseren als onze extractielogica verbetert. Daarna worden de geparseerde gegevens bewaard; de ruwe klodder wordt verwijderd.

Grenzen

LimietWaarde
Totale grootte bundel50MB gecomprimeerd
Ongecomprimeerde grootte per item5MB
Maximale inzendingen30
Totaal ongecomprimeerd20MB
CoderingAlleen UTF-8-tekstbestanden (plus de XML)

In de praktijk bedraagt een normale bundel minder dan een megabyte. Deze limieten zijn er om vijandige uploads uit te sluiten, niet om echte rapporten uit te sluiten.

Verzenden zonder het feedbackformulier

Als je de bundel liever rechtstreeks wilt e-mailen, schrijf dan naar feedback·ffb-bridge.com (vervang de · door een @) en bevestig de ZIP. De server-side parser werkt niet voor e-mail, dus de triage is langzamer, maar de bundel is net zo bruikbaar.