feat: quarter juz option, remove inaccurate duration/phase labels, download missing audio

Author: Tarteel

backend/api/private_rooms.py

@@ -41,14 +41,14 @@ async def create_private_room(
 ):
     if body.rakats not in (8, 20):
         raise HTTPException(status_code=400, detail="rakats must be 8 or 20")
-    if body.juz_per_night not in (0.5, 1.0):
-        raise HTTPException(status_code=400, detail="juz_per_night must be 0.5 or 1.0")
+    if body.juz_per_night not in (0.25, 0.5, 1.0):
+        raise HTTPException(status_code=400, detail="juz_per_night must be 0.25, 0.5 or 1.0")
     if not (1 <= body.juz_number <= 30):
         raise HTTPException(status_code=400, detail="juz_number must be 1-30")
 
     juz_half = None
-    if body.juz_per_night == 0.5:
-        juz_half = 1
+    if body.juz_per_night in (0.5, 0.25):
+        juz_half = 1  # always use first slice (first half or first quarter)
 
     invite_code = secrets.token_urlsafe(9)[:12]
 

backend/services/audio/playlist_builder.py

@@ -42,7 +42,7 @@
 import logging
 from pathlib import Path
 from config import get_settings
-from utils.juz_data import get_juz_ayahs, distribute_ayahs_to_rakats, AyahKey
+from utils.juz_data import get_juz_ayahs, get_juz_quarter, distribute_ayahs_to_rakats, AyahKey
 from services.audio.downloader import get_audio_path
 
 logger = logging.getLogger(__name__)
@@ -144,12 +144,16 @@ def build_concat_file(
     juz_number: int,
     juz_half: int | None,
     reciter: str,
+    juz_per_night: float = 1.0,
 ) -> Path:
     """
     Build a single FFmpeg concat file for a room.
     Returns the path to the concat .txt file.
     """
-    ayahs = get_juz_ayahs(juz_number, half=juz_half)
+    if juz_per_night == 0.25:
+        ayahs = get_juz_quarter(juz_number, juz_half or 1)
+    else:
+        ayahs = get_juz_ayahs(juz_number, half=juz_half)
 
     # Al-Fatiha (Surah 1) is recited separately as a fixed step in every rakat.
     # Strip it from the juz portion so it is never played twice,

backend/services/scheduler.py

@@ -258,7 +258,7 @@ async def build_playlist_job(room_slot_id: str) -> None:
         loop = asyncio.get_event_loop()
         concat_path = await loop.run_in_executor(
             None, build_concat_file,
-            room_slot_id, slot.rakats, slot.juz_number, slot.juz_half, slot.reciter,
+            room_slot_id, slot.rakats, slot.juz_number, slot.juz_half, slot.reciter, slot.juz_per_night,
         )
         async with AsyncSessionLocal() as db:
             s = await db.get(RoomSlot, uuid.UUID(room_slot_id))

backend/utils/juz_data.py

@@ -106,6 +106,20 @@ def get_juz_ayahs(juz_num: int, half: int | None = None) -> list[AyahKey]:
     return all_ayahs[midpoint:]
 
 
+def get_juz_quarter(juz_num: int, quarter: int) -> list[AyahKey]:
+    """
+    Return one quarter of a juz.
+    quarter: 1 = first quarter, 2 = second, 3 = third, 4 = fourth.
+    """
+    info = get_juz_info(juz_num)
+    all_ayahs = get_ayahs_in_range(info.start_surah, info.start_ayah, info.end_surah, info.end_ayah)
+    total = len(all_ayahs)
+    size = total // 4
+    start = (quarter - 1) * size
+    end = start + size if quarter < 4 else total
+    return all_ayahs[start:end]
+
+
 def distribute_ayahs_to_rakats(ayahs: list[AyahKey], num_rakats: int) -> list[list[AyahKey]]:
     """Distribute ayahs as evenly as possible across rakats."""
     total = len(ayahs)

frontend/app/dashboard/page.tsx

