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
4. Surah 1 is added at the end of Part 60 daily revision (since Part 60 only covers 89-114)

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 + Surah 1 (appended)

---

Display Rules

Display Order

Results are displayed in surah order: 2, 3, 4, ..., 114, then 1 at the end

This reflects the typical revision order (earliest memorized to most recent), with Surah 1 shown last since it's memorized first.

Contiguous Verse Merging

When verses from the same surah are contiguous, they are merged into a single entry: - Example: 1:1-2 + 1:3-6 → displayed as 1:1-6

End Verse Display

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

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

Previous Daily Revision Selector

Shows what was memorized BEFORE today's start position using surah names: - Single surah: "An-Nas" - Surah range: "Al-Falaq to An-Nas" - Partial surah: "Al-Ikhlas:1-2" - Combined: "Al-Ikhlas:1-2 + Al-Falaq to An-Nas + Al-Fatihah"

Arabic Numerals Option

When Arabic language is selected, users can toggle Arabic numerals (٠١٢٣٤٥٦٧٨٩): - Affects all numbers in selectors and results - Toggle located below mushaf selection

---

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)