This pull request refactors the /prospects API endpoint to provide a more useful and production-ready response. Instead of returning static endpoint information, the endpoint now returns a paginated, filtered, and ordered list of prospects, prioritizing flagged entries and sorting alphabetically by first name.

[goldlabelapps]

Prospects endpoint improvements:

• The /prospects GET endpoint now returns paginated, filtered, and ordered results from the prospects table, rather than a static list of endpoint URLs.
• Results are ordered so that flagged prospects appear first (using flag DESC NULLS LAST), followed by alphabetical ordering by first_name.

Code cleanup:

• Removed the old /prospects/read endpoint and its handler, consolidating functionality into the updated /prospects endpoint.

These changes make the API more useful for clients by allowing them to fetch actual prospect data with pagination and meaningful ordering.