🧙 Randoria - Générateur Aléatoire Fantasy

Randoria est une application Android développée avec Flutter permettant de tirer aléatoirement des noms ou éléments selon des catégories et sous-catégories définies.
Elle a été pensée pour fonctionner sur tablette, avec une interface immersive inspirée des univers fantasy (parchemins, typographies anciennes, ambiance RPG).

---

✨ Fonctionnalités

• 🎲 Génération de 10 éléments aléatoires selon un filtre (catégorie et sous-catégorie)
• 📜 Interface personnalisée avec fond parchemin, icône stylisée, polices fantasy
• 📁 Chargement des données depuis un fichier CSV structuré
• 🔍 Navigation par catégories et sous-catégories
• 🌐 Affichage responsive (portrait / paysage)
• ✅ Aucune base de données nécessaire : toutes les données sont définies en amont

---

📂 Structure des données

Les éléments sont stockés dans un fichier CSV :

assets/data/elements.csv

Chaque ligne contient :

valeur;categorie;sousCategorie

Exemple :

Gandalf;prénom;fantasy
Paris;lieu;
Alice;prénom;

Tu peux générer ce fichier automatiquement à partir d’une arborescence de fichiers texte grâce au script Python fourni (voir ci-dessous).

---

⚙️ Génération du CSV

Les fichiers .txt sont lus depuis :

/source_elements/
├── prenom/
│   ├── fantasy/
│   │   └── noms.txt
│   └── noms.txt
├── lieu/
│   └── lieux.txt
├── traductions.csv     ← facultatif

Lance simplement :

python generateur_csv.py

Le script produit automatiquement assets/data/elements.csv avec le bon format.

---

📦 Installation & compilation

🔧 Pré-requis

• Flutter
• Un terminal et un éditeur de code (VS Code, Android Studio)

▶️ Lancer en local (mode debug)

flutter run

📱 Compiler pour Android (mode release)

flutter build apk --release

Le fichier généré se trouve dans :

build/app/outputs/flutter-apk/app-release.apk

---

📲 Installation sur tablette

1. Active le mode développeur et le débogage USB
2. Connecte la tablette via USB
3. Installe l’APK :

adb install -r build/app/outputs/flutter-apk/app-release.apk

Ou transfère manuellement le fichier APK et ouvre-le depuis la tablette.

---

⚙️ CI/CD GitHub

• Analyse statique automatique à chaque commit
• Compilation de l'APK automatique lors de la création d’une release GitHub
• Le fichier app-<version>.apk est joint automatiquement à la release

---

🚧 Roadmap

• Ajout d'autres catégories
• Ajout d'autres univers

---

📝 Licence

Ce projet est distribué sous licence Mozilla Public License 2.0. Vous pouvez l’utiliser et le modifier librement, y compris dans des projets commerciaux, mais les fichiers modifiés doivent rester open source.
Voir le fichier LICENSE pour plus de détails.

---