rubis/apps/api/database/schema.ts
ordinarthur b0e6f83655
All checks were successful
Build & Deploy Landing / build-and-deploy (push) Successful in 1m19s
Build & Deploy API / build-and-deploy (push) Successful in 1m44s
Build & Deploy Web / build-and-deploy (push) Successful in 41s
feat(billing): essai 14 j Pro avec CB à l'inscription (Stripe trial_period_days)
Implémente le chantier #6 de docs/tech/landing-optimisations.md. Le
funnel signup propose maintenant un essai 14 j Pro avec carte demandée
mais non prélevée — prélèvement automatique à J+14 avec rappel à J+11
(webhook customer.subscription.trial_will_end de Stripe).

Couverture tests : 60 tests unitaires sur la couche billing
  - billing.spec.ts          (25) — quota Free, bypass trial, inTrial state
  - stripe_billing.spec.ts   (24) — handlers webhook, idempotence, dispatcher
  - trial_recap_job.spec.ts  (11) — stats aggregation, formatRubisToHoursFr
+ 3 nouveaux tests vitest côté SPA (useTrialDaysRemaining,
useIsAtFreeLimit bypass trial).

Backend :
  - Migration 1779000000000_add_trial_ends_at_to_organizations
  - PLAN_CAPS bypass quand status=trialing AND trial_ends_at futur
  - getOrgSubscriptionState expose inTrial + trialEndsAt
  - Refactor handlers webhook en service stripe_billing.ts (pures,
    testables) — extraction depuis le controller. dispatchWebhookEvent
    routeur typé également extrait pour les tests.
  - createTrialCheckoutSession avec subscription_data.trial_period_days=14,
    garde-fou TrialAlreadyConsumedError contre re-trial.
  - handleTrialWillEnd → enqueue job recap (BullMQ jobId déterministe
    basé sur subscriptionId, idempotent contre re-delivery Stripe).
  - Endpoint POST /api/v1/billing/start-trial.
  - Email template trial_recap (React Email, branding Rubis figé) avec
    stats: factures importées, relances envoyées, € récupérés, rubis +
    heures libérées.

Infra de test :
  - tests/helpers/stripe_mock.ts : __setStripeForTests injection +
    factories fakeSubscription / fakeCheckoutSession / fakeInvoice.
  - __setTrialRecapEnqueueForTests : permet de spy l'enqueue sans Redis.

Frontend :
  - /onboarding/billing.tsx (opt-in, pas encore forcé dans le flow) :
    bouton primaire essai 14j + fallback "Free 2 factures".
  - PlanLimitBanner : nouveau état "Essai Pro · X jours restants" qui
    prime sur les autres bandeaux. Discret rubis-glow, non blocant.
  - useStartTrial hook + useTrialDaysRemaining (arrondi sup).
  - SubscriptionState typé avec inTrial + trialEndsAt.

Landing :
  - Sous-texte CTA réactivé : « CB demandée, non prélevée avant J+14 »
    (Hero + FinalCTA), maintenant promesse véridique.

Notes ouvertes (à décider ultérieurement) :
  - Tunnel /onboarding/billing FORCÉ entre signup et /onboarding/compte :
    guard reste à activer (risque cassage du signup actuel sinon).
    Pour l'instant l'écran est accessible mais opt-in.
  - Cron de redondance trial-recap : pas encore implémenté (le
    jobId déterministe BullMQ couvre déjà la double-livraison Stripe).
    À ajouter si on observe des trial sans recap en prod.
  - Tests E2E avec Stripe test mode à faire avant le go-live (cartes
    3DS 4000 0027 6000 3184, declined 4000 0000 0000 0341).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-18 12:04:41 +02:00

567 lines
18 KiB
TypeScript