@@ -319,7 +319,7 @@ export default function DashboardPage() {
                   >
                     <div className="flex items-center justify-between mb-1">
                       <span className="text-sm font-medium text-white">
-                        {r.rakats}R · Juz {r.juz_number} {r.juz_per_night === 0.5 ? "(½)" : ""}
+                        {r.rakats}R · Juz {r.juz_number}{r.juz_per_night === 0.25 ? " (¼)" : r.juz_per_night === 0.5 ? " (½)" : ""}
                       </span>
                       <span className={`text-xs px-2 py-0.5 rounded-full ${
                         r.status === "live" ? "bg-green-900/40 text-green-400" : "bg-gray-800 text-gray-400"
@@ -389,7 +389,7 @@ export default function DashboardPage() {
                   <div>
                     <label className="text-xs text-gray-400 mb-1 block">Amount</label>
                     <div className="flex gap-2">
-                      {[1.0, 0.5].map((j) => (
+                      {([1.0, 0.5, 0.25] as const).map((j) => (
                         <button
                           key={j}
                           onClick={() => setCreateForm((f) => ({ ...f, juz_per_night: j }))}
@@ -399,7 +399,7 @@ export default function DashboardPage() {
                               : "border-gray-700 text-gray-400"
                           }`}
                         >
-                          {j === 1.0 ? "Full Juz" : "Half Juz"}
+                          {j === 1.0 ? "Full" : j === 0.5 ? "Half" : "Quarter"}
                         </button>
                       ))}
                     </div>

frontend/app/room/[id]/page.tsx

@@ -94,20 +94,14 @@ function PrayerProgress({
   const netTotal     = Math.max(total - breaks.length * INTER_PRAYER_BREAK, 1);
   const timePerRakah = netTotal / totalRakats;
   const currentRakah = Math.min(Math.floor(netCurrent / timePerRakah) + 1, totalRakats);
-  const timeInRakah  = Math.max(0, netCurrent - (currentRakah - 1) * timePerRakah);
-  const isFirstOfPrayer = currentRakah % 2 === 1;
-  const phase        = getPrayerPhase(timeInRakah, timePerRakah, isFirstOfPrayer);
   const remaining    = Math.max(0, total - current);
 
   return (
     <div className="w-full space-y-3">
-      {/* Rakah + phase label */}
-      <div className="flex items-center justify-between">
-        <div className="flex items-baseline gap-1">
-          <span className="text-mosque-gold font-bold text-base">Rakah {currentRakah}</span>
-          <span className="text-gray-500 text-xs">of {totalRakats}</span>
-        </div>
-        <span className="text-xs text-gray-400 font-medium">{phase}</span>
+      {/* Rakah label */}
+      <div className="flex items-baseline gap-1">
+        <span className="text-mosque-gold font-bold text-base">Rakah {currentRakah}</span>
+        <span className="text-gray-500 text-xs">of {totalRakats}</span>
       </div>
 
       {/* Segmented bar — one segment per rakah */}
@@ -263,7 +257,9 @@ export default function RoomPage({ params }: { params: { id: string } }) {
     </div>
   );
 
-  const juzLabel    = room.juz_half === 1
+  const juzLabel = room.juz_per_night === 0.25
+    ? `Juz ${room.juz_number} — ¼`
+    : room.juz_half === 1
     ? `Juz ${room.juz_number} — 1st half`
     : room.juz_half === 2
     ? `Juz ${room.juz_number} — 2nd half`

frontend/components/RoomCard.tsx

@@ -1,6 +1,5 @@
 import Link from "next/link";
 import type { RoomSlot } from "@/lib/api";
-import { ROOM_DURATION } from "@/lib/api";
 
 const ROOM_CONFIG: Record<string, { icon: string; label: string; color: string }> = {
   "8_1.0":  { icon: "🌙", label: "Short · Full Juz",  color: "from-indigo-900/40 to-mosque-dark/60" },
@@ -15,9 +14,8 @@ interface Props {
 }
 
 export default function RoomCard({ room }: Props) {
-  const key      = `${room.rakats}_${room.juz_per_night}`;
-  const config   = ROOM_CONFIG[key] ?? { icon: "🌙", label: "", color: "from-mosque-navy to-mosque-dark" };
-  const duration = ROOM_DURATION[key] || 60;
+  const key    = `${room.rakats}_${room.juz_per_night}`;
+  const config = ROOM_CONFIG[key] ?? { icon: "🌙", label: "", color: "from-mosque-navy to-mosque-dark" };
 
   const juzLabel =
     room.juz_half === 1 ? `Juz ${room.juz_number} · 1st half`
@@ -85,16 +83,11 @@ export default function RoomCard({ room }: Props) {
             <span className="text-mosque-gold text-xs">▸</span>
             <span>{juzLabel}</span>
           </div>
-          <div className="flex items-center gap-2 text-xs text-gray-500">
-            <span>⏱</span>
-            <span>~{duration} min</span>
-            {room.participant_count > 0 && (
-              <>
-                <span className="text-gray-700">·</span>
-                <span className="text-white/70">{room.participant_count} praying</span>
-              </>
-            )}
-          </div>
+          {room.participant_count > 0 && (
+            <div className="flex items-center gap-2 text-xs text-gray-500">
+              <span className="text-white/70">{room.participant_count} praying</span>
+            </div>
+          )}
         </div>
 
         {/* CTA */}