Initial commit of Descrybe v2 without local scratch artifacts.

Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.
2026-08-09 22:47:43 +02:00
commit 8580c996c3
1285 changed files with 325780 additions and 0 deletions
@@ -0,0 +1,70 @@
+# Marketing Suite - user guide
+
+Seasonal email campaigns, brand voice, SEO tips, WooCommerce reviews/orders audiences, and the in-app tutorial for Descrybe v2.
+
+## Start the tutorial (1 click)
+
+1. Sign in and open **Dashboard**.
+2. Click **Start tutorial** (welcome card or header).
+3. Follow the highlighted controls — you must perform each action (no free Continue on action steps).
+4. Use **Resume tutorial** after Pause, or **Restart tutorial** after Skip / Done.
+
+Full step list: [tutorial.md](tutorial.md).
+
+## Black Friday campaign in 5 clicks
+
+Assumes you already have products in the catalog (map a feed or import first).
+
+1. Open **`/campaigns`** → Create campaign  
+   (or **`/marketing/calendar`** → Prepare Black Friday, then open Campaigns).
+2. Pick the **Black Friday** season template.
+3. Choose categories/products (or leave defaults for top catalog items). Optionally set audience to purchasers after syncing Woo orders.
+4. Click **Generate** (template mode is free; AI generate needs Starter+ / credits -- Free returns 402).
+5. **Send test** to yourself, then **Schedule** or **Send** once your email provider is verified under **`/integrations/email`**.
+
+### Optional: Content Calendar one-shot
+
+**`/marketing/calendar` → Prepare Black Friday** creates a seasonal export-feed bundle for the BF window. Then open **`/campaigns`** to draft the email.
+
+## Free vs paid
+
+| Action | Free | Paid (Starter+) |
+|--------|------|-----------------|
+| Create campaign drafts, pick seasons | Yes | Yes |
+| Template generate (no AI) | Yes | Yes |
+| AI campaign / SEO / brand AI | No (`can_use_ai=false`, 0 monthly credits) | Yes (credits / BYOK) |
+| Real email blast | Dry-run until upgrade + verified provider | Verified Resend/SMTP |
+| Brand kit form | Yes | Yes |
+| SEO recommendations (template fill) | Yes | AI fill on paid |
+| Woo orders/reviews sync | Yes (connection required) | Yes |
+
+Details: [free-tier.md](free-tier.md). Upgrade from **Pricing** / **Plans** when you hit an AI or send gate.
+
+## Brand kit
+
+**`/brand`** (nav: Marketing → Brand kit) — tone, do/don't, colors, preferred terms, logo URL, and **logo file upload** (`POST /api/brand/logo`). Product AI and campaign AI inject this voice when AI is enabled.
+
+## SEO
+
+**`/seo`** (nav: Marketing → SEO) — missing meta, thin/duplicate titles, weak images. Template apply on Free; AI fill on paid.
+
+## Orders, reviews and purchase audiences
+
+1. Connect the store under **`/woocommerce`** (Connection tab).
+2. Open the **Orders** tab → **Sync orders** (worker pulls Woo REST orders into `woo_orders` / `woo_order_items`).
+3. Open **Reviews** (`/woocommerce?tab=reviews`; nav `/reviews` redirects here) → **Sync reviews**.
+4. In a campaign (`/campaigns`), choose a purchase-based audience. On send, campaigns call `ResolveAudience` against synced orders.
+
+API: `POST /api/woocommerce/sync-orders`, `sync-reviews`; `GET /api/woocommerce/orders`, `reviews`; `POST /api/woocommerce/audience`.
+
+## Email provider
+
+**`/integrations/email`** (nav: Email sending) — Resend or SMTP, verify from-address/domain, then send tests. Free plans force dry-run for real blasts. See [email-sending.md](email-sending.md).
+
+## Related docs
+
+- [QA local demo](qa-local-demo.md) — login, Local Demo Co, uploads, nav status  
+- [Demo user](demo-user.md) — credentials + company counts  
+- [Marketing suite design](marketing-suite-design.md)  
+- [Free tier gates](free-tier.md)  
+- [Email sending](email-sending.md)