# Code Quality Index (TCQI & PCQI) \[TR]

### **Genel Bakış**

Oobeya’daki **Code Quality Index** metrikleri, yazılım projelerinizin ve ekiplerinizin kod kalitesini **0–5 arası tek bir skorla** ifade eder.\
Bu metrikler, **SonarQube** verilerini kullanır ve **ISO/IEC 25010** yazılım kalite modelinin nitelikleri ile uyumludur.

* **Project Code Quality Index (PCQI)**: Proje seviyesinde kod kalitesini ölçer.
* **Total Code Quality Index (TCQI)**: Bir ekibin tüm projelerinin kod kalitesini ağırlıklı ortalama ile hesaplar.

Bu sayede hem **tek bir projeye** hem de **tüm ekibe** ait kod kalitesi trendlerini kolayca izleyebilirsiniz.

***

### **Hangi Veriler Kullanılır?**

Oobeya, SonarQube entegrasyonu ile aşağıdaki verileri toplar:

1. **Security** – Güvenlik açıkları ve zafiyetlerin kod üzerindeki etkisi
2. **Reliability** – Hata/bozulma olasılığı, kurtarılabilirlik, istisnalar
3. **Maintainability** – Bakım kolaylığı, modülerlik, okunabilirlik
4. **Unit Test Coverage** – Birim test kapsam yüzdesi
5. **Duplication** – Tekrarlayan kod oranı
6. **Complexity** – Döngüsel (cyclomatic) ve bilişsel (cognitive) karmaşıklık

***

### **1. PCQI (Project Code Quality Index)**

#### **Tanım**

**PCQI**, tek bir projenin kod kalitesini yukarıdaki altı bileşen üzerinden hesaplar. Skor **0–5 aralığında** normalize edilir.

***

#### **Hesaplama Adımları**

**1. Alt Metriklerin Hesaplanması**

**Security / Reliability / Maintainability:**

* Yüksek, orta, düşük eforlu sorunlar katsayılarla çarpılır, kod satır sayısına (LOC) bölünür, kalite ölçeği hesaplanır, rating’in tavan puanı ile çarpılır, minimum puan ile karşılaştırılır. Çıkan sonuç ilgili metrik skorudur.
* Rating (A–E) değerine göre **tavan puan (CeilingScore)** ve **taban puan (MinScore)** uygulanır.
  * **CeilingScore**: A=5, B=4, C=3, D=2, E=1
  * **MinScore**: A=2.5, B=2.0, C=1.5, D=1.0, E=0.0

```
LineEffort = [(HighEffort * HighCoeff) + (MediumEffort * MediumCoeff) + (LowEffort * LowCoeff)] / LOC 

ScaleScore = max(0, 1 - LineEffort) 

SeverityScore = max(CeilingScore(Rating) * ScaleScore, MinScore(Rating))
```

**Unit Test Coverage:**

Unit test Coverage yüzdesi, ağırlığı ile çarpılır.

```
CoverageScore = CoverageRate * CoverageWeight
```

**Duplication:**

%25 tekrar oranı eşiği baz alınır, üzeri doğrudan sıfır (0) olarak kabul edilir.

```
DuplicationScore = max(0, (1 - (DuplicationRate / 0.25)) * DuplicationWeight)
```

**Complexity:**

Döngüsel ve bilişsel karmaşıklık değerleri fonksiyon başına normalize edilir, hedef değer **FD=20** ile karşılaştırılır. İki skorun ortalaması alınır.

* **FD (Function Default)**: 20
* **CyWeight:** 5
* **CoWeight**: 5

```
ComplexityScore = statistics.mean([
  max(0, CyWeight * (1 - ((Cyclomatic / FunctionCount) / FD))),
  max(0, CoWeight * (1 - ((Cognitive / FunctionCount) / FD)))
])
```

***

**2. Alt Metriklerin Ortalaması**

Tüm alt metrikler **0–5** aralığında normalize edilir ve aritmetik ortalama alınarak PCQI skoru elde edilir:

```
PCQI = Ortalama(SecurityScore, ReliabilityScore, MaintainabilityScore, CoverageScore, DuplicationScore, ComplexityScore)
```

***

#### **PCQI Skor Yorumlama**

<table><thead><tr><th width="158.79229736328125">PCQI Skoru</th><th width="154.36083984375">Durum</th><th>Önerilen Aksiyon</th></tr></thead><tbody><tr><td>4.5 – 5.0</td><td>Mükemmel</td><td>Süreçleri koruyun ve iyi uygulamaları yaygınlaştırın.</td></tr><tr><td>3.5 – 4.4</td><td>İyi</td><td>Belirli alanlarda iyileştirme fırsatlarını değerlendirin.</td></tr><tr><td>2.5 – 3.4</td><td>Orta</td><td>Hedefli iyileştirmeler yapın.</td></tr><tr><td>0 – 2.4</td><td>Kritik</td><td>Güvenlik, bakım kolaylığı, test kapsamı alanlarında acil aksiyon alın.</td></tr></tbody></table>

***

### **2. TCQI (Team Code Quality Index)**

#### **Tanım**

**TCQI**, bir ekibin tüm projelerinin PCQI skorlarının, proje büyüklükleri (LOC) ile ağırlıklandırılmış ortalamasıdır. Bu sayede küçük ve büyük projeler adil şekilde karşılaştırılır.

***

#### **Hesaplama Adımları**

1. Her proje için **PCQI** hesaplanır.
2. Her proje PCQI değeri, proje LOC değeri ile çarpılır.
3. Elde edilen değerler toplanır ve ekibin toplam LOC’una bölünür:

```
TCQI = [ ∑(PCQI_project * LOC_project) ] / ∑(LOC_team)
```

***

**Örnek Hesaplama**

<table><thead><tr><th width="165.05755615234375">Proje</th><th width="109.272705078125">PCQI</th><th width="175.86090087890625">LOC</th><th>Ağırlıklı Değer</th></tr></thead><tbody><tr><td>A</td><td>4.0</td><td>100,000</td><td>400,000</td></tr><tr><td>B</td><td>3.0</td><td>50,000</td><td>150,000</td></tr><tr><td><strong>Toplam</strong></td><td></td><td>150,000</td><td><strong>TCQI = 3,67</strong></td></tr></tbody></table>

***

#### **TCQI Skor Yorumlama**

<table><thead><tr><th width="156.457763671875">TCQI Skoru</th><th width="185.997314453125">Durum</th><th>Önerilen Aksiyon</th></tr></thead><tbody><tr><td>4.5 – 5.0</td><td>Mükemmel</td><td>Takım genelinde kalite çok yüksek, mevcut süreçleri koruyun.</td></tr><tr><td>3.5 – 4.4</td><td>İyi</td><td>Belirli projelerde küçük iyileştirmeler planlayın.</td></tr><tr><td>2.5 – 3.4</td><td>Orta</td><td>Düşük skorlu projelere odaklanın.</td></tr><tr><td>0 – 2.4</td><td>Kritik</td><td>Ekip genelinde kalite sorunları var, acil aksiyon alın.</td></tr></tbody></table>

***

### **İyileştirme Önerileri**

* **Security / Reliability / Maintainability**: Kritik ve büyük sorunları çözün, kod inceleme süreçlerini güçlendirin.
* **Coverage**: Test kapsamını artırın (%80+ hedeflenmeli).
* **Duplication**: Kod tekrarını %25’in altına indirin.
* **Complexity**: Fonksiyon başına karmaşıklığı 20’nin altında tutun.

***


---

# 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.oobeya.io/quality-analytics/code-quality-index-tcqi-and-pcqi-tr.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.