Vinicius Aguiar

Vinicius Aguiar

02Écrits

Écrits

Architecture
25 septembre 2026 · 6 min de lecture

La page faisait 514 lignes. Le cadre, 2 560.

Une expérience de micro frontend par route : la page Outils est désormais servie par une autre app Next.js, sur le même domaine. Pourquoi la partie coûteuse a été le cadre, le monorepo que ça a exigé et ce qui n'est apparu qu'en production.

Frontend
24 septembre 2026 · 6 min de lecture

Il y a une app Angular dans cet article Next.js

Une expérience : une app Angular 22, avec son propre dépôt et son propre déploiement, qui tourne en micro frontend dans cet article Next.js. Le contrat, le coût mesuré, et quand ça n'en vaut pas la peine.

Produit
24 septembre 2026 · 5 min de lecture

On a construit le produit. La distribution, c'était le produit.

En 2025, j'ai lancé mon premier produit : des associés, des contacts dans le secteur, un lancement et des discussions avec des investisseurs. En fin d'année, on l'a mis au placard. Pourquoi c'est la distribution, pas le code, qui a tranché.

Carrière
23 septembre 2026 · 10 min de lecture

À un moment donné, écrire du code cesse d'être la partie difficile

Un regard personnel sur le passage de junior à senior : pourquoi la difficulté quitte le code pour aller vers le périmètre, l'ownership, les trade-offs et le choix de quoi construire.

Architecture
20 septembre 2026 · 9 min de lecture

La requête d'activation ment dès le premier jour : anti-join et backfill en PostgreSQL

Les comptes qui paient sans jamais s'être activés n'apparaissent pas dans une métrique de baisse d'usage — ils n'existent même pas dans la table des événements. Pourquoi le défaut est dans le FROM, pourquoi NOT IN renvoie zéro ligne en silence, et pourquoi le premier résultat de cette requête est presque toujours faux.

Frontend
10 août 2026 · 14 min de lecture

L'erreur que personne ne voyait : quand le frontend casse et que le chiffre d'affaires disparaît du log

Un composant QR Code cassait dans le checkout PIX d'un SaaS de dropshipping pendant que le backend répondait 200 — du chiffre d'affaires qui fuyait sans une seule ligne de log. Comment nous avons instrumenté le frontend avec du contexte de session, ce que nous n'avons délibérément pas capturé dans un flux de paiement, et l'écart encore ouvert.

Frontend
23 juillet 2026 · 12 min de lecture

De 6,7 MB à 19 KB : pagination cursor-based et virtualisation dans une inbox React

Comment j'ai reconstruit l'inbox d'un SaaS B2B qui chargeait ~20 000 conversations d'un coup — pagination cursor-based avec React Query, virtualisation avec TanStack Virtual et les trade-offs de chaque décision. Payload par requête : de ~6,7 MB à ~19 KB (~400x).

Ingénierie
17 avril 2026 · 11 min de lecture

Stratégie de tests pour les intégrations de paiement en Node.js

Comment tester les webhooks, l'idempotence, le PIX et plusieurs gateways (Stripe, Asaas, Mercado Pago) sans facturer pour de vrai — sandbox, mocks, contrats et tests de résilience.

Étude de cas
16 avril 2026 · 14 min de lecture

Étude de cas : Vox Pet Digital — migrer un SaaS vétérinaire d'Express vers NestJS sans downtime

95 modèles Prisma, multi-tenant + multi-filiale, IA sur WhatsApp avec RAG et Whisper, migration progressive v1→v2 et facturation avec fallback.

Étude de cas
16 avril 2026 · 12 min de lecture

Étude de cas : X-Drop — comment j'ai construit un SaaS de dropshipping qui a généré R$ 30k+ en 2 mois

Architecture, décisions techniques et défis réels du passage à l'échelle d'une plateforme SaaS de dropshipping avec des intégrations Mercado Livre, Shopee, Asaas et Mercado Pago.

Architecture
16 avril 2026 · 9 min de lecture

Circuit Breaker en Node.js : protéger les systèmes contre les défaillances en cascade

Comment implémenter le pattern Circuit Breaker dans des applications Node.js pour gérer des API externes instables — state machine, fallbacks, retry et monitoring en production.

Architecture
15 avril 2026 · 10 min de lecture

Architecture de webhooks pour les fournisseurs de paiement en Node.js

Comment structurer la réception de webhooks de paiement en production — validation de signature, idempotence, traitement asynchrone, réconciliation et gestion des défaillances réelles.

Frontend
16 mars 2026 · 7 min de lecture

Construire un design system avec Shadcn UI et Tailwind

Un guide pratique pour structurer un design system évolutif avec Shadcn UI, Tailwind CSS et React — en garantissant la cohérence visuelle et la productivité dans les applications modernes.

Architecture
3 février 2026 · 8 min de lecture

Architecture multi-tenant avec PostgreSQL dans les applications SaaS

Un guide pratique sur la façon de structurer des applications SaaS multi-tenant avec PostgreSQL — isolation des données, modélisation de la base de données et bonnes pratiques d'architecture.

IA
11 octobre 2025 · 9 min de lecture

Construire un système RAG avec LangChain et PostgreSQL

Une étude pratique sur la façon d'implémenter un système de recherche sémantique (RAG) avec Python, LangChain et pgVector — en intégrant l'IA générative aux données d'entreprise.