For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/modules/task-recovery.md (or send Accept: text/markdown).

Görev API'si ve kurtarma

Belirsiz gönderimi yeni görev oluşturmadan kurtarın.

Bu kılavuz hakkında sor

Başlamadan önce

İndirdiğiniz supastack projenizi Visual Studio Code'de Dosya → Klasörü Aç'ı kullanarak açın ve ardından Terminal → Yeni Terminal'i seçin. Depo kökü package.json'u, uygulamaları ve paketleri içeren klasördür. Aşağıdaki komutu orada çalıştırın ve terminalini açık bırakın. Bir komut tanınmazsa devam etmeden önce araç kurulum kılavuzunu tamamlayın.

Önce platform eğitimini okuyun. Sunucu, tarayıcı veya telefon isteklerini yanıtlayan uygulama işlemidir. Web, apps/web/.env.local'yi okur, Expo, apps/mobile/.env.local'yi okur ve veritabanı geçiş komutları root .env'yi okur. Veritabanı olmayan/gösterge paneli gösterimi, Postgres'nin taşınmasını gerektiren gerçek/auth hesaplarından ayrıdır. Yalnızca telefona veya masaüstüne yönelik bir ödeme, ayrı olarak çalışan bir Web arka ucuna ihtiyaç duyar.

corepack pnpm --filter @supastack/web dev

Kurulum ve yapılandırma

POST /api/ai/tasks kimliği doğrulanmış çalışma alanı ve etkin yetkilendirme gerektirir. Anahtarlı istek, gönderimden önce değişmez görev rezerve eder. Idempotency-Key, 16–128 ASCII harf, rakam, alt çizgi ya da kısa çizgi kabul eder.

POST /api/ai/tasks
Idempotency-Key: a-stable-client-submission-key

Recovery body: { "resume": true }
Status: GET /api/ai/tasks/{taskId}

Uygulama iş akışı

Göndermeden önce kurtarma anahtarını kalıcı kılın. Belirsiz gönderimden sonra aynı anahtarı ve resume gövdesini yeniden kullanın; sunucu orijinal girdiyi yükler ve aynı görev kapsamlı Trigger kimliğini yeniden dener. Aynı anahtar altında değişen girdi 409 idempotencyConflict döndürür.

Belirsiz kuyruklamadan sonra HTTP 202, gönderimin belirsiz olduğu anlamına gelir. Trigger'ın işi kabul ettiğini kanıtlamaz. Zaten çalışan ya da sonlanmış görevler başka kuyruklama olmadan kaydedilmiş durumu döndürür. Kurtarma yine kimlik doğrulama, sahiplik ve yetkilendirme gerektirir.

Doğrulama ve sorun giderme

Kayıp yanıtı, değişen-girdi çakışmasını, yabancı-çalışma-alanı isteğini ve yenileme geri yüklemesini uygulayın. Otomatik outbox göndericisi ya da uçtan uca tam-bir-kez garantisi yoktur. Yan etkilerini araştırmadan çalışan görevi kuyruğa sıfırlamayın.