# Feature Catalog

Proven workload archetypes for demo billing data. Each feature represents
a real-world product component with a defined service stack per provider.

Use these as building blocks when designing a demo dataset. Pick the features
that match your demo scenario and scale the costs to your target spend.

## Core Product Features

### InsightAPI
Primary REST/GraphQL API for customer insights.
- **AWS**: EC2 (c5/m5), ALB, RDS PostgreSQL, ElastiCache Redis, EBS, Data Transfer
- **Azure**: VMs (D-series), SQL Database, Redis Cache, App Service
- **GCP**: Compute Engine (N2), Cloud SQL, Memorystore, Cloud Run
- **Budget ref**: $7M enterprise / $550K commercial (annual)
- **Tags**: `Feature: InsightAPI`
- **K8s namespace**: `insightapi-prod`

### Dashboard
Web analytics dashboard (React/Next.js frontend + backend).
- **AWS**: CloudFront, S3, ALB, EC2, EBS
- **Azure**: CDN, Blob Storage, App Service
- **GCP**: Cloud CDN, Cloud Storage, Cloud Run
- **Budget ref**: $4M enterprise / $310K commercial
- **Tags**: `Feature: Dashboard`
- **K8s namespace**: `dashboard-prod`

### MobileSDK
Mobile app backend services (iOS/Android).
- **AWS**: API Gateway, Lambda, DynamoDB, S3
- **Azure**: API Management, Functions, Cosmos DB
- **GCP**: Cloud Endpoints, Cloud Functions, Firestore
- **Budget ref**: $2.5M enterprise / $195K commercial
- **Tags**: `Feature: MobileSDK`

### DataPipeline
ETL and data transformation pipeline.
- **AWS**: EMR, Glue, S3, EC2 (Spark workers), EBS
- **Azure**: Data Factory, HDInsight, Blob Storage
- **GCP**: Dataproc, Dataflow, Cloud Storage
- **Budget ref**: $3M enterprise / $235K commercial
- **Tags**: `Feature: DataPipeline`
- **K8s namespace**: `datapipeline-prod`

### DataLake
Central data storage for analytics.
- **AWS**: S3 (multiple tiers), Glue Catalog
- **Azure**: ADLS Gen2, Blob Storage
- **GCP**: Cloud Storage, BigQuery Storage
- **Budget ref**: $2M enterprise / $155K commercial
- **Tags**: `Feature: DataLake`

### RealtimeSync
Real-time collaboration and live updates.
- **AWS**: API Gateway WebSocket, ElastiCache, Lambda
- **Azure**: SignalR, Event Hubs
- **GCP**: Cloud Pub/Sub, Cloud Run
- **Budget ref**: $2M enterprise / $155K commercial
- **Tags**: `Feature: RealtimeSync`

## Infrastructure Features

### SearchCore
Full-text search infrastructure (Elasticsearch/OpenSearch).
- **AWS**: OpenSearch, EC2 (search nodes)
- **Azure**: Cognitive Search
- **GCP**: Managed Elasticsearch
- **Budget ref**: $1.5M enterprise
- **Tags**: `Feature: SearchCore`

### MetricsEngine
Observability and monitoring infrastructure.
- **AWS**: CloudWatch, EC2 (Prometheus/Grafana), EBS
- **Azure**: Monitor, Log Analytics
- **GCP**: Cloud Monitoring, Cloud Logging
- **Budget ref**: $1.2M enterprise
- **Tags**: `Feature: MetricsEngine`

### IntegrationHub
Third-party API integrations (Salesforce, Slack, etc.).
- **AWS**: Lambda, SQS, API Gateway
- **Azure**: Logic Apps, Service Bus
- **GCP**: Cloud Functions, Cloud Tasks
- **Budget ref**: $1M enterprise
- **Tags**: `Feature: IntegrationHub`

## AI/ML Features

### ConversationalAI
AI chat and natural language querying (virtual feature — shared allocation).
- **Anthropic**: Claude API
- **OpenAI**: GPT API
- **AWS**: Bedrock
- **Budget ref**: $5.6M enterprise
- **Allocation**: Telemetry-based (token usage per feature)

### PredictiveML
Prediction models and training pipelines.
- **AWS**: SageMaker, EC2 GPU instances
- **Azure**: ML Studio
- **GCP**: Vertex AI
- **Budget ref**: $1.5M enterprise
- **Tags**: `Feature: PredictiveML`

## Config Organization

Organize configs by feature, with one file per service category:

```
configs/
  insightapi/
    compute.yaml      # EC2/VMs/GCE + K8s
    database.yaml      # RDS/SQL/Cloud SQL
    storage.yaml       # EBS/Managed Disks
    managed.yaml       # ElastiCache/Redis/ALB
  dashboard/
    compute.yaml
    storage.yaml       # S3/Blob/GCS + CDN
  datapipeline/
    compute.yaml       # EMR/Dataproc workers
    storage.yaml       # S3/GCS staging
```

Each YAML file contains jobs for one provider or multiple providers,
grouped by the service category within that feature.

## Scaling

Commercial tier is enterprise at ~8% scale. Same job names, tag variants,
filter patterns, and account structure. Only `total_cost` differs.

To scale any feature: multiply the budget ref by your target ratio.
Example: for a $1M/year demo, InsightAPI at 30% = $300K annual total_cost.
