← ブログに戻る
Guide公開日 2026-11-07· 8 分で読了

ホワイトラベルSaaSソース交付:4つの本物のプルーニング規則

WangNan, author at Uncorne
著者 WangNan
発行 Uncorne · 更新 2026-10-05

「ホワイトラベル」はランディングページに書くのは簡単ですが、実際に届けるのは驚くほど難しいものです。ZIPそのものが商品である場合、購入者が解凍する前に四つのことが成り立っていねばなりません。Uncorneは四つすべてをビルド時のアサーションとして扱います。約束ではなく、以下それぞれに自分で証明する手段を添えます。この区別が重要なのは、ほとんどの「ホワイトラベル」の失敗が悪意ではなく、ランディングページには映らない杜撰な納品だからです。

ホワイトラベルSaaSソース交付のプルーニングフロー
ホワイトラベルSaaSソース交付のプルーニングフロー

1. プルーニングは本物であって、環境変数スイッチではない

未選択のモジュールはアーカイブから消えていなければならず、環境変数で無効化されているだけでは足りません。管理コンソールの選択を外した顧客は、そのルートもナビ項目もimportも受け取るべきではありません。Uncorneではスキップリストは宣言的で、Builderが認証、決済、AIプロバイダー、機能、デプロイ先、ビジュアルスタイルを選び、サーバーはそれらのモジュールだけを含むZIPを返します。生成された全パッケージは型チェックされ、24の代表設定(各Builderシナリオプリセットを含む)がCIでダウンロード・ガード検査・コンパイルされます。生成アプリはNext.js App Router上で動くため、モジュールを消すとはルートセグメントが実際になくなることであり、コンポーネントを隠すことではありません。generate APIに結びついたServer Actionsも一緒に消えます。認証モジュールには行レベルセキュリティポリシーも付いてくるので、それも削除が必要です。

痛い目で学んだ規則があります。書き換え処理はZIP内に既にあるファイルだけを変更してよい、というものです。初期版では削除済みファイルをディスクから読みにいくフォールバックがあり、顧客パッケージへこっそり戻していました。このバグは全単体テストを通り、誰かが届いたZIPをgrepしたときだけ露見しました。存在するけれどオフになっているモジュールも、やはりモジュールです。バンドルに残り、importに現れ、保守も必要です。

grep -R "admin" -il . | head -20
find . -path './node_modules' -prune -o -name '*.tsx' -print | sort

最初のコマンドは、顧客が選んでいないモジュールに関して何も返さないはずです。二つ目は実際のファイル一覧を出し、プレビューのマニフェストと照合できます。

選択モジュールと出荷ファイルツリーの比較
選択モジュールと出荷ファイルツリーの比較

2. ブランド除去は生成ページまで及ぶ

顧客ビルドのホーム、料金、sitemap、robots、法的ページは、当社のマーケティングサイトを継承するのではなく、その顧客自身の設定から生成されます。これらはGoogleの構造化データガイドに従い、アサーションは他の生成ページとまったく同じに検査します。かつては生成テンプレート内のコメントに旧ブランド名が残っただけでCIマトリクス全体が落ちていました。現在はアサーションが顧客ページの当社ブランド、競合名、デッドリンク、ジェネレーターファイルを走査し、ZIPを出す前にビルドを失敗させます。

grep -R -i "uncorne|旧ブランド名|legacy-brand" -n app lib public 2>/dev/null | head -20
grep -R -o 'href="/[^"]*"' app | sed 's/href="//;s/"//' | sort -u

最初のコマンドは空でなければなりません。二つ目は全内部リンクを列挙します。生成アプリのルートと照合してください。存在しないルートへのリンクはデッドリンクであり、一つでもホワイトラベル主張を壊すのに十分です。

3. 工場を一緒に出荷しない

ZIPには商品が入っており、それを作る機械ではありません。ジェネレーターディレクトリ、builderルート、generate APIは削除されます。購入は一つの生成プロジェクトを与えるもので、工場を動かすライセンスではありません。これはサポートとセキュリティの両面で重要です。ジェネレーターも受け取った顧客はビルドを自作でき、あなたが工場にプッシュした修正が、彼らのデプロイ版と綺麗に一致しなくなります。

test -d generator && echo "LEAK: generator present" || echo "OK: no generator"
test -f app/builder/page.tsx && echo "LEAK: builder present" || echo "OK: no builder"
grep -R "generateSourceZip" -n . 2>/dev/null | head

三つのチェックすべてがクリーンと報告すべきです。これは顧客がすぐに気づく失敗モードです。ジェネレーターコードにはベンダー独自の慣習があちこちに残っているからです。

4. ペイウォールが顧客について帰ってはいけない

