Merchant Analytics, Portfolio and Leaderboard endpoints

[Josue19-08]

🔖 Title

Merchant Analytics, Portfolio and Leaderboard endpoints

---

📄 Description

merchants.controller.ts only exposes GET /merchants and GET /merchants/:id. There is no way to inspect a merchant's loan portfolio, repayment performance, or ranking against other merchants — needed for both the merchant dashboard and internal risk review.

---

✅ Tasks to complete

• GET /merchants/:id/portfolio — active loans, repayment rate, volume
• GET /merchants/:id/analytics — time-series volume, default rate, avg loan size
• GET /merchants/leaderboard — ranked merchants by configurable metric
• Financial score calculation service for merchants
• Repository queries/aggregations backing the above
• DTOs for each response shape
• Unit tests for score calculation and aggregation logic
• Integration tests for all new endpoints
• Swagger documentation

---

📚 Documentation/context for AI

(This link never should removed)
https://github.com/TrustUp-app/TrustUp-API/tree/main/docs

---

🗒️ Additional notes

Greenfield — no portfolio/analytics/leaderboard logic exists today in merchants.service.ts.

[SudiptaPaul-31]

Hey Maintainer!!! My name is Sudipta Paul a very old contributor of GrantFox and other platform having quite a lot of experience in open source and working with full stack issues as well as very much proficient in writing contracts and would love to work on this issue and contribute to your project, May I be assigned to this task