# TechShop Commerce OS V5 — Premium Commerce Release

## Major experience changes

- Staff creation and staff account control now remain inside the main Administrator dashboard workspace.
- The dashboard brand/logo block has been removed to increase usable workspace.
- Customer cart is embedded in the Customer dashboard; guest cart remains shareable from the storefront.
- Wishlist menu has been removed. Loved products remain visually loved using persistent guest-session or account storage.
- Product-view metrics open the real product-view history and each record links back to the product.
- Storefront categories, footer, cart and secure checkout have received the premium animated design system, including ambient gadget motion.
- Trending-search fallback rotates real active products when search history is empty and refreshes every ten minutes.
- Search suggestions now use product names, brands, categories, SKU/GTIN and tokenized words from catalogue content.

## Campaign Studio

Marketers/Admins can select multiple products and choose Email, WhatsApp, Facebook, TikTok, X/Twitter, LinkedIn, Telegram or Instagram.

- Social channels create/share a curated campaign cart.
- Email creates a responsive product campaign with configurable sender, subject, hero heading and font.
- Large opted-in recipient lists can be pasted or uploaded as TXT/CSV, deduplicated and queued.
- Suppressed/unsubscribed recipients are excluded.
- Delivery is batched by the scheduler rather than blocking a browser request.
- Configure SMTP and run `composer install` before actual email delivery.

## Payments

Admin Payment Settings supports Paystack, Monnify and Flutterwave with encrypted application-side secret storage, test/live mode and activation switches. Environment credentials remain a fallback. Checkout only exposes activated/configured online gateways.

Payment completion is verified server-side against provider status, TechShop reference, currency and expected amount before fulfillment. V5 also supports Pay on Delivery and installmental checkout controls.

External provider accounts, credentials and registered callback/webhook URLs are still required before live transactions can be processed.

## Upgrade

Back up the database, `.env` and `public/uploads` first. Then run:

```powershell
composer install --no-dev --optimize-autoloader
php bin\upgrade-v5.php
php bin\validate-v5.php
php bin\diagnose-v5.php
```

The V5 upgrade script is additive and preserves existing V4 products, users, carts, orders and staff records.