v1.0.0
Setup Required
Go to Admin Panel → System Settings → AI Settings. Enter your Anthropic API key, enable the master switch, then toggle individual features. Switching the master off stops every feature that calls Claude. The database-only tools (Recommendations, Delivery ETA, Pricing Suggestions, Sales Forecasting, Fraud Alerts) need no API key. Recommendations has a switch that hides it on the storefront; the others have no switch of their own and are always available.

Phase 1 — Product AI Tools

AI tools integrated directly into admin and vendor product add/edit forms. Available on web panel and Flutter vendor/store apps.

AI Product Descriptions

Click "Generate with AI" next to the description field. Claude generates an SEO-optimized 80-150 word description from the product name, category, and price.

TriggerButton on product add/edit form
InputProduct name, category, price
OutputPlain text description (2-3 paragraphs)
Meta descriptionA second button next to the SEO meta description field runs the same generator and trims the result to 160 characters
API Key RequiredYes (Claude)
PlatformsAdmin Panel, Vendor Panel, Vendor App (v3), Store App (v4)

Auto-Categorization

Click "AI Suggest" next to the category dropdown. Claude analyzes the product name against all available categories and auto-selects the best match.

TriggerButton on product form, next to category
InputProduct name + category tree
Outputcategory_id + sub_category_id (auto-selects dropdowns)
API Key RequiredYes (Claude)
PlatformsAdmin Panel, Vendor Panel, Vendor App (v3), Store App (v4)

Auto Image Tagging

Click "AI Tags" in the SEO section after uploading a product thumbnail. Claude Vision analyzes the image and generates 5-10 relevant SEO keywords.

TriggerButton in SEO section of product form
InputProduct thumbnail image + name
OutputArray of SEO tags → populates meta fields
API Key RequiredYes (Claude Vision)
PlatformsAdmin Panel, Vendor Panel, Vendor App (v3), Store App (v4)

Phase 2 — Customer Experience

AI features that enhance the shopping experience for customers on the website and mobile app.

Shopping Assistant Chatbot

Floating chat widget on the storefront (bottom-left corner). Customers can search products, track orders, and get store info via natural conversation.

LocationWebsite — all 3 themes (Classic, Modern, Semi-Classic) — and the customer app, where a floating assistant button on the main screens opens the chat while the chatbot is switched on.
Intent Detectionproduct_search, order_tracking, store_info, greeting, general
Product SearchReturns product cards with images, prices, and links
Order TrackingShows order status, payment, amount, date — for a shopper signed in on the website
API Key RequiredYes (Claude)
API EndpointPOST /api/v1/ai/chatbot — answers as a guest, so order tracking is website-only

Review Summarization

AI generates a 2-3 sentence summary of all customer reviews, shown at the top of the Reviews tab. Cached for 24 hours, and cleared as soon as a review is added, edited, or hidden.

Minimum Reviews3 reviews required to generate summary
Cache Duration24 hours, refreshed on the next review change
DisplaySummary card above the individual reviews, on all 3 themes and in the customer app
API Key RequiredYes (Claude)
API EndpointGET /api/v1/ai/review-summary/{productId}

Background Removal

Product image background removal through the remove.bg API — a busy background is replaced with clean white. It ships as an endpoint and a setting: there is no button for it in the admin or vendor panel and none in the apps, so today it is reachable only from your own code.

Available inAPI only — no button in any panel or app yet
External APIremove.bg (API key required)
Max Image Size5MB
OutputPNG with white background
SetupEnter remove.bg API key in AI Settings

Phase 3 — Smart Commerce

Intelligent search and recommendation systems that boost discovery and conversions.

Smart NLP Search

A natural-language query — "blue cotton shirt under 500 for men" — is parsed by Claude into structured filters (keywords, price range, color, brand, category, sort order) and run against the catalogue. The parser ships as an endpoint: the theme search bars and the app's search screen still use the ordinary keyword search, so you reach it through the API or your own wiring.

Available inAPI only — not wired into the theme search bars or the app search screen
InputNatural language search query (max 200 chars)
Parsed Filterskeywords, min_price, max_price, color, brand, category, sort
PricesRead in your store's default currency — "under 500" means 500 of whatever the catalogue is priced in
Cache5 minutes per unique query
FallbackRegular keyword search if AI disabled
API Key RequiredYes (Claude)
API EndpointPOST /api/v1/ai/smart-search

Product Recommendations Engine

