Otel programı için dosya biçimi

1Genel bakış

Otel programı bildirilecek misafirleri kbs_bekleyen.txt dosyasına yazar. KBS Köprüsü bu dosyayı birkaç dakikada bir okur, girişleri ve çıkışları KBS'ye bildirir, sonucu kbs_sonuc.txt dosyasına yazar. Otel programı sonucu okuyup kendi veritabanındaki bildirim bayrağını günceller.

KBS kullanıcı adı, şifre ve öteki KBS bilgileri KBS Köprüsü'nün kendi ayarlarında durur. Otel programı bunlarla ilgilenmez.

2Dosyalar

Otel programı ve KBS Köprüsü aynı klasörü kullanır, örneğin C:\KBS\. Klasör başka bir bilgisayardaysa ağda paylaşılır ve iki bilgisayar da bu klasöre yazabilir.

Klasörde KBS Köprüsü'nün kendi kullandığı kbs_kopru.kilit dosyası da durur. Otel programı ona dokunmaz.

3kbs_bekleyen.txt

Otel programının yazdığı misafir dosyası.

kayitno;bayrak;durum;oda;ad;soyad;kimlikno;uyruk;cinsiyet;dogumtarihi;dogumyeri;giris;cikis;plaka;telefon;eskikimlikno
12345;0;icerde;105;Ayşe;Yılmaz;12345678901;TC;K;14.03.1985;İzmir;23.10.2026 14:05;;35ABC123;05321234567;
12346;1;cikti;107;John;Smith;C01X00T47;GBR;E;02.07.1979;London;21.10.2026 16:30;23.10.2026 11:10;;;
12347;1;iptal;110;Mehmet;Kaya;98765432109;TC;E;01.01.1990;Aydın;23.10.2026 09:00;;;;
12348;1;icerde;108;Elif;Demir;23456789012;TC;K;05.09.1992;Bursa;22.10.2026 18:20;;;;
12349;0;icerde;112;Anna;Müller;C7F2K91LX;DEU;;11.05.1988;Berlin;23.10.2026 13:40;;;;
12350;3;icerde;114;Mehmet;Öztürk;34567890123;TC;E;20.06.1979;Denizli;22.10.2026 20:15;;;;34567890132
12351;0;icerde;116;;;45678901234;TC;;;;23.10.2026 14:02;;;;
#SON

Kurallar

• Karakter kodlaması UTF-8, ayraç noktalı virgül.
• İlk satır yukarıdaki başlık satırının aynısıdır, sütunlar bu sırada yazılır.
• Son satır #SON. KBS Köprüsü #SON satırı olmayan dosyayı yarım sayar ve okumaz.
• Gönderilecek misafir yoksa da dosya yazılır: yalnız başlık satırı ve #SON. KBS Köprüsü dosyanın hiç olmamasını otel programının çalışmadığı ya da klasörün yanlış seçildiği şeklinde anlar ve uyarır.
• Otel programının dosyayı belli aralıklarla, örneğin beş dakikada bir, kendiliğinden yeniden yazması zorunlu değildir. Ama yazarsa KBS Köprüsü'nün penceresinde dosyanın son yazıldığı saat hep güncel görünür. Saat ilerlemiyorsa resepsiyon otel programının kapandığını ya da dosyayı yazamadığını hemen fark edip önlem alabilir.
• Otel programı dosyayı her seferinde kendi veritabanından baştan üretir: o anda bayrağı 0, 1 ya da 3 olan bütün kayıtları (daha önce yazılmış olsalar da) yeniden yazar. Bayrağı 2 olan kayıt yazılmaz. Mevcut dosyanın sonuna ekleme yapılmaz.
• Otel programı dosyayı önce aynı klasörde geçici bir adla (örneğin kbs_bekleyen.tmp) yazar, sonra eski kbs_bekleyen.txt dosyasının üzerine taşır. Böylece KBS Köprüsü hiçbir zaman yarım dosya görmez. KBS Köprüsü okurken otel programının dosyayı değiştirmesine engel olmaz.
• Değerlerin içinde noktalı virgül ve satır sonu bulunmaz. Otel programı, örneğin adın ya da doğum yerinin içinde noktalı virgül geçerse onu virgüle çevirir. Yoksa sütunlar kayar ve KBS Köprüsü o satırı göndermez.

Sütunlar

