Match Preview

Score a single résumé against 1-5 active job roles in parallel. Stateless preview — no candidate is created. The recruiter sees a ranked table and then commits one (or more) of the results via the existing add-candidate-to-role endpoint.

Built for the agency flow where one résumé might fit Tesco Sr SE, Walmart Sr SE, and Stripe Sr SE simultaneously and the recruiter wants the comparison before picking where to send the screening invite. In-house TAs benefit too — match one résumé against several of their own open positions without re-uploading.

Cap of 5 roles per request bounds latency (~5s) and LLM spend per click. Match results land in the existing match_results cache (compute_match handles dedup by sha256(jd + résumé)), so resubmitting the same résumé + selection costs nothing.