▶ 6:09lecture 5 min

Votre app vibe codée tourne. Elle peut crasher demain.

L'IA écrit du bon code. Le problème, c'est tout ce qu'il y a autour. Voici les 4 protections que je mets en place sur chaque application que je livre : la data, les environnements, les tests et la documentation.

Amory Rouault
Amory Rouault · Ingénieur IA freelance

// en bref

  • Une app vibe codée qui tourne n'est pas une app protégée : le risque n'est pas dans le code, il est autour.
  • La base de données n'est jamais accessible sur internet, et l'API vérifie un token à chaque appel.
  • Trois environnements au minimum : développement, stage, prod. Le stage est une réplique exacte de la prod.
  • Des tests utilisateurs automatisés, puis une documentation qui dit pourquoi les choses sont faites ainsi.

Votre application est vibe codée, elle tourne, vous avez vos premiers clients. Félicitations. Et pourtant, elle pourrait crasher dès demain.

Récemment, j'ai eu un call avec quelqu'un exactement dans ce cas. Son application, vibe codée, tournait chez ses clients. Mais côté architecture, il n'y avait que son ordinateur en local et l'environnement de ses clients. Rien pour la protéger.

L'IA écrit du bon code. Le problème, ce n'est pas le code, c'est tout ce qu'il y a autour.

Dans cet article, je reprends ce que je livre autour de chacune des applications web sur mesure que je développe, pour une architecture qui tient la route. Quatre thèmes : la base, les environnements, les tests et la documentation.

1. La base : protéger votre data

Une application, c'est trois briques. Le front, ce que l'utilisateur voit à l'écran. L'API, qui fait tout le travail derrière. Et la base de données, où sont stockées les données.

01 · front

Ce que l'utilisateur voit. Une interface, rien de plus.

02 · api

Ce qui fait le travail. Elle vérifie qui lui parle à chaque appel.

03 · base

Là où vivent les données. Seule l'API a le droit de lui parler.

Règle n° 1 : la base de données jamais sur internet

La base de données ne doit jamais être accessible sur internet. La règle est simple : seule votre API a le droit de discuter avec votre base de données.

Règle n° 2 : l'API vérifie qui lui parle

Un e-mail et un mot de passe ne suffisent pas. Ils vivent au niveau du front, qui n'est qu'une interface pour faciliter l'usage. N'importe qui peut parler directement à votre API, sans passer par le front.

Votre API doit donc vérifier elle-même qui lui parle : c'est le rôle du token. Pas de token, ou un token invalide, pas de réponse.

La data, c’est tout ce qui compte

Vous perdez votre front ou votre API, ce n'est pas grave : vous pouvez les reconstruire. Vous perdez votre base de données, c'est fini.

3 000+leads récupérés par jour chez un client

Chez un client avec qui je travaille, on récupère plus de 3 000 leads par jour. Perdre les formulaires qui les collectent, ce n'est pas très grave. Perdre la base de données, celle que lit son CRM, c'est un vrai problème. Maîtrisez votre base et faites des sauvegardes régulières.

Fluvia · Dashboard & CRM

Dashboard CRM pour 3 000 leads par jour

Chaque lead structuré et qualifié, tous les formulaires pilotés depuis un seul écran.

Avant la mise en ligne, vous devez pouvoir répondre clairement à ces questions :

  • Comment votre base de données est-elle sécurisée ?
  • Où est-elle hébergée ?
  • Qui peut y accéder, et comment ?

Si vous hésitez sur une seule de ces réponses, c'est peut-être qu'il y a un problème.

2. Dev, stage, prod : les environnements

Votre data est sécurisée. Reste une question : comment mettre votre application en ligne sans tout casser ? C'est là qu'on entre vraiment dans l'architecture, parce qu'il vous faut plusieurs environnements de travail.

Le dev et la prod ne suffisent pas. Vous travaillez sur votre ordinateur, vous n'avez pas vu que quelque chose ne fonctionnait plus, vous poussez directement en prod : si ça casse, vos utilisateurs ne peuvent plus utiliser l'application. Même chose si votre script de mise en ligne fait une mauvaise manipulation.

EnvironnementQui y vaÀ quoi il sert
DéveloppementVous, en localConstruire les fonctionnalités
StageVousTester le déploiement dans une réplique de la prod
ProdVos utilisateursFaire tourner l'application

Je recommande trois environnements au minimum, et votre application passe par les trois, l'un après l'autre. Le stage est une réplique de la prod : mêmes serveurs, même architecture. Sauf que ce ne sont pas vos utilisateurs qui testent, c'est vous.

