shoplazza/shoplazza

Use when an app developer needs to bill a Shoplazza merchant for app usage through the CLI — one-time application charges, recurring (subscription) charges, metered usage charges, and app-charge transaction records. Triggers include 应用收费 / 订阅费 / 一次性收费 / 用量费 / 计费 / app billing / recurring / one-time / usage charge. NOT buyer order payments or refunds (那是 shoplazza-orders 的 transactions / +refund).

Shared foundation for the shoplazza CLI: installing the CLI (安装 CLI / command not found), authentication (auth login — account-level and store-level; 登录 / 授权), auth status/scopes/logout, store switching (auth store use; 切换店铺 / 换店), multi-store profiles (add/list/use/rename/remove/info), the three access tiers (+shortcut / spec leaf / api rest), the output envelope ({ok,data} / .data), --dry-run / --jq / --fields / --format, schema introspection, api rest fallback, update notice, the safety protocol, and how to trust a filtered list read (pagination / has_more / cursor, silently-dropped filters, the exact-match precision ladder). Read this FIRST on first use of the shoplazza CLI, when the CLI is missing, when logging in / authorizing / switching store or profile, on permission errors, when a search or filter looks like it returned too much, and before using any domain skill.

Use when the user wants to manage customers (buyers) on a shoplazza store through the CLI — create a customer profile, find a customer by email or phone, get customer details or the total customer count, update names / tags / email or SMS marketing subscription, or manage a customer's shipping addresses including the default checkout address. Triggers include 客户 / 买家 / 顾客 / 客户资料 / 新建客户 / 按邮箱查客户 / 按手机号查客户 / 给客户打标签 / 退订营销 / 收货地址 / 默认地址 / customer profile / new customer / find customer by email or phone / customer count / tag a customer / unsubscribe marketing / shipping address / default address. Finding the customer RECORD by email (按邮箱找客户资料) belongs HERE (customers +search); that customer's ORDER HISTORY (该客户下过的订单 / orders placed by this email) belongs to shoplazza-orders.

Use when the user wants to manage discount activities on a shoplazza store through the CLI — promotional campaigns, coupon codes, flash sales, buy-X-get-Y offers, rebates / tiered satisfy-N-get-M discounts, free-shipping codes, M-for-N (Nth-item-off) discounts, discount stacking / combination rules, or coupon (voucher) campaigns. Triggers include 满减 / 折扣码 / 优惠码 / 闪购 / 满X减Y. NOT gift cards (redeemable store credit → shoplazza-products gift-cards). NOT showing a sale inside a theme card / 首页促销卡片 (→ shoplazza-themes).

Use when the user wants to manage a shoplazza store's orders through the CLI — searching / counting / viewing orders (查订单 / 找订单 / 订单列表 / 订单详情 / 新订单 / order search), shipping and fulfillment (发货 / 标记发货 / 物流 / 运单号 / 改运单号 / ship an order / update tracking), refunding a buyer (退款 / 给顾客退钱 / 退钱给买家 / refund an order — buyer refunds live HERE, not in discounts and not in billing), cancelling / creating / updating / marking orders paid (取消订单 / 代客下单 / 标记支付), an order's payment transactions (订单支付流水 / 支付交易记录 / buyer payment transactions — app-charge transactions → shoplazza-billing), fraud risk records (欺诈 / 风控 / 高风险订单 / order risk), after-sales records (售后 / post-sales), shipping zones and rates (运费区域 / 邮费 / 运费方案 / shipping zones — real-time rate carriers → shoplazza-shop carrier-services), and tracking-carrier lookup (快递承运商 / 运单号识别承运商). A customer's orders by email (按邮箱查某客户的订单) are searched HERE; the customer record itself → shoplazza-customers. NOT product stock / 库存 / 补货 (→ shoplazza-products).