Four recommendation algorithms — all database-driven (no AI API calls).

Frequently Bought TogetherCo-purchase analysis from order history — product detail pages on all 3 themes, and the customer app
Similar ProductsSame category + similar price range — product detail pages on all 3 themes, and the customer app
Trending NowMost ordered products in the last 30 days — homepage on the Classic theme and in the customer app
PersonalizedBased on the customer's purchase history categories. It needs a signed-in shopper, so it is served by the website endpoint only; no theme places it on a page yet, and the app's request is unauthenticated and comes back as the last 14 days' trending products.
Cache60 minutes (frequently bought together), 30 minutes (trending, personalized); similar products is computed per request
API Key RequiredNo (database queries only)
API EndpointsGET /api/v1/ai/recommendations/fbt/{id}
GET /api/v1/ai/recommendations/similar/{id}
GET /api/v1/ai/recommendations/trending
GET /api/v1/ai/recommendations/personalized

Phase 4 — Business Intelligence

AI-powered pricing, delivery prediction, and discount optimization tools for smarter business decisions.

Smart Delivery ETA

Predicts delivery time from the store's own past deliveries, adjusted by haversine distance, vendor performance, and the day of the week. It is arithmetic on your order history, not a trained model.

Shown onProduct detail page on the Classic and Modern themes; on Semi-Classic only for a signed-in shopper with a saved address (it has no guest location prompt). The customer app shows it on product pages too. It is on unless Delivery ETA is switched off on the AI Settings page, and the storefront and the app both follow that switch.
Logged-in UsersUses saved shipping address (server-side, instant)
Guest UsersBrowser geolocation prompt (client-side AJAX)
Distance Factors<5km: 0.8x, <20km: 1.0x, <50km: 1.3x, <200km: 1.6x, >200km: 2.0x
Weekend FactorSaturday/Sunday: 1.15x slower
Display"1-2 Days (18.6 km away)" in green
API Key RequiredNo (historical data + math)
On/off switchNone — it has no toggle on the AI Settings page

Pricing Suggestions

Click "AI Price" on the admin Add Product form. Analyzes all products in the same category and returns median price, average, min/max range, and competitive range (P25-P75).

TriggerButton next to the unit price field on the admin Add Product form — it is not on the edit form or in the vendor panel
PlatformsAdmin Add Product form, Vendor App, Store App, and the API
OutputSuggested price, average, range, competitor count
Auto-fillFills unit price field if empty
API Key RequiredNo (database queries only)
On/off switchNone of its own — the button appears only while AI Product Descriptions is switched on

Discount Optimizer

Analyzes product metrics (views, sales, conversion rate, stock levels, days since last sale) and suggests an optimal discount percentage. Uses Claude API or falls back to rule-based engine.

Available inVendor App and Store App, and over the API — there is no button in the admin or vendor web panel
Metrics AnalyzedViews, sales, conversion %, stock, days listed, days since last sale
OutputSuggested discount (0-50%), reasoning, urgency level
FallbackRule-based engine if no API key
API Key RequiredOptional (works without, better with)
On/off switchNone — it has no toggle on the AI Settings page

Phase 5 — Advanced Features

Visual search, sales forecasting, and fraud detection for enterprise-grade intelligence.

Visual Search

A mobile-app feature: the shopper taps the scan icon in the customer app's search screen and picks a photo → Claude Vision identifies the product type, color, material, and style → the catalog is searched for matching products. There is no photo search on the website in any theme.

Available inCustomer app (scan icon in the search screen), and over the API
InputProduct photo (JPEG/PNG/WebP, max 5MB)
AI AnalysisProduct type, color, material, style, search query
OutputUp to 12 matching products
API Key RequiredYes (Claude Vision)
API EndpointPOST /api/v1/ai/visual-search

Sales Forecasting Dashboard

Admin page showing 7-day revenue and order predictions with growth trends, daily breakdown table, and low-stock alerts. Built from a trailing average of the last 30 days, a weekday pattern, and a damped growth rate.

LocationAdmin Panel → System Settings → Sales Forecast
PredictionsRevenue, orders, growth rate per day
Stock AlertsProducts predicted to run out within 7 days
Data SourceLast 30 days of order history
Cache30 minutes
API Key RequiredNo (historical data analysis)

Fraud Detection

Scores every order on 7 risk factors and flags suspicious orders for admin review. Accessible from Admin Panel sidebar; the page is always available to the admin.

