Campaign Phase B In-progress
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 | In-progress |
| 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 | Status |
|---|---|---|
| Promotion setup | Create promotions with method + rules in one step | In-progress |
| Lifecycle control | Activate, deactivate, expire, archive | In-progress |
| Eligibility & target rules | Restrict by customer, product, order conditions | In-progress |
| BuyGet campaigns | Define "buy X get Y" offers | In-progress |
| Coupon codes | Manual promo codes with usage limits | In-progress |
| Discount application | Auto-apply discounts during pricing/checkout | Planned |
| Campaign analytics | Track usage and ROI | Planned |
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 |
| CRM | 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 |
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 |