LearnKorean — synthèse du besoin
Statut : validé le 2026-07-19 (phase 1). Repo : leon/learnkoreanapp
(à créer en phase 3). Dossier : ~/projets/devapp/learnkoreanapp.
Le problème
J'apprends le coréen. Les applications existantes sont fermées, par abonnement, et ne suivent pas mes cours. Je veux mon outil d'apprentissage — aligné sur ma progression, enrichissable à volonté — et en faire un produit public qui, à terme, démontre mes compétences full stack et génère un revenu (v3).
La vision en 4 versions (validée)
| Version | Contenu |
|---|---|
| v1 (MVP) | Comptes, module hangul, flashcards vocabulaire + répétition espacée (base libre + cartes perso), quiz — publiée sur Google Play |
| v2 | Phrases/expressions + audio : prononciation (TTS libre), puis exercices de prononciation (reconnaissance vocale libre) |
| v3 | IA conversationnelle self-hosted + abonnement payant (implique statut juridique + facturation + Play Billing) |
| v4 | iOS (99 $/an) + site web complet |
Ce document cadre la v1 ; chaque version suivante repassera par un cadrage court et ses propres ADRs.
Les utilisateurs (v1)
| Rôle | Qui | Besoin |
|---|---|---|
| Apprenant | Public francophone débutant en coréen (dont moi, premier utilisateur quotidien) | Apprendre le hangul, mémoriser du vocabulaire durablement, se tester |
| Administrateur | Moi | Gérer le contenu de base, suivre la santé de l'app |
Inscription libre → exigences RGPD complètes dès la v1 (cf. exigences).
Les parcours clés (v1)
- Débuter : je m'inscris, j'apprends mes premières lettres hangul, je ressors en sachant en lire quelques-unes.
- Réviser chaque jour : l'app me présente les cartes de vocabulaire au bon moment (répétition espacée) ; 5 minutes par jour suffisent.
- Me tester : un quiz me dit ce que je maîtrise et me remet les échecs en révision.
- Personnaliser : j'ajoute les mots vus en cours ; ils entrent dans mon cycle de révision.
Périmètre v1
Dans le MVP : comptes (inscription, connexion, suppression), module hangul, flashcards avec répétition espacée, decks de base importés de jeux de données libres, création de cartes perso, quiz, progression simple. Application Android publiée sur Google Play.
Exclusions (Won't v1 — planifiées, pas abandonnées) : interaction vocale (v2), IA (v3), paiement/abonnement (v3), iOS et web public (v4), fonctions sociales (classements, partage), notifications push (Should v1.x).
Contexte et contraintes
- Distribution : Google Play (compte développeur : 25 $, une fois). Choix de la stack mobile = phase 2 (comparatif dédié).
- Backend hébergé sur l'infra (Coolify, VLAN, CrowdSec déjà en place) ; process standard : Gitflow, Commitizen, CI Woodpecker, miroir GitHub, 100 % logiciels libres.
- Je suis en alternance + Mastère : mon temps est compté → lots courts, livrables fréquents.
Données
- Comptes : email + mot de passe (haché), progression d'apprentissage. Minimisation : rien d'autre. Droit à l'effacement : suppression de compte en libre-service. Politique de confidentialité obligatoire (exigée par Google Play) + CGU.
- Contenu d'apprentissage : jeux de données libres (vérifier licence et attribution de chaque source — cf. risque R3) + mes contributions.