Çözümler · Diş klinikleri
Bir diş kliniği sitesi tek bir şeye göre değerlendirilir: kişinin ihtiyaç duyduğu hizmeti, fiyatı ve birimiyle birlikte — diş başına, çene başına, seans başına — bulup bulamadığına ve bunun sigorta kapsamında olup olmadığını bilip bilmediğine göre. Geri kalanı dekor. Bunu taşıyan yapıyı ve personelin bunu kendi başına değiştirebildiği paneli kuruyoruz.
Zaten kurduklarımızÇalışma şu anda dışarıdan doğrulanabilir: yönettiğimiz bölgesel bir diş merkezinin kamuya açık verileri yapılandırılmış bir dosya olarak sunuluyor — 89 hizmet, her biri kategori, alt kategori, ad, fiyat, ölçü birimi ve zorunlu sigorta uygunluk göstergesiyle; bunlardan 27’si uygun olarak işaretli. 7 kategori ve 10 alt kategori, 06.09.2026 tarihinde tarafımızca doğrulandı. Kanıtın ikinci kısmı, geçmişteki diff ile güvenliktir: devralmada yönetici parolası tarayıcıda karşılaştırılıyordu ve herkese açık JavaScript paketine gidiyordu, ayrıca uygulama arayüzüne yazmalar internetten herkes tarafından yapılabiliyordu. Doğru açıklama, kendimize ait olandan fazlasını atfetmemek için: sitenin ilk sürümü bize ait değil. Diff ile gösterilebilen katkı, devralma, güvenlik, türler, sürekli entegrasyon ve bağımlılık hijyenidir.
Bir diş kliniği „hizmet” satmaz. Başka hiçbir alana benzemeyen birimlerle çok uzun bir tarife pozisyonları listesi satar: diş başına, çene başına, çekim başına, tedavi edilen vaka başına, seans başına, ziyaret başına, müdahale başına. İnternette arayan kişi kliniği değil, kendi pozisyonunu arar: bir çekim ne kadar, diş başına mı yoksa ziyaret başına mı ödenir, sigorta kapsamında mı. Buna cevap veren bir site kullanışlıdır; ekli bir PDF’si olan „Fiyatlar” sayfası olan bir site değildir.
Bir kliniğin gerçekliği açısından istenen ikinci şey, listenin programcı olmadan değiştirilebilir olmasıdır. Tarifeler değişir, doktorlar değişir, acil durum programı kışın farklı duyurulur. Her değişiklik bir geliştiriciden geçerse, liste eski kalır ve birkaç ay içinde hastalar geçen yılın fiyatıyla gelir. Kurduğumuz yapı, kamuya açık verileri — hizmetler ve ekip — hem programlama arayüzü hem de sitenin görünen kısmı tarafından okunan yapılandırılmış dosyalarda tutar ve personel bunları bir panelden düzenler.
Üçüncü şey, brief’te kimsenin istemediği ama en çok önem taşıyan şey, o listeye kimin yazabildiğidir. Burada yazdığımız proje devralındığında, internetten herkes programlama arayüzüne bir yazma isteği gönderebiliyordu ve panel parolası tarayıcıya sunulan JavaScript paketine giriyordu — çünkü doğrulama tarayıcıda yapılıyordu. Doğrulamayı sunucuya taşıdık: parola artık sunucudan ayrılmıyor, on iki saat geçerli imzalı bir jeton dönüyor, IP adresi başına onbeş dakikada sekiz deneme sınırı ve sabit zamanlı karşılaştırmalar var; arayüz yalnızca yerel adreste dinliyor, dolayısıyla kamuya açık tek yol web sunucusudur.
Zorunlu sigorta kapsam işareti, ayrı bir cümleyi hak eder; çünkü hasta için en yüksek değere ve klinik için en büyük riske sahip alandır: sonuçları olan bir ifadedir. Bu yüzden o, bizim bir sayfada yazdığımız metin olarak değil, kurum tarafından düzenlenen veri olarak yaşar; biz alanı, gösterimi ve bir dakika içinde düzeltilebilme imkânını kurarız.
Neleri kapsıyor
Her hizmetin veri yapısı kategori, alt kategori, ad, fiyat, ölçü birimi ve zorunlu sigorta uygunluk göstergesi içerir. Birimler alanın gerçek birimleridir — diş, çene, çekim, tedavi edilmiş vaka, seans, ziyaret, muayene, anestezi, prosedür, inceleme, müdahale — çünkü birimsiz bir fiyat, tam da kayıt masasının kaçınmak istediği konuşmayı doğurur.
Kategori ve alt kategori, düz bir liste değil. Yazdığımız çalışmada: 7 kategori ve 10 alt kategori üzerinde 89’dan fazla hizmet. Büyüklük sırası önemlidir — yüzün altındaki kalemlerde iki seviyeli bir taksonomi yeterlidir; birkaç yüzün üstünde yapı başka bir konu olur ve bunu sonra değil, önce söyleriz.
Uygunluk göstergesi her hizmette, genel veriler içinde yer alır ve klinik tarafından düzenlenebilir. Alıntılanan çalışmada 89 hizmetin 27’si uygun olarak işaretlenmiştir. Sigortaya neyin girdiğini biz yazmıyoruz ve biz çıkarsamıyoruz: bu, hasta için sonuçları olan kurum beyanıdır ve her an kurum tarafından düzeltilebilmelidir.
Tek bir “Hizmetler” sayfası değil. Site 22 ekrandan oluşur; hizmetler ve fiyatlardan acil durumlara, ortodontiye, implantlara, pedodontiye, şeffaflığa ve geri bildirime kadar. Nedeni pratiktir: Pazar gecesi “diş acil” arayan biri genel bir sayfa istemez ve bir bölüm sayfası, çalışma saatleri ve orada ne yapıldığı hakkında söyleyecek bir şeyi vardır.
Hizmetler ve ekip bir panelden düzenlenir ve yazma işlemleri geçerli bir jeton gerektirir; okumalar herkese açık kalır, böylece site kimlik doğrulama olmadan çalışır. Klinik için sonuç: bir fiyat değişikliği aynı gün içinde yürürlüğe girer, sonraki geliştirme iterasyonunda değil.
Kimlik doğrulama sunucuda yapılır ve 12 saat geçerli, HMAC-SHA256 ile imzalanmış bir jeton döndürür; IP adresi başına 15 dakikada en fazla 8 deneme ve sabit zamanlı karşılaştırmalar vardır. İmzalama sırrı otomatik olarak, kısıtlı yetkilere sahip bir dosyada, depolamanın dışında tutulacak şekilde oluşturulur. Bunlar koddaki sayılardır, genel ilkeler değil — okunabilir ve tartışılabilirler.
Yalnızca yerel adreste dinler, bu nedenle öndeki web sunucusu tek açık yoldur; izin verilen alan adları listesi açıktır ve istek gövdesi 1 MB ile sınırlandırılmıştır. Yazmalar jeton ister, okumalar istemez. Bu olağan bir yapılandırmadır — sorun şu ki, eksik olduğunda dışarıdan, biri onu bulana kadar görünmez.
Derleyip tipleri doğrulayan kontrol, az sayıda projenin yaptığı başka bir şeyi de yapar: oluşturulan pakette sır arar ve bulursa başarısız olur. Bu, teslim sırasında düzeltilen kusurla doğrudan bağlantılıdır — bir parola, tam da bunu hiçbir şey denetlemediği için genel pakete girmişti. Bunun üzerine, haftalık ritimde bağımlılık güncellemeleri gelir.
Bir programlamayı tek başına onaylamaz: talebi toplar, onay ise ya bir kişiyi ya da kliniğin programlama sistemine bağlantıyı gerektirir — ayrı bir iştir, kendi koşulları vardır. Bizim yazdığımız klinik bilgisini yayımlamaz: tedavilerle ilgili içerik uzmanların sorumluluğundadır. Ve sigorta kapsamına neyin girdiğine karar vermez.
Traseul
İlk teslimat, her birinin birimi ve kapsam işaretiyle birlikte tarif pozisyonları listesidir; kliniğin tuttuğu biçimde olur. Liste yapılandırılmış bir biçimde yoksa — ve genelde hesap dosyası ya da belge olarak vardır — onu biz yapılandırırız, ardından klinik onaylar. Tasarım sonra gelir, çünkü kaç pozisyon olduğuna bağlıdır.
Genel ekranlar ve düzenlendiği panel ayrı ayrı yapılmaz, çünkü aksi halde görüntülenen ama düzenlenemeyen alanlar ortaya çıkar. Siteyi gerçek yüklenmiş verilerle teslim ederiz, dolgu içerikle değil — geçici metinle dolu bir klinik sitesi kimse tarafından değerlendirilemez.
Sunucuda kimlik doğrulama, imzalı belirteç, deneme sınırı, programlama arayüzü yalnızca yerel adres üzerinden, izin verilen alan adları listesi, istek gövdeleri üzerinde tavan. Dışarıdan yapılan bir kontrolün sonucunu teslim ederiz: kimlik doğrulama olmadan ne okunabilir ve ne yazılamaz.
Erişimleri, devreye alma belgesini ve tarifeleri ile ekibi değiştirecek kişi için kısa bir eğitimi teslim ederiz. Klinikten biri, sitede görünen bir değişikliği tek başına yapana kadar teslimat tamamlanmış sayılmaz.
Veriler
Kurallar sektörden sektöre değişir. Bunlar diş kliniklerinde uygulananlardır.
Bir vaka
Durum
Bir diş kliniği sitesini devralırken, yönetim panelinde yalnızca içeriden görülebilen iki sorun vardı. Birincisi: parola tarayıcıda karşılaştırılıyordu, dolayısıyla kamuya açık JavaScript paketine giriyordu. İkincisi: uygulama arayüzüne yazma istekleri internetten herkes tarafından yapılabiliyordu ve port doğrudan açıktı.
Ne kurduk
Doğrulamayı sunucuya taşıdık: kimlik doğrulama, HMAC-SHA256 ile imzalanmış, 12 saat geçerli bir jeton döndürüyor; adres IP başına 15 dakikada 8 deneme sınırı ve sabit zamanlı karşılaştırmalar var; imzalama sırrı, kendi kendine üretiliyor, kısıtlı yetkilerle, deponun dışında. Uygulama arayüzü yalnızca yerel adreste dinlemeye devam etti; önde web sunucusu, izinli alan adları listesi ve 1 MB ile sınırlandırılmış istek gövdesi var. Servislere ve ekibe yapılan yazmalar jeton istiyor; okumalar kamusal kaldı. Tüm bunların üstünde, derleyen, türleri denetleyen ve içinde bir sır bulursa paketi reddeden sürekli entegrasyon var.
Ne çıktı
Kliniğin kamusal verileri bugün dışarıdan da doğrulanabilir: kategori, alt kategori, fiyat, birim ve sigorta kapsam göstergesi olan 89 hizmet, bunların 27’si uygun olarak işaretli. Değişen şey, bunlara kimin yazabildiği.
Vakanın söylemedikleri
İlk site sürümünü biz yapmadık. Depo geçmişinden, commit’lerin bir kısmı dış geliştiricilere ait. Diff ile gösterebildiğimiz katkı devralmadır: güvenlik, sürekli entegrasyon, türler, bağımlılıklar.
Sorular
Evet — işin yarısı bu. Servisler ve ekip bir panelden düzenlenir; yazmalar kimlik doğrulama ister, okumalar kamusal kalır. Bizim önerimiz: teslim sırasında, bununla ilgilenecek kişi değişikliği bizim önümüzde yapsın, böylece bunun bizden değil, kendi elinden çalıştığını bilelim.
Düzenlediğiniz aynı verilerde, her hizmet üzerinde bir gösterge olarak. Alıntı yaptığımız çalışmada, 89 hizmetin 27’si uygun olarak işaretli. Alanı ve gösterimi biz kuruyoruz; tam olarak neyin uygun olduğu kurumun beyanıdır, çünkü bunun hasta ve klinik için sonuçları vardır.
Çünkü diş hekimliğinde fiyat ziyaret başına değildir. Diş başına, çene başına, çekim başına, tedavi edilen vaka başına, seans başına olur. Birim olmadan gösterilen fiyat, resepsiyonun günde on kez yaptığı tam konuşmayı doğurur ve daha da kötüsü, hastaya telefonda başka bir şey söylenmiş olduğu hissini verir.
Talebi toplayabilir. Bir saatin onayı ya takvime bakan bir kişi ya da kliniğin programlama sistemine bağlantı gerektirir — bu, önceden uyumluluk kontrolü olan ayrı bir iştir. Sadece e-posta gönderen bir formu “çevrimiçi programlama” diye adlandırmayız.
Klinik uzmanları. Biz klinik bilgileri yazmıyoruz ve bunları arama için “optimize” etmiyoruz; çünkü bu, bir tıbbi kurum adına tıbbi iddialar formüle etmek anlamına gelir. Yapıyı kuruyoruz, metnin yanıtlaması gereken soruları belirliyoruz ve doğrulandıktan sonra yayımlıyoruz.
Evet, ve burada yazdığımız çalışma tam olarak budur. Bir devralmada önce ne yaparız: dışarıdan nelerin yazılabildiğine, parolaların nerede durduğuna ve tarayıcıya sunulan pakette neyin yer aldığına bakarız. Alıntılanan durumda yönetici parolası herkese açık pakete giriyordu ve yazma işlemleri herkes tarafından yapılabiliyordu. Doğrulamayı sunucuya taşıdık ve yazma işlemlerini kapattık.
Kaydedilir kaydedilmez, çünkü kamuya açık veriler sizin düzenlediğiniz aynı kaynaktan okunur. Vaad etmediğimiz şey, arama motorlarındaki sonuçların ne hızla güncellendiğidir — bu bize bağlı değildir ve bunu garanti edemeyiz.
Uygulama sırasında belirlenir: nereye giderler, kim görür, ne kadar süre saklanırlar ve formda asla ne istenmez. Bir klinikte mesaj çoğu zaman bir sağlık sorununun açıklamasını içerir, dolayısıyla bu “bir lead” değildir, sıkı rejime tabi bir veri kategorisidir — ve bunun işlenmesi kliniğin yayımlanmış politikasında yazılır.
Yalnızca isterseniz. Çalışmalarımızın bazıları alt kısımda atıf taşır, bazıları taşımaz — bu müşteriye bağlıdır. Bunu belirtiyoruz çünkü bu, kliniklerin sorduğu bir sorudur ve site hiçbir atıf taşımıyorsa, biz de onların onayı olmadan kendimizi yazar olarak sunmayız.
Bize sürecinizi anlatın. Neyin kurulmaya değer olduğuna, neyi bağlayabileceğimize ve sonucu nasıl doğrulayacağımıza birlikte karar verelim.