Home empty-state priority, profile-completion milestones, and AI-lock upgrade entry policy

DEC-0039 - Home empty-state priority, profile-completion milestones, and AI-lock upgrade entry policy

Context

Home dual-state and suggestion-only behavior are already confirmed. Product still needed concrete ordering and entry behavior for zero-history users, plus a clearer completion model for profile nudge resolution.

Decision

Home empty-state priority:

• For newly registered user with no course participation:
  • priority 1: Quan ly luyen tap,
  • priority 2: So tu vung,
  • priority 3: Quan ly khoa hoc.
• If user has active/past course participation:
  • promote Quan ly khoa hoc to top priority on Home.

AI-locked CTA behavior for free users:

• If free user taps CTA tied to AI feature:
  • show locked state clearly,
  • user can explicitly choose unlock action,
  • unlock action opens upgrade popup and continues to paid upgrade flow per existing checkout policy.

Profile-completion milestone model:

• Profile completion uses milestone progression with badge reward at each completed milestone.
• Milestone groups:
  • basic profile,
  • academic profile,
  • goal profile,
  • payment profile (when applicable).
• Home profile-completion nudge is resolved when required milestones in current scope are completed.
• Payment-profile milestone rule:
  • not required for free users,
  • becomes applicable when user enters paid flow,
  • pre-filling payment information before paid flow is allowed but optional.

Onboarding re-prompt behavior:

• If user skips onboarding popup, next reminders remain popup-only.
• Do not add extra reminder channels for this onboarding re-prompt.

Decision Value

• Gives deterministic Home ordering for first-session experience.
• Makes free-user paywall entry behavior explicit at AI feature touchpoints.
• Increases profile completion motivation without hard-gating users.

Rationale

Priority ordering and milestone-based feedback reduce decision friction for new users while preserving optional, user-friendly behavior.