Feature : add fuzzy team matching for pair programming

[SindiBuklaji]

Checklist

General

• I tested all changes and their related features with all corresponding user types.

Server

• Important: I implemented the changes with a very good performance and prevented too many (unnecessary) and too complex database calls.
• I strictly followed the principle of data economy for all database calls.
• I strictly followed the server coding and design guidelines.
• I documented the Java code using JavaDoc style.

Client

• Important: I implemented the changes with a very good performance, prevented too many (unnecessary) REST calls and made sure the UI is responsive, even with large data (e.g. using paging).
• I strictly followed the principle of data economy for all client-server REST calls.
• I strictly followed the client coding and design guidelines.
• I documented the React code.

Motivation and Context

Description

• Implement Levenshtein distance-based fuzzy matching to handle team names that differ between Artemis and uploaded Excel files (e.g., "crop & code" vs "crop and code")

  • Conservative exact matching with & → and conversion for safe name normalization that works for
    all teams

  • Aggressive fuzzy matching as fallback that removes common prefixes (Team, Group), suffixes (+ Co.
    KG, Ltd., Inc.), and dots to match edge cases.

  • 80% similarity threshold for fuzzy matching to ensure high-quality matches while catching minor
    variations

  • Comprehensive debug logging to troubleshoot team name matching issues in production

  • Two-stage matching strategy: Try exact match first (safe, precise), then fuzzy match as fallback
    (flexible, catches edge cases)

Steps for Testing

• Log in to Harmonia
• Upload the attendance excel document
• Check Pair programming is found and scored for team with different names in the excel document

Prerequisites:

1. Log in to Harmonia

Review Progress

Code Review

• Code Review 1

Manual Tests

• Test 1

Test Coverage

Screenshots

[github-actions]

🤖 No OpenAPI or client changes needed.

[github-actions]

🤖 No OpenAPI or client changes needed.

[github-actions]

🤖 No OpenAPI or client changes needed.