TEMSİLÎ VAKA · İNŞAAT
İhale dosyalarının madde madde karşılaştırılması
Bir işin idari şartnamesi, teknik şartnamesi, sözleşme tasarısı, birim fiyat tarifleri ve süreç içinde yayımlanan zeyilnameleri birkaç yüz sayfa tutuyor; bunların bir bölümü taranmış PDF olarak geliyor. Teklif mühendisi yeni gelen zeyilnameyi eski sürümle elle karşılaştırıyor, değişen maddeyi gözle yakalamaya çalışıyordu. Hangi maddenin risk taşıdığı kurumsal bir tanımda değil kişinin tecrübesinde durduğu için aynı dosyada iki mühendis farklı maddeleri işaretliyordu. Teklif verildikten sonra fark edilen bir gecikme cezası ya da fiyat farkı hükmü, artık müzakere edilemeyen bir maliyete dönüşüyordu.
Beklenen etki
- Kapsam
- İdari ve teknik şartname, sözleşme tasarısı ve zeyilnameler tek sürüm ağacında toplandı
- İzlenebilirlik
- Her fark satırı kaynak belgenin sayfasına ve madde numarasına bağlanıyor
- Ölçüm
- Gözden kaçan madde ile gereksiz işaretlenen madde ayrı ayrı izleniyor
- Karar sınırı
- Teklif kararı ve hukuki görüş insanda; sistem yalnızca incelenecek madde listesi üretiyor
Temsilî senaryo: buradaki satırlar ölçüm sonucu değil, bu kurulumda hangi büyüklüğün izlenmesi gerektiğini gösterir.
Bu kayıt gerçek bir müşteri işi değildir. Sinaptik Lab'in bu problemde izlediği yaklaşımı, mimari kararları ve ölçüm düzenini göstermek için yazılmış temsilî bir senaryodur: kurum adı taşımaz, içindeki hiçbir değer gerçek ölçüm değildir ve referans olarak gösterilemez. Gerçek projelerden vakalar müşteri onayı alındıkça bu kütüphaneye eklenir.
Problem
Bir işin idari şartnamesi, teknik şartnamesi, sözleşme tasarısı, birim fiyat tarifleri ve süreç içinde yayımlanan zeyilnameleri birkaç yüz sayfa tutuyor; bunların bir bölümü taranmış PDF olarak geliyor. Teklif mühendisi yeni gelen zeyilnameyi eski sürümle elle karşılaştırıyor, değişen maddeyi gözle yakalamaya çalışıyordu. Hangi maddenin risk taşıdığı kurumsal bir tanımda değil kişinin tecrübesinde durduğu için aynı dosyada iki mühendis farklı maddeleri işaretliyordu. Teklif verildikten sonra fark edilen bir gecikme cezası ya da fiyat farkı hükmü, artık müzakere edilemeyen bir maliyete dönüşüyordu.
Yaklaşım
Belgeleri serbest metin olarak gömmek yerine madde hiyerarşisini koruyan bir ayrıştırıcı yazıldı: her parça belge türü, bölüm, madde numarası ve sürüm etiketiyle saklandı, tablolar akan metne karıştırılmadan ayrı nesne olarak tutuldu. Karşılaştırma bir arama problemi gibi değil hizalama problemi gibi kuruldu; önce madde numarası ve başlık benzerliğiyle eşleşen madde çiftleri çıkarıldı, sonra yalnızca o çift modele tam metniyle verildi. Böylece bağlam bütçesi yüzlerce sayfayı kırpmaya değil iki maddeyi eksiksiz göstermeye harcandı. Çıktı bir özet değil madde madde fark listesi oldu: eklendi, çıkarıldı, anlam değişti, yalnızca biçim değişti; her satır kaynak sayfaya bağlı. Risk etiketleri kural tabanlı bir sözlükle işaretlendi, modelin takdirine bırakılmadı, çünkü riskin ne olduğu şirket politikasıdır.
Kullanılan teknolojiler
- Madde sınırlı parçalama
- Sürüm etiketli belge deposu
- Madde hizalama (numara ve gömü benzerliği)
- Tablo çıkarımı ve ayrı saklama
- Bağlam bütçesi yönetimi
- Kural tabanlı risk etiketleme
Bağlam, kurulum ve ölçüm
Problem ve yaklaşım özetin üstünde; burada kararların gerekçesi ve mimarinin ayrıntısı var.
Bağlam ve kısıtlar#
İhale dosyası tek bir belge değil, birbirine atıf yapan bir belge kümesidir: ilan, idari şartname, teknik şartname, sözleşme tasarısı, birim fiyat tarifleri, mahal listesi ve süreç içinde yayımlanan zeyilnameler. Teklif hazırlama süresi kısadır ve süre içinde dosya değişebilir. Orta ölçekli bir yüklenicinin teklif masası aynı anda birden fazla işe bakar; bir dosyaya ayrılan okuma zamanı dosyanın hacmiyle değil takvimle belirlenir.
Kısıt teknik olmaktan çok usulidir: teklif verildikten sonra bu maddeyi görmemişiz demenin bir karşılığı yok. Sözleşmenin eki haline gelen her hüküm bağlayıcıdır ve düzeltme yolu yoktur. Bu yüzden hedef dosyayı özetlemek değil, hiçbir maddenin okunmamış kalmadığını gösterebilmekti.
Veri ve erişim#
Belgeler ihale platformundan indiriliyor, sonra teklif mühendisinin dizüstünde ve paylaşılan sürücüde çoğalıyordu; aynı şartnamenin birden fazla kopyası dolaşıyor, hangisinin güncel olduğu dosya adındaki tarihe bakılarak tahmin ediliyordu. İlk iş veriyi tek yere almak ve her indirmenin ne zaman, hangi dosya adıyla ve kim tarafından geldiğini kaydetmekti. Sürüm bilgisi dosya adında değil kayıtta durur; dosya adı artık kimlik sayılmıyor.
- Metin katmanı olan PDF ile taranmış PDF ayrı işlenir; taranmış sayfalar sayfa bazında güven notuyla saklanır.
- Birim fiyat tarifleri ve mahal listeleri tablo olarak çıkarılır; satır ve sütun yapısı korunur, akan metne çevrilmez.
- Zeyilnameler ana metnin üzerine yazılmaz, ayrı sürüm olarak durur; hizalama sürümler arasında yapılır.
- Yaklaşık maliyet okuması, alt yüklenici fiyatları ve kâr beklentisi gibi ticari alanlar teklif masası dışına açılmaz.
- Girilmeyen işlerin dosyaları tanımlı süre sonunda arşive taşınır; çalışma deposunda süresiz durmaz.
Mimari kararlar#
İki tercih işin geri kalanını belirledi: parçalama sınırının madde sınırı olması ve karşılaştırmanın geri getirme yerine hizalamayla kurulması. Bağlam penceresi geniş bir model dosyanın tamamını alabiliyor gibi görünse de, fark bulma işinde dikkati yüzlerce sayfaya yaymak yerine iki maddeye kilitlemek daha kararlı sonuç verdi. Aynı sorunun iki kez sorulduğunda aynı cevabı vermesi, bu işte isabetten önce gelen gereksinimdi.
| Karar | Seçilen yol | Neden |
|---|---|---|
| Parçalama sınırı | Madde ve alt bent sınırı | Sabit pencere istisna cümlesini maddeden ayırıyor, hüküm eksik okunuyor |
| Karşılaştırma yöntemi | Numara ve başlıkla hizalama, sonra çift bazında karşılaştırma | Tek istemle nesi değişti sorusu uzun dosyada bölüm atlaması üretiyor |
| Tablolar | Ayrı nesne, satır ve sütun korunarak | Akan metne çevrilen tabloda birim fiyat satırı başka kaleme kayıyor |
| Risk yargısı | Kural tabanlı sözlük ve insan incelemesi | Riskin tanımı şirket politikasıdır; modele bırakılınca ihaleden ihaleye değişiyor |
| Çıktı biçimi | Kaynağa bağlı fark listesi | Serbest özet denetlenemez; fark satırı maddeye dönülerek doğrulanabiliyor |
Güvenlik ve yetki#
Teklif dosyası ticari sır taşır: yaklaşık maliyet okuması, alt yüklenici fiyatları, şirketin kâr beklentisi. Erişim iş bazında verildi; bir işe atanmayan kullanıcı o işin belgelerini ve fark raporunu göremez. İstem ve yanıt kayıtları da aynı yetkiyle korunur, çünkü kayıt içinde madde metni geçiyor. Dışa aktarma tek tıkla değil, kim ne zaman ne aldı kaydıyla yapılır.
Ölçüm düzeni#
- Kapanan her ihalede sistemin fark listesi ile mühendisin elle işaretlediği maddeler karşılaştırılır; atlanan madde ve gereksiz uyarı ayrı sayılır.
- Hizalama isabeti ayrı ölçülür: eşlenen madde çiftlerinin doğru çift olup olmadığı örneklemle denetlenir.
- Karakter tanıma güven notu düşük maddeler ayrı kuyrukta izlenir, isabet bu kuyruk için ayrıca raporlanır.
- Sözleşme yürürken ortaya çıkan hüküm sürprizleri geri besleme olarak kaydedilir: hangi madde, hangi aşamada görülmüş.
- Model sürümü değiştiğinde sabit bir karşılaştırma seti yeniden koşulur ve fark raporu satır bazında eski çıktıyla karşılaştırılır.
Devreye alma ve işletme#
- 1Dosya alımı
Belgeler indirildiği gibi, değiştirilmeden saklanır; her dosyanın özet karması ve alınma kaydı tutulur.
- 2Ayrıştırma ve etiketleme
Madde hiyerarşisi çıkarılır, tablolar ayrılır, taranmış sayfalar için sayfa bazında güven notu yazılır.
- 3Hizalama
Sürümler arasında madde çiftleri eşlenir; eşlenemeyenler yeni ya da kaldırılmış kuyruğuna düşer.
- 4Fark raporu
Her çift için değişiklik türü ve risk etiketi üretilir, satırlar kaynak sayfaya bağlanır.
- 5İnceleme ve kapanış
Teklif mühendisi satırları tek tek kapatır; hukuki görüş gereken maddeler işaretlenir ve rapor teklif dosyasına eklenir.
Nerede yanıldık#
İlk sürümde dosyanın tamamını tek istemde verip değişiklikleri listele demenin yeterli olacağını varsaydık; çıkan liste inandırıcı görünüyor ama sondaki bölümler sessizce atlanıyordu ve atlandığını ancak elle okuyan mühendis fark ediyordu. İkinci yanılgı zeyilnameyi ana metnin üzerine yazmak oldu: eski hüküm kaybolduğu için neye göre değişti sorusu cevapsız kaldı ve bir süre sürümler karıştı. Üçüncüsü risk etiketini modele bırakmaktı; aynı gecikme cezası maddesi bir koşuda yüksek, diğerinde orta geldi ve bu dalgalanma, etiketleme sözlüğe geçene kadar raporun güvenilirliğini aşağı çekti.
Bir sonraki projede ne değişir?
Bir vakanın en değerli bölümü sonuç değil, tekrar edilebilir dersidir.
- 01
Sabit uzunlukta parçalama şartname metninde işe yaramıyor: bir madde ortadan kesildiğinde istisna cümlesi başka parçada kalıyor ve hüküm olduğundan katı ya da olduğundan gevşek okunuyor.
- 02
Zeyilnameler çoğu zaman yalnızca değişen sayfaları taşıyor; gelen belgenin tam sürüm olduğu varsayımı sessiz bir veri kaybı üretti. Artık her zeyilnamenin hangi maddeleri kapsadığı ayrıca çıkarılıyor.
- 03
Modelden bu madde riskli mi diye sormak yerine bu iki madde arasındaki fark nedir diye sormak, uzun dosyada bölüm atlama davranışını ortadan kaldırdı; risk yargısı sözlükte ve insanda kaldı.
- 04
Taranmış sayfalarda karakter tanıma hatası sayıların içinde saklanıyor ve metinde göze çarpmıyor. Süre, oran ve tutar içeren maddelerde sayfa görüntüsü fark satırının yanında gösterilmeye başlandı.
- 05
Aynı madde numarasının farklı belgelerde tekrar etmesi hizalamayı bozuyor; madde numarası tek başına kimlik değil, belge türüyle birlikte kimliktir.
Vaka kütüphanesinden
- EğitimDers materyali üretiminde telif ve kaynak zinciriBir eğitim içeriği ekibinin slayt, çalışma kâğıdı ve ders notu arşivi yıllar içinde karışık kaynaklardan büyümüştü: internetten alınmış görseller, yabancı kitaplardan çevrilmiş paragraflar, farklı lisanslarla dolaşan açık ders materyalleri. Bir hak sahibi itiraz ettiğinde hangi paragrafın nereden geldiğini kimse söyleyemiyor; arama dosya adına ve ekip hafızasına kalıyordu. Model destekli üretim devreye girdikten sonra bu belirsizlik büyüdü, çünkü üretilen metnin dayandığı kaynak hiçbir yerde yazılı olmuyordu. Ekipte yaygın olan eğitim amaçlı kullanım serbesttir varsayımı da hiç denetlenmemiş bir varsayımdı.
- EğitimÖdeve biçimlendirici geri bildirim üretimiBir özel okul grubunda dil ve sosyal bilimler öğretmenleri her hafta çok sayıda yazılı ödev okuyordu; not zamanında giriliyordu ama öğrenciye dönen şey bir puan ile kısa bir genel yorumdu. Hangi öğrencinin hangi rubrik ölçütünde tekrar tekrar zorlandığı hiçbir yerde toplu olarak durmuyordu; öğretmen bunu kendi defterindeki izlenimden hatırlıyordu. Geri bildirim yazma işi mesai dışına taştığı için dönem başındaki ödevlerde ayrıntılı, dönem sonuna doğru tek cümleye inen bir kalite farkı oluşuyordu. Velinin gördüğü tabloda puan vardı, gerekçe yoktu.
- EğitimÖğrenci risk modelinde etik sınırlarBir yükseköğretim kurumunda akademik danışmanlar, dersi bırakma ya da kayıt yenilememe riski taşıyan öğrencilere ulaşmayı sezgiyle yapıyordu: yokluğu fark edilen öğrenciye yazılıyor, fark edilmeyen kimseye görünmüyordu. Devam bilgisi, ödev teslimleri ve öğrenme yönetim sistemi hareketleri ayrı sistemlerde durduğu için kimse bunları tek bir öğrenci için yan yana koymuyordu. Danışmanın haftada yapabileceği görüşme sayısı sınırlıydı ama bu sınırın kime harcandığı hiçbir kayıtta yoktu. Risk modeli gündeme geldiğinde ilk itiraz teknik değildi: skor öğrenciye yapışan bir etikete dönerse ne olacağı soruldu.
BUILD
Aynı yaklaşımı kurumunuzda kurmak ister misiniz?
Discovery oturumunda mevcut durumunuzu, veri erişiminizi ve başarı tanımınızı birlikte yazıyoruz.