Add post-subscription onboarding activation

.cursor/rules/tests-dusk.mdc

@@ -1,43 +1,51 @@
 ---
-description: Laravel Dusk browser tests — named routes, dusk selectors, no CSS/text-based assertions
+description: Browser tests (Pest + Playwright) — named routes, data-testid selectors, no CSS/text-based assertions
 globs: tests/Browser/**/*.php
 alwaysApply: false
 ---
 
-# Dusk Browser Tests
+# Browser Tests
 
 ## Named routes (IMPORTANT)
 
 ALWAYS use named routes via the `route()` helper. NEVER hardcode URLs like `'https://trypost.test/login'`.
 
 ```php
 // BAD
-$browser->visit('https://trypost.test/login');
+visit('https://trypost.test/login');
 
 // GOOD
-$browser->visit(route('login'));
+visit(route('login'));
 ```
 
-## Dusk selectors
+## Selectors (IMPORTANT)
 
-ALWAYS use `dusk` selectors (`@selector-name`) for interactions and assertions. NEVER use CSS classes (`.text-red-600`), tag names, or text strings.
+ALWAYS use `data-testid` attributes and target them with `@selector-name`. NEVER use CSS classes (`.text-red-600`), tag names, or text strings.
 
-Add `dusk="my-element"` attributes to Vue components and target them with `$browser->click('@my-element')`, `$browser->waitFor('@my-element')`, etc.
+The Pest browser plugin resolves `@selector` against `[data-testid]` / `[data-test]` only — `dusk="..."` attributes are NOT matched (legacy from Laravel Dusk).
+
+Add `data-testid="my-element"` attributes to Vue components and target them with `$page->click('@my-element')`, `$page->assertVisible('@my-element')`, etc.
 
 ```php
 // BAD
-$browser->waitFor('.text-red-600');
-$browser->click('button.primary');
-$browser->assertSee('Welcome');
+$page->assertVisible('.text-red-600');
+$page->click('button.primary');
 
 // GOOD
-$browser->waitFor('@input-error');
-$browser->click('@submit-button');
-$browser->assertVisible('@welcome-message');
+$page->assertVisible('@input-error');
+$page->click('@submit-button');
 ```
 
 ```vue
 <!-- Vue component -->
-<button dusk="submit-button" @click="handleSubmit">Submit</button>
-<span dusk="input-error" v-if="error">{{ error }}</span>
+<button data-testid="submit-button" @click="handleSubmit">Submit</button>
+<span data-testid="input-error" v-if="error">{{ error }}</span>
 ```
+
+## No auto-wait
+
+Browser assertions do not auto-wait. Poll browser-side (see `waitForTestId` / `waitForDusk` helpers in existing tests) before asserting on async UI.
+
+## Strict models
+
+Use `->fresh()` when acting as a factory-created user — the in-process server keeps the guard user across requests, and factory instances lack nullable columns (strict mode throws `MissingAttributeException`).

.env.example

@@ -191,11 +191,17 @@ STRIPE_SECRET=
 STRIPE_WEBHOOK_SECRET=
 # Set to false to allow generic signup trial without requiring a card.
 REQUIRE_CARD_FOR_TRIAL=true
-# Free trial length in days, used only for the no-card generic trial above.
+# Checkout trial length in days (card collected up front when REQUIRE_CARD_FOR_TRIAL=true).
+# - >0: Stripe Checkout trial for N days for first-time signups only (no prior
+#   real subscription). Values below 2 are clamped to 2 (Stripe's 48h min).
+# - 0: no Checkout trial; charge starts immediately.
+# - Returning / canceled accounts never get another Checkout trial.
+# - When REQUIRE_CARD_FOR_TRIAL=false, Checkout never applies a trial (generic
+#   signup trial uses this value instead; must be >= 1 in that mode).
+# Empty = default 8.
 CASHIER_TRIAL_DAYS=8
