Internal Documentation

Welcome to the AI SpendOps internal docs. This section is for team members only and is protected by Cloudflare Access in production.

These pages cover the system internals that are not exposed to customers: architecture decisions, detailed specifications, operational runbooks, and deployment procedures.

Quick Links

Architecture

• System Overview — Components, environments, and architectural principles
• Proxy Design — Auth, routing, streaming, and usage extraction

Specifications

• Pricing Pipeline — Helicone sync, KV storage, alias resolution, change detection
• Usage Enrichment — Provider-specific extraction, cost calculation formulas
• Budget Alerting — Scopes, periods, ClickHouse queries, notifications
• Denial Event Pipeline — Denial points, queue, consumer, event schema
• Stripe Billing — Plans, invoicing, overage, VAT
• Model Expense Ranking — Cost scoring, ranking tiers, recomputation

Operations

• Deployment — Workers, CI/CD, KV namespaces, queues
• SaaS Metrics — MRR/ARR, retention, unit economics, financial health