デプロイ

ビルド

サイトはビルド時に Next.js によって静的 HTML として生成されます:

pnpm build

Next.js はホームページ、ドキュメントページ、サイトマップ、静的アセットを 7言語すべてビルド時にプリレンダリングします。ただし提供には、ロケール ネゴシエーションのエッジミドルウェア（apps/web/src/proxy.ts）とセキュリティ ヘッダーを実行するランタイムが必要です。そのためターゲットは Next.js プリセット の Vercel であり、純粋な静的ホストではロケールネゴシエーションが失われます。

ホスティング

本番ホスティングは Vercel:

• framework preset: Next.js
• root directory: apps/web
• build command: pnpm build

ドメインは ella.yuricunha.com で、apps/web/src/data/site.ts とアプリの メタデータで設定され、正準 URL、Open Graph、サイトマップを駆動します。

ドキュメントルート

• /docs 利用可能なドキュメントページのインデックス（言語ごと）;
• /docs/<slug> 個別のドキュメントページ（言語ごと）。

どちらもビルド時に生成される静的ルートです。デフォルト言語（英語）には URL プレフィックスがありません。他の言語はプレフィックスを付けます。 例: /pt/docs や /ja/docs。

ローカライゼーションルート

• デフォルト英語: https://ella.yuricunha.com
• 他の言語: https://ella.yuricunha.com/<locale>

各ページは7言語すべての hreflang オルタネートを宣言し、サイトマップは 各バリアントをリストします。

アナリティクス

Umami は準備されていますが、デフォルトでは無効です。Analytics コンポーネントは、ビルド時に両方の環境変数が存在する場合のみ レンダリングされます:

NEXT_PUBLIC_UMAMI_SRC=https://your-umami-host/script.js
NEXT_PUBLIC_UMAMI_WEBSITE_ID=your-website-id

なければ、サイトはアナリティクス JavaScript をゼロ配信します。プレース ホルダー ID はコミットされません。

品質ゲート

CI サーバーはプッシュを監視していません。GitLab パイプラインは廃止され、 GitLab リモートはミラー専用です。プッシュ前にゲートを実行します:

pnpm type-check && pnpm lint && pnpm test && pnpm format:check && pnpm build

pnpm audit --prod もクリーンである必要があります。Vercel がデプロイ時に 本番バンドルをビルドし、ページはプリレンダリング済みのため、グリーンな ビルドがゲートです。

SEO

• ロケールレイアウトでの metadata、Open Graph、Twitter カード、 canonical、JSON-LD;
• robots.txt とサイトマップはビルドに生成されます;
• ソーシャルカードは public/og.png（1200x630、レンダリングされた HTML テンプレートから Geist フォントで生成）;
• 各言語に独自のメタデータと hreflang オルタネートが与えられます。