@bash-app/bash-common 30.383.0 → 30.385.0

package/prisma/schema.prisma

@@ -268,6 +268,19 @@ model Competition {
   /// How 1st/2nd/3rd place icons appear on leaderboards and profiles
   placementAwardStyle   PlacementAwardStyle          @default(Trophy)
 
+  /// PROMOTER competitions only — purpose distinguishes consumer contests from ticket-sales races
+  competitionPurpose     CompetitionPurpose   @default(CONSUMER)
+  /// PROMOTER: total ticket-sale goal for the competition
+  promoterSalesGoal      Int?
+  /// PROMOTER: maximum organizer cash reward exposure in cents
+  promoterRewardBudgetCents Int?
+  /// PROMOTER: how milestone rewards are calculated
+  promoterRewardMode     PromoterRewardMode   @default(TOTAL_AT_MILESTONE)
+  /// PROMOTER: who can enroll as a promoter
+  promoterRecruitMode    PromoterRecruitMode  @default(InviteOnly)
+  /// PROMOTER: attribution window in days (purchases within N days of referral click count)
+  referralWindowDays     Int?                 @default(30)
+
   /// Optional Adventures rewards when someone becomes an ACCEPTED participant
   participationBashPoints    Int?
   participationEventBadgeId  String?
@@ -292,6 +305,11 @@ model Competition {
   judgeScores      CompetitionJudgeScore[]
   notifications    Notification[]
   sideQuests       SideQuest[]
+  giveaways   Giveaway[]
+  promoterMilestones  PromoterMilestone[]
+  promoterRewards     PromoterReward[]
+  promoters           Promoter[]
+  promoterEventPerformances PromoterEventPerformance[]
   participationEventBadge EventBadge? @relation("CompetitionParticipationBadge", fields: [participationEventBadgeId], references: [id], onDelete: SetNull)
   finalistEventBadge      EventBadge? @relation("CompetitionFinalistBadge", fields: [finalistEventBadgeId], references: [id], onDelete: SetNull)
   winEventBadge           EventBadge? @relation("CompetitionWinBadge", fields: [winEventBadgeId], references: [id], onDelete: SetNull)
@@ -305,6 +323,67 @@ model Competition {
   @@index([winEventBadgeId])
 }
 
+/// Threshold-based reward step in a PROMOTER competition.
+/// Each row defines what a promoter earns when they hit `threshold` qualified ticket sales,
+/// or `rank` (e.g. rank=1 for first-place prize).
+model PromoterMilestone {
+  id                  String             @id @default(cuid())
+  competitionId       String
+  /// null = rank-based prize (use `rank`); non-null = threshold-based
+  threshold           Int?
+  /// null = threshold-based (use `threshold`); 1 = first-place prize, etc.
+  rank                Int?
+  rewardType          PromoterRewardType
+  /// Cash reward in cents (used when rewardType = CASH)
+  rewardAmountCents   Int?
+  /// Human-readable label shown to promoters (e.g. "Free VIP upgrade")
+  rewardDescription   String?
+  /// Ticket tier to award (for TICKET / TICKET_UPGRADE rewards)
+  ticketTierId        String?
+  /// Linked sponsor prize (for SPONSOR_PRIZE rewards)
+  sponsorPrizeId      String?
+  /// Controls display order in UIs
+  displayOrder        Int                @default(0)
+  createdAt           DateTime           @default(now())
+  updatedAt           DateTime           @updatedAt
+
+  competition    Competition      @relation(fields: [competitionId], references: [id], onDelete: Cascade)
+  rewards        PromoterReward[]
+
+  @@index([competitionId])
+  @@index([threshold])
+  @@index([rank])
+}
+
+/// Tracks a specific reward earned (or pending/revoked) by a promoter participant.
+/// Created when a promoter's qualified sales cross a milestone threshold or they win a rank prize.
+model PromoterReward {
+  id              String               @id @default(cuid())
+  competitionId   String
+  /// FK to Promoter.id (the per-bash promoter row, not User)
+  promoterId      String
+  /// null for rank-based rewards (use `rank`)
+  milestoneId     String?
+  /// For rank prizes (1 = first place, etc.)
+  rank            Int?
+  /// Snapshot of qualified sales at the time this reward status was last updated
+  qualifiedSalesSnapshot Int            @default(0)
+  status          PromoterRewardStatus @default(PENDING)
+  earnedAt        DateTime?
+  fulfilledAt     DateTime?
+  revokedAt       DateTime?
+  revokeReason    String?
+  createdAt       DateTime             @default(now())
+  updatedAt       DateTime             @updatedAt
+
+  competition Competition         @relation(fields: [competitionId], references: [id], onDelete: Cascade)
+  milestone   PromoterMilestone?  @relation(fields: [milestoneId], references: [id], onDelete: SetNull)
+
+  @@index([competitionId, promoterId])
+  @@index([promoterId])
+  @@index([status])
+}
+
 model CompetitionJudgeAssignment {
   id            String      @id @default(cuid())
   competitionId String
@@ -611,10 +690,16 @@ model Promoter {
   updatedAt         DateTime             @updatedAt
   userId            String? // null until invited promoter signs up (do not use host id as placeholder)
   invitedEmail      String? // normalized invitee email for reconciliation when userId is null
+  /// When set, this promoter is enrolled in a specific PROMOTER competition
+  competitionId     String?
+  /// Cached count of qualified ticket sales for the linked competition (updated async after checkout/refund)
+  qualifiedSales    Int     @default(0)
   promoCodes        BashEventPromoCode[]
   promoterUser      User?                @relation(fields: [userId], references: [id])
+  competition       Competition?         @relation(fields: [competitionId], references: [id], onDelete: SetNull)
 
   @@unique([promoterId, promotedForBash])
+  @@index([competitionId])
 }
 
 model PromoterStats {
@@ -632,11 +717,85 @@ model PromoterStats {
   pendingCredits        Int      @default(0)
   availableCredits      Int      @default(0)
   promoterInvitations   Int      @default(0)
+  // Cross-competition lifetime aggregates (added in promoter network layer migration)
+  totalCompetitionsJoined     Int @default(0)
+  totalCompetitionsWithSale   Int @default(0)
+  totalMilestonesReached      Int @default(0)
+  totalCompetitionsWon        Int @default(0) // rank=1 achieved
+  totalEventsPromoted         Int @default(0)
+  repeatOrganizerCount        Int @default(0) // distinct organizers worked with 2+ times
+  lifetimeQualifiedTickets    Int @default(0)
+  lifetimeRevenueCents        Int @default(0)
   createdAt             DateTime @default(now())
   updatedAt             DateTime @updatedAt
   user                  User     @relation(fields: [userId], references: [id])
 }
 
+/// Persisted per-promoter per-event performance record.
+/// Created when a promoter joins a PROMOTER competition; updated async after each qualified sale/refund.
+/// Survives competition end and event archival.
+model PromoterEventPerformance {
+  id                      String   @id @default(cuid())
+  promoterUserId          String
+  bashEventId             String
+  competitionId           String
+
+  clicks                  Int      @default(0)
+  checkoutStarts          Int      @default(0)
+  qualifiedOrders         Int      @default(0)
+  qualifiedTickets        Int      @default(0)
+  revenueGeneratedCents   Int      @default(0)
+
+  highestMilestoneThreshold Int?
+  finalRank               Int?
+
+  eventCategory           String?
+  eventCity               String?
+  eventRegion             String?
+
+  joinedAt                DateTime @default(now())
+  lastSaleAt              DateTime?
+  completedAt             DateTime?
+  createdAt               DateTime @default(now())
+  updatedAt               DateTime @updatedAt
+
+  promoterUser  User        @relation("PromoterEventPerformances", fields: [promoterUserId], references: [id], onDelete: Cascade)
+  bashEvent     BashEvent   @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  competition   Competition @relation(fields: [competitionId], references: [id], onDelete: Cascade)
+
+  @@unique([promoterUserId, competitionId])
+  @@index([promoterUserId])
+  @@index([bashEventId])
+  @@index([eventCategory, promoterUserId])
+  @@index([eventCity, promoterUserId])
+}
+
+/// Cross-event relationship between a host (organizer) and a promoter.
+/// Updated each time they work together. Enables "Invite Previous Promoters" and relationship depth metrics.
+model OrganizerPromoterRelationship {
+  id                    String   @id @default(cuid())
+  organizerUserId       String
+  promoterUserId        String
+
+  timesInvited          Int      @default(1)
+  timesJoined           Int      @default(0)
+  eventsWithSale        Int      @default(0)
+  totalTicketsGenerated Int      @default(0)
+  totalRevenueGeneratedCents Int  @default(0)
+  lastWorkedTogetherAt  DateTime?
+  lastInvitedAt         DateTime @default(now())
+
+  createdAt             DateTime @default(now())
+  updatedAt             DateTime @updatedAt
+
+  organizer User @relation("OrganizerPromoterRelationshipsAsOrganizer", fields: [organizerUserId], references: [id], onDelete: Cascade)
+  promoter  User @relation("OrganizerPromoterRelationshipsAsPromoter", fields: [promoterUserId], references: [id], onDelete: Cascade)
+
+  @@unique([organizerUserId, promoterUserId])
+  @@index([organizerUserId])
+  @@index([promoterUserId])
+}
+
 model PromoterClick {
   id               String   @id @default(cuid())
   promoterId       String
@@ -936,6 +1095,12 @@ model BashEvent {
   /// When true, only accounts with a published service profile (Vendor/Venue/Entertainment/Exhibitor/Sponsor/Event
   /// Service) can view budget lines revealed via `Budget.showOnBashDetailPage`. Default off = anyone can click to view.
   budgetRestrictedToServiceProviders Boolean          @default(false)
+  /// Public funding meter: value coming in toward included budget lines (not host spend).
+  showFundingMeter                   Boolean          @default(false)
+  /// When false, public can Pay now only — Commit / pledge POST is rejected.
+  fundingAllowCommitments            Boolean          @default(true)
+  /// When true, open pledges fill the lighter meter segment. Default off: bar is collected only.
+  fundingShowPledgesOnMeter          Boolean          @default(false)
   /// When true on Rsvp-mode events, affirmative RSVPs land in a host approval queue first.
   rsvpRequiresApproval        Boolean                @default(false)
   /// Hide when guests RSVP'd on host-facing attendee views.
@@ -943,6 +1108,8 @@ model BashEvent {
   /// Only allow inviting people who share a mutual bash with the host.
   invitesLimitedToMutuals     Boolean                @default(false)
   showOrganizerTitles         Boolean                @default(false)
+  /// When false, public/guest surfaces hide host identity (cards + Meet the host).
+  showHostOnBashPage          Boolean                @default(true)
   /// When true, low-stock scarcity badges show "X% left" instead of "Only N left".
   showPercentRemaining        Boolean                @default(false)
   servicePreferences          Json? // New tiered status: { "Entertainment": "need", "Sponsors": "booked_closed", ... }
@@ -1002,6 +1169,14 @@ model BashEvent {
   guestsCanInviteOthers       Boolean                @default(false)
   /// Private-event screening: route access requests to a host approval queue
   accessScreeningEnabled      Boolean                @default(false)
+  /// Optional host application (markup + questions) before RSVP or ticket checkout.
+  applicationEnabled          Boolean                @default(false)
+  /// Rich-text intro shown at the top of the guest application.
+  applicationIntroHtml        String?                @db.Text
+  /// After this time, guests cannot submit a new application. Hosts can still review.
+  applicationClosesAt         DateTime?
+  /// When true, auto-approve applicants this host has approved on a prior bash.
+  autoApproveRegulars         Boolean                @default(false)
   /// Collaborative post-event photo/video album contributions
   albumEnabled                Boolean                @default(false)
   /// When true, attendee uploads require host approval before appearing in the public album.
@@ -1038,6 +1213,10 @@ model BashEvent {
   organizationId String?
   organization   Organization? @relation("OrganizationBashEvents", fields: [organizationId], references: [id])
 
+  /// Host-as-service identity. XOR with organizationId (enforced in upsert + DB check).
+  hostedByServiceId String?
+  hostedByService   Service? @relation("BashEventHostedByService", fields: [hostedByServiceId], references: [id], onDelete: SetNull)
+
   // Organization access controls (only apply when organizationId is set)
   requiresOrgMembership    Boolean  @default(false) // Must be member to attend/RSVP
   allowMemberGuests        Boolean  @default(false) // Members can bring +1s
@@ -1149,7 +1328,10 @@ model BashEvent {
   eventReferralRewards EventReferralReward[]
   eventReferrals       EventReferral[]
   discussionComments   EventDiscussionComment[]
-  bashEventDonations   BashEventDonation[]
+  bashEventDonations     BashEventDonation[]
+  budgetContributions    BudgetContribution[]
+  giveaways         Giveaway[]
+  promoterEventPerformances PromoterEventPerformance[]
 
   // Adventures / Side Quests
   sideQuests           SideQuest[]
@@ -1215,6 +1397,7 @@ model BashEvent {
   @@index([templateId])
   @@index([parentEventId])
   @@index([organizationId])
+  @@index([hostedByServiceId])
   @@index([eventSeriesId])
   @@index([status, aiApprovalVerdict])
 }
@@ -2025,11 +2208,16 @@ model PublicBashRsvp {
   plusOneNames  String[] @default([])
   /// Set when the guest keeps or declines after a postponement; cleared on each new Postpone.
   postponeRespondedAt DateTime?
+  /// Optional guest photo submitted with an RSVP application.
+  applicationPhotoUrl String?
+  /// Optional host sentence included when an RSVP application is denied.
+  hostNote            String?
   createdAt   DateTime @default(now())
   updatedAt   DateTime @updatedAt
 
-  bashEvent BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
-  user      User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  bashEvent            BashEvent                  @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  user                 User                       @relation(fields: [userId], references: [id], onDelete: Cascade)
+  applicationAnswers   BashEventQuestionAnswer[]
 
   @@unique([bashEventId, userId])
   @@index([bashEventId])
@@ -2190,6 +2378,7 @@ model SideQuest {
   eventBadge   EventBadge?           @relation(fields: [eventBadgeId], references: [id], onDelete: SetNull)
   competition  Competition?          @relation(fields: [competitionId], references: [id], onDelete: SetNull)
   completions  SideQuestCompletion[]
+  giveaways Giveaway[]
   milestonesUnlocking SideQuestMilestone[] @relation("MilestoneUnlocksQuest")
   checkpoints  SideQuestCheckpoint[]
   progressHits SideQuestProgressHit[]
@@ -2464,34 +2653,57 @@ enum BashEventQuestionType {
   YesNo
 }
 
-/// Host-defined custom RSVP / checkout question for a bash.
+/// What happens when a choice answer is not in acceptableOptions.
+enum QuestionMismatchAction {
+  None
+  FlagForReview
+  AutoDeny
+}
+
+/// Host-defined custom RSVP / checkout / application question for a bash.
 model BashEventCustomQuestion {
-  id          String                @id @default(cuid())
-  bashEventId String
-  prompt      String
-  type        BashEventQuestionType @default(ShortText)
-  options     String[]              @default([])
-  required    Boolean               @default(false)
-  sortOrder   Int                   @default(0)
-  createdAt   DateTime              @default(now())
-  updatedAt   DateTime              @updatedAt
+  id                 String                  @id @default(cuid())
+  bashEventId        String
+  prompt             String
+  type               BashEventQuestionType   @default(ShortText)
+  options            String[]                @default([])
+  required           Boolean                 @default(false)
+  sortOrder          Int                     @default(0)
+  /// null = every applying surface (all application tiers + RSVP).
+  ticketTierId       String?
+  mismatchAction     QuestionMismatchAction  @default(None)
+  acceptableOptions  String[]                @default([])
+  /// When set, only show this question if the parent answer matches showWhenAnswer.
+  parentQuestionId   String?
+  showWhenAnswer     String?
+  createdAt          DateTime                @default(now())
+  updatedAt          DateTime                @updatedAt
 
   @@index([bashEventId])
+  @@index([ticketTierId])
+  @@index([parentQuestionId])
 }
 
-/// An attendee's answer to a custom question (captured at RSVP / checkout).
+/// An attendee's answer to a custom question (captured at RSVP / checkout / application).
 model BashEventQuestionAnswer {
-  id          String   @id @default(cuid())
-  questionId  String
-  bashEventId String
-  userId      String?
-  email       String?
-  ticketId    String?
-  answer      String
-  createdAt   DateTime @default(now())
+  id              String   @id @default(cuid())
+  questionId      String
+  bashEventId     String
+  userId          String?
+  email           String?
+  ticketId        String?
+  accessRequestId String?
+  publicRsvpId    String?
+  answer          String
+  createdAt       DateTime @default(now())
+
+  accessRequest BashEventAccessRequest? @relation(fields: [accessRequestId], references: [id], onDelete: SetNull)
+  publicRsvp    PublicBashRsvp?         @relation(fields: [publicRsvpId], references: [id], onDelete: SetNull)
 
   @@index([questionId])
   @@index([bashEventId])
+  @@index([accessRequestId])
+  @@index([publicRsvpId])
 }
 
 enum BashEventAccessRequestStatus {
@@ -2510,10 +2722,17 @@ model BashEventAccessRequest {
   status           BashEventAccessRequestStatus @default(Pending)
   reviewedByUserId String?
   reviewedAt       DateTime?
-  createdAt        DateTime                     @default(now())
-  updatedAt        DateTime                     @updatedAt
+  /// Optional host sentence included when the request is denied.
+  hostNote             String?
+  ticketTierId         String?
+  applicationPhotoUrl  String?
+  createdAt            DateTime                     @default(now())
+  updatedAt            DateTime                     @updatedAt
+
+  answers BashEventQuestionAnswer[]
 
   @@index([bashEventId, status])
+  @@index([ticketTierId])
 }
 
 /// A collaborative album contribution (photo/video URL) for a bash.
@@ -3324,6 +3543,8 @@ model TicketTier {
 
   /// Host opt-in: buyers of this tier may choose mailed or venue will-call physical delivery (see TicketPrintOrder).
   allowsPhysicalDelivery Boolean @default(false)
+  /// Guests must complete the event application and be approved before buying this tier.
+  requiresApplication    Boolean @default(false)
 
   @@unique([bashEventId, title])
   @@index([availableAt])
@@ -3474,6 +3695,7 @@ model Ticket {
   flyerConversions   FlyerConversion[]
   coatCheckEntitlements CoatCheckEntitlement[]
   printOrder            TicketPrintOrder?
+  giveawayRedemptions GiveawayRedemption[]
 
   @@index([bashEventId])
   @@index([bashEventId, seatId])
@@ -4451,6 +4673,7 @@ model User {
   eventFeaturedGuestSpots      EventFeaturedGuest[]         @relation("FeaturedGuestOnEvent")
   eventAttendeeVisibilities    EventAttendeeVisibility[]    @relation("AttendeeVisibilityOnEvent")
   bashEventDonations             BashEventDonation[]
+  budgetContributions            BudgetContribution[]
   bashCreativeSubmissions        BashCreativeSubmission[]
   ticketsOnWaitlist              Ticket[]                     @relation("TicketsOnWaitlist")
   transfersFrom                  TicketTransfer[]             @relation("TransfersFrom")
@@ -4557,6 +4780,9 @@ model User {
   coatCheckEntitlementsOwned      CoatCheckEntitlement[] @relation("CoatCheckOwner")
   coatCheckEntitlementsCheckedIn  CoatCheckEntitlement[] @relation("CoatCheckCheckedInBy")
   coatCheckEntitlementsClaimed    CoatCheckEntitlement[] @relation("CoatCheckClaimedBy")
+  giveawayRedemptions        GiveawayRedemption[] @relation("GiveawayRedemptionUser")
+  giveawayRedemptionsReceived GiveawayRedemption[] @relation("GiveawayReceivedBy")
+  giveawayRedemptionsVoided   GiveawayRedemption[] @relation("GiveawayVoidedBy")
   bashBusWaitlistSignup    BashBusWaitlistSignup?
   collectibleRedemptions   CollectibleRedemption[]
   bashFeedSaves            BashFeedSave[]
@@ -4636,6 +4862,11 @@ model User {
 
   phoneVerificationCodes PhoneVerificationCode[]
   smsSendLogs            SmsSendLog[]
+
+  // Promoter Network Layer relations
+  promoterEventPerformances                    PromoterEventPerformance[]             @relation("PromoterEventPerformances")
+  organizerPromoterRelationshipsAsOrganizer    OrganizerPromoterRelationship[]        @relation("OrganizerPromoterRelationshipsAsOrganizer")
+  organizerPromoterRelationshipsAsPromoter     OrganizerPromoterRelationship[]        @relation("OrganizerPromoterRelationshipsAsPromoter")
 }
 
 model PhoneVerificationCode {
@@ -5285,6 +5516,7 @@ model Service {
   serviceCategoryRequests            ServiceCategoryRequest[] // Services created from approved category requests
   associatedBashesReferencingMe      AssociatedBash[]           @relation("AssociatedBashToService")
   bashEvent                          BashEvent[]                @relation("BashEventToService")
+  hostedBashEvents                   BashEvent[]                @relation("BashEventHostedByService")
   media                              Media[]                    @relation("MediaToService")
   analytics                          ServiceAnalytics[] // Track service analytics
   scoutReferrals                     ScoutReferral[]            @relation("ScoutServiceProfile")
@@ -5308,6 +5540,7 @@ model Service {
   serviceReviews                     ServiceReview[]
   providerHostReviews                ProviderHostReview[]
   sideQuestCheckpoints               SideQuestCheckpoint[]
+  giveaways                     Giveaway[]
   serviceRankings                    ServiceRankings?
 
   @@index([serviceListingStripeSubscriptionId])
@@ -6993,6 +7226,8 @@ model Budget {
   remainingCents      Int? // Can be computed: totalAllocatedCents - spentCents
   /// Host opt-in: reveal this line's category + amount to providers on the public bash detail page.
   showOnBashDetailPage Boolean @default(false)
+  /// When true (default), this line's allocation is part of the public funding goal.
+  includeOnFundingMeter Boolean @default(true)
 
   // Categorization
   category   String? // "Marketing", "Catering", "Venue", "Annual", "Activities"
@@ -7022,7 +7257,8 @@ model Budget {
   service      Service?      @relation("ServiceBudgets", fields: [serviceId], references: [id], onDelete: Cascade)
   submitter    User?         @relation("BudgetSubmitter", fields: [submittedBy], references: [id])
   approver     User?         @relation("BudgetApprover", fields: [approverId], references: [id])
-  expenses     Expense[]
+  expenses      Expense[]
+  contributions BudgetContribution[]
 
   @@index([organizationId])
   @@index([bashEventId])
@@ -7034,6 +7270,116 @@ model Budget {
   @@index([fiscalYear])
 }
 
+enum BudgetContributionKind {
+  Cash
+  InKind
+}
+
+enum BudgetContributionStatus {
+  Pledged
+  Paid
+  Fulfilled
+  Declined
+  Cancelled
+}
+
+enum BudgetContributionSource {
+  Stripe
+  HostEntered
+  PublicPledge
+}
+
+/// Value coming in toward a bash budget line (host-entered, public pledge, or Stripe).
+/// `budgetId` is required on create for HostEntered / PublicPledge / Stripe; null is unallocated only.
+model BudgetContribution {
+  id                      String                     @id @default(cuid())
+  bashEventId             String
+  budgetId                String?
+  contributorUserId       String?
+  displayName             String
+  kind                    BudgetContributionKind
+  status                  BudgetContributionStatus
+  source                  BudgetContributionSource
+  amountCents             Int
+  note                    String?
+  stripeCheckoutSessionId String?                    @unique
+  stripePaymentIntentId   String?                    @unique
+  createdAt               DateTime                   @default(now())
+  updatedAt               DateTime                   @updatedAt
+
+  bashEvent   BashEvent @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  budget      Budget?   @relation(fields: [budgetId], references: [id], onDelete: SetNull)
+  contributor User?     @relation(fields: [contributorUserId], references: [id], onDelete: SetNull)
+
+  @@index([bashEventId])
+  @@index([budgetId])
+  @@index([contributorUserId])
+  @@index([status])
+}
+
+enum GiveawayEligibility {
+  AnyoneGoing
+  TicketHolders
+  CheckedIn
+  CompetitionParticipants
+  SideQuestCompleters
+}
+
+/// Host/sponsor swag handed out at the bash. Not merch (for sale) and not a competition prize.
+model Giveaway {
+  id                 String              @id @default(cuid())
+  bashEventId        String
+  name               String
+  description        String?
+  imageUrl           String?
+  quantityTotal      Int
+  quantityRemaining  Int
+  displayOrder       Int                 @default(0)
+  sponsorLabel       String?
+  sponsorServiceId   String?
+  eligibility        GiveawayEligibility
+  competitionId      String?
+  sideQuestId        String?
+  pickupNote         String?
+  createdAt          DateTime            @default(now())
+  updatedAt          DateTime            @updatedAt
+
+  bashEvent      BashEvent                 @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  competition    Competition?              @relation(fields: [competitionId], references: [id], onDelete: SetNull)
+  sideQuest      SideQuest?                @relation(fields: [sideQuestId], references: [id], onDelete: SetNull)
+  sponsorService Service?                  @relation(fields: [sponsorServiceId], references: [id], onDelete: SetNull)
+  redemptions    GiveawayRedemption[]
+
+  @@index([bashEventId])
+  @@index([bashEventId, displayOrder])
+  @@index([competitionId])
+  @@index([sideQuestId])
+}
+
+/// Event-team confirmed handout. Partial unique (giveawayId, attendeeId) WHERE voidedAt IS NULL — migration SQL only.
+model GiveawayRedemption {
+  id               String    @id @default(cuid())
+  giveawayId       String
+  attendeeId       String
+  userId           String?
+  ticketId         String?
+  receivedAt       DateTime  @default(now())
+  receivedByUserId String
+  voidedAt         DateTime?
+  voidedByUserId   String?
+
+  giveaway   Giveaway @relation(fields: [giveawayId], references: [id], onDelete: Cascade)
+  user       User?         @relation("GiveawayRedemptionUser", fields: [userId], references: [id], onDelete: SetNull)
+  ticket     Ticket?       @relation(fields: [ticketId], references: [id], onDelete: SetNull)
+  receivedBy User          @relation("GiveawayReceivedBy", fields: [receivedByUserId], references: [id], onDelete: Restrict)
+  voidedBy   User?         @relation("GiveawayVoidedBy", fields: [voidedByUserId], references: [id], onDelete: SetNull)
+
+  @@index([giveawayId])
+  @@index([attendeeId])
+  @@index([ticketId])
+  @@index([userId])
+}
+
 enum ExpenseExtractionStatus {
   none
   pending
@@ -8176,6 +8522,13 @@ enum NotificationType {
   CompetitionPrizeOfferReceived // Host: someone offered a prize contribution
   CompetitionPrizeOfferAccepted // Offeror: host accepted your prize offer
   CompetitionPrizeOfferDeclined // Offeror: host declined your prize offer
+  PromoterCompetitionJoined     // Organizer: a promoter joined the challenge
+  PromoterCompetitionMilestoneReached // Promoter: you hit a milestone and earned a reward
+  PromoterCompetitionLeaderboardChange // Promoter: your leaderboard rank changed
+  PromoterCompetitionEnding     // Promoter: competition ending in 24h (with earned progress)
+  PromoterCompetitionCompleted  // Promoter + organizer: competition finished
+  PromoterCompetitionRewardFulfilled // Promoter: organizer marked your reward as fulfilled
+  PreviousPromoterInvited       // Promoter: organizer you've worked with is inviting you back
   BashRating
   BashRatingMilestone
   BashFeedPost
@@ -8872,6 +9225,41 @@ enum CompetitionType {
   AUDIENCE_VOTING // Audience Voting-Based
 }
 
+enum CompetitionPurpose {
+  CONSUMER // existing behavior — vote/bracket/raffle/contest
+  PROMOTER // ticket sales contest — rewards promoters per milestone
+}
+
+enum PromoterRewardMode {
+  TOTAL_AT_MILESTONE // "10 sales = $40 total earned" (default)
+  ADDITIVE // milestone rewards stack on each other
+}
+
+enum PromoterRecruitMode {
+  Public // anyone can join from bash page
+  InviteOnly // organizer sends invites (default)
+  Private // no enrollment shown publicly
+}
+
+enum PromoterRewardType {
+  CASH
+  TICKET
+  TICKET_UPGRADE
+  TABLE
+  ACCESS
+  MERCH
+  SPONSOR_PRIZE
+  CREDIT
+  CUSTOM
+}
+
+enum PromoterRewardStatus {
+  PENDING // milestone not yet reached
+  EARNED // threshold crossed; awaiting fulfillment
+  FULFILLED // organizer marked delivered
+  REVOKED // refunds pushed promoter below threshold; FULFILLED rewards are never auto-revoked
+}
+
 enum PlacementAwardStyle {
   Trophy // Gold/silver/bronze trophies for 1st/2nd/3rd
   Medal  // Gold/silver/bronze medals for 1st/2nd/3rd
@@ -12212,6 +12600,8 @@ model AppliedDiscount {
   attributionCampaignId String?
   commissionRate        Float?
   commissionAmount      Int? // In cents
+  /// Set when this discount was applied under a PROMOTER competition — used for attribution recalculation
+  competitionId         String?
 
   // Display
   displayReason String? // "Early Bird Discount" for receipt