ArchMaturity Analyzer, yazılım mühendislik ekiplerini ve teknik sistemleri iki temel eksen üzerinden değerlendiren interaktif bir olgunluk analiz aracıdır: Bilgi Yetkinliği ve Sistem Bütünlüğü. Yapısal açıkları tespit eder ve ham puanları Üretken Yapay Zeka (Google Gemini) kullanarak stratejik öneri, güçlü yönler ve ayrıntılı iyileştirme planları içeren kapsamlı olgunluk raporlarına dönüştürür.
-
İki Değerlendirme Modu
- Bilgi Olgunluğu (Knowledge Maturity): Tasarım desenleri, SOLID prensipleri, dağıtık sistemler, güvenlik, DDD ve DevOps gibi alanlarda bireysel mimari bilgi düzeyini ölçer. Kişisel gelişim ve işe alım süreçleri için idealdir.
- Sistem Olgunluğu (System Maturity): Mevcut bir sistemin teknik olgunluğunu ölçeklenebilirlik, CI/CD, gözlemlenebilirlik, veri yönetimi ve yazılım kalitesi gibi boyutlarda değerlendirir.
-
Yapay Zeka Destekli Rapor Üretimi: Değerlendirme tamamlandıktan sonra kendi Google Gemini API anahtarınızı girerek kişiselleştirilmiş, kapsamlı bir mimari olgunluk raporu oluşturabilirsiniz.
-
Sayfalı Soru Akışı: Sorular sayfa sayfa sunulur, önceki sayfaya geri dönülebilir ve ilerleme çubuğuyla tamamlanma durumu anlık izlenir.
-
Otomatik Puanlama: Her soru ağırlıklı puan sistemiyle değerlendirilir; sonuçlar toplam puan ve yüzde olarak gösterilir.
-
Markdown Rapor Görüntüleme: Yapay zeka tarafından üretilen raporlar GitHub Markdown stiliyle zengin içerik olarak ekranda sunulur.
| Teknoloji | Sürüm | Açıklama |
|---|---|---|
| React | 19 | UI framework |
| TypeScript | 5 | Tip güvenli geliştirme |
| Vite | 6 | Hızlı geliştirme ve build aracı |
| Tailwind CSS | 4 | Utility-first CSS framework |
| Lucide React | 0.563+ | İkon kütüphanesi |
| React Markdown | 10 | Markdown render |
| Google Gemini API | - | Yapay zeka rapor üretimi |
- Node.js 18 veya üzeri
- npm 9 veya üzeri
# 1. Repoyu klonlayın
git clone https://github.com/DTVegaArchChapter/architecture-maturity-analyzer.git
cd architecture-maturity-analyzer
# 2. Bağımlılıkları yükleyin
npm install
# 3. Geliştirme sunucusunu başlatın
npm run devTarayıcınızda http://localhost:5173 adresine gidin.
| Komut | Açıklama |
|---|---|
npm run dev |
Geliştirme sunucusunu başlatır (hot reload) |
npm run build |
Üretim için derleme yapar (dist/ klasörüne) |
npm run preview |
Üretim build'ini yerel olarak önizler |
npm run lint |
ESLint ile kod kalite kontrolü yapar |
- İki değerlendirme modundan birini seçin.
- Tüm soruları cevaplayın ve "Analizi Tamamla" butonuna tıklayın.
- Sonuç ekranında "AI Maturity Report Oluştur" bölümüne gelin.
- Google AI Studio adresinden ücretsiz bir Gemini API anahtarı alın.
- API anahtarınızı ilgili alana girin ve "Generate Comprehensive Report" butonuna tıklayın.
⚠️ Güvenlik Notu: API anahtarınız yalnızca tarayıcınızda tutulur ve hiçbir sunucuya gönderilmez. Yine de anahtarınızı başkalarıyla paylaşmayın.
| Kategori | Kapsam |
|---|---|
| Tasarım Desenleri | Microkernel, Microservices karşılaştırması |
| SOLID & Temiz Kod | Bağımlılık tersine çevirme prensibi |
| Dağıtık Sistemler | CAP teoremi ve veritabanı seçimi |
| Gözlemlenebilirlik | Tracing, Metrics, Logging tasarımı |
| Performans | Mimari darboğaz analizi ve çözümü |
| Cloud Native | 12-Factor App metodolojisi |
| Güvenlik | Zero Trust, OAuth2/OIDC, Security by Design |
| Domain Driven Design | Event Storming, Bounded Context |
| DevOps | IaC, CI/CD, "You build it, you run it" |
| Soft Skills | Teknik kararları paydaşlara aktarma |
| Kategori | Kapsam |
|---|---|
| Ölçeklenebilirlik | Trafik artışına karşı mimari yanıt |
| Deployment | CI/CD pipeline olgunluğu |
| Gözlemlenebilirlik | Üretim ortamı izleme ve tanı |
| Veri Yönetimi | Veri tutarlılığı ve yedekleme stratejisi |
| Yazılım Kalitesi | Test stratejisi ve teknik borç yönetimi |
architecture-maturity-analyzer/
├── public/ # Statik dosyalar
├── src/
│ ├── App.tsx # Ana uygulama bileşeni (tüm mantık burada)
│ ├── App.css # Uygulama stilleri
│ ├── main.tsx # React uygulama giriş noktası
│ └── index.css # Global stiller
├── index.html # HTML şablonu
├── vite.config.ts # Vite yapılandırması
├── tsconfig.json # TypeScript yapılandırması
├── eslint.config.js # ESLint yapılandırması
└── package.json # Proje bağımlılıkları
- Bu repoyu fork'layın.
- Yeni bir dal oluşturun:
git checkout -b feature/ozellik-adi - Değişikliklerinizi commit edin:
git commit -m 'feat: yeni özellik eklendi' - Dalınızı push edin:
git push origin feature/ozellik-adi - Bir Pull Request açın.
Bu proje MIT Lisansı ile lisanslanmıştır.