Porje dökümanları oluşturuldu

2025-11-27 09:27:06 +03:00
parent f6b73dacd2
commit 945c0e7a76
7 changed files with 1637 additions and 33 deletions
--- a/.serena/memories/proje_genel_bilgiler.md
+++ b/.serena/memories/proje_genel_bilgiler.md
@@ -0,0 +1,120 @@
+# Wisecolt-CI Proje Genel Bilgileri
+
+## Proje Tanımı
+Wisecolt-CI, modern web teknolojileriyle geliştirilmiş tam teşekküllü bir CI/CD (Sürekli Entegrasyon/Sürekli Dağıtım) platformudur. Proje, repository otomasyonu ve test süreçlerini yönetmek için tasarlanmıştır.
+
+## Teknoloji Yığını
+
+### Backend
+- **Platform**: Node.js + TypeScript
+- **Framework**: Express.js
+- **Veritabanı**: MongoDB
+- **Gerçek Zamanlı**: Socket.io
+- **Kimlik Doğrulama**: JWT (JSON Web Token)
+- **Process Yönetimi**: Child Process (git, npm komutları)
+- **Geliştirme Araçları**: tsx (hot-reload)
+
+### Frontend
+- **Platform**: React 18 + TypeScript
+- **Build Tool**: Vite
+- **Stil**: Tailwind CSS
+- **UI Bileşenleri**: shadcn/ui
+- **Rotalama**: React Router DOM
+- **HTTP Client**: Axios
+- **Font Awesome**: Font Awesome SVG Icons
+- **Toast Bildirimleri**: Sonner
+- **İkonlar**: Lucide React
+
+### DevOps
+- **Konteynerizasyon**: Docker + Docker Compose
+- **Hot Reload**: Geliştirme anında kod değişiklikleri
+- **Environment**: .env konfigürasyon yönetimi
+
+## Proje Yapısı
+
+```
+wisecolt-ci/
+├── backend/
+│   ├── src/
+│   │   ├── config/env.ts           # Konfigürasyon yönetimi
+│   │   ├── middleware/authMiddleware.ts  # JWT kimlik doğrulama
+│   │   ├── models/job.ts           # MongoDB Job modeli
+│   │   ├── routes/
+│   │   │   ├── auth.ts            # Giriş/kimlik endpoint'leri
+│   │   │   └── jobs.ts            # Job yönetim endpoint'leri
+│   │   ├── services/jobService.ts   # Job süreç yönetimi
+│   │   └── index.ts               # Express sunucu ana dosyası
+│   ├── package.json
+│   ├── tsconfig.json
+│   ├── Dockerfile
+│   └── .env
+├── frontend/
+│   ├── src/
+│   │   ├── api/
+│   │   │   └── client.ts           # API istemci ayarları
+│   │   ├── components/
+│   │   │   ├── ui/                 # shadcn/ui bileşenleri
+│   │   │   ├── ProtectedRoute.tsx  # Korumalı rotalar
+│   │   │   ├── DashboardLayout.tsx # Ana kontrol paneli
+│   │   │   └── ThemeToggle.tsx     # Tema değiştirme
+│   │   ├── pages/                   # Sayfa bileşenleri
+│   │   │   ├── LoginPage.tsx       # Giriş sayfası
+│   │   │   ├── HomePage.tsx        # Ana sayfa
+│   │   │   ├── JobsPage.tsx        # Job listesi
+│   │   │   └── JobDetailPage.tsx   # Job detayı
+│   │   ├── providers/                # React Context Provider'lar
+│   │   │   ├── auth-provider.tsx   # Kimlik yönetimi
+│   │   │   ├── socket-provider.tsx # Socket.io bağlantısı
+│   │   │   ├── live-provider.tsx    # Gerçek zamanlı güncellemeler
+│   │   │   └── theme-provider.tsx  # Tema yönetimi
+│   │   ├── lib/utils.ts             # Yardımcı fonksiyonlar
+│   │   ├── App.tsx                 # Ana uygulama bileşeni
+│   │   └── main.tsx                # Giriş noktası
+│   ├── package.json
+│   ├── vite.config.ts
+│   ├── tailwind.config.js
+│   └── Dockerfile
+├── docker-compose.yml
+└── README.md
+```
+
+## Temel Özellikler
+
+### Authentication Sistemi
+- JWT tabanlı kimlik doğrulama
+- .env dosyasında yönetilen admin bilgileri
+- Korumalı rotalar için middleware
+- localStorage tabanlı token saklama
+
+### Job Yönetim Sistemi
+- Repository URL ve test komutu tanımımlama
+- Zaman tabanlı otomatik çalıştırma (dakika/saat/gün)
+- Real-time durum güncellemeleri
+- Job log akışı
+- Test sonuçlarını kayıt ve izleme
+
+### Real-time İletişim
+- Socket.io tabanlı gerçek zamanlı iletişim
+- Job durum güncellemeleri
+- Sayaç yayınınlaması
+- Canlı log akışı
+
+### UI/UX Özellikler
+- Modern React tabanlı arayüz
+- shadcn/ui bileşen kütüphanesi
+- Tailwind CSS ile responsive tasarım
+- Dark/Light tema desteği
+- Toast bildirim sistemi
+
+## Port Yapılandırması
+- Frontend: http://localhost:5173
+- Backend API: http://localhost:4000  
+- MongoDB: localhost:27017
+
+## Environment Değişkenleri
+- PORT: Backend sunucu portu (4000)
+- MONGO_URI: MongoDB bağlantı adresi
+- ADMIN_USERNAME: Admin kullanıcı adı
+- ADMIN_PASSWORD: Admin şifresi
+- JWT_SECRET: JWT imzalama anahtarı
+- CLIENT_ORIGIN: Frontend adresi (CORS için)