Hangi bilgiler zorunlu

Polis ve Jandarma aşağıdakiler olmadan misafiri kabul etmez. KBS Köprüsü de bu misafiri göndermez ve sonuç dosyasına nedenini yazar. Otel programının bu bilgileri önceden denetlemesi gerekmez.

Hangi kayıtlar dosyaya yazılır

Bayrağı 2 olan kayıtlar (çıkışı bildirilmiş) dosyaya yazılmaz.

4kbs_sonuc.txt

KBS Köprüsü'nün yazdığı sonuç dosyası, UTF-8. Otel programı yalnız okur.

kayitno;islem;bayrak;sonuc;mesaj;zaman;ad;soyad
12345;giris;1;tamam;Jandarma'ya giriş bildirildi.;23.10.2026 14:07;;
12346;cikis;2;tamam;Jandarma'ya çıkış bildirildi.;23.10.2026 14:07;;
12348;oda;1;tamam;Jandarma'da oda güncellendi (104 → 108).;23.10.2026 14:07;;
12349;giris;0;hata;Cinsiyet yazılmamış. Jandarma pasaportlu misafirde cinsiyeti zorunlu istiyor.;23.10.2026 14:07;;
12350;duzeltme;3;tamam;Eski kayıt KBS'den çıkarıldı. Doğru bilgilerle giriş yapılacak.;23.10.2026 14:07;;
12351;giris;1;tamam;Jandarma'ya giriş bildirildi.;23.10.2026 14:07;ME*****;KA*****
#SON

islem sütunu giris, cikis, oda ya da duzeltme olur. iptal durumundaki kaydın sonucu da cikis olarak gelir.

ad ve soyad sütunları yalnız başarılı girişte ve otel programı o alanı kbs_bekleyen.txt dosyasında boş gönderdiyse dolar: KBS'nin gösterdiği maskeli hâl, örneğin ME*****. Öteki satırlarda boştur. Otel programı bunları isterse kendi ekranında gösterebilir ya da kaydına yazabilir. Satır, otel programı bayrağı güncelledikten sonra dosyadan silinir, bu yüzden tamam satırı işlenirken birlikte okunur.

• sonuc = tamam: otel programı kendi veritabanında o kaydın bayrağını bayrak sütunundaki değere çevirir. Satırdaki bayrak veritabanındakinden büyükse ya da veritabanındaki bayrak 3 ise uygular, değilse geçer. Dosya birkaç dakikada bir okunduğu için aynı satır birden çok kez görülür, bu kural tekrar okumayı zararsız yapar.
• sonuc = hata: bayrak değişmez. Otel programı mesaj sütununu kullanıcıya gösterebilir. Kullanıcı kaydı düzeltince KBS Köprüsü yeniden dener.

Otel programı bu dosyayı silmez ve içindeki satırları temizlemez. KBS Köprüsü sonuç satırlarını kendisi temizler, otel programının bir şey yapması gerekmez.

Otel programı dosyayı okuyup hemen kapatır, açık tutmaz. Dosya açık kalırsa KBS Köprüsü yeni sonuçları yazamaz.

5Durum ve Şimdi gönder

Bu iki dosya zorunlu değildir. Otel programı isterse KBS Köprüsü'nün durumunu kendi ekranında gösterebilir ve kullanıcıya bir "Şimdi gönder" düğmesi sunabilir. Bunları kullanmayan otel programı da KBS Köprüsü'yle sorunsuz çalışır.

kbs_durum.txt — KBS Köprüsü çalışıyor mu

Otel programı bu dosyayla resepsiyona "KBS Köprüsü çalışıyor" ya da "KBS Köprüsü çalışmıyor" gösterebilir. Örneğin KBS Köprüsü'nün çalıştığı bilgisayar kapatılmışsa resepsiyon bunu otel programından görür. KBS Köprüsü bu dosyayı dakikada bir yazar.

zaman;surum;oturum;bekleyengiris;bekleyencikis;sontur;hata
24.10.2026 14:08:00;2026.10.24.1;acik;0;1;24.10.2026 14:07:12;
#SON

kbs_simdi.txt — Şimdi gönder

KBS Köprüsü birkaç dakikada bir gönderir. Otel programı, beklemeden gönderim isteyen kullanıcı için bir "Şimdi gönder" düğmesi koyabilir. Düğme klasöre kbs_simdi.txt adında boş bir dosya bırakır. KBS Köprüsü bir dakika içinde dosyayı görür, siler ve gönderimi başlatır.

