Veri modeli

Atlas’ta dört ana nesne vardır ve hepsi bir ağaç oluşturur. Bu ağacı anlamak, hem paneli hem API’yi anlamayı kolaylaştırır.

Çalışma alanı
└── Koleksiyon
    ├── Doküman
    └── Yayın (koleksiyonun dondurulmuş hâli)

Çalışma alanı

Faturalamanın, üyeliğin ve anahtarların kapsamıdır. Bir kullanıcı birden çok çalışma alanına üye olabilir; her üyelik kendi rolünü taşır.

Çalışma alanı kimlikleri wsp_ önekiyle başlar.

Koleksiyon

Aynı kenar çubuğunu paylaşan dokümanların kümesidir. Bir koleksiyonun kendi yolu, kendi görünürlüğü ve kendi yayın geçmişi vardır.

Tipik bir ayrım şöyle olur:

• /dokumanlar — son kullanıcı kılavuzları
• /api — geliştirici referansı
• /ic — yalnızca çalışma alanı üyelerine açık iç kaynaklar

Doküman

Bir Markdown dosyası ve onun ön bilgisidir. Ön bilgide en az şu alanlar bulunmalıdır:

---
title: Sayfanın başlığı
description: Arama sonuçlarında ve <meta> etiketinde görünen özet
group: baslangic
order: 2
---

order aynı grup içindeki sırayı belirler; küçük değer üstte görünür. Değer vermezseniz doküman grubun sonuna eklenir.

Yayın

Bir koleksiyonun belirli bir andaki kopyasıdır ve değiştirilemez. Yayınlar sürüm numarası alır, kim tarafından ve hangi mesajla alındığı saklanır. Eski bir yayına dönmek yeni bir yayın oluşturur — geçmiş hiçbir zaman silinmez.

Kimlikler

Tüm nesne kimlikleri önek taşır ve kısa, URL güvenli karakterlerden oluşur:

Nesne	Önek	Örnek
Çalışma alanı	wsp_	wsp_3Kd8
Koleksiyon	col_	col_82Kd
Doküman	doc_	doc_Ph21
Yayın	pub_	pub_44Qn
Kullanıcı	usr_	usr_9Fq2xK

Kimlikleri kendi tarafınızda saklarken uzunluk varsayımı yapmayın; önek sabittir ama gövdenin uzunluğu zamanla değişebilir.