Daily Revision Calculator - Logic Documentation

Overview

Daily revision for Quran memorization students consists of two parts:

1. Last 5 Pages (~75 lines): Content memorized BEFORE today's memorization
2. Daily Part Revision: A cycle through 60 predefined daily revision parts

IMPORTANT: - Daily revision does NOT include today's new memorization - Line counts do NOT include surah headers or basmalah - only verse content

---

Memorization Pattern

Order of Memorization

Students memorize in the following order: 1. Surah Al-Fatihah first (Surah 1) 2. Then from An-Nas backwards to Al-Baqarah (114 → 113 → 112 → ... → 2)

Within each surah: Verse 1 → 2 → 3 → ... → end

---

Last 5 Pages Calculation

Definition

Last 5 Pages = exactly 75 lines of verse content memorized BEFORE today's memorization.

Rules

1. Start from the verse before today's memorization begins
2. Go backwards through memorization order (most recent first)
3. Stop at exactly 75 lines (only verse content, not headers)

Line Counting

• Only count lines containing verses
• Do NOT count surah name lines
• Do NOT count basmalah lines (except in Surah 1 where basmalah is verse 1)

---

Daily Part Revision

Definition

Daily Part Revision = One of 60 predefined parts of the Quran that contains PREVIOUSLY memorized content.

The 60 Daily Parts

The Quran is divided into 60 daily revision parts (different from hizbs):

Part	Start	End
1	1:1	2:78
2	2:79	2:141
...	...	...
59	78:1	88:26
60	89:1	114:6

Important Rules

1. Only PREVIOUSLY memorized content is included - Not today's new memorization
2. Students in Part 60 (surahs 89-114): Can only select "First time" or "Part 60"
3. Part 1 is only available when student reaches Surah 2

Example at Surah 95

When student is at 95:1-5 (today's new memorization): - Previously memorized: Surahs 96-114 + Surah 1 - Daily revision (Part 60): Surahs 96-114

---

Display Rules

End Verse Display

When displaying end verses on the website: - English: Show "End" instead of the verse number - Arabic: Show "إلخ" instead of the verse number

Example: "Al-Baqarah: 79 - End" instead of "Al-Baqarah: 79 - 141"

---

Technical Notes

Mushaf Line Counts

Mushaf	Lines/Page	5 Pages Target
Hafs	15	75 lines
Warsh	15	75 lines
Qaloon	15	75 lines
IndoPak	16	80 lines

What Counts as Lines

• ✅ Verse content lines
• ❌ Surah name/title lines
• ❌ Basmalah lines (except in Surah 1)