Zaman takibinden faturalamaya: kayıtları markalı PDF'lere dönüştürme

Ne inşa ediyorsunuz ve neden önemli\n\nZaman takibi–fatura uygulaması yaygın bir karışıklığı çözer: saatler takvimlere, sohbetlere ve notlara dağılır. Sonra fatura günü geldiğinde ayı elle yeniden oluşturmak gerekir. İşte hatalar burada ortaya çıkar: fatura atlanan saatler, yanlış oranlar, tekrar eden satırlar veya tutarların uymaması.\n\nBu uygulama saatte fatura kesen ve tekrarlanabilir bir süreç isteyen herkes içindir: birden fazla müşteriyi yöneten serbest çalışanlar, aynı projeye birden fazla kişinin zaman kaydettiği ajanslar ve zamanı müşteriye ya da departmana geri tahakkuk eden dahili ekipler.\n\nAmaç pratiktir: proje bazlı zaman kayıtlarını yakalamak, bunları bir fatura kaydına toplamak ve müşterinin anlayabileceği markalı bir PDF üretmek. Bu iş akışı güvenilir olduğunda, faturalama aylık bir telaş olmaktan çıkar.\n\n"Önce basit" yaklaşımı genellikle şunları ifade eder:\n\n- Zaman kaydetmenin tek bir yolu (tarih, proje, saat, not)\n- Tek bir oran kuralı (proje başına veya kişi başına)\n- Her dönem için müşteri başına tek fatura\n- Logonuz ve işletme bilgilerinizle tek bir PDF düzeni\n- Net durumlar (Draft, Sent, Paid)\n\nKüçük bir senaryo: iki kişilik bir stüdyo "Client A - Website Updates" için zamanı takip ediyor. Herkes hafta içinde kayıt giriyor. Cuma günü, o proje ve tarih aralığı için bir fatura oluşturuyorsunuz; uygulama kayıtları fatura satırlarına dönüştürüyor ve PDF hiçbir yeniden yazma olmadan gönderilmeye hazır oluyor.\n\nAppMaster gibi bir no-code platform kullanıyorsanız, makbuzlar, çoklu para birimleri, indirimler veya onaylar gibi ekstraları eklemeden önce veriyi ve iş akışını doğru kurun. Çekirdek akış hızlı, doğru ve kırılması zor olduğunda bu eklentiler eklenmesi daha kolay olur.\n\n## Dahil edilecek temel özellikler (ilk sürümde neyi dışarıda bırakmalı)\n\nKüçük bir ilk sürüm sizi daha çabuk "gönderilebilir faturalar" noktasına getirir. Üç şeye odaklanın: zamanı yakalayın, zamanı anlaşılır fatura satırlarına dönüştürün ve müşterinin takip etmesine gerek kalmayacak bir PDF üretin.\n\nBaşlangıç için birkaç temel kayıt yeterlidir (sonradan yeniden adlandırabilirsiniz ama yapı önemlidir): Client, Project, Time Entry, Invoice ve Invoice Line.\n\nFatura iş akışınızı Invoice kaydında tek bir durum alanı ile basit tutun. Draft, Sent ve Paid pek çok ekip için uzun süre yeterlidir.\n\nOlmazsa olmaz eylemleriniz haftalık olanları yansıtmalı:\n\n- Zaman kaydı (manuel giriş genelde en hızlı ve düzeltmesi en kolay olandır)\n- Zamanı onaylama (basitçe bir "Approved" durumu bile olabilir)\n- Onaylanmış zamandan fatura oluşturma\n- PDF dışa aktarma\n\n"Markalı" olmak gösterişli olmak demek değildir. Tutarlı ve güvenilir olmak demektir: logo, işletme bilgileri, fatura numarası ve tarihler, net toplamlar ve ödeme talimatları.\n\nİlk başta şunları dışarıda bırakın: vergiler, indirimler, çoklu para birimi ve ekler. Bunlar faydalıdır ama yuvarlama, yargı kuralları, döviz kurları, dosya depolama gibi kenar durumlarını getirir ve ilk sürümü yavaşlatır.\n\n## Veri modeli: gereken kayıtlar ve önemli alanlar\n\nBir zaman takibi–fatura uygulaması veri modeline bağlıdır. Küçük ve öngörülebilir tutun ki toplamlar her zaman müşteriye verdiğinizle uyuşsun.\n\nMinimal tablo seti genellikle şöyle görünür:\n\n- Client: isim, fatura e-postası, fatura adresi, varsayılan para birimi, ödeme koşulları (ör. Net 14)\n- Project: client_id, proje adı, varsayılan saatlik oran (opsiyonel), aktif flag\n- Time entry: project_id, kişi (isim veya user_id), tarih, süre (saat), açıklama, rate_at_time, faturalandırılabilir (evet/hayır), invoiced_invoice_id (faturalanana kadar boş)\n- Invoice: client_id, project_id (opsiyonel), fatura numarası, düzenlenme tarihi, vade tarihi, durum, ara toplam, vergi, toplam\n\nOranlar uygulamaları karıştıran yerlerdir. Bir yaklaşım seçin ve ona bağlı kalın: proje başına oran, kişi başına oran veya görev/hizmet başına sabit oran.\n\nVarsayılan bir oran proje veya kişide saklansa bile, gerçek oranı her zaman bir zaman kaydına rate_at_time olarak kopyalayın (kayıt oluşturulurken veya onaylanırken). Bu, oranlar daha sonra değişse bile sürprizleri önler. Faturalar, işin yapıldığı zamandaki durumu yansıtmalıdır.\n\nZaman kayıtları için ayrı bir durum alanını genelde atlayabilirsiniz ve bunun yerine invoiced_invoice_id boş mu dolu mu ile kontrol edebilirsiniz. Faturalar için durumlar sıkı tutulmalı: Draft, Ready, Sent, Paid (gerekiyorsa temiz bir iptal durumu için Void ekleyin).\n\nAppMaster'da Data Designer, ilişkileri çoğaltmadan net tutmayı kolaylaştırarak PostgreSQL ile uyumlu bir eşleme sağlar.\n\n## Proje bazlı zaman kaydı yakalama (basit UX)\n\nZaman yakalama uygulamanın ya zahmetsiz hissettiren ya da göz ardı edilen kısmıdır. İlk sürümü sıkıcı ve hızlı tutun: tek ekran, tek temel eylem ve mümkün olduğunca az seçenek.\n\nBaşlamak için bir yakalama yöntemi seçin. Manuel giriş genelde erken kazanan olur çünkü herkes için çalışır ve gözden geçirmek kolaydır. Bir zamanlayıcı daha sonra eklenebilir; eklerseniz kaçırılan duraklar için manuel düzenlemelere izin verin.\n\nFaturalama kalitesini koruyan alanları zorunlu yapın:\n\n- Proje (veya müşteri + proje)\n- Tarih\n- Süre (saat ve dakika)\n- Kısa açıklama (müşterinin tanıyacağı bir şey)\n- Kişi (birden fazla kişi zaman kaydediyorsa)\n\nYuvarlama kurallarını erken karar verin çünkü bunlar güveni ve toplamları etkiler. Yaygın yaklaşım 6 dakikalık artışlar (0.1 saat). Her bir kaydı mı yoksa günlük toplamı mı yuvarladığınızı netleştirin. Her kaydı yuvarlamak açıklaması ve denetimi daha basittir.\n\nFaturalamaya birden fazla kişi dokunuyorsa hafif bir onay adımı ekleyin. Pratik bir kural: onaylandıktan sonra kayıtlar varsayılan olarak düzenlemeye kapansın. Eğer bir şey değişecekse, yöneticinin yeniden açmasını ve kimin neden değiştirdiğini kaydetmesini isteyin.\n\n## Zamanı fatura satırlarına dönüştürme (roll-up kuralları)\n\nRoll-up, ham kayıtların müşterinin anlayacağı fatura satırlarına dönüştüğü yerdir. Kuralları basit ve tekrar edilebilir tutun ki her oluşturulan faturaya güvenebilin.\n\nBaşlangıçta tek bir eyleme odaklanın: bir müşteri ve tarih aralığı seçin, sonra sadece faturalandırılmamış zaman kayıtlarını çekin. Bu filtre çift faturalamayı önleyen emniyet hattıdır. Bir kayıt eksik müşteri veya proje içeriyorsa, onu "faturaya hazır değil" olarak ele alın ve düzeltilene kadar roll-up dışında bırakın.\n\n### Kayıtları fatura satırlarına nasıl gruplayabilirsiniz\n\nGruplama, kaç satır oluşturacağınızı ve müşterinin ne kadar kolay inceleyeceğini belirler. Bir varsayılan seçin ve esneklik gerekiyorsa bir seçenek anahtarı ekleyin.\n\nYaygın gruplayıcı seçenekler:\n\n- Projeye göre\n- Kişiye göre (oranlar farklıysa kullanışlıdır)\n- Güne veya haftaya göre\n- Göreve/kategoriye göre (Tasarım vs Geliştirme)\n\nHangisini seçerseniz seçin, her satırda şunlar olmalı: net bir etiket, toplam saat, oran ve satır tutarı. Oranlar değişebiliyorsa, her kayda kaydedilmiş rate_at_time kullanın (veya "geçerli olan" tarihten itibaren efektif oran tablosu), tek bir "şimdiki oran" değil.\n\n### Faturalandı olarak işaretleme (kendi kendinize kök salmayın)\n\nKayıtları bir faturaya eklediğinizde, her zaman kaydına fatura ID'sini kaydedin. Bu bir denetim izi oluşturur ve aynı kaydın tekrar çekilmesini engeller.\n\nDüzeltmeler olabilir. Bir satırı bir faturadan kaldırırsanız, geçmişi silmeyin. Etkilenen zaman kayıtlarının fatura ID'sini temizleyin (bağlantıyı kaldırın), toplamları yeniden hesaplayın ve "2.0saat çıkarıldı, yanlış proje" gibi kısa bir not saklayın.\n\nAppMaster'da bu, tek bir iş süreci olarak kolayca uyum sağlar: faturalandırılmamış kayıtları sorgula, grupla, fatura satırlarını oluştur, sonra her kaydı ilgili fatura referansıyla güncelle.\n\n## Fatura kayıtları: toplamlar, numaralandırma ve durum\n\nFatura kaydı, daha sonra gönderebileceğiniz, takip edebileceğiniz ve denetleyebileceğiniz kapsayıcıdır. Birisi proje adını veya varsayılan oranı değiştirse bile sabit kalmalıdır.\n\nPratik bir fatura başlığı şunları içerir:\n\n- Fatura numarası (benzersiz, insan tarafından okunabilir)\n- Düzenlenme tarihi ve vade tarihi\n- Fatura edilecek taraf bilgileri (müşteri adı, fatura adresi, gerekiyorsa vergi numarası)\n- Notlar (ödeme talimatları, kısa teşekkür satırı)\n- Para birimi (ve uluslararası faturalama varsa kaydedilmiş döviz kuru opsiyonel olarak)\n\nToplamları öngörülebilir tutun. Ara toplam fatura satırlarının toplamıdır. Ardından indirim (sabit tutar veya yüzde) uygula, vergi hesapla (genelde indirim uygulanmış ara toplam üzerinden) ve nihai toplamı sakla. Kullanılan vergi oranını ve indirim değerlerini tam olarak kaydedin ki faturayı daha sonra yeniden üretebilesiniz.\n\nFatura numaralandırması gösterişli olmak zorunda değil. Bir desen seçin ve ona sadık kalın: ardışık (000123), yıl bazlı (2026-00123) veya müşteri önekli sıralama (ACME-014). Tutarlılık mükemmellikten daha önemlidir.\n\nDurum iletişim ve iç kontrol üzerine odaklanmalı:\n\n- Draft (düzenlenebilir, gönderilmemiş)\n- Ready (tutarlar kilitli)\n- Sent (müşteriyle paylaşıldı)\n- Paid (ödeme onaylandı)\n- Overdue (vade geçti)\n- Void (iptal edildi, geçmiş için saklandı)\n\n## Müşterinin okuyabileceği markalı bir PDF oluşturma\n\nİyi bir fatura PDF’i iki soruya hızlıca yanıt verir: ne faturalandırılıyor ve nasıl ödenecek. PDF’i fatura kaydından (ham zaman kayıtlarından değil) oluşturun ki belge her zaman fatura numarası, toplamlar ve durumla eşleşsin.\n\nÇoğu müşteri her seferinde aynı blokları bekler:\n\n- İşletme adınız, fatura numarası ve fatura tarihi ile başlık\n- Müşteri bilgileri (şirket, iletişim kişi, fatura adresi, gerekiyorsa vergi numarası)\n- Satır öğeleri (açıklama, miktar veya saat, oran, satır toplamı)\n- Toplamlar (ara toplam, vergi, indirim, genel toplam)\n- Ödeme koşulları (vade tarihi, kabul edilen yöntemler, kullanıyorsanız gecikme ücreti notu)\n\nMarka önemli ama okunabilirlik daha önemlidir. Bir vurgu rengi kullanın, temiz bir font seçin ve toplamların kolay taranmasını sağlayın.\n\nGerçek verilerle yerleşim sorunları ortaya çıkar. Uzun açıklamalar ve 30+ satırlı faturalarla test edin. Kolon başlıklarının yeni sayfalarda tekrarlanmasını ve toplamlar bloğunun birlikte kalmasını sağlayın.\n\nAppMaster içinde PDF üretiyorsanız, PDF’i faturanın bir çıktısı olarak değerlendirin: dosyayı (veya depolama referansını) fatura kaydına oluşturma zaman damgası ve sürüm ile kaydedin. Bu, müşteriye gönderilen tam belgeyi yeniden göndermeyi kolaylaştırır.\n\n## Adım adım inşa planı (no-code iş akışı)\n\n"Gerçek veri kaynağı"nın ne olduğuna karar verin. Zaman kayıtları ham gerçeklerdir. Faturalar, gönderilip daha sonra denetlenebilecek anlık görüntülerdir.\n\n### 1) Önce veriyi modelleyin\n\nTabloları ve ilişkileri oluşturun, sonra temel stabil hale geldikten sonra birkaç kalite alanı ekleyin:\n\n- Clients\n- Projects\n- Time Entries\n- Invoices\n- Invoice Lines\n\n### 2) İki basit ekran oluşturun\n\nUI’ı minimum tutun:\n\n- Zaman kaydı formu: proje, tarih, süre, not, kaydet\n- Fatura inceleme: müşteri, dönem, satırlar, toplamlar, durum\n\nYönetim ve inceleme için genelde bir web arayüzü yeterlidir. İnsanlar hareket halindeyse zaman kaydı için mobile ekranlar daha sonra ekleyin.\n\n### 3) Roll-up mantığını otomatikleştirin\n\nŞu akışı inşa edin: müşteri + tarih aralığı seç, faturalandırılmamış kayıtları getir, grupla, fatura satırlarını oluştur. Kayıtları yalnızca fatura onaylandıktan veya Ready durumuna geçirildikten sonra faturalandı olarak işaretleyin.\n\n### 4) PDF’i oluşturup saklayın\n\nFatura başlığı, müşteri bilgileri ve satırları bir şabloona çekip çıktıyı fatura kaydına kaydeden bir "PDF Oluştur" eylemi ekleyin.\n\n## Örnek: haftalık zaman kayıtlarından müşteriye gönderilecek faturaya\n\n3 kişilik bir ajansın bir müşterisi, Northstar Co, var ve iki hafta boyunca iki proje için faturalandırma yapıyor: Website Refresh ve Monthly Support. Ekipte Alex (tasarım), Priya (geliştirme) ve Sam (PM) var. Herkes günlük olarak müşteri, proje, tarih ve kısa bir not seçerek zaman kaydediyor.\n\nHer gün, kayıtlar Draft olarak kaydediliyor. Cuma öğleden sonra Sam, "Bu hafta, Northstar Co" filtresindeki inceleme ekranını açıyor. İki notu düzeltiyor ("Hero" yerine "Homepage hero"), faturalandırılabilirliği onaylıyor ve haftayı kilitliyor.\n\nO hafta için örnek kayıtlar şunlar:`\n\n| Date | Person | Project | Hours | Note |\n|---|---|---:|---:|---|\n| Mon | Priya | Website Refresh | 2.5 | Header layout fixes |\n| Tue | Alex | Website Refresh | 3.0 | New homepage mock |\n| Tue | Sam | Monthly Support | 1.0 | Client call |\n| Wed | Priya | Website Refresh | 4.0 | Contact form logic |\n| Thu | Alex | Monthly Support | 1.5 | Banner update |\n| Thu | Priya | Monthly Support | 2.0 | Email template tweak |\n| Fri | Sam | Website Refresh | 1.0 | QA and handoff |\n\nSam "Create invoice"a tıkladığında uygulama kayıtları basit kurallarla fatura satırlarına topluyor: proje ve faturalandırılabilir orana göre gruplama, saatleri toplama ve kısa bir açıklamayı aktarma. Fatura sonunda 3 satır içeriyor:\n\n| Line | Description | Qty | Rate | Amount |\n|---|---:|---:|---:|---:|\n| 1 | Website Refresh (Design) | 3.0 hrs | $120 | $360 |\n| 2 | Website Refresh (Development/PM) | 7.5 hrs | $140 | $1,050 |\n| 3 | Monthly Support | 4.5 hrs | $110 | $495 |\n\nSistem NS-2026-014 gibi bir fatura numarası atıyor, ara toplam ve vergiyi hesaplıyor ve durumu Ready yapıyor. Bir tıkla markalı bir PDF (logo, müşteri adresi, satır detayları, toplamlar, ödeme notları) oluşturuluyor. Gönderdikten sonra durum Sent olarak güncelleniyor ve alttaki zaman kayıtları faturalandı olarak işaretleniyor, böylece iki kez faturalama engelleniyor.\n\n## Yaygın hatalar ve nasıl kaçınılır\n\nÇoğu sorun matematik problemi değildir. İş akışı problemidir.\n\nFaturalanan zaman kayıtlarını kilitlememe. İnsanlar aynı kayıtları yeni bir fatura için değiştirebiliyorsa, sonunda çift faturalama olur. Bunu her zaman kaydında fatura referansı ile düzeltin ve faturalanan kayıtları "faturaya hazır" görünümünden gizleyin.\n\nOranlar değiştiğinde geçmişi yeniden yazma. Sadece "geçerli" proje veya kullanıcı oranını kullanırsanız, oran değiştiğinde eski faturalar da değişir. Her kayda geçerli olan oranı rate_at_time olarak kaydedin.\n\nOnaylanmış zamanı düzenleyip denetim izi bırakmama. Onaylayan kişi ve zaman için "Approved by", "Approved at" ve onay sonrası düzenlemeler için kısa bir değişiklik notu ekleyin.\n\nGerçek verilerle bozulan PDF şablonları. Uzun açıklamalar, çok sayıda satır ve büyük sayılar şablonu zorlar.\n\nHızlı düzeltmeler:\n\n- Maksimum açıklama uzunluğu belirleyin ve taşan kısmı notlar bölümüne taşıyın\n- Sarma (wrapping) yapmaya izin verin ve 30+ satırla test edin\n- Tabloya alan bırakmak için başlığı kompakt tutun\n- Tutarlı sayı formatları kullanın (para birimi, ondalık)\n\nBelirsiz durum akışı. Net kurallar yoksa faturalar iki kez gönderilir veya hiç gönderilmez.\n\nBasit ve güvenli bir akış: Draft -> Ready -> Sent -> Paid. Roll-up yalnızca Draft iken izin verin ve PDF üretimini yalnızca toplamlar kilitlendiğinde mümkün kılın.\n\n## Kısa bir kontrol listesi ve pratik sonraki adımlar\n\nFatura göndermeden önce hızlı bir gözden geçirme yapın. Bu en yaygın sorunları engeller: yanlış toplamlar, eksik bilgiler ve ekranda iyi görünen ama yazdırıldığında bozulan PDF'ler.\n\nGöndermeden önce kontrol listesi:\n\n- Müşteri bilgileri eksiksiz (resmi isim, fatura adresi, doğru iletişim)\n- Fatura dönemi doğru (başlangıç ve bitiş tarihleri yapılan işlemlerle eşleşiyor)\n- Toplamlar tutarlı (ara toplam, vergi, genel toplam kayıtlar, oranlar ve yuvarlama ile eşleşiyor)\n- Hiçbir zaman atlanmamış veya çift faturalandırılmamış (faturalandırılmamış zaman bırakılmadı, aynı şey iki kere dahil edilmedi)\n- Operasyonel alanlar temiz (benzersiz fatura numarası, doğru durum, faturada PDF kaydı)\n\nSonra PDF’i "yazıcı gözüyle" önizleyin. Logo yerleşimi, uzun adresler, tablo sarma ve sayfa sonlarını kontrol edin. Hem kısa (1-2 satır) hem de uzun (20+ satır) faturalarla test edin.\n\nTemeller stabil hale geldikten sonra sonraki adımlar:\n\n- Faturaları tutarlı bir şablonla e-posta ile gönderin\n- Stripe ödemelerini bağlayın ve faturaları otomatik olarak Paid yapın\n- Yalnızca doğru rollerin oranları, zamanı onaylamayı veya durumları değiştirmesini sağlayacak izinler ekleyin\n\nHızlıca kurup yinelemek istiyorsanız AppMaster (appmaster.io) no-code faturalama uygulaması oluşturmak için pratik bir seçenek sunar: gerçek bir veritabanı, iş mantığı ve PDF üretimi ile başlayın ve gereksinimler değiştikçe temiz kaynak kodu yeniden oluşturun.\n\nEğer bu hafta sadece bir şeyi düzeltecekseniz, "faturalandırılmamış zamanı" gözden kaçırmayı imkansız hale getirin. Bu tek şey saatler kazandırır ve geliri korur.