<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/">
  <channel>
    <title>Team Collaboration · 仁才徳</title>
    <link>https://jared.lynskey.co.nz/ja/tags/team-collaboration/</link>
    <description>ソフトウェアエンジニアリングと開発組織のリーダーシップについて。評価、採用とチームの拡大、CI/CD、DevOps モニタリング、エージェンティック AI。ソウルより。</description>
    <generator>Hugo</generator>
    <language>ja</language>
    <copyright>© 2026 仁才徳</copyright>
    <lastBuildDate>Wed, 28 Oct 2026 00:00:00 +1300</lastBuildDate>
    <atom:link href="https://jared.lynskey.co.nz/ja/tags/team-collaboration/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>APIファースト開発をOpenAPIで：フロントエンドとバックエンドを並行して進める</title>
      <link>https://jared.lynskey.co.nz/ja/posts/2023/2023-10-08-open-api/</link>
      <guid isPermaLink="true">https://jared.lynskey.co.nz/ja/posts/2023/2023-10-08-open-api/</guid>
      <pubDate>Sun, 08 Oct 2023 00:30:03 +0000</pubDate>
      <dc:creator>Jared Lynskey</dc:creator>
      <category>OpenAPI</category>
      <category>Backend</category>
      <category>Frontend</category>
      <category>API Design</category>
      <category>Software Development</category>
      <category>Team Collaboration</category>
      <description>APIファースト開発の実践編です。先にOpenAPIでコントラクトに合意し、モックサーバーを立てれば、フロントエンドはバックエンドを待たずに済みます。</description>
      <content:encoded><![CDATA[<p>これまで見てきた中で一番確実にスケジュールを殺すのは、難しいエンジニアリングではありません。「もうすぐできる」エンドポイントを、フロントエンドがひたすら待っている状態です。職場で落ち着いた解決策は地味ですが効きます。コードを書く前に、まずOpenAPIでAPIコントラクトに合意することです。</p>

<h3 class="relative group">待ちのゲーム
    <div id="待ちのゲーム" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e5%be%85%e3%81%a1%e3%81%ae%e3%82%b2%e3%83%bc%e3%83%a0" aria-label="アンカー">#</a>
    </span>
    
</h3>
<p>従来のフローは直列です。バックエンドがAPIを設計・実装し、エンドポイントが実際に動くようになってから、フロントエンドが統合を始める。バックエンドの遅れはすべてフロントエンドのカレンダーに直撃しますし、リリース日が載っているのはたいていフロントエンドのカレンダーです。</p>

<h3 class="relative group">コードより先にコントラクト
    <div id="コードより先にコントラクト" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e3%82%b3%e3%83%bc%e3%83%89%e3%82%88%e3%82%8a%e5%85%88%e3%81%ab%e3%82%b3%e3%83%b3%e3%83%88%e3%83%a9%e3%82%af%e3%83%88" aria-label="アンカー">#</a>
    </span>
    
</h3>
<p>スキーマファーストのフローでは、両者がほぼ同時に走り出せます。コードが1行も存在しない段階で、APIの構造をOpenAPIスキーマに書き出します。すべてのエンドポイント、リクエストとレスポンスのモデル、認証方式、エラーコード。このドキュメントが、フロントエンドとバックエンドの間の契約書になります。</p>
<p>見返りはすぐに現れます。作る前に、全員が同じ形で機能を理解できる。バックエンドが実装中でも、フロントエンドはUIを作り始められる。合意済みの唯一の情報源を更新すればいいので、変更も速く回る。さらにスキーマから直接モックサーバーを生成できるので、本物のエンドポイントがひとつもない段階からフロントエンドのテストが始められます。</p>

<h3 class="relative group">実際の回し方
    <div id="実際の回し方" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e5%ae%9f%e9%9a%9b%e3%81%ae%e5%9b%9e%e3%81%97%e6%96%b9" aria-label="アンカー">#</a>
    </span>
    
</h3>
<ol>
<li>要件を集める。これは何を作るときでも同じです。</li>
<li>スキーマを設計する。エンドポイント、リクエスト／レスポンスモデル、認証、エラーコード。</li>
<li>フロントとバックの両方でレビューする。コントラクトが本領を発揮するのはここです。</li>
<li>モックサーバーを生成し（SwaggerでもPostmanでも可能です）、フロントエンドはそれに対して統合を進める。</li>
<li>バックエンドは同じスキーマに沿って本物のエンドポイントを実装する。</li>
<li>出来上がったものからモックを本物に差し替え、契約が守られているか継続的にテストする。</li>
<li>会話を続ける。スキーマは生きたドキュメントであって、石版ではありません。</li>
</ol>

<h3 class="relative group">引っかかりどころ
    <div id="引っかかりどころ" class="anchor"></div>
    
    <span
        class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100 select-none">
        <a class="text-primary-300 dark:text-neutral-700 !no-underline" href="#%e5%bc%95%e3%81%a3%e3%81%8b%e3%81%8b%e3%82%8a%e3%81%a9%e3%81%93%e3%82%8d" aria-label="アンカー">#</a>
    </span>
    
</h3>
<p>タダではありません。しっかりしたスキーマを前もって書くには、それなりの時間がかかります。要件が変われば先にスキーマを直す必要があり、その波紋は両チームに及びます。そして全員が、OpenAPIと周辺ツールについて最低限の土地勘を持っている必要があります。</p>
<p>それでも、この先行投資が、防いでくれる統合の混乱に負けたところを見たことがありません。フロントエンドは初日から動き出せますし、議論はビルドが壊れてからではなく、ドキュメントの上で起きるようになります。</p>
]]></content:encoded>
      <media:content url="https://jared.lynskey.co.nz/en/posts/2023/2023-10-08-open-api/featured.jpg" medium="image" type="image/jpeg" />
    </item>
  </channel>
</rss>
