@bash-app/bash-common 30.235.0 → 30.237.0

package/prisma/schema.prisma

@@ -682,6 +682,11 @@ model BashEvent {
   donationDetails             String?
   absorbDonationFees          Boolean                @default(false)
   absorbTicketFees            Boolean                @default(false)
+  /// Phase 1 of unified-pricing roadmap: governs where PER_BASHPOINTS_ATTENDEE
+  /// settlements are paid from. `HostWallet` (default) pays directly from the
+  /// host's BP balance; `BashBpPool` taps a per-bash pool funded by
+  /// BashPoints-priced ticket sales before falling back to the host wallet.
+  bashPointsPayoutSource      BashPointsPayoutSource @default(HostWallet)
   /// When true, attendees may request a refund from the app/email (host approves in Tickets → Refunds). When false, self-serve refund CTAs are hidden.
   allowAttendeeRefundRequests Boolean                @default(true)
   // GuestPays / Split: Stripe processing + Bash platform fee presentation (see platformFeeEnabled).
@@ -697,7 +702,7 @@ model BashEvent {
   /// Host uses Tap to Pay on a supported device (no separate reader). Door flow when enabled.
   hasTapToPay                 Boolean                @default(true)
   /// Optional Stripe Terminal Location id on the host's connected account.
-  stripeTerminalLocationId   String?
+  stripeTerminalLocationId    String?
   /// Optional: attendees can tag which act they came to see; drives attribution reports and future payouts.
   artistAttributionEnabled    Boolean                @default(false)
   /// "percentage" | "flat" — how artistPayoutRate is interpreted for suggested splits (display/export).
@@ -890,6 +895,8 @@ model BashEvent {
   /// SHA-256 of the snapshot fed to the AI; lets us skip a re-run when nothing changed.
   aiApprovalContentHash String?
 
+  bookingOffers ServiceBookingOffer[]
+
   @@index([templateId])
   @@index([parentEventId])
   @@index([organizationId])
@@ -992,9 +999,9 @@ model FlyerCampaign {
   fulfillmentType FlyerFulfillmentType @default(DONE_FOR_YOU)
 
   /// EDDM: route map + tier pricing. LOB: recipient list + lobFlyerUtils pricing.
-  mailChannel        FlyerMailChannel   @default(EDDM_ROUTES)
+  mailChannel            FlyerMailChannel @default(EDDM_ROUTES)
   /// Used when `mailChannel` is LOB_ADDRESS_LIST. Ignored for pure EDDM campaigns.
-  lobPostcardSize    LobPostcardSize     @default(LOB_6X11)
+  lobPostcardSize        LobPostcardSize  @default(LOB_6X11)
   lastVendorStatusSyncAt DateTime?
   lastLobWebhookId       String?
 
@@ -1008,8 +1015,8 @@ model FlyerCampaign {
   campaignQrSlug    String  @unique
   campaignPromoCode String?
 
-  ctaLabel        String?
-  templateVariant String  @default("default")
+  ctaLabel                  String?
+  templateVariant           String   @default("default")
   excludedSponsorCategories String[] @default([])
 
   status FlyerCampaignStatus @default(DRAFT)
@@ -1017,13 +1024,13 @@ model FlyerCampaign {
   vendorOrderRef String?
   vendorStatus   String?
 
-  bashEvent       BashEvent              @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
-  host            User                   @relation(fields: [hostUserId], references: [id], onDelete: Cascade)
-  routes            FlyerMailingRoute[]
-  mailingAddresses  FlyerMailingAddress[]
-  artworkVersions   FlyerArtwork[]
-  sponsors          FlyerCampaignSponsor[]
-  conversions       FlyerConversion[]
+  bashEvent        BashEvent              @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  host             User                   @relation(fields: [hostUserId], references: [id], onDelete: Cascade)
+  routes           FlyerMailingRoute[]
+  mailingAddresses FlyerMailingAddress[]
+  artworkVersions  FlyerArtwork[]
+  sponsors         FlyerCampaignSponsor[]
+  conversions      FlyerConversion[]
 
   createdAt DateTime @default(now())
   updatedAt DateTime @updatedAt
@@ -1058,18 +1065,18 @@ model FlyerMailingAddress {
   campaignId String
   campaign   FlyerCampaign @relation(fields: [campaignId], references: [id], onDelete: Cascade)
 
-  name  String?
-  line1 String
-  line2 String?
-  city  String
-  state String
+  name    String?
+  line1   String
+  line2   String?
+  city    String
+  state   String
   /// ZIP or ZIP+4 as a single string (normalized server-side for Lob)
   zipCode String
 
-  source             FlyerMailingAddressSource @default(CSV_IMPORT)
+  source           FlyerMailingAddressSource @default(CSV_IMPORT)
   /// pending | valid | failed
-  validationStatus  String  @default("pending")
-  validationError   String?
+  validationStatus String                    @default("pending")
+  validationError  String?
   /// Lob `adr_…` after creating a saved address, optional
   lobAddressId     String?
 
@@ -1099,9 +1106,9 @@ model FlyerArtwork {
 }
 
 model FlyerCampaignSponsor {
-  id         String        @id @default(cuid())
-  campaignId String
-  campaign   FlyerCampaign @relation(fields: [campaignId], references: [id], onDelete: Cascade)
+  id               String          @id @default(cuid())
+  campaignId       String
+  campaign         FlyerCampaign   @relation(fields: [campaignId], references: [id], onDelete: Cascade)
   sponsorProfileId String?
   sponsorProfile   SponsorProfile? @relation(fields: [sponsorProfileId], references: [id], onDelete: SetNull)
 
@@ -1115,8 +1122,8 @@ model FlyerCampaignSponsor {
 
   slotPriceCents        Int       @default(0)
   stripePaymentIntentId String?
-  stripeRefundId         String?
-  refundedAt             DateTime?
+  stripeRefundId        String?
+  refundedAt            DateTime?
   paidAt                DateTime?
 
   hostPayoutCents Int?
@@ -1139,9 +1146,9 @@ model FlyerCampaignSponsor {
 }
 
 model SponsorProfile {
-  id                     String   @id @default(cuid())
+  id                     String                 @id @default(cuid())
   ownerUserId            String
-  owner                  User     @relation(fields: [ownerUserId], references: [id], onDelete: Cascade)
+  owner                  User                   @relation(fields: [ownerUserId], references: [id], onDelete: Cascade)
   businessName           String
   normalizedBusinessName String
   contactName            String?
@@ -1153,11 +1160,11 @@ model SponsorProfile {
   logoAltText            String?
   defaultCtaText         String?
   description            String?
-  preferredCities        String[] @default([])
+  preferredCities        String[]               @default([])
   budgetRange            String?
   flyerSponsors          FlyerCampaignSponsor[]
-  createdAt              DateTime @default(now())
-  updatedAt              DateTime @updatedAt
+  createdAt              DateTime               @default(now())
+  updatedAt              DateTime               @updatedAt
 
   @@unique([ownerUserId, normalizedBusinessName])
   @@index([ownerUserId])
@@ -1576,26 +1583,6 @@ model BashCreditTransaction {
   @@index([type])
 }
 
-model PendingBashPointsGift {
-  id              String            @id @default(cuid())
-  senderId        String
-  sender          User              @relation("SentPendingGifts", fields: [senderId], references: [id], onDelete: Cascade)
-  recipientEmail  String
-  amount          Int
-  message         String?
-  status          PendingGiftStatus @default(Pending)
-  claimedAt       DateTime?
-  claimedByUserId String?
-  claimedBy       User?             @relation("ClaimedPendingGifts", fields: [claimedByUserId], references: [id], onDelete: SetNull)
-  returnedAt      DateTime?
-  expiresAt       DateTime
-  createdAt       DateTime          @default(now())
-
-  @@index([recipientEmail, status])
-  @@index([senderId])
-  @@index([expiresAt, status])
-}
-
 model UserReferralCode {
   id                    String                 @id @default(cuid())
   userId                String                 @unique
@@ -1810,9 +1797,11 @@ model Ticket {
   qrToken                    String?
 
   // BashPoints Purchase Tracking
-  purchaseType     String? // "USD", "BashPoints", "Free", "Comp", "BashPass"
-  pointsPaid       Int? // BashPoints amount paid (if purchaseType="BashPoints")
-  stripePurchaseId String? // Stripe payment ID (if purchaseType="USD")
+  purchaseType       String? // "USD", "BashPoints", "Free", "Comp", "BashPass", "PayAtDoor", "Cash"
+  /// Promo entered at Pay-at-Door reservation; discount applied when they pay at the door (analytics: unpaid rows with code set).
+  payAtDoorPromoCode String?
+  pointsPaid         Int? // BashPoints amount paid (if purchaseType="BashPoints")
+  stripePurchaseId   String? // Stripe payment ID (if purchaseType="USD")
 
   /// When set, this ticket was created from a host `TicketGiftGrant` (comp block for distribution).
   giftGrantId String?
@@ -2101,18 +2090,19 @@ model Link {
 }
 
 model Media {
-  id                           String                   @id @default(cuid())
-  url                          String                   @unique
-  type                         MediaType
-  mimetype                     String?
-  volunteerServiceId           String?
-  serviceRatesAssociationId    String?
-  serviceRatesAssociation      ServiceRatesAssociation? @relation(fields: [serviceRatesAssociationId], references: [id], onDelete: Cascade)
-  volunteerService             VolunteerService?        @relation(fields: [volunteerServiceId], references: [id])
-  stripeAccount                StripeAccount[]
-  bashEventsReferencingMe      BashEvent[]              @relation("BashEventToMedia")
-  serviceReferencingMe         Service[]                @relation("MediaToService")
-  sponsoredEventsReferencingMe SponsoredEvent[]         @relation("MediaToSponsoredEvent")
+  id                                     String                   @id @default(cuid())
+  url                                    String                   @unique
+  type                                   MediaType
+  mimetype                               String?
+  volunteerServiceId                     String?
+  serviceRatesAssociationId              String?
+  serviceRatesAssociation                ServiceRatesAssociation? @relation(fields: [serviceRatesAssociationId], references: [id], onDelete: Cascade)
+  volunteerService                       VolunteerService?        @relation(fields: [volunteerServiceId], references: [id])
+  stripeAccount                          StripeAccount[]
+  bashEventsReferencingMe                BashEvent[]              @relation("BashEventToMedia")
+  serviceReferencingMe                   Service[]                @relation("MediaToService")
+  sponsoredEventsReferencingMe           SponsoredEvent[]         @relation("MediaToSponsoredEvent")
+  organizationsNonprofitDeterminationDoc Organization[]           @relation("OrganizationNonprofitDeterminationDoc")
 }
 
 model Prize {
@@ -2243,16 +2233,16 @@ model SocialMediaProfile {
 }
 
 model User {
-  id                   String      @id @default(cuid())
-  username             String?     @unique
-  email                String      @unique
-  createdOn            DateTime    @default(now())
-  stripeCustomerId     String?     @unique
-  stripeAccountId      String?     @unique
+  id                   String          @id @default(cuid())
+  username             String?         @unique
+  email                String          @unique
+  createdOn            DateTime        @default(now())
+  stripeCustomerId     String?         @unique
+  stripeAccountId      String?         @unique
   /// Preferred processor for dual-rail onboarding (optional; legacy Stripe fields remain source of truth until fully migrated).
-  paymentProvider      PaymentProvider           @default(STRIPE)
-  isSuperUser          Boolean     @default(false)
-  isSuspended          Boolean     @default(false)
+  paymentProvider      PaymentProvider @default(STRIPE)
+  isSuperUser          Boolean         @default(false)
+  isSuspended          Boolean         @default(false)
   intent               UserIntent?
   signupSource         String? // e.g. 'jamwith', 'mixlog', 'organic' for attribution
   googleCalendarAccess String?
@@ -2452,8 +2442,7 @@ model User {
   bashEventMessagesRead          BashEventMessageRead[]       @relation("BashMessageReader")
   transferRequestsFrom           BashEventTransferRequest[]   @relation("TransferRequestsFrom")
   transferRequestsTo             BashEventTransferRequest[]   @relation("TransferRequestsTo")
-  sentPendingGifts               PendingBashPointsGift[]      @relation("SentPendingGifts")
-  claimedPendingGifts            PendingBashPointsGift[]      @relation("ClaimedPendingGifts")
+  venueFBCarryoverCredits        VenueFBCarryoverCredit[]     @relation("VenueFBCarryoverHost")
   biometricCredentials           BiometricCredential[]
   blocksReceived                 BlockedUser[]                @relation("UserBlocksReceived")
   blocksCreated                  BlockedUser[]                @relation("UserBlocksMade")
@@ -2507,6 +2496,8 @@ model User {
   serviceBookingForUser          ServiceBooking[]             @relation("BookingForUser")
   serviceBookingCheckout         ServiceBookingCheckout[]
   serviceBookingMessages         ServiceBookingMessage[]      @relation("ServiceMessageSender")
+  sentBookingOffers              ServiceBookingOffer[]        @relation("OfferSender")
+  receivedBookingOffers          ServiceBookingOffer[]        @relation("OfferRecipient")
   sessions                       Session[]
   socialMediaProfiles            SocialMediaProfile[]
   sponsorBookingRequestsAsHost   SponsorBookingRequest[]      @relation("SponsorBookingHost")
@@ -2606,17 +2597,19 @@ model User {
   ideaInterests IdeaInterest[]
 
   // Organization Relations
-  ownedOrganizations      Organization[]       @relation("OrganizationOwner")
-  organizationMemberships OrganizationMember[] @relation("OrganizationMemberUser")
-  organizationEventRSVPs  EventRSVP[]          @relation("OrganizationEventRSVP")
-  submittedExpenses       Expense[]            @relation("ExpenseSubmitter")
-  approvedExpenses        Expense[]            @relation("ExpenseApprover")
-  approvedBudgets         Budget[]             @relation("BudgetApprover")
-  submittedBudgets        Budget[]             @relation("BudgetSubmitter")
-  ownedBudgets            Budget[]             @relation("UserBudgets")
-  departmentsHeaded       Department[]         @relation("DepartmentHead")
-  favoriteOrganizations   Organization[]       @relation("FavoriteOrganizations")
-  eventSeriesCreated      EventSeries[]        @relation("EventSeriesCreator")
+  ownedOrganizations             Organization[]       @relation("OrganizationOwner")
+  /// Organizations this admin user has verified as a nonprofit.
+  verifiedNonprofitOrganizations Organization[]       @relation("OrganizationNonprofitVerifier")
+  organizationMemberships        OrganizationMember[] @relation("OrganizationMemberUser")
+  organizationEventRSVPs         EventRSVP[]          @relation("OrganizationEventRSVP")
+  submittedExpenses              Expense[]            @relation("ExpenseSubmitter")
+  approvedExpenses               Expense[]            @relation("ExpenseApprover")
+  approvedBudgets                Budget[]             @relation("BudgetApprover")
+  submittedBudgets               Budget[]             @relation("BudgetSubmitter")
+  ownedBudgets                   Budget[]             @relation("UserBudgets")
+  departmentsHeaded              Department[]         @relation("DepartmentHead")
+  favoriteOrganizations          Organization[]       @relation("FavoriteOrganizations")
+  eventSeriesCreated             EventSeries[]        @relation("EventSeriesCreator")
 
   // Service Includes & Add-On Requests
   suggestedIncludes ServiceInclude[]      @relation("SuggestedIncludes")
@@ -3065,6 +3058,7 @@ model Service {
   pocBusinessEmail                   String?
   additionalInfo                     String?
   coverPhoto                         String?
+  backgroundImage                    String? // Custom or curated background image URL for the service/org profile page
   mission                            String?
   communityInvolvement               String?
   emergencyContact                   String?
@@ -3103,9 +3097,6 @@ model Service {
   verifiedAt                         DateTime? // When verification was approved
   licenseNumber                      String? // License/registration number
   certifications                     String[]                   @default([]) // Array of certification names
-  /// Custom scope pricing — admin-gated flag for providers who need variable/quote-based pricing
-  customScopeStatus                  CustomScopeStatus          @default(None)
-  customScopeRequestNote             String? // Provider's explanation of why they need custom scope
   bashFeedPosts                      BashFeedPost[]
   bashEventArtists                   BashEventArtist[]
   bashCreativeSubmissions            BashCreativeSubmission[]
@@ -3145,6 +3136,7 @@ model Service {
   includes                           ServiceInclude[]
   addonRequests                      ServiceAddonRequest[]
   serviceBudgets                     Budget[]                   @relation("ServiceBudgets")
+  bookingOffers                      ServiceBookingOffer[]
 
   @@index([serviceListingStripeSubscriptionId])
   @@index([paymentAccountId])
@@ -3171,24 +3163,24 @@ model StripeAccount {
 
 /// Connects a user to Stripe and/or Square rails for provider payouts (dual-processor layer).
 model PaymentProviderAccount {
-  id        String          @id @default(cuid())
-  userId    String
-  provider  PaymentProvider @default(STRIPE)
-  stripeAccountId           String? @unique
-  stripeCustomerId          String? @unique
-  squareMerchantId          String? @unique
-  squareLocationId          String?
-  squareAccessToken         String? @db.Text
-  squareRefreshToken        String? @db.Text
-  squareTokenExpiresAt      DateTime?
-  accountVerified           Boolean  @default(false)
-  payoutsEnabled            Boolean  @default(false)
-  accountStatus             String?
-  createdAt                 DateTime @default(now())
-  updatedAt                 DateTime @updatedAt
-  lastVerifiedAt            DateTime?
-  user                      User     @relation(fields: [userId], references: [id], onDelete: Restrict, onUpdate: Cascade)
-  services                  Service[]
+  id                   String          @id @default(cuid())
+  userId               String
+  provider             PaymentProvider @default(STRIPE)
+  stripeAccountId      String?         @unique
+  stripeCustomerId     String?         @unique
+  squareMerchantId     String?         @unique
+  squareLocationId     String?
+  squareAccessToken    String?         @db.Text
+  squareRefreshToken   String?         @db.Text
+  squareTokenExpiresAt DateTime?
+  accountVerified      Boolean         @default(false)
+  payoutsEnabled       Boolean         @default(false)
+  accountStatus        String?
+  createdAt            DateTime        @default(now())
+  updatedAt            DateTime        @updatedAt
+  lastVerifiedAt       DateTime?
+  user                 User            @relation(fields: [userId], references: [id], onDelete: Restrict, onUpdate: Cascade)
+  services             Service[]
 
   @@unique([userId, provider])
   @@index([userId])
@@ -3209,32 +3201,47 @@ model StripeDispute {
 }
 
 model VolunteerService {
-  id                      String                   @id @default(cuid())
+  id                      String                    @id @default(cuid())
   userId                  String
   serviceRangeId          String?
   fullName                String?
   address                 String?
   email                   String?
   phone                   String?
-  agreedToAgreement       Boolean                  @default(false)
-  description             String                   @default("")
-  status                  VolunteerServiceStatus   @default(Draft)
+  agreedToAgreement       Boolean                   @default(false)
+  description             String                    @default("")
+  status                  VolunteerServiceStatus    @default(Draft)
   skills                  String?
   experienceLevel         String?
-  preferredEventTypes     String[]                 @default([])
-  availability            String[]                 @default([])
+  preferredEventTypes     String[]                  @default([])
+  availability            String[]                  @default([])
   physicalCapabilities    String?
   equipment               String?
   transportation          String?
   emergencyContactName    String?
   emergencyContactPhone   String?
-  serviceId               String                   @unique
-  links                   Link[]                   @relation("VolunteerServiceLinks")
+  serviceId               String                    @unique
+  // Volunteer compensation block — intentionally NARROWER than the unified
+  // pricing block used by paid verticals. Volunteers are not employees or
+  // contractors, so this surface deliberately excludes USD rates,
+  // PER_ATTENDEE, revenue share, etc. See
+  // `bash-common/src/utils/service/volunteerCompensationUtils.ts` and
+  // `docs/help-center/pricing-models/volunteer-stipend.md`.
+  compensationType        VolunteerCompensationType @default(None)
+  /// BashPoints amount per `rateUnit`. Closed-loop: only redeemable on Bash.
+  bashPointsStipend       Int?
+  /// `"shift" | "hour"` — kept as a String for forward flexibility.
+  rateUnit                String?
+  /// Free-form description of any perks ("Comp ticket + drink wristband + tee").
+  perksDescription        String?
+  /// Host-facing notes ("Free swag bag if you stay through breakdown").
+  compensationNotes       String?
+  links                   Link[]                    @relation("VolunteerServiceLinks")
   media                   Media[]
   serviceRatesAssociation ServiceRatesAssociation?
-  service                 Service                  @relation("ServiceToVolunteer", fields: [serviceId], references: [id])
-  serviceRange            ServiceRange?            @relation(fields: [serviceRangeId], references: [id])
-  user                    User                     @relation(fields: [userId], references: [id])
+  service                 Service                   @relation("ServiceToVolunteer", fields: [serviceId], references: [id])
+  serviceRange            ServiceRange?             @relation(fields: [serviceRangeId], references: [id])
+  user                    User                      @relation(fields: [userId], references: [id])
 
   @@index([userId])
 }
@@ -3253,6 +3260,18 @@ model EventService {
   menuItems           String?
   venueTypes          String[]
   secondaryVenueTypes String[]              @default([])
+  // Pricing Model Fields — Event Promoter subtype is locked to PER_ATTENDEE
+  // by `validateEventPromoterPricing` in bash-common/eventPromoterUtils.ts.
+  pricingModel        PricingModel?         @default(CUSTOM)
+  baseRateCents       Int?
+  // BashPoints unit rate, used when pricingModel = PER_BASHPOINTS_ATTENDEE
+  // or for BP-priced tiered packages. Kept alongside baseRateCents so a single
+  // service can quote in either currency. See Phase 1 of the unified-pricing
+  // roadmap.
+  baseRateBashPoints  Int?
+  rateUnit            String?
+  minimumChargeCents  Int?
+  minimumQuantity     Int?
   crowdSize           AmountOfGuests?       @relation(fields: [crowdSizeId], references: [id], onDelete: Cascade)
   serviceRange        ServiceRange?         @relation(fields: [serviceRangeId], references: [id])
   service             Service?
@@ -3290,9 +3309,19 @@ model EntertainmentService {
   notifyOnMatchingVenues    Boolean   @default(true)
   lastMatchNotificationSent DateTime?
 
-  crowdSize    AmountOfGuests? @relation(fields: [crowdSizeId], references: [id], onDelete: Cascade)
-  serviceRange ServiceRange?   @relation(fields: [serviceRangeId], references: [id])
-  service      Service?
+  // Phase 1 unified pricing block — adds parity with EventService/Vendor/etc.
+  // so EntertainmentService can quote PER_ATTENDEE, PER_PAID_ATTENDEE, etc.
+  pricingModel       PricingModel?   @default(CUSTOM)
+  baseRateCents      Int?
+  baseRateBashPoints Int?
+  rateUnit           String?
+  minimumChargeCents Int?
+  minimumQuantity    Int?
+  tierPricing        Json?
+  pricingNotes       String?
+  crowdSize          AmountOfGuests? @relation(fields: [crowdSizeId], references: [id], onDelete: Cascade)
+  serviceRange       ServiceRange?   @relation(fields: [serviceRangeId], references: [id])
+  service            Service?
 }
 
 model Vendor {
@@ -3323,6 +3352,7 @@ model Vendor {
   // Pricing Model Fields
   pricingModel       PricingModel? @default(CUSTOM)
   baseRateCents      Int? // Base rate in cents
+  baseRateBashPoints Int? // BashPoints unit rate (for PER_BASHPOINTS_ATTENDEE etc.)
   rateUnit           String? // "per_person", "per_hour", "per_day", "flat"
   minimumChargeCents Int? // Minimum booking amount in cents
   minimumQuantity    Int? // Minimum attendees/hours/days
@@ -3443,6 +3473,7 @@ model Exhibitor {
   // Pricing Model Fields
   pricingModel       PricingModel? @default(CUSTOM)
   baseRateCents      Int? // Base rate in cents
+  baseRateBashPoints Int? // BashPoints unit rate (for PER_BASHPOINTS_ATTENDEE etc.)
   rateUnit           String? // "per_person", "per_hour", "per_day", "flat"
   minimumChargeCents Int? // Minimum booking amount in cents
   minimumQuantity    Int? // Minimum attendees/hours/days
@@ -3470,6 +3501,7 @@ model Sponsor {
   // Pricing Model Fields
   pricingModel       PricingModel? @default(CUSTOM)
   baseRateCents      Int? // Base rate in cents
+  baseRateBashPoints Int? // BashPoints unit rate (for PER_BASHPOINTS_ATTENDEE etc.)
   rateUnit           String? // "per_person", "per_hour", "per_day", "flat"
   minimumChargeCents Int? // Minimum booking amount in cents
   minimumQuantity    Int? // Minimum attendees/hours/days
@@ -3517,42 +3549,187 @@ model Venue {
   notifyOnMatchingMusicians Boolean   @default(true)
   lastMatchNotificationSent DateTime?
 
-  /// Venue loyalty program intent (wizard + profile; redemption is future work)
+  /// Venue loyalty program. Per-offer structured configuration lives on
+  /// VenueLoyaltyOffer. `loyaltyTemplateIds[]` and `loyaltyNotes` are deprecated
+  /// (kept for backward compat through one release); new wizards write offers.
   loyaltyEnabled     Boolean  @default(false)
   loyaltyTemplateIds String[] @default([])
   loyaltyNotes       String?
 
   bashEvents              BashEvent[]
   service                 Service?
+  venueLoyaltyOffers      VenueLoyaltyOffer[]
   venueLoyaltyRedemptions VenueLoyaltyRedemption[]
 
   // Pricing model — what the venue charges the host
   pricingModel       PricingModel? @default(CUSTOM)
   baseRateCents      Int?
+  baseRateBashPoints Int? // BashPoints unit rate (for PER_BASHPOINTS_ATTENDEE etc.)
   rateUnit           String?
   minimumChargeCents Int?
   minimumQuantity    Int?
   tierPricing        Json?
   pricingNotes       String?
+
+  // Phase 2 of the unified-pricing roadmap — F&B minimum spend + revenue share.
+  // All snapshot fields are copied onto `ServiceBooking` at confirmation time
+  // so subsequent policy edits don't move historical bookings.
+  fbMinimumEnabled                   Boolean                @default(false)
+  /// Per-day-of-week minimums in cents. JSON shape:
+  /// `{ Mon: 800000, Tue: 800000, Wed: 800000, Thu: 800000, Fri: 4000000, Sat: 4000000, Sun: 2000000 }`.
+  /// Missing keys → no minimum that day. Date-specific overrides live in
+  /// `VenueFBMinimumOverride` and beat the schedule.
+  fbMinimumSchedule                  Json?
+  /// ISO 4217 code. Only USD is supported in Phase 2; field reserved for future.
+  fbMinimumCurrency                  String?                @default("USD")
+  /// Does the stated minimum already credit service charge as part of the
+  /// covered amount? Industry default = TRUE.
+  fbServiceChargeCountsTowardMinimum Boolean                @default(true)
+  /// Does the stated minimum include tax in the spend it counts? Industry
+  /// default = FALSE.
+  fbMinimumIncludesTax               Boolean                @default(false)
+  /// Free-form policy notes ("Minimum waived for non-profit events", etc.).
+  fbMinimumNotes                     String?
+  /// Default resolution when a shortfall occurs at settlement. Venue can
+  /// override on a per-booking basis when uploading the invoice.
+  defaultFBShortfallResolution       FBShortfallResolution? @default(ChargeDelta)
+
+  /// Revenue-share split with the host.
+  revenueShareEnabled        Boolean @default(false)
+  /// 0..100 — the percentage of `revenueShareBasis` the HOST keeps. Venue
+  /// share is `100 - revenueShareHostPercentage`. Single source of truth.
+  revenueShareHostPercentage Int?
+  /// `"FB_SALES" | "TICKET_REVENUE" | "TOTAL_GROSS"` — what the % is taken on.
+  revenueShareBasis          String?
+  /// Free-form notes shown next to the rev-share split.
+  revenueShareNotes          String?
+
+  fbCarryoverCredits VenueFBCarryoverCredit[]
+  fbMinimumOverrides VenueFBMinimumOverride[]
+}
+
+/// Date-based override of the per-day-of-week F&B schedule. Use cases: NYE,
+/// Halloween, holiday weekends, special-event nights. Wizard surfaces these
+/// as a small calendar/list.
+model VenueFBMinimumOverride {
+  id           String   @id @default(cuid())
+  venueId      String
+  startDate    DateTime
+  endDate      DateTime
+  /// Override amount in cents. Replaces the schedule's day-of-week minimum
+  /// for any bash whose start falls inside `[startDate, endDate]`.
+  minimumCents Int
+  /// Optional human label ("NYE 2026").
+  note         String?
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+  venue        Venue    @relation(fields: [venueId], references: [id], onDelete: Cascade)
+
+  @@index([venueId])
+  @@index([venueId, startDate])
+}
+
+/// F&B credit a host accumulated either by exceeding the minimum at a prior
+/// bash OR by the venue choosing `CreditFutureBooking` on a shortfall. Applies
+/// as a discount on the next bash at the same venue. Default expiry: 12 months
+/// from `issuedAt` (per Phase 2 calibration).
+model VenueFBCarryoverCredit {
+  id                          String    @id @default(cuid())
+  venueId                     String
+  hostUserId                  String
+  /// Booking that generated the credit (excess spend, or shortfall converted
+  /// to a future credit).
+  originatingServiceBookingId String?
+  creditCents                 Int
+  issuedAt                    DateTime  @default(now())
+  /// Default: `issuedAt + 12 months`.
+  expiresAt                   DateTime?
+  consumedAt                  DateTime?
+  consumedByServiceBookingId  String?
+  venue                       Venue     @relation(fields: [venueId], references: [id], onDelete: Cascade)
+  host                        User      @relation("VenueFBCarryoverHost", fields: [hostUserId], references: [id], onDelete: Cascade)
+
+  @@index([venueId])
+  @@index([hostUserId])
+  @@index([hostUserId, venueId, expiresAt])
 }
 
-/// Guest-requested perk aligned with Venue.loyaltyTemplateIds; host marks redeemedAt when fulfilled.
-model VenueLoyaltyRedemption {
-  id         String    @id @default(cuid())
-  venueId    String
-  userId     String
-  templateId String
-  claimedAt  DateTime  @default(now())
-  redeemedAt DateTime?
-  guestNotes String?
-  hostNotes  String?
+/// Structured per-offer loyalty configuration for a venue. Replaces the flat
+/// Venue.loyaltyTemplateIds[] (which now lives on as legacy/deprecated config).
+/// Each row is one perk the venue offers: BashPoints price (optional), eligibility
+/// gates (optional), cooldown, and claim expiry.
+model VenueLoyaltyOffer {
+  id                        String   @id @default(cuid())
+  venueId                   String
+  /// One of VENUE_LOYALTY_TEMPLATE_IDS — used for default copy + categorization.
+  templateId                String
+  /// Title shown to guests on the public loyalty section. Defaults to template copy
+  /// when the venue creates an offer from a template.
+  title                     String
+  description               String?
+  /// Optional BashPoints price. Null = free request (legacy "polite-request" mode).
+  bashPointsCost            Int?
+  /// Optional guest-side gate. Counts distinct BashEvents at this venue where the
+  /// user has a non-refunded paid ticket.
+  minTicketedEventsAttended Int?
+  /// Optional host-side gate. Counts confirmed ServiceBookings where the user is
+  /// the booker and the service is this venue.
+  minBookingsAsHost         Int?
+  /// Days a guest must wait after redeeming/declining/expiring before claiming
+  /// the same offer again. 0 = no cooldown.
+  cooldownDays              Int      @default(0)
+  /// How many days a generated redemption code stays valid before auto-refund.
+  claimExpiryDays           Int      @default(30)
+  /// Soft-disable so codes-in-flight still resolve cleanly.
+  enabled                   Boolean  @default(true)
+  createdAt                 DateTime @default(now())
+  updatedAt                 DateTime @updatedAt
+
+  venue       Venue                    @relation(fields: [venueId], references: [id], onDelete: Cascade)
+  redemptions VenueLoyaltyRedemption[]
 
-  venue Venue @relation(fields: [venueId], references: [id], onDelete: Cascade)
-  user  User  @relation(fields: [userId], references: [id], onDelete: Cascade)
+  @@index([venueId, enabled])
+}
 
+/// Guest claim against a VenueLoyaltyOffer. BashPoints are escrowed at claim time
+/// (when bashPointsCost > 0), credited to the venue owner on redemption, or refunded
+/// to the guest on decline/expire. Every transition writes a BashCreditTransaction
+/// row tagged CreditSourceType.VenueLoyaltyRedemption.
+model VenueLoyaltyRedemption {
+  id                  String    @id @default(cuid())
+  venueId             String
+  /// Nullable so legacy rows (pre-offer migration) still resolve. New claims always set it.
+  offerId             String?
+  userId              String
+  /// Copy of offer.templateId at claim time (for legacy display compat).
+  templateId          String
+  /// BashPoints cost snapshotted at claim time so later offer edits don't shift accounting.
+  bashPointsCost      Int       @default(0)
+  /// 8-char alphanumeric code generated server-side; null on legacy rows.
+  redemptionCode      String?
+  /// claimedAt + offer.claimExpiryDays. Null on legacy rows.
+  expiresAt           DateTime?
+  claimedAt           DateTime  @default(now())
+  redeemedAt          DateTime?
+  declinedAt          DateTime?
+  expiredAt           DateTime?
+  /// "host_declined" | "expired" | other freeform reasons.
+  cancelReason        String?
+  guestNotes          String?
+  hostNotes           String?
+  /// { ticketedEventsAttended: number, bookingsAsHost: number } captured at claim time.
+  eligibilitySnapshot Json?
+
+  venue Venue              @relation(fields: [venueId], references: [id], onDelete: Cascade)
+  user  User               @relation(fields: [userId], references: [id], onDelete: Cascade)
+  offer VenueLoyaltyOffer? @relation(fields: [offerId], references: [id], onDelete: SetNull)
+
+  @@unique([venueId, redemptionCode])
   @@index([venueId])
   @@index([userId])
+  @@index([offerId])
   @@index([venueId, redeemedAt])
+  @@index([expiresAt])
 }
 
 model UserPromoCodeRedemption {
@@ -3608,6 +3785,7 @@ model Organization {
   stripeSubscriptionId        String?              @unique
   stripeCustomerId            String?
   stripeConnectedAccountId    String? // Org-level Stripe account for wallet display
+  accentColor                 String? // Hex color for org page branding (e.g. "#6366f1")
   inheritBrandingFromParent   Boolean              @default(true)
   latitude                    Float?
   longitude                   Float?
@@ -3627,10 +3805,27 @@ model Organization {
   seasons                     Season[]
   homeTeamGames               Game[]               @relation("HomeTeamGames")
   awayTeamGames               Game[]               @relation("AwayTeamGames")
+  products                    OrgProduct[]
+
+  /// Verified-nonprofit fields. Verification is a Bash-side admin action driven by
+  /// the host's uploaded determination letter (nonprofitDeterminationDocId). These
+  /// are the ONLY signals fee-math is allowed to read — `BashEvent.nonProfit` is
+  /// user-entered and MUST NOT drive money. Country-agnostic shape so the first
+  /// non-US charity doesn't require a re-model.
+  nonprofitCountry             String? // ISO-3166-1 alpha-2 (US, CA, GB, ...)
+  nonprofitRegistrationNumber  String? // EIN in US / charity number elsewhere; not unique because countries collide
+  nonprofitDeterminationDocId  String? // Media FK — uploaded 501(c)(3) determination letter or equivalent
+  nonprofitDeterminationDoc    Media?                       @relation("OrganizationNonprofitDeterminationDoc", fields: [nonprofitDeterminationDocId], references: [id], onDelete: SetNull)
+  nonprofitVerifiedAt          DateTime?
+  nonprofitVerifiedByUserId    String?
+  nonprofitVerifiedByUser      User?                        @relation("OrganizationNonprofitVerifier", fields: [nonprofitVerifiedByUserId], references: [id], onDelete: SetNull)
+  /// Recorded for analytics — informational only, NOT a gate for verification or fee waivers.
+  stripeNonprofitPricingStatus StripeNonprofitPricingStatus @default(NotApplied)
 
   @@index([ownerId])
   @@index([slug])
   @@index([parentOrganizationId])
+  @@index([nonprofitVerifiedAt])
 }
 
 /// Sports-specific metadata for league or team organizations (1:1 with Organization).
@@ -3648,6 +3843,26 @@ model SportsProfile {
   updatedAt      DateTime     @updatedAt
 }
 
+/// Merchandise or digital products sold by an organization on their public profile.
+model OrgProduct {
+  id             String           @id @default(cuid())
+  organizationId String
+  name           String
+  description    String?
+  priceCents     Int
+  imageUrl       String?
+  /// null = unlimited stock
+  inventory      Int?
+  status         OrgProductStatus @default(Active)
+  /// shipping | pickup | digital
+  fulfillment    String           @default("shipping")
+  createdAt      DateTime         @default(now())
+  updatedAt      DateTime         @updatedAt
+  organization   Organization     @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@index([organizationId])
+}
+
 /// A competition season owned by a league organization.
 model Season {
   id             String       @id @default(cuid())
@@ -3922,23 +4137,23 @@ model ServiceRange {
 }
 
 model ServiceAddon {
-  id                        String                   @id @default(cuid())
-  name                      String
-  description               String
-  priceCents                Int
-  quantity                  Int
+  id                             String                          @id @default(cuid())
+  name                           String
+  description                    String
+  priceCents                     Int
+  quantity                       Int
   /// Booking-time add-ons vs merchandise sold at events (same CRUD; UI filters by kind)
-  catalogKind               ServiceAddonCatalogKind  @default(BookingAddOn)
-  status                    ServiceAddonStatus       @default(Enabled)
-  imageUrl                  String? // Add-on image URL
-  imageAlt                  String? // Alt text for accessibility
-  servicePackageId          String?
-  serviceRatesAssociationId String?
-  servicePackage            ServicePackage?          @relation(fields: [servicePackageId], references: [id], onDelete: Cascade)
-  serviceRatesAssociation   ServiceRatesAssociation? @relation(fields: [serviceRatesAssociationId], references: [id], onDelete: Cascade)
-  ServiceBookingAddOn       ServiceBookingAddOn[]
-  convertedFromInclude      ServiceInclude[]         @relation("IncludeConvertedToAddon")
-  convertedFromRequest      ServiceAddonRequest[]    @relation("RequestConvertedToAddon")
+  catalogKind                    ServiceAddonCatalogKind         @default(BookingAddOn)
+  status                         ServiceAddonStatus              @default(Enabled)
+  imageUrl                       String? // Add-on image URL
+  imageAlt                       String? // Alt text for accessibility
+  servicePackageId               String?
+  serviceRatesAssociationId      String?
+  servicePackage                 ServicePackage?                 @relation(fields: [servicePackageId], references: [id], onDelete: Cascade)
+  serviceRatesAssociation        ServiceRatesAssociation?        @relation(fields: [serviceRatesAssociationId], references: [id], onDelete: Cascade)
+  ServiceBookingAddOn            ServiceBookingAddOn[]
+  convertedFromInclude           ServiceInclude[]                @relation("IncludeConvertedToAddon")
+  convertedFromRequest           ServiceAddonRequest[]           @relation("RequestConvertedToAddon")
   serviceMerchSquareFulfillments ServiceMerchSquareFulfillment[]
 
   @@index([imageUrl])
@@ -4182,48 +4397,116 @@ model ServiceBookingCheckout {
 }
 
 model ServiceBooking {
-  id                      String                         @id @default(cuid())
-  creatorId               String
-  forUserId               String
-  daysTotalATBCents       Int
-  serviceId               String
-  rateOption              ServiceBookingRateOption       @default(TimeBased)
-  flatRateCents           Int?
-  status                  ServiceBookingStatus           @default(Pending)
-  bookingType             ServiceBookingType             @default(Request)
-  timezone                String
-  requestedOn             DateTime?
-  requestDecisionOn       DateTime?
-  bookedOn                DateTime?
-  canceledOn              DateTime?
-  isFreeGuest             Boolean                        @default(false)
-  allowPromiseToPay       Boolean                        @default(false)
-  totalATBCents           Int
-  subtotalATBCents        Int                            @default(0)
-  bashEventId             String?
-  isVendorBid             Boolean                        @default(false)
-  vendorBidAmountCents    Int?
-  vendorEventDetails      String?
-  bashPointsApplied       Int? // BashPoints credits applied to this booking
-  bashPointsTransactionId String? // Link to BashCreditTransaction
+  id                                String                         @id @default(cuid())
+  creatorId                         String
+  forUserId                         String
+  daysTotalATBCents                 Int
+  serviceId                         String
+  rateOption                        ServiceBookingRateOption       @default(TimeBased)
+  flatRateCents                     Int?
+  status                            ServiceBookingStatus           @default(Pending)
+  bookingType                       ServiceBookingType             @default(Request)
+  timezone                          String
+  requestedOn                       DateTime?
+  requestDecisionOn                 DateTime?
+  bookedOn                          DateTime?
+  canceledOn                        DateTime?
+  isFreeGuest                       Boolean                        @default(false)
+  allowPromiseToPay                 Boolean                        @default(false)
+  totalATBCents                     Int
+  subtotalATBCents                  Int                            @default(0)
+  bashEventId                       String?
+  isVendorBid                       Boolean                        @default(false)
+  vendorBidAmountCents              Int?
+  vendorEventDetails                String?
+  bashPointsApplied                 Int? // BashPoints credits applied to this booking
+  bashPointsTransactionId           String? // Link to BashCreditTransaction
   // Settlement fields for percentage-based bookings (populated at event close)
-  settlementBasis         ServiceBookingSettlementBasis?
-  settlementPercentage    Decimal?
-  settlementAmountCents   Int?
-  settledAt               DateTime?
-  notification            Notification[]
-  bashEvent               BashEvent?                     @relation(fields: [bashEventId], references: [id])
-  creator                 User                           @relation("BookingCreator", fields: [creatorId], references: [id])
-  forUser                 User                           @relation("BookingForUser", fields: [forUserId], references: [id])
-  service                 Service                        @relation(fields: [serviceId], references: [id])
-  addOns                  ServiceBookingAddOn[]
-  checkout                ServiceBookingCheckout?
-  bookedDays              ServiceBookingDay[]
-  additionalFees          ServiceBookingFee[]
-  messages                ServiceBookingMessage[]
-  packages                ServiceBookingPackage[]
-  commissions             BookingCommission[]            @relation("BookingCommissions")
-  sentReminders           SentReminder[]
+  settlementBasis                   ServiceBookingSettlementBasis?
+  settlementPercentage              Decimal?
+  settlementAmountCents             Int?
+  settledAt                         DateTime?
+  // Event Promoter / `AttendeeCount` settlement fields (see eventPromoterUtils.ts).
+  // expectedAttendeesAtBooking is snapshotted from `bashEvent.expectedAttendees`
+  // at booking time so the post-event true-up has a stable baseline even if
+  // the host later edits the bash. `maxAttendeesAttributable` is the host-set
+  // per-booking ceiling on billable check-ins (multi-promoter risk control).
+  expectedAttendeesAtBooking        Int?
+  maxAttendeesAttributable          Int?
+  checkedInAttendeesAtSettle        Int?
+  settlementDeltaCents              Int?
+  deltaChargeStripePaymentIntentId  String?
+  deltaRefundStripeRefundId         String?
+  // Phase 0 adoption guardrails (see bash-common/src/utils/service/billingCapUtils.ts).
+  // `maxBillableCents` is the host-set per-booking dollar ceiling for any
+  // variable-pricing booking — defaults to 1.5x expectedAttendees * baseRateCents
+  // at booking time. Snapshotted so policy changes don't move history.
+  // `maxBillableBashPoints` is the parallel cap for PER_BASHPOINTS_ATTENDEE bookings.
+  // `payoutTimingNote` snapshots the provider-facing copy ("Final settlement ~3
+  // business days after the bash") so the booking detail keeps showing the
+  // right expectation even after platform defaults change.
+  maxBillableCents                  Int?
+  maxBillableBashPoints             Int?
+  payoutTimingNote                  String?
+  // Phase 3 — PER_PAID_ATTENDEE / PER_BASHPOINTS_ATTENDEE settlement snapshots.
+  /// Checked-in attendees with `isFreeGuest = false` and ticket tier
+  /// pricingType = USD. Populated at settlement time. PER_PAID_ATTENDEE.
+  paidAttendeesAtSettle             Int?
+  /// Checked-in attendees with `isFreeGuest = false` and ticket tier
+  /// pricingType = BASHPOINTS. Populated at settlement time.
+  /// PER_BASHPOINTS_ATTENDEE.
+  paidInBashPointsAttendeesAtSettle Int?
+  /// When true on a `PER_PAID_ATTENDEE` booking, BP-paid tickets ALSO count
+  /// toward the head count. Defaults to false (providers must explicitly opt
+  /// in to mixed-currency settlement).
+  countsBashPointsTickets           Boolean                        @default(false)
+  /// Snapshot of the per-attendee BashPoints rate. Mirrors `baseRateCents`
+  /// snapshot semantics for PER_BASHPOINTS_ATTENDEE.
+  baseRateBashPointsSnapshot        Int?
+  // Phase 2 — Venue F&B + revenue-share settlement snapshots. All fields are
+  // snapshots taken at booking confirmation time so policy changes don't move
+  // history.
+  /// Effective F&B minimum after applying day-of-week schedule + overrides.
+  fbMinimumCents                    Int?
+  /// Final F&B spend (cents) from the venue-uploaded invoice.
+  fbActualSpendCents                Int?
+  /// FK to the uploaded `Media` row (PDF/image of the F&B invoice).
+  fbInvoiceMediaId                  String?
+  fbInvoiceUploadedAt               DateTime?
+  /// Resolution applied at settlement (ChargeDelta | CreditFutureBooking | Forgiven).
+  fbShortfallResolution             FBShortfallResolution?
+  /// Snapshot of `Venue.fbServiceChargeCountsTowardMinimum`.
+  fbServiceChargeIncludedSnapshot   Boolean?
+  /// Snapshot of `Venue.fbMinimumIncludesTax`.
+  fbMinimumIncludesTaxSnapshot      Boolean?
+  /// Snapshot of `Venue.revenueShareHostPercentage` (0..100).
+  revenueShareHostPctSnapshot       Int?
+  /// Snapshot of `Venue.revenueShareBasis`.
+  revenueShareBasisSnapshot         String?
+  /// Computed venue rev-share owed (cents) at settlement.
+  revenueShareCalculatedCents       Int?
+  // Settlement lifecycle state (drives dunning, retries, dispute window).
+  settlementStatus                  ServiceBookingSettlementStatus @default(Pending)
+  settlementAttempts                Int                            @default(0)
+  lastSettlementAttemptAt           DateTime?
+  // When the host clicks "Dispute" during the window, we pause auto-settle.
+  settlementDisputedAt              DateTime?
+  // When the delta refund actually lands at the issuing bank.
+  refundedOn                        DateTime?
+  notification                      Notification[]
+  bashEvent                         BashEvent?                     @relation(fields: [bashEventId], references: [id])
+  creator                           User                           @relation("BookingCreator", fields: [creatorId], references: [id])
+  forUser                           User                           @relation("BookingForUser", fields: [forUserId], references: [id])
+  service                           Service                        @relation(fields: [serviceId], references: [id])
+  addOns                            ServiceBookingAddOn[]
+  checkout                          ServiceBookingCheckout?
+  bookedDays                        ServiceBookingDay[]
+  additionalFees                    ServiceBookingFee[]
+  messages                          ServiceBookingMessage[]
+  packages                          ServiceBookingPackage[]
+  commissions                       BookingCommission[]            @relation("BookingCommissions")
+  sentReminders                     SentReminder[]
+  offers                            ServiceBookingOffer[]
 
   @@index([status])
   @@index([creatorId])
@@ -4264,6 +4547,10 @@ model VendorBookingRequest {
   permitRequirements     String
   weatherContingency     String
   cancellationPolicy     String
+  /// Phase 4 — pricing models this host will accept bids in. Empty array =
+  /// no host-side restriction (provider may bid in any of their supported
+  /// models). Validated in `bash-common/src/utils/service/offerAllowListUtils.ts`.
+  pricingModelAllowList  String[]                @default([])
   status                 VendorBookingStatus     @default(PENDING)
   paymentAmount          Float?
   paymentStatus          String?
@@ -4276,6 +4563,7 @@ model VendorBookingRequest {
   bashEvent              BashEvent?              @relation("VendorBookingEvent", fields: [bashEventId], references: [id])
   hostUser               User                    @relation("VendorBookingHost", fields: [hostUserId], references: [id], onDelete: Cascade)
   vendorService          Service                 @relation("VendorBookingService", fields: [vendorServiceId], references: [id], onDelete: Cascade)
+  offers                 ServiceBookingOffer[]
 
   @@index([hostUserId])
   @@index([vendorServiceId])
@@ -4367,6 +4655,8 @@ model ExhibitorBookingRequest {
   leadGenerationExpected Boolean                 @default(false)
   materialDistribution   String
   demonstrationNeeds     String
+  /// Phase 4 — see VendorBookingRequest.pricingModelAllowList.
+  pricingModelAllowList  String[]                @default([])
   status                 ExhibitorBookingStatus  @default(PENDING)
   paymentAmount          Float?
   paymentStatus          String?
@@ -4416,6 +4706,8 @@ model SponsorBookingRequest {
   cancellationPolicy      String
   mentionRequirements     String
   socialMediaRequirements String
+  /// Phase 4 — see VendorBookingRequest.pricingModelAllowList.
+  pricingModelAllowList   String[]                @default([])
   status                  SponsorBookingStatus    @default(PENDING)
   paymentAmount           Float?
   paymentStatus           String?
@@ -4461,23 +4753,23 @@ model ServiceLink {
 }
 
 model UserReport {
-  id          String       @id @default(cuid())
+  id          String               @id @default(cuid())
   reporterId  String
   reportedId  String
   bashEventId String?
   reason      String
   details     String
-  createdAt   DateTime     @default(now())
-  status      ReportStatus @default(Pending)
+  createdAt   DateTime             @default(now())
+  status      ReportStatus         @default(Pending)
   reviewerId  String?
   reviewedAt  DateTime?
   reviewNotes String?
   demerits    Demerit[]
   evidence    UserReportEvidence[]
-  bashEvent   BashEvent?   @relation(fields: [bashEventId], references: [id])
-  reported    User         @relation("ReportsReceived", fields: [reportedId], references: [id], onDelete: Cascade)
-  reporter    User         @relation("ReportsMade", fields: [reporterId], references: [id], onDelete: Cascade)
-  reviewer    User?        @relation("ReportsReviewed", fields: [reviewerId], references: [id])
+  bashEvent   BashEvent?           @relation(fields: [bashEventId], references: [id])
+  reported    User                 @relation("ReportsReceived", fields: [reportedId], references: [id], onDelete: Cascade)
+  reporter    User                 @relation("ReportsMade", fields: [reporterId], references: [id], onDelete: Cascade)
+  reviewer    User?                @relation("ReportsReviewed", fields: [reviewerId], references: [id])
 
   @@index([reporterId])
   @@index([reportedId])
@@ -4823,6 +5115,7 @@ enum NotificationType {
   ServiceBookingDeclined
   ServiceBookingCancelled
   ServiceBookingConfirmed
+  ServiceOfferReceived
   Message
   ConnectionRequest
   ConnectionAccepted
@@ -5193,14 +5486,6 @@ enum SchoolNameSource {
   UserConfirmed
 }
 
-/// Admin-gated custom-scope pricing flag for service providers needing variable/quote-based pricing
-enum CustomScopeStatus {
-  None
-  Pending
-  Approved
-  Rejected
-}
-
 /// AI bash-approval reviewer verdict (see `bashApprovalAiService`).
 /// `Approve` and `Reject` are recommendations; whether the system acts on them
 /// vs. queues for a human depends on confidence + AI_BASH_APPROVAL_MODE.
@@ -5268,6 +5553,21 @@ enum VolunteerServiceStatus {
   Created
 }
 
+/// How a host thanks a volunteer for their time on a bash. Intentionally
+/// narrower than `PricingModel` — volunteers are not employees or contractors,
+/// so USD wages / per-attendee / revenue share are out of scope by design.
+enum VolunteerCompensationType {
+  /// Pure volunteer — appreciation only, no stipend or perks recorded.
+  None
+  /// Closed-loop BashPoints stipend per shift or per hour. BP redeems on
+  /// Bash; never cashed out, never a wage.
+  BashPointsStipend
+  /// Comped ticket + on-site perks (food, drink wristband, swag). No BP.
+  PerksOnly
+  /// Both a BashPoints stipend AND on-site perks.
+  BashPointsAndPerks
+}
+
 enum Gender {
   Male
   Female
@@ -6680,6 +6980,105 @@ enum ServiceBookingRateOption {
 enum ServiceBookingSettlementBasis {
   TicketRevenue // Venue takes % of ticket sales (Bash auto-calculates from held revenue)
   ProductSales // Host takes % of vendor product sales through Bash checkout
+  AttendeeCount // Event Promoter: host pays per checked-in attendee with deposit + delta true-up
+  FBMinimumShortfall // Venue F&B minimum (Phase 2) — host owes the gap between actualFbSpend and the minimum
+  RevenueShare // Venue revenue-share + optional minimum floor (Phase 2)
+}
+
+/// How an F&B minimum shortfall on a venue booking was resolved at settlement.
+/// Default venue policy lives at `Venue.defaultFBShortfallResolution`; the
+/// venue can override on the invoice-upload step.
+enum FBShortfallResolution {
+  /// Host's card is charged the shortfall delta via the existing
+  /// `ServiceBookingSettlementStatus` flow.
+  ChargeDelta
+  /// Venue chooses to bank the shortfall as a `VenueFBCarryoverCredit` against
+  /// the host's next bash at the same venue.
+  CreditFutureBooking
+  /// Venue waives the shortfall — no charge, no credit.
+  Forgiven
+}
+
+/// Lifecycle state for `AttendeeCount` settlement (Event Promoter bookings).
+/// Drives Stripe webhook handlers, dunning, dispute window, retry logic.
+enum ServiceBookingSettlementStatus {
+  Pending // Bash not yet ended, or within dispute window
+  Settled // Charged or refunded successfully; `settledAt` populated
+  SettlementPaymentFailed // Off-session delta charge failed after Stripe Smart Retries
+  SettlementHeld // Awaiting host action (dispute, no check-in data, promoter Connect issue)
+  SettlementDisputed // Host clicked "Dispute" during the dispute window
+}
+
+/// Direction of a booking offer — derived from service type, not chosen by the user.
+/// Vendors/Exhibitors/Sponsors use ProviderToHost; all other service types use HostToProvider.
+enum ServiceBookingOfferDirection {
+  HostToProvider
+  ProviderToHost
+}
+
+enum ServiceBookingOfferStatus {
+  Pending
+  Accepted
+  Declined
+  Countered // superseded by a child counter offer
+  Expired
+}
+
+/// Structured negotiation offer attached to a service + bash event.
+/// Max 3 rounds per thread (1 initial + 1 counter per side).
+model ServiceBookingOffer {
+  id        String   @id @default(cuid())
+  createdAt DateTime @default(now())
+
+  serviceId              String
+  bashEventId            String
+  serviceBookingId       String? // set once attached to a Pending booking or after accept
+  vendorBookingRequestId String? // for Vendor/Exhibitor/Sponsor flow
+
+  parentOfferId String? // the offer this is countering
+  roundNumber   Int // 1, 2, or 3 — server-enforced cap of 3
+
+  senderId    String
+  recipientId String
+  direction   ServiceBookingOfferDirection
+  amountCents Int
+  note        String?
+
+  // Phase 5 — offers carry the pricing model so negotiation can cross models.
+  // `amountCents` is kept as the denormalized **expected total** for legacy
+  // sorting/AI; the fields below capture the full per-unit pricing block so
+  // the recipient can counter on any axis.
+  pricingModel       PricingModel?
+  baseRateCents      Int?
+  baseRateBashPoints Int?
+  rateUnit           String?
+  minimumChargeCents Int?
+  minimumQuantity    Int?
+  maxBillableCents   Int?
+
+  aiSuggestedLowCents  Int?
+  aiSuggestedMidCents  Int?
+  aiSuggestedHighCents Int?
+  aiReasoning          String?
+  acceptedAiSuggestion Boolean @default(false)
+
+  status    ServiceBookingOfferStatus @default(Pending)
+  decidedAt DateTime?
+  expiresAt DateTime?
+
+  service              Service               @relation(fields: [serviceId], references: [id], onDelete: Cascade)
+  bashEvent            BashEvent             @relation(fields: [bashEventId], references: [id], onDelete: Cascade)
+  serviceBooking       ServiceBooking?       @relation(fields: [serviceBookingId], references: [id], onDelete: SetNull)
+  vendorBookingRequest VendorBookingRequest? @relation(fields: [vendorBookingRequestId], references: [id], onDelete: SetNull)
+  parentOffer          ServiceBookingOffer?  @relation("OfferCounters", fields: [parentOfferId], references: [id], onDelete: SetNull)
+  counters             ServiceBookingOffer[] @relation("OfferCounters")
+  sender               User                  @relation("OfferSender", fields: [senderId], references: [id])
+  recipient            User                  @relation("OfferRecipient", fields: [recipientId], references: [id])
+
+  @@index([serviceId, bashEventId])
+  @@index([serviceBookingId])
+  @@index([recipientId, status])
+  @@index([senderId])
 }
 
 enum VendorBookingStatus {
@@ -6781,7 +7180,9 @@ enum PaymentProvider {
 
 enum PricingModel {
   FLAT_FEE // Fixed amount: "$500 for vendor booth"
-  PER_ATTENDEE // Per person: "$50 per expected attendee"
+  PER_ATTENDEE // Per person: "$50 per expected attendee" — counts every checked-in attendee
+  PER_PAID_ATTENDEE // Like PER_ATTENDEE but only revenue-generating tickets count (no comps)
+  PER_BASHPOINTS_ATTENDEE // Per attendee who paid in BashPoints (host wallet or BP pool)
   HOURLY // Per hour: "$200/hour, 4-hour minimum"
   PER_DAY // Per day: "$1,000/day"
   TIERED // Multiple options: "Bronze $1K, Silver $2.5K, Gold $5K"
@@ -6790,6 +7191,20 @@ enum PricingModel {
   PRODUCT_SALES_PERCENTAGE // Host takes a % of vendor/exhibitor product sales through Bash checkout
 }
 
+/**
+ * Where the BashPoints for a PER_BASHPOINTS_ATTENDEE settlement come from.
+ * - `HostWallet` (default): host's BP balance pays the provider directly.
+ * - `BashBpPool`: BP collected from BashPoints-priced ticket sales for this
+ * bash form a per-bash pool; the provider is paid from that pool first.
+ * Refund of a BP ticket after settlement debits the host's wallet so Bash
+ * never goes negative.
+ * See `eventPromoterUtils` / Phase 3 of the unified-pricing roadmap.
+ */
+enum BashPointsPayoutSource {
+  HostWallet
+  BashBpPool
+}
+
 enum PricingType {
   USD // Ticket priced in USD (paid with credit card, earns BashPoints cashback)
   BASHPOINTS // Ticket priced in BashPoints (peer-to-peer loyalty points transfer)
@@ -6900,12 +7315,7 @@ enum CreditSourceType {
   PostBeforeEvent // First BashFeed post linked to event before it ends
   PostAfterEvent // First BashFeed post linked to event after it ends
   ReferralCodeUsed // Flat bonus for referrer when code drives a ticket/signup
-}
-
-enum PendingGiftStatus {
-  Pending
-  Claimed
-  Returned
+  VenueLoyaltyRedemption // BashPoints moved through a VenueLoyaltyRedemption claim/redeem/refund
 }
 
 enum ReferralTier {
@@ -8423,3 +8833,17 @@ enum VanityPathStatus {
   Active
   Revoked
 }
+
+enum OrgProductStatus {
+  Active
+  Archived
+}
+
+/// Lifecycle of a host's external Stripe nonprofit-pricing application. Recorded
+/// for analytics; does NOT gate Bash-side verification or platform-fee waivers.
+enum StripeNonprofitPricingStatus {
+  NotApplied
+  Pending
+  Approved
+  Declined
+}