# İlk tema ve ilk uygulama

> Sıfırdan başlayıp bir geliştirme mağazasında çalışan bir tema ve bir uygulamaya varmak.

Bu sayfa sizi boş bir klasörden, bir geliştirme mağazasında çalışan bir temaya ve bir uygulamaya götürür. Komutların ayrıntısı [CLI](cli.md) sayfasındadır; burada yalnızca sıra anlatılır.

## Gerekenler

- `biticaret` CLI: [kurulum](cli.md#kurulum).
- Tema için: `git` ve `zip`.
- Uygulama için: Go, ve iş ortağı portalında uygulamalar üzerinde çalışabilen bir üyelik.
- Bir geliştirme mağazası. İş ortağı organizasyonunuz geliştirme mağazaları açar: ücretsizdirler, şifre koruması kapatılamaz ve ödeme adımı yalnızca test modunda çalışır, yani gerçek satış yapmazlar.

## Bir tema

1. İskelet temadan başlayın:

   ```bash
   biticaret theme init my-theme
   cd my-theme
   ```

2. Dosyaları düzenleyin. Tema nasıl kurulur: [Tema yapısı](themes/structure.md).

3. Denetleyin. Bu, yüklemenin yaptığı denetimin aynısıdır:

   ```bash
   biticaret theme check --strict .
   ```

4. Tema klasörlerini ZIP yapın:

   ```bash
   zip -r ../my-theme.zip assets blocks config layout locales sections snippets templates
   ```

   ZIP yalnızca tema klasörlerini içerir; `README.md`, `LICENSE`, `AGENTS.md` ve `CLAUDE.md` gibi dosyaları yükleme reddeder.

5. Geliştirme mağazanızın yönetim panelinde **Online mağaza > Temalar** altından ZIP'i yükleyin. Yüklenen tema yayınlanmamış olarak gelir: önizleyin, hazır olduğunda yayınlayın.

Döngü budur: düzenle, `theme check`, ZIP, yükle, önizle. Her yükleme yeni bir yayınlanmamış tema oluşturur; bir mağaza en çok 20 tema tutar.

## Partner hesabı ve geliştirme mağazası

Uygulama geliştirmek için bir partner organizasyonu gerekir; temalar için gerekmez, yönetim panelindeki herhangi bir mağazaya yüklenir.

1. Yönetim paneli adresinde (CLI'ın `auth login` komutundaki platform adresi; varsayılan `https://admin.biticaret.com.tr`) **Hesap oluşturun** ile bir hesap açın ve e-posta adresinizi doğrulayın: doğrulanmamış bir hesap başvuramaz.
2. İş ortağı portalını (`/partners`) açın ve **Partner olun** formunu doldurun: organizasyonun bilgileri, bir veya birkaç amaç (`Uygulama geliştirme`, `Müşteri mağazaları`, `Yönlendirme` ya da `Diğer`), ne yapmak istediğiniz ve varsa önceki işlerinizin bağlantıları. Başvuruyu Biticaret ekibi elle değerlendirir; reddedilen bir amaç için 30 gün sonra yeniden başvurulur. Ölçütler ve süre iş ortağı programıyla birlikte netleşir. Beklerken portal yalnızca başvurunuzun durumunu gösterir.
3. `Uygulama geliştirme` onaylanınca portalın **Mağazalar** sayfasından **Mağaza oluştur** ile `Geliştirme mağazası` türünde bir mağaza açın (ad ve adres verilir). Kuruluş başına bir mağaza sınırı vardır; sayfa kullanılanı ve kalanı gösterir. Geliştirme mağazası ücretlendirilmez, şifre koruması kapatılamaz, ödemeler yalnızca test modundadır ve müşteriye devredilemez.
4. Aynı portalda uygulamanızı oluşturabilirsiniz (ad, kısa ad ve dağıtım: genel ya da tek bir müşteri mağazası için özel); ya da `biticaret app config link` bunu CLI'dan yapar.

## Bir uygulama

1. Go şablonundan başlayın:

   ```bash
   biticaret app init my-app
   cd my-app
   ```

   Şablon küçük bir Go sunucusudur: OAuth ile kurulur, yönetim panelinde bir sayfa gösterir ve her uygulamanın yanıtlaması gereken KVKK webhook'larını karşılar.

2. Yapılandırmayı denetleyin (çevrimdışı çalışır):

   ```bash
   biticaret app check
   ```

3. Giriş yapın ve uygulamayı organizasyonunuzda oluşturun. `config link`, `biticaret.app.toml` dosyasına `client_id` yazar:

   ```bash
   biticaret auth login
   biticaret app config link
   ```

4. `biticaret.app.toml` içindeki `application_url` adresini sunucunuzun dışarıdan erişilen HTTPS adresine çevirin ve sunucuyu çalıştırın. `CLIENT_ID` ve `CLIENT_SECRET` iş ortağı portalındaki uygulamanızdan gelir; `APP_URL`, `application_url` sunucusunun kök adresidir:

   ```bash
   CLIENT_ID=… CLIENT_SECRET=… APP_URL=https://my-app.example.com go run .
   ```

5. Bir sürüm yükleyip yayınlayın:

   ```bash
   biticaret app deploy --submit
   ```

   Yalnızca `app deploy` bir taslak yükler; taslak sürüm hiçbir mağazaya kurulmaz, kurulum her zaman uygulamanın yayınlanmış sürümünü kullanır. Özel bir uygulamada `--submit` (ya da portalın **Sürümler** sekmesindeki **Gönder**) sürümü hemen yayınlar; onaydan önce yalnızca kendi kuruluşunuzun mağazalarında çalışır. Ödeme uygulamaları ve onaylı erişimden fazlasını isteyen sürümler önce incelemeden geçer.

6. Uygulamayı geliştirme mağazanıza kurun. Kurulum mağazanın yönetim panelinde başlar: platform `application_url` adresini imzalı bir sorguyla açar, uygulama mağaza sahibini izin ekranına gönderir ve onaydan sonra bir erişim jetonu alır. Akışın tamamı: [Uygulama API'si](apps/api.md#kurulum).

### Yerel geliştirmede HTTPS adresi

Platform `application_url` adresini, yönlendirme adreslerini ve webhook adreslerini kendi sunucusundan çağırır; bu yüzden uygulamanızın internetten erişilen bir HTTPS adresi olmalıdır. Bilgisayarınızda geliştirirken herhangi bir tünel aracı (yerel bir portu genel bir HTTPS adresine açan bir araç) işinizi görür. Tünelin adresini aldıktan sonra:

- `biticaret.app.toml` içindeki `application_url` değerini o adrese çevirin. `[auth] redirect_urls`, `[privacy]` adresleri ve webhook `uri` değerleri yol olarak yazıldıysa (`/auth/callback`, `/webhooks`) `application_url` sunucusuna göre çözülür; başka bir şey değiştirmeniz gerekmez. Tam adres yazdıysanız onları da güncelleyin.
- Sunucuyu `APP_URL` olarak aynı adresle başlatın.
- `biticaret app check` ve `biticaret app deploy --submit` ile yapılandırmayı yeniden yükleyin. Adresler sürümle birlikte gittiği için, `app config push` gibi ayrı bir komut yoktur: tünelin adresi her değiştiğinde yeni bir sürüm yükleyip yayınlamak (`app deploy --submit`) gerekir. Sabit bir adres veren bir tünel bunu önler.

Döngü: kodu değiştirin, sunucuyu yeniden başlatın; yapılandırma (izinler, webhook'lar, adresler, uzantılar) değiştiyse `app check` ve yeniden `app deploy --submit`.

Şablon mağazaların jetonlarını bellekte tutar, yeniden başlatınca unutur. Gerçek bir uygulamada jetonları kendi veritabanınızda, şifreli tutun.

## İnceleme ve yayın

`biticaret app deploy` bir taslak sürüm yükler; `--submit` onu aynı komutla incelemeye gönderir (ya da iş ortağı portalının **Sürümler** sekmesinden gönderin). Bir sürümün inceleme durumu `draft` (taslak), `submitted` (incelemede), `approved` (onaylı) veya `rejected` (reddedilmiş) olur; `biticaret app versions list` durumları gösterir. Göndermek için uygulamanın mağaza sayfası (listeleme bilgileri) tam olmalıdır, değilse sürüm taslak kalır ve komut `listing_incomplete` ile 1 döner. Yalnızca onaylı sürüm yayına çıkar.

- **Genel uygulama:** sürüm Biticaret incelemesinden geçer; onaylanınca uygulama, mağazaların **Uygulamalar > Uygulama mağazası** sekmesinde listelenir ya da (listelenmesin seçilirse) yalnızca yükleme bağlantısıyla bulunur. İnceleme ölçütleri ve süresi iş ortağı programıyla birlikte yayımlanacaktır.
- **Özel uygulama:** pazarda yer almaz. Kuruluşunuzun geliştirme ve müşteri mağazalarına, portalın uygulama sayfasındaki yükleme bağlantısıyla onaysız kurulur; canlı bir mağazaya çıkması için o mağaza adına ayrıca Biticaret onayı istenir.

## Sonra

- Tema: [Tema yapısı](themes/structure.md), [nesneler](themes/objects.md), [etiketler](themes/tags.md), [filtreler](themes/filters.md).
- Uygulama: [Uygulama API'si](apps/api.md), [webhook'lar](apps/webhooks.md), [uygulama vekili ve arayüz](apps/storefront-and-admin.md), [Go SDK](apps/go-sdk.md), [yapılandırma dosyaları](apps/configuration.md), [bütün API yolları](reference/api-routes.md).
- Kodlama asistanı: `biticaret mcp` ile belgeleri ve denetimleri asistanınıza bağlayın ([CLI](cli.md#yapay-zeka-kodlama-asistaniyla-calismak)).
- Uzantılar: `biticaret app generate extension --type <tür> --name <ad>` tema blokları, ödeme adımı fonksiyonları, arayüz uzantıları ve web pikselleri başlatır.
