Refactor family vocabulary exercises generation for improved flexibility

- Replaced static family vocabulary exercises with a dynamic structure that generates exercises based on native language input, enhancing adaptability for different languages.
- Introduced a mapping for family words and their translations, allowing for a more comprehensive and organized approach to exercise creation.
- Updated logging to include native language context during exercise generation, improving clarity for developers and users.
- Streamlined the gap fill and transformation exercises to ensure accurate and relevant content for learners.
This commit is contained in:
Torsten Schulz (local)
2026-01-19 22:59:46 +01:00
parent 81dbbdd6f5
commit 14eb28d37f
2 changed files with 249 additions and 107 deletions

View File

@@ -11,133 +11,161 @@
import { sequelize } from '../utils/sequelize.js';
import VocabCourseLesson from '../models/community/vocab_course_lesson.js';
import VocabGrammarExercise from '../models/community/vocab_grammar_exercise.js';
import VocabCourse from '../models/community/vocab_course.js';
import User from '../models/community/user.js';
// Spezifische Übungen für Familienwörter
const FAMILY_WORDS_EXERCISES = [
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "Mutter" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "Mutter" auf Bisaya?',
options: ['Nanay', 'Tatay', 'Kuya', 'Ate']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Nanay" bedeutet "Mutter" auf Bisaya. "Mama" wird auch verwendet.'
// Familienwörter-Übersetzungen in verschiedene Muttersprachen
const FAMILY_WORDS = {
Mutter: {
de: 'Mutter',
en: 'Mother',
es: 'Madre',
fr: 'Mère',
it: 'Madre',
pt: 'Mãe'
},
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "Vater" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "Vater" auf Bisaya?',
options: ['Tatay', 'Nanay', 'Kuya', 'Ate']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Tatay" bedeutet "Vater" auf Bisaya. "Papa" wird auch verwendet.'
Vater: {
de: 'Vater',
en: 'Father',
es: 'Padre',
fr: 'Père',
it: 'Padre',
pt: 'Pai'
},
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "älterer Bruder" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "älterer Bruder" auf Bisaya?',
options: ['Kuya', 'Ate', 'Nanay', 'Tatay']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Kuya" bedeutet "älterer Bruder" auf Bisaya. Wird auch für respektvolle Anrede von älteren Männern verwendet.'
'älterer Bruder': {
de: 'älterer Bruder',
en: 'older brother',
es: 'hermano mayor',
fr: 'frère aîné',
it: 'fratello maggiore',
pt: 'irmão mais velho'
},
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "ältere Schwester" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "ältere Schwester" auf Bisaya?',
options: ['Ate', 'Kuya', 'Nanay', 'Tatay']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Ate" bedeutet "ältere Schwester" auf Bisaya. Wird auch für respektvolle Anrede von älteren Frauen verwendet.'
'ältere Schwester': {
de: 'ältere Schwester',
en: 'older sister',
es: 'hermana mayor',
fr: 'sœur aînée',
it: 'sorella maggiore',
pt: 'irmã mais velha'
},
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "Großmutter" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "Großmutter" auf Bisaya?',
options: ['Lola', 'Lolo', 'Nanay', 'Tatay']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Lola" bedeutet "Großmutter" auf Bisaya.'
Großmutter: {
de: 'Großmutter',
en: 'Grandmother',
es: 'Abuela',
fr: 'Grand-mère',
it: 'Nonna',
pt: 'Avó'
},
{
exerciseTypeId: 2, // multiple_choice
title: 'Wie sagt man "Großvater" auf Bisaya?',
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: 'Wie sagt man "Großvater" auf Bisaya?',
options: ['Lolo', 'Lola', 'Nanay', 'Tatay']
},
answerData: {
type: 'multiple_choice',
correctAnswer: 0
},
explanation: '"Lolo" bedeutet "Großvater" auf Bisaya.'
},
{
Großvater: {
de: 'Großvater',
en: 'Grandfather',
es: 'Abuelo',
fr: 'Grand-père',
it: 'Nonno',
pt: 'Avô'
}
};
// Bisaya-Übersetzungen
const BISAYA_TRANSLATIONS = {
'Mutter': 'Nanay',
'Vater': 'Tatay',
'älterer Bruder': 'Kuya',
'ältere Schwester': 'Ate',
'Großmutter': 'Lola',
'Großvater': 'Lolo'
};
// Sprach-Codes für Mapping
const LANGUAGE_CODES = {
'Deutsch': 'de',
'English': 'en',
'Español': 'es',
'Français': 'fr',
'Italiano': 'it',
'Português': 'pt',
'Spanish': 'es',
'French': 'fr',
'Italian': 'it',
'Portuguese': 'pt'
};
// Erstelle Übungen basierend auf Muttersprache
function createFamilyWordsExercises(nativeLanguageName) {
const langCode = LANGUAGE_CODES[nativeLanguageName] || 'de'; // Fallback zu Deutsch
const exercises = [];
// Multiple Choice Übungen für jedes Familienwort
const familyWords = Object.keys(FAMILY_WORDS);
const bisayaWords = ['Nanay', 'Tatay', 'Kuya', 'Ate', 'Lola', 'Lolo'];
familyWords.forEach((key, index) => {
const nativeWord = FAMILY_WORDS[key][langCode];
const bisayaWord = BISAYA_TRANSLATIONS[key];
// Erstelle Multiple Choice mit falschen Antworten
const wrongAnswers = bisayaWords.filter(w => w !== bisayaWord);
const shuffledWrong = wrongAnswers.sort(() => Math.random() - 0.5).slice(0, 3);
const options = [bisayaWord, ...shuffledWrong].sort(() => Math.random() - 0.5);
const correctIndex = options.indexOf(bisayaWord);
exercises.push({
exerciseTypeId: 2, // multiple_choice
title: `Wie sagt man "${nativeWord}" auf Bisaya?`,
instruction: 'Wähle die richtige Übersetzung.',
questionData: {
type: 'multiple_choice',
question: `Wie sagt man "${nativeWord}" auf Bisaya?`,
options: options
},
answerData: {
type: 'multiple_choice',
correctAnswer: correctIndex
},
explanation: `"${bisayaWord}" bedeutet "${nativeWord}" auf Bisaya.`
});
});
// Gap Fill Übung
const nativeWords = familyWords.map(key => FAMILY_WORDS[key][langCode]);
exercises.push({
exerciseTypeId: 1, // gap_fill
title: 'Familienwörter vervollständigen',
instruction: 'Fülle die Lücken mit den richtigen Bisaya-Familienwörtern.',
instruction: `Fülle die Lücken mit den richtigen Bisaya-Familienwörtern.`,
questionData: {
type: 'gap_fill',
text: '{gap} (Mutter) | {gap} (Vater) | {gap} (älterer Bruder) | {gap} (ältere Schwester) | {gap} (Großmutter) | {gap} (Großvater)',
gaps: 6
text: familyWords.map((key, i) => `{gap} (${nativeWords[i]})`).join(' | '),
gaps: familyWords.length
},
answerData: {
type: 'gap_fill',
answers: ['Nanay', 'Tatay', 'Kuya', 'Ate', 'Lola', 'Lolo']
answers: bisayaWords
},
explanation: 'Nanay = Mutter, Tatay = Vater, Kuya = älterer Bruder, Ate = ältere Schwester, Lola = Großmutter, Lolo = Großvater.'
},
{
explanation: bisayaWords.map((bw, i) => `${bw} = ${nativeWords[i]}`).join(', ') + '.'
});
// Transformation Übung
exercises.push({
exerciseTypeId: 4, // transformation
title: 'Familienwörter übersetzen',
instruction: 'Übersetze das Familienwort ins Bisaya.',
instruction: `Übersetze das Familienwort ins Bisaya.`,
questionData: {
type: 'transformation',
text: 'Mutter',
sourceLanguage: 'Deutsch',
text: nativeWords[0], // Erste Muttersprache als Beispiel
sourceLanguage: nativeLanguageName || 'Deutsch',
targetLanguage: 'Bisaya'
},
answerData: {
type: 'transformation',
correct: 'Nanay',
alternatives: ['Mama', 'Nanay', 'Inahan']
correct: bisayaWords[0],
alternatives: [bisayaWords[0]] // Nur die korrekte Antwort
},
explanation: '"Nanay" oder "Mama" bedeutet "Mutter" auf Bisaya.'
}
];
explanation: `"${bisayaWords[0]}" bedeutet "${nativeWords[0]}" auf Bisaya.`
});
return exercises;
}
async function findOrCreateSystemUser() {
let systemUser = await User.findOne({
@@ -183,7 +211,10 @@ async function updateFamilyWordsExercises() {
}
const courses = await sequelize.query(
`SELECT id, title, owner_user_id FROM community.vocab_course WHERE language_id = :languageId`,
`SELECT c.id, c.title, c.owner_user_id, c.native_language_id, nl.name as native_language_name
FROM community.vocab_course c
LEFT JOIN community.vocab_language nl ON c.native_language_id = nl.id
WHERE c.language_id = :languageId`,
{
replacements: { languageId: bisayaLanguage.id },
type: sequelize.QueryTypes.SELECT
@@ -196,7 +227,11 @@ async function updateFamilyWordsExercises() {
let totalLessonsUpdated = 0;
for (const course of courses) {
console.log(`📚 Kurs: ${course.title} (ID: ${course.id})`);
const nativeLangName = course.native_language_name || 'Deutsch'; // Fallback zu Deutsch
console.log(`📚 Kurs: ${course.title} (ID: ${course.id}, Muttersprache: ${nativeLangName})`);
// Erstelle Übungen für diese Muttersprache
const exercises = createFamilyWordsExercises(nativeLangName);
// Finde "Familienwörter"-Lektionen
const lessons = await VocabCourseLesson.findAll({
@@ -219,7 +254,7 @@ async function updateFamilyWordsExercises() {
// Erstelle neue Übungen
let exerciseNumber = 1;
for (const exerciseData of FAMILY_WORDS_EXERCISES) {
for (const exerciseData of exercises) {
await VocabGrammarExercise.create({
lessonId: lesson.id,
exerciseTypeId: exerciseData.exerciseTypeId,
@@ -234,7 +269,7 @@ async function updateFamilyWordsExercises() {
totalExercisesUpdated++;
}
console.log(` ✅ Lektion ${lesson.lessonNumber}: "${lesson.title}" - ${FAMILY_WORDS_EXERCISES.length} neue Übung(en) erstellt`);
console.log(` ✅ Lektion ${lesson.lessonNumber}: "${lesson.title}" - ${exercises.length} neue Übung(en) erstellt (${nativeLangName} → Bisaya)`);
totalLessonsUpdated++;
}

107
update-vocab-courses.sh Executable file
View File

@@ -0,0 +1,107 @@
#!/bin/bash
# Script zum Aktualisieren der Sprachkurse
# Führt Git-Fetch/Pull aus und aktualisiert die Kurs-Übungen
# Findet automatisch die neuesten/relevanten Script-Dateien
# Kein "set -e", damit Scripts auch bei Fehlern weiterlaufen können
echo "🔄 Starte Update der Sprachkurse..."
echo ""
# Prüfe ob wir im richtigen Verzeichnis sind
if [ ! -f "package.json" ]; then
echo "❌ Fehler: Bitte im Projekt-Root-Verzeichnis ausführen"
exit 1
fi
# 1. Git Fetch und Pull
echo "📥 Führe Git Fetch aus..."
git fetch
echo "📥 Führe Git Pull aus..."
git pull
echo ""
echo "✅ Git Update abgeschlossen"
echo ""
# 2. Wechsle ins Backend-Verzeichnis
cd backend
# 3. Finde relevante Script-Dateien
# Suche nach Scripts, die mit Sprachkursen zu tun haben
echo "🔍 Suche nach relevanten Script-Dateien..."
echo ""
SCRIPT_DIR="scripts"
RELEVANT_KEYWORDS=("vocab" "course" "lesson" "exercise" "bisaya" "family" "survival" "grammar" "update" "create")
# Finde alle .js-Dateien im scripts-Verzeichnis, die relevante Keywords enthalten
# Sortiere nach Änderungsdatum (neueste zuerst)
TEMP_SCRIPT_LIST=$(mktemp)
find "$SCRIPT_DIR" -name "*.js" -type f | while read -r file; do
filename=$(basename "$file" .js)
lowercase=$(echo "$filename" | tr '[:upper:]' '[:lower:]')
for keyword in "${RELEVANT_KEYWORDS[@]}"; do
if [[ "$lowercase" == *"$keyword"* ]]; then
echo "$file"
break
fi
done
done | xargs ls -t 2>/dev/null > "$TEMP_SCRIPT_LIST" || true
SCRIPT_FILES=$(cat "$TEMP_SCRIPT_LIST" 2>/dev/null || true)
rm -f "$TEMP_SCRIPT_LIST"
if [ -z "$SCRIPT_FILES" ]; then
echo "⚠️ Keine relevanten Script-Dateien gefunden"
echo ""
else
echo "📋 Gefundene Script-Dateien (nach Änderungsdatum sortiert):"
while IFS= read -r script; do
if [ -n "$script" ] && [ -f "$script" ]; then
echo " - $script"
fi
done <<< "$SCRIPT_FILES"
echo ""
# 4. Führe die Scripts aus
echo "▶️ Starte Ausführung der Scripts..."
echo ""
EXECUTED_COUNT=0
FAILED_COUNT=0
while IFS= read -r script; do
if [ -n "$script" ] && [ -f "$script" ]; then
script_name=$(basename "$script")
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "📝 Führe aus: $script_name"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
if sudo -u yourpart node "$script"; then
echo "$script_name erfolgreich abgeschlossen"
EXECUTED_COUNT=$((EXECUTED_COUNT + 1))
else
EXIT_CODE=$?
echo "$script_name fehlgeschlagen (Exit Code: $EXIT_CODE)"
FAILED_COUNT=$((FAILED_COUNT + 1))
# Setze nicht -e, damit weitere Scripts ausgeführt werden können
fi
echo ""
fi
done <<< "$SCRIPT_FILES"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "🎉 Update der Sprachkurse abgeschlossen!"
echo ""
echo "📊 Zusammenfassung:"
echo " - Git-Repository aktualisiert"
echo " - $EXECUTED_COUNT Script(s) erfolgreich ausgeführt"
if [ $FAILED_COUNT -gt 0 ]; then
echo " - ⚠️ $FAILED_COUNT Script(s) fehlgeschlagen"
fi
echo ""
fi
echo "💡 Hinweis: Das Frontend muss separat aktualisiert werden mit: ./deploy-frontend.sh"