openqa-cn Distribution data-build slot
Vendor-neutral distributor slot. Drop-in under pack slots/ (already discovered).slot.yaml scene ready-to-sell is create distributor → bind inventory → set commission.
Executors talk to DATA_BUILD_API_BASE (default local mock on port 8765). The case pipeline binds from slot.yaml when the match is unique.
Single-step routing
| User intent | Executor |
|---|---|
| Create distributor | scripts/executors/create_distributor.ts |
| Bind supply / inventory | scripts/executors/bind_inventory.ts |
| Set commission | scripts/executors/set_commission.ts |
| Browse and quote | scripts/executors/browse_and_quote.ts |
node scripts/executors/create_distributor.ts --json '{"name":"North Channel"}'
Scene: ready-to-sell
This scene depends on a catalog product (another domain's material). If productId is not in context and the catalog slot cannot produce one, ask the user for that product material (reuse an id, or construct via catalog first). Then continue bind → commission. Do not skip those steps.
- Create distributor →
distributorId - Bind
productId - Set commission rate
- Return distributor, binding, and commission
Optional fields (rate, region) use executor defaults. Do not invent distributorId / productId when the user already supplied them.
Guardrails
- Start
node ../mock_server.tsif no enterprise gateway is configured - Do not invent
distributorId/productId - Defaults:
region=domestic,rate=0.1 - See references/tools-guide.md and ../SLOT_SPEC.md