docs(talent): correct placement-path comments from Polar to Creem

The recruiter placement/unlock path charges and settles through Creem
(creemService + signed creemWebhooks checkout.completed), but the
talentBillingService header, its settlement section comment, and the
controller's requestUnlock JSDoc still described a Polar adapter / Polar
order webhook. Correct those comments so the money path reads
unambiguously as Creem.

Verified before changing: @polar-sh/sdk and POLAR_WEBHOOK_SECRET remain in
active use by subscriptionService, storeController, and polarWebhooks for
subscriptions and the creator store, so they are intentionally left in place.
Comment-only change; no behavior change.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
caelum0x 2026-09-06 10:36:04 +03:00
parent 2431ac08f9
commit 7589058b91
2 changed files with 5 additions and 5 deletions

View File

@ -41,7 +41,7 @@ export const talentBillingController = {
/**
* POST /opportunities/:id/unlocks
* Recruiter opens (or replays) a paid unlock for a matched candidate. Returns a
* Polar checkout URL, or `alreadyUnlocked` when the entitlement is already paid.
* Creem checkout URL, or `alreadyUnlocked` when the entitlement is already paid.
*/
requestUnlock: asyncHandler(async (req: AuthRequest, res: Response) => {
const opportunityId = req.params.id;

View File

@ -4,8 +4,8 @@
* This is the recruiter monetization the talent graph was designed for but never
* wired: a recruiter (the opportunity owner) pays a placement/access fee to
* unlock a matched candidate's contact details and full evidence. The fee is
* charged through the shared Polar adapter (the same provider used for
* subscriptions and the store) and settled by the Polar `order.created` webhook.
* charged through the Creem adapter (a merchant-of-record supporting Turkey-based
* sellers) and settled by the signed Creem `checkout.completed` webhook.
*
* Design notes:
* - Fee math is pure and configuration-driven (see the `*FeeCents` helpers).
@ -15,7 +15,7 @@
* (opportunity, candidate, recruiter); a repeated unlock never opens a second
* charge, and settlement is a no-op once the entitlement is already paid.
* - Every function accepts injectable dependencies so the flow can be unit
* tested without a live Postgres, Polar, or the matcher (same pattern as
* tested without a live Postgres, Creem, or the matcher (same pattern as
* `findTalentMatches`).
*/
import prisma from '../utils/prisma';
@ -249,7 +249,7 @@ export async function requestCandidateUnlock(
}
// ---------------------------------------------------------------------------
// Settlement (Polar order webhook) + entitlement check
// Settlement (Creem checkout.completed webhook) + entitlement check
// ---------------------------------------------------------------------------
export interface SettlePlacementParams {