docs(frontend): clarify soundManager placeholder audio behavior

frontend/src/app/[locale]/request-loan/page.tsx

@@ -23,11 +23,38 @@ const LoanApplicationWizard = dynamic(
   { ssr: false, loading: () => <WizardSkeleton /> },
 );
 
+// Score band thresholds
+const EXCELLENT_SCORE_THRESHOLD = 750;
+const GOOD_SCORE_THRESHOLD = 670;
+const FAIR_SCORE_THRESHOLD = 580;
+const MINIMUM_ELIGIBLE_SCORE_THRESHOLD = 500;
+
+// Maximum loan amounts per score band
+const EXCELLENT_SCORE_MAX_LOAN = 50_000;
+const GOOD_SCORE_MAX_LOAN = 25_000;
+const FAIR_SCORE_MAX_LOAN = 10_000;
+const MINIMUM_SCORE_MAX_LOAN = 5_000;
+
+// Warning range
+const NEAR_MINIMUM_SCORE_DELTA = 40;
+
 function getScoreBandMax(score: number): number {
-  if (score >= 750) return 50_000;
-  if (score >= 670) return 25_000;
-  if (score >= 580) return 10_000;
-  if (score >= 500) return 5_000;
+  if (score >= EXCELLENT_SCORE_THRESHOLD) {
+    return EXCELLENT_SCORE_MAX_LOAN;
+  }
+
+  if (score >= GOOD_SCORE_THRESHOLD) {
+    return GOOD_SCORE_MAX_LOAN;
+  }
+
+  if (score >= FAIR_SCORE_THRESHOLD) {
+    return FAIR_SCORE_MAX_LOAN;
+  }
+
+  if (score >= MINIMUM_ELIGIBLE_SCORE_THRESHOLD) {
+    return MINIMUM_SCORE_MAX_LOAN;
+  }
+
   return 0;
 }
 
@@ -83,7 +110,8 @@ export default function RequestLoanPage() {
     minScoreConfig?.maxAmount ?? Number.POSITIVE_INFINITY,
   );
   const scoreDelta = resolvedCreditScore - minimumScore;
-  const isCloseToMinimum = scoreDelta >= 0 && scoreDelta <= 40;
+  const isCloseToMinimum =
+  scoreDelta >= 0 && scoreDelta <= NEAR_MINIMUM_SCORE_DELTA;
   const isIneligible = isWalletConnected && !isLoadingConfig && !isLoadingScore && scoreDelta < 0;
   const isCheckingEligibility =
     isWalletConnected && (isLoadingConfig || (isLoadingScore && !!borrowerAddress));

frontend/src/app/utils/soundManager.ts

@@ -27,8 +27,8 @@ class SoundManager {
   }
 
   private initializeSounds() {
-    // Using data URIs for simple sound effects to avoid external dependencies
-    // In production, replace with actual audio files
+     // Placeholder silent sound effects.
+// Replace with real audio assets or generated tones in production.
 
     const soundEffects: Record<SoundEffect, string> = {
       // Level up - triumphant sound
@@ -65,15 +65,17 @@ class SoundManager {
   }
 
   /**
-   * Generate a simple tone using Web Audio API
-   * This creates a data URI that can be used as an audio source
-   */
-  private generateTone(_frequencies: number[], _duration: number): string {
-    // For now, return empty data URI
-    // In a real implementation, you would generate actual audio data
-    // or use external audio files
-    return "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQAAAAA=";
-  }
+ * Placeholder sound generator.
+ *
+ * Gamification sound effects are currently disabled and all generated
+ * clips are intentionally silent placeholders until real audio assets
+ * or Web Audio API tone generation is implemented.
+ *
+ * The frequency and duration parameters are currently unused.
+ */
+private generateTone(_frequencies: number[], _duration: number): string {
+  return "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQAAAAA=";
+}
 
   /**
    * Play a sound effect