npm - @laitszkin/apollo-toolkit - Versions diffs - 3.10.0 → 3.11.1 - Mend

@laitszkin/apollo-toolkit 3.10.0 → 3.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (47) hide show

package/init-project-html/sample-demo/resources/project-architecture/features/invite-code-registration/postgresql.html CHANGED Viewed

@@ -1,161 +1,86 @@
 <!DOCTYPE html>
-<html lang="zh-Hant">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>子模組 · postgresql — 邀請碼註冊（reg 視角）</title>
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,500;600&family=Plus+Jakarta+Sans:wght@400;500;600&display=swap"
-      rel="stylesheet"
-    />
-    <link rel="stylesheet" href="../../assets/architecture.css" />
-  </head>
-  <body>
-    <main class="atlas-page atlas-page--feature">
-      <nav class="breadcrumb" aria-label="階層導航">
-        <a href="../../index.html">宏觀架構</a> · <a href="./index.html">邀請碼註冊</a> · <span>postgresql</span>
-      </nav>
-      <header class="atlas-header">
-        <p class="atlas-kicker">Submodule · postgresql（reg 視角）</p>
-        <h1 class="atlas-title">postgresql — 註冊側操作</h1>
-        <p class="atlas-meta">
-          自身職責：以 SQL 對 <code>invite_codes</code>／<code>users</code> 表執行讀鎖、寫入與條件更新。本子模組同時是<strong>讀者</strong>（查邀請碼）與<strong>寫者</strong>（建 user、核銷邀請）。本頁只列自身 SQL 函式的 I/O。
-        </p>
-      </header>
-      <section class="sub-io">
-        <h2>SQL 函式 I/O</h2>
-        <table>
-          <thead><tr><th>函式</th><th>簽名／SQL</th><th>副作用</th><th>用途</th></tr></thead>
-          <tbody>
-            <tr>
-              <td><code>GetInviteForUpdate</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>tx</code>, <code>code: text</code><br>
-                <strong>out:</strong> <code>InviteRow</code> | <code>NotFound</code><br>
-                SQL: <code>SELECT … FROM invite_codes WHERE code=$1 FOR UPDATE</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--io">lock</span> 對該列加 row lock 直到 tx 結束</td>
-              <td>取得邀請碼狀態並阻止他人並行核銷。</td>
-            </tr>
-            <tr>
-              <td><code>InsertUser</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>tx</code>, <code>{email, passwordHash, inviteID}</code><br>
-                <strong>out:</strong> <code>UserID</code> | <code>UniqueViolation</code><br>
-                SQL: <code>INSERT INTO users (...) RETURNING id</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--write">write</span> 新列（待 commit）</td>
-              <td>建立使用者列；<code>users.email UNIQUE</code>。</td>
-            </tr>
-            <tr>
-              <td><code>MarkInviteConsumed</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>tx</code>, <code>inviteID</code>, <code>userID</code>, <code>now</code><br>
-                <strong>out:</strong> <code>RowsAffected</code><br>
-                SQL: <code>UPDATE invite_codes SET consumed_at=$3, consumed_by=$2 WHERE id=$1 AND consumed_at IS NULL</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--write">write</span> 條件更新</td>
-              <td>標記核銷；<code>RowsAffected=0</code> 表示已被搶先核銷。</td>
-            </tr>
-          </tbody>
-        </table>
-      </section>
-      <section class="sub-vars">
-        <h2>變數與業務用途</h2>
-        <p class="sub-vars__intro">本表分兩段：上半為 SQL 函式參數，下半為 <code>invite_codes</code> / <code>users</code> 表上的關鍵列欄位（被本子模組讀寫）。</p>
-        <table>
-          <thead><tr><th>變數</th><th>型別</th><th>作用域</th><th>業務用途</th></tr></thead>
-          <tbody>
-            <tr>
-              <td class="sub-vars__name">tx</td>
-              <td class="sub-vars__type">*sql.Tx</td>
-              <td><span class="sub-vars__scope sub-vars__scope--tx">tx</span></td>
-              <td>上層管理的隔離單元；本子模組所有 SQL 都掛在這個 <code>tx</code> 上，未 commit 即視為「無事發生」，保證註冊原子性。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">code</td>
-              <td class="sub-vars__type">text</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td><code>GetInviteForUpdate</code> 的查鎖鍵；對應到列上欄位 <code>invite_codes.code</code> 的 UNIQUE 索引，避免並行核銷相同邀請。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">inviteID</td>
-              <td class="sub-vars__type">UUID</td>
-              <td><span class="sub-vars__scope sub-vars__scope--tx">tx</span></td>
-              <td>從 SELECT 取得後跨多個寫入；把「核銷哪一張邀請」與「新 user 屬於哪張邀請」綁定，作為日後審計鏈。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">userID</td>
-              <td class="sub-vars__type">UUID</td>
-              <td><span class="sub-vars__scope sub-vars__scope--tx">tx</span></td>
-              <td><code>InsertUser RETURNING id</code> 的結果；同一 <code>tx</code> 內回填到 <code>consumed_by</code>，完成「誰用了邀請」的紀錄。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">now</td>
-              <td class="sub-vars__type">timestamp</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td>核銷時的官方時間；由應用層提供以避免應用與 DB 時鐘漂移影響審計順序。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">RowsAffected</td>
-              <td class="sub-vars__type">int</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td><code>MarkInviteConsumed</code> 條件更新結果；<code>0</code> 表示已被搶先核銷，本次必須回滾，否則會發生雙倍消費。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">consumed_at</td>
-              <td class="sub-vars__type">timestamp NULL</td>
-              <td><span class="sub-vars__scope sub-vars__scope--persist">persist</span></td>
-              <td><code>invite_codes</code> 列上欄位；非空代表「這張邀請已被消費」，與 <code>WHERE consumed_at IS NULL</code> 一起防雙重核銷。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">consumed_by</td>
-              <td class="sub-vars__type">FK → users.id</td>
-              <td><span class="sub-vars__scope sub-vars__scope--persist">persist</span></td>
-              <td><code>invite_codes</code> 列上欄位；紀錄是哪個 user 用掉這張邀請，是「邀請碼註冊」這條業務路徑留下的最終痕跡。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">users.email</td>
-              <td class="sub-vars__type">text UNIQUE</td>
-              <td><span class="sub-vars__scope sub-vars__scope--persist">persist</span></td>
-              <td>使用者唯一鍵；UNIQUE 違例代表「相同信箱已註冊」，業務上以 409 回應，呼叫端不應靜默忽略。</td>
-            </tr>
-          </tbody>
-        </table>
-      </section>
-      <section class="sub-dataflow">
-        <h2>內部資料流（單一交易視角）</h2>
-        <ol>
-          <li>呼叫端開 <code>tx</code> → 本子模組以該 <code>tx</code> 執行 SQL；交易控制不在本子模組內。</li>
-          <li><code>GetInviteForUpdate</code> 取得 <code>InviteRow</code> 並把 <strong>列鎖</strong> 綁在 <code>tx</code> 上。</li>
-          <li><code>InsertUser</code> 取得 <code>UserID</code>，作為下一步 <code>consumed_by</code> 的 FK 值。</li>
-          <li><code>MarkInviteConsumed</code> 以 <code>WHERE consumed_at IS NULL</code> 防雙重核銷。</li>
-          <li>所有寫入皆在 <code>tx</code> 內；commit／rollback 由呼叫端決定，本子模組對外只報告每個 SQL 的結果。</li>
-        </ol>
-      </section>
-      <section class="sub-errors">
-        <h2>本子模組會回傳的錯誤</h2>
-        <table>
-          <thead><tr><th>錯誤</th><th>觸發 SQL</th><th>含義</th></tr></thead>
-          <tbody>
-            <tr><td><code>NotFound</code></td><td><code>GetInviteForUpdate</code></td><td>無該邀請碼列。</td></tr>
-            <tr><td><code>UniqueViolation</code></td><td><code>InsertUser</code></td><td>email 重複。</td></tr>
-            <tr><td><code>LockWaitTimeout</code></td><td><code>GetInviteForUpdate</code></td><td>其他並發交易長時間持有鎖。</td></tr>
-            <tr><td><code>ConnTransient</code></td><td>任意</td><td>網路／restart；交易不會 partial。</td></tr>
-          </tbody>
-        </table>
-      </section>
-      <footer class="atlas-meta" style="margin-top: 2rem">
-        <p><a href="../../index.html">← 宏觀架構</a> · <a href="./index.html">← 功能總覽</a></p>
-      </footer>
-    </main>
-  </body>
+<html lang="en" data-atlas-page="submodule">
+<head>
+  <meta charset="utf-8">
+  <title>Invite-code registration · postgresql</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="submodule-header">
+    <nav class="submodule-breadcrumb"><a href="../../index.html">← Atlas</a> · <a href="index.html">← Invite-code registration</a></nav>
+    <h1>postgresql <small class="submodule-kind submodule-kind--db">DB</small></h1>
+    <p class="submodule-role">Stores `users` rows and applies invite-code state transitions inside the registration tx.</p>
+  </header>
+  <main class="submodule-main">
+    <section class="sub-io" aria-label="Function I/O">
+      <h2>Function I/O</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>SELECT_invite_for_update</td><td>code</td><td>InviteCodeRow | nil</td><td>lock</td><td>Locks the invite row for the duration of the transaction.</td></tr>
+          <tr><td>INSERT_users</td><td>userRow</td><td>userId</td><td>write</td><td>Persists the new account.</td></tr>
+          <tr><td>UPDATE_invite_consumed</td><td>code, now</td><td>rows_affected</td><td>write</td><td>Marks the invite as consumed.</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="sub-vars" aria-label="Variables">
+      <h2>Variables</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">Type</th><th scope="col">Scope</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>users.email</td><td>text</td><td>persist</td><td>Unique account identity.</td></tr>
+          <tr><td>invite_codes.consumed_at</td><td>timestamptz</td><td>persist</td><td>Timestamp set the moment the invite row is consumed.</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="sub-dataflow" aria-label="Internal data flow">
+      <h2>Internal data flow</h2>
+      <div class="sub-dataflow__canvas" data-pan-zoom-container>
+        <div class="sub-dataflow__toolbar" role="toolbar" aria-label="Diagram controls">
+          <button type="button" data-pan-zoom="zoom-in" aria-label="Zoom in">+</button>
+          <button type="button" data-pan-zoom="zoom-out" aria-label="Zoom out">−</button>
+          <button type="button" data-pan-zoom="fit" aria-label="Reset view">Fit</button>
+        </div>
+        <div class="sub-dataflow__viewport" data-pan-zoom-viewport>
+          <svg class="sub-dataflow__svg" data-atlas-svg="sub-dataflow" viewBox="0 0 628 368" role="img" aria-label="Internal dataflow">
+  <defs>
+    <marker id="sub-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="9" markerHeight="9" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" /></marker>
+  </defs>
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="68" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="73" text-anchor="middle">1</text>
+    <rect class="sub-dataflow__box" x="80" y="32" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="74" text-anchor="middle">Apply row lock on invite_codes.</text>
+  </g>
+  <line class="sub-dataflow__arrow" x1="340" y1="110" x2="340" y2="140" marker-end="url(#sub-arrow)" />
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="184" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="189" text-anchor="middle">2</text>
+    <rect class="sub-dataflow__box" x="80" y="148" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="190" text-anchor="middle">Validate uniqueness of users.email.</text>
+  </g>
+  <line class="sub-dataflow__arrow" x1="340" y1="226" x2="340" y2="256" marker-end="url(#sub-arrow)" />
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="300" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="305" text-anchor="middle">3</text>
+    <rect class="sub-dataflow__box" x="80" y="264" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="306" text-anchor="middle">Write users row and update invite_codes.consumed_at.</text>
+  </g>
+</svg>
+        </div>
+      </div>
+    </section>
+    <section class="sub-errors" aria-label="Errors">
+      <h2>Errors</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">When</th><th scope="col">Means</th></tr></thead>
+        <tbody>
+          <tr><td>ErrUniqueEmail</td><td>users.email unique constraint violated.</td><td>Bubble up so service can return ErrEmailTaken.</td></tr>
+        </tbody>
+      </table>
+    </section>
+  </main>
+  <script src="../../assets/viewer.client.js" defer></script>
+</body>
 </html>

