Added dynamic Match Score 4.0-10.0 scaling and UI badge

[Soumya1Kesharwani]

Good Evening Ma'am

I have introduced a new "Match Score" feature that provides users with a clear, visual indicator of how well project matches their skills, level, and interests.

Key changes-

1. Backend Scoring Logic (utils/recommender.py)
   • Added logic to calculate the maximum possible score for a perfect match based on the user's specific inputs.
   • Introduced a mathematical normalization that scales the raw AI similarity score to a clean 4.0 to 10.0 range.
   • Preserved cluster logic: projects matched via a cluster receive an appropriate coverage penalty before scaling.

2.Frontend UI Badge (static/script.js & static/style.css)

• Dynamically injects a beautiful Match Score: X.X / 10 badge below the project title on the project cards.
• The badge includes an animated, color-filled progress bar corresponding to the score.
• Fully styled for both Light Mode and Dark Mode.

3. API & Tests Fix (routes/main_routes.py & tests/test_basic.py)
   • Fixed an API return structure bug so the /api/recommend route safely returns an array of projects for the frontend to iterate over.
   • All 72 backend unit tests pass successfully.

Testing

• Tested locally on a Flask development server.
• Verified that all edge cases (like zero matches or missing max scores) safely fall back to a minimum score of 4.0 without crashing.

Ma'am I have not modified any other parts of code .I have only added this feature on the score.Kindly review the changes and merge them with the acutal code base.

Thank You

[vercel]

Someone is attempting to deploy a commit to the komalsony234-1530's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

Thank you for submitting your first pull request to DevPath.

Before review:

• Complete the PR template fully
• Ensure all tests pass
• Link your PR to an issue
• Keep changes scoped to the issue

A maintainer will review your contribution soon.

[Soumya1Kesharwani]

Ma'am I have added this section.kindly review the changes and merge it to main code.I have also resolved the merge conflicts. Thank you

…

On Mon, Jun 8, 2026, 19:33 github-actions[bot] ***@***.***> wrote: ***@***.***[bot]* commented on this pull request. Thank you for submitting your first pull request to DevPath. Before review: - Complete the PR template fully - Ensure all tests pass - Link your PR to an issue - Keep changes scoped to the issue A maintainer will review your contribution soon. — Reply to this email directly, view it on GitHub <#813?email_source=notifications&email_token=BW5UIZDRSA3CWHK4IB7D7Q3463BUZA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINBVGAZDCNJSGY42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#pullrequestreview-4450215269>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BW5UIZDSVFWHMTXOWGVQYCL463BUZAVCNFSM6AAAAACZ7F2XRCVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHM2DINJQGIYTKMRWHE> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/BW5UIZHSPTRTH4LJO3CLUPD463BUZA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINBVGAZDCNJSGY42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/BW5UIZB2WPRT4O7S2B2BURL463BUZA5CNFSNUABKM5UWIORPF5TWS5BNNB2WEL2QOVWGYUTFOF2WK43UKJSXM2LFO4XTINBVGAZDCNJSGY42M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>