feat: console screens for promotions, promo codes, segments and campaigns

[roncodes]

Summary

Console screens for the promotions work. The Storefront Promotions section (sidebar and tabs) now has Promotions, Campaigns, Segments and the existing Push Notifications.

Stacked PR, part of release #107 (release/v0.4.22). This builds on #105 (campaigns), which builds on #102, #103 and #104. Review only commit c7a10fb "feat: add console screens…". The diff shrinks to it once the stack merges into the release branch.

Promotions

• List: name, type (with value), trigger (automatic or promo code), status, run dates, redemptions, and discount given.
• Row actions: edit, manage codes, announce, activate / pause / end, and delete.
• Form sections:
  • Basics: name, description, type (percentage, amount off, free delivery, buy X get Y with quantities and discount %), trigger, status.
  • Schedule: start and end date/time.
  • Conditions: minimum spend, minimum items, first order only.
  • Targeting: products, categories, excluded products.
  • Limits: total uses, uses per customer, total budget, maximum discount per order.
  • Stacking: stackable, priority, show in the app's deals.
• Promo codes modal: generate a batch (count, prefix, length, uses per code) or one specific code; list codes with usage; disable or enable each code.
• Announce modal: audience segment, notification title and message, optional send time. It creates a campaign through POST promotions/{id}/announce.

Campaigns

• List: status, audience, title, send time, and customers reached. Row actions: edit, send now, cancel, delete.
• Form: name, notification title and message, audience (segment, or all customers), channels (push and/or inbox), linked promotion or a URL, and when to send: save as draft, send now, or schedule. Existing campaigns show their current audience size.

Segments

• List and a rule builder (order counts, ordered or lapsed within N days, joined within N days, minimum spend, reachable by push) that shows a live count of matching customers.

Plumbing

• Ember Data models, adapters and app re-exports for promotion, promotion-code, customer-segment and campaign.
• Three small table cell components for the promotions list.
• English translations under storefront.promotions.*. Other locales fall back and still need translating.

Related Issue

Part of the promotions / notifications work. No tracking issue.

Type of Change

• Bug fix
• Feature
• Refactor
• Documentation
• Test
• Chore

Implementation Notes

• The screens follow the existing Storefront patterns: Layout::Section with Table, row dropdown actions, and modalsManager forms. Monetary fields use MoneyInput (minor units, same as the API) and dates use DateTimeInput.
• The promotion form stores targeting as ids in applies_to and reloads the selected products and categories when it opens.
• The weekly schedule windows supported by the API (e.g. happy hours) aren't editable in the form yet. That's a follow-up.

Validation

• Tests (no new Ember tests)
• Lint
• Build
• Manual validation (see below)

eslint addon app           -> clean
ember-template-lint addon  -> clean for new files (2 errors that already exist on main: widget/customers.hbs:35, widget/orders.hbs:49)
fleetbase-intl-lint        -> all translation keys found
pnpm build (production)    -> succeeds
composer test:unit         -> 582 tests, 0 failures (backend of the stack)

Not clicked through in a browser. The local console runs the published engine package, not this checkout. I did run the API behind these screens against a local MySQL database:

• the promotion engine, including stacking and codes
• reservation under a row lock
• every segment rule
• campaign audience counts
• the inbox queries

Temporary rows were cleaned up afterwards. A manual pass in the console is still needed before merging.

Documentation Impact

• No documentation changes needed
• Documentation updated in fleetbase/fleetbase.io
• Documentation needed but not included

API Reference Impact

• No API reference changes needed
• Updated fleetbase/postman
• API reference updates required but not included

Documentation Notes

fleetbase.io, Storefront → Promotions: user guide for promotions, promo codes, segments and campaigns.

Risk

UI only. The promotions route's index is now the promotions list, and Push Notifications moved to promotions/push-notifications, so existing sidebar and tab links are updated.

Screenshots / Recordings

Not captured (see Validation).

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (490f9e5) to head (b8de7df).
⚠️ Report is 21 commits behind head on release/v0.4.22.

Additional details and impacted files

@@                  Coverage Diff                  @@
##             release/v0.4.22      #106     +/-   ##
=====================================================
  Coverage             100.00%   100.00%             
- Complexity              1772      2281    +509     
=====================================================
  Files                    135       182     +47     
  Lines                   7778      9070   +1292     
=====================================================
+ Hits                    7778      9070   +1292     

Flag	Coverage Δ
backend	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.