KoderKoder.ai
FiyatlandırmaKurumsalEğitimYatırımcılar için
Giriş YapBaşla

Ürün

FiyatlandırmaKurumsalYatırımcılar için

Kaynaklar

Bize UlaşınDestekEğitimBlog

Yasal

Gizlilik PolitikasıKullanım KoşullarıGüvenlikKabul Edilebilir Kullanım PolitikasıKötüye Kullanımı Bildir

Sosyal

LinkedInTwitter
Koder.ai
Dil

© 2026 Koder.ai. Tüm hakları saklıdır.

Ana Sayfa›Blog›Bilgi Tabanları ve SOP'lar için Web Uygulaması Nasıl Oluşturulur
26 Ağu 2025·8 dk

Bilgi Tabanları ve SOP'lar için Web Uygulaması Nasıl Oluşturulur

Roller, iş akışları, versiyonlama, arama ve güvenlik içeren dahili bilgi tabanları ve SOP'ları yönetmek için bir web uygulamasını nasıl planlayacağınızı, tasarlayacağınızı ve oluşturacağınızı öğrenin.

Bilgi Tabanları ve SOP'lar için Web Uygulaması Nasıl Oluşturulur

Hedefler ve kullanıcı ihtiyaçlarıyla başlayın

Ekran taslakları çizmeden veya teknoloji yığını seçmeden önce, bu uygulamanın günlük olarak kimlere hizmet ettiğini netleştirin. Bilgi tabanı ve SOP araçları çoğunlukla kod kalitesinden değil, insanların çalışma biçimine uymadıkları için başarısız olur.

Birincil kullanıcılarınızı belirleyin

Farklı gruplar farklı deneyimler ister:

  • Operasyon ekipleri ve saha personeli iş başında hızlı cevaplara ihtiyaç duyar (kontrol listeleri, “ne yapmalı…” adımları, mobil uyumlu görünümler).
  • Yöneticiler ve takım liderleri tutarlılık, görünürlük ve prosedürlerin takip edildiğine güven ister.
  • Yeni işe girenler rehberli öğrenme yolları, sade dil ve bağlam ister—sadece bir belge duvarı değil.

Kurumunuzda “bilgi tabanı” ile “SOP” arasındaki farkı tanımlayın

Kendi tanımlarınızı kullanın, ancak herkesin aynı hedefe yönelmesi için bunları yazılı hale getirin. Pratik bir ayrım:

  • Bilgi tabanı: referans materyali (politika, SSS, sorun giderme notları, nasıl yapılır rehberleri).
  • SOP'lar: açık sahipliği, zorunlu adımları olan, versiyonlanan "gerçek kaynak" niteliğinde tekrarlanabilir prosedürler.

Önceliklendireceğiniz sorunları listeleyin

Ölçebileceğiniz acıları önceleyin:

  • İnsanlar doğru dokümanı hızlıca bulamıyor.
  • İçerik güncel değil veya çoğaltılmış.
  • Değişiklikler onay gerektiriyor ama süreç belirsiz.

İzleyebileceğiniz başarı metriklerini belirleyin

Lansmandan sonra doğrulayabileceğiniz birkaç basit metrik seçin:

  • Doğru cevabı bulma süresi (ör. medyan 30 saniyenin altında)
  • Daha az önlenebilir hata veya eski talimatlara bağlı yeniden iş
  • Benimseme: haftalık aktif kullanıcılar, kullanıcı başına arama sayısı veya güncelleme yapan ekip yüzdesi

Bu hedefler sınırlandırma, gezinme ve iş akışları gibi sonraki kararlara rehberlik eder ve aşırı yapı kurmanızı engeller.

Gereksinimleri ve içerik modelini tanımlayın

Araçları seçmeden veya ekranları çizmeye başlamadan önce, bilgi tabanınızın ne depolaması gerektiği ve nasıl davranması gerektiği konusunda net olun. Açık bir gereksinimler listesi “wiki yayılımını” önler ve onay gibi iş akışlarını daha sonra uygulamayı kolaylaştırır.

İçerik tipleri ile başlayın

İlk günden hangi doküman tiplerini destekleyeceğinize karar verin. Yaygın tercihler: SOP'lar, politikalar, nasıl yapılır rehberleri, şablonlar ve duyurular. Her tipin farklı alanları ve kuralları olabilir—örneğin SOP'lar genelde duyurulardan daha katı onaylar gerektirir.

Temel alanları (içerik modelinizi) tanımlayın

En azından her belgenin taşıyacağı meta verileri standartlaştırın:

  • Başlık (insan dostu, aranabilir)
  • Sahip (doğrulukla ilgili sorumlu kişi veya ekip)
  • Son güncelleme (tarih + değişikliği yapan)
  • Statü (yayın kuralları için kullanılır)
  • Etiketler (filtreleme ve gruplayma için)

Ayrıca “doküman”ın ne olduğu kararını verin: zengin metin, markdown, ekli dosyalar veya karışık bir yapı.

Doküman yaşam döngüsü kuralları

Durumları ve her birinin ne anlama geldiğini yazın. Pratik bir varsayılan:

Taslak → İnceleme → Onaylandı → Arşivlendi

