Nasıl Çalışır

Docufy'nin iş akış modeli ve komut aileleri

İş akışı modeli

Docufy, tüm komutlarda benzer bir çalışma modeli kullanır: girdi seçimi, dönüşüm stratejisi, yerel işlem ve çıktı/rapor.

1) Girdi belirleme

2) Strateji ve parametreler

Komutların çoğu ortak kontrol parametreleri paylaşır: kalite, metadata modu, çakışma politikası, tekrar deneme, rapor üretimi ve profil kullanımı.

docufy convert input.jpg --to webp --quality 85 --strip-metadata
docufy batch ./media --from jpg --to png --on-conflict versioned --retry 2

3) Yerel işleme katmanı

Tüm dönüşümler yerel makinede çalışır. FFmpeg / LibreOffice / Pandoc gerektiren dönüşümlerde ilgili aracın sistemdeki kurulumu kullanılır; dosyalar dış servislere gönderilmez.

4) Çıktı, rapor ve devam

Özellikle batch ve pipeline modlarında JSON raporla gözlemlenebilirlik sağlanır. Yarıda kalan operasyonlarda `--resume-from-report` ile başarılı adımlar atlanarak devam edilir.

docufy batch ./assets --from png --to jpg --report json --report-file ./reports/batch.json
docufy batch ./assets --from png --to jpg --resume-from-report ./reports/batch.json

Konfigürasyon önceliği

Genel öncelik sırası: CLI flag > ENV > proje config > default.

Komut aileleri özeti

Komut Kullanım amacı
convert Tek dosya dönüşümü ve temel medya format işlemleri
batch Toplu klasör/glob işleme, raporlama, resume
watch Klasör izleyip yeni dosyaları otomatik dönüştürme
pipeline run Çok adımlı JSON akışlarıyla otomasyon
video, audio, info Medya araçları ve metadata/teknik bilgi analizi