Teknik Referans

Dosya Yapısı

Colpan\
├── Colpan.exe                  (Ana uygulama)
├── QtPdfView.exe               (Bağımsız PDF viewer)
├── Qt6Core.dll                 (Qt çekirdek kütüphanesi)
├── Qt6Gui.dll                  (Qt GUI kütüphanesi)
├── Qt6Widgets.dll              (Qt widget kütüphanesi)
├── Qt6Pdf.dll                  (Qt PDF kütüphanesi)
├── Qt6PdfWidgets.dll           (Qt PDF widget'ları)
├── Qt6Concurrent.dll           (Qt paralel işlem)
├── Qt6Network.dll              (Qt ağ kütüphanesi)
├── Qt6Xml.dll                  (Qt XML kütüphanesi)
├── Qt6PrintSupport.dll         (Qt yazdırma desteği)
├── quazip.dll                  (ZIP kütüphanesi)
├── zlib.dll                    (Sıkıştırma kütüphanesi)
├── platforms\                  (Qt platform eklentileri)
│   └── qwindows.dll
├── imageformats\               (Görsel formatlar)
│   ├── qsvg.dll
│   └── qico.dll
├── styles\                     (Qt stil eklentileri)
│   └── qmodernwindowsstyle.dll
└── udf2pdf_portable\           (PDF dönüştürücü)
    ├── udf2pdf_simple.bat      (Başlatıcı script)
    ├── udf2pdf.jar             (Java uygulaması)
    └── jre-25-custom\          (Gömülü Java)

İndeks Dosya Formatları

header.txt

Dosya listesi ve hash eşleştirmesi:

# Format: hash|path|size|modified|offset|length
a1b2c3d4|C:\docs\file1.udf|1024000|2024-12-22T10:30:00|0|32768
b2c3d4e5|C:\docs\file2.udf|2048000|2024-12-21T15:45:00|32768|65536

content.idx

Hash → konum haritası:

# Format: hash offset length
a1b2c3d4 0 32768
b2c3d4e5 32768 65536

content.bin

• Binary format
• 32 MB hizalı bloklar
• Normalize edilmiş UTF-8 içerik

Ayar Dosyası

Konum: %APPDATA%\Colpan\settings.ini

[Settings]
ThemeMode=3
PreviewSide=true
StartWithWindows=false
SonucLimit=1000
AktifProfil=0

[Profiles]
Count=5

[Profile_0]
name=Profil 1
icon=1
color=#FF5733

[Profile_0_Dirs]
count=2
0\path=C:\Documents
0\active=true
0\excluded=false
1\path=D:\Archive
1\active=true
1\excluded=false

Log Dosyası

Konum: %TEMP%\Colpan\colpan.log

Log Seviyeleri:

• DEBUG: Detaylı teknik bilgi
• INFO: Normal işlem bilgisi
• WARNING: Uyarı mesajları
• ERROR: Hata mesajları

Komut Satırı Parametreleri

Colpan.exe [seçenekler]

Seçenekler:
  --minimized     Tray'de başlatır
  --profile N     Belirli profille başlatır (0-4)
  --search "..."  Otomatik arama başlatır

Örnekler:

# Tray'de sessiz başlat
Colpan.exe --minimized

# Profil 3 ile başlat
Colpan.exe --profile 2

# Başlatıp otomatik arama yap
Colpan.exe --search "boşanma ; nafaka"

Desteklenen Dosya Formatları

Format	Uzantı	Destek
UYAP UDF	.udf	Tam destek
PDF (çıktı)	.pdf	Oluşturma/Görüntüleme

Sistem Gereksinimleri (Detaylı)

Bileşen	Minimum	Önerilen	Notlar
OS	Windows 10 64-bit	Windows 11	32-bit desteklenmez
CPU	2 çekirdek	4+ çekirdek	Paralel arama için
RAM	4 GB	8 GB+	Büyük indeksler için
Disk	500 MB	2 GB+	İndeksler için
Ekran	1366x768	1920x1080	Daha iyi kullanım
.NET	Gerekli değil	-	Qt tabanlı
Java	Gerekli değil	-	Gömülü Java

Port Kullanımı

Port	Kullanım
39876	PDF daemon iletişimi (Java)
9308	Manticore Search HTTP API
9306	Manticore Search MySQL protokolü

Geçici Dosyalar

Konum	İçerik
%TEMP%\Colpan\	İndeksler, loglar
%TEMP%\Colpan\pdf_cache\	PDF önbellekleri
%TEMP%\Colpan\Profil_N\	Hash index dosyaları
%TEMP%\Colpan\manticore_data_N\	Manticore Search veritabanı

AI Asistan Ayarları

API Endpoint’leri:

Mod	Endpoint
CF Worker	Cloudflare Worker proxy
Direct OpenRouter	https://openrouter.ai/api/v1/chat/completions

Ayar Dosyasında:

[AI]
UseWorker=true
ApiKey=sk-or-v1-xxx
Model=anthropic/claude-3-haiku

Dönüştürücü Modları

Mod	Açıklama
OriginalUyapEditor	Java daemon tabanlı (port 39876)
ColpanUdf2Pdf	Native Qt/C++ dönüştürücü

Ayar Dosyasında:

[PDF]
ConverterType=0  # 0=Java, 1=Native

Desteklenen Giriş Formatları

Format	Uzantı	Dönüşüm Yolu
UYAP UDF	.udf	Direkt → PDF
RTF	.rtf	RTF → UDF → PDF
FODT	.fodt	FODT → UDF → PDF
DOCX	.docx	LibreOffice → RTF → UDF → PDF
DOC	.doc	LibreOffice → RTF → UDF → PDF
ODT	.odt	LibreOffice → RTF → UDF → PDF

Sürüm Bilgisi

v1.1.0 (Şubat 2026)

• AI Sorgu Asistanı (CF Worker + OpenRouter)
• Manticore Search entegrasyonu (BM25 ranking)
• Native Qt dönüştürücü (ColpanUdf2Pdf)
• RTF/FODT import desteği
• LibreOffice zinciri (DOCX/DOC/ODT)

v1.0.0 (Aralık 2025)

• İlk kararlı sürüm
• 5 profil desteği
• Hash tabanlı indeksleme
• Entegre PDF viewer
• 4 tema seçeneği
• Global kısayollar