
# 🎧 Pronunciation & Preferences System Overview

---

## Sound Icon for Italian Words
- 🔊 A speaker icon automatically appears next to all `<span lang="it">` elements.
- On click, it uses the system default **Italian voice** (e.g., `it-IT-Wavenet-D`).
- Fallbacks to Web Speech API if system voice not available.

---

## Admin Panel – Voice Defaults
Accessible under `/admin/preferences`:
- Set default **Italian** voice (used for quizzes, flashcards, reading)
- Set default **English** voice (used for instructions)
- Change speed/pitch settings (saved in `settings` table)

---

## User Preferences Panel – `/user/preferences`
Available settings:
- 🌗 Dark mode toggle (auto detects or user-defined)
- 🎤 Choose preferred Italian voice (dropdown)
- 📢 Choose English narration voice
- 📧 Change subscription email
- 🔒 Reset password
- 💳 Manage subscription tier via Stripe portal

All changes are saved in the `user_preferences` table and respected app-wide.

---

## Accessibility
- All voice interactions are ARIA-labeled and keyboard accessible.
- Sound icons are visible but do not block screen readers.
- System gracefully falls back to on-screen text if voices not supported.

---

## Monetization Note
- Free users: audio limited to 1 playback per item (e.g., 1x per quiz/flashcard)
- Premium users: unlimited audio usage
- Admins may view audio usage stats under `/admin/analytics/audio`

