Nền tảng lý thuyết của dự án được tập hợp trong khái niệm chính ["uchitsya-legko.rf — học đọc như giải mã mã chữ viết"](/concepts/uchitsya-legko-rf-obuchenie-chteniyu-kak-deshifrovke-pismennogo-koda). Đây là điểm trung tâm của dự án: mô tả mô hình chung, trạng thái hiện tại và liên kết các khái niệm cụ thể.

Hiện tại, dự án đang ở giai đoạn **Ý tưởng (Idea)**. Lý thuyết cơ bản về việc đọc như một quá trình khôi phục thông tin từ mã chữ viết đã được hình thành. Các thực thể thông tin làm nền tảng cho việc học đã được ghi nhận: đối tượng và tình huống, khái niệm, hình ảnh, từ nói, âm thanh, từ viết, chữ cái và các phần cấu trúc lớn hơn của từ.

Các thành phần chính của lý thuyết:

- [Đọc là nhận diện từ và khôi phục ý nghĩa, chứ không phải là phát âm tuần tự các chữ cái](/concepts/chtenie-eto-raspoznavanie-slova-i-vosstanovlenie-smysla).
- [Từ viết liên kết nhiều biểu hiện của cùng một nội dung](/concepts/pismennoe-slovo-svyazyvaet-neskolko-predstavleniy).
- [Học đọc phải đi từ điểm tựa đã biết đến mã chưa biết](/concepts/obuchenie-chteniyu-ot-izvestnyh-opor-k-neizvestnomu-kodu).
- [Từ vựng nói là cơ sở nhận diện khi học đọc](/concepts/ustnyy-slovar-baza-raspoznavaniya-pri-obuchenii-chteniyu).
- [Từ dài phải được làm rõ thông qua các phần cấu trúc quen thuộc](/concepts/dlinnoe-slovo-cherez-znakomye-strukturnye-chasti).
- [Các gợi ý phải biến mất dần khi các mối liên hệ được làm chủ](/concepts/podskazki-dolzhny-postepenno-ischezat).

Hướng đi thực tế là một hệ thống tương tác, trong đó trẻ bắt đầu với các đối tượng và từ ngữ dễ nhận biết, xác nhận âm thanh của chúng, làm quen với cách viết, phát hiện các yếu tố lặp lại của mã chữ viết và sau đó áp dụng các sự tương ứng tìm được để giải mã các từ mới.

Nguyên tắc quan trọng: hệ thống không được đòi hỏi trẻ phải tiếp thu đồng thời nhiều cấp độ chưa biết. Nếu trẻ chưa biết khái niệm, từ nói, âm thanh và chữ cái của nó, thì từ đó không phù hợp để làm tài liệu bắt đầu. Bài tập tiếp theo phải dựa trên kiến thức đã được xác nhận của riêng đứa trẻ đó.

Giai đoạn tiếp theo của dự án là biến lý thuyết thành cơ chế tương tác tối thiểu và kiểm tra tiêu chí chính: liệu trẻ có khả năng chuyển các mối liên hệ đã thành thạo sang các từ chưa từng gặp trước đó, chứ không chỉ ghi nhớ các ví dụ được hiển thị.

Một dự án học đọc tương tác dưới dạng giải mã dần dần mã chữ viết thông qua các ý nghĩa, hình ảnh và từ ngữ phát âm mà trẻ đã quen thuộc.

uchitsya-legko.rf

## Nhiệm vụ

Tách logic thực thi chung của `VoiceScenario` thành một module runtime duy nhất và sử dụng nó đồng thời trong cả bộ tổng hợp (synthesizer) và bộ trực quan hóa (visualizer).

Hiện tại, logic của `prepareScenario`, `evaluateBezier`, `updateAutomations`, `executeCommand` và việc tính toán `VoiceControlState` hiện tại đang bị trùng lặp. Điều này tạo ra rủi ro lệch pha: bộ trực quan hóa có thể hiển thị trạng thái không giống với trạng thái mà DSP thực sự đang sử dụng.

## Những việc cần làm

- Tạo một module runtime chung cho `VoiceScenario` (ví dụ: `VoiceSynthesizer/src/runtime.ts`).
- Tách phần chuẩn bị bố cục kịch bản và timeline chung vào đó.
- Tách phần diễn giải `set` và `animate`.
- Tách phần tính toán cubic bezier.
- Tách phần cập nhật automation đang hoạt động và ngữ nghĩa giữ lại giá trị `to` sau khi kết thúc `duration`.
- Đảm bảo khả năng lấy `VoiceControlState` thực tế theo thời gian hoặc lặp trạng thái dọc theo thang thời gian.
- Chuyển `synthesizeScenario` sang sử dụng runtime này.
- Chuyển `ScenarioVisualizer` sang dùng chung runtime đó để biểu đồ là sự phản ánh trạng thái thực tế của bộ tổng hợp, chứ không phải là một cách diễn giải kịch bản riêng biệt.
- Giữ nguyên ngữ nghĩa kết hợp mảng kịch bản hiện tại: `initial` chỉ có ở kịch bản đầu tiên, các kịch bản tiếp theo tiếp tục trạng thái hiện tại mà không reset.

## Tiêu chí hoàn thành

Đối với cùng một `VoiceScenario`, bộ tổng hợp và bộ trực quan hóa sử dụng chung một triển khai state machine. Sau khi thay đổi ngữ nghĩa runtime, không thể xảy ra tình huống DSP thực thi kịch bản theo một cách còn bộ trực quan hóa hiển thị theo một cách khác.

Loại bỏ việc trùng lặp logic thực thi VoiceScenario giữa synthesizeScenario và ScenarioVisualizer.

Nhiệm vụ

Tách runtime VoiceScenario thành một module chung cho bộ tổng hợp và bộ trực quan hóa