pcm-engine 0.4.1

Product Catalog Engine (PCM) Framework for pricing, eligibility, bundling, relationships, and catalog versioning
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

# pcm-engine


[![Crates.io](https://img.shields.io/crates/v/pcm-engine.svg)](https://crates.io/crates/pcm-engine)
[![Documentation](https://docs.rs/pcm-engine/badge.svg)](https://docs.rs/pcm-engine)

**Product Catalog Engine (PCM)** — the catalog heart of the BSS/OSS Rust ecosystem.

**Status: implemented (v0.4.1)** on [crates.io](https://crates.io/crates/pcm-engine). All four core feature areas below are available in the library API today.

## Implemented features


| Area | What you get |
|------|----------------|
| **Pricing rules & calculations** | Base price, percentage / fixed discounts with conditions, `valid_for` windows, priority-based rule selection, complex models (tiered, volume, subscription, dynamic) |
| **Product eligibility validation** | All / Any rule sets, customer segment & attributes, `has_product` ownership checks, structured `EligibilityOutcome` with failure reasons |
| **Bundling & product relationships** | Mandatory / optional / exclusive bundles, runtime selection validation, relationships (`DependsOn`, `Excludes`, `Requires`, `MigratesTo`), bundle price calculation |
| **Catalog versioning & lifecycle** | Content snapshots of rules/bundles/relationships, create → publish → rollback, content-aware version diffs |

Entry point: **`CatalogEngine`** — register rules, call `calculate_price`, `check_eligibility` / `explain_eligibility`, `qualify_and_price`, bundle helpers, and `create_version` / `publish_version` / `rollback_to_version`.

## Install


```toml
pcm-engine = "0.4.1"
```

```bash
cargo add pcm-engine@0.4.1
```

## Quick start


```rust
use pcm_engine::{
    CatalogEngine, EligibilityContext, Money, PriceType, PricingContext, PricingRule,
};
use uuid::Uuid;

let offering = Uuid::new_v4();
let mut engine = CatalogEngine::new();

engine.add_pricing_rule(PricingRule {
    id: Uuid::new_v4(),
    product_offering_id: offering,
    price_type: PriceType::OneTime,
    base_price: Money {
        value: 29.99,
        unit: "USD".into(),
    },
    priority: 10,
    discount_rules: None,
    valid_for: None,
});

let price = engine
    .calculate_price(offering, &PricingContext::new(1))
    .expect("price");
assert!((price.value - 29.99).abs() < f64::EPSILON);

// Snapshot + publish catalog content
let catalog_id = Uuid::new_v4();
let version = engine.create_version(catalog_id, "1.0.0".into(), None, None);
engine.publish_version(version.id).unwrap();
```

### Qualify and price in one call


```rust
use pcm_engine::{CatalogEngine, EligibilityContext, PricingContext};
use uuid::Uuid;

let offering = Uuid::new_v4();
let engine = CatalogEngine::new(); // with rules already registered
let mut eligibility = EligibilityContext::new();
eligibility.customer_segment = Some("premium".into());

let result = engine.qualify_and_price(
    offering,
    &eligibility,
    &PricingContext::new(1),
    &[offering],
);
if result.eligible {
    let _money = result.price;
}
```

## Tests


```bash
cargo test -p pcm-engine
```

## Docs in this repo


- Root README — PCM section under Architecture / Core Engine Crates  
- [docs.rs/pcm-engine](https://docs.rs/pcm-engine)

## License


MIT