Scout
wiki/ux/workflows/products-and-algolia.md
Products And Algolia Prep Workflow
User Intent
Collect product records from a category or product URL, preserve source evidence, and prepare Algolia-ready JSON/JSONL without persisting Algolia credentials.
Required Inputs
- Product/category URL or domain.
- Execution mode, default
auto. - Working directory.
- Crawl settings: max depth, robots.txt behavior, delay.
- Optional product/category limits.
- Optional Algolia App ID, API key, and index name for readiness preview only.
Run States
- Setup: checklist confirms use case, URL, workdir, crawl settings, and mode.
- Live Execution: timeline shows queued, discovery, rendering/browser, extraction, enrichment, artifacts, and complete/blocked/failed.
- Results Review: metrics show pages processed, product records, unique SKUs, blocked pages, and warnings.
Result Tabs
- Overview: run summary, listing records found, detail pages blocked, readiness.
- Browser: captured screenshot/DOM/markdown when available.
- Records: product table, filters, columns, download, selected record drawer.
- Sources: source registry with listing/detail/browser/blocked badges.
- Blocked: blocked URLs, reasons, attempted providers, fallback result.
- Artifacts: manifest, records JSON/JSONL, sources, blocked pages, report.
- Logs: timestamped execution events.
Right Drawer
Selecting a product opens name, brand, price, SKU, image URL, product URL, completeness, missing fields, citations, source snippets, and blocked detail evidence if enrichment failed.
Empty, Error, And Blocked States
- Zero records plus zero blocked evidence is a failure.
- Listing records with blocked detail pages is a partial success.
- Estée Lauder can pass with listing records or complete blocked/fallback evidence.
- API keys must never appear outside the password input/session payload.
Expected Artifacts
manifest.json, records.json, records.jsonl, source_pages.json,
blocked_pages.json, validation.json, extraction_report.md, and optional
Algolia preview output.
Controls
Start Execution, Cancel Run, Clear Run, Browse folder, Crawl Settings chips, Developer Details, tabs, record select, filters, columns, download, Algolia preview, copy object IDs, artifact links, and citation context.