owned this note
owned this note
Published
Linked with GitHub
# Contract Management
Döküman süreçlerinin tasarımını versiyon, personel, servis check gibi kontrollerin yapılarak tek platformdan takip edilmesini sağlayan modül yapılacaktır.
Yeni oluşturulacak proje ile Döküman ve Kontrat Yönetimi yeni teknolojiler kullanılarak parametrik bir yapıda oluşturulup özel hizmete sunulacaktır.
Döküman veya döküman gruplarının, tanımlı olan kontroller ile eksik belgelerin veya güncellenmesi gereken sözleşmelerin client'a bilgilendiren servis yapısının parametrik olarak yapılması amaçlanmıştır.
Mevcutta DMS'nin yaptığı kontrolleri ve viewer kontrollerini bu proje kapsamında yönetiyor olacağız.
## Hedefler
- Uçtan uca Kontrat yönetimin sağlanması.
- Ayrı bir platform yaratmak
- Kayıt edilecek dokümanın kurallarını kontrol eder
- Doküman setlerinin hazırlanması
- Doküman şablonunun oluşturulması
- Doküman saklaması için tanımlanan platform a entegrasyon sağlanır
- Endostment entegrasyonu ile kural setlerimize uyan dokumanların onay mekanizmalarının çalıştırılması
- Client'lerın tüm sözleşme ve dokumanlar süreçlerinde kullanacakları api'ler geliştirmek
- Rule Management Module
- Document Percentage Module: Clientlara dökümanın belirli kısmını izleyebilir kılma (sadece imza sayfası gibi)
- Format Converter Module
## Definitions
- Document Type
- Döküman Dili(tr,ing,arp...)
- Kurallar
- Versiyon(Kural Seti)
- Kanal(Kural Seti)
- Mob Service kontrolleri
- Dokuman için Service kontrolu
- Döküman Grupları
-----------------------------
# Contract and Document İşlemleri
TEST: https://nonprod-apisix.burgan.com.tr/ebanking/contract/
PREPROD: https://preprod-apisix.burgan.com.tr/ebanking/contract/
DMZTEST: https://test-pubagw6.burgan.com.tr/ebanking/contract/
DMZPREPROD: https://preprod-pubagw6.burgan.com.tr/ebanking/contract/
| Column 1 | Column 2 |
| -------- | -------- |
| https://nonprod-apisix.burgan.com.tr/ebanking/contract/* | https://preprod-apisix.burgan.com.tr/ebanking/contract/*
| Text | Text |
| Text | Text |
| Text | Text |
| Text | Text |
## POST /contract/Instance
POST /contract/Instance endpoint'i, belirli bir müşteri için sözleşme örneği oluşturur ve müşterinin kontrata bağlı eksik belgelerini döndürür. Bu işlem, müşterinin hangi belgeleri onaylaması gerektiğini anlamasına yardımcı olur. İstek, sözleşmenin adını, referansı (genellikle TCKN veya VKN), sahibi ve işlemle ilgili bilgileri içerir. İşlem bilgileri, işlemi yapan istemci, kullanıcı, işlemin adı, durumu ve eylemi içerir. Bu endpoint, müşteri onayı gerektiren belgeleri yönetmek ve eksik belgeleri saptamak için kullanılır, böylece müşteriler gereken tüm belgeleri eksiksiz bir şekilde sunabilirler.
### Request Curl:
```
curl --location --request POST 'https://dev-amorphie-contract.burgan.com.tr/contract/Instance' \
--header 'Content-Type: application/json' \
--header 'Business_line: X' \
--header 'User_reference: 11223344558' \
--header 'Cookie: 79aa751ea7c0210235c7d1ba7d63a7c2=60bf996c67174c852f9e6723f3266901' \
--data-raw '{
"contractname": "dev-con-tr-test",
"reference": "11223344558",
"owner": "11223344558",
"process": {
"client": "ekyc-application",
"user": "34455667789",
"name": "ekyc-process",
"state": "load-document",
"action": "web-mobil-document-load"
}
}'
```
### Request Detayları
- **Header Parametreleri**
- **Content-Type**: İstek gövdesinin içeriğinin türünü belirtir. Bu örnekte `application/json` olarak ayarlanmış, yani gönderilen veri JSON formatındadır.
- **Business_line**: Mobil ON veya Mobil Burgan ayrımını belirten parametre.
- **ClientId**: İstek yapan müşterinin kimliğini belirten parametre.
- **Accept-Language**: İstemcinin tercih ettiği dil kodunu belirten parametre. Örneğin, "en-US" veya "tr-TR".
- **User_reference**: Genellikle müşterinin TCKN veya VKN bilgisini ifade eden referans bilgisi.
- **Cookie**: Oturum bilgileri gibi ek bilgileri taşımak için kullanılan HTTP cookie’si.
- **Request Body**
- `contractname`: Oluşturulacak sözleşmenin adı.
- `reference`: Sözleşme örneği ile ilişkilendirilen referans numarası.
- `owner`: Sözleşme sahibinin kimliği veya referans numarası.
- `process`: Sözleşme süreciyle ilgili detayları içeren nesne.
- `client`: İşlemin yapıldığı client türünü belirtir. Örneğin, "ekyc-application".
- `user`: İşlemi gerçekleştiren kullanıcının kimliği.
- `name`: İşlem sürecinin adı.
- `state`: Sürecin mevcut durumu.
- `action`: Gerçekleştirilecek eylemi belirten parametre.
### Response Detayları
```
{
"success": true,
"data": {
"code": "dev-con-tr-test",
"status": "InProgress",
"document": [
{
"name": "SÖZLEŞME ÖNCESİ BİLGİLENDİRME FORMU",
"status": "Active",
"code": "doc-sozlesme-oncesi-bildilendirme-formu",
"useExisting": "AnyValid",
"minVersion": "1.0.0",
"isRequired": true,
"documentDetail": {
"onlineSing": {
"templateCode": "cont-sozlesme-oncesi-bildilendirme-formu",
"version": "1.0.0"
}
}
},
{
"name": "KUR KORUMALI TÜRK LİRASI VADELİ MEVDUAT HESABI EK SÖZLEŞMESİ",
"status": "Active",
"code": "doc-kkm-hhesabi-ek-sozlesmesidir",
"useExisting": "AnyValid",
"minVersion": "1.0.0",
"isRequired": true,
"documentDetail": {
"onlineSing": {
"templateCode": "cont-kkm-hhesabi-ek-sozlesmesidir",
"version": "1.0.0"
}
}
}
],
"documentGroup": [
{
"required": true,
"status": "Active",
"title": "Login Belgeleri",
"at-least-required-document": 1,
"documentGroupDetailInstanceDto": {
"documentInstances": [
{
"name": "vk4",
"status": "Active",
"code": "vk4-test",
"useExisting": null,
"minVersion": "1.0.0",
"isRequired": false,
"documentDetail": {
"onlineSing": {
"templateCode": "doc-bankacilik-hizmetleri-sozlesmesi-30-VK4-1",
"version": "1.0.0"
}
}
},
{
"name": "vk5 test",
"status": "Active",
"code": "vk5-test",
"useExisting": null,
"minVersion": "1.0.0",
"isRequired": false,
"documentDetail": {
"onlineSing": {
"templateCode": "doc-bankacilik-hizmetleri-sozlesmesi-30-VK5-1",
"version": "1.0.0"
}
}
},
{
"name": "vk11-test",
"status": "Active",
"code": "vk11-test",
"useExisting": null,
"minVersion": "1.0.0",
"isRequired": false,
"documentDetail": {
"onlineSing": {
"templateCode": "doc-bankacilik-hizmetleri-sozlesmesi-30-VK11",
"version": "1.0.0"
}
}
}
],
"status": null,
"name": "Login Belgeleri",
"code": "login-doc-grup-test",
"id": "f3beaa2e-ba72-4700-b2df-019de51ced99"
}
}
]
},
"errorMessage": null
}
```
### Response Dönüş Değerleri
- **success**: İşlemin başarılı olup olmadığını belirten boolean bir değer.
- **data**: İşlem sonucunda dönen veri nesnesi.
- `code`: Sözleşmenin kodu. Sözleşmenin türünü belirten bir tanımlayıcıdır.
- `status`: Sözleşmenin mevcut durumu. Örneğin, "InProgress" sözleşmenin henüz tamamlanmadığını gösterir.
- `document`: İlgili belgelerin listesi.
- `name`: Belgenin adı.
- `status`: Belgenin durumu.
- `code`: Belgenin kodu.
- `useExisting`: Mevcut dokümanların kullanılıp kullanılmayacağını belirten bir alan. Örneğin, "AnyValid" herhangi bir geçerli dokümanın kullanılabileceğini gösterir..
- `minVersion`: Belgenin gerektirdiği minimum versiyon.
- `isRequired`: Belgenin zorunlu olup olmadığı.
- `documentDetail`: Belge detayları.
- `onlineSing`: Dijital onay ile ilgili detaylar.
- `templateCode`: İmza şablonunun kodu.
- `version`: İmza şablonunun versiyonu.
- `documentGroup`: İlgili belge gruplarının listesi.
- `required`: Grubun zorunlu olup olmadığı.
- `status`: Grubun durumu.
- `title`: Grubun başlığı.
- `at-least-required-document`: Grubun gerektirdiği minimum belge sayısı.
- `documentGroupDetailInstanceDto`: Belge grubu detayları.
- `documentInstances`: Belge örneklerinin listesi.
- `status`: Belge grubunun durumu.
- `name`: Belge grubunun adı.
- `code`: Belge grubunun kodu.
- `id`: Belge grubunun benzersiz tanımlayıcısı.
- **errorMessage**: Hata mesajı, işlem başarısız olduğunda hata detaylarını içerir.
## POST template-render/render/pdf
/template-render/render/pdf endpoint'i, belirtilen bir şablonu(document defination) kullanarak PDF formatında belge oluşturmak için tasarlanmış bir servistir. Bu servis, dinamik verilerle belirli bir şablonun doldurulup, sonucun PDF olarak geri dönmesini sağlar.
### Request Detayları
```
curl --location --request POST 'https://test-amorphie-contract.burgan.com.tr/template-render/render/pdf' \
--header 'Authorization: Bearer' \
--header 'User_reference: 11223344558' \
--header 'Business_line: X' \
--header 'Language: en-EN' \
--header 'Content-Type: application/json' \
--header 'Cookie: 80ba7bf6b241fbce6b86fb15ee661993=c504d2a83fd6a72c8331dd9438bd3136' \
--data-raw '{
"name": "cont-ddkkm-erken-kapama-talimati",
"render-data": {"customer":{"customerIdentity":"40156437404"}, "customerIdentity":40156437404, "Tarih":"06.03.2024"},
"render-data-for-log": {"customer":{"customerIdentity":"40156437404"}, "customerIdentity":40156437404, "Tarih":"06.03.2024"},
"semantic-version": "1.0.0"
}
```
- **Header Parametreleri**
- `User_reference`: Genellikle müşterinin TCKN veya VKN bilgisini ifade eden referans bilgisi.
- `Business_line`: Mobil ON veya Mobil Burgan ayrımını belirten parametre.
- `Language`: İstemcinin tercih ettiği dil kodunu belirten parametre. Bu örnekte "en-EN" olarak ayarlanmıştır.
- `Content-Type`: İstek gövdesinin içeriğinin türünü belirtir. Bu örnekte `application/json` olarak ayarlanmış, yani gönderilen veri JSON formatındadır.
- `Cookie`: Oturum bilgileri gibi ek bilgileri taşımak için kullanılan HTTP cookie’si.
- **Request Body**
- `name`: Kullanılacak şablonun adını(Template-name) belirten parametre.
- `render-data`: PDF oluşturulurken kullanılacak verileri içeren nesne. Bu veriler şablonda yer alacak dinamik içeriği belirler.
- `render-data-for-log`: Loglama amacıyla kullanılacak verileri içeren nesne. Genellikle `render-data` ile aynı içeriğe sahiptir fakat loglama sırasında farklı bir amaçla kullanılabilir.
- `semantic-version`: Şablonun kullanılacak semantik versiyonunu belirten parametre.
### Response Detayları
```
data": {
"templateRenderRequestModel": {
"name": "cont-ddkkm-erken-kapama-talimati",
"render-id": "beb8ec55-c51f-4986-a882-dcc4a16f5720",
"render-data": {
"customer": {
"customerIdentity": "40156437404"
},
"customerIdentity": 40156437404,
"Tarih": "06.03.2024"
},
"render-data-for-log": {
"customer": {
"customerIdentity": "40156437404"
},
"customerIdentity": 40156437404,
"Tarih": "06.03.2024"
},
"semantic-version": "1.0.0",
"process-name": null,
"identity": "11223344558"
},
"content": "JVBERi0xLjQKMSAwIG9iago8PAovVGl0bGUgKP7/AHAAZABmKQovQ3JlYXRvciAo/
```
- **data**: İşlem sonucunda dönen veri nesnesi.
- `templateRenderRequestModel`: İstek modeli hakkında bilgi içeren nesne.
- `name`: İşlenen şablonun adı.
- `render-id`: Oluşturulan PDF'in benzersiz tanımlayıcısı.
- `render-data`: Şablonda kullanılan veriler.
- `render-data-for-log`: Loglama için kullanılan veriler.
- `semantic-version`: Kullanılan şablonun semantik versiyonu.
- `process-name`: İşlem adı, bu örnekte null olarak belirtilmiş.
- `identity`: Kullanıcı kimliği.
- `content`: Oluşturulan PDF'in içeriği, base64 kodlanmış bir string olarak döner.
- **success**: İşlemin başarılı olup olmadığını belirten boolean bir değer.
- **errorMessage**: Hata mesajı, işlem başarısız olduğunda hata detaylarını içerir. Bu örnekte boş bir string olarak dönmüş, yani hata oluşmamıştır.
## POST document/Instance
Bu endpoint, müşterilerin dökümanları onaylamasını ve sunmasını işleyen bir API'dir. Bu endpoint, dosya içeriğini (örneğin PDF formatında) base64 kodlanmış içerik ile birlikte kabul eder ve döküman kodu, versiyonu, referans ve sahip gibi meta verileri işler.
- **Header Parametreleri**
- `User_reference`: Genellikle müşterinin TCKN veya VKN bilgisini ifade eden referans bilgisi.
- `Business_line`: Mobil ON veya Mobil Burgan ayrımını belirten parametre.
- `Accept-Language`: İstemcinin tercih ettiği dil kodunu belirten parametre. Bu örnekte "en-EN" olarak ayarlanmıştır.
- `Customer_no`: Müşteri numarasını belirtir. Müşteriye özgü işlemlerde veya sorgularda kullanılır.
## GET /customer/get-documents-by-contracts Endpoint Analizi
Bu API endpoint'i, belirli sözleşmelere bağlı dokümanları getirmek için kullanılır. Endpoint, özellikle müşterilere ait sözleşmelerle ilişkilendirilmiş dokümanları sorgulamak için tasarlanmıştır. Kullanıcı bu endpoint'e bir istek gönderdiğinde, sistem sözleşme bilgilerine göre ilgili dokümanları bulur ve döndürür. Bu işlem, müşteri hizmetleri ve sözleşme yönetimi süreçlerinde, müşterilerin ilgili dokümanlara hızlı ve kolay erişimini sağlamak için önemlidir.
Endpoint, genellikle sözleşme ID'si veya benzer bir tanımlayıcı alır ve bu tanımlayıcıya bağlı dokümanları listeler. Yanıt olarak, ilgili dokümanların detayları (örneğin, doküman adı, türü, oluşturulma tarihi vb.) döndürülür. Bu endpoint'in kullanımı, müşteri ve sözleşme bilgilerinin doğru ve güncel tutulmasını gerektirir.
---------------------------
# Definition
### Document Definitions
**3 type document definitions**
1. Şeması olmayan, render edilmeyen,image olarak eklenebilecek dokuman tipi tanımı
```json=
{
"name": "identification-certificate-nc",
"title": {
"tr-TR": "Nufus Cuzdani",
"en-EN": "Birth Certificate"
},
"tags": [
{
"tag": "id-card",
"id": "reference"
},
{
"tag": "customer-info",
"id": "#mernis.response.$.tcknno"
},
{
"tag": "mernis",
"id": "owner"
}
],
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "jpg",
"max-size-kilobytes": 1024
}
]
},
"optimize": [
{
"transform-to": "jpg",
"size": true
}
],
"starting-transition-name" : "trx-upload-document",//sor
"operation": {
"control-layout": {
"view-tags": [
{
"tag": "mernis",
"parameter-key": "owner"
}
]
},
"[OBSOLUTE]document-manuel-control": true
},
"metadata": {
"form":"",
"template":"",
"valid-after-upload": "6M",
"offical-expiry": "#mernis.response.$.information.expiryAt"
},
"status": "active",
"base-status": "active"
}
```
* allowed-clients client bilgileri idm üzerindenmi gelecek bunlari ona göre mi kontrol edecegiz Mehmet
* **valid-after-upload**: validity period of document for contract validation after upload. Values can be *days ex:5d, months ex:5m, and years ex:2y. Operator can alter this datre manually.
* **offical-expiry**: Offical document expiry date comes from tag data. Operator can alter this date manually.
* Direct input sample "1997-07-16T19:20+01:00"
* **max-size-kilobytes**: Allowed maximum size(kilobyte) per document. This limit controlled while uploding document in client side and also server side.
* **transform-to**: If some formats have to converted to another format before storing, target format has to suplied.
* **optimize**: If the file is to be optimized before it is saved, it is set to true.
* **tags**: dokumanı alabilcegime dair sorulari cevaplayan service entegrasyonu (örneğin müşteri 70 yaş üstüyse ekstra belge alımı için)
* **allowed-clients**: hangi clientlar bu dokumanı yükleyebilir.
* **sca-required**: 2 factor banka herhangi bir talimatı 2 birleşenli alabilir.
* **allowed-formats**:izin verilen format ve max sizeleri
* **metadata**: birden fazla kural field i istenebilir.
* **operation**: operasyon kontrollerinin tanımlandıgı alan
2. Şeması olan dijital olarak onaylanan dokuman tipi
```json=
{
"name": "gdpr-consent",
"title": {
"tr-TR": "KVKK Bilgilendirme Onayi",
"en-EN": "GDPR Approval"
},
"tags": [
{
"tag": "gdpr",
"id": "reference"
}
],
"online-sign": {
"version": 2.2,
"sca-required": false,
"template": {
"tr-TR": "consent-gdpr-2.2-tr-html",
"en-EN": "consent-gdpr-2.2-en-html"
},
"allowed-clients": [
"ib",
"mobile-ib",
"idm-account"
]
},
"status": "active",
"base-status": "active"
}
```
bir yerde tutulcakmı online sing base64 olarak neyi onayladıgını kacırmamız gerekiyor consent-gdpr-2.2-tr-html ezebilirler çünkü
3. Şeması olan ve aynı zamanda ıslak imzalı upload edilebilir dokuman tanımı
```json=
{
"name": "address-statement",
"title": {
"tr-TR": "Adres Beyanı",
"en-EN": "Address Statement"
},
"tags": [
{
"tag": "address-statement-tag",
"id": "reference"
}
],
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "jpg",
"max-size-kilobytes": 1024
}
]
},
"render": {
"version": 6.2,
"template": {
"tr-TR": "address-statement-6.2-tr-html",
"en-EN": "address-statement-6.2-en-html"
},
"allowed-clients": [
"ib",
"mobile-ib",
"idm-account"
]
},
"optimize": [
{
"transform-to": "jpg",
"size": true
}
],
"status": "active"
}
```
## Document Group
```json=
{
"name": "address-confirmation-group",
"status": "active",
"title": {
"tr-TR": "Adres Teyit Grubu",
"en-EN": "Address Confirmation Group"
},
"document": [
"gas-bill",
"water-bill",
"electricity-bill",
"residence-certificate",
"property-deeds"
]
}
```
* **at-least-required-document**: At least document count to validate to document group reqirement.
## Contract Definition
```json=
{
"name": "ekyc-customer-application",
"status": "active",
"tags": [
{
"tag": "ekyc-application",
"id": "reference"
}
],
"documents": [
{
"name": "gdpr-consent",
"use-existing": "any-valid | uploaded-by-contract | never",
"required": true
},
{
"name": "channel-usage-consent",
"use-existing": "any-valid",
"min-version": 2.2,
"required": true
},
{
"name": "salary-certificate",
"use-existing": "never",
"required": false
}
],
"document-group": [
{
"name": "address-confirmation-group",
"at-least-required-document": 2,
"required": true
},
{
"name": "identification-certificate-group",
"at-least-required-document": 1,
"required": true
}
],
"validations": [
{
"type": "all-valid"
},
{
"type": "decision-table",
"decision-table": "dmn-ekyc-document-validation"
}
]
}
```
* **validations** The contract can different include multiple validation methods. All validation methods return validation status and a multilingual message set.
* **all-valid** just checks all reqired document is uploaded.
* ~~script is expression (C# ? Javscript ? FEEL ?) based valdiation~~
* **decision-table** is DMN table.
## Callback Definition
Workflow un her step ınde call back tanımlanabılır.
```json=
[
{
"name": "ekyc-callback",
"url": "https://api.burgan.com.tr/ekyc/..../document-tracking",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
},
{
"name": "loan-callback",
"url": "https://api.burgan.com.tr/retail-loan/..../document-tracking",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
]
```
# Instance (Application)
## Lifecycles (Status)
### Document
#### (Upload) Document
```mermaid
stateDiagram-v2
ns: not-started
up: uploaded
wc: waiting-control
ac: auto-control
v: validated
nv: not-validated
ns --> up : upload-document
up --> wc : auto
up --> ac : auto
ac --> v : valid
wc --> v : valid
ac --> nv : not-valid
wc --> nv : not-valid
nv --> v : valid
```
#### (Render & Wet-Sign & Upload) Document
```mermaid
stateDiagram-v2
ns: not-started
r: rendered
up: uploaded
wc: waiting-control
ac: auto-control
v: validated
nv: not-validated
ns --> r : render
r --> up : upload-document
up --> wc : auto
up --> ac : auto
ac --> v : valid
wc --> v : valid
ac --> nv : not-valid
wc --> nv : not-valid
nv --> v : valid
ns --> v : validated-with-existing
```
#### (Render & Online-Sign) Document
```mermaid
stateDiagram-v2
ns: not-started
r: rendered
v: validated
nv: not-validated
ns --> r : render
r --> v : valid
r --> nv : not-valid
```
### Document Group
```mermaid
stateDiagram-v2
ns: not-started
ip: in-progress
v: validated
nv: not-validated
ns --> ip : start
ip --> v : valid
ip --> nv : not-valid
```
### Contract
```mermaid
stateDiagram-v2
ns: not-started
ip: in-progress
v: validated
nv: not-validated
ns --> ip : start
ip --> v : valid
ip --> nv : not-valid
```
## Start Instance
POST https://api.burgan.com.tr/amorphie.contract/contract/
Header **Accept-Language** has to set
### Request
```json=
{
"id": "439b2e3a-4e40-4d44-a933-4eb1ef3bd887",
"contract-name": "ekyc-customer-application",
"reference": "38552069000",
"owner": "38552069008",
"callback-name": "web-ui-ekyc-callback"
"process": {
"client": "ekyc-application",
"user": "34455667789",
"behalf-of-user": "34455667789",
"name": "ekyc-process",
"id": "f220740a-5466-4bbd-8b82-3eaa97c2c15f",
"state": "load-document",
"action": "web-ui-document-load",
}
}
```
* **reference** müşteri no olabilir, login name(u05762) olabilir.
* **owner** required sadece tckn/vkn alabilir.
* **user** işlemi yapan kişi
* **behalf-of-user** vekalet eden kişi
### Generic Response for Contract Status
```json=
{
"id": "88acf003-94f6-497e-90dc-bdd90c45fd12",
"status": "in-progress",
"document": [
{
"name": "identification-certificate-nc",
"title": "Nufus Cüzdanı",
"status": "validated",
"required": "true",
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "pdf",
"max-size-kilobytes": 1024
}
]
}
},
{
"name": "gdpr-cosent",
"title": "KVKK Bilgilendirme Onayi",
"status": "not-started",
"required": "true",
"render": true,
"online-sign": {
"version": 2.2,
"sca-required": false,
"alloved-clients": [
[
"ib",
"mobile-ib",
"idm-account"
]
]
}
},
{
"name": "address-statement",
"title": "Adres Beyanı",
"status": "not-started",
"required": "true",
"render": true,
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "pdf",
"max-size-kilobytes": 1024
}
]
}
}
],
"document-groups": [
{
"name": "address-confirmation-group",
"status": "in-progress",
"title": "Adres Teyit Grup Belgeleri",
"at-least-required-document": 1,
"document": [
{
"name": "water-bill",
"title": "Su faturasi",
"status": "waiting-control",
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "pdf",
"max-size-kilobytes": 1024
}
]
}
},
{
"name": "gass-bill",
"title": "Dogalgaz Faturasi",
"status": "not-started",
"upload": {
"sca-required": false,
"allowed-clients": [
"web-ib",
"mobile-ib",
"dealer",
"direct-sales"
],
"allowed-formats": [
{
"format": "png",
"max-size-kilobytes": 512
},
{
"format": "pdf",
"max-size-kilobytes": 1024
}
]
}
}
]
}
]
}
```
## Render Document
POST https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}/render
POST https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}/render/pdf
POST https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}/render
POST https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}/render/pdf
### Request
All requests must include json data body for support templating while render.
```json=
{
"data": {
"customer": {
"firstName": "Ahmet",
"lastName": "Halil"
}
}
}
```
### Response
Client display or prints rendered document.
```json=
{
"content": "base64;pdf 0xsdad"
}
```
## Upload Document
POST https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}
POST https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}
### Request
Content-Type: application/pdf
Content-Transfer-Encoding: base64
> https://www.w3.org/Graphics/JPEG/
### Response
```json=
{
"status": "uploaded"
}
```
### Additional Properties of Document
PATCH https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}
PATCH https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}
```json=
{
"data": {
"customer": {
"notes": "sgk belgesi eklenmelir."
}
}
}
```
## Get Instance
GET https://api.burgan.com.tr/amorphie.contract/contract/{id}
[Response ](/Instance (Application))
## Query Instance
GET https://api.burgan.com.tr/amorphie.contract/contract/
Query Params
* contract-name
* owner
* process...
* page-size & page
## Get Document
GET https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}
GET https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}
GET https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}/schema
GET https://api.burgan.com.tr/amorphie.contract/document/{name}/owner/{owner}/schema
## Callback
When state of any document is changed, callback url is consumed with below body.
```json=
{
"name": "ekyc-customer-application",
"status": "in-progress",
"id": "1180d691-f53d-48fa-a960-aea265267d1d",
"document": [
{
"name": "identification-certificate-nc",
"status": "waiting-control"
},
{
"name": "gdpr-consent",
"status": "valid"
}
],
"document-groups": [
{
"name": "address-confirmation-group",
"status": "in-progress",
"document": [
{
"name": "water-bill",
"status": "waiting-control"
},
{
"name": "gas-bill",
"status": "not-started"
}
]
}
]
}
```
# Instance (Manuel Ops)
## Approve/Reject Document
POST https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents/{name}/transition/{transition-name}
POST https://api.burgan.com.tr/amorphie.contract/documents/{id}/transition/{transition-name}
## Request More Document
POST https://api.burgan.com.tr/amorphie.contract/contract/{id}/documents
{
document tipi
}
# Rule Management Module
Biz ve iş birimimiz için kullanabileceğimiz bir kural (rule) modülü geliştirilecektir.
Uygulama (APP) içerisinde, yapılacak tüm işlemlerin tanımları tutulacak ve bir belgenin dönüştürüleceği bilgisi, küçültme işleminin gerekip gerekmediği ve ne kadar küçültülebileceği gibi bilgiler müşterilerden hangi formatlarda alınabilir ve hangi formatta saklanmalıdır sorularına yanıt sağlayacaktır.
Uygulama (APP) dışında, versiyon, son kullanma tarihi (expritedate), geliş kanalı, doküman tipi gibi alanlara bakarak, sonuç tag servisiyle iletişim kurup mob onayının gerekip gerekmediğini, gerekiyorsa hangi rule koduyla mob'a sorulacağını belirleyebileceğimiz bir tasarım kurgulayacağız.
Admin tarafından oluşturulan kural tanımına (rule definition) göre doküman alanlarını da belirleyeceğiz. Her doküman için kendine özgü bir kural tanımı yapılabilir, bu nedenle her doküman için farklı bir alan seti beklenmesi mümkündür.
Örneğin, aynı doküman grubunda yer alan bir doküman için kural seti 3 farklı alandan oluşabilirken, aynı gruptaki başka bir doküman için farklı bir alan seti bekleniyor olabilir. Bu nedenle, her doküman için özel bir kural tanımı yapılacaktır.
olası kullanılacak teknolojiler
esicion-table
zeebe-comand-dmn
c# roslyn–
zeebe feel expression
# Format Converter Module
Gönderilen dokumanı istenilen formata ceviren modul geliştirilecek.
Rule manager kullnaılarak hangi dokuman hangi formata çevrile biliniyor sorgulanır.
örnek
pdf > jpg
docx> jpg
xlsx> jpg
#
# Document Percentage Module
Dosya boyutlarini gerekliligi kadar küçültecek modul geliştirilecek.
burada rule manager kullanılarak gerekli boyutları sorgulanır kucultülme izni ve tanımı varise kucultulur
5000px*5000px > 2000px * 2000px
# Dosya Gerekli Kısım Belirleme
40 sayfalık bir pdf içinde bizim için gerekli olan sayfa belirlenip saklanacak.
sorular:
Bu kısımda şimdilik mob a yaptırabilirsin ekran tasarlanmalı aslı saklanmalı mı?(sorgula)
Burada saklama 2 yöne ayrılabilir birinci aslı saklanır 2.seçili olanda saklanır bizim için birinci tc altında dosyada tutulur 2 dosya documant defination karsılığı olur birinci bişi ifade etmiyor hale gelir.
40 sayfa > 1 sayfa
# Callback Module
clientlar kendi api leri için tanımladıklari url ve securty bilgileri ile callback çalıştırmamızı saglıyacak modul.
bir callback seneryosu için 3 istektede buluna bilir.
default atmasını bekledigimiz requestler bizim tarafımızdan tanımlı olacak fakat istenirse callback requesti clientlar tarafında callback defination ile override(json model) edile bilir olacak.
workflow içerisinden dogrudan bir callback atmayıp kendi callback apimizi cagıracagız api arkatarafta bu istegi ilk aldıgında defination a bakarak bir q kaydı olusturacak bu kayıtlari eriten bir worker yazılacak
client isterse son bir aylık veya instance bazlı callback leri tekrar calistirabilecegi bir istekte buluna bilir.
# 23-24 Mayıs notlar
1)Dokumanın silinmesi opsıyonunu istiyorlar. Bunu senle konuşmuştuk silinmemeli goruşunu iletmiştin soledik.
Uğur Bey yorum: dokuman elbete silinmemeli. Bu ihtgiyac aslinda alrtapi eksiliginde. ORnegin burgan trade kullanimi icin sozlesme imaziliyor musteri, sonra erisimin kapatilmasini istediginde sozlesme silerek yapabiliyorlar. O kisim belge tarafindan transactional olarak feature kapatmasi olmali. Butunsel de tum surec ornekleri ile degerlenmdiririz. Belki onayladigi belgeyi gecersiz kilacak baska bir belge onaylamali, talimat iptali gibi.
2)Dokumanı html/pdf template den etme kısmını kım yapcak sorusu ondada var. Dha ihale kımde bilmiyoruz dedık ama otomatık olmalı görüşü var.
Uğur Bey yorum: Birden fazla dokuman olup paralel gidecegi icin konu evet otomatik olmali ama render icin gereken veri setlerinin tedarigi konusunda konu netlesmeli. Bu noktada TAG yapisi yardima kosabilir. verilerio TAG den cekip render edilebilir.
3-IB ve mobılde dokumanlar gösterilmesin mi parametresi olmalı. Bu kritik.
Uğur Bey yorum: dokuman tipi icin bir property gibi anliyorum. Amorpie client ile eslebilir dokuman tipi
4-Mail gönderimi? Müşteri dokumları maille istediğinde göndermeliyiz.
Uğur Bey yorum: Bu konu derin bir konu. Email validasyonu yapilmilmissa gonderilmeli. Gonderim gatewayden yapilir, oradan da kontrol edilir email dogrulama. Ama hangi dokumanin gonderilecegini, documan set instance icindeki dokumanlari gondermek icin servis tetikleme isi sureclerde olmali. Paylasma destegi verelim, paylasma kurali tuketen uzman sistemlerde olsun
müşterinin onaylamış olduğu formları bir tamplate ile mail gönderme