Proje Dizin Mimarisi
ChatGPT / Codex projelerinde yer alan klasörler, yapay zeka ajan sistem dosyaları ve konfigürasyon yapılarının kullanım amaçları.
ChatGPT / Codex projelerinde yer alan klasörler, yapay zeka ajan sistem dosyaları ve konfigürasyon yapılarının kullanım amaçları.
Klasör Dizini ve Kullanım Amaçları
| Klasör Adı | Kullanım Amacı |
|---|---|
| .git | Git versiyon kontrol sisteminin tüm geçmişini, dal (branch) bilgilerini ve commit kayıtlarını tutan gizli sistem klasörüdür. |
| .tools | Ajana veya projeye özel kullanılan yardımcı betikler, dahili araçlar ve otomasyon script’lerinin saklandığı klasördür. |
| android | Projenin Android mobil platformuna özel kaynak kodlarını ve Gradle derleme yapılandırmalarını içerir. |
| artifacts | Derleme (build) veya test süreçleri sonucunda ortaya çıkan çıktıların (ör. raporlar, binary paketler) depolandığı alandır. |
| desktop-client | Uygulamanın masaüstü istemcisine (Electron, WPF vb.) ait kaynak kod ve arayüz bileşenlerini barındırır. |
| dist | Yayına / üretime (production) dağıtılmaya hazır nihai derlenmiş kod ve static çıktı dosyalarını içerir. |
| distribution | Dağıtım paketleri, yükleyici (installer) oluşturma script’leri veya paket dağıtım yapılandırmalarını tutar. |
| docs | Projeye ait teknik dokümantasyon, API kılavuzları, mimari şemalar ve kullanım belgelerinin bulunduğu klasördür. |
| hestia | Projeyle entegre çalışan veya kullanılan özel kontrol paneli/servis (ör. Hestia CP entegrasyonu) modülüdür. |
| homelab | Sanal laboratuvar, yerel test ortamları veya ev sunucusu kurulum ve yapılandırma script’lerini barındırır. |
| output | Betiklerin veya yapay zeka ajanlarının işlemler sırasında ürettiği geçici veya nihai çıktı dosyalarının kaydedildiği yerdir. |
| reference | Projede kılavuz/örnek alınan harici dokümanlar, kod şablonları veya veri kalıplarının yer aldığı klasördür. |
| snapshots | Projenin, veri tabanının veya sistem durumunun belirli bir andaki anlık görüntülerinin (snapshot) tutulduğu yerdir. |
| tests | Projenin doğruluğunu kontrol eden birim (unit), entegrasyon ve otomasyon test kodlarını içerir. |
| tmp | Çalışma esnasında oluşturulan ve silinebilir olan geçici (temporary) önbellek ve veri dosyalarını barındırır. |
| windows | Projenin Windows işletim sistemine özel yapılandırmalarını, kaynak kodlarını ve PowerShell betiklerini içerir. |
Sistem ve Yapılandırma Dosyaları
| Dosya Adı | Kullanım Amacı |
|---|---|
| .gitignore | Git versiyon kontrolüne dahil edilmeyecek geçici, hassas veya derlenmiş dosya kalıplarını tanımlar. |
| AGENTS.md | Yapay zeka ajanlarına (ChatGPT, Codex vb.) yönlendirici sistem istemlerini (system prompts), kuralları ve rol tanımlarını belirtir. |
| BASELINE.json | Projenin temel kabul edilen (baseline) konfigürasyon ayarlarını, standart metriklerini ve parametrelerini tutar. |
| HANDOFF.md | Yapay zeka oturumları veya geliştiriciler arası devir teslim notlarını, projenin en son durumunu ve sıradaki adımları barındırır. |
| README.md | Projenin ne olduğunu, nasıl kurulacağını ve çalıştırılacağını açıklayan ana dokümantasyon belgesidir. |
| SANITIZATION.json | Verilerin temizlenmesi, anonimleştirilmesi ve hassas bilgilerin gizlenmesi kurallarını içeren JSON yapılandırmasıdır. |
| START-NEW-CHAT.txt | ChatGPT/Codex ile yeni bir sohbet başlatıldığında ajana iletilecek hazır başlangıç komutlarını (prompt) saklar. |