/**
* This file is automatically generated
* DO NOT EDIT manually
* Run "node ace migration:run" command to re-generate this file
*/
import { BaseModel, column } from '@adonisjs/lucid/orm'
import { DateTime } from 'luxon'
export class ActivityEventSchema extends BaseModel {
static $columns = ['at', 'createdAt', 'id', 'kind', 'label', 'meta', 'organizationId', 'updatedAt'] as const
$columns = ActivityEventSchema.$columns
@column.dateTime()
declare at: DateTime
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare kind: 'relance_sent' | 'invoice_paid' | 'invoice_imported' | 'warning_drafted'
@column()
declare label: string
@column()
declare meta: { invoiceId?: string; clientId?: string; planStepOrder?: number; [k: string]: unknown }
@column()
declare organizationId: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class AuthAccessTokenSchema extends BaseModel {
static $columns = ['abilities', 'createdAt', 'expiresAt', 'hash', 'id', 'lastUsedAt', 'name', 'tokenableId', 'type', 'updatedAt'] as const
$columns = AuthAccessTokenSchema.$columns
@column()
declare abilities: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime | null
@column.dateTime()
declare expiresAt: DateTime | null
@column()
declare hash: string
@column({ isPrimary: true })
declare id: string
@column.dateTime()
declare lastUsedAt: DateTime | null
@column()
declare name: string | null
@column()
declare tokenableId: string
@column()
declare type: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class BankAccountSchema extends BaseModel {
static $columns = ['balanceCents', 'bankConnectionId', 'createdAt', 'currency', 'iban', 'id', 'name', 'powensAccountId', 'type', 'updatedAt'] as const
$columns = BankAccountSchema.$columns
@column()
declare balanceCents: number | null
@column()
declare bankConnectionId: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare currency: string
@column()
declare iban: string | null
@column({ isPrimary: true })
declare id: string
@column()
declare name: string
@column()
declare powensAccountId: bigint | number
@column()
declare type: string | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class BankConnectionSchema extends BaseModel {
static $columns = ['bankLogoUrl', 'bankName', 'createdAt', 'id', 'lastError', 'lastSyncAt', 'organizationId', 'powensConnectionId', 'state', 'updatedAt'] as const
$columns = BankConnectionSchema.$columns
@column()
declare bankLogoUrl: string | null
@column()
declare bankName: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare lastError: string | null
@column.dateTime()
declare lastSyncAt: DateTime | null
@column()
declare organizationId: string
@column()
declare powensConnectionId: bigint | number
@column()
declare state: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class BankTransactionSchema extends BaseModel {
static $columns = ['amountCents', 'bankAccountId', 'bookedAt', 'createdAt', 'id', 'label', 'matchStatus', 'matchedInvoiceId', 'powensId', 'raw', 'valueDate', 'wording'] as const
$columns = BankTransactionSchema.$columns
@column()
declare amountCents: number
@column()
declare bankAccountId: string
@column.dateTime()
declare bookedAt: DateTime | null
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare label: string
@column()
declare matchStatus: string
@column()
declare matchedInvoiceId: string | null
@column()
declare powensId: bigint | number
@column()
declare raw: any
@column.date()
declare valueDate: DateTime
@column()
declare wording: string | null
}
export class CheckinTaskSchema extends BaseModel {
static $columns = ['answer', 'answeredAt', 'createdAt', 'id', 'invoiceId', 'organizationId', 'sendAt', 'sentAt', 'status', 'tokenHash', 'updatedAt'] as const
$columns = CheckinTaskSchema.$columns
@column()
declare answer: 'paid' | 'still_pending' | null | null
@column.dateTime()
declare answeredAt: DateTime | null
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare invoiceId: string
@column()
declare organizationId: string
@column.dateTime()
declare sendAt: DateTime
@column.dateTime()
declare sentAt: DateTime | null
@column()
declare status: 'scheduled' | 'sent' | 'answered' | 'expired'
@column()
declare tokenHash: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class ClientSchema extends BaseModel {
static $columns = ['address', 'addressCity', 'addressCountry', 'addressLine1', 'addressLine2', 'addressZip', 'contactFirstName', 'contactLastName', 'createdAt', 'email', 'id', 'name', 'notes', 'organizationId', 'phone', 'siren', 'siret', 'tvaIntra', 'updatedAt'] as const
$columns = ClientSchema.$columns
@column()
declare address: string | null
@column()
declare addressCity: string | null
@column()
declare addressCountry: string | null
@column()
declare addressLine1: string | null
@column()
declare addressLine2: string | null
@column()
declare addressZip: string | null
@column()
declare contactFirstName: string | null
@column()
declare contactLastName: string | null
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare email: string
@column({ isPrimary: true })
declare id: string
@column()
declare name: string
@column()
declare notes: string | null
@column()
declare organizationId: string
@column()
declare phone: string | null
@column()
declare siren: string | null
@column()
declare siret: string | null
@column()
declare tvaIntra: string | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class DemoCapturedEmailSchema extends BaseModel {
static $columns = ['body', 'createdAt', 'fromEmail', 'fromName', 'id', 'kind', 'meta', 'organizationId', 'replyTo', 'sentAt', 'subject', 'toEmail', 'toName', 'updatedAt'] as const
$columns = DemoCapturedEmailSchema.$columns
@column()
declare body: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare fromEmail: string
@column()
declare fromName: string | null
@column({ isPrimary: true })
declare id: string
@column()
declare kind: string
@column()
declare meta: any
@column()
declare organizationId: string
@column()
declare replyTo: string | null
@column.dateTime()
declare sentAt: DateTime
@column()
declare subject: string
@column()
declare toEmail: string
@column()
declare toName: string | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class ImportBatchSchema extends BaseModel {
static $columns = ['createdAt', 'id', 'organizationId', 'updatedAt'] as const
$columns = ImportBatchSchema.$columns
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare organizationId: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class ImportDraftSchema extends BaseModel {
static $columns = ['batchId', 'confidence', 'createdAt', 'edited', 'extracted', 'filename', 'id', 'invoiceId', 'pdfStorageKey', 'status', 'updatedAt'] as const
$columns = ImportDraftSchema.$columns
@column()
declare batchId: string
@column()
declare confidence: Partial<{ clientId: number; clientName: number; clientEmail: number; numero: number; amountTtcCents: number; issueDate: number; dueDate: number; planId: number }>
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare edited: { clientId: string | null; clientName: string; clientEmail: string | null; numero: string; amountTtcCents: number; issueDate: string; dueDate: string; planId: string | null }
@column()
declare extracted: { clientId: string | null; clientName: string; clientEmail: string | null; numero: string; amountTtcCents: number; issueDate: string; dueDate: string; planId: string | null }
@column()
declare filename: string
@column({ isPrimary: true })
declare id: string
@column()
declare invoiceId: string | null
@column()
declare pdfStorageKey: string | null
@column()
declare status: 'pending' | 'validated' | 'skipped'
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class InvoiceSchema extends BaseModel {
static $columns = ['amountHtCents', 'amountTtcCents', 'amountTvaCents', 'clientId', 'clientSnapshot', 'createdAt', 'dueDate', 'footerNotes', 'id', 'isNative', 'issueDate', 'issuerSnapshot', 'lines', 'notes', 'numero', 'organizationId', 'paidAt', 'paymentTermsDays', 'pdfGeneratedAt', 'pdfStorageKey', 'planId', 'rubisEarned', 'sequenceNumber', 'status', 'themeAccentColor', 'themeSlug', 'tvaBreakdown', 'updatedAt'] as const
$columns = InvoiceSchema.$columns
@column()
declare amountHtCents: number | null
@column()
declare amountTtcCents: number
@column()
declare amountTvaCents: number | null
@column()
declare clientId: string
@column()
declare clientSnapshot: any | null
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column.dateTime()
declare dueDate: DateTime
@column()
declare footerNotes: string | null
@column({ isPrimary: true })
declare id: string
@column()
declare isNative: boolean
@column.dateTime()
declare issueDate: DateTime
@column()
declare issuerSnapshot: any | null
@column()
declare lines: any | null
@column()
declare notes: string | null
@column()
declare numero: string
@column()
declare organizationId: string
@column.dateTime()
declare paidAt: DateTime | null
@column()
declare paymentTermsDays: number | null
@column.dateTime()
declare pdfGeneratedAt: DateTime | null
@column()
declare pdfStorageKey: string | null
@column()
declare planId: string | null
@column()
declare rubisEarned: number
@column()
declare sequenceNumber: number | null
@column()
declare status: 'pending' | 'awaiting_user_confirmation' | 'in_relance' | 'paid' | 'litigation' | 'cancelled'
@column()
declare themeAccentColor: string | null
@column()
declare themeSlug: string | null
@column()
declare tvaBreakdown: any | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class OrganizationSchema extends BaseModel {
static $columns = ['billingCycle', 'brandSettings', 'cancelAtPeriodEnd', 'createdAt', 'currentPeriodEnd', 'demoMode', 'demoSpeedFactor', 'gracePeriodEndsAt', 'id', 'invoiceSettings', 'monthlyVolumeBucket', 'name', 'onboardingCompletedAt', 'plan', 'powensTokenEncrypted', 'powensUserId', 'reconciliationMode', 'rubisCount', 'siret', 'stripeCustomerId', 'stripeSubscriptionId', 'subscriptionStatus', 'trialEndsAt', 'updatedAt', 'virtualNow'] as const
$columns = OrganizationSchema.$columns
@column()
declare billingCycle: string | null
@column()
declare brandSettings: { logoPath?: string | null; logoUrl?: string | null; senderName?: string | null; primaryColor?: string | null; bannerColor?: string | null; bodyBgColor?: string | null; cardBgColor?: string | null; textColor?: string | null; textMutedColor?: string | null; borderColor?: string | null; linkColor?: string | null; buttonTextColor?: string | null } | null | null
@column()
declare cancelAtPeriodEnd: boolean
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column.dateTime()
declare currentPeriodEnd: DateTime | null
@column()
declare demoMode: boolean
@column()
declare demoSpeedFactor: number
@column.dateTime()
declare gracePeriodEndsAt: DateTime | null
@column({ isPrimary: true })
declare id: string
@column()
declare invoiceSettings: any | null
@column()
declare monthlyVolumeBucket: string | null
@column()
declare name: string
@column.dateTime()
declare onboardingCompletedAt: DateTime | null
@column()
declare plan: string
@column()
declare powensTokenEncrypted: string | null
@column()
declare powensUserId: bigint | number | null
@column()
declare reconciliationMode: string
@column()
declare rubisCount: number
@column()
declare siret: string | null
@column()
declare stripeCustomerId: string | null
@column()
declare stripeSubscriptionId: string | null
@column()
declare subscriptionStatus: string | null
@column.dateTime()
declare trialEndsAt: DateTime | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
@column.dateTime()
declare virtualNow: DateTime | null
}
export class PlanStepSchema extends BaseModel {
static $columns = ['body', 'createdAt', 'id', 'offsetDays', 'order', 'planId', 'requiresManualValidation', 'subject', 'tone', 'updatedAt'] as const
$columns = PlanStepSchema.$columns
@column()
declare body: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare offsetDays: number
@column()
declare order: number
@column()
declare planId: string
@column()
declare requiresManualValidation: boolean
@column()
declare subject: string
@column()
declare tone: 'amical' | 'courtois' | 'ferme' | 'mise_en_demeure'
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class PlanSchema extends BaseModel {
static $columns = ['createdAt', 'description', 'id', 'isDefault', 'name', 'organizationId', 'slug', 'thanksBody', 'thanksSubject', 'updatedAt'] as const
$columns = PlanSchema.$columns
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare description: string
@column({ isPrimary: true })
declare id: string
@column()
declare isDefault: boolean
@column()
declare name: string
@column()
declare organizationId: string
@column()
declare slug: string | null
@column()
declare thanksBody: string | null
@column()
declare thanksSubject: string | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class PostSchema extends BaseModel {
static $columns = ['aiGenerated', 'aiTopicId', 'authorName', 'canonicalUrl', 'contentHtml', 'contentMd', 'createdAt', 'excerpt', 'heroImageAlt', 'heroImageUrl', 'id', 'noindex', 'ogImageUrl', 'publishedAt', 'readingTimeMinutes', 'slug', 'status', 'tags', 'title', 'updatedAt', 'wordCount'] as const
$columns = PostSchema.$columns
@column()
declare aiGenerated: boolean
@column()
declare aiTopicId: string | null
@column()
declare authorName: string
@column()
declare canonicalUrl: string | null
@column()
declare contentHtml: string
@column()
declare contentMd: string
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare excerpt: string
@column()
declare heroImageAlt: string | null
@column()
declare heroImageUrl: string | null
@column({ isPrimary: true })
declare id: string
@column()
declare noindex: boolean
@column()
declare ogImageUrl: string | null
@column.dateTime()
declare publishedAt: DateTime | null
@column()
declare readingTimeMinutes: number
@column()
declare slug: string
@column()
declare status: any
@column()
declare tags: any
@column()
declare title: string
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
@column()
declare wordCount: number
}
export class RefreshTokenSchema extends BaseModel {
static $columns = ['createdAt', 'expiresAt', 'hashedToken', 'id', 'ipAddress', 'lastUsedAt', 'revokedAt', 'updatedAt', 'userAgent', 'userId'] as const
$columns = RefreshTokenSchema.$columns
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column.dateTime()
declare expiresAt: DateTime
@column()
declare hashedToken: string
@column({ isPrimary: true })
declare id: string
@column()
declare ipAddress: string | null
@column.dateTime()
declare lastUsedAt: DateTime | null
@column.dateTime()
declare revokedAt: DateTime | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
@column()
declare userAgent: string | null
@column()
declare userId: string
}
export class RelanceTaskSchema extends BaseModel {
static $columns = ['createdAt', 'id', 'invoiceId', 'organizationId', 'planStepId', 'queueJobId', 'sendAt', 'sentAt', 'status', 'updatedAt'] as const
$columns = RelanceTaskSchema.$columns
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column({ isPrimary: true })
declare id: string
@column()
declare invoiceId: string
@column()
declare organizationId: string
@column()
declare planStepId: string
@column()
declare queueJobId: string | null
@column.dateTime()
declare sendAt: DateTime
@column.dateTime()
declare sentAt: DateTime | null
@column()
declare status: 'scheduled' | 'sent' | 'cancelled' | 'failed'
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}
export class UserSchema extends BaseModel {
static $columns = ['createdAt', 'email', 'fullName', 'googleId', 'id', 'isAdmin', 'microsoftId', 'organizationId', 'password', 'signature', 'updatedAt'] as const
$columns = UserSchema.$columns
@column.dateTime({ autoCreate: true })
declare createdAt: DateTime
@column()
declare email: string
@column()
declare fullName: string | null
@column()
declare googleId: string | null
@column({ isPrimary: true })
declare id: string
@column()
declare isAdmin: boolean
@column()
declare microsoftId: string | null
@column()
declare organizationId: string | null
@column({ serializeAs: null })
declare password: string | null
@column()
declare signature: string | null
@column.dateTime({ autoCreate: true, autoUpdate: true })
declare updatedAt: DateTime | null
}