Skip to main content

Track G: Revenue & Billing Operations

Priority: HIGH — Revenue enablement for GA launch Agent: payment-systems-specialist, subscription-billing Sprint Range: S5-S7 Reference: docs/executive/60-business-model.md (4 pricing tiers, hybrid model)

Status Summary​

Progress: 0% (0/24 tasks)

SectionTitleStatusTasks
G.1Subscription ManagementPending0/5
G.2Pricing Engine & Tier ManagementPending0/5
G.3Invoicing & Payment ProcessingPending0/5
G.4Usage Metering & Overage BillingPending0/5
G.5Revenue Recognition & ReportingPending0/4

G.1: Subscription Management​

Sprint: S5 | Priority: P0 | Depends On: C.1 Goal: Core subscription lifecycle for 4-tier hybrid SaaS model

  • G.1.1: Design subscription data model (Plan, Subscription, BillingCycle, Invoice entities)
    • Plans: Starter ($36K-$60K), Professional ($96K-$180K), Enterprise ($240K-$600K), Enterprise Plus ($400K+)
    • Subscription states: trial -> active -> past_due -> suspended -> cancelled -> expired
    • Billing cycles: monthly, quarterly, annual with auto-renewal
  • G.1.2: Implement subscription lifecycle state machine
    • State transitions: upgrade/downgrade with proration
    • Grace period: 15 days past_due before suspension
    • Reactivation: workflow with payment verification
  • G.1.3: Build subscription management API
    • CRUD endpoints: create, read, update, cancel subscriptions
    • Plan change: proration calculation
    • Audit trail: subscription history and change log
  • G.1.4: Create subscription admin dashboard
    • Overview: active, trial, churned counts
    • MRR/ARR: display with trend charts
    • Health indicators: payment failures, upcoming renewals
  • G.1.5: Implement trial management
    • Duration: 14-day free trial with feature limits
    • Tracking: trial-to-paid conversion tracking
    • Extension: sales-approved trial extension workflow

G.2: Pricing Engine & Tier Management​

Sprint: S5-S6 | Priority: P0 | Depends On: G.1 Goal: Configurable pricing with tier-based feature gating

  • G.2.1: Build configurable pricing engine
    • Model: base price + per-seat + per-WO overage
    • Tier thresholds: Starter (<=500 WOs, <50 employees), Professional (<=5000 WOs), Enterprise (unlimited)
    • Discount rules: annual prepay (15%), multi-year (20%), volume
  • G.2.2: Implement tier feature gating
    • Feature matrix: per tier (agent autonomy level, integrations, SLA, support tier)
    • Runtime checks: subscription.tier middleware
    • Degradation: graceful limits approaching
  • G.2.3: Create pricing configuration admin
    • Price lists: management with effective dates
    • Custom pricing: Enterprise Plus per-deal override
    • Impact analysis: price change on existing subscriber revenue
  • G.2.4: Implement quote generation
    • CPQ: Configure-Price-Quote for sales team
    • PDF quotes: generation with terms
    • Conversion: quote-to-subscription workflow
  • G.2.5: Build pricing analytics
    • Revenue: per tier breakdown
    • Flow analysis: upgrade/downgrade patterns
    • Sensitivity: price sensitivity tracking

G.3: Invoicing & Payment Processing​

Sprint: S6 | Priority: P0 | Depends On: G.1, G.2 Goal: Stripe-based payment processing with PCI compliance

  • G.3.1: Integrate payment gateway (Stripe)
    • Recurring: Stripe Billing for subscriptions
    • Enterprise: ACH/wire for net-30/60 terms
    • PCI DSS: compliance via Stripe Elements (no card data on our servers)
  • G.3.2: Build invoice generation engine
    • Automated: monthly/quarterly/annual invoices
    • Line items: base subscription + overage + professional services
    • Tax: Stripe Tax or Avalara integration
  • G.3.3: Implement payment lifecycle management
    • Storage: tokenized payment methods via Stripe
    • Retry logic: failed payments at 1, 3, 7 day intervals
    • Dunning: email sequence for past_due notifications
  • G.3.4: Create billing portal for customers
    • Self-service: payment method update
    • History: invoice history and PDF download
    • Display: current plan and usage
  • G.3.5: Build accounts receivable dashboard
    • Outstanding: invoices and aging report
    • Metrics: payment collection rate and DSO
    • Waterfall: billed -> collected -> recognized

G.4: Usage Metering & Overage Billing​

Sprint: S6-S7 | Priority: P1 | Depends On: C.1, G.3 Goal: Event-driven usage tracking with overage billing

  • G.4.1: Design usage metering infrastructure
    • Events: WO created, WO completed, agent invocations, API calls
    • Counters: real-time with daily aggregation
    • Database: append-only usage_events table
  • G.4.2: Implement usage tracking per tenant
    • Work orders: count per billing period
    • Users: active user count (monthly unique logins)
    • AI agents: invocation count with token consumption
    • API: call volume tracking
  • G.4.3: Build overage calculation engine
    • Detection: threshold detection per tier
    • Pricing: per-WO ($15-$25), per-seat ($50-$100/mo)
    • Proration: mid-cycle overage billing
  • G.4.4: Create usage dashboard for customers
    • Real-time: usage vs. plan limits
    • Trends: 30/60/90 day usage charts
    • Projection: overage projection and upgrade recommendation
  • G.4.5: Implement usage-based alerting
    • Thresholds: 80%/90%/100% notifications
    • Admin alerts: approaching limits
    • Auto-suggest: upgrade suggestion workflow

G.5: Revenue Recognition & Reporting​

Sprint: S7 | Priority: P1 | Depends On: G.3, G.4 Goal: ASC 606 compliant revenue recognition and investor-grade metrics

  • G.5.1: Implement ASC 606 revenue recognition
    • Obligations: performance obligation tracking per contract
    • Allocation: revenue across deliverables (subscription, services, marketplace)
    • Deferred revenue: calculation for annual prepayments
  • G.5.2: Build MRR/ARR calculation engine
    • Components: new MRR, expansion MRR, contraction MRR, churned MRR
    • ARR: MRR * 12 with segment breakdowns
    • NRR: Net Revenue Retention tracking (target: 160%)
  • G.5.3: Create financial reporting dashboards
    • Revenue: by tier, segment, cohort
    • Unit economics: LTV ($12.3M), CAC ($15K), payback (8 months)
    • Gross margin: tracking (target: 72-76%)
  • G.5.4: Build investor-grade metrics export
    • SaaS metrics: ARR, NRR, logo churn, gross margin, CAC payback
    • Board deck: data export (quarterly)
    • Audit-ready: revenue documentation

Updated: 2026-02-14 Compliance: CODITECT Track Nomenclature Standard (ADR-054)