AI Tutor diagram and mindmap rendering fallback policy

DEC-0090 - AI Tutor diagram and mindmap rendering fallback policy

Context

diagram_or_mindmap_ready đã có trong output taxonomy nhưng chưa chốt policy render theo thiết bị/năng lực UI, gây rủi ro trải nghiệm không nhất quán.

Decision

• Khóa layered rendering contract cho diagram_or_mindmap_ready:
  1. visual_native: dùng renderer native khi môi trường hỗ trợ.
  2. structured_graph_text: fallback text theo node-edge chuẩn khi visual không khả dụng.
  3. guided_checklist_fallback: fallback cuối khi complexity/performance gate không đạt.
• Complexity baseline để bảo toàn hiệu năng:
  • khi vượt ngưỡng node/edge đã chốt cho surface, runtime tự hạ về fallback phù hợp.
• Dù ở mode nào, response phải giữ action continuity (continue_chat hoặc deeplink học tiếp).

Decision Value

• Giữ trải nghiệm học tập liền mạch trên cả desktop/mobile.
• Tránh fail-hard do renderer hoặc payload quá nặng.

Rationale

Policy 3 tầng giúp tối ưu chất lượng hiển thị nhưng vẫn đảm bảo “always usable output”.

Implications

• Product/UX impact:
  • learner luôn nhận được nội dung dùng được, không phụ thuộc renderer.
• Data/logic impact:
  • response layer cần chọn render mode theo capability + complexity gate.
• Operational impact:
  • QA có acceptance rõ cho từng fallback tier.

Alternatives considered

• Option A: chỉ hỗ trợ visual, lỗi thì fail.
• Option B: visual-first với structured fallback nhiều tầng (selected).

Open follow-ups

• Tune complexity threshold theo từng surface sau A/B rollout.

Decision quality check

Decision quality check: DEC-0090

• Score: 11/12
• Weak dimensions: Operational feasibility (1)
• Action: Promoted with per-surface threshold tuning follow-up.