Task: Develop a Vietnamese language learning system for adult learners

Develop a Vietnamese language learning system for adult learners

19.09.2026vietnamguru.ru

Design a methodology and learning interface for Vietnamese: an initial primer, learning through familiar meanings, constant returns to phonetics, and transitioning to spontaneous speech.

Objective

Develop an independent Vietnamese language learning system for vietnamguru.ru, primarily focused on an adult Russian-speaking audience and aimed at rapidly building the ability to understand and independently construct living phrases.

Core Methodological Idea

One cannot mechanically apply the reading acquisition model of a Russian-speaking child to learning a foreign language.

A child learning to read in Russian usually already has two pillars:

  • a familiar meaning;
  • a familiar sound of the Russian word.

What remains unknown is the written code.

When learning Vietnamese as a Russian-speaking adult, the starting situation is different: the meaning is familiar, but both the Vietnamese sound and its spelling are unknown. Therefore, before the main vocabulary learning begins, the learner needs an initial map of how Vietnamese writing connects to sound.

Basic Principles of the Course

  1. First, provide a compact Vietnamese primer: letters, combinations, the vowel system, syllable structure, diacritics, tones, and basic reading/sound principles.
  2. Do not require complete memorization of the primer before continuing the course. Its purpose is to give the adult a map of the system.
  3. The primer must always remain at hand as a constant reference tool—for example, a separate tab/bookmark on the right labeled "Primer".
  4. After an initial introduction to the system, move on to real words, objects, actions, and situations whose meanings are already clear to the learner.
  5. When encountering an unfamiliar symbol, combination, or sound, the learner should easily be able to return to the relevant section of the primer and then back to the word.
  6. Learning is structured spirally, not linearly: primer → words → return to primer → new words → phrases → system refinement → spontaneous speech.
  7. New words should not become mere flashcards for recognition, but building blocks that are quickly integrated into several different combinations and phrases.

Why This Matters Specifically for Vietnamese

Vietnamese is analytic and morphologically relatively easy for a Russian-speaking learner, but its phonetic threshold is high: vowel quality, finals, and especially tones are part of the word's lexical form. Therefore, pronunciation cannot be postponed to a later stage. At the same time, there is no need to turn the beginning of the course into an academic lecture on phonology: an adult first needs to be shown a working map of the system and then reinforce it with real words.

Architectural Model

The main course space should handle:

  • familiar meanings and objects;
  • sounding Vietnamese words;
  • spelling;
  • actions and attributes;
  • word combinations;
  • simple constructions;
  • independent spontaneous speech.

The permanent "Primer" should handle the technical map of the language:

  • letters and letter combinations;
  • vowels and special marks;
  • consonants and finals;
  • syllable structure;
  • tones;
  • sound examples;
  • pronunciation differences where they are practically significant.

Adult Learning Principle

The methodology should not be hidden from the user. A separate material should explicitly explain to the adult learner how to use the system: why the primer is initially covered as an overview, why it is normal to return to it dozens of times, why the course is non-linear, and why a word is considered mastered not just after recognition, but after the ability to use it in new combinations.

Result Criterion

Upon implementation, the user should understand how to start the course, have permanent access to the phonetic map of the language, and gradually transition from recognizing individual words to independently constructing new phrases without first needing to fully master academic grammar.

Related Tasks

Dependency Logic

The primer creates the coordinate system. The article explains to the user how to use it. The word-learning mechanics use the primer as a reference layer. The mechanics of phrases and spontaneous speech are built on top of already mastered words and maintain the ability to return to the primer at any stage.

Ворклоги

The Vietnamese language teaching methodology is broken down into a parent task and four sub-directions. Key decisions are documented: adult learners are first given an overview primer as a map of the sound/writing system; the primer remains constantly accessible via a separate tab/spine; the main learning flow proceeds through familiar meanings and real words with returns to the primer; a separate article explains the rules for working with the course to the user; words must quickly transition into combinations and productive phrases to develop improvisation rather than just recognition.

Initial Vietnamese Voiceover Research

We tested using the browser's speechSynthesis for course voiceover. Based on the research results, it cannot be used as the primary mechanism.

Findings

  • The Vietnamese voice cannot be reliably installed in the browser.
  • The path available via Reading Mode is extremely inconvenient for a regular user: open reading mode → go to settings → open languages → add Vietnamese.
  • After enabling Vietnamese, a Downloading voices ... message appears, but the download can hang indefinitely and never actually complete.
  • Official documentation provides no clear guarantee of availability and support for a specific Vietnamese voice.
  • In Chromium, the language may be declared in the source code, but Chromium itself does not supply the final voice dictionaries. This is the responsibility of the specific browser/cloud provider—in our case, Google—and there is no transparent guarantee that such a dictionary is available.
  • Even if the installation works for a developer, we cannot build a course that requires users to manually install additional voices/dictionaries.

Additional Risk

The developer is not a native Vietnamese speaker and cannot independently guarantee that the synthesis correctly conveys the quality of sounds and tones. Therefore, the final quality must be verified with a native speaker.

Decision Made

Switch to a custom, controlled voiceover pipeline via OpenRouter + Google Gemini.

Do not generate voiceover on every playback. We need to create a permanent audio dictionary: generate a letter/syllable/word/phrase once, save metadata in the DB and the audio file itself in file storage, and then reuse the ready-made recording multiple times.

Also provide for:

  • regeneration of specific voiceovers;
  • storage of the model version and generation parameters;
  • quality check statuses;
  • subsequent verification by a native speaker;
  • separate Northern/Southern variants if necessary;
  • the ability to manually replace a synthetic recording with a reference native speaker recording.

Related Task

A child task has been created for the design and implementation of a custom TTS pipeline and voiceover dictionary: "Develop a custom Vietnamese voiceover pipeline and audio dictionary", taskId cmu8uqhzc0we6qw0qlviqsm7q.

The first target set for generation is the primer (abeceda): basic sounds, combinations, tones, diphthongs/triphthongs, and word examples. After quality verification using the same mechanism, expand the voiceover to the main course dictionary.