Update matching.py

matching.py

@@ -1,22 +1,29 @@
 from typing import List, Dict
 from models import Profile
 
+
 def calculate_local_matches(
     current: Profile,
     candidates: List[Profile],
     top_k: int = 3,
 ) -> List[Dict]:
+    """
+    Calculate local matches based on skill overlap.
+    Returns a list of dicts containing full profile info + score (0-1).
+    """
     matches = []
 
     for c in candidates:
         if c.id == current.id:
             continue
 
-        # Calculate score based on skill overlap
+        # Skill overlap score
         score = 0
         score += len(set(c.offers) & set(current.wants)) * 30
         score += len(set(current.offers) & set(c.wants)) * 30
-        score = min(1.0, score / 100)  # Normalize to 0-1
+
+        # Normalize score to 0-1
+        score = min(1.0, score / 100)
 
         matches.append({
             "id": c.id,
@@ -24,9 +31,9 @@ def calculate_local_matches(
             "offers": c.offers,
             "wants": c.wants,
             "avatar": c.avatar,
-            "score": score,  # 0-1 float
-            "reason": "Local scoring",
+            "score": score,
+            "reason": "Local scoring"
         })
 
-    # Sort descending and take top_k
+    # Sort descending by score and return top_k
     return sorted(matches, key=lambda x: x["score"], reverse=True)[:top_k]