Introducing the Subscription Management System

Release: v1.0.68

Version 1.0.68 delivers a fully integrated Subscription Management System for the platform. This system gives operators and tenants end-to-end control over plan lifecycles, feature access, and usage-based billing — all enforced automatically within the multi-tenant environment.

Overview

The Subscription Management System is built around four core capabilities:

Subscription lifecycle management — create, modify, and cancel tenant subscriptions
Feature access control — gate platform features based on the active plan
Usage tracking — measure and record consumption per tenant
Automated billing — charge tenants accurately based on plan and usage

Subscription Lifecycle

Each tenant account is associated with a subscription record that defines:

The active plan (e.g. Starter, Professional, Enterprise)
The billing period (monthly or annual)
The status of the subscription (active, past due, cancelled, etc.)

Subscriptions can be created when a tenant is provisioned, and can be updated at any time by the tenant or a platform operator.

Plan Upgrades & Downgrades

Tenants can self-serve plan changes directly within the platform:

Upgrades take effect immediately, with proration applied for the remainder of the current billing period.
Downgrades are scheduled to apply at the end of the current billing cycle, preventing service disruption.

Feature Access Controls

Every platform feature is mapped to one or more subscription plans. The access control layer enforces plan entitlements at runtime:

Requests to access a feature not included in the tenant's active plan are rejected with an appropriate error.
Feature gates are evaluated on each request — plan changes propagate to access decisions without requiring a restart or manual cache flush.

This ensures tenants always have access to exactly what their plan entitles them to — no more, no less.

Usage Tracking

For metered features, the platform records consumption events per tenant. Tracked dimensions may include:

Number of active users
API call volume
Data storage consumed
Other configurable resource metrics

Usage data is aggregated at billing cycle boundaries to calculate charges for usage-based pricing tiers.

Automated Billing

The billing engine automates the full charge lifecycle:

Event	Behaviour
Subscription created	First invoice generated and charged
Billing period renews	Recurring charge triggered automatically
Plan upgraded mid-cycle	Prorated charge calculated and applied immediately
Plan downgraded	Credit or adjustment applied at next cycle
Usage-based charges	Metered usage totalled and invoiced at period end

No manual billing steps are required for standard subscription operations.

Usage-Based Pricing

In addition to flat-rate plans, the platform now supports usage-based pricing. With this model:

A base subscription fee covers the plan tier.
Additional charges are calculated from recorded usage above any included allowances.
Tenants can monitor their current usage against plan limits within the platform.

Access Enforcement Summary

Incoming Request
       │
       ▼
┌─────────────────────┐
│  Resolve Tenant     │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│  Load Active Plan   │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│  Check Feature Gate │──── Not entitled ──▶ 403 / Feature Unavailable
└─────────┬───────────┘
          │ Entitled
          ▼
     Continue Request

Summary

The Subscription Management System in v1.0.68 provides the foundational billing and access infrastructure needed to operate the platform commercially at scale. Key outcomes:

Tenants are automatically restricted to features within their plan.
Billing is handled end-to-end without manual intervention.
Usage-based pricing unlocks flexible, consumption-aligned revenue models.
Plan changes are self-serve and handled safely with proration and scheduling.