Y365, kurumların IT giderlerini (Microsoft 365 lisansları, sunucu maliyetleri ve donanım giderleri) merkezi bir yerden yönetmesini, grup şirketlerine adil bir şekilde dağıtmasını ve detaylı raporlar almasını sağlayan web tabanlı bir uygulamadır.

Bu proje aşağıdaki temel sorunları çözmek için tasarlanmıştır:

• Merkezi Yönetim: Dağınık haldeki lisans ve sunucu faturalarının tek bir panelden yönetilmesi.
• Adil Maliyet Dağıtımı: Ortak kullanılan kaynakların (sunucu, lisans vb.) holding veya grup şirketlerine kullanım oranına göre paylaştırılması.
• Otomasyon: Microsoft Graph API entegrasyonu ile lisans sayılarının otomatik çekilmesi.
• Şeffaf Raporlama: Her firmanın ne kadar IT gideri olduğunu gösteren Excel ve PDF raporlarının üretilmesi.

Projeyi kendi sunucunuza kurmak için aşağıdaki adımları izleyebilirsiniz.

• Node.js (v16 veya üzeri)
• Git

1. Projeyi Sunucuya Çekin:

   git clone https://github.com/ufukkay/Y365.git
   cd it-cost-app

2. Frontend Bağımlılıklarını Yükleyin:

   npm install

3. Backend Bağımlılıklarını Yükleyin:

   cd server
   npm install
   cd ..

4. Çevre Değişkenlerini Ayarlayın (.env): Ana dizinde ve server klasöründe .env dosyaları oluşturun. Microsoft Graph API kullanacaksanız Azure AD bilgilerinizi server/.env dosyasına ekleyin:

   # server/.env
   AZURE_TENANT_ID=azure-tenant-id-buraya
   AZURE_CLIENT_ID=azure-client-id-buraya
   AZURE_CLIENT_SECRET=azure-secret-buraya
   PORT=3001

5. Uygulamayı Çalıştırın:

   Geliştirme Modu (Dev):

   # Terminal 1 (Backend)
   cd server
   npm run start
   
   # Terminal 2 (Frontend)
   npm run dev

   Canlı Ortam (Production): Frontend uygulamasını build alıp, backend üzerinden veya bir web sunucusu (Nginx/IIS) ile sunabilirsiniz.

   npm run build

• Microsoft 365 Entegrasyonu: Lisans sayılarını ve atamalarını Azure AD üzerinden otomatik çeker.
• Kullanıcı Detayları: Hangi lisansın hangi kullanıcılara (Ad Soyad) atandığını raporlar ekranında detaylı gösterir.
• Maliyet Matrisi: Giderleri firmalara manuel, eşit veya yüzdesel olarak dağıtma imkanı.
• Akıllı Dağıtım: "Kalanı Tamamla", "Eşit Dağıt" ve "Kullanıcılardan Dağıt" gibi hızlı aksiyon butonları.
• Excel İşlemleri: Fatura ve kullanıcı listelerini Excel'den içe/dışa aktarma.
• Dinamik Raporlama: Firma bazlı veya hizmet bazlı detaylı maliyet tabloları.

G 2.0 ve sonrası için planlanan geliştirmeler:

• LDAP / Active Directory Login: Kurumsal kullanıcıların kendi AD hesapları ile sisteme giriş yapabilmesi.
• Rol Bazlı Yetkilendirme (RBAC): Admin, Raporlayıcı ve İzleyici gibi farklı kullanıcı rolleri.
• Gelişmiş Dashboard: Aylık gider değişimlerini gösteren trend grafikleri ve görsel panolar.
• Döviz Kuru Entegrasyonu: TCMB üzerinden günlük kur çekerek maliyetlerin otomatik TL/USD çevrimi.
• Otomatik Fatura Okuma (OCR): Taranmış faturalardan kalemlerin yapay zeka ile otomatik ayrıştırılması.
• Docker Desteği: Tek komutla (docker-compose up) tüm sistemin ayağa kaldırılması.

Geliştirici: Ufuk Kaya