Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ Supabase
### Bridge .NET

- Connexion/reconnexion SimConnect.
- Client hors processus self-contained Windows x64, limité à la session locale.
- Normalisation, validation et agrégation de la télémétrie.
- Machine à états de vol déterministe et rejouable.
- Rapport de vol versionné.
Expand Down Expand Up @@ -162,3 +163,6 @@ de caractérisation malgré l'absence de migration de code.
- `ADR-0002` : réécriture totale isolée dans un nouveau dépôt ; ancien dépôt
conservé comme référence en lecture seule, nouveau schéma sans migration des
données de développement et une seule bascule publique après parité.
- `ADR-0003` : Windows 11 x64 maintenu et MSFS 2024 stable uniquement ; Store et
Steam sont validés séparément, sans support Windows 10, ARM64, MSFS 2020,
Insider ou Preview. WebView2 Evergreen et bridge .NET self-contained.
18 changes: 15 additions & 3 deletions docs/CURRENT_STATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,11 +168,23 @@ Il n'y aura ni coexistence en production, ni double écriture, ni ancien client
connecté au nouveau backend. Une seule bascule publique est prévue après les
gates de caractérisation, SimConnect, parité, restauration et distribution.

## Décision de support

`ADR-0003` retient Windows 11 x64, sur une version publique encore maintenue par
Microsoft, et MSFS 2024 stable uniquement. Microsoft Store/Xbox App et Steam sont
deux combinaisons distinctes qui restent `Unsupported — validation requise`
jusqu'à une fiche de test réelle par canal. Windows 10, ARM64, MSFS 2020,
Windows Insider et les builds MSFS Beta/Preview sont `Unsupported`.

Une machine Ryzen 7 5800X, 32 Go et RX 6070 XT est disponible comme profil
recommandé de validation. Elle ne prouve pas le minimum matériel. Aucun test
MSFS réel n'a été exécuté dans T0004.

## Prochain ticket recommandé

Créer et exécuter un ticket borné de caractérisation du golden path et des traces
SimConnect avant le nouveau socle. La matrice Windows/MSFS reste planifiée dans
T0004.
`T0005 — Budgets stabilité et performance`. Il doit mesurer et fixer les budgets
du profil minimum/recommandé. Les preuves Store/Steam et les replays SimConnect
seront réalisés lors du premier vertical slice bridge.

## Mise à jour de ce fichier

Expand Down
2 changes: 2 additions & 0 deletions docs/KNOWN_ISSUES.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ Statut : `Open`, `Accepted`, `Scheduled`, `Resolved`, `Invalid`.
| KI-008 | High | Rebuild | Une réécriture totale peut omettre des comportements actuels non caractérisés. | ADR-0002 : couverture automatisée faible face au périmètre existant | Caractérisation du golden path | Open |
| KI-009 | High | Bridge | Aucun corpus de traces SimConnect rejouables n'est fourni pour prouver la parité du moteur de vol. | T0001 et ADR-0002 | Premier vertical slice SimConnect | Open |
| KI-010 | High | Release | Après création de données réelles dans le nouveau schéma, aucun retour vers l'ancien produit ne sera possible. | ADR-0002 : nouveau schéma sans compatibilité descendante | Phase 6 | Accepted |
| KI-011 | High | Support | Aucune preuve réelle distincte ne valide encore MSFS 2024 Microsoft Store/Xbox App et Steam ; une seule machine de test est disponible. | T0004 et proposition ADR-0003 | Validation plateformes / premier vertical slice SimConnect | Open |
| KI-012 | Medium | Support | Le profil matériel minimum Thrustline n'est pas mesuré ; la machine Ryzen 7 5800X, 32 Go, RX 6070 XT ne prouve que le profil recommandé cible. | Réponses Andy et ADR-0003 | T0005 | Open |

## Règles

Expand Down
7 changes: 5 additions & 2 deletions docs/PRODUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,8 +78,11 @@ ADR. Ne pas ajouter partiellement du multi-utilisateur.

## Contraintes de distribution

- Windows 10/11 à confirmer par matrice de tests.
- MSFS 2020/2024 et éditions réellement supportées à documenter.
- Windows 11 x64 uniquement, version publique encore maintenue par Microsoft.
- MSFS 2024 stable uniquement ; Microsoft Store/Xbox App et Steam sont deux
combinaisons distinctes à prouver avant toute déclaration `Supported`.
- Windows 10, ARM64, MSFS 2020, Windows Insider et MSFS Beta/Preview sont exclus
conformément à `ADR-0003`.
- Aucun privilège administrateur permanent.
- Données utilisateur séparées des fichiers d'installation.
- Politique de confidentialité, support, sécurité et licence avant bêta publique.
Expand Down
15 changes: 10 additions & 5 deletions docs/QUALITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,12 @@ résultat.

