# Projelerin Kontrolü

## 👨‍💻 Kaynak Kod Odaklı Proje Yönetimi

Çok kişi ile yapılan projelerde her konuyu birbirimize anlatmak vakit kaybıdır, bu sebeple herkesin sadece kendi işi ile uğraşacağı yapı kurulmalıdır.

* Her fonksyionun nereye yazılacağı belirtilmeli ve projenin taslak yapısı kurulmalıdır.
  * İstenen fonksiyonların taslakları kod içerisine yerleştirilir
  * Kişi istenen tipte veriler veya gönderdiği veriler gönderir
  * Göndereceği veriler için açıklayıcı bir dökümantasyon eklemelidir
  * Yapacağı işlemlerin detaylarını çok fazla anlatmadan istenen veri hakkında bilgi verilmelidir. (Vakit kaynını engeller)
* Projenin en üst kısmında değiştirlebilir veriler saklanmalı ve switch yapısı kurulmalıdır.

### ✨ Proje Oluşturma & Güncelleme Yapısı

Proje yönetimi için git kullanılması çok faydalıdır.

* Her yeni ekleme için onu tanımlayan bir **branch** oluşturulur.
  * Branch oluşturma işlemi `checkout` komutuyla yapılır
  * Oluşturulan her branch `master` branch'inden `pull from` komutu ile güncellenir.
    * Güncellenmez ise `merge conflict` hataları meydana gelir ve çok vakit harcar 😢
  * Tüm işlemler yapıldıktan sonra branch'i uzak sunucuda saklamak adına `pull` komutu kullanılır
* **Merge Request** ile *master branch* kısmına eklenme talebi oluşturulur.
* Yönetici, talebi kontrol edip, onaylayarak projeye katar.

> Küresel çalışma adına İngilizce tercih edilmektedir.

#### Ufak Projeler için Branch (Tam hazır değil)

Bir proje üzerinde herkes kendi adıyla bir branch açabilir.

#### Büyük Projeler için Branch Prefix (Ön ek)

Büyük projelerdeki temel yapı `konu` / `detay veya dosya` şeklinde branch oluşturmaya dayanır.

* `feature/<detail>` Yenilikler
* `bugfix/<detail>` Hata çözümleri
* `sf/<detail>` Tasarım değişikleri (Store front-end)

> Ardından **merge request** ile geliştirici (dev) ortamına birleştirme isteği oluşturulur.

#### Branch Naming Convention (Yazım kuralı)

* Camel Case
* `<prefix>/thisIsExampleDetail`

**Örnek Kullanım**

* sf/newBannerRow
* feature/excelPhp

### 🍱 Model View Controller Yapısı

Ek kaynak için [buraya](https://blog.koddit.com/yazilim/mvc-nedir-gercek-orneklerle-mvc-nedir-anlayalim/) tıklayabilirsin.

> Temel amaç *model* ile *view* katmanını ayırmaktır. Bu sayede tasarımı değiştireceğimiz zaman yapısal kodlarla uğraşmak zorunda kalmayız. (*model: back-end view: front-end denebilir*)

| Yapı Ögesi | Özet                          | Örnek                                                     |
| :--------: | ----------------------------- | --------------------------------------------------------- |
|    Model   | Veriler ile ilgili işlemler   | Veritabanına veri kaydedilmesi ve veritabanından alınması |
|    View    | Kullanıcıya görünen kısım     | Anasayfa gibi web sayfaları                               |
| Controller | Model ile View arası bağlantı | Verinin web sayfasına aktarılması                         |

#### Yapı düzenleme sırası

* **Model** kısmı düzenlenir.
* **Controller** üzerinde bağlantılar oluşturulur.
* **View** ile kullanıcıya sunulur.

### 💎 Değişken İsimlendirmeleri

| İsim           | Açıklama                                                     |
| -------------- | ------------------------------------------------------------ |
| `NAME`\_PREFİX | Veri tabanı ön eki. *Örn: DB\_PREFIX, BRANCH\_PREFIX*        |
| Flag           | Checkbox gibi *boolean* değerleri tutan değişkenlerin adıdır |

## 🌊 Continuous Integration

| Continuous Integration                                                     | Continuous Delivery                            | Continuous Deployment                         |
| -------------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------- |
| Her kod için test metotları yazılır                                        | Continuous Integration'a geliştirilmiş halidir | Continuous Delivery'nin gelişmiş halidir      |
| Tüm test metotları farklı sunucuda her commit işleminden sonra gerçekleşir | Projeyi yayınlamaya hazır hale getirir         | Proje yayınlanması da otomatik hale gelmiştir |

{% hint style="info" %}
‍🧙‍♂ Detaylı bilgi için [Continuous integration vs. continuous delivery vs. continuous deployment](https://www.atlassian.com/continuous-delivery/principles/continuous-integration-vs-delivery-vs-deployment) alanına bakabilirsin.
{% endhint %}

## ⚗️ CI Bağlantıları

* 📋 Tüm CI hizmetlerine [Awesome CI](https://github.com/ligurio/awesome-ci) üzerinden bakabilirsin
* [📃 Continuously Deploying Python Packages to PyPI with CircleCI](https://circleci.com/blog/continuously-deploying-python-packages-to-pypi-with-circleci/)
* [🔨 Configuring CircleCI](https://circleci.com/docs/2.0/configuration-reference)

## ⭐ Faydalı Yazılımlar

Eklentileri ile meşhur olan `VsCode` yazılımı tavsiye edilir.

### 👨‍💼 Yönetim Uygulamaları & Siteleri

| Uygulama İsmi                                                | Açıklama                                                          |
| ------------------------------------------------------------ | ----------------------------------------------------------------- |
| [Github](https://github.com/) & [Gitlab](https://gitlab.com) | Kaynak kod yöneticisi                                             |
| [GitGuardian](https://app.gitguardian.com/)                  | API key gibi gizli bilgilerin projelerdeki varlığını kontrol eder |
| [Asana](https://asana.com/)                                  | Proje yönetimi & Yapılacaklar Aşaması & İş aktarımı / eşleme      |
| [Slack](https://slack.com/)                                  | Takım yönetimi                                                    |

### 🌍 Web programlama

| Uygulama İsmi                                                            | Açıklama                                                         |   |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------- | - |
| [Git](https://git-scm.com/downloads)                                     | Kaynak kod yönetimi                                              |   |
| [PhpStorm](https://www.jetbrains.com/phpstorm/download/#section=windows) | Çok fonksiyonel PHP IDE                                          |   |
| [Xammpp](https://www.apachefriends.org/tr/download.html)                 | Php için sunucu, veri tabanı vs. işlemleri sunan platform        |   |
| [Nodejs](https://nodejs.org/en/download/)                                | Javascript kodlarını makine koduna çevir. Js'i sunucuda kullanma |   |
| [MySQL](https://www.mysql.com/downloads/)                                | Veri tabanı yönetimi                                             |   |
| [Composer](https://getcomposer.org/download/)                            | Php paket yönetimi (NPM)                                         |   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yemreak.com/arsiv/proje-yonetimi/kontrol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.