Files
swift_companion/docs/pedagogie/00-plan-preparation-soutenance.md
2026-10-21 08:49:37 +02:00

84 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Plan de préparation — dépôt soutenance, doc et code
> **Méthode :** pour chaque lot, l’agent décrit ce qu’il compte faire → **tu valides ou ajustes** → on exécute → on coche.
**Dernière mise à jour :** lot 2 livré (README rendu + `.env.example`).
---
## Décisions validées (lot 0)
| Point | Décision |
|-------|----------|
| Branche `soutenance` | Même contenu que rendu école ; `main` = travail perso ; présentation portable sur `soutenance` |
| PC école | Clone perso → copie `swiftyCompanion/` → supprimer repo perso → `git init` rendu → push Vogosphere (détail §6 fiche dépôt) |
| `.env` | **Uniquement** `swifty_companion/.env` en local ; **jamais** dans Git ; `.env.example` versionné (sujet : échec direct si secrets publics) |
| Fiche orale (lot 3) | **Déroulé de soutenance** détaillé (sujet, points critiques, réalisation, commandes expliquées) — un fichier structuré logiquement |
| Commentaires code | **Français** — sujet ne l’interdit pas |
| Bouton DEBUG | Voir [fiche-depot-soutenance.md §8](fiche-depot-soutenance.md) — pas lié aux secrets ; visible seulement en build debug ; choix garder/retirer avant rendu final |
---
## Où vit quoi
| Zone | Chemin | Git |
|------|--------|-----|
| Travail | racine `swifty_companion/` | Gitea privé (`main`) |
| Rendu / soutenance | `swiftyCompanion/` | Vogosphere + branche `soutenance` |
| Oral long | `docs/pedagogie/` | perso uniquement |
---
## Ordre des lots
| Phase | Lot | Statut |
|-------|-----|--------|
| A | 0 Cadrage | ✅ Validé |
| B | 1 Dépôt + branche | ✅ [fiche-depot-soutenance.md](fiche-depot-soutenance.md) |
| C | 2 README rendu autonome | ✅ fait |
| D | 3 Fiche soutenance orale | ☐ à faire |
| E | 4 Commentaires `lib/` | ☐ à faire |
---
## Lot 2 — Livré
- `swiftyCompanion/README.md` réécrit (autonome, sans lien `docs/`).
- `.env.example` commenté (racine + `swifty_companion/.env.example`).
- `swifty_companion/README.md` : pointeur court vers le README racine.
**Prochaine étape :** dis **« OK lot 3 »** pour la fiche orale détaillée.
---
## Lot 3 — Fiche orale (aperçu du déroulé prévu)
Structure envisagée pour `fiche-soutenance-orale.md` :
1. Introduction (30 s) — sujet, objectif, stack
2. Sécurité & `.env` — encadré sujet, ce qu’est chaque clé OAuth
3. Architecture — 2 vues, services, flux token unique
4. Démo guidée — commandes `flutter doctor`, `test`, `run`, parcours écran par écran
5. Critères obligatoires — comment chaque critère est rempli (renvoi fichiers)
6. Erreurs & edge cases — quoi montrer
7. Bonus refresh — flux + option démo DEBUG
8. Questions fréquentes — réponses courtes
---
## Lot 4 — Commentaires code
`lib/` en français, sans lien vers doc externe ; décision DEBUG bouton documentée en oral.
---
## Suivi
| Lot | Fait ? |
|-----|--------|
| 0 | ✅ |
| 1 | ✅ |
| 2 | ✅ |
| 3 | ☐ |
| 4 | ☐ |