Checklist des boilerplates SaaS IA 2026 : 12 critères vérifiables
En 2026, le starter « AI-first » est une catégorie mature, avec des checklists d'acheteur publiées. C'est une bonne nouvelle : vous pouvez en évaluer un en un après-midi au lieu de croire une page d'atterrissage. Voici douze critères, chacun accompagné d'une commande réellement exécutable. Aucun ne nécessite l'accès au dépôt privé du vendeur — seulement le ZIP téléchargé, un terminal et un peu de patience.

Base de capacités : les six sont attendues
Ces six éléments doivent figurer dans tout boilerplate SaaS IA sérieux en 2026. Ce sont des prérequis, pas des différenciateurs. S'il en manque un, cherchez ailleurs.
1. Sortie en streaming
Un endpoint en streaming émet le texte progressivement, au fur et à mesure de la génération. Un faux renvoie un seul blob JSON une fois le modèle terminé, puis anime un curseur de frappe dans l'interface.
curl -N -s http://localhost:3000/api/chat -H 'Content-Type: application/json' -d '{"messages":[{"role":"user","content":"Count from 1 to 20"}]}'Regardez le terminal : les vrais fragments arrivent avant le dernier jeton. Si toute la réponse tombe d'un coup, la fonctionnalité est du théâtre. Une capture du panneau réseau montrant Transfer-Encoding: chunked et plusieurs petites réponses constitue une preuve tout aussi valable.
2. Plusieurs fournisseurs de modèles
Un starter sérieux place l'accès au modèle derrière une seule route et change de fournisseur via une variable d'environnement. Vous devez pouvoir passer d'OpenAI à Anthropic sans toucher au code applicatif.
grep -R "OPENAI_API_KEY|ANTHROPIC_API_KEY" -n lib app | head -20Changez ensuite de clé, redémarrez et rejouez la même requête. Si la route casse ou qu'un second SDK est codé en dur dans un composant, la revendication « multi-fournisseurs » ne vit que dans le README.
3. Comptage d'usage et quotas
L'usage doit être compté côté serveur et appliqué avant l'appel au fournisseur, pas affiché comme un chiffre décoratif dans le tableau de bord.
for i in $(seq 1 25); do curl -s -o /dev/null -w "%{http_code} " http://localhost:3000/api/chat -d '{"q":"hi"}'; done; echo
curl -s -D - http://localhost:3000/api/chat -d '{"q":"hi"}' | grep -i "retry-after|ratelimit"Vous voulez un 429 une fois le quota épuisé et un en-tête Retry-After honnête dans la réponse. Une interface qui se contente de masquer le bouton n'est pas un quota.
4. Recherche avec citations
La recherche signifie que la réponse peut être retracée jusqu'à un fragment de votre propre document. Ingérez un PDF de test et posez une question que lui seul peut résoudre.
curl -s -X POST http://localhost:3000/api/ingest -F '[email protected]'
curl -s http://localhost:3000/api/ask -H 'Content-Type: application/json' -d '{"q":"What is the refund window?"}' | jq '.sources'Le tableau sources doit contenir les noms de documents et les identifiants de fragments (ou numéros de page), et ces marqueurs doivent aussi apparaître en ligne dans la réponse rendue. Un paragraphe assuré sans provenance est une hallucination que vous ne pouvez pas auditer.