### Manuel MSFS

- MSFS fermé, lancement tardif et redémarrage.
- Vol normal, touch-and-go, go-around, pause, slew et accélération temporelle.
- Perte réseau pendant et après le vol.
- Plusieurs appareils/add-ons représentatifs.
- Exécuter les quatorze scénarios définis par `ADR-0003` pour la première
promotion de chaque canal MSFS 2024 vers `Supported`.
- Conserver une fiche distincte Store/Steam dans `docs/validation/platforms/`
avec versions exactes, commit, appareil, résultat, testeur, anomalies et trace.
- Après Sim Update, exécuter au minimum les scénarios smoke 1–5, 9–11 et 14 avant
de retirer l'état `Compatibility pending`.

## Matrice de validation par zone

Expand All @@ -49,6 +51,7 @@ résultat.
| Contrat transverse | tests de contrat + builds des consommateurs |
| Sécurité | scénario d'abus et contrôle rejeté |
| Release | VM propre, signature, upgrade et rollback |
| Plateforme `Supported` | fiche réelle Windows/MSFS par canal + protocole ADR-0003 |

## Budgets initiaux à fixer en phase 0

Expand Down Expand Up @@ -81,6 +84,9 @@ Le Completion Report conserve :
- étapes manuelles et résultat ;
- capture ou extrait uniquement si utile et sans donnée sensible.

Une documentation fournisseur ou un test effectué sur un autre canal MSFS ne
remplace jamais la fiche réelle exigée pour une combinaison `Supported`.

## Release gate

Une release publique exige :
Expand All @@ -93,4 +99,3 @@ Une release publique exige :
- SBOM/checksums/provenance ;
- parcours critiques sur VM propre ;
- notes de version, limitations et procédure de rollback.

9 changes: 6 additions & 3 deletions docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,17 @@ Objectif : rendre l'existant mesurable et décider ce que l'on reconstruit.
- Inventaire reproductible, tests/builds et matrice de dépendances.
- Décision du modèle produit : MVP solo connecté préparé pour une collaboration
ultérieure (`ADR-0001`, acceptée).
- Matrice Windows/MSFS supportée.
- Matrice Windows/MSFS acceptée (`ADR-0003`) : Windows 11 x64 et MSFS 2024
stable, Store et Steam prouvés séparément.
- Budgets stabilité/performance et politique de données.
- Stratégie acceptée : réécriture totale isolée dans un nouveau dépôt
(`ADR-0002`), sans migration des données de développement.
- Environnements dev/staging/prod documentés.

Gate : baseline verte ou écarts connus, ADR majeures acceptées, périmètre MVP
gelé et golden path à caractériser identifié.
gelé, golden path à caractériser identifié et protocole de preuve plateforme
défini. La promotion effective d'un canal MSFS vers `Supported` peut intervenir
avec les tests réels du vertical slice.

## Phase 1 — Socle reproductible

Expand Down Expand Up @@ -92,7 +95,7 @@ Objectif : produire une bêta installable et récupérable.
- Updater signé, canaux stable/bêta et rollback.
- Logs redigés, diagnostics consentis et crash reporting.
- Politique sécurité, confidentialité, licence et support.
- Tests VM Windows/MSFS.
- Tests Windows 11 x64/MSFS 2024 sur Store et Steam, avec fiches ADR-0003.

Gate : installation, upgrade N-1, rollback et désinstallation validés.

Expand Down
111 changes: 111 additions & 0 deletions docs/SUPPORT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
# Plateformes prises en charge

Dernière mise à jour : 24 juillet 2026
Décision acceptée : `ADR-0003`

Thrustline cible une application desktop **Windows 11 x64** connectée localement
à **Microsoft Flight Simulator 2024**. Le support Xbox console, Cloud Gaming et
PlayStation n'est pas possible : l'application et son client SimConnect doivent
fonctionner sur le même PC Windows.

## Signification des niveaux

- **Supported** : combinaison testée réellement pour la release, documentée et
prise en charge en cas d'incident.
- **Compatible** : test réel concluant, sans garantie à chaque release.
- **Experimental** : fonctionnement attendu mais couverture insuffisante. Ce
niveau n'est pas utilisé actuellement sur décision produit.
- **Unsupported** : combinaison exclue ou pas encore validée.

`Compatibility pending` signifie qu'une combinaison auparavant `Supported` est
en cours de revalidation après une mise à jour.

## Matrice actuelle

### Windows