Ce que le local ne montre pas : le réseau

Sur votre ordinateur, le front, l'API et la base de données sont au même endroit. Rien ne passe par internet, tout est instantané. Sur des serveurs, tout passe par le réseau. Le stage permet de vérifier qu'aucun maillon de la chaîne n'est cassé.

3. Les tests utilisateurs

Votre application est en ligne et tout fonctionne. Comment vous assurer qu'elle fonctionne toujours dans trois mois ?

Les tests unitaires, qui testent le code, ne suffisent pas. Il vous faut des tests utilisateurs : des tests qui lancent votre application et font ce que ferait un vrai utilisateur. C'est la seule façon de savoir qu'elle fonctionne vraiment, et ils s'automatisent.

Résultat : rien ne casse quand vous ajoutez une fonctionnalité. Les tests vous disent si ça marche. Ils ne vous disent pas pourquoi les choses ont été faites d'une certaine manière.

4. La documentation (et BMAD)

Que vous développiez à la main ou que vous vibe codiez, écrivez de la documentation. Ça peut paraître inutile, c'est pourtant le plus important. La doc garde une trace de ce qui a été fait, et surtout de pourquoi ça a été fait ainsi.

Au début, l'application est simple, vous gardez tout en tête. Quand elle grossit, les questions arrivent :

  • Comment s'assurer qu'une nouvelle fonctionnalité ne casse pas, ou n'écrase pas, l'ancienne ?
  • Comment se rappeler pourquoi les choses ont été faites d'une certaine manière ?
  • Comment savoir que l'IA ne va pas contredire ce qui a été fait avant ?

La réponse à tout ça : la documentation et les spécifications. Pour la gérer, j'utilise BMAD, une méthode à laquelle je consacrerai sûrement une vidéo. Vous pouvez déjà vous renseigner dessus, c'est un bon début.

Pour Korya, une agence web, j'ai développé un cockpit : CRM, onboarding, préparation de projet, reporting SEO, agent IA. Avec autant de fonctionnalités, sans documentation, chaque nouvelle risque de casser l'ancienne. C'est pour ça que je livre des projets documentés.

Korya · Agence web

Cockpit interne piloté depuis Claude

Onboarding, production et reporting automatisés : 2 à 3 jours gagnés par semaine.

Je spécifie, l'IA code

La façon de construire des applications a changé. L'IA écrit du code, et même du très bon code. Avant, mon travail d'ingénieur, c'était d'écrire des spécifications puis de développer les fonctionnalités qui y répondent.

80 %de mon travail passé à écrire des spécifications

Aujourd'hui, j'écris les spécifications et c'est l'IA qui code. Si vous ne lui dites pas exactement comment faire, elle exécute quand même : parfois mal, souvent parce qu'elle n'a pas compris ce que vous vouliez.

J'écrisLes spécifications, précises.
L'IA développeÀ partir de ces spécifications.
Je relisChaque changement passe en review.

Vous avez monté votre application, vibe codée ou non, et vous voulez savoir si elle va tenir dans le temps, ou ce qu'il faut améliorer dans son architecture ? Je peux l'auditer.

Questions fréquentes

Parce que le code généré par l'IA est souvent bon, mais que rien n'est mis en place autour : base de données exposée, pas d'environnement de test, pas de tests utilisateurs, pas de documentation.

Non, jamais. Seule votre API doit pouvoir lui parler, et l'API vérifie un token à chaque appel.

Trois au minimum : développement, stage et prod. Le stage est une réplique de la prod où vous testez le déploiement et le comportement réseau avant vos utilisateurs.

Non. Ils testent le code. Les tests utilisateurs lancent l'application et reproduisent ce que ferait un vrai utilisateur, et ils s'automatisent.

Pour garder la trace de ce qui a été fait et pourquoi, éviter qu'une nouvelle fonctionnalité casse l'ancienne, et que l'IA contredise ce qui existe. J'utilise la méthode BMAD.

Amory Rouault
// écrit par

Amory Rouault · Ingénieur IA freelance

Je conçois et je code des agents IA, des automatisations et des applications sur-mesure. Sur YouTube, je partage ce que j'apprends sur le terrain.

$ amory audit app

Votre app va-t-elle tenir dans le temps ?

Parlons de votre projet

// youtube

La prochaine vidéo, directement dans votre fil.

// contact

Vous voulez faire auditer votre app ? Parlons-en.