Package com.eqixiac.equinix.design.value.ratecard

package com.eqixiac.equinix.design.value.ratecard

Rate cards: pluggable sources of unit prices for the design-time cost, savings, and TCO models. The central abstraction is RateCard, whose lookups (connection, Cloud Router, cloud egress, colocation) return Optional — an empty result means "this card cannot price that item", which is deliberately distinct from a zero price, so callers fall back to another source instead of treating unknown as free.

Cards are composed into a precedence chain with RateCard.layered(...) — the first card that can price an item wins. The conventional ordering is most-trusted first: CustomRateCard (caller-supplied, e.g. negotiated contract rates), then EquinixRateCard (live Fabric Pricing API, term-aware with labelled substitutions), then ReferenceRateCard (bundled, dated indicative figures). RateCard.standardChain(fabric) builds the default live-then-reference chain the value models use when no card is supplied. Every PriceQuote and EgressRate carries its PriceSource provenance and an optional note flagging substitutions and extrapolations.

Two invariants hold across all cards: an unpriceable item yields empty, never a fabricated $0; and quotes in different currencies are never combined — no FX rate is ever invented (PriceQuote.plus throws on a currency mismatch, and the engines route cross-card sums through CurrencyReconciler).

See Also:

• RateCard
• PriceSource
• com.eqixiac.equinix.design.value.ratecard.provider

Related Packages

Package	Description
com.eqixiac.equinix.design.value	The value-realization layer of the design API: design-time cost modelling that puts a money figure on an interconnect decision.
com.eqixiac.equinix.design.value.ratecard.provider	Live cloud-provider pricing adapters: RateCard implementations that source current data-egress list prices from the providers' public pricing APIs — AwsPriceListRateCard (AWS Price List bulk offers), AzureRetailPricesRateCard (Azure Retail Prices), GcpBillingCatalogRateCard (GCP Cloud Billing Catalog; the only one needing an API key), and OracleCloudPriceListRateCard (OCI Price List).
com.eqixiac.equinix.design.value.savings	Cloud-egress savings estimation: how much routing a monthly data volume over an Equinix private interconnect saves versus egressing it to the public internet, net of the Equinix interconnect cost.
com.eqixiac.equinix.design.value.tco	Design-time total-cost-of-ownership comparison across three DeploymentArchetypes — public cloud over the internet, on-premises, and Equinix-interconnected.

Class	Description
ColocationItem	An Equinix colocation cost primitive that a RateCard can price — alongside the interconnection rates (connection / cloud router / egress).
CustomRateCard	A RateCard whose prices are supplied by the caller — e.g.
CustomRateCard.Builder	Fluent builder for a CustomRateCard.
EgressPath	The network path data egress takes when leaving a cloud provider.
EgressRate	A usage-based data-egress price expressed per gigabyte, tagged with its PriceSource.
EquinixRateCard	A RateCard backed by the live Equinix Fabric Pricing API (fabric.prices()); the authoritative source of Equinix-side connection and Cloud Router prices for the cost, savings, and TCO models.
PriceQuote	An immutable price for a single resource, split into its monthly-recurring (MRC) and non-recurring (one-time setup, NRC) components, tagged with the PriceSource it was resolved from.
PriceSource	Identifies where a PriceQuote came from, so every number in a cost estimate or savings calculation is traceable to its origin and disclaimed appropriately.
RateCard	A source of unit prices for the design-time cost, savings, and TCO models.
ReferenceRateCard	A RateCard backed by a bundled, dated table of indicative reference figures — published cloud-provider egress rates, interconnect port fees, and on-prem/colocation midpoints — compiled so the value-realization models work out of the box without a live connection or caller-supplied rates.
Term	Commitment term for a priced resource.