🚀 Workly - Kurumsal İK & Görev Yönetim Platformu

Workly, İK yönetimi, görev takibi, performans analitiği ve kurumsal iletişim için mikro frontend tabanlı kurumsal bir platformdur. Next.js 15, Vue 3, Angular 17 ile geliştirilmiş ve Vercel üzerinde modern, ölçeklenebilir bir mimari ile deploy edilmiştir.

🌐 Canlı Demo: https://workly-landing.vercel.app

✨ Özellikler

🏢 Kurumsal Seviye Mimari

• 🔥 Mikro Frontend Mimarisi - Her modül bağımsız olarak geliştiriliyor, deploy ediliyor ve ölçekleniyor
• 🔒 Iframe Tabanlı Entegrasyon - Her uygulama için güvenli, izole çalışma ortamı
• 📦 Monorepo Yönetimi - Turbo ile hızlandırılmış pnpm workspaces
• 🎨 Ortak Bileşen Kütüphanesi - Tüm modüllerde tutarlı UI/UX
• 🌐 Çoklu Framework Desteği - Next.js, Vue ve Angular sorunsuz çalışıyor

🎯 Ana Modüller

🏗️ Mimari

Workly, mikro frontend mimarisi kullanmaktadır. Her modül bağımsız olarak geliştirilip deploy edilir ancak shell uygulaması üzerinden sorunsuz bir şekilde entegre edilir.

┌─────────────────────────────────────────┐
│          Shell (Ana Uygulama)           │
│         Next.js 15 - Port 3005          │
│  ┌───────────────────────────────────┐  │
│  │   Navigasyon & Kimlik Doğrulama  │  │
│  └───────────────────────────────────┘  │
└─────────────┬───────────────────────────┘
              │
    ┌─────────┼─────────┬─────────┐
    │         │         │         │
┌───▼───┐ ┌──▼───┐ ┌───▼───┐ ┌───▼────┐
│  İK   │ │Görev │ │Perf.  │ │Duyuru  │
│Angular│ │Next  │ │Angular│ │Next    │
│ 3002  │ │ 3003 │ │ TBD   │ │ 3004   │
└───────┘ └──────┘ └───────┘ └────────┘

📖 Detaylı mimari dokümantasyon için: docs/architecture.md

🚀 Hızlı Başlangıç

Ön Gereksinimler

• Node.js >= 18.0.0
• pnpm >= 8.0.0

# pnpm'i global olarak yükleyin (yoksa)
npm install -g pnpm@8.12.0

Kurulum

1. Repository'yi klonlayın

git clone https://github.com/hamzaince6/Workly.git
cd workly

2. Bağımlılıkları yükleyin

pnpm install

3. Ortam değişkenlerini ayarlayın

# Root .env.example dosyasını kopyalayın
cp .env.example .env

# Her uygulama için .env.example dosyalarını da kopyalayın (opsiyonel)
# cp apps/shell/.env.example apps/shell/.env.local

4. Geliştirme sunucusunu başlatın

# Tüm uygulamaları paralel olarak başlat
pnpm dev

Bu komut şunları başlatır:

• Landing: http://localhost:3000
• Auth: http://localhost:3001
• HR Management: http://localhost:3002
• Task Manager: http://localhost:3003
• Announcements: http://localhost:3004
• Shell: http://localhost:3005

📚 Dokümantasyon

Detaylı dokümantasyon için docs/ klasörüne bakın:

• 📖 Mimari Dokümantasyon - Detaylı mimari açıklamaları
• 🔧 Geliştirme Rehberi - Geliştirme süreçleri ve best practices
• 📦 Ortak Paketler - Shared packages dokümantasyonu
• 🌐 Deployment - Deployment rehberi
• 🎯 Roadmap - Proje yol haritası
• 🔓 Açık Kaynak Kurulum - Açık kaynak yapılandırması

🛠️ Teknoloji Yığını

• Frontend: Next.js 15, Vue 3, Angular 17, React 18
• Styling: Tailwind CSS
• Language: TypeScript 5.3
• Package Manager: pnpm
• Build Tool: Turbo
• Deployment: Vercel

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! Lütfen şu yönergeleri takip edin:

1. Repository'yi fork edin
2. Feature branch oluşturun (git checkout -b feature/harika-ozellik)
3. Değişikliklerinizi commit edin (git commit -m 'Harika özellik eklendi')
4. Branch'inizi push edin (git push origin feature/harika-ozellik)
5. Pull Request açın

📋 Detaylı katkı rehberi için: CONTRIBUTING.md
📋 Katkıda bulunabileceğiniz konular için: Issues sayfasına bakın.

🔒 Güvenlik

Güvenlik açığı bulduysanız, lütfen hamzaince001@gmail.com adresine e-posta gönderin.
Detaylar için: SECURITY.md

📄 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.

👥 Yazar

Hamza İnce - İlk geliştirme ve mimari tasarım

• GitHub: @hamzaince6