Campaign Phase B Planned
Campaign lets merchants run promotions - percentage and fixed discounts, bundles, BuyGet offers and coupon codes - targeted by customer, product, and date. Promotion setup and lifecycle are live today; automatic discount application at checkout is planned for Phase B.
1. Identity
| Property | Value |
|---|---|
| Module ID | EXT-03 |
| Tier | Extended |
| Status | Planned |
| Phase | P1-P3 |
| Priority | MEDIUM |
| Primary users | Owner / Manager |
2. Purpose & Scope
| Included | Excluded |
|---|---|
| Define discounts, bundles, BuyGet, coupons | Loyalty points (see Loyalty) |
| Eligibility rules & scheduling | Message delivery (see Marketing) |
| Activate / deactivate lifecycle | Tax computation (Pricing tax engine) |
| Discount application at checkout | - |
3. Capabilities
| Capability | What the user can do |
|---|---|
| Promotion setup | Create promotions with method + rules in one step |
| Lifecycle control | Activate, deactivate, expire, archive |
| Eligibility & target rules | Restrict by customer, product, order conditions |
| BuyGet campaigns | Define "buy X get Y" offers |
| Coupon codes | Manual promo codes with usage limits |
| Discount application | Auto-apply discounts during pricing/checkout |
| Campaign analytics | Track usage and ROI |
Promotion CRUD, lifecycle and rules are wired in code. Discount calculation is not yet active - the compute service is disabled, so promotions are configured but not auto-applied at checkout.
4. Module Dependencies
| Depends on | Why |
|---|---|
| Products | Target rules reference products and categories |
| Customer | Eligibility rules reference customer segments |
5. Backend Packages
Implementation detail lives in the developer docs - this section only maps the module to the services that power it.
| Package | Role | Developer docs |
|---|---|---|
@nx/pricing | Promotion CRUD, rules, lifecycle; discount compute (disabled) | Promotion System |
Engineering Mapping (Feature ⇄ Package)
The horizontal axis of the Feature Spine - each business feature (
<AREA>in the URD) maps to its engineering home. Reciprocal: the package docs link back here.
| Feature | Dev package | Status |
|---|---|---|
PRM Promotion Setup & Lifecycle | @nx/pricing | Built |
APP Discount Application | @nx/pricing | Planned |
6. Key User Flows
7. Roles & Permissions
| Role | Can | Cannot |
|---|---|---|
| Owner | Create, activate, archive any promotion | - |
| Manager | Create & manage promotions | Override usage limits post-launch |
8. Status & Roadmap
| Phase | Capabilities |
|---|---|
| P1 | Promotion setup, rules, lifecycle, BuyGet, coupons (live) |
| P2 | Discount application at checkout (compute service) |
| P3 | Campaign analytics & ROI reporting |