Her geçiş için kim ilerletebilir, yorum gerekip gerekmediği ve görünürlüğün ne olacağı gibi kuralları tanımlayın (ör. yalnızca Onaylandı içerik herkes tarafından görülebilir).

Önemli fonksiyonel olmayan gereksinimler

Erken kısıtlamaları yakalayın ki daha sonra yeniden tasarlamak zorunda kalmayın:

  • Performans (büyük dokümanlar ve arama için hızlı yükleme)
  • Erişilebilirlik (WCAG-dostu gezinme ve editör)
  • Kullanılabilirlik ve yedekler (beklenen çalışma süresi ve yedeklemeler)

Bu girdileri toplamak için basit bir çalışma sayfası istiyorsanız, dahili bir sayfa oluşturun: /docs/requirements-template

Yapıyı planlayın: alanlar, kategoriler, etiketler ve şablonlar

Bir bilgi tabanı yapısı üzerine kurulur. İnsanlar bir şeyin nerede olduğunu tahmin edemezse sisteme güvenmeyi bırakır ve dokümanları “başka bir yerde” saklamaya başlar. Şirketin gerçek işleyişini yansıtan bir bilgi mimarisine yatırım yapın.

Alanlar/ekipler, kategoriler ve koleksiyonlar

Sahipliği açık şekilde gösteren alanlarla (spaces) başlayın (örn. People Ops, Support, Engineering, Security). Her alan içinde kalıcı gruplamalar için kategoriler kullanın (Politikalar, Onboarding, Araçlar, Süreçler). Ekipler arası işleri kapsayan içerikler için çoğaltma yerine koleksiyonlar (seçilmiş merkezler) oluşturun.

Basit bir kural: bir yeni çalışan “bunu kim yönetiyor?” diye sorduğunda cevap alan sahibi olmalı.

SOP şablonları ve adlandırma kuralları

SOP'ları standartlaştırın ki okunması ve hissi tutarlı olsun:

  • Adlandırma: Fiil + nesne + bağlam (örn. “Müşteri iadeleri işlemi (Stripe)”).
  • Şablon bölümleri: Amaç, Ne zaman kullanılmalı, Önkoşullar, Adımlar, İstisnalar, Sahip, İlgili dokümanlar.

Şablonlar yazma sürtünmesini azaltır ve onaycıların riskli detayları daha hızlı bulmasını sağlar.

Yönetilebilir kalan etiketleme

Etiketler güçlüdür—ve kolaylıkla aşırıya kaçılır. Küçük, kontrollü bir set ve kurallar tutun:

  • Etiketleri çapraz-kesit konular için kullanın (Ürün alanı, Araç, Bölge, Uyumluluk).
  • Kategorileri yineleyen etiketlerden kaçının (örn. “Onboarding”, “Policy”).
  • Bir “etiket bütçesi” oluşturun (ör. doküman başına en fazla 3–5) ve izin verilen listeyi yayınlayın.

Başlangıç yolları: “Buradan Başlayın” ve küratörlük merkezleri

İlk kez okumaya gelenler için plan yapın. Her alan için 5–10 temel dokümanı içeren bir "Buradan Başlayın" sayfası ve rol tabanlı merkezler (örn. “Yeni Yönetici” veya “Yeni Destek Elemanı”) oluşturun. Ana sayfadan ve gezinmeden bunlara bağlantı verin ki onboarding kabile bilgisinden bağımsız olsun.

Teknik olmayan ekipler için UX ve gezinme

Bir bilgi tabanı, insanlar dokümanları bulup okuyup güncellemezse işe yaramaz. Öğrenmesi kolay, tahmin edilebilir yollar etrafında tasarlayın ve UI'yi sakin tutun—özellikle nadiren kullananlar için.

Gezinmeyi açık yapan ana sayfalar