package/init-project-html/sample-demo/resources/project-architecture/features/invite-code-registration/public-api.html CHANGED Viewed

@@ -1,145 +1,83 @@
 <!DOCTYPE html>
-<html lang="zh-Hant">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>子模組 · public-api — 邀請碼註冊</title>
-    <link rel="preconnect" href="https://fonts.googleapis.com" />
-    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-    <link
-      href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,500;600&family=Plus+Jakarta+Sans:wght@400;500;600&display=swap"
-      rel="stylesheet"
-    />
-    <link rel="stylesheet" href="../../assets/architecture.css" />
-  </head>
-  <body>
-    <main class="atlas-page atlas-page--feature">
-      <nav class="breadcrumb" aria-label="階層導航">
-        <a href="../../index.html">宏觀架構</a> · <a href="./index.html">邀請碼註冊</a> · <span>public-api</span>
-      </nav>
-      <header class="atlas-header">
-        <p class="atlas-kicker">Submodule · public-api</p>
-        <h1 class="atlas-title">public-api（reg）</h1>
-        <p class="atlas-meta">自身職責：HTTP 邊界。處理綁定、輸入 schema 檢查、把網域結果映射為狀態碼／錯誤 payload。</p>
-      </header>
-      <section class="sub-io">
-        <h2>函式 I/O</h2>
-        <table>
-          <thead><tr><th>函式</th><th>簽名</th><th>副作用</th><th>用途</th></tr></thead>
-          <tbody>
-            <tr>
-              <td><code>RegisterHandler</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>http.Request</code><br>
-                <strong>out:</strong> <code>http.Response</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--io">io</span> 讀／寫 socket</td>
-              <td>路由綁定的對外入口。</td>
-            </tr>
-            <tr>
-              <td><code>decodeRegisterInput</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>io.Reader</code><br>
-                <strong>out:</strong> <code>RegisterInput</code> | <code>ErrBadRequest</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--io">io</span> 讀 body</td>
-              <td>JSON 解碼 + 基本 schema 校驗。</td>
-            </tr>
-            <tr>
-              <td><code>mapDomainError</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>error</code><br>
-                <strong>out:</strong> <code>(httpStatus, ErrorBody)</code>
-              </td>
-              <td><span class="sub-io__side sub-io__side--pure">pure</span></td>
-              <td>網域 error → HTTP 對映表。</td>
-            </tr>
-            <tr>
-              <td><code>writeSuccess</code></td>
-              <td class="sub-io__signature">
-                <strong>in:</strong> <code>NewUserID</code>, <code>http.ResponseWriter</code><br>
-                <strong>out:</strong> —
-              </td>
-              <td><span class="sub-io__side sub-io__side--write">io</span> 寫 201 body</td>
-              <td>序列化 user id + 必要 header。</td>
-            </tr>
-          </tbody>
-        </table>
-      </section>
-      <section class="sub-vars">
-        <h2>變數與業務用途</h2>
-        <p class="sub-vars__intro">HTTP 邊界子模組持有的識別子，幾乎全在單次 handler 呼叫中存活。</p>
-        <table>
-          <thead><tr><th>變數</th><th>型別</th><th>作用域</th><th>業務用途</th></tr></thead>
-          <tbody>
-            <tr>
-              <td class="sub-vars__name">http.Request</td>
-              <td class="sub-vars__type">request</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td>邊界輸入；只在 handler 期間有效，handler 結束後資源歸還，不可在背景任務繼續使用。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">RegisterInput</td>
-              <td class="sub-vars__type">{Email, Password, InviteCode}</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td>HTTP body 解碼後的網域層承載；schema 校驗通過代表「結構面可進入業務」，避免錯誤輸入觸發無謂的 DB 開銷。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">httpStatus</td>
-              <td class="sub-vars__type">int</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td><code>mapDomainError</code> 的輸出之一；業務面決定協議語意（409 與 503 不可混用，前者要使用者改、後者要使用者稍後再試）。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">ErrorBody</td>
-              <td class="sub-vars__type">{code, message}</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td>結構化錯誤體；<code>code</code> 給 UI 對映本地化文字，<code>message</code> 僅供開發者排錯。</td>
-            </tr>
-            <tr>
-              <td class="sub-vars__name">http.ResponseWriter</td>
-              <td class="sub-vars__type">writer</td>
-              <td><span class="sub-vars__scope sub-vars__scope--call">call</span></td>
-              <td>對外副作用通道；本子模組保證一次回應只寫一次，避免重複寫入造成協議違例與使用者看到的不一致結果。</td>
-            </tr>
-          </tbody>
-        </table>
-      </section>
-      <section class="sub-dataflow">
-        <h2>內部資料流</h2>
-        <ol>
-          <li><code>http.Request.Body</code> → <code>decodeRegisterInput</code> → <code>RegisterInput</code>（失敗 → <code>ErrBadRequest</code>）。</li>
-          <li><code>RegisterInput</code> 作為傳入網域層的參數；本子模組<strong>不</strong>持有交易、密碼明文也只在這一函式內存在。</li>
-          <li>從網域層拿到 <code>NewUserID | error</code>：
-            <ul>
-              <li><code>NewUserID</code> → <code>writeSuccess</code>。</li>
-              <li><code>error</code> → <code>mapDomainError</code> → 對應 HTTP 狀態 + JSON。</li>
-            </ul>
-          </li>
-          <li>處理結束 / response 完成寫入後生命週期終止。</li>
-        </ol>
-      </section>
-      <section class="sub-errors">
-        <h2>本子模組會回應／轉化的錯誤</h2>
-        <table>
-          <thead><tr><th>條件</th><th>HTTP</th></tr></thead>
-          <tbody>
-            <tr><td>schema 失敗</td><td><code>400 BAD_REQUEST</code></td></tr>
-            <tr><td>網域回 <code>ErrInviteInvalid</code></td><td><code>409 INVITE_INVALID</code></td></tr>
-            <tr><td>網域回 <code>ErrTransient</code></td><td><code>503 SERVICE_UNAVAILABLE</code></td></tr>
-            <tr><td>panic 或未分類</td><td><code>500 INTERNAL</code></td></tr>
-          </tbody>
-        </table>
-      </section>
-      <footer class="atlas-meta" style="margin-top: 2rem">
-        <p><a href="../../index.html">← 宏觀架構</a> · <a href="./index.html">← 功能總覽</a></p>
-      </footer>
-    </main>
-  </body>
+<html lang="en" data-atlas-page="submodule">
+<head>
+  <meta charset="utf-8">
+  <title>Invite-code registration · public-api</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="stylesheet" href="../../assets/architecture.css">
+</head>
+<body>
+  <header class="submodule-header">
+    <nav class="submodule-breadcrumb"><a href="../../index.html">← Atlas</a> · <a href="index.html">← Invite-code registration</a></nav>
+    <h1>public-api <small class="submodule-kind submodule-kind--api">API</small></h1>
+    <p class="submodule-role">HTTP boundary for `/api/register` POST requests.</p>
+  </header>
+  <main class="submodule-main">
+    <section class="sub-io" aria-label="Function I/O">
+      <h2>Function I/O</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">In</th><th scope="col">Out</th><th scope="col">Side</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>postRegister</td><td>HttpRequest</td><td>HttpResponse</td><td>network</td><td>Parses payload and delegates to registration-service.</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="sub-vars" aria-label="Variables">
+      <h2>Variables</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">Type</th><th scope="col">Scope</th><th scope="col">Purpose</th></tr></thead>
+        <tbody>
+          <tr><td>payload</td><td>RegisterDTO</td><td>call</td><td>Inbound registration intent.</td></tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="sub-dataflow" aria-label="Internal data flow">
+      <h2>Internal data flow</h2>
+      <div class="sub-dataflow__canvas" data-pan-zoom-container>
+        <div class="sub-dataflow__toolbar" role="toolbar" aria-label="Diagram controls">
+          <button type="button" data-pan-zoom="zoom-in" aria-label="Zoom in">+</button>
+          <button type="button" data-pan-zoom="zoom-out" aria-label="Zoom out">−</button>
+          <button type="button" data-pan-zoom="fit" aria-label="Reset view">Fit</button>
+        </div>
+        <div class="sub-dataflow__viewport" data-pan-zoom-viewport>
+          <svg class="sub-dataflow__svg" data-atlas-svg="sub-dataflow" viewBox="0 0 628 368" role="img" aria-label="Internal dataflow">
+  <defs>
+    <marker id="sub-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="9" markerHeight="9" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 Z" /></marker>
+  </defs>
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="68" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="73" text-anchor="middle">1</text>
+    <rect class="sub-dataflow__box" x="80" y="32" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="74" text-anchor="middle">Decode JSON body.</text>
+  </g>
+  <line class="sub-dataflow__arrow" x1="340" y1="110" x2="340" y2="140" marker-end="url(#sub-arrow)" />
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="184" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="189" text-anchor="middle">2</text>
+    <rect class="sub-dataflow__box" x="80" y="148" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="190" text-anchor="middle">Call registration-service.RegisterWithInvite.</text>
+  </g>
+  <line class="sub-dataflow__arrow" x1="340" y1="226" x2="340" y2="256" marker-end="url(#sub-arrow)" />
+  <g class="sub-dataflow__step">
+    <circle class="sub-dataflow__badge" cx="42" cy="300" r="18" />
+    <text class="sub-dataflow__badge-text" x="42" y="305" text-anchor="middle">3</text>
+    <rect class="sub-dataflow__box" x="80" y="264" width="520" height="72" rx="14" ry="14" />
+    <text class="sub-dataflow__text" x="340" y="306" text-anchor="middle">Serialize success or 422 / 5xx error.</text>
+  </g>
+</svg>
+        </div>
+      </div>
+    </section>
+    <section class="sub-errors" aria-label="Errors">
+      <h2>Errors</h2>
+      <table class="sub-table">
+        <thead><tr><th scope="col">Name</th><th scope="col">When</th><th scope="col">Means</th></tr></thead>
+        <tbody>
+          <tr><td>ErrMalformedPayload</td><td>JSON parse fails.</td><td>400 response with `payload` reason.</td></tr>
+        </tbody>
+      </table>
+    </section>
+  </main>
+  <script src="../../assets/viewer.client.js" defer></script>
+</body>
 </html>