-# Stripe Coupon ID (amount_off, duration=once) so the first invoice at
-# checkout comes out to $1 instead of the full monthly price.
-STRIPE_FIRST_MONTH_COUPON_ID=
+# Show Stripe Checkout promotion-code field.
+CASHIER_ALLOW_PROMOTION_CODES=true
 
 # Stripe Plan Price IDs (one per plan × interval). Used by PlanSeeder.
 STRIPE_WORKSPACE_MONTHLY=

CLAUDE.md

@@ -306,13 +306,16 @@ Vue components must have a single root element.
     - Example: `$this->postJson(route('app.posts.store'))` instead of `$this->postJson('/posts')`.
     - With params: `route('app.posts.ai.create.finalize', $creationId)`.
 
-## Dusk (Browser Tests)
-
-- In Dusk tests, ALWAYS use named routes via `route()` helper. NEVER hardcode URLs like `'https://trypost.test/login'`.
-    - Example: `$browser->visit(route('login'))` instead of `$browser->visit('https://trypost.test/login')`.
-- ALWAYS use `dusk` selectors (`@selector-name`) for interacting with and asserting elements. NEVER use CSS classes (`.text-red-600`), tag names, or text strings.
-    - Add `dusk="my-element"` attributes to Vue components and use `$browser->click('@my-element')`, `$browser->waitFor('@my-element')`, etc.
-    - Example: `$browser->waitFor('@input-error')` instead of `$browser->waitFor('.text-red-600')`.
+## Browser Tests
+
+- In browser tests, ALWAYS use named routes via `route()` helper. NEVER hardcode URLs like `'https://trypost.test/login'`.
+    - Example: `visit(route('login'))` instead of `visit('https://trypost.test/login')`.
+- ALWAYS use `data-testid` selectors (`@selector-name`) for interacting with and asserting elements. NEVER use CSS classes (`.text-red-600`), tag names, or text strings.
+    - The Pest browser plugin resolves `@selector` against `[data-testid]` / `[data-test]` only — `dusk="..."` attributes are NOT matched.
+    - Add `data-testid="my-element"` attributes to Vue components and use `$page->click('@my-element')`, `$page->assertVisible('@my-element')`, etc.
+    - Example: `$page->assertVisible('@input-error')` instead of `$page->assertVisible('.text-red-600')`.
+- Assertions do not auto-wait — poll browser-side (see `waitForTestId`/`waitForDusk` helpers in `tests/Browser`) before asserting on async UI.
+- Use `->fresh()` when acting as a factory-created user: the in-process server keeps the guard user across requests, and factory instances lack nullable columns (strict mode throws `MissingAttributeException`).
 
 ## Array Data Access
 

app/Actions/Billing/StartSubscriptionCheckout.php

@@ -5,17 +5,16 @@
 namespace App\Actions\Billing;
 
 use App\Models\Account;
-use App\Support\Billing\FirstMonthCheckoutDiscount;
+use App\Support\Billing\ConfigureSubscriptionCheckout;
 use Inertia\Inertia;
 use Symfony\Component\HttpFoundation\Response;
 
 class StartSubscriptionCheckout
 {
     /**
      * Create a Stripe Checkout session for the given price and return an Inertia
-     * redirect to it. Quantity tracks the account's workspace count; the first
-     * month's coupon is applied when the instance requires a card up front, so
-     * the first invoice charges $1 instead of running a $0 trial authorization.
+     * redirect to it. Quantity tracks the account's workspace count. Trial days
+     * and promotion codes come from Cashier env config.
      */
     public function redirect(Account $account, string $priceId, string $cancelUrl): Response
     {
@@ -27,7 +26,7 @@ public function redirect(Account $account, string $priceId, string $cancelUrl):
         $subscription = $account->newSubscription(Account::SUBSCRIPTION_NAME, $priceId)
             ->quantity(max(1, $account->workspaces()->count()));
 
-        FirstMonthCheckoutDiscount::apply($subscription, $account);
+        ConfigureSubscriptionCheckout::apply($subscription, $account);
 
         $session = $subscription->checkout([
             'success_url' => route('app.billing.processing').'?session_id={CHECKOUT_SESSION_ID}',