Çekirdek seti küçük tutun ve üst gezinmeden her zaman erişilebilir yapın:

  • Anasayfa: “Buradan Başlayın” kutuları (Öne çıkan SOP'lar, Yeni/Güncellenen, Bekleyen onaylarınız)
  • Gözat: kategoriler, alanlar ve popüler etiketler
  • Doküman görünümü: net meta verilerle tek kaynak
  • Editör: odaklanmış yazma deneyimi (dağınıklık yok)
  • Onaylar: bekleyen incelemeler, yorumlar, kararlar
  • Yönetim: kullanıcılar, roller, şablonlar, saklama ayarları

Okuma ve yazma modlarını basit tutun

Doküman görünümünü temiz, yazdırılabilir bir sayfa olarak ele alın. Gezinti (iz yolları, içindekiler) metnin yanında olsun, metin içinde değil.

Editör için sık kullanılan işlemleri önceliklendirin: başlıklar, listeler, linkler ve çağırma kutuları. Gelişmiş biçimlendirmeyi “Daha Fazla” altında saklayın ve otomatik kaydetme ile açık bir onay gösterin (“Kaydedildi • 2 saniye önce”).

Gerçek işe uyan hızlı eylemler

Teknik olmayan ekipler hız değer verir. Doküman başlığında tek tıkla eylemler ekleyin:

  • Bağlantıyı kopyala (Slack/e-posta için)
  • Değişiklik iste (görev veya taslak oluşturur)
  • Okundu olarak işaretle (eğitim/uyumluluk için)

Güven oluşturan UI desenleri

Her SOP şu soruyu yanıtlamalı: “Bu güncel mi ve sahibi kim?” Bu öğeleri tutarlı gösterin:

  • Son güncelleme tarihi ve versiyon
  • Sahip (kişi veya ekip) ve iletişim bilgisi
  • Statü rozeti (Taslak, İnceleme, Onaylandı, Kullanımdan Kaldırıldı)
  • Bir sonraki inceleme tarihi ve kısa değişiklik özeti

Kullanıcılar gördüklerine güvendikçe ekran görüntüsü almak yerine portali kullanmaya başlar.

Teknoloji yığını ve mimari seçimi

Teknoloji seçimi trendleri takip etmek değil; ekibinizin yıllarca kurup işletmeyi sürdürebileceği çözümleri seçmekle ilgilidir.

Ekibinizle yığını eşleştirin

Geliştiricilerinizin rahatça üretebildiği şeylerle başlayın. Basit ve yaygın bir kurulum: tek sayfa uygulama (React/Vue) + bir backend API (Node.js, Django veya Rails) ve ilişkisel veritabanı (PostgreSQL). Küçük ekipler veya hızlı hareket etmek isteyenler için tam yığın framework'ler (Next.js, Laravel veya Django) frontend ve backend'i tek yerde tutarak karmaşıklığı azaltabilir.

Ayrıca dokümanların HTML, Markdown veya yapılandırılmış bir formatta (JSON tabanlı bloklar) tutulup tutulmayacağına erken karar verin. Bu seçim editörünüzü, arama kalitesini ve gelecekteki göçleri etkiler.

Hızlı prototipleme için haftalarca iskelet kurmaya bağlı kalmak istemiyorsanız, Koder.ai gibi bir vibe-coding platformu, chat tabanlı bir spesifikasyonla React tabanlı dahili portalı Go + PostgreSQL backend ile hızlıca ayağa kaldırıp hazır olduğunuzda kaynak kodunu dışa aktarmanıza izin verebilir. Bu, gezinme, roller ve onay akışlarını gerçek kullanıcılarla doğrulamak için özellikle faydalıdır.

Barındırma: yönetilen platform mu yoksa kendi sunucunuz mu?

Yönetilen barındırma (ör. bir PaaS) operasyon yükünü azaltır: otomatik dağıtımlar, ölçekleme, yedekler ve SSL. Dahili bir bilgi tabanı için en hızlı yol genellikle budur.

Kendi sunucunuzda çalıştırma veri yerleşimi gereksinimleriniz, mevcut altyapınız veya güvenlik ekibinizin her şeyi iç ağda tutma tercihi varsa mantıklı olabilir. Kurulum ve bakım çabası artar; buna göre plan yapın.

Ortamlar: dev, staging, prod

Ayrı ortamlar “sürpriz” değişikliklerin çalışanları etkilemesini önler. Tipik akış:

  • Dev: hızlı yineleme ve deneyler
  • Staging: üretim benzeri veri ve izinlerle gerçekçi test
  • Prod: kararlı, denetlenmiş yayınlar

Riskli değişiklikler (yeni onay adımları veya arama sıralaması ayarları gibi) için feature flag kullanın.

Büyüyebilen modüler mimari

Küçük başlasanız bile, yeniden yazmadan özellik ekleyebilmek için net sınırlar tasarlayın. Pratik yaklaşım: modüler monolit—tek dağıtım, ama kimlik doğrulama ve roller, dokümanlar, iş akışları, arama ve denetim izi gibi ayrı modüller. İhtiyaç arttıkça belirli modülleri (ör. arama) ayrı servislere ayırabilirsiniz.

Daha derin bir kurulum kontrol listesi isterseniz bu bölümü rollout planınıza bağlayın: /blog/testing-rollout-improvement

Veritabanı ve veri ilişkilerini tasarlayın

Kaynak Koda Sahip Olun
Hazır olduğunuzda kaynak kodunu dışa aktararak kontrolü elinizde tutun.
Kaynağı Dışa Aktar

Bir bilgi tabanı veya SOP uygulaması, “kim neyi, ne zaman, hangi kurallar altında yazdı” sorusunu doğru temsil edebilmelidir. Temiz bir veri modeli versiyonlama, onaylar ve denetimi kırılgan yerine öngörülebilir yapar.

Modellenecek temel varlıklar

Başlangıç için az sayıda çekirdek tablo (veya koleksiyon) ile başlayın ve her şeyi bunlara iliştirin:

  • Users ve Groups: kişiler, ekipler ve üyelik (çoktan çoğa)
  • Spaces: üst seviye alanlar (Engineering, HR, Operations)
  • Documents: kanonik kayıt (başlık, statü, current_version_id, space_id)
  • Versions: dokümanın değiştirilemez anlık görüntüleri
  • Comments: dokümana veya belirli bir versiyona bağlı tartışmalar
  • Tasks: inceleme talepleri, onay öğeleri veya “bu SOP'u Cuma'ya kadar güncelle” gibi görevler

Veriyi tutarlı kılan ilişkiler

Tipik ilişkiler:

  • Bir document bir spacee aittir (space_id).
  • Bir documentin birçok versiyonu vardır (versions.document_id).
  • Bir version bir kullanıcı tarafından yazılır (versions.created_by).
  • Bir comment bir dokümana ve opsiyonel olarak bir versiyona aittir.

Bu yapı “geçerli” dokümanı hızlı yüklerken tam geçmişi korur.

Zengin metni güvenli saklama

Ham HTML yerine yapılandırılmış format (ProseMirror/Slate/Lexical'den JSON gibi) tercih edin. Değiştirilebilir editörlerde daha kolay doğrulama, güvenli render ve dayanıklılık sağlar. HTML saklanacaksa yazarken ve render ederken sanitize edin.

Göçler ve yedeklemeleri erken planlayın

Başlangıçtan itibaren bir migration aracı seçin ve migrationları CI'da çalıştırın. Yedekleme için RPO/RTO belirleyin, günlük snapshot'ları otomatikleştirin ve kurtarmayı düzenli olarak test edin—özellikle diğer sistemlerden eski SOP'ları içe aktarmadan önce.

Editör ve doküman görüntüleme deneyimini oluşturun

Kullanıcılar en çok editörde zaman geçirir; küçük UX ayrıntıları benimsemeyi sağlar veya kırar. Bir e-posta yazmak kadar kolay hissettiren ama tutarlı SOP'lar üreten bir deneyim hedefleyin.

Editör stilini seçin: Markdown, WYSIWYG veya hibrit

  • Markdown hızlı ve temizdir ama teknik olmayan ekipleri ürkütebilir.
  • WYSIWYG tanıdık ve tablo ile hızlı düzenlemeler için iyidir.
  • Hibrit dahili bilgi tabanı için iyi bir denge sağlar: güç kullanıcıları için kaynak görünümü olan bir WYSIWYG.

Hangi yolu seçerseniz seçin, biçimlendirme kontrollerini basit ve tutarlı tutun. Çoğu SOP başlıklar, numaralı adımlar, kontrol listeleri, tablolar ve çağrı kutuları gerektirir.

Şablonlar, kontrol listeleri ve yeniden kullanılabilir bölümler

Yaygın SOP tipleri için doküman şablonları destekleyin (örn. “Olay Müdahalesi”, “Onboarding”, “Aylık Kapanış”). Doğru yapıyla başlamak tek tıkla mümkün olsun.

“Acil durum kontrolleri”, “tamamlanma tanımı” veya “yükseltme iletişimleri” gibi yeniden kullanılabilir bloklar ekleyin. Bu, kopyala-yapıştırı azaltır ve SOP versiyon kontrolünü temiz tutar.

Satır içi yorumlar ve incelemeye uygun yazma

Satır içi yorumlar onaylı bir wiki'yi gerçek bir işbirliği aracına dönüştürür. İnceleyicilerin:

  • Belirli bir cümle veya adıma yorum bırakmasına
  • Önerilen değişiklikleri takip etmesine
  • Konuları çözerek son halin okunmasını kolaylaştırmasına izin verin

Ayrıca saha ekipleri için düzenleme UI'sını gizleyen ve temiz, yazdırılabilir bir görünüm sunan bir “okuma modu” düşünün.

Ekler, görseller ve embed'ler

SOP'lar genellikle ekran görüntüleri, PDF'ler ve tablolar gerektirir. Ekleri doğal hissettirecek şekilde yönetin:

  • Sürükle-bırak yüklemeler ve açık dosya adları
  • Görseller için otomatik küçük resim önizlemeleri
  • Onaylı dosya tipleri için güvenli embed'ler

En önemlisi, dosyaları SOP'lar için kimin ne zaman yüklediğini ve hangi doküman versiyonunun onu referans verdiğini koruyacak şekilde depolayın.

Roller, izinler ve onay iş akışları

Bilgi tabanınız SOP'ları içeriyorsa erişim kontrolü ve inceleme adımları “iyi olur” değil—sistemi güvenilir kılan gerekliliklerdir. Günlük kullanım basit tutulsun; kritik alanlarda yönetişimi sıkılaştırın.

Net roller tanımlayın

Küçük, anlaşılır bir rol setiyle başlayın:

  • Viewer: yayınlanmış içeriği okuyabilir (ve gerekirse yorum bırakabilir).
  • Editor: doküman taslağı oluşturup güncelleyebilir, fakat düzenlenmiş SOP'ları tek başına yayımlayamaz.
  • Approver: belirli alanlar veya SOP kategorileri için değişiklikleri inceleyip onaylar.
  • Admin: alanları, şablonları, kullanıcıları/grupları ve iş akışı kurallarını yönetir.

Bu, beklentileri netleştirir ve “herkes her şeyi düzenleyebilir” kaosunu önler.

Alan ve doküman düzeyinde izinler

İzinleri iki seviyede ayarlayın:

  • Alan düzeyi (departman, takım, ürün alanı): kim görüntüleyebilir, taslak oluşturabilir, onaylayabilir veya yönetebilir.
  • Doküman düzeyi (istisnalar): tek bir SOP'u kilitlemek, hassas runbook'u sınırlamak veya geçici düzenleme erişimi vermek.

Bireyler yerine grupları (örn. “Finance Approvers”) kullanmak bakım yükünü azaltır.

SOP'lar için onay iş akışları

SOP'lar için açık bir yayımlama kapısı ekleyin:

  • Bir taslağın "Yayınlanabilir" hale gelmesi için bir veya daha fazla gözden geçirici gerekli olsun.
  • Sıralı veya paralel onayları destekleyin (ör. önce Uyumluluk, sonra Operasyon).
  • Politikanız gerekliyse “küçük düzenleme” ve “büyük değişiklik” kurallarını ayırın.

Denetim izi (kim, ne, ne zaman, neden)

Her değişiklik: yazar, zaman damgası, tam fark ve isteğe bağlı değişiklik nedeni kaydıyla tutulmalıdır. Onaylar da loglanmalıdır. Bu denetim izi hesap verebilirlik, eğitim ve iç/dış incelemeler için esastır.

Arama, filtreler ve bulunabilirlik

Hazır Olduğunuzda Canlıya Geçin
Pilot aşamasından üretime geçme zamanı geldiğinde uygulamanızı dağıtın ve barındırın.
Şimdi Dağıt

İnsanlar bilgi tabanında gezinmekten çok bir cevabı avlar. Arama yavaş veya belirsizse ekipler Slack ve kabile belleğine geri döner.

Aramayı hızlı ve okunaklı yapın

Tam metin arama uygulayın; sonuçlar bir saniyenin altında dönmeli ve bir sayfanın neden eşleştiğini göstermeli. Başlıkta ve kısa açıklamada eşleşmeleri vurgulayın ki kullanıcı alaka düzeyini hızlıca değerlendirsin.

Arama gerçek ifadelerle çalışmalı, yalnızca tam anahtar kelimelerle değil:

  • Eşanlamlıları destekleyin (örn. “PTO” ↔ “izin”, “onboarding” ↔ “yeni işe başlama”) ki kaçan sonuçlar azalır.
  • Yaygın yazım hataları için “bunu mu demek istediniz” önerileri ekleyin.

Ekiplerin düşündüğü filtreler

Arama geniş sonuç verdiğinde hafif filtreler hızla daraltmaya yardımcı olur:

  • Statü (taslak, inceleme, onaylandı)
  • Sahip (kimin yönettiği)
  • Etiket
  • Güncelleme tarihi (son 30/90 gün)
  • Alan (departman veya fonksiyon)

En iyi filtreler tutarlı ve öngörülebilir olanlardır. Eğer “sahip” bazen kişi bazen ekip adıysa kullanıcılar güvenmez.

Tekrarlanan işler için kaydedilmiş görünümler

Ekipler aynı sorguları tekrar tekrar çalıştırır. Paylaşılabilir ve sabitlenebilir kaydedilmiş görünümler oluşturun, örn:

  • “İnceleme gerektiren SOP'lar” (onaylı + yaklaşan inceleme tarihi)
  • “Operasyon'da son güncellenenler”
  • “Onay bekleyen taslaklarım”

Kaydedilmiş görünümler aramayı bir iş akışı aracına dönüştürür ve dokümantasyonu ekstra toplantılar olmadan güncel tutmaya yardımcı olur.

Versiyonlama, inceleme döngüleri ve değişim yönetimi

Bilgi tabanınız SOP'ları içeriyorsa soru “bu değişecek mi?” değil—“değişikliklere güvenebilir miyiz ve neden?” olmalıdır. Net bir versiyonlama sistemi ekipleri eski adımlardan korur ve onayları kolaylaştırır.

Kullanılabilir bir sürüm geçmişi

Her doküman görünür bir sürüm geçmişine sahip olmalı: kim değiştirdi, ne zaman ve hangi statüde olduğu. İnceleyiciler için diff görünümü ekleyin ki versiyonları satır satır aramak zorunda kalmasınlar. Geri alma için tek bir eylemle önceki onaylı versiyona dönülebilmeli ve daha yeni taslak kaydedilmeli.

Onaylı SOP güncellemeleri için değişiklik notu zorunluluğu

Onaylı SOP'lar için yayımlamadan önce kısa bir değişiklik notu isteyin—ne değişti ve neden. Bu hafif denetim izi oluşturur ve ilgili ekiplerin etkisini hızlıca değerlendirmesine yardımcı olur.

İnceleme döngüleri ve hatırlatmalar

Her doküman için periyodik inceleme ayarı ekleyin (ör. her 6 veya 12 ay). Sahiplere hatırlatmalar gönderin ve gecikme durumunda yükseltin. Basit tutun: bir son tarihe, sahibi ve açık bir eyleme sahip olsun (“hala doğru olduğunu onayla” veya “revize et”).

Güvenli arşivleme (silme değil)

Kesin silme yerine arşivlemeyi tercih edin. Arşivlenmiş sayfalarda “Arşivlendi” bandı gösterin ki eski yer imleri çalışmaya devam etsin. Arşivleme/geri alma izinlerini kısıtlayın, bir neden isteyin ve kazara silinmeyi engelleyin—özellikle eğitim veya uyumlulukta referans verilen SOP'lar için.

Güvenlik ve uyumluluk temelleri

Çekirdek Stack'i Hızla Kurun
React ile birlikte Go ve PostgreSQL backend kullanarak dahili bir bilgi tabanı web uygulaması oluşturun.
Portal Oluştur

Bir bilgi tabanı veya SOP portalı için güvenlik sadece hack'lere karşı değil—istemeden paylaşımı önlemek ve kimin neyi değiştirdiğini kanıtlamaktır. Her dokümanı potansiyel olarak hassas kabul edin ve varsayılan olarak “özel” yaklaşımını benimseyin.

Kimlik ve giriş (SSO)

Kuruluşunuz zaten single sign-on kullanıyorsa, erken entegre edin. SAML veya OIDC desteği (Okta, Azure AD, Google Workspace vb.) parola riskini azaltır ve onboarding/offboarding süreçlerini öngörülebilir kılar. Merkezi politikalar (MFA, koşullu erişim) da uygulanabilir.

Asgari ayrıcalık ve güvenli varsayılanlar

İzinleri insanların ihtiyaç duyduğu minimum erişimle tasarlayın:

  • Yeni alanları/projeleri varsayılan olarak kısıtlı görünürlükte oluşturun.
  • “Görüntüle”, “düzenle” ve “yayınla/onayla” izinlerini ayırın.
  • Yönetimsel işlemleri zorlaştırın (izin değişikliği gibi) ve onay isteyin.

Ayrıca yükleniciler için geçici erişim ve “break-glass” admin hesapları gibi ek kontroller düşünün.

Veriyi koruyun (ve uygulamayı)

Temelleri iyi uygulayın:

  • Trafikte (HTTPS) ve depolamada şifreleme
  • XSS/SQL injection gibi saldırılara karşı girdi doğrulama; zengin metin editörlerini dikkatle ele alın
  • Giriş, arama ve dışa aktarma uç noktaları için hız sınırlamaları
  • Kod içinde API anahtarları saklamayın; sırları güvenle yönetin ve tokenları düzenli döndürün

Girişler, izin değişiklikleri, onaylar ve düzenlemeler için log tutmak da önemlidir.

Uyumluluk: saklama ve dışa aktarma

Küçük ekipler bile uyumlulukla karşılaşır. Baştan karar verin:

  • Saklama kuralları (versiyonlar, taslaklar ve silinen dokümanlar ne kadar saklanır)
  • Hukuki tutma veya “silme yasağı” seçenekleri için kritik SOP'lar
  • Denetimler, göçler veya eDiscovery için alan veya organizasyon düzeyinde dışa aktarma yeteneği

İleride iş akışları ve versiyonlamayı eklediğinizde bunları uyumluluk kurallarıyla hizalayın.

Entegrasyonlar ve otomasyon

Bir bilgi tabanı, insanların zaten iletişim kurduğu ve iş yaptığı araçlarla uyumlu olduğunda işe yarar. Entegrasyonlar ve hafif otomasyonlar “lütfen SOP'ı güncelle” takiplerini azaltır ve dokümantasyonu iş akışının parçası haline getirir.

Eylem üreten bildirimler

Önemli anlara odaklı bildirimler oluşturun:

  • Bahsetmeler: @kişi ve @ekip bildirimleri
  • Onaylar: doküman inceleme bekliyor veya onay/red alındı bildirimleri
  • Yaklaşan incelemeler: planlı inceleme tarihleri yaklaşırken hatırlatmalar

Tercihleri basit tutun (e-posta vs uygulama) ve düşük öncelikli güncellemeleri günlük özette toplayarak spam'i önleyin.

Dokümanları sohbet, e-posta ve görevlerle bağlayın

Ekiplerin zaten olduğu yerlerle başlayın:

  • Slack / Microsoft Teams: doküman kartı paylaşımı (başlık, statü, sahip, sonraki inceleme tarihi) ve hızlı eylemler (örn. “inceleme iste”)
  • E-posta: onay talepleri ve inceleme hatırlatmaları
  • Görev araçları (Jira, Asana, Trello): SOP linklerini ticket'a ekleme ve inceleme başladığında otomatik görev oluşturma

Kural: farkındalık ve takip için entegre edin, ancak tek gerçek kaynak uygulama olsun.

Gerçek dünya operasyonları için içe/dışa aktarma

Ekiplerin mevcut içeriklerini tablolar halinde sakladıkları ve denetimler için anlık dışa aktarımlar gerektiği olur.

Destekleyin:

  • CSV içe/dışa aktarım: SOP envanterleri, sahipler ve inceleme tarihleri gibi listeler için
  • PDF dışa aktarma: belirli bir andaki SOP anlık görüntüsü (versiyon numarası ve dışa aktarım zaman damgası dahil)

Küçük, stabil bir dahili API

Halka açık bir geliştirici platformu olmasa bile basit bir API dahili bağlantılar için faydalıdır. Öncelikli uç noktalar: arama, doküman meta verisi, durum/onaylar ve webhooklar (örn. “SOP onaylandı”, “inceleme gecikti”). /docs/api üzerinde açıkça belgelendirin ve versiyonlamayı muhafazakar tutun.

Test, dağıtım ve sürekli iyileştirme

Bir bilgi tabanını göndermek tek seferlik bir lansman değildir. Üründeymiş gibi davranın: küçük başlayın, değeri kanıtlayın, sonra güvenle genişletin.

Odaklanmış bir pilot ile başlayın

En çok acıyı hisseden bir pilot ekip seçin (Ops, Support, HR). Hızlı erişilen birkaç yüksek değerli SOP'u taşıyın—ideal olarak haftalık olarak sıkça sorulan veya uyumlulukla ilişkili olanlar.

Başlangıç kapsamını dar tutun: bir alan, birkaç şablon ve net bir sahip. Bu, şirket geneline açmadan önce karışıklıkları fark etmeyi kolaylaştırır.

Deneyimi uçtan uca test edin

Temel QA'nın ötesinde, gerçek işleri taklit eden iş akışı testleri yapın:

  • Oluştur → incele → onayla → yayınla
  • Yayınlanmış bir SOP'u düzenle ve bildirimleri ile görünürlük kurallarını doğrula
  • Yaygın terimleri arayıp sonuçların beklendiği gibi geldiğini kontrol et

Ayrıca ekiplerin gerçekten kullandığı cihazlarda (masaüstü + mobil) ve gerçek izinlerle (yazar vs onaycı vs görüntüleyici) test yapın.

Benimseme ve sürtünmeyi ölçün

Başlangıçtan itibaren birkaç hafif metrik belirleyin:

  • Yapılan aramalar (ve “sonuç yok” oranı)
  • Doküman başına okuma sayısı ve benzersiz okuyucular
  • Haftalık düzenlemeler (insanlar içeriği iyileştiriyor mu?)
  • Onay döngü süresi (taslak → yayın)

Rakamları kısa görüşmelerle eşleştirerek bir şeyin neden kullanılmadığını öğrenin.

Yinele, belgele ve yaygınlaştır

Geri bildirim toplayın ve şablonları, kategorileri ve adlandırma kurallarını rafine edin. Basit yardım dokümanları yazın (SOP nasıl bulunur, değişiklik nasıl istenir, onaylar nasıl işler) ve bunları uygulamada yayınlayın.

Sonra dalga dalga bir yaygınlaştırma planı ile dağıtın: zaman çizelgesi, eğitim oturumları, ofis saatleri ve soru göndermek için tek bir yer (ör. /support veya /docs/help).

SSS

What’s the difference between a knowledge base and an SOP system?

Kendi kuruluşunuzun tanımlarına ve yönetişimine göre başlayın:

  • Bir bilgi tabanı referans içeriği için en uygunudur (SSS, politikalar, sorun giderme notları).
  • SOP'lar ise sahiplik, onaylar, versiyonlama ve denetlenebilirlik gerektiren tekrarlanabilir prosedürlerdir.

Birçok ekip, aynı uygulama içinde iki içerik tipi kullanır ve her biri için farklı iş akışı kuralları uygular.

What success metrics should I track for a knowledge base/SOP web app?

Lansmandan sonra doğrulayabileceğiniz çıktılara odaklanın:

  • Medyan cevabı bulma süresi (ör. 30 saniyenin altında)\n- Benimseme (haftalık aktif kullanıcılar, kullanıcı başına arama sayısı)\n- Kalite göstergeleri (eski talimatlara bağlı hatalarda azalma)\n- İş akışı sağlığı (onay döngü süresi, gecikmiş incelemeler)

Küçük bir set seçin ve aylık olarak gözden geçirin.

What fields should every document include from day one?

Başlangıç için minimal bir içerik modeliyle başlayın ve her yerde uygulayın:

  • Başlık
  • Sahip (kişi veya ekip)
  • Statü (Taslak → İnceleme → Onaylandı → Arşivlendi)
  • Son güncelleme (kim + ne zaman)
  • Etiketler (kontrollü)

Tutarlı meta veriler, ileride arama, filtreler ve yönetişim için temel oluşturur.

How should I structure spaces, categories, and collections?

Öngörülebilir sahiplik ve gezinme için alanlar ve kategoriler kullanın:

  • Spaces (Alanlar) içeriğin kim tarafından korunduğunu gösterir (HR, Support, Engineering).
  • Kategoriler bir alan içinde sabit gruplamalardır (Politikalar, Süreçler, Araçlar).
  • Collections/hubs ise ekipler arası içeriği çoğaltmak yerine küratörlük yapar.

Birisi “bunu kim yönetiyor?” diye sorduğunda alan cevap vermelidir.

How do I avoid a tagging system that becomes messy?

Etiketleri sınırlı ve kural tabanlı tutun:

  • Etiketleri çapraz-kesit kavramlar için kullanın (Araç, Bölge, Uyumluluk, Ürün alanı).
  • Kategorileri tekrar eden etiketlerden kaçının.
  • Bir “etiket bütçesi” belirleyin (ör. her doküman için 3–5) ve izin verilen liste yayınlayın.

Bu, etiket karmaşasını önlerken esnek filtrelemeyi korur.

What UX patterns help non-technical teams actually use the system?

Birkaç öngörülebilir sayfa ve basit modlar etrafında tasarlayın:

  • Üst gezinme: Home, Browse, Search, Approvals
  • Doküman görünümü: temiz düzen + görünür meta veriler (sahip, statü, versiyon, son güncelleme)
  • Editör: başlıklar, listeler, linkler, kontrol listeleri; otomatik kaydetme ve açık bir onay mesajı

Gerçek iş akışlarına uyan Kopyala bağlantı ve Değişiklik iste gibi hızlı eylemler ekleyin.

Should the editor be Markdown, WYSIWYG, or hybrid?

Kullanıcılarınıza ve gelecekteki taşınabilirliğe göre seçin:

  • Markdown: hızlı ve temiz, ancak teknik olmayan ekipler için göz korkutucu olabilir.
  • WYSIWYG: tanıdık ve tablolar, hızlı düzenlemeler için iyidir.
  • Hibrit: güç kullanıcılar için kaynak görünümü sunan WYSIWYG iyi bir denge sağlar.

Ne seçerseniz seçin, biçimlendirmeyi minimal tutun ve SOP yapıları (adımlar, kontrol listeleri, açıklamalar) için optimize edin.

What database entities and relationships are most important?

Denetlenebilirlik ve güvenli geri alma için modelleyin:

  • Dokümanlar: kanonik kayıt (alan, statü, geçerli versiyon)
  • Versiyonlar: değiştirilemez anlık görüntüler (yazar, zaman damgası)
  • Yorumlar: isteğe bağlı olarak belirli bir versiyona bağlı
  • Görevler: inceleme/onay öğeleri ve güncelleme talepleri

Bu yapı, “güncel” sayfaları hızlı tutarken tam bir geçmiş saklar.

How do I design roles, permissions, and approvals without chaos?

Basit tutun ve SOP yayınlama için daha katı kurallar uygulayın:

  • Roller: Viewer, Editor, Approver, Admin
  • Varsayılan olarak alan düzeyinde izinler; gerektiğinde doküman düzeyinde istisnalar
  • SOP yayınlama aşaması: bir veya daha fazla gözden geçirenin gerekli olması (paralel veya sırayla)

Düzenli olarak her önemli olayı (düzenlemeler, onaylar, izin değişiklikleri) kaydedin.

How do I make search and findability work in real-world usage?

Aramayı hızlı ve anlaşılır yapın, aramayı iş akışına dönüştürün:

  • Tam metin arama, vurgulanmış snippetler ve “bu yüzden eşleşti” gösterimi
  • Gerçek ifadeler için eşanlamlılar (ör. PTO ↔ tatil)
  • Filtreler: statü, sahip, etiket, alan, güncelleme tarihi
  • Kaydedilmiş görünümler: “Bekleyen onaylarım”, “İnceleme gerektiren SOP'lar”, “Son güncellenenler”

Ayrıca “sonuç yok” aramalarını takip edip eksik içeriği tespit edin.

How do I handle versioning, review cycles, and change management?

Sürüm geçmişi herkesin kullanabileceği şekilde olmalı:

  • Her doküman görünür bir versiyon geçmişine sahip olmalı: kim değiştirdi, ne zaman ve hangi statüde olduğu. Bir diff görünümüyle versiyonları kolayca karşılaştırın.
  • Geri alma işlemi basit olmalı: önceki onaylı bir versiyonu geri yükleyin ve daha yeni taslağı kayıt olarak saklayın.

Onaylı SOP güncellemeleri için kısa bir değişiklik notu zorunlu kılın; bu, hafif bir denetim izi oluşturur ve etkileri hızlıca değerlendirmeyi sağlar.

What security and compliance basics should I cover?

SSO'yu erken entegre edin (SAML veya OIDC). Merkezi politikalar (MFA, koşullu erişim) ve onboarding/offboarding süreçleri kolaylaşır.

Güvenlik temelleri:

  • Trafikte (HTTPS) ve depolamada şifreleme
  • Girdi doğrulama ve sanitizasyon (özellikle zengin metin editörleri)
  • Giriş, arama ve dışa aktarım uç noktalarında hız sınırlamaları
  • Gizli anahtarları güvenli saklayın ve düzenli döndürün

Ayrıca girişler, izin değişiklikleri, onaylar ve doküman düzenlemeleri için kapsamlı bir log tutun.

How do I integrate docs with other tools and automate workflows?

En etkili entegrasyonlar, ekiplerin zaten kullandıkları araçlarla bağlantı kuranlardır:

  • Bildirimler: @bahsetmeler, onay talepleri, süresi dolmak üzere olan inceleme hatırlatmaları
  • Chat entegrasyonları (Slack / Microsoft Teams): doküman kartı paylaşımı ve hızlı aksiyonlar
  • Görev araçları (Jira, Asana, Trello): SOP linklerini ticket'lara ekleyin veya inceleme başladığında otomatik görev oluşturun

Kaynak tekil olarak uygulamada kalmalı; entegrasyonlar farkındalık ve takip için olsun.

İçindekiler
Hedefler ve kullanıcı ihtiyaçlarıyla başlayınGereksinimleri ve içerik modelini tanımlayınYapıyı planlayın: alanlar, kategoriler, etiketler ve şablonlarTeknik olmayan ekipler için UX ve gezinmeTeknoloji yığını ve mimari seçimiVeritabanı ve veri ilişkilerini tasarlayınEditör ve doküman görüntüleme deneyimini oluşturunRoller, izinler ve onay iş akışlarıArama, filtreler ve bulunabilirlikVersiyonlama, inceleme döngüleri ve değişim yönetimiGüvenlik ve uyumluluk temelleriEntegrasyonlar ve otomasyonTest, dağıtım ve sürekli iyileştirmeSSS
Paylaş
Koder.ai
Build your own app with Koder today!

The best way to understand the power of Koder is to see it for yourself.

Start FreeBook a Demo