Submitted content
{lastSyncedAt && (
Last sync{" "}
{formatDistanceToNow(new Date(lastSyncedAt), { addSuffix: true })}
)}
{/* Renders progress bar, platform icon, and social preview component */}
);
}
```
Sources: [apps/web/app/app.dub.co/dashboard/slug/ee/program/bounties/bountyId/bounty-submission-details-sheet.tsx:421-488](https://github.com/blade47/dub/blob/HEAD/apps/web/app/app.dub.co/(dashboard)/%5Bslug%5D/(ee)/program/bounties/%5BbountyId%5D/bounty-submission-details-sheet.tsx#L421-L488), [apps/web/ui/partners/bounties/bounty-submission-details-sheet.tsx:47-118](https://github.com/blade47/dub/blob/HEAD/apps/web/ui/partners/bounties/bounty-submission-details-sheet.tsx#L47-L118)
### Approval Workflows and Side Effects
The approval engine processes standard submissions and social milestone tiers through targeted execution functions. When approving social metrics via `approveSocialMetricsMilestones`, the system validates pending milestones, calculates incremental reward amounts, updates database states using Prisma transactions, queues commissions, and executes side-effects asynchronously.
```typescript
async function approveSocialMetricsMilestones({
submissionId,
submission,
metric,
user,
}: {
submissionId: string;
submission: SubmissionToApprove;
metric: string;
user: Session["user"];
}) {
const { bounty } = submission;
const pendingMilestones = getPendingSocialMetricsMilestones({
bounty,
submission,
});
const earningCap = getSocialMetricsEarningCap(bounty);
if (pendingMilestones.length === 0 || earningCap == null) {
throw new DubApiError({
code: "bad_request",
message:
"The partner hasn't reached a new milestone for this bounty yet, so there is nothing to approve.",
});
}
const firstPendingMilestone = pendingMilestones[0];
const approvedThreshold =
pendingMilestones[pendingMilestones.length - 1].threshold;
const completesEarningCap = approvedThreshold >= earningCap;
const approvedSubmission = await prisma.bountySubmission.update({
where: {
id: submissionId,
approvedSocialMetricThreshold: submission.approvedSocialMetricThreshold,
status: {
notIn: [
BountySubmissionStatus.approved,
BountySubmissionStatus.draft,
],
},
},
data: {
approvedSocialMetricThreshold: approvedThreshold,
status: completesEarningCap ? "approved" : "submitted",
reviewedAt: new Date(),
userId: user.id,
rejectionNote: null,
rejectionReason: null,
},
include: submissionApprovalInclude,
});
const rewardAmount = pendingMilestones.reduce(
(sum, { rewardAmount }) => sum + rewardAmount,
0,
);
const description = buildMilestonesCommissionDescription({
bountyName: bounty.name,
metric,
milestone: {
fromThreshold: firstPendingMilestone.fromThreshold,
threshold: approvedThreshold,
},
});
await queuePartnerCommissionCreation({
event: "custom",
partnerId: submission.partnerId,
programId: submission.programId,
amount: rewardAmount,
quantity: 1,
userId: user.id,
source: CommissionSource.user,
description,
bountySubmissionId: submissionId,
metadata: {
socialMetrics: {
metric,
fromThreshold: firstPendingMilestone.fromThreshold,
threshold: approvedThreshold,
milestones: pendingMilestones,
},
},
});
runApprovalSideEffects({
approvedSubmission,
bounty,
user,
description: completesEarningCap
? `Bounty submission approved for ${approvedSubmission.partner.id}`
: `Bounty milestones approved up to ${nFormatter(approvedThreshold, { full: true })} ${metric} for ${approvedSubmission.partner.id}`,
notifyPartner: completesEarningCap,
});
return BountySubmissionSchema.parse(approvedSubmission);
}
```
Sources: [apps/web/lib/bounty/api/approve-bounty-submission.ts:204-316](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/bounty/api/approve-bounty-submission.ts#L204-L316)
> [!WARNING]
> Database updates for social metric milestones explicitly guard against race conditions using P2025 error catching on threshold matches, throwing a `bad_request` API error if the submission has already been reviewed or processed concurrently.
> Sources: [apps/web/lib/bounty/api/approve-bounty-submission.ts:237-270](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/bounty/api/approve-bounty-submission.ts#L237-L270)
### Call-Chain Execution Walkthrough
The reward approval sequence follows a deterministic flow from administrative trigger to audit logging and partner email dispatch:
1. `approveSocialMetricsMilestones()` or standard approval handlers evaluate incoming submission payloads against active Prisma records.
2. `getPendingSocialMetricsMilestones()` identifies unapproved performance tiers or social engagement thresholds.
3. `prisma.bountySubmission.update()` writes the new `approvedSocialMetricThreshold` and adjusts the submission status (`submitted` or `approved`).
4. `queuePartnerCommissionCreation()` logs the commission entry with source `CommissionSource.user` and assigns the associated `bountySubmissionId`.
5. `runApprovalSideEffects()` uses `waitUntil()` to wrap concurrent execution of `recordAuditLog()` and optional partner notification emails via `sendEmail()`.
Sources: [apps/web/lib/bounty/api/approve-bounty-submission.ts:184-371](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/bounty/api/approve-bounty-submission.ts#L184-L371)
> [!TIP]
> The `runApprovalSideEffects` function delegates tasks to `waitUntil()`, ensuring audit logs and notification emails resolve asynchronously without delaying the synchronous API response returned to the client.
> Sources: [apps/web/lib/bounty/api/approve-bounty-submission.ts:318-370](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/bounty/api/approve-bounty-submission.ts#L318-L370)
### Terminal Submission States and Notifications
Performance-based bounties executed via automated workflows check terminal status reasons and partner eligibility before transitioning submission rows. Once conditions are satisfied, workflow actions transition the submission status to `submitted`, record the completion timestamp, and dispatch notification emails to both the partner and program owners.
| Terminal Status | Action Type | Reason Mapping | Notification Template |
| :--- | :--- | :--- | :--- |
| `submitted` | Workflow Execution | `"finished"` | `BountyCompleted`, `NewBountySubmission` |
| `approved` | Manual / Milestone Approval | `"been awarded"` | `BountyApproved` |
| `rejected` | Administrative Rejection | `"been rejected"` | None (Rejection Note/Reason recorded) |
Sources: [apps/web/lib/api/workflows/award-bounty/execute.ts:23-30](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/api/workflows/award-bounty/execute.ts#L23-L30), [apps/web/lib/api/workflows/award-bounty/execute.ts:212-254](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/api/workflows/award-bounty/execute.ts#L212-L254), [apps/web/lib/bounty/api/approve-bounty-submission.ts:318-371](https://github.com/blade47/dub/blob/HEAD/apps/web/lib/bounty/api/approve-bounty-submission.ts#L318-L371)
## Related
- [Partner Program Management](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/technical/affiliate-platform/partner-program-management)
- [Commission Rules and Rewards](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/technical/affiliate-platform/commission-rules-and-rewards)
## Sitemap
See the full [sitemap](https://www.doc0.dev/docs/934e554a-e6a1-476f-bb2f-23e62d86c3fd/llms.txt) for all pages in this wiki.