UI Logic Mapping - Item Visuals

Hardening Note (SoT precedence): Tài liệu này tuân theo ../Core Logic/VOCV2_Product_Spec_Hardening_v1.md. Nếu có mâu thuẫn, ưu tiên SoT hardening.

1) Contract hiển thị bắt buộc

• Level thành thạo của mỗi từ là thang 0-5 trong max_stage (Seed -> Flowering).
• Health là trạng thái hiện tại theo F_now so với Threshold.
• Level và Health là 2 trục độc lập:
  • Level nói về đỉnh tiến bộ dài hạn.
  • Health nói về độ “khát nước” hiện tại.

2) Level thành thạo 0-5 (size cây)

Level	Tên	Điều kiện đạt	Quy tắc hiển thị
0	Seed	unseen (chưa có ItemLearner)	Hạt giống
1	Sprout	Có ItemLearner, chưa đạt điều kiện Level 2	Cây mầm
2	Seedling	F_peak >= 30	Cây non
3	Sapling	F_peak >= Threshold(skill)	Cây đang vững
4	Mature	successCount >= 3	Cây trưởng thành
5	Flowering	successCount >= 5	Cây nở hoa

Rule quan trọng:

• max_stage chỉ tăng, không giảm theo F_now.
• Một từ từng đạt Level 5 vẫn giữ icon Level 5, dù có thể đang Needs Water/Withered.

3) Health state (màu/overlay)

Health	Điều kiện	Ý nghĩa
Healthy	F_now >= Threshold(skill)	Đang ổn
Needs Water	0 < F_now < Threshold(skill)	Cần ôn sớm
Withered	F_now = 0	Quên nặng, cần relearn

4) Rendering rule trong UI

1. Render size/icon theo max_stage.
2. Render health overlay theo F_now + Threshold.
3. Không dùng F_now để hạ level 5->4->3.
4. Cho phép tổ hợp như:
   • Level 5 + Needs Water
   • Level 3 + Healthy
   • Level 1 + Withered

5) Data requirements cho FE

• max_stage (0..5)
• F_now (0..100)
• threshold theo skill
• item.skill
• is_unseen (hoặc kiểm tra ItemLearner record)

6) References

• VOCV2_Product_Spec_Hardening_v1.md
• VOCV2_Data_Model.md
• VOCV2_Mechanism_Exlpained.md