Template documents and example code

setup.py

@@ -46,7 +46,7 @@ def create_mo_files():
         'dateutils'
     ],
     url='https://github.com/zetaops/ulakbus',
-    packages=find_packages(exclude=['tests', 'tests.*']),
+    packages=find_packages(exclude=['tests', 'tests.*', '*.odt']),
     download_url='https://github.com/zetaops/ulakbus/archive/master.zip',
     package_data={
         'ulakbus': ['diagrams/*.bpmn'],

ulakbus/lib/doc_render/bap_komisyon_toplanti_tutanagi.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def bap_komisyon_toplanti_tutanagi_uret(context_data, wants_pdf=False):
+    """
+    BAP Komisyon toplantı tutanağı şablonu için kullanılabilir değişkenler:
+
+    -> karar_tarihi
+    -> oturum_no
+    -> karar_no
+    -> kararlar         : <list> Karar metinleri liste halinde buraya gelir.
+    -> baskan           : Toplantı başkanı adı
+    -> bap_koordinatoru : BAP Koordinatörü adı
+    -> uyeler           : <list> Toplamda 5 toplantı üyesi olmalı. 5 Zorunlu.
+
+
+    Args:
+        context_data (dict):
+        wants_pdf    (Bool):
+    Returns:
+        str: URL
+    """
+    template = "bap_komisyon_toplanti_tutanagi.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/bap_sozlesme.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def bap_sozlesme_uret(context_data, wants_pdf=False):
+    """
+    BAP Sözleşme Şablonu
+
+    Şablon içinde kullanabileceğiniz değişkenler:
+        -> proje_no             : BAP proje numarası
+        -> proje_basligi        : BAP proje başlığı
+        -> proje_yurutucusu     : BAP proje yürütücüsü (x2 in Template)
+        -> proje_butcesi        : BAP proje bütçesi
+        -> toplam_destek_tutari : Verilecek desteğin toplam değeri (TL)
+        -> sozlesme_imza_tarihi : Sözleşmenin imzalanma tarihi (x2 in Template)
+        -> bap_komisyon_baskani : BAP komisyon başkanının adı.
+        -> tuketim_malzemeleri  : Proje için gerekecek olan malzemelerin listesi.
+            ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+            --> yil          : Malzeme yılı
+            --> tur          : Malzeme türü
+            --> gerekce      : Malzeme kullanımı için gerekçe.
+            --> miktar       : Malzemenin ne kadar olacağı.
+            --> birim_fiyat  : Malzemenin birim fiyatı.
+            --> toplam_tutar : Malzemenin `miktar`ı ile `birim_fiyat`ının çarpımı.
+
+    Args:
+        context_data (dict): Template içinde kullanılacak olan değişkenler.
+        wants_pdf (Bool)     : Output olarak PDF isteniyorsa, True olmalı.
+
+    Returns:
+        str: Üretilmiş olan dökümanın, URL adresi.
+
+    """
+
+    template = "bap_sozlesme.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/dogrudan_tek_kaynak.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def dogrudan_tek_kaynak_uret(context_data, wants_pdf=False):
+    """
+    Doğrudan tek kaynak template.
+
+    Kullanılabilir değişkenler :
+        -> idare            : Hangi daire hazırlıyor, BAP vs.
+        -> alim_yapan_birim :
+
+        -> ongorulen_teslim_zamani :
+        -> ongorulen_yaklasik_bedel:
+        -> satici_unvan            :
+        -> satici_tebligat_adresi  :
+
+        -> satici_vergi_dairesi_ve_numarasi:
+        -> satici_telefon_ve_faks_numarasi :
+        -> satici_eposta_adresi            :
+        -> satici_ilgili_kisi              :
+
+        -> ihtiyac_konusu_malin_nitelikleri:
+        -> alimin_hangi_kapsamda_yapildigi :
+
+        -> alim_maddesi : Alım maddesi, 21-a,b,c bendine göre bir işeretleme şeklidir.
+                          Applied filters on alim_maddesi : string(), lower() (a, b, c)
+                          Örnek : a,b,c,A,B,C,"a" vs.
+        -> ihale_yetkilisi :
+            ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+            -> ad       :
+            -> gorev    :
+    Args:
+        context_data (dict):
+        wants_pdf    (bool):
+    Returns:
+        str: URL
+    """
+    template = "dogrudan_tek_kaynak.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/mal_ve_hizmet_alimlari_onay_belgesi.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def mal_ve_hizmet_alimlari_onay_belgesi_uret(context_data, wants_pdf=False):
+    """
+    Mal ve hizmet alımları onay belgesi template değişkenleri:
+
+    -> i_f_no       : Belgenin sağ üst köşesinde yer alan bir numara.
+    -> alimi_yapan_idare_adi    :
+    -> belge_tarih_ve_sayisi    :
+    -> isin_tanimi              :
+    -> isin_niteligi            :
+    -> isin_miktari             :
+    -> yaklasik_maliyet         :
+    -> kullanilabilir_odenek_tutari:
+    -> proje_numarasi           :
+    -> butce_tertibi            :
+    -> alim_usulu               : Alım usulü veya şekli.
+    # Bundan sonraki degerler örnek dökümanda çok basit cevaplanmış.
+    # Yoktur, düzenlenmeyecektir, verilmeyecektir gibi.
+    -> avans_verilme_sartlari   :
+    -> ilanin_sekli_ve_adedi    :
+    -> sartname_duzenlemesi     :
+    -> sozlesme_duzenlemesi     :
+
+    -> alim_ile_ilgili_aciklama : Alım yapan kişinin ve neden alım yapıldığı.
+    -> arastirma_gorevlileri    : Piyasa araştırması yapmakla görevli araştırmacı personel.
+        ### Bu bir list olmalıdır ve sadece isimleri yer almalıdır.
+        ### Örnek kullanım : for gorevli in arastirma_gorevlileri: print (gorevli)
+
+    -> belge_imza_tarihi        : İmzanın atıldıgı kısımda yer alır.
+    -> gorevli      :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> ad      : Görevli adı.
+        --> unvan   : Görevlinin unvanı. Project Executor vs.
+    -> ihale_yetkilisi :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> ad      : İhale yetkilisi ad.
+        --> unvan   : Ünvanı
+
+    Args:
+        context_data (dict): Template içinde kullanılacak olan değişkenler.
+        wants_pdf (Bool)     : Output olarak PDF isteniyorsa, True olmalı.
+
+    Returns:
+        str: Üretilmiş olan dökümanın, URL adresi.
+    """
+    template = "mal_ve_hizmet_alimlari_onay_belgesi.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/muayene_gorevlendirmesi.py

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def muayene_gorevlendirmesi_uret(context_data, wants_pdf=False):
+    """
+    Muayene görevlendirmesi dilekçe şablonu üretir.
+
+    Template içerisinde kullanabileceğiniz değişkenler:
+
+        -> dilekce_sayisi           :
+        -> dilekce_tarihi           : Oluşturulma tarihi. (x2 in Template)
+
+        -> gerceklestirme_gorevlisi :
+            ### Aşağıdaki niteliklere sahip, dict veya object gönderilmeli.
+            --> ad      :
+            --> unvan   :
+        -> harcama_yetkilisi :
+            ### Aşağıdaki niteliklere sahip, dict veya object gönderilmeli.
+            --> ad      :
+            --> unvan   :
+
+        -> muayene_komisyonu_idari_uzman     : Görevlendirilecek kişinin adı.
+        -> muayene_komisyonu_teknik_uzman    :
+        -> muayene_komisyonu_ambar_gorevlisi :
+
+    Args:
+        context_data (dict) : Variables for template engine.
+        wants_pdf (Bool)    : Output as PDF?
+    Returns:
+        str: URL
+    """
+    template = "muayene_gorevlendirmesi.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/piyasa_fiyat_arastirmasi_tutanagi.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+
+
+def piyasa_fiyat_arastirmasi_tutanagi_uret(context_data, wants_pdf=False):
+    """
+    Piyasa fiyat araştırması tutanağı şablonu.
+
+    !!!    Verilerin sıralı olmasına dikkat ediniz....
+
+    -> idare_adi    :
+    -> yapilan_isin_adi :
+    -> alim_yapan_gorevlilere_iliskin :
+    -> ihale_onay_belgesi_tarih_sayi  :
+
+    -> firmalar :
+        ### Bu bir liste olmalı. 3 Elemanlı. Yani 3 Firma olabilir. Eksik yazmayın!
+
+    -> malzemeler :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> sira_no :
+        --> adi     :
+        --> miktar  :
+        --> birim   :
+
+        --> f1_birim    : Şirket 1 'in vermiş olduğu birim fiyat.
+        --> f1_toplam   : Şirket 1 'in vermiş olduğu toplam fiyat. Birim * Adet.
+
+        --> f2_birim    : Şirket 2'nin vermiş olduğu birim fiyat.
+        --> f2_toplam   : Şirket 2'nin vermiş olduğu toplam fiyat. Birim * Adet.
+
+        --> f3_birim    : Şirket 3 için.
+        --> f3_toplam   : Şirket 3 için. Birim * Adet. Max. 3 şirket olabilir.
+
+    -> f1_genel_toplam : Firma 1'in teklifinin genel toplamı.
+    -> f2_genel_toplam : Firma 2'nin teklifinin genel toplamı.
+    -> f3_genel_toplam
+
+    -> malzeme_sayisi   : Kaç kalem malzeme alındığı bilgisi.
+    -> uygun_gorulen_firma_adi_adresi : İhaleyi kazanan, firma bilgisi.
+    -> uygun_gorulen_teklif_tutari    : İhaleyi ne kadar ile kazandı.
+
+    -> gorevli :
+        ### Bu bir liste olmalı. Liste elemanları dict ile şunları içermeli.
+        --> ad      : Görevlinin adı
+        --> unvan   : Görevlinin ünvanı
+        # Örnek erişim >>> gorevli[0].ad
+    -> harcama_yetkilisi :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> ad      : Harcama yetkilisinin adı
+        --> unvan   : Ünvanı. BAP Koordinatorü vs.
+    -> belge_imza_tarihi : Belgenin imzalanma tarihi. En altta yer alıyor.
+
+    Args:
+        context_data (dict): Context data
+        wants_pdf    (Bool):
+    Returns:
+        str: URL rendered doc.
+    """
+    template = "piyasa_fiyat_arastirmasi_tutanagi.odt"
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url

ulakbus/lib/doc_render/siparis_formu.py

@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (C) 2015 ZetaOps Inc.
+#
+# This file is licensed under the GNU General Public License v3
+# (GPLv3).  See LICENSE.txt for details.
+
+from ulakbus.lib.document import RenderDocument
+import datetime
+
+
+def siparis_formu_uret(context_data, wants_pdf=False):
+    """
+    Sipariş formu için gerekli context data.
+
+    -> isin_niteligi         :
+    -> butce_tertibi         :
+    -> isin_adi_veya_miktari :
+    -> malzemeler            : 1..*
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> sira_no :
+        --> adi     :
+        --> miktar  :
+        --> birim   :
+
+    -> yuklenici_firma_adi   : (x2 in Template)
+    -> tebligata_esas_adresi :
+    -> siparis_bedeli        :
+    -> odeme_saymanligi      :
+    -> vergi_resim_ve_harclar:
+    -> garanti_suresi_ve_sartlar:
+    -> yedek_parca_montaj_sartlari:
+    -> teslim_suresi         :
+    -> belge_yili            : Bulunulan yıl, 2017. (x3 in Template)
+    -> gerceklestirme_gorevlisi :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> ad   : Kişi adı, Prof. Someone
+        --> unvan: Proje yürütücüsü, BAP Koordinatörü vs.vs.
+    -> harcama_yetkilisi :
+        ### Aşağıdaki attributelara sahip bir dict veya object olmalı.
+        --> ad   : Kişi adı, Prof Someone
+        --> unvan: BAP koordinatörü vs.vs.
+
+    Args:
+        context_data (dict): Context variables for template engine.
+        wants_pdf    (Bool): Output as PDF ?
+    Returns:
+        str: URL of produced document.
+    """
+    # Set current year.
+    context_data['belge_yili'] = datetime.datetime.now().year
+    template = "siparis_formu.odt"
+
+    rd = RenderDocument(template_name=template,
+                        context=context_data,
+                        wants_pdf=wants_pdf)
+    return rd.doc_url