当サイトはソースZIPを出す前にHMACライセンスキー、有効なサブスクリプション、またはメール確認を要求し、署名シークレットが未設定でも本番では閉じたまま失敗します。顧客自身のプロジェクトでは、このゲートはソース内で既定がオフの状態で届きます。.env.exampleに書くだけではありません。誰も写さないからです。匿名の訪問者はスケルトンプレビューを取得できます。プロジェクト骨格、ファイル一覧、デザイントークンで、署名付き訪問トークンと二つのバケットによるクォータで制限されています。

grep -R "licenseGateMode" -n lib | head
sed -n '1,80p' lib/env.ts

lib/env.ts自体でゲートがオフ既定になっているのを確認してください。名前の良い変数を読むだけで安全な既定値がない場合、購入者は触るなと言われたコードを編集しないと消せないペイウォールを継承することになります。

ライセンスゲート:サイトはオン、顧客プロジェクトはオフ
ライセンスゲート:サイトはオン、顧客プロジェクトはオフ

購入者が「ホワイトラベル」ZIPで実際に見つけるもの

納品後に繰り返し出る不平は三つあります。一つ目はデッドリンクです。ナビ項目がプルーニングで消えたルートを指し、顧客が自社ユーザーを404へ送り込みます。二つ目はブランド残りです。コメント、READMEの一行、あるいは og:image のパスにベンダー名が残り、公開した瞬間に顧客の問題になります。三つ目は工場がそもそも消えていないこと。購入者は製品全体を再生成できてしまい、リポジトリを手にした他人も同じです。

これらは店頭のスクリーンショットには映りません。解凍してチェックを走らせたときだけ露見します。だからこそ私たちはZIPを納品物として扱い、マーケティングページをその説明として扱います。逆ではありません。上記四つの規則はこれらの不平に直接対応します。本物のプルーニングはルートを消す(だからデッドリンクも消える)、ブランド assertion は生成ページを覆い、工場を消せば購入の境界が曖昧になりません。ライセンスゲートが四番目なのは、ソースに残されたペイウォールがそのままサポートチケットになるからです。購入者は出荷できず、彼らが見たこともない設定のせいであなたが非難されます。

もう一つ、静かな利点があります。宣言的なスキップリストは再現可能なビルドを与えてくれます。同じ設定ならCIマトリクスは同じファイルツリーを生むので、「adminルートが消えた」というバグ報告は設定だけで再現できます。手作業の削除では、再現可能な顧客ビルドなど存在しません。ZIPはすべて雪の結晶のようになり、サポートは考古学になります。

エンドツーエンドで自分に確認する

ビルドを解凍し、上記四つのチェックを走らせ、さらに解凍先で型チェックと本番ビルドを実行します。

生成されたホワイトラベルZIPのエンドツーエンド検証
生成されたホワイトラベルZIPのエンドツーエンド検証
npm install && npx tsc --noEmit && npm run build

これらのコマンドの出力はビルドと一緒に保管してください。同じ設定から同じクリーンな結果を再現できるレビュアーは、営業の会話での約束より価値があります。

どれか一つでも失敗すれば、ホワイトラベルはマーケティングでした。これはAI機能ではなく配送基準であることに注意してください。どんなチェックリストも、ブランドが漏れる固定リポジトリを綺麗にはできません。支払っていないモジュールを隠すのではなく消してほしいなら、設定から生成してください。その差こそがソース交付の意味全体です。

FAQ

生成ZIPにジェネレーター自体は入っていますか?+

いいえ。ジェネレーターモジュール、builderページ、generate APIは削除されます。一つのビルドを買うと一つのプロジェクトが手に入り、ビルドを生産する工場ではありません。test -d generatorで確認でき、ジェネレーターがないと報告されるはずです。

ダウンロードしたプロジェクトでゲートは有効ですか?+

いいえ。Uncorneのダウンロードではlib/env.tsが書き換えられ、licenseGateMode()がソース内で既定オフになります。ペイウォールを強制するのは当サイトだけで、本番では失敗時に閉じます。展開先でsed -n '1,80p' lib/env.tsを実行して確認してください。

匿名プレビューには何が入っていますか?+

ソースなしの実行可能なスケルトンプレビューです。設定、テーマ付きプレースホルダーページ、完全なファイル一覧、デザイントークン、説明用のPREVIEW.mdが含まれますが、アプリケーションソースはありません。署名付きvisitトークンと信頼ネットワークのバケットで制限されています。

ホワイトラベル主張をどう自分で証明しますか?+

ビルドを解凍し、ベンダーのブランドとジェネレーターパスをgrepし、npx tsc --noEmitとnpm run buildを実行します。本物のホワイトラベルZIPは三つすべてを通過しますが、マーケ宣言は最初のブランドgrepで落ちることが多いです。

よくある質問をすべて見る · Markdown 版(AI エージェント向け)