swift_companion/docs/pedagogie/00-reprise-et-etat.md

Reprise du projet — où nous en sommes

Dernière mise à jour : étape 7 bonus (refresh token) codée.

En bref

Fait	Structure dépôt perso, sujet FR, paquet rendu, projet Flutter (swifty_companion/)
Fait	OAuth + token + /v2/me (login connecté)
Fait	Vue 1 recherche + vue 2 profil (skills, projets, ≥ 4 champs)
Prochaine action	Rendu Vogosphere + test manuel bonus (token invalide)

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
    ├── .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 : Flutter, flutter_dotenv, flutter_appauth, http.
3. Secrets : .env local uniquement, jamais commité (modèle dans swiftyCompanion/.env.example).
4. Redirect OAuth mobile : com.example.swiftycompanion://callback (pas localhost sur téléphone physique).
5. Sujet PDF : pas de maquettes d’écrans — l’UI suit la liste des critères obligatoires (sujet FR).

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	OAuth2 (IntraAuthService, /v2/me)	✅ Validé
3	Vue 1 : SearchScreen + IntraUserService + navigation profil	✅ Codé — tester sur téléphone
4	Vue 2 : IntraProfileService + profil (skills, projets, champs)	✅ Codé — tester sur téléphone
5	Retour vue 1 + layout adaptatif (swifty_ui.dart)	✅ Codé — etape-05-navigation-layout.md
6	Checklist soutenance + rendu école	✅ Guide — etape-06-checklist-soutenance.md
7	Bonus : refresh token à expiration	✅ Codé — etape-07-bonus-token.md

Code applicatif (swifty_companion/lib/)

Fichier	Rôle
config/intra_config.dart	.env, URLs OAuth / API
services/intra_auth_service.dart	OAuth + refresh token + GET /v2/me
services/intra_oauth_tokens.dart	Parse réponse /oauth/token
services/intra_user_service.dart	GET /v2/users?filter[login]=
services/intra_profile_service.dart	Profil : user, cursus_users, projects_users
services/intra_api_exception.dart	Erreurs métier
screens/search_screen.dart	Vue 1
screens/profile_screen.dart	Vue 2
theme/swifty_ui.dart	Layout responsive partagé
main.dart	home: SearchScreen()

Reprendre le travail (checklist)

1. Ouvrir le dépôt : ~/projets/42School/swifty_companion
2. Relire le sujet traduit (section obligatoire).
3. Vérifier Flutter : flutter doctor et flutter devices.
4. Lancer l’app (après modification .env, relancer flutter run) :

   cd swiftyCompanion/swifty_companion
   flutter run -d <device>
   

5. Tester le parcours : OAuth → recherche → profil → retour → erreurs réseau.

Fichiers utiles selon le contexte

Tu veux…	Fichier
Préparer la correction (sujet ↔ fichiers)	guide-soutenance-realisation.md
Comprendre le sujet	docs/sujets/swifty-companion.md
Plan complet des étapes	docs/pedagogie/README.md
Vue profil (étape 4)	etape-04-vue-profil.md
Workflow Git travail / école	README racine
Soutenance / peer-eval	swiftyCompanion/README.md

Guides détaillés

Fichier	Statut
etape-02-oauth-intra.md	✅
etape-03-vue-recherche.md	✅
etape-04-vue-profil.md	✅
etape-05-navigation-layout.md	✅
etape-06-checklist-soutenance.md	✅
etape-07-bonus-token.md	✅ piste bonus

Notes pour la session suivante

• Partie obligatoire : prête pour peer-eval si la checklist étape 6 est OK sur device.
• git init dans swiftyCompanion/ quand tu pousses sur Vogosphere (voir README racine).
• Bonus refresh token : étape 7 si tu as le temps après rendu.