Pazaryeri yayını
Bir persona'yı Moonborn pazaryerinde listele — moderasyon kapısı, atıflı fork soy ağacı (lineage), puanlama, isteğe bağlı ticaret (Stripe Connect, Enterprise).
Senin için işleyen bir persona paylaşılmaya değer. İki başarısızlık biçimi vardır:
- Kapısız yayın → pazaryeri düşük kaliteli, marka-dışı veya güvensiz yayınlarla dolar
- Soy ağacı (lineage) olmadan yayın → fork'lar kanonik çalışmayla bağını kaybeder; atıf (attribution) yok, denetim izi yok, iyileştirmeleri yukarı doğru takip yok
Moonborn pazaryeri küratörlü, fork-bilinçli bir yayın yüzeyidir: her yayın moderasyondan geçer, her fork soy ağacına bağlanır, isteğe bağlı ticaret katmanı Stripe Connect üzerindedir (Enterprise).
Bu kullanım senaryosu sana uyar mı?
- Bir persona'yı toplulukla paylaşmak istiyorsun (ücretsiz yayın)
- Pazaryerinden fork'lanan persona'ların kanonik çalışmana atfedilmesini istiyorsun
- (Enterprise) Persona'ları ücretli yayın olarak satmayı planlıyorsun
- Küratör rolü — çalışma alanı içinde persona kütüphanesi yönetiyorsun
Yapabileceklerin
- Yayınla — bir persona'yı yayın olarak gönder, lisans + isteğe bağlı fiyat
- Gözat — filtre (ücretsiz / ücretli / yeni / öne çıkan) + sırala (popüler / yeni / ilgi)
- Kur (install) — yayını çalışma alanına kur (kopyalar, indirme sayar)
- Fork — yayını lineage kenarıyla fork'la, atıf üstverisi otomatik
- Puanla — 1-5 yıldız + isteğe bağlı inceleme (kullanıcı başına bir puan, üst-üste-yaz / upsert)
- Bildir — kötüye kullanımı moderasyon kuyruğuna
- Koleksiyonlar — çalışma alanı kapsamlı yayın grupları (Pro ve üzeri)
Yayınlama akışı
const listing = await client.marketplace.listings.publish({
personaId: persona.id,
license: 'CC-BY-4.0',
priceCents: 0,
description: 'Brand voice for indie devtool startups...',
tags: ['brand-voice', 'startup', 'tech'],
});
console.log(listing.status); // "in_review"Her yeni yayın in_review'a düşer. Moderasyon kapısı (marketplace.moderation.auto_approve yapılandırması) karar verir:
published— herkese açıkunpublished— reddedildi (sebep yükte)in_review(devam) — elle inceleme için işaretli
Varsayılan elle inceleme; SLA marketplace.moderation.review_sla_hours (varsayılan 24 saat).
Fork ile atıf (attribution)
Bir yayın fork'landığında Moonborn:
- Persona'yı fork'layan çalışma alanına kopyalar
- Yeni persona'nın
parent_persona_id= kaynak - Soy ağacına kenar yazar
marketplace.fork.attribution_requiredaçıksa (varsayılan) yeni persona'yameta.attribution = { sourceCreator, sourcePersonaId }ekler- Kaynak yayının
forkssayacı artar - Denetim kaydına
marketplace.listing.forkedolayı (değiştirilemez)
Bu desen Marka sesi varyantları akışıyla eşleşir — herkese açık kanonik persona → aşağı akıştaki çalışma alanlarının marka-kilitli varyantları.
Ticaret (Stripe Connect, Enterprise)
Ticaret katmanı marketplace.commerce.enabled ile kapı altındadır (varsayılan kapalı), Stripe Connect Express'e bağlıdır:
- Yaratıcı ilk-kurulumu (creator onboarding) —
OnboardCreatorUseCase;charge_enabled+payouts_enabledbayrakları - Gelir paylaşımı —
marketplace.commerce.revenue_share(varsayılan0.7— %70 yaratıcı, %30 platform) - Ödeme eşiği —
marketplace.commerce.payout_min_usd(varsayılan$50) - Stripe Tax — KDV, GST, ABD satış vergisi otomatik
- Mutabakat (reconciliation) cron'u — her saat
usage_events↔ Stripe defteri karşılaştır; iç defter ile Stripe asla kaymaz
Ticaret katmanı yalnızca Enterprise + Stripe Connect anlaşması yerinde olduğunda organizasyon başına açılır.
API uç noktaları
| Yöntem | Yol | Amaç |
|---|---|---|
GET | /v1/marketplace/listings | Keşif (filtre, arama, sıralama) |
POST | /v1/marketplace/listings/publish | İncelemeye gönder |
POST | /v1/marketplace/listings/{id}/install | Çalışma alanına kur |
POST | /v1/marketplace/listings/{id}/fork | Soy kenarıyla fork |
POST | /v1/marketplace/listings/{id}/review | Puan + inceleme |
POST | /v1/marketplace/listings/{id}/report | Kötüye kullanım bildirimi |
GET | /v1/marketplace/collections | Küratörlü koleksiyonlar |
GET | /v1/marketplace/publishable | Yayına uygun persona'lar |
Plan gereksinimi
| Yetenek | Free | Pro | Team | Enterprise |
|---|---|---|---|---|
| Gözat + kur + fork + puanla | ✓ | ✓ | ✓ | ✓ |
| Yayınla (ücretsiz yayın) | — | ✓ | ✓ | ✓ |
| Koleksiyonlar | — | ✓ | ✓ | ✓ |
| Ticaret (ücretli yayın) | — | — | — | ✓ |