Store Stripe's Subscription.customer to subscriptions.customer column in the database

[satococoa]

Task Description

We currently need to make API calls to Stripe each time to get the Subscription.customer information, as it's not stored in our database. This information is required for:

• Building a customer portal
• Reporting usage-based billing

To improve performance and reliability, we need to store this information in our subscriptions table.

Background

Current implementation requires Stripe API calls for each operation:

• giselle/services/usage-based-billing/agent-time-usage.ts

  Lines 78 to 83 in 4a5a130

  	// FIXME: if we have customer id in subscriptions table, we can use it directly
  	const subscription = await stripe.subscriptions.retrieve(subscriptionId);
  	customerId =
  	typeof subscription.customer === "string"
  	? subscription.customer
  	: subscription.customer.id;

• giselle/services/teams/actions/manage-billing.ts

  Lines 11 to 16 in 4a5a130

  	const subscription = await stripe.subscriptions.retrieve(subscriptionId);
  	const session = await stripe.billingPortal.sessions.create({
  	customer: subscription.customer as string,
  	return_url: `${siteUrl}/settings/team`,
  	});

Implementation Steps

1. Add customer column to subscriptions table (nullable initially)
2. Migrate existing subscriptions by fetching customer data from Stripe API
3. Modify the column to be NOT NULL

Reference

• Stripe Subscription Object Documentation