| Système | Architecture | Niveau |
| --- | --- | --- |
| Windows 11 Home/Pro, version publique encore maintenue par Microsoft | x64 | **Unsupported — validation requise**, cible `Supported` |
| Windows 11 Enterprise/Education maintenu | x64 | **Unsupported — validation requise**, cible `Compatible` |
| Windows 11 Insider/Preview | x64 | **Unsupported** |
| Windows 11 ARM64 | ARM64 | **Unsupported** |
| Windows 10 | toute | **Unsupported** |
| Windows Server, Wine/Proton | toute | **Unsupported** |

Une version Windows arrivée en fin de support Microsoft n'est pas supportée par
Thrustline.

### Microsoft Flight Simulator

| Simulateur | Canal | Niveau |
| --- | --- | --- |
| MSFS 2024 stable | Microsoft Store/Xbox App | **Unsupported — validation requise**, cible `Supported` |
| MSFS 2024 stable | Steam | **Unsupported — validation requise**, cible `Supported` |
| MSFS 2024 Beta/Sim Update Preview | Store ou Steam | **Unsupported** |
| MSFS 2020 | Store ou Steam | **Unsupported** |
| MSFS sur console/cloud | tout | **Unsupported** |

Aucune ligne n'est encore `Supported`, car T0004 est documentaire et n'a exécuté
aucun vol réel. Les canaux Store et Steam doivent chacun réussir leur propre
validation ; le résultat de l'un ne prouve pas l'autre.

## Prérequis

- Windows 11 x64 maintenu et à jour.
- Session utilisateur standard ; aucun droit administrateur permanent.
- WebView2 Evergreen présent et maintenu. L'installateur doit le vérifier et
proposer sa réparation officielle s'il manque.
- Connexion Internet pour l'authentification et les fonctions cloud.
- MSFS 2024 lancé dans la même session Windows que Thrustline.
- Le compte ayant acheté ou installé MSFS peut être différent si le simulateur
démarre normalement dans cette session et si SimConnect local fonctionne sans
contourner les permissions.

Le bridge .NET doit être livré avec son runtime. L'utilisateur ne doit installer
ni SDK .NET, ni outils de développement, ni SDK MSFS.

## Profils matériels

Les exigences propres à Thrustline restent provisoires jusqu'aux mesures T0005.
Les exigences officielles de MSFS 2024 s'ajoutent séparément.

| Profil | Configuration Thrustline |
| --- | --- |
| Minimum supporté, à valider | CPU x64 moderne 4 cœurs, 16 Go de RAM, 2 Go libres hors MSFS, Windows 11 maintenu, écran 1280×720 à 100–150 % |
| Recommandé | Ryzen 7 5800X ou équivalent, 32 Go, 4 Go libres hors MSFS, écran 1920×1080 à 100–150 % |
| CI/replay sans MSFS | 4 vCPU x64, 8 Go, 10 Go pour sources/caches/artefacts, Windows 11, écran virtuel 1920×1080 |

La machine de validation disponible possède un Ryzen 7 5800X, 32 Go de RAM et
un GPU RX 6070 XT confirmé par le propriétaire de la machine.

## Quand une mise à jour arrive

Après une feature update Windows ou une Sim Update MSFS, une combinaison déjà
supportée peut passer temporairement `Compatibility pending`. Thrustline :

1. relève les versions sans collecter de donnée personnelle ;
2. exécute les smoke tests, puis le golden path ;
3. publie les limitations connues sans promettre un délai de confirmation ;
4. rétablit `Supported` uniquement après une nouvelle fiche de preuve ;
5. laisse l'application démarrer avec un avertissement lorsque c'est sûr.

Un blocage ou kill switch n'est autorisé qu'en cas de risque réel de corruption,
double clôture, perte de données ou sécurité. La lecture et la récupération des
données doivent rester disponibles autant que possible.

## Ce qui est testé

La première promotion d'un canal vers `Supported` exige les 14 scénarios :
MSFS fermé ; ordres de lancement ; reconnexion ; menu/chargement/vol ; vol normal ;
go-around/touch-and-go ; pauses/accélération ; slew/téléportation ; retour menu et
changement d'appareil ; crash MSFS ; perte Internet ; vol long ; avion natif et
add-on ; variable SimConnect absente ou invalide.

Chaque preuve indique la version Thrustline, le commit, Windows/build, MSFS/build
et canal, l'appareil, le scénario, le résultat, la date, le testeur, les anomalies
et la trace de replay. Les futures fiches seront conservées dans
`docs/validation/platforms/`.

Le protocole détaillé et les sources officielles sont dans
`docs/decisions/ADR-0003-matrice-support-windows-msfs.md`.
Loading
Loading