feat(questions): Implement pass rate

Author: pan93412

assets/styles/app.scss

@@ -120,7 +120,19 @@ ul.credit {
   }
 
   &__operations {
-    @extend .d-flex, .gap-2, .justify-content-start, .align-items-center;
+    @extend .d-flex, .gap-3, .justify-content-start, .align-items-center;
+  }
+
+  .question-card__pass-rate {
+    &[data-pass-rate~="high"] {
+      @extend .text-success;
+    }
+    &[data-pass-rate~="medium"] {
+      @extend .text-warning;
+    }
+    &[data-pass-rate~="low"] {
+      @extend .text-danger;
+    }
   }
 }
 

src/Twig/Components/Questions/Card.php

@@ -5,10 +5,68 @@
 namespace App\Twig\Components\Questions;
 
 use App\Entity\Question;
+use App\Entity\SolutionEvent;
+use App\Entity\SolutionEventStatus;
 use Symfony\UX\TwigComponent\Attribute\AsTwigComponent;
 
 #[AsTwigComponent]
 final class Card
 {
     public Question $question;
+
+    /**
+     * Get the pass rate of the question.
+     *
+     * @return float the pass rate of the question
+     */
+    public function getPassRate(): float
+    {
+        $totalAttemptCount = $this->getTotalAttemptCount();
+        if (0 === $totalAttemptCount) {
+            return 0;
+        }
+
+        return round($this->getTotalSolvedCount() / $totalAttemptCount * 100, 2);
+    }
+
+    /**
+     * Get the pass rate level of the question.
+     *
+     * Low: 0% - 40%
+     * Medium: 41 – 70%
+     * High: 71% - 100%
+     */
+    public function getPassRateLevel(): string
+    {
+        $passRate = $this->getPassRate();
+
+        return match (true) {
+            $passRate <= 40 => 'low',
+            $passRate <= 70 => 'medium',
+            default => 'high',
+        };
+    }
+
+    /**
+     * Get the total number of attempts made on the question.
+     *
+     * @return int the total number of attempts made on the question
+     */
+    private function getTotalAttemptCount(): int
+    {
+        return $this->question->getSolutionEvents()->count();
+    }
+
+    /**
+     * Get the total number of times the question has been solved.
+     *
+     * @return int the total number of times the question has been solved
+     */
+    private function getTotalSolvedCount(): int
+    {
+        return $this->question->getSolutionEvents()
+            ->filter(
+                fn (SolutionEvent $solutionEvent) => SolutionEventStatus::Passed === $solutionEvent->getStatus()
+            )->count();
+    }
 }

templates/components/Questions/Card.html.twig

@@ -11,6 +11,7 @@
 
             <div class="question-card__operations">
                 <a role="button" class="btn btn-primary" href="{{ path('app_challenge', {id: question.id}) }}">進行測驗</a>
+                <div class="question-card__pass-rate" data-pass-rate="{{ this.passRateLevel }}">通過率 {{ this.passRate }}%</div>
             </div>
 
             <div class="question-card__background">