Vinicius Aguiar

Vinicius Aguiar

02執筆

執筆

アーキテクチャ
2026年9月25日 · 6分で読めます

ページは514行。枠組みは2,560行。

ルート分割のマイクロフロントエンドの実験:ツールページを、同じドメインのまま別のNext.jsアプリから配信するようにした。高くついたのが枠組みだった理由、そのために必要になったモノレポ、そして本番でしか現れなかったこと。

フロントエンド
2026年9月24日 · 6分で読めます

このNext.jsの記事の中にAngularアプリが入っている

実験:独自のリポジトリとデプロイを持つAngular 22アプリを、このNext.jsの記事の中でマイクロフロントエンドとして動かす。コントラクト、計測したコスト、そして割に合わないとき。

プロダクト
2026年9月24日 · 5分で読めます

私たちはプロダクトを作った。ディストリビューションこそがプロダクトだった。

2025年、初めてのプロダクトを公開した。パートナー、業界の人脈、リリース、投資家との対話。それでも年末には棚上げになった。決め手がコードではなくディストリビューションだった理由。

キャリア
2026年9月23日 · 10分で読めます

ある時点で、コードを書くことは難しい部分ではなくなる

ジュニアからシニアへの変化を個人的に振り返る。難しさがコードを書くことから、担う範囲、オーナーシップ、トレードオフ、そして何を作るかの判断へと移っていく理由。

アーキテクチャ
2026年9月20日 · 9分で読めます

アクティベーションのクエリは初日から嘘をつく — PostgreSQLのアンチジョインとバックフィル

支払っているのに一度も有効化されていないアカウントは、利用低下の指標には現れません — そもそもイベントテーブルに存在しないからです。欠陥がFROMにある理由、NOT INが黙ってゼロ件を返す理由、そしてこのクエリの最初の結果がほぼ必ず誤りである理由。

フロントエンド
2026年8月10日 · 14分で読めます

誰にも見えなかったエラー:フロントエンドが壊れ、売上がログから消えるとき

ドロップシッピング SaaS の PIX チェックアウトで QR コードのコンポーネントが壊れる一方、バックエンドは 200 を返していた — ログ 1 行も残さずに売上が漏れていたのです。セッションコンテキストを伴うフロントエンド計装、決済フローで意図的に捕捉しなかったもの、そして今も残るギャップ。

フロントエンド
2026年7月23日 · 12分で読めます

6.7 MB から 19 KB へ:React インボックスのカーソルベースページネーションと仮想化

約 20,000 件の会話を一度に読み込んでいた B2B SaaS のインボックスを再構築した方法 — React Query によるカーソルベースのページネーション、TanStack Virtual によるリスト仮想化、そして各判断のトレードオフ。リクエストあたりのペイロード:約 6.7 MB から約 19 KB へ(約 1/400)。

エンジニアリング
2026年4月17日 · 11分で読めます

Node.js における決済連携のテスト戦略

実際に課金せずに webhook、冪等性、PIX、複数ゲートウェイ(Stripe、Asaas、Mercado Pago)をテストする方法 — サンドボックス、モック、契約テスト、レジリエンステスト。

ケーススタディ
2026年4月16日 · 14分で読めます

ケーススタディ: Vox Pet Digital — 動物病院向け SaaS を Express から NestJS へダウンタイムなしで移行

Prisma モデル 95 個、マルチテナント + マルチ支店、RAG と Whisper を備えた WhatsApp の AI、v1→v2 の段階的移行、フォールバック付きの電子インボイス発行。

ケーススタディ
2026年4月16日 · 12分で読めます

ケーススタディ: X-Drop — 2 か月で R$ 30k+ を売り上げたドロップシッピング SaaS を構築した方法

Mercado Livre、Shopee、Asaas、Mercado Pago との連携を備えたドロップシッピング SaaS プラットフォームをスケールさせる際のアーキテクチャ、技術的判断、そして実際の課題。

アーキテクチャ
2026年4月16日 · 9分で読めます

Node.js における Circuit Breaker:システムを連鎖障害から守る

不安定な外部 API に対処するために Node.js アプリケーションで Circuit Breaker パターンを実装する方法 — state machine、フォールバック、リトライ、本番での監視。

アーキテクチャ
2026年4月15日 · 10分で読めます

Node.js における決済プロバイダー向け Webhook アーキテクチャ

本番環境での決済 Webhook の受信をどのように構成するか — 署名検証、冪等性、非同期処理、リコンシリエーション、そして実際の障害への対処。

フロントエンド
2026年3月16日 · 7分で読めます

Shadcn UI と Tailwind でデザインシステムを構築する

Shadcn UI、Tailwind CSS、React を活用してスケーラブルなデザインシステムを構築する方法に関する実践ガイド — モダンなアプリケーションで視覚的な一貫性と生産性を確保します。

アーキテクチャ
2026年2月3日 · 8分で読めます

SaaS アプリケーションにおける PostgreSQL を用いたマルチテナントアーキテクチャ

PostgreSQL を活用してマルチテナント SaaS アプリケーションを構築する方法に関する実践ガイド — データの分離、データベースモデリング、アーキテクチャのベストプラクティスを取り上げます。

AI
2025年10月11日 · 9分で読めます

LangChain と PostgreSQL で RAG システムを構築する

Python、LangChain、pgVector を使ってセマンティック検索(RAG)システムを実装する方法に関する実践的な研究 — 生成 AI を企業データと統合します。