Moonborn — Developers

Marketplace yayınlama

Bir personayı Moonborn marketplace'inde yayına-öncesi moderasyon, atıflı fork lineage, puanlamalar ve Stripe Connect üzerinden opsiyonel ticaret katmanıyla listele. Free workspace'ler tarayabilir ve fork'layabilir; yayınlama Pro'dan başlar.

Problem

Senin için işleyen bir persona paylaşılmaya değer. İki başarısızlık modu var:

Geçitsiz yayınla ve marketplace düşük kaliteli, marka-dışı veya güvensiz listing'lerle dolar.
Lineage'siz yayınla ve fork'lar kanonik çalışmayla bağlantısını kaybeder — atıf yok, audit izi yok, iyileştirmeleri yukarı doğru takip edecek yol yok.

Moonborn'un marketplace'i küratörlü, fork-bilinçli bir listing yüzeyidir: her yayın moderasyondan geçer, her fork lineage grafiğine bağlanır ve opsiyonel ticaret katmanı Stripe Connect üzerinde çalışır.

Yapabileceklerin

Bir personayı bir listing olarak yayınla — bir lisans ve (opsiyonel) fiyat ile.
Filtreyle (tümü / ücretsiz / ücretli / yeni / editör seçimi) ve sıralamayla (popüler / yeni / öne çıkan / semantik) tara.
Bir listing'i workspace'ine kur — personayı kopyalar, listing'in indirme sayacını artırır.
Bir listing'i fork'la — personayı parent_persona_id ayarlanmış olarak kopyalar, atıf meta verisi iliştirir ve lineage kenarı eklenir.
Bir listing'i puanla (1–5 yıldız, opsiyonel yorum) — kullanıcı başına tek puan, yeniden puanlamada upsert.
Kötüye kullanımı bildir — moderasyon kuyruğuna düşer.
Koleksiyonları düzenle — workspace kapsamlı listing gruplandırmaları.

Yayınlama nasıl çalışır

const listing = await client.marketplace.listings.publish({
 personaId: persona.id,
 license: 'CC-BY-4.0',
 priceCents: 0,
});
// listing.status === 'in_review'

Her yeni listing in_review durumuna girer. marketplace.moderation.auto_approve üzerinden otomatik onay veya insan denetimi olarak yapılandırılabilen bir moderasyon geçidi published, unpublished (reddedildi) veya in_review'da tutulması (daha derin inceleme için işaretlendi) arasında karar verir. Varsayılan politika insan incelemesinden geçer, hedef SLA marketplace.moderation.review_sla_hours ile yapılandırılır.

Listing entity'si şunları taşır:

{
 id, personaId, orgId,
 license, priceCents, currency,
 status: 'draft' | 'in_review' | 'published' | 'unpublished' | 'removed',
 featured, ratingsAvg, ratingsCount,
 downloads, forks,
 publishedAtMs, removedAtMs,
}

Fork sırasında lineage

Bir listing fork'landığında, Moonborn:

Personayı fork'layan workspace'e kopyalar.
Yeni personanın parent_persona_id alanını kaynak personaya ayarlar.
Fork grafiğine bir persona_lineage kenarı yazar.
marketplace.fork.attribution_required açıksa (varsayılan), yeni personanın meta verisini meta.attribution = { sourcePersonaId, sourceCreator } ile zenginleştirir.
Kaynak listing'in forks sayacını artırır.
Audit log'a değişmez bir marketplace.listing.forked satırı yazar.

Bunu, downstream ekiplerin atıf zincirini kaybetmeden kendi marka-kilitli varyantlarına fork'layabileceği kamuya açık bir kanonik persona istediğinizde Marka ses varyantları akışıyla eşleştirin.

Ticaret (opsiyonel, Stripe Connect)

Ticaret katmanı marketplace.commerce.enabled ile geçit altındadır (varsayılan kapalı) ve Stripe Connect Express'e bağlanır:

Yaratıcılar OnboardCreatorUseCase ile onboard olur; ücret tahsilatı ve ödemeler, Stripe'ın charges_enabled ve payouts_enabled bayraklarına bağlıdır.
Gelir paylaşımı marketplace.commerce.revenue_share ile ayarlanır (varsayılan 0.7 — %70 yaratıcı, %30 platform).
Yaratıcının bekleyen bakiyesi marketplace.commerce.payout_min_usd eşiğini (varsayılan $50) geçtiğinde ödeme RequestPayoutUseCase üzerinden tetiklenir.
Stripe Tax KDV, GST ve ABD satış vergisini otomatik halleder.
Bir mutabakat cron'u her saat usage_events ile Stripe kayıtlarını denetler; iç defter ve Stripe asla kaymaz.

Endpoint'ler

Yöntem	Yol	Amaç
`GET`	`/api/marketplace/listings`	Keşfet (filtre, sorgu, sıralama, limit)
`POST`	`/api/marketplace/listings/publish`	İncelemeye gönder
`POST`	`/api/marketplace/listings/{id}/install`	Workspace'e ekle
`POST`	`/api/marketplace/listings/{id}/fork`	Lineage ile fork'la
`POST`	`/api/marketplace/listings/{id}/review`	Puanla (1–5) + opsiyonel yorum
`POST`	`/api/marketplace/listings/{id}/report`	Kötüye kullanım bildir
`GET`	`/api/marketplace/collections`	Küratörlü koleksiyonları tara
`GET`	`/api/marketplace/publishable`	Yayınlamaya uygun personaları listele

Tarife

Yetenek	Free	Pro	Team	Enterprise
Tara, fork'la, puanla, yorumla	✓	✓	✓	✓
Yayınla	—	✓	✓	✓
Koleksiyonlar	—	✓	✓	✓
Ticaret (ücretli listing'ler)	—	—	—	✓

Ticaret katmanı şu anda yalnızca Enterprise'da ve sistem config seviyesinde varsayılan olarak kapalı başlar — bir Stripe Connect anlaşması yerinde olduğunda organizasyon başına açın.

Dürüst kapsam

Moonborn'un marketplace'i bir üçüncü-taraf storefront platformu değildir — gömülü storefront yok, yaratıcı-katman abonelik yeniden satışı yok, NFT veya blockchain katmanı yok. Doğrudan yaratıcı-tüketici mesajlaşma ve native bir Slack persona bot da açıkça kapsam dışındadır; webhook'lar entegrasyon yolu olarak kalır.

Sıradaki

Lineage kavramına giriş: Marka ses varyantları.
Endpoint referansı: API reference.