forked from diegoecab/oci-deal-accelerator
6209907a63
Regression after the closing-slide removal surfaced a separate bug: _adapt_flat_spec() only emitted metadata + summary + cost, so decks generated from the MCP flat payload collapsed to 3-5 slides of title + summary. The deck generator's ECAL sections (service_tiering, architecture_principles, environment_catalogue, operational_raci, etc.) all check top-level spec keys the adapter never produced. Adapter now also emits, from the flat payload + kb/patterns defaults: - service_tiering from services[] (preserves any tier/uptime/rto/rpo) - architecture / architecture_principles (ECAL "always" picks) - ha_dr tiers derived from the distinct service tiers present - security baseline (IAM/network/database/monitoring controls) - environment_catalogue (Prod/Pre-Prod/Dev-Test, +DR if enabled) - operational_raci co_managed default from the KB - next_steps skeleton Flat MCP payload now renders 11 content slides instead of 3-5, and the proposal-spec.yaml path (non-flat) is unchanged — still 16 slides for examples/proposal-spec.yaml. Also documents the new data_services SKUs in docs/bom-cookbook.md as Recipe 4 (BDS/DS/DF) so MCP payloads can use the catalog codes directly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
191 lines
6.7 KiB
Markdown
191 lines
6.7 KiB
Markdown
# BOM Cookbook — Building `generate_bom` Payloads
|
|
|
|
Copy-paste recipes that map common customer requirements to the exact OCI SKUs the
|
|
`generate_bom`, `generate_bom_appca`, and `generate_cost_estimate` MCP tools expect.
|
|
The goal is to skip the "grep the catalog and guess SKUs" exploration loop that
|
|
burns tool calls on well-known patterns.
|
|
|
|
> **If the requirement does not match any recipe below, consult
|
|
> [`kb/services/`](../kb/services/) and
|
|
> [`kb/pricing/oci-sku-catalog.yaml`](../kb/pricing/oci-sku-catalog.yaml)
|
|
> before inventing SKUs.** All SKUs below are verified against the catalog as of
|
|
> 2026-04-20; re-`grep` the catalog if a recipe ever fails.
|
|
|
|
## Payload Shape
|
|
|
|
All three tools accept the same envelope:
|
|
|
|
```json
|
|
{
|
|
"customer_id": "acme-prod",
|
|
"discount_pct": 0.35,
|
|
"currency": "USD",
|
|
"services": [
|
|
{ "sku": "B90777", "quantity": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
- `customer_id`: free-form identifier, used for output file naming.
|
|
- `discount_pct`: decimal (0.35 = 35%). Applied to every line unless overridden.
|
|
- `services[].quantity`: integer or float depending on the SKU metric (ECPUs, GB, hours).
|
|
|
|
---
|
|
|
|
## Recipe 1 — Exadata Cloud Service (ExaCS) X11M, BYOL
|
|
|
|
**When it matches:** "ExaCS X11M BYOL, N ECPUs, M TB storage, no DR" — customer-managed
|
|
Oracle Database on dedicated Exadata hardware, BYOL licensing.
|
|
|
|
**SKUs:**
|
|
|
|
| SKU | Component | Typical qty |
|
|
|-----|-----------|-------------|
|
|
| `B90777` | Exadata Infrastructure — Base System | `1` per rack |
|
|
| `B110627` | Exadata Database Server — X11M | `2` (Base/Quarter) — adjust per rack config |
|
|
| `B110629` | Exadata Storage Server — X11M | `3` (Base/Quarter) — adjust per rack config |
|
|
| `B110632` | Exadata Database ECPU — Dedicated Infra BYOL (X11M) | One per ECPU |
|
|
|
|
Swap `B110632` → `B110631` for PAYG (license-included) pricing.
|
|
|
|
**Payload (120 ECPUs, 120 TB, BYOL, standard Base System):**
|
|
|
|
```json
|
|
{
|
|
"customer_id": "acme-exacs",
|
|
"discount_pct": 0.35,
|
|
"currency": "USD",
|
|
"services": [
|
|
{ "sku": "B90777", "quantity": 1 },
|
|
{ "sku": "B110627", "quantity": 2 },
|
|
{ "sku": "B110629", "quantity": 3 },
|
|
{ "sku": "B110632", "quantity": 120 }
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Recipe 2 — Autonomous Database Dedicated (ADB-D), BYOL
|
|
|
|
**When it matches:** "ADB Dedicated, N ECPUs, M TB, BYOL" — Autonomous Database running
|
|
on dedicated Exadata infrastructure.
|
|
|
|
**⚠️ Gotcha that burns tool calls:** ADB-Dedicated has **no separate infrastructure
|
|
SKUs** in the catalog. It reuses the same Exadata dedicated infra SKUs as ExaCS
|
|
(`B90777`, `B110627`, `B110629`) plus the same Exadata ECPU SKU (`B110631`/`B110632`).
|
|
The Autonomous-vs-customer-managed distinction is a tenancy-level configuration,
|
|
not a billing line item. Do not search for `autonomous_dedicated` SKUs — they do
|
|
not exist.
|
|
|
|
**SKUs:** identical to Recipe 1.
|
|
|
|
**Payload (64 ECPUs, BYOL):**
|
|
|
|
```json
|
|
{
|
|
"customer_id": "acme-adbd",
|
|
"discount_pct": 0.35,
|
|
"currency": "USD",
|
|
"services": [
|
|
{ "sku": "B90777", "quantity": 1 },
|
|
{ "sku": "B110627", "quantity": 2 },
|
|
{ "sku": "B110629", "quantity": 3 },
|
|
{ "sku": "B110632", "quantity": 64 }
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Recipe 3 — Autonomous Database Serverless (ADB-S) + Block Volume + FastConnect
|
|
|
|
**When it matches:** "ADB-S ATP, N ECPUs, M TB data + block storage for app tier +
|
|
FastConnect to on-prem" — the typical "app on OCI Compute, DB on ADB-S" pattern.
|
|
|
|
**SKUs:**
|
|
|
|
| SKU | Component | Metric |
|
|
|-----|-----------|--------|
|
|
| `B95701` | ADB ECPU (ATP or ADW) — license-included | ECPU/hour |
|
|
| `B95703` | ADB ECPU BYOL — use instead of B95701 if BYOL | ECPU/hour |
|
|
| `B95706` | ADB ATP data storage | GB/month |
|
|
| `B95754` | ADB ADW data storage — use instead of B95706 for warehouse | GB/month |
|
|
| `B95754a` | ADB backup storage | GB/month |
|
|
| `B91961` | Block Volume storage (app tier) | GB/month |
|
|
| `B91962` | Block Volume performance (VPU) — optional, for higher IOPS tiers | VPU/GB/month |
|
|
| `B88326` | FastConnect 10 Gbps port | port-hour |
|
|
|
|
Swap `B88326` → `B88325` (1 Gbps) or `B93126` (100 Gbps) as needed.
|
|
|
|
**Payload (16 ECPUs ATP license-included, 2 TB data + 1 TB backup, 500 GB block, 10 G FastConnect):**
|
|
|
|
```json
|
|
{
|
|
"customer_id": "acme-adbs",
|
|
"discount_pct": 0.35,
|
|
"currency": "USD",
|
|
"services": [
|
|
{ "sku": "B95701", "quantity": 16 },
|
|
{ "sku": "B95706", "quantity": 2048 },
|
|
{ "sku": "B95754a", "quantity": 1024 },
|
|
{ "sku": "B91961", "quantity": 500 },
|
|
{ "sku": "B88326", "quantity": 1 }
|
|
]
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Recipe 4 — Big Data Service + Data Science + Data Flow (analytics stack)
|
|
|
|
**When it matches:** "HDFS-managed cluster for ETL", "notebooks + model deployment",
|
|
"managed Spark pipelines" — typical OCI analytics/AI workload mix.
|
|
|
|
**SKUs:**
|
|
|
|
| SKU | Component | Metric |
|
|
|-----|-----------|--------|
|
|
| `B91128` | Big Data Service — Compute Standard (real) | OCPU/hour |
|
|
| `B91129` | Big Data Service — Compute Dense I/O (real) | OCPU/hour |
|
|
| `B91130` | Big Data Service — Compute HPC (real) | OCPU/hour |
|
|
| `B93555` | Big Data Service — Core (real) | OCPU/hour |
|
|
| `EST-DS-NOTEBOOK` | **[Estimate]** Data Science notebook session — priced as underlying VM.Standard OCPU | OCPU/hour |
|
|
| `EST-DS-MODEL` | **[Estimate]** Data Science model-deployment endpoint — priced as underlying VM.Standard OCPU | OCPU/hour |
|
|
| `EST-DF-SPARK` | **[Estimate]** Data Flow managed Spark runtime — priced as underlying VM.Standard OCPU | OCPU/hour |
|
|
|
|
OCI Data Science and OCI Data Flow have no dedicated SKUs in the Oracle public
|
|
pricing API — both are billed via the underlying Compute shape + Block/Object
|
|
Storage consumed. The `EST-*` entries are placeholder estimates (VM.Standard3.Flex
|
|
OCPU rate) so BOMs can include them as line items with an explicit "estimate"
|
|
flag; confirm the actual shape and hours with the customer before quoting.
|
|
|
|
**Payload (16 BDS Standard + 8 BDS Dense I/O + 4 notebook + 2 model + 8 Spark):**
|
|
|
|
```json
|
|
{
|
|
"customer_id": "acme-analytics",
|
|
"discount_pct": 0.30,
|
|
"currency": "USD",
|
|
"services": [
|
|
{ "sku": "B91128", "quantity": 16 },
|
|
{ "sku": "B91129", "quantity": 8 },
|
|
{ "sku": "EST-DS-NOTEBOOK", "quantity": 4 },
|
|
{ "sku": "EST-DS-MODEL", "quantity": 2 },
|
|
{ "sku": "EST-DF-SPARK", "quantity": 8 }
|
|
]
|
|
}
|
|
```
|
|
|
|
Add `B91961` (Block Volume) and `B91628` (Object Storage Standard) when the
|
|
customer needs dedicated storage beyond the compute default.
|
|
|
|
---
|
|
|
|
## When a recipe doesn't fit
|
|
|
|
1. Grep the catalog: `grep -n "<product keyword>" kb/pricing/oci-sku-catalog.yaml`
|
|
2. Check service docs under `kb/services/` for deployment-specific guidance.
|
|
3. Check `kb/field-knowledge/` for known sizing/pricing gotchas.
|
|
4. If a SKU still cannot be located, surface the gap to the user rather than guessing — fabricated SKUs break the BOM silently.
|