guidephase3

2026-09-29 09:39:56 +02:00
parent 987519da5f
commit cb8f98fac0
143 changed files with 5562 additions and 105 deletions
--- a/docs/pedagogie/00-reprise-et-etat.md
+++ b/docs/pedagogie/00-reprise-et-etat.md
@@ -0,0 +1,93 @@
+# Reprise du projet — où nous en sommes
+
+> Dernière mise à jour : projet Flutter créé dans `swiftyCompanion/swifty_companion/`.
+
+## En bref
+
+| | |
+|---|---|
+| **Fait** | Structure dépôt perso, sujet FR, paquet rendu, **projet Flutter** (`swifty_companion/`) |
+| **Pas commencé** | OAuth Intra, les 2 vues, appels API 42 |
+| **Prochaine action** | **Étape 2** — [OAuth2 Intra + token unique](etape-02-oauth-intra.md) |
+
+## Arborescence actuelle
+
+```
+swifty_companion/                    ← dépôt Git de TRAVAIL (perso)
+├── README.md                        ← explique les 2 dépôts Git
+├── .gitignore                       ← ignore docs + swiftyCompanion/.git/
+├── docs/
+│   ├── README.md
+│   ├── sujets/
+│   │   ├── swifty-companion.md      ← sujet traduit (référence)
+│   │   ├── originaux/swifty_companion_subject.pdf
+│   │   └── captures/                ← visuels PDF (couverture uniquement)
+│   └── pedagogie/
+│       ├── README.md                ← plan des étapes
+│       └── 00-reprise-et-etat.md    ← ce fichier
+└── swiftyCompanion/                 ← futur dépôt ÉCOLE (racine Vogosphere)
+    ├── README.md
+    ├── .gitignore
+    ├── .env.example
+    └── swifty_companion/            ← projet Flutter (lib/, android/, pubspec.yaml)
+```
+
+## Décisions déjà prises
+
+1. **Deux dépôts Git** : tout `docs/` et la traduction restent dans le repo perso ; l’Intra ne reçoit que le contenu de `swiftyCompanion/`.
+2. **Stack prévue** : Flutter (cohérent avec `piscine_mobile/`), modifiable en soutenance si justifié.
+3. **Secrets** : `.env` local uniquement, jamais commité (modèle dans `swiftyCompanion/.env.example`).
+4. **Sujet PDF** : pas de maquettes d’écrans — l’UI suit la liste des critères obligatoires ([sujet FR](../sujets/swifty-companion.md)).
+
+## Avancement par étape
+
+| Étape | Contenu | Statut |
+|-------|---------|--------|
+| **0** | Structure, traduction sujet, séparation travail / école, README rendu | ✅ **Terminé** |
+| **1** | Projet Flutter `swiftyCompanion/swifty_companion/` | ✅ **Terminé** |
+| **2** | App OAuth sur l’Intra + flux OAuth2 + token unique réutilisé | ⏳ **En cours — prochaine** |
+| **3** | Vue 1 : recherche login + erreurs (introuvable, réseau) | ⏳ |
+| **4** | Vue 2 : profil (≥ 4 champs + photo), skills, projets (dont failed) | ⏳ |
+| **5** | Retour vue 1 + layout adaptatif | ⏳ |
+| **6** | Passage checklist [swiftyCompanion/README.md](../../swiftyCompanion/README.md) | ⏳ |
+| **7** | Bonus : refresh token à expiration | ⏳ |
+
+## Reprendre le travail (checklist)
+
+1. Ouvrir le dépôt : `~/projets/42School/swifty_companion`
+2. Relire le [sujet traduit](../sujets/swifty-companion.md) (section obligatoire).
+3. Vérifier Flutter : `flutter doctor` et `flutter devices` (voir [piscine — Ubuntu natif](../../../piscine_mobile/docs/pedagogie/flutter/09-ubuntu-natif-dev-android.md) si besoin).
+4. Lancer l’app :
+   ```bash
+   cd swiftyCompanion/swifty_companion
+   flutter run -d <device>
+   ```
+5. **Étape 2** — suivre [etape-02-oauth-intra.md](etape-02-oauth-intra.md) (app OAuth Intra, `.env`, service token unique).
+6. Dans le chat : demander l’**implémentation pas à pas** du code OAuth quand l’app OAuth Intra est créée.
+
+## Fichiers utiles selon le contexte
+
+| Tu veux… | Fichier |
+|----------|---------|
+| Comprendre le sujet | [docs/sujets/swifty-companion.md](../sujets/swifty-companion.md) |
+| Plan complet des étapes | [docs/pedagogie/README.md](README.md) |
+| Workflow Git travail / école | [README racine](../../README.md) |
+| Soutenance / peer-eval | [swiftyCompanion/README.md](../../swiftyCompanion/README.md) |
+| Environnement Flutter | [piscine_mobile](../../../piscine_mobile/README.md) |
+
+## Guides détaillés (à créer au fil du code)
+
+| Fichier prévu | Quand |
+|---------------|--------|
+| `etape-01-flutter-init.md` | Après validation étape 1 |
+| `etape-02-oauth.md` | Début OAuth Intra |
+| `etape-03-vue-recherche.md` | Vue 1 |
+| `etape-04-vue-profil.md` | Vue 2 + API |
+| `etape-05-navigation-layout.md` | Navigation + responsive |
+| `etape-06-bonus-token.md` | Bonus |
+
+## Notes pour la session suivante
+
+- Code : projet Flutter par défaut (`lib/main.dart` compteur) — OAuth et vues à implémenter.
+- Le dépôt perso peut versionner le code dans `swiftyCompanion/` ; le remote **école** pointe uniquement sur ce sous-dossier (voir README racine).
+- Aucun `git init` obligatoire dans `swiftyCompanion/` tant que tu n’es pas prêt à lier Vogosphere.