6Otel programının yapacakları

1. Misafir dosyasını güncel tutmakBir misafir kaydedildiğinde, düzeltildiğinde, çıkış yaptığında, silindiğinde ya da bildirim bayrağı değiştiğinde otel programı kbs_bekleyen.txt dosyasını kendi veritabanından baştan üretir. Dosyaya o anda bayrağı 0, 1 ya da 3 olan bütün kayıtlar (daha önce yazılmış olsalar da) yazılır. Bayrağı 0 olan misafirin girişi henüz bildirilmemiştir, KBS Köprüsü girişi bu satırdan bildirir. Bayrağı 1 olan misafir hâlâ oteldedir: KBS Köprüsü oda değişikliğini ve çıkışı bu satırdan görür. Bayrağı 3 olan misafirin kimlik bilgisi KBS'de düzeltilmeyi bekler. Bayrağı 2 olmuş kayıt artık yazılmaz. Örneğin 12345 numaralı misafirin çıkışı bildirilip bayrağı 2 olduysa bir sonraki dosyada 12345 yer almaz. Mevcut dosyanın sonuna ekleme yapılmaz.
2. Sonuçları işlemekOtel programı kbs_sonuc.txt dosyasını birkaç dakikada bir okur. Bu dosyaya hiçbir şey yazmaz. Her satırda:
   • tamam: veritabanında kayıt numarası aynı olan kaydın bayrağını kbs_sonuc.txt satırındaki bayrak değeri yapar. Yalnız satırdaki bayrak veritabanındakinden büyükse ya da veritabanındaki bayrak 3 ise.
   • hata: veritabanındaki bayrağa dokunmaz. Mesajı kullanıcıya gösterebilir.
3. Silinen misafiri KBS'den çıkarmakGirişi KBS'ye bildirilmiş (bayrağı 1 olan) bir misafir otel programında silinirse misafir KBS'de kayıtlı kalmaya devam eder. KBS'den çıkması için:
   • Otel programı silinen kaydın bilgilerini saklar ve kaydı kbs_bekleyen.txt dosyasına durumu iptal olarak yazmaya devam eder.
   • KBS Köprüsü misafiri KBS'den çıkarır, sonuç dosyasına tamam ve bayrak 2 yazar.
   • Otel programı saklanan kaydın bayrağını 2 yapar. Kayıt artık dosyaya yazılmaz, saklanan bilgisi silinebilir.
   Silinen kayıt dosyadan hemen çıkarılırsa KBS Köprüsü onu göremez ve misafir KBS'de kayıtlı kalır. Girişi hiç bildirilmemiş (bayrağı 0 olan) kayıt silinirse dosyaya yazılmaz, KBS'de yapılacak bir şey yoktur.
4. Kimlik bilgisini düzeltmekGirişi KBS'ye bildirilmiş, içerideki bir misafirin kimlik bilgisi (ad, soyad, kimlik numarası, uyruk, doğum tarihi gibi) otel programında düzeltilirse KBS'deki kayıt yanlış kalır. KBS'de de düzeltilmesi için:
   • Otel programı kaydın bayrağını 3 yapar. Düzeltilen kimlik numarasının kendisiyse eski numarayı eskikimlikno sütununa yazar. Bu yazılmazsa KBS Köprüsü KBS'deki eski kaydı bulamaz ve o kayıt KBS'de kalır.
   • KBS Köprüsü KBS'deki eski kaydı çıkarır (Jandarma'da "yanlış girilmiş kayıt" olarak), sonra doğru bilgilerle yeniden giriş yapar. Arada sonuç dosyasına duzeltme;3;tamam yazar, otel programı bu satırla bir şey yapmaz.
   • Düzeltme bitince sonuç dosyasına duzeltme;1;tamam gelir. Otel programı bayrağı 1 yapar ve eskikimlikno'yu boşaltır.
   Bayrak 3 yalnız içerideki misafir için kullanılır.
5. Yeniden göndermekMisafir KBS'den yanlışlıkla çıkarıldıysa ya da yeniden bildirilmesi gerekiyorsa otel programı kaydın bayrağını 0 yapar. KBS Köprüsü girişi yeniden bildirir.