descrybe/docs/e2e-marketing.md

E2E marketing suite (Descrybe v2)

Date: 2026-08-04
App: API http://127.0.0.1:8080 + worker (OPENAI_* from root .env//integrations/ai``) + web :5174
LLM: Green Chat overloaded-local at http://192.168.50.181:8767/v1 (used when OPENAI_* is set)
Tenant: demo@descrybe.local / DemoPass123! → Local Demo Co (Enterprise, ~1M AI credits, can_use_ai=true)

No secrets are recorded here (OPENAI key length only: 64). Cookie jar used locally: artifacts/e2e-marketing-cookies.txt / session WebRequest (gitignored / local only). Results snapshot: artifacts/e2e-marketing-matrix.json.

Scope

Area	What is exercised
Brand kit	PUT/GET /api/brand — tone, dos/donts, preferred terms, formula tips
SEO AI	GET /api/seo/recommendations, POST /api/seo/apply with mode=ai
Campaigns AI	POST /api/campaigns → POST /api/campaigns/{id}/generate mode=ai (+ template control)
Email dry-run	Configure provider if needed; POST /api/email/send with force_dry_run=true; campaign POST .../send with dry_run=true
Content calendar	GET /api/marketing/calendar, POST /api/marketing/calendar/prepare
Green Chat	TCP + GET {OPENAI_BASE_URL}/models before AI steps

If OPENAI_* is unset or Green Chat is unreachable, AI steps are SKIP; template campaign generate and brand/email dry-run still run.

Results (this run)

Step	Result	Notes
Green Chat reachability	PASS	OPENAI_BASE_URL=http://192.168.50.181:8767/v1, model overloaded-local, /v1/models OK
Login	PASS	Local Demo Co, Enterprise, remaining ≈ 999996, can_use_ai=true
Brand kit PUT+GET	PASS	Tips include tone, preferred terms (wireless,premium), donts
Brand kit in AI prompts	PASS	Brand terms present in SEO + campaign copy
Sample product	PASS	d2c309ed-… Sample Gadget
SEO apply mode=ai	PASS	~1s; title Sample Gadget | Premium Wireless Performance; credits_charged=2
SEO recommendations	PASS	Report with recommendations / overall score
Campaign generate mode=ai	PASS	~7s; status=ready, generation_mode=ai, unsubscribe footer present
Campaign generate mode=template	PASS	Black Friday subject filled without LLM
Email integration GET	PASS	Was unconfigured before stub SMTP
Email provider configure (SMTP stub)	PASS	Local stub so dry-run path can load transport
Email send force_dry_run	PASS	dry_run=true, reason force_dry_run, result status dry_run
Campaign send dry_run	PASS	Blast path with dry_run=true (no delivery)
Marketing calendar prepare	PASS	preset_id=black_friday → export feed “Black Friday 2026”

Overall: PASS against LAN Green Chat.

Failure fixed during this run

Issue	Cause	Fix
Calendar prepare 404	Wrong path /api/marketing/prepare	Use POST /api/marketing/calendar/prepare with body { "preset_id": "black_friday", "format": "csv" }

Notes (not failures)

• POST /api/integrations/email/test against the stub SMTP (127.0.0.1:2525) returns failed / send failed when not dry-running — expected. Prefer force_dry_run on /api/email/send or set EMAIL_DRY_RUN=true and restart API.
• Credits live under GET /api/auth/me → credits and the session billing routes GET /api/billing/credits, GET /api/billing/usage, GET /api/billing/plans (same tenant session + company context).

Prerequisites

1. Postgres up (make up / docker compose on :5433).
2. API + worker running with env loaded from root .env//integrations/ai`` (must include OPENAI_BASE_URL, OPENAI_API_KEY, OPENAI_MODEL for AI).
3. Web optional for UI; this suite is API/session E2E.
4. Demo user seeded (make seed / seed-demo).
5. Green Chat listening on LAN (Test-NetConnection 192.168.50.181 -Port 8767).

Commands (PowerShell)

$base = "http://127.0.0.1:8080"
$session = New-Object Microsoft.PowerShell.Commands.WebRequestSession
try { Invoke-WebRequest "$base/api/auth/me" -WebSession $session -UseBasicParsing | Out-Null } catch {}
$csrf = ($session.Cookies.GetCookies($base) | Where-Object Name -eq descrybe_csrf).Value
$login = '{"email":"demo@descrybe.local","password":"DemoPass123!"}'
Invoke-WebRequest "$base/api/auth/login" -Method POST -WebSession $session `
  -Headers @{ "X-CSRF-Token" = $csrf; "Content-Type" = "application/json" } -Body $login -UseBasicParsing | Out-Null
$csrf = ($session.Cookies.GetCookies($base) | Where-Object Name -eq descrybe_csrf).Value

function ApiJson($method, $path, $obj) {
  Invoke-RestMethod "$base$path" -Method $method -WebSession $session -TimeoutSec 120 `
    -Headers @{ "X-CSRF-Token" = $csrf; "Content-Type" = "application/json" } `
    -Body ($obj | ConvertTo-Json -Depth 8 -Compress)
}

# Brand kit
ApiJson PUT /api/brand @{
  voice_tone = "confident concise"
  dos = @("Lead with benefit")
  donts = @("No hype")
  preferred_terms = @("wireless","premium")
}

# SEO AI
ApiJson POST /api/seo/apply @{
  product_id = "d2c309ed-fa99-4785-aa72-4f7d180f1f85"
  mode = "ai"
}

# Campaign AI
$c = ApiJson POST /api/campaigns @{
  name = "E2E Spring"
  template_key = "spring"
  use_default_prompt = $true
}
ApiJson POST "/api/campaigns/$($c.id)/generate" @{ mode = "ai" }

# Email dry-run (configure stub SMTP first if configured=false)
ApiJson PUT /api/integrations/email @{
  provider = "smtp"
  from_email = "noreply@descrybe.local"
  from_name = "Descrybe E2E"
  domain = "descrybe.local"
  smtp_host = "127.0.0.1"
  smtp_port = "2525"
  smtp_user = "e2e"
  smtp_password = "e2e-not-used"
  is_enabled = $true
}
ApiJson POST /api/email/send @{
  to = @("demo@descrybe.local")
  subject = "E2E dry-run"
  text = "Should not deliver"
  mode = "test"
  force_dry_run = $true
}
ApiJson POST "/api/campaigns/$($c.id)/send" @{
  confirm = $true
  recipients = @("demo@descrybe.local")
  dry_run = $true
}

# Content calendar
Invoke-RestMethod "$base/api/marketing/calendar" -WebSession $session
ApiJson POST /api/marketing/calendar/prepare @{
  preset_id = "black_friday"
  format = "csv"
}

Green Chat probe (no app session):

# Load OPENAI_* from root `.env` / `/integrations/ai` — do not print the key
Test-NetConnection 192.168.50.181 -Port 8767
curl.exe -sS -H "Authorization: Bearer $env:OPENAI_API_KEY" http://192.168.50.181:8767/v1/models

Related

• ai-full-smoke.md — broader AI smoke (enhance / EPREL)
• green-chat-smoke.md — LAN Green Chat connectivity
• green-chat-llm.md — OPENAI_* wiring
• email-sending.md — providers, EMAIL_DRY_RUN, blast confirm
• marketing-suite-user-guide.md — UI flows
• demo-user.md — demo credentials