Base de production : les éléments que les vendeurs sautent
5. Appel d'outils et MCP
Un client agent doit pouvoir découvrir et appeler votre endpoint d'outils sans intégration sur mesure. La spécification Model Context Protocol est le contrat de référence ici.
npx @modelcontextprotocol/inspector http://localhost:3000/mcpL'inspecteur doit lister vos outils avec des entrées typées. Si la découverte ne fonctionne que dans le chat de démo du vendeur, vous avez un SDK propriétaire, pas du MCP.
6. Honnêteté des erreurs fournisseur
Injectez une clé invalide et confirmez que l'échec est réel et journalisé.
OPENAI_API_KEY=sk-invalid npm run devDans un second terminal, appelez la route de chat, puis lisez le journal serveur. Vous voulez un 5xx (ou un 4xx propre avec un vrai message) et une entrée d'erreur structurée côté serveur. Une réponse générée et souriante lors d'un échec d'authentification signifie que les erreurs sont avalées.
7. Vérification de signature des webhooks
Les webhooks de facturation sont les requêtes les plus falsifiées que votre application recevra. Le guide de signature Stripe décrit le contrôle attendu.
curl -s -i -X POST http://localhost:3000/api/webhooks/stripe -H 'Content-Type: application/json' -d '{}'Un corps non signé doit renvoyer 400, jamais 200. Rejouez aussi un corps avec un horodatage périmé : cela doit échouer également.
8. Idempotence
Les fournisseurs réessaient. Le même identifiant d'événement livré trois fois ne doit produire qu'une seule écriture.
psql "$DATABASE_URL" -c "select event_id, count(*) from processed_events group by 1 order by 2 desc limit 5;"Rejouez trois fois un événement capturé avec une signature valide (voir la référence des types d'événements), puis relancez la requête. Tout event_id dont le compte dépasse 1 est un bug d'écriture en double.
9. Garde-fous et limites de débit
Les refus doivent survenir côté serveur avant un appel de modèle coûteux.
curl -s -o /dev/null -w "%{http_code}
" -X POST http://localhost:3000/api/chat -d '{"q":"hi"}'Non authentifié doit donner 401 et hors quota 429. Si le endpoint renvoie 200 et que l'interface masque simplement le champ, le garde-fou est cosmétique.
10. Observabilité
curl -s http://localhost:3000/api/health | jq .
grep -R "error_events" -n lib | head/api/health doit sonder la base de données, pas seulement renvoyer { "ok": true }. Cherchez des journaux structurés, une barrière d'erreur, une table locale error_events et un récepteur ERROR_REPORT_URL optionnel. Puis demandez qui configure ce récepteur et qui est appelé en astreinte — le code seul ne peut appeler personne.

11. Documentation lisible par les agents
for f in AGENTS.md llms.txt openapi.json; do test -f "$f" && echo "OK $f" || echo "MISSING $f"; doneLa proposition llms.txt et la spécification OpenAPI 3.1 sont les deux contrats qui méritent d'être exigés. Vérifiez que ces fichiers sont dans le ZIP, pas seulement sur le site marketing, et que les règles de style sont cadrées pour qu'un agent ne puisse pas réécrire votre design system.
12. Visibilité des coûts
psql "$DATABASE_URL" -c "select user_id, sum(prompt_tokens) as prompt, sum(completion_tokens) as completion from usage group by 1 order by prompt desc limit 10;"Sans comptage des jetons, vous ne pouvez pas relier un quota à une facture. Même sans tableau de bord des coûts, les compteurs bruts permettent de calculer la dépense et de repérer les abus.

Ce qui n'est pas dans cette checklist
Le nom de marque, l'animation d'accueil et le nombre d'écrans de démonstration. Pas davantage les auto-déclarations du type « économisez 480 heures » — elles ne sont pas vérifiables. Ne traitez aucun critère de base isolé comme un différenciateur ; fin 2026, ce sont des tickets d'entrée. Rédiger un long tableau de fonctionnalités est plus facile que rédiger une checklist vérifiable — c'est précisément pourquoi vous devez préférer la seconde.
La seule question qui sépare encore les produits
Demandez : reçois-je le même dépôt fixe que tout le monde, ou un build généré depuis ma propre configuration avec les modules non sélectionnés réellement supprimés ? Uncorne suit la seconde voie : le Builder choisit l'authentification, la passerelle, les fournisseurs d'IA, les fonctionnalités et le style, et le serveur ne renvoie que ces modules. Si un vendeur répond « un dépôt fixe », prévoyez du temps pour supprimer le code que vous n'avez pas demandé et vérifier que cette suppression ne laisse aucun lien mort. Une checklist vous dit quoi vérifier ; un build généré supprime l'essentiel de ce qui méritait vérification.
FAQ
Le support MCP est-il un différenciateur en 2026 ?+
Non. Les endpoints MCP, l'appel d'outils, la facturation à l'usage, les évaluations et l'observabilité figurent désormais dans les checklists publiques d'achat de boilerplates SaaS IA. Considérez-les comme la base, vérifiez-les avec la commande inspector, sans payer de prime pour l'argument marketing.
Comment vérifier l'affirmation de streaming d'un vendeur ?+
Ouvrez le panneau réseau ou utilisez curl avec -N et observez si des fragments arrivent avant la fin du modèle. Une réponse JSON unique à la fin n'est pas du streaming, même si l'interface anime un curseur de frappe.
Quel est le vide caché le plus courant dans les starters IA ?+
La vérification de signature et l'idempotence des webhooks sur le parcours de facturation, ainsi que la propagation honnête des erreurs fournisseur sur le parcours IA. Tout paraît correct en démo, mais échoue dès la première requête falsifiée ou clé API invalide.
Un dépôt de starter fixe fait-il gagner du temps ?+
Uniquement au début. Un dépôt fixe arrive complet, mais vous devez quand même supprimer les modules non choisis et traquer les liens morts. Un build généré depuis votre configuration les retire avant livraison — vérifiez en cherchant dans le ZIP les routes que vous n'avez jamais sélectionnées.
Toutes les questions fréquentes · Version Markdown (pour les agents IA)