Veri modeli

Temel varlıkları, proje sınırını ve kimliklerin anlamını öğrenin.

Son güncelleme: 2026-11-10

Bu sayfada

Kurum ve proje Ana varlıklar Geometri ve öznitelikler Kimlikler Silme ve geçmiş

Kurum ve proje

orgs kurumları, projects ise kurumların projelerini tutar. Kullanıcı kurumla ilişkilidir; süper yönetici kurumdan bağımsızdır. Harita ve teknik kayıtlar project_id taşır. Proje erişimi çerezli API’de oturum, v1 ve OGC’de erişim anahtarının sahibi üzerinden denetlenir. Kurumla paylaşılan proje ile üyelik gerektiren proje ayrıdır; üye rolü ve bölge izni yazma kapsamını daraltabilir.

Entegrasyonlarda veritabanına doğrudan yazmak yerine API kullanın. Tür, bağlantı, sürüm, lisans, kota ve geçmiş kuralları API yazma akışında birlikte uygulanır.

Ana varlıklar

Varlık	Anlam ve temel alanlar
`features`	Haritadaki fiziksel nesne; `id`, `project_id`, `type`, `geom`, `props`, `version`, `deleted`
`ref_layers`	İçe aktarılan referans katmanı; ad, görünüm ve sıralama
`equipment`	Düğüm içindeki cihaz; `node_id`, `kind`, `parent_id`, `props`, `version`
`connections`	Düğümde iki lif/port ucunu birleştiren teknik bağlantı; `node_id`, `a`, `b`, `location_id`, `slot`
`relations`	Yerleşim ve güzergâh bağı; `kind`, `child_id`, `parent_id`, `seq`, `via_id`, `via_no`
`talep_items`	Bina planı, birim, uç, politika ve aktarım kaynak kayıtları
`fiber_items`	Kıl tahsisi, rezerv ve ilgili kural kayıtları
`circuits`	Teknik devre; çapalar, kayıtlı yol ve isteğe bağlı uç bağı
`optik_items`	Optik profil, seçim, dondurulmuş hesap ve ölçüm kayıtları
`changes`	Kayıtların önce/sonra değerleri, işlem, kullanıcı, varsa anahtar kimliği ve `batch` bilgisi
`project_members`	Proje üyeliği, proje rolü ve bölge/modül kapsamı
`tasarimlar`, `tasarim_eslem`, `tasarim_olaylar`	Tasarım dalı, kimlik eşlemesi ve inceleme/yayın olayları
`is_paketleri`	İş paketi ve yapım sonrası teslim akışı
`ekler`	Saha notu, fotoğraf ve belge hedefi ile dosya üst verisi
`saha_paketleri`, `saha_islemler`	Çevrimdışı paket kapsamı, gönderilen işlemler ve inceleme durumu
`kaynaklar`, `kaynak_satirlari`	Yeniden aktarımın kaynak ailesi ve kabul edilmiş tabanı
`erisim_anahtarlari`	Entegrasyon kapsamı ve anahtar özeti; tam sır tutulmaz
`webhooklar`, `webhook_olaylar`, `webhook_teslimler`	Abonelik, işlem içi olay kaydı ve kalıcı teslim kuyruğu

equipment.parent_id cihazın mekanik yerleşim ebeveynidir. connections.location_id ekin bulunduğu kaseti, slot kasetteki yuvayı belirtir. Bunlar connections.a ve connections.b ile tanımlanan optik bağlantının yerine geçmez.

relations.kind=icinde kapsayan saha yapısını; guzergah güzergâh segmentini; giris adres girişinin bina bağını ifade eder. Güzergâh sırası seq, geçilen boru via_id, alt boru numarası via_no ile saklanır.

Geometri ve öznitelikler

Geometriler EPSG:4326 sisteminde, GeoJSON’da [boylam, enlem] sırasıyla okunur ve yazılır. Genel düzenleme iki boyutlu geometri saklar. OGC yayını seçilen koordinat sisteminin eksen sırasını kullanabilir; Content-Crs başlığını esas alın. Projeye farklı koordinat sistemi seçmek depodaki koordinat sistemini değiştirmez; dönüşüm aktarım ve çıktı sırasında yapılır.

GeoJSON nesnesinin öznitelikleri properties altındadır. Genel düzenleme isteğinde bunların düzenlenebilir kısmı props alanında gönderilir. Sunucunun döndürdüğü properties.id, properties.type ve properties.v alanlarını serbest öznitelik gibi yazmayın.

Kablo başlangıç ve bitiş düğümleri props.from ve props.to ile belirtilir. Yalnız haritada çizgilerin kesişmesi teknik bağlantı oluşturmaz.

Kimlikler

Kurum, kullanıcı, proje ve referans katmanı kimlikleri sayısaldır. Harita nesnesi, cihaz ve teknik bağlantı kimlikleri metindir. Sunucu tür öneki ve sıra numarası üretir; örneğin fiber kabloda KB-, binada BN-, ek kutusunda EK-, ODF’de ODF-, bağlantıda C-, ilişkide IL- önekleri kullanılır.

Kimlikleri ayrıştırarak yetki, sıralama veya varlık durumu çıkarmayın. API’nin döndürdüğü değeri bütün halinde saklayın. Oluşturmada verilen geçici id, kalıcı kimliği belirlemez; yanıttaki tmp eşlemesini kullanın. Paket geri yükleme yeni kimlikler üretir.

Silme ve geçmiş

Genel düzenleme, temel varlıklarda deleted işareti ve sürüm artışı kullanır. Bağımlı kayıtlar aynı işlemde değişebilir veya silinebilir. Geçmişteki before ve after alanları, işlem öncesini ve sonrasını taşır. batch, birlikte uygulanan değişiklikleri bir araya getirir.

Proje paketi etkin proje verisini taşır; bütün kullanıcıları, oturumları ve geçmiş tablolarını kapsayan veritabanı yedeği değildir. Bkz. Proje paketi.