API de tâches et reprise

Avant de commencer

Ouvrez votre projet supastack téléchargé dans Visual Studio Code en utilisant Fichier → Ouvrir le dossier, puis choisissez Terminal → Nouveau terminal. La racine du référentiel est le dossier contenant package.json, les applications et les packages. Exécutez la commande ci-dessous et laissez son terminal ouvert. Si une commande n'est pas reconnue, terminez le guide d'installation de l'outil avant de continuer.

Lisez d’abord le didacticiel de la plateforme. Un serveur est le processus d'application qui répond aux requêtes du navigateur ou du téléphone. Le Web lit apps/web/.env.local, Expo lit apps/mobile/.env.local et les commandes de migration de base de données lisent root .env. La démonstration sans base de données/tableau de bord est distincte des comptes réels/auth, qui nécessitent une migration Postgres. Un paiement sur téléphone ou sur ordinateur uniquement nécessite un backend Web exécuté séparément.

• Installez les outils et récupérez le code
• Apprendre les commandes, les fichiers et la configuration
• Terminez le didacticiel Web de première exécution

corepack pnpm --filter @supastack/web dev

Configuration et paramètres

POST /api/ai/tasks exige un espace de travail authentifié et un droit actif. Une requête avec clé réserve une tâche immuable avant sa distribution. Idempotency-Key accepte de 16 à 128 caractères ASCII : lettres, chiffres, tirets bas ou traits d’union.

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

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

Processus d’implémentation

Enregistrez la clé de reprise avant la soumission. Après une distribution incertaine, réutilisez la même clé et le corps resume ; le serveur charge l’entrée d’origine et relance la même identité Trigger liée à la tâche. Une entrée modifiée avec la même clé renvoie 409 idempotencyConflict.

HTTP 202 après une mise en file ambiguë signifie que la distribution reste incertaine ; cela ne prouve pas que Trigger a accepté le travail. Les tâches en cours ou terminées renvoient l’état enregistré sans nouvelle mise en file. La reprise exige toujours une authentification, la propriété de la tâche et un droit valide.

Vérification et dépannage

Reproduisez une réponse perdue, un conflit après modification de l’entrée, une requête issue d’un autre espace de travail et la restauration après actualisation. Il n’existe ni distributeur automatique de boîte d’envoi ni garantie de traitement exactement une fois de bout en bout. Ne remettez pas une tâche en cours à l’état queued sans examiner ses effets.