Update comments

Author: cbullinger

mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java

@@ -638,9 +638,7 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
         // Use compound operator with "should" clauses to create a scoring hierarchy:
         // 1. phrase match (highest score) - exact phrase in same array element
         // 2. text match without fuzzy (high score) - all terms present, exact spelling
-        // 3. text match with fuzzy (lower score) - typo-tolerant fallback
-        // This ensures "James Cameron" ranks higher than "James Mangold" + "Cameron Crowe"
-        // while still supporting typo tolerance.
+        // 3. text match with fuzzy (lower score) - typo-tolerant fallback; update fuzzy settings as needed
         // For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
         if (searchRequest.getDirectors() != null && !searchRequest.getDirectors().trim().isEmpty()) {
             String directorsQuery = searchRequest.getDirectors().trim();
@@ -660,6 +658,7 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
                                     .append("query", directorsQuery)
                                     .append("path", Movie.Fields.DIRECTORS)
                                     .append("matchCriteria", "all")
+                                    // Fuzzy settings: allow up to 1 edit, require first 2 characters to match
                                     .append("fuzzy", new Document()
                                             .append("maxEdits", 1)
                                             .append("prefixLength", 2)))
@@ -668,7 +667,7 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
             ));
         }
 
-        // Add writers search if provided (see directors comments for compound should scoring hierarchy)
+        // Add writers search if provided (see directors comments for compound scoring hierarchy)
         if (searchRequest.getWriters() != null && !searchRequest.getWriters().trim().isEmpty()) {
             String writersQuery = searchRequest.getWriters().trim();
             searchPhrases.add(new Document("compound", new Document()
@@ -692,7 +691,7 @@ public List<Movie> searchMovies(MovieSearchRequest searchRequest) {
             ));
         }
 
-        // Add cast search if provided (see directors comments for compound should scoring hierarchy)
+        // Add cast search if provided (see directors comments for compound scoring hierarchy)
         if (searchRequest.getCast() != null && !searchRequest.getCast().trim().isEmpty()) {
             String castQuery = searchRequest.getCast().trim();
             searchPhrases.add(new Document("compound", new Document()

mflix/server/js-express/src/controllers/movieController.ts

@@ -581,9 +581,7 @@ export async function searchMovies(req: Request, res: Response): Promise<void> {
   // Use compound operator with "should" clauses to create a scoring hierarchy:
   // 1. phrase match (highest score) - exact phrase in same array element
   // 2. text match without fuzzy (high score) - all terms present, exact spelling
-  // 3. text match with fuzzy (lower score) - typo-tolerant fallback
-  // This ensures "James Cameron" ranks higher than "James Mangold" + "Cameron Crowe"
-  // while still supporting typo tolerance.
+  // 3. text match with fuzzy (lower score) - typo-tolerant fallback; update fuzzy settings as needed
   // For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
   if (directors) {
     searchPhrases.push({
@@ -599,7 +597,7 @@ export async function searchMovies(req: Request, res: Response): Promise<void> {
               query: directors,
               path: "directors",
               matchCriteria: "all",
-              fuzzy: { maxEdits: 1, prefixLength: 2 },
+              fuzzy: { maxEdits: 1, prefixLength: 2 }, // Allow up to 1 edit, require first 2 characters to match
             },
           },
         ],
@@ -609,7 +607,7 @@ export async function searchMovies(req: Request, res: Response): Promise<void> {
   }
 
   if (writers) {
-    // See comments above regarding compound should scoring hierarchy.
+    // See comments above regarding compound scoring hierarchy.
     searchPhrases.push({
       compound: {
         should: [
@@ -630,7 +628,7 @@ export async function searchMovies(req: Request, res: Response): Promise<void> {
   }
 
   if (cast) {
-    // See comments above regarding compound should scoring hierarchy.
+    // See comments above regarding compound scoring hierarchy.
     searchPhrases.push({
       compound: {
         should: [

mflix/server/python-fastapi/src/routers/movies.py

@@ -157,9 +157,7 @@ async def search_movies(
         # Use compound operator with "should" clauses to create a scoring hierarchy:
         # 1. phrase match (highest score) - exact phrase in same array element
         # 2. text match without fuzzy (high score) - all terms present, exact spelling
-        # 3. text match with fuzzy (lower score) - typo-tolerant fallback
-        # This ensures "James Cameron" ranks higher than "James Mangold" + "Cameron Crowe"
-        # while still supporting typo tolerance.
+        # 3. text match with fuzzy (lower score) - typo-tolerant fallback; update fuzzy settings as needed
         # For more details, see: https://www.mongodb.com/docs/atlas/atlas-search/operators-collectors/text/
         search_phrases.append({
             "compound": {
@@ -170,14 +168,14 @@ async def search_movies(
                     {"text": {"query": directors, "path": "directors", "matchCriteria": "all"}},
                     # Lower score: fuzzy match (typo tolerance)
                     {"text": {"query": directors, "path": "directors", "matchCriteria": "all",
-                              "fuzzy": {"maxEdits": 1, "prefixLength": 2}}}
+                              "fuzzy": {"maxEdits": 1, "prefixLength": 2}}} # Allow up to 1 edit, require first 2 characters to match
                 ],
                 "minimumShouldMatch": 1
             }
         })
 
     if writers is not None:
-        # See comments above regarding compound should scoring hierarchy.
+        # See comments above regarding compound scoring hierarchy.
         search_phrases.append({
             "compound": {
                 "should": [
@@ -191,7 +189,7 @@ async def search_movies(
         })
 
     if cast is not None:
-        # See comments above regarding compound should scoring hierarchy.
+        # See comments above regarding compound scoring hierarchy.
         search_phrases.append({
             "compound": {
                 "should": [