Geliştirici - Kod Gönderim Prosedürü

Workcube uygulamasının kaynak kodları Git sürüm denetim sistemiyle takip edilir ve Bitbucket reposunda barındırılır. Git'in sağlıklı ve sürdürülebilir bir denetim mekanizması oluşturabilmesi için belli başlı kurallara dikkat edilmesi gerekir. Bu kurallara dikkat edilmediği takdirde conflict adını verdiğimiz çakışmalar meydana gelir ve içinden çıkılamayacak sorunlara sebep olur. Geliştirimlerinizi VSCode üzerinde yapıyorsanız git yönetimi için dahili "Source Control" ve harici "GitLens" uygulamalarını kullanabilirsiniz.

Workcube uygulaması 5 ana branch üzerinde yönetilir. Bu branchların isimleri ve request kuralları aşağıda belirtilmiştir.

1. Developer: Sürekli request edilebilir.
2. Master: Development süreci tamamlanmış ve test edilmiş düzenlemeler request edilebilir.
3. Beta: Development süreci tamamlanmış, test edilmiş, productiona gidecek düzenlemeler request edilebilir.
4. Projects: Uzun sürecek projeler request edilebilir.
5. Releases: Productiona gidecek düzenlemeler request edilebilir. Sadece ilgili iş kaydında request edilmesi isteniyorsa edilir.
   

Dikkat!: developer, master, beta ve projects branchları feature ve bugfix işlemlerinde, releases ise Workcube sürümlerinin dağıtımında kullanılır.

Geliştiriciler git reposundan güncel düzenlemeleri sırasıyla aşağıdaki şekilde alıp gönderebilirler.

1. Master branchına geçin, pull edin.
2. Kod düzenlemelerinizi yapın.
3. Düzenlemelerinizi bitirdikten sonra kodlarınızı stashleyin. Kodları stashlemek; yedekleme, branchlar arası gezme vb. kolaylıklar sağlar.
4. Yeni bir branch oluşturun: tasks/adsoyad_isid = adsoyad yerine Adınızı ve Soyadınızı, isid yerine de networg sistemindeki işin idsini yazın.
5. Stashlediğiniz kodları bu branch üzerindeyken apply edin.
6. Bir commit mesajı yazın.
7. Düzenlemelerinizi commitleyin: Commit mesajını standartlara uygun formatta yazın: #işid_iştipi_işaçıklama:
   1. işid: İlgili işin id değeri
   2. iştipi: hotfix ya da feature
   3. işaçıklama: İlgili işin açıklaması
      

Kod gönderimleri tamamlandıktan sonra aşağıdaki kurallar doğrultusunda düzenlemelerinizi merkezi branchlara gönderebilirsiniz.

1. Yeni oluşturduğunuz branchı developer branchına request olarak gönderin.
2. Request işleminden sonra iş kaydını test işlemini yapacak kişiye gönderin.
3. Test süreci tamamlandıktan sonra iş kaydı üzerinden master ve beta branchlarına gönderilsin olarak dönülecektir.
4. Yeni oluşturduğunuz branchı master ve beta branchlarına ayrı ayrı request olarak gönderin.
5. Request işleminden sonra iş kaydını test işlemini yapacak kişiye gönderin.
   

Conflict neden oluşur? Oluşmaması için ne yapmalıyız?

1. Master dışındaki branchlardan yeni branch açılarak request işlemi yapılması.
   Workcube kuralları gereği sadece masterdan oluşturulan branchlar request olarak gönderilebilir.
   Aksi durumda kesinlikle conflict oluşur ve git yapısı bozulur.
2. Birden fazla geliştiricinin aynı dosyalarda çalışarak request işlemi yapması.
   Bunun önüne geçmek için; dosyalarınızı commitlemeden önce stashleyin ve master branchını yeniden pull edin. Böylelikle sizden önce gönderilmiş kodları da çekmiş olacaksınız.
   Stashlerinizi tekrar apply edin. Conflict bildirimi görürseniz özel olarak ilgilenin ve çakışan kısımları düzenleyin.
   Ardından kodlarınızı commitleyin ve pushlayın.
   

Asla yapılmaması gerekenler

1. Developer branchından iş branchı oluşturmayın. Oluşturduysanız kesinlikle başka bir brancha request göndermeyin ya da merge etmeyin.
   
2. Masterdan oluşturduğunuz branch içerisine developer branchını merge etmeyin.
3. Test süreci tamamlanmamış işleri beta branchına request göndermeyin.