234 lines
8.4 KiB
Markdown
234 lines
8.4 KiB
Markdown
# Fiche — dépôt de soutenance, branche `soutenance`, PC école
|
||
|
||
> **Lot 1** du [plan de préparation](00-plan-preparation-soutenance.md).
|
||
> **Validé :** branche `soutenance` = même contenu que Vogosphere ; travail quotidien sur `main` ; `.env` local uniquement ; `.env.example` dans le rendu Git.
|
||
|
||
---
|
||
|
||
## 1. Ce que dit le sujet (sécurité — **éliminatoire**)
|
||
|
||
Traduction du PDF v4, chapitre IV (encadré page 5) :
|
||
|
||
> Les identifiants, clés API, variables d’environnement, etc. doivent être stockés **localement** dans un fichier **`.env`** et **ignorés par git**. Des identifiants exposés **publiquement** entraînent **l’échec direct** du projet.
|
||
|
||
**À retenir pour le rendu :**
|
||
|
||
| Fichier | Dans le Git école (Vogosphere) ? |
|
||
|---------|----------------------------------|
|
||
| `.env` (avec vrais secrets) | **NON — jamais** |
|
||
| `.env.example` (modèle vide + explications) | **OUI** |
|
||
| `.gitignore` qui ignore `.env` | **OUI** |
|
||
|
||
Le correcteur crée **son** `.env` sur sa machine à partir de `.env.example` + **son** app OAuth Intra (ou la tienne en démo, **sans** committer les valeurs).
|
||
|
||
---
|
||
|
||
## 2. Où mettre le `.env` pour que l’app tourne
|
||
|
||
Flutter charge le fichier déclaré dans `pubspec.yaml` :
|
||
|
||
```yaml
|
||
assets:
|
||
- .env
|
||
```
|
||
|
||
→ chemin **obligatoire pour l’exécution** :
|
||
|
||
```text
|
||
swiftyCompanion/swifty_companion/.env
|
||
```
|
||
|
||
| Fichier | Rôle |
|
||
|---------|------|
|
||
| `swifty_companion/.env` | **Secrets réels** — machine locale (portable, école en démo) — **gitignore** |
|
||
| `swiftyCompanion/.env.example` | **Modèle** à la racine du paquet rendu — **versionné** |
|
||
| `swiftyCompanion/.env` (racine paquet) | **Inutile** pour Flutter — à **ne pas** utiliser pour éviter la confusion (tu peux le supprimer en local) |
|
||
|
||
**Procédure correcteur / toi :**
|
||
|
||
```bash
|
||
cd swiftyCompanion/swifty_companion
|
||
cp ../.env.example .env
|
||
# Éditer .env : CLIENT_ID, CLIENT_SECRET, REDIRECT_URI
|
||
flutter pub get
|
||
flutter run -d <device>
|
||
```
|
||
|
||
*(Le lot 2 enrichira `.env.example` avec commentaires détaillés par variable.)*
|
||
|
||
---
|
||
|
||
## 3. Contenu exact du dépôt école (Vogosphere)
|
||
|
||
**Racine du dépôt Intra** = contenu du dossier `swiftyCompanion/` (pas le repo perso entier).
|
||
|
||
```text
|
||
swiftyCompanion/ ← racine Git Vogosphere
|
||
├── README.md
|
||
├── .gitignore
|
||
├── .env.example
|
||
└── swifty_companion/ ← projet Flutter
|
||
├── pubspec.yaml
|
||
├── lib/
|
||
├── android/
|
||
├── test/
|
||
└── …
|
||
```
|
||
|
||
**Ne doit pas apparaître dans Vogosphere :**
|
||
|
||
- `docs/` (sujet traduit, pédagogie, fiches orale)
|
||
- tout `.env` avec secrets
|
||
- dépôt Gitea perso, liens vers guides internes
|
||
|
||
---
|
||
|
||
## 4. Deux Git, deux rôles
|
||
|
||
| Dépôt | Remote typique | Contenu |
|
||
|-------|----------------|---------|
|
||
| **Perso** | Gitea privé | `docs/` + `swiftyCompanion/` (travail) |
|
||
| **École** | Vogosphere | **uniquement** `swiftyCompanion/` à la racine |
|
||
|
||
Sur le **portable**, tu continues à coder sur **`main`** (perso). Quand le rendu est prêt, tu mets à jour la branche **`soutenance`** (voir §5) — c’est la référence « propre » pour présenter et pour préparer le push école.
|
||
|
||
---
|
||
|
||
## 5. Branche `soutenance` (portable)
|
||
|
||
### Objectif
|
||
|
||
- Même **arbre utile** que Vogosphere : tout sous `swiftyCompanion/` à jour et fonctionnel.
|
||
- Tu **peux** continuer à développer sur `main` ; `soutenance` ne bouge que quand tu **décides** de figer une version pour correction.
|
||
- En soutenance sur **ton PC** : tu ouvres le projet dans `swiftyCompanion/swifty_companion/` (pas besoin d’afficher `docs/` à l’écran).
|
||
|
||
### Méthode recommandée (monorepo perso)
|
||
|
||
```bash
|
||
cd ~/projets/42School/swifty_companion
|
||
|
||
# 1) Finir les modifs sur main (swiftyCompanion + éventuellement docs)
|
||
git checkout main
|
||
git status # rien de secret à committer
|
||
|
||
# 2) Mettre à jour soutenance (merge depuis main)
|
||
git checkout soutenance # créer une fois : git checkout -b soutenance
|
||
git merge main # ou cherry-pick des commits rendu uniquement
|
||
|
||
# 3) Vérifier que seul le paquet rendu est cohérent
|
||
cd swiftyCompanion/swifty_companion
|
||
flutter analyze && flutter test
|
||
# .env présent en local, absent du git :
|
||
git -C ../.. ls-files | rg '\.env' # doit montrer seulement .env.example
|
||
```
|
||
|
||
**Présentation :** `git checkout soutenance`, lancer `flutter run` depuis `swifty_companion/`.
|
||
|
||
**Travail après soutenance :** retour sur `main`, nouvelles features ; avant rendu final, re-merge vers `soutenance`.
|
||
|
||
### Alternative (si tu préfères un repo Git **uniquement** dans `swiftyCompanion/`)
|
||
|
||
- `git init` dans `swiftyCompanion/`, remote Vogosphere.
|
||
- Branche `main` = école, branche `dev` optionnelle.
|
||
- Le monorepo perso ne versionne plus le code Flutter (plus lourd à maintenir). **Tu as choisi le monorepo + branche `soutenance`** — la méthode ci-dessus suffit.
|
||
|
||
---
|
||
|
||
## 6. Ton scénario **PC école** (push Vogosphere)
|
||
|
||
C’est le flux que tu as décrit — formalisé pour ne rien oublier.
|
||
|
||
### Prérequis
|
||
|
||
- Branche `soutenance` à jour sur Gitea **ou** dossier `swiftyCompanion/` prêt sur clé USB / copie.
|
||
- `.env` **sur la clé ou la machine école** pour la démo (fichier local, **pas** dans le commit).
|
||
- URL du dépôt **Vogosphere** (Intra 42).
|
||
|
||
### Étapes sur le PC école
|
||
|
||
```bash
|
||
# A — Récupérer le travail (une fois)
|
||
cd ~
|
||
git clone https://ton-gitea/.../swifty_companion.git
|
||
cd swifty_companion
|
||
git checkout soutenance
|
||
|
||
# B — Préparer le dossier de rendu (contenu école pur)
|
||
# Option simple : le rendu EST le sous-dossier swiftyCompanion
|
||
cd ~/chemin/attendu/par/l/ecole # répertoire de rendu du sujet
|
||
rm -rf ./* # seulement si dossier vide / dédié — attention !
|
||
cp -a ~/swifty_companion/swiftyCompanion/. .
|
||
|
||
# C — Retirer le dépôt perso de la machine école (optionnel mais ton choix)
|
||
rm -rf ~/swifty_companion
|
||
|
||
# D — Git ÉCOLE uniquement dans le répertoire de rendu
|
||
cd ~/chemin/attendu/par/l/ecole
|
||
git init
|
||
git remote add origin <url-vogosphere-swifty_companion>
|
||
git add .
|
||
git status # VÉRIFIER : pas de .env, pas de docs/
|
||
|
||
git commit -m "Rendu Swifty Companion"
|
||
git push -u origin main
|
||
```
|
||
|
||
### Contrôles avant `git push` (checklist)
|
||
|
||
- [ ] `git status` ne liste **aucun** `.env`
|
||
- [ ] `.env.example` est présent et **sans** vraies clés
|
||
- [ ] Pas de dossier `docs/` du dépôt perso
|
||
- [ ] `flutter test` OK dans `swifty_companion/`
|
||
- [ ] README à la **racine** du clone Vogosphere (pas un niveau au-dessus)
|
||
|
||
---
|
||
|
||
## 7. Portable = démo = même binaire « logique » que l’école
|
||
|
||
| Action | Portable (`soutenance`) | Vogosphere |
|
||
|--------|-------------------------|------------|
|
||
| Code Flutter | `swiftyCompanion/swifty_companion/` | idem |
|
||
| Secrets | `.env` local | jamais poussé |
|
||
| Doc longue oral | `docs/pedagogie/` (perso) | absent |
|
||
| README correcteur | `swiftyCompanion/README.md` | idem |
|
||
|
||
---
|
||
|
||
## 8. Point « DEBUG » dans l’app (éclaircissement)
|
||
|
||
Ce n’est **pas** un fichier `.env` ni un secret.
|
||
|
||
Dans `search_screen.dart`, un bouton **« DEBUG : simuler token expiré »** n’apparaît que si `kDebugMode` est vrai (build **debug**, ex. `flutter run`). Il **n’existe pas** dans un APK **release** (`flutter build apk --release`).
|
||
|
||
| Question | Réponse |
|
||
|----------|---------|
|
||
| Le sujet l’interdit ? | **Non** — rien dans le PDF sur les boutons de debug. |
|
||
| Risque en soutenance ? | L’évaluateur peut le voir en `flutter run` ; tu peux l’expliquer pour le **bonus refresh**, ou le retirer avant rendu final si tu veux une UI plus « propre ». |
|
||
| Décision (lot 4) | **Garder** — le bonus sujet = refresh token ; le bouton ne fait qu’**invalider l’access** en debug pour tester le refresh sans attendre l’expiration. Absent en `flutter build apk --release`. |
|
||
|
||
→ Démo orale : [fiche-soutenance-orale.md](fiche-soutenance-orale.md) §7.
|
||
|
||
---
|
||
|
||
## 9. Commentaires en français dans le code
|
||
|
||
Le sujet n’impose pas la langue des commentaires. **Français = OK** (lot 4).
|
||
|
||
---
|
||
|
||
## 10. Prochaines étapes (autres lots)
|
||
|
||
| Lot | Document / action |
|
||
|-----|-------------------|
|
||
| 2 | README rendu + `.env.example` commenté (sans ton « IA ») |
|
||
| 3 | `fiche-soutenance-orale.md` — déroulé minute par minute + commandes |
|
||
| 4 | Commentaires `lib/` + décision finale bouton DEBUG |
|
||
|
||
---
|
||
|
||
## 11. Liens
|
||
|
||
- Plan global : [00-plan-preparation-soutenance.md](00-plan-preparation-soutenance.md)
|
||
- Sujet sécurité : [swifty-companion.md](../sujets/swifty-companion.md) § IV
|
||
- PDF : [originaux/swifty_companion_subject.pdf](../sujets/originaux/swifty_companion_subject.pdf)
|