--- title: Hızlı Başlangıç description: Admin uygulaması geliştirmeye hızlı başlangıç rehberi --- Bu rehber size [ikas CLI](quick-start/ikas-CLI) kullanarak ilk uygulamanızı oluşturma sürecinde adım adım rehberlik edecek. ## Öğrenecekleriniz - ikas CLI'yi kurmayı ve yapılandırmayı - Yeni bir uygulama projesi oluşturmayı - Proje yapısını anlamayı --- ## Gereksinimler Aşağıdaki koşulların sağlandığından emin olun: - Öncelikle bir ikas Partner hesabınızın olması ve test mağazası oluşturmanız gerekiyor. Eğer yoksa, bir [ikas Partner hesabı oluşturun](./ikas-partner). - En son Node.js sürümünü kullandığınızdan emin olun. ```bash node --version ``` **Önemli**: Node.js v16+ gereklidir. Eski sürümler desteklenmemektedir. [nodejs.org](https://nodejs.org/tr/download/) adresinden güncel sürümü indirin. --- ## Adım 1: ikas CLI'yi Kurun Uygulama geliştirmek için gerekli CLI aracını yükleyin ve kurulumu doğrulayın: ```bash npm i -g ikas ikas --version ``` --- ## Adım 2: İlk Uygulamanızı Oluşturun Yeni bir uygulama projesi oluşturun: 1. Uygulamayı oluşturmak istediğiniz dizine gidin. Uygulamanız yeni bir alt dizinde oluşturulacaktır. 2. Aşağıdaki komutu çalıştırın: Bu komut, geliştirme sürecinizi hızlandırmak için bilgisayarınıza bir başlangıç projesi indirir. ```bash ikas app init ``` 3. Uygulamanız için bir ad girin: ```console title="Terminal" $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. ? What should we call your app? ``` 4. Uygulama framework'ünü seçin: ```console title="Terminal" {6} $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. What should we call your app? my-new-app ? For your template, which framework do you want use? (Use arrow keys) ❯ Build a Next.js app (recommended) ``` 5. Uygulama türünü seçin: Bu adımda ikas CLI, oluşturmak istediğiniz uygulama türünü seçmenizi ister. Starter App: UI + OAuth + SDK içeren, Next.js tabanlı tam uygulama. Webhook Listener App: UI yok; yalnızca ikas olaylarını dinleyip arka planda işler. Starter App seçin: - Yönetim paneli/ayar ekranı gibi kullanıcı etkileşimi gerekiyorsa - OAuth ile ikas API'lerini aktif kullanacaksanız - Mağazaya yayınlanacak bir uygulama geliştiriyorsanız Webhook Listener App seçin: - Sipariş, stok, iade vb. olaylara tepki verip arka planda işlem yapacaksanız - Hiç UI gerekmiyorsa veya UI'yi başka yerde barındırıyorsanız - Hafif, maliyeti düşük, otomasyon odaklı bir servis istiyorsanız ```console title="Terminal" {8-10} $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. What should we call your app? my-new-app ? For your template, which framework do you want use? (Use arrow keys) ✔ Build a Next.js app (recommended) ? What type of app do you want to build? (Use arrow keys) ❯ Starter app (recommended) Webhook listener app ``` 6. Admin Uygulaması oluşturma seçimi: Bu adımda CLI, ikas Partners panelinizde yeni bir uygulama oluşturmak mı istediğinizi ya da hesabınızdaki mevcut uygulamayı kullanmak isteyip istemediğinizi sorar. Yeni bir uygulama oluşturmak için "Create new app" seçeneğini seçin. ```console title="Terminal" {12-14} $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. What should we call your app? my-new-app ? For your template, which framework do you want use? (Use arrow keys) ✔ Build a Next.js app (recommended) ? What type of app do you want to build? (Use arrow keys) ✔ Starter app (recommended) ? Do you want to create a new ikas OAuth application? (Use arrow keys) ❯ Create new app Use existing app ``` 7. API yetki kapsamlarını seçin: Uygulamanızın erişebileceği ikas API kapsamlarını seçin. Bu kapsamlar, uygulamanızın hangi verilere erişebileceğini belirler. **Read Permissions**: Verileri okuma yetkisi (Campaigns, Customers, Inventories, Orders, Products) **Write Permissions**: Verileri yazma/güncelleme yetkisi (Campaigns, Customers, Inventories, Orders, Products, Storefront) Geliştiriciler, uygulamalarının ihtiyaç duyduğu minimum yetkileri seçmelidir. ```console title="Terminal" {16-25} $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. What should we call your app? my-new-app ? For your template, which framework do you want use? (Use arrow keys) ✔ Build a Next.js app (recommended) ? What type of app do you want to build? (Use arrow keys) ✔ Starter app (recommended) ? Do you want to create a new ikas OAuth application? (Use arrow keys) ✔ Create new app ? Select API scopes for your application: (Press to select, to toggle all, to invert selection, and to proceed) ❯◯ Read Campaigns ◉ Read Customers ◉ Read Inventories ◉ Read Orders ◉ Read Products ◯ Write Campaigns ◯ Write Customers ◯ Write Inventories ◯ Write Orders ◯ Write Products ◯ Write Storefront ``` 8. Tebrikler! Uygulamanız hazır: CLI, uygulama oluşturma sürecini tamamladıktan sonra size Client ID, Client Secret ve sonraki adımları gösterir. ```console title="Terminal" $ ikas app init 🎉 Welcome! Let's start by naming your app. You can change this later. What should we call your app? my-new-app ? For your template, which framework do you want use? (Use arrow keys) ✔ Build a Next.js app (recommended) ? What type of app do you want to build? (Use arrow keys) ✔ Starter app (recommended) ? Do you want to create a new ikas OAuth application? (Use arrow keys) ✔ Create new app ? Select API scopes for your application: ✔ Read Customers, Read Inventories, Read Orders, Read Products 🎉 Congratulations! Your app has been created successfully. 📦 App Details: Name: my-new-app Client ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Client Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ✨ Next steps: 1. cd my-new-app 2. ikas app dev Happy coding! ``` **Sonraki Adımlar:** 1. `cd [uygulama-adı]` ile uygulama klasörüne geçin 2. `ikas app dev` ile geliştirme sunucusunu başlatın 3. Favori IDE'nizi açıp geliştirmeye başlayın **.env dosyası otomatik olarak Client ID ve Client Secret ile yapılandırılmıştır.** Editörü açtığınızda görünecek olan proje yapısı: ikas app init terminal çıktısı --- ## Sonraki Adımlar **Tebrikler!** İlk ikas uygulamanızı başarıyla oluşturdunuz. Şimdi şunları yapabilirsiniz: - **[Geliştirme Ortamı](./admin-app-quick-start/development)** - Development workflow'u öğrenin - **[CLI Komutları](./admin-app-quick-start/ikas-cli)** - CLI komutlarını öğrenin