LocationAdmin Panel → System Settings → Fraud Alerts
Risk Factors (7)New account + high value, multiple addresses, amount anomaly, unusual hours (2-5AM), guest + high value, rapid repeat orders, mismatched billing/shipping
Scoring0-100 score → Low (<25), Medium (25-49), High (50+)
Scan RangeLast 72 hours of orders
API Key RequiredNo (rule-based scoring)

API Reference

The AI features the mobile apps use are exposed over REST. The tables below list exactly what each app can call.

Customer App (v1) — /api/v1/ai/

MethodEndpointAuthPurpose
POST/ai/chatbotNoShopping assistant chat (answers as a guest — no order tracking)
GET/ai/review-summary/{productId}NoAI review digest
POST/ai/smart-searchNoNatural language search
POST/ai/visual-searchNoImage-based product search
GET/ai/recommendations/fbt/{id}NoFrequently bought together
GET/ai/recommendations/similar/{id}NoSimilar products
GET/ai/recommendations/trendingNoTrending products
GET/ai/recommendations/personalizedNoPersonalized picks
POST/ai/delivery-etaNoDelivery estimate for a location
These endpoints are open
The customer AI endpoints take no bearer token, so they always answer as a guest: the chatbot cannot look up orders and personalized picks fall back to the last 14 days' trending products. Order tracking in chat works on the website, where the shopper is signed in.

Which features the customer app shows

A feature switched off is refused with 403, so the app asks first: GET /api/v1/config carries ai_features — chatbot, delivery_eta, review_summary, smart_search and visual_search, each true or false. The app shows the assistant button, the delivery estimate, the review summary and the visual-search scan button only while theirs is on. A backend that sends no ai_features counts as everything on.

Vendor App (v3) — /api/v3/seller/ai/

MethodEndpointAuthPurpose
GET/ai/statusSellerGet AI feature toggles
POST/ai/generate-descriptionSellerGenerate product description
POST/ai/suggest-categorySellerAuto-categorize
POST/ai/generate-tagsSellerGenerate tags from image
POST/ai/suggest-pricingSellerCompetitive pricing
POST/ai/suggest-discountSellerDiscount recommendation

Store App (v4) — /api/v4/ai/

MethodEndpointAuthPurpose
GET/ai/statusNoGet AI feature toggles
POST/ai/generate-descriptionStoreGenerate product description
POST/ai/suggest-categoryStoreAuto-categorize
POST/ai/generate-tagsStoreGenerate tags from image
POST/ai/suggest-pricingStoreCompetitive pricing
POST/ai/suggest-discountStoreDiscount recommendation

AI Settings Configuration

SettingDefaultDescription
ai_features_enabledONMaster switch — off stops every feature that calls Claude
ai_anthropic_api_key—Claude API key from console.anthropic.com
ai_removebg_api_key—remove.bg API key (background removal only)
ai_product_descriptionONAI product descriptions (and the meta description button)
ai_auto_categorizationONAuto-categorization
ai_auto_taggingONAuto image tagging
ai_review_summaryONReview summarization
ai_background_removalOFFBackground removal
ai_chatbotONShopping assistant chatbot
ai_smart_searchONNLP smart search
ai_recommendationsONProduct recommendations (no API key needed)
ai_visual_searchONVisual search
ai_delivery_etaONSmart delivery ETA (on until switched off; no API key needed)
ai_fraud_detectionONListed on the settings screen; the Fraud Alerts page is available to the admin either way

A fresh install ships with the master switch and ten of the eleven features on, and Background Removal off — nothing calls Claude until you save an API key. Pricing Suggestions, the Discount Optimizer and Sales Forecasting have no switch on this screen; they read your own data and are always available.

Cost Estimation

FeatureAPI Calls/Day (Est.)Monthly Cost (Est.)
Product Descriptions (each meta description is a second call)10-50$2-10
Auto-Categorization10-50$1-5
Auto-Tagging (Vision)10-50$3-15
Review Summarization5-20$2-8
Chatbot50-500$10-100
Smart Search50-500$5-50
Visual Search (Vision)10-50$3-15
Discount Optimizer5-20$1-3
Recommendations—$0 (no API calls)
Delivery ETA—$0 (no API calls)
Sales Forecast—$0 (no API calls)
Fraud Detection—$0 (no API calls)
Total$27-206/month

Background Removal uses remove.bg API: $0.20/image (first 50 free/month).