Use when the user wants to manage a shoplazza store's product catalog through the CLI — creating / publishing / unpublishing products (建品 / 新建商品 / 上新 / 上架 / 下架), searching or counting the catalog (搜商品 / 找商品 / 商品数量 / how many products I sell), changing prices (改价 / 调价 / set price), adjusting stock (库存 / 补货 / 加库存 / 减库存 / inventory), product tags (标签), variants / SKUs (变体 / 规格), collections and collects (商品合集 / 商品分组), product images (商品图片 / 主图), gift cards (礼品卡 / 储值卡 — gift cards live HERE, not in discounts), customer product reviews (买家评价 / 评论 / product reviews), warehouse locations (仓库 / 库位), suppliers and procurement (供应商 / 采购单 / 进货). NOT discount codes / coupons / 优惠码 / 折扣码 / 满减 (→ shoplazza-discounts); NOT the store media library / file uploads / 媒体库文件 and NOT metafields / 元字段 (→ shoplazza-shop); NOT order fulfillment / 发货 (→ orders domain); NOT theme card images / 装修配图 / 商品详情页模板 (→ shoplazza-themes).

Store-level config & content for a shoplazza store — use for: shop info / settings (店铺信息 / 店铺设置 / 主域名 / 币种 / 客服邮箱 / customer email); sales & traffic analytics (销量 / 销售额 / 流量 / 流量渠道 / 搜索词 / 报表 / 数据分析 / analytics / PV UV / conversion / SKU 排行 / best-selling SKU); media library & file uploads (素材库 / 媒体库 / 上传文件 / upload file — store assets, NOT product images); metafields / 元字段 / 自定义字段 — ALL metafields live HERE, incl. ones ON products / orders / customers (给商品加字段); blogs & articles (博客 / 文章 / blog post); custom storefront pages (自定义页面 / 关于我们 / About Us / policy page); navigation menus (导航菜单 / 菜单项 / menu items); URL redirects (重定向 / 301 / URL 跳转); markets (市场 / 多市场 / 发布到日本市场); store languages (语言 / 多语言 / 翻译 / 开通日语); real-time rate carrier services (实时运费报价 / 承运商 / carrier service). NOT product catalog / 商品图片 (→ shoplazza-products); NOT 优惠码 (→ shoplazza-discounts); NOT order search / 订单统计 / 物流查询 (→ orders domain); NOT theme editing / 装修 / page templates (→ shoplazza-themes).

Store theme operations for a shoplazza store — use when the user works on the store's themes through the CLI: page & card editing (装修 / 改页面 / 改卡片 / 模块 / 板块 / 首页 banner / 轮播图 / 页头页尾 / 加卡片 / 隐藏卡片 / 调整顺序 / sections & blocks / edit the homepage); theme settings (主题设置 / 配色 / 字体 / 全局样式 / colors / fonts); app embeds (弹窗 / 公告栏 / app 开关 / app embed); custom templates (自定义模板 / 商品详情模板 / custom template); AI cards (生成卡片 / 自定义卡片 / 改卡片源码 / generate or edit a liquid block); installed themes & the market (主题列表 / 当前主题 / 主题市场 / 安装 / 改名 / 复制 / 删除 / 升级 / 发布主题 / 预览链接 / theme list, install, rename, duplicate, delete, upgrade, publish, preview); theme files, version history, page builder. NOT local theme development (themes init / serve / push / pull); NOT custom page / blog / menu content (自定义页面内容 / 博客 / 菜单 → shoplazza-shop); NOT product images (商品图片 → shoplazza-products); NOT creating a flash sale (→ shoplazza-discounts).

Use when an app developer needs to manage webhook subscriptions on a Shoplazza store through the CLI — subscribe to store events (order created, product updated, …) so the platform pushes notifications to an app's endpoint, and list / get / update / delete / count those subscriptions. Triggers include webhook / 事件订阅 / 事件回调 / 事件通知 / 推送通知 / 回调地址 / subscribe to an event / event notification. NOT the events themselves in shoplazza-orders / shoplazza-products — this domain owns the SUBSCRIPTION.