tap-doc-lop-1-docs

Quản lý vần & ví dụ

1. Mục đích

Module Quản lý vần & ví dụ (Premium) cho phép phụ huynh:

• Thêm vần mới: Tạo vần với tên, độ khó, danh sách ví dụ
• Sửa vần: Thay đổi tên, độ khó, thêm/xóa ví dụ
• Disable vần: Ẩn vần khỏi danh sách (không xóa, không ảnh hưởng lịch sử)
• Reset: Khôi phục vần và ví dụ về dữ liệu mặc định (tùy spec)

Tất cả thao tác nằm trong Cài đặt, tách rõ luồng Học (Tab 1, Tab 2) và Thiết lập (Cài đặt).

2. Khi nào nên dùng

Sử dụng module này khi bạn muốn:

• Thêm vần mới không có trong dữ liệu mặc định
• Sửa tên vần hoặc độ khó
• Thêm hoặc xóa ví dụ cho vần
• Tạm ẩn vần không muốn học (disable)
• Khôi phục dữ liệu về mặc định (nếu có tính năng Reset)

3. Các màn hình liên quan

• Quản lý vần (danh sách)
• Modal thêm vần mới
• Modal sửa vần
• Cài đặt (entry point)

4. Cách sử dụng chính

4.1 Thêm vần mới

1. Vào Tab Cài đặt → Quản lý vần & ví dụ
2. (Premium) Tap FAB + hoặc Thêm vần
3. Modal mở, nhập:
   • Tên vần: VD “oa”, “oe”
   • Độ khó: Dễ / Vừa / Khó
   • Ví dụ: Danh sách từ (vd: “hoa”, “loa”, “toa”)
4. Tap Lưu
5. Vần mới xuất hiện trong Tab Tất cả vần

4.2 Sửa vần

1. Ở màn hình Quản lý vần, tap vào vần cần sửa
2. Modal sửa mở:
   • Sửa tên vần
   • Thay đổi độ khó
   • Thêm ví dụ mới
   • Xóa ví dụ
3. Tap Lưu
4. Cập nhật áp dụng cho Tab 1, Tab 2, và các collection chứa vần đó

4.3 Disable vần

1. Ở màn hình Quản lý vần, tắt switch bên cạnh vần
2. Vần bị ẩn khỏi Tab Tất cả vần và các collection
3. Không xóa lịch sử học tập (session cũ vẫn giữ)
4. Bật lại switch → vần hiển thị trở lại

4.4 Enable vần

1. Tìm vần đã disable trong danh sách Quản lý vần
2. Bật switch
3. Vần hiển thị lại trong Tab 1 và collection

5. Logic & quy tắc

5.1 Disable vs Xóa

• Disable: Ẩn vần, không xóa dữ liệu, lịch sử giữ nguyên
• Xóa: (nếu có) Xóa vần hoàn toàn – cẩn thận ảnh hưởng collection và lịch sử

5.2 Độ khó

• Dễ (🟢): Vần dễ đọc
• Vừa (🟡): Trung bình
• Khó (🔴): Vần khó, cần luyện nhiều

Độ khó do phụ huynh gán, phản ánh cảm nhận về vần đó.

5.3 Ví dụ

• Mỗi vần có danh sách ví dụ (từ chứa vần đó)
• Mỗi ví dụ có nút [🔊] để phát âm
• Ví dụ hiển thị ở mặt sau card (mode 2 mặt hoặc Chỉ ví dụ)

6. Lưu ý quan trọng

• Premium only: Free user không truy cập được, tap → dialog khóa
• Tách biệt Học – Thiết lập: Tab 1 và Tab 2 chỉ để học, không chỉnh sửa vần
• Offline: Tất cả dữ liệu lưu local, không cần internet