Welcome to Hifz Focus! This guide is designed to walk you through every feature available on the Teacher Dashboard, turning you into a power user. Let's begin.

---

1. The Teacher Dashboard: Your Command Center

When you log in, your dashboard gives you an at-a-glance overview of all your assigned students.

- Student Cards: Each student has a card displaying their name and their current lesson (`Sabak`).

- Quick Actions: From the card, you have two primary options:

- Start Session: Immediately begin a lesson with the student.

- View Details: Access a comprehensive overview of the student's entire Hifz journey.

---

2. The Student Details Page

Clicking "View Details" takes you to a student's complete profile. This page is crucial for understanding a student's progress over time.

- Last Session Review: The page prominently displays the interactive Mushaf from the student's most recent session, with all marked errors highlighted. This allows you to quickly recall their last performance.

- Practice Queue: A list of lessons that you previously marked as "Needs More Practice."

- Dour (Revision) Queue: The student's full long-term revision schedule, sorted by what's due next.

- Achievements: A collection of all the badges the student has earned.

- Revision Settings:

- Dour Chunk Size: Customize the approximate word count for each automatically generated revision block. This helps tailor the size of revision lessons to a student's capacity.

- Clean Up Queue: This is an advanced tool that completely rebuilds the student's Dour queue from their entire session history. It should only be used if the revision schedule appears inconsistent or out of order.

---

3. The Session Screen: Where the Magic Happens

This is the core of the Hifz Focus workflow. When you start a session, a timer begins automatically. The screen is organized into three main tabs, each representing a different type of lesson.

3.1. Sabak Revision (Practice)

This is the default tab. It contains all the lessons you've previously marked as "Needs More Practice."

- Workflow:

1. Select a lesson from the list.

2. The Mushaf will load the verses along with all previously marked errors.

3. Conduct the review with your student. As they recite, you can add or remove error markers.

4. If the student has mastered it, click "Complete & Save Session"* and choose *"Sabak Memorized." This removes the lesson from the practice queue and promotes it to the long-term Dour queue.

3.2. New Sabak

This tab is for teaching a brand new lesson.

- Workflow:

1. Go to the "Lesson Control" card.

2. Select the Surah, "From" verse, and "To" verse for the new lesson.

3. Click "Update Sabak."

4. The Mushaf will load the new content.

5. As the student recites, use the error marking tools to provide feedback.

3.3. Dour (Long-Term Revision)

This tab is for reviewing older lessons to ensure long-term retention. It uses a Spaced Repetition System (SRS) to schedule lessons automatically.

- Workflow (Option A: Queued Item):

1. The "Dour Selection" card shows a prioritized list of lessons due for revision.

2. Select an item from the list.

3. Conduct the revision. If recited well, mark it as "Sabak Memorized." The system will automatically reschedule it for a later date, further in the future.

- Workflow (Option B: Custom Dour):

1. In the "Lesson Control" card, select any Surah and verse range you wish to review.

2. Click "Set Custom Dour."

3. The Mushaf loads your custom selection.

4. Conduct the session. Marking it as "Sabak Memorized" will add this custom range to the student's permanent Dour queue for future automated revisions.

3.4. Reviewing Audio Recitations

If a student has submitted an audio recording for a lesson, a "Play Recitation" button will appear.

- Workflow:

1. Click the button to load the relevant lesson in the Mushaf.

2. An audio player will appear at the bottom.

3. Play the student's audio. You can follow along in the Mushaf, marking errors in real-time just as you would in a live session. This is perfect for detailed Tajweed feedback.

---

4. Core Tools: Error Marking & Session Completion

Error Marking

Floating buttons on the session screen allow you to toggle between error modes:

- Jali (Red): For major mistakes (e.g., wrong word, missed verse). Click on a word or verse number to mark it.

- Khafi (Yellow): For minor Tajweed mistakes (e.g., incorrect ghunnah, madd timing). Click a word to mark it.

- My Notes (Blue): This mode is for the student's private use. You will only see your own error markings.

Clicking on a marked error in the list at the bottom allows you to add specific categories and notes for more detailed feedback.

Completing a Session

When you click the "Complete & Save Session" button, you have two choices:

1. Sabak Memorized: Choose this if the student has learned the lesson well.

- If it was a `New Sabak` or `Sabak Revision`, it gets added to the Dour queue.

- If it was a `Dour` item, its next revision date is pushed further into the future.

2. Needs More Practice: Choose this if the lesson requires more work.

- The lesson is added to (or remains in) the student's "Practice Queue."

A notification is instantly sent to the student with the results, creating an immediate and effective feedback loop.