what the fuck

src/Controller/ReviewController.php

@@ -4,8 +4,6 @@ namespace App\Controller;
 
 use App\Entity\Review;
 use App\Form\ReviewType;
-use App\Repository\ReviewRepository;
-use App\Service\SpotifyClient;
 use Doctrine\ORM\EntityManagerInterface;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 use Symfony\Bundle\SecurityBundle\Attribute\IsGranted;
@@ -14,19 +12,27 @@ use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;
 
+/**
+ * ReviewController funnels CRUD flows through album pages and simple routes.
+ */
 #[Route('/reviews')]
 class ReviewController extends AbstractController
 {
-    // Exclusively for compat, used to route to standalone reviews page.
+    /**
+     * Maintains backwards compatibility by redirecting to the dashboard.
+     */
     #[Route('', name: 'review_index', methods: ['GET'])]
     public function index(): Response
     {
         return $this->redirectToRoute('account_dashboard');
     }
 
+    /**
+     * Redirects users to the album flow when starting a review.
+     */
     #[Route('/new', name: 'review_new', methods: ['GET', 'POST'])]
     #[IsGranted('ROLE_USER')]
-    public function new(Request $request): Response
+    public function create(Request $request): Response
     {
         $albumId = (string) $request->query->get('album_id', '');
         if ($albumId !== '') {
@@ -36,6 +42,9 @@ class ReviewController extends AbstractController
         return $this->redirectToRoute('album_search');
     }
 
+    /**
+     * Shows a standalone review page.
+     */
     #[Route('/{id}', name: 'review_show', requirements: ['id' => '\\d+'], methods: ['GET'])]
     public function show(Review $review): Response
     {
@@ -44,6 +53,9 @@ class ReviewController extends AbstractController
         ]);
     }
 
+    /**
+     * Handles review form edits with authorization.
+     */
     #[Route('/{id}/edit', name: 'review_edit', requirements: ['id' => '\\d+'], methods: ['GET', 'POST'])]
     #[IsGranted('ROLE_USER')]
     public function edit(Request $request, Review $review, EntityManagerInterface $em): Response
@@ -65,6 +77,9 @@ class ReviewController extends AbstractController
         ]);
     }
 
+    /**
+     * Deletes a review when the CSRF token and permission check pass.
+     */
     #[Route('/{id}/delete', name: 'review_delete', requirements: ['id' => '\\d+'], methods: ['POST'])]
     #[IsGranted('ROLE_USER')]
     public function delete(Request $request, Review $review, EntityManagerInterface $em): RedirectResponse
@@ -78,7 +93,6 @@ class ReviewController extends AbstractController
         return $this->redirectToRoute('account_dashboard');
     }
 
-    // fetchAlbumById no longer needed; album view handles retrieval and creation
 }