Farrukh Inomov

inomov.online

Farrukh Inomov のドイツ語（デフォルト、/）と英語（/en）の採用向けポートフォリオです。 Astro を使って静的 HTML として構築し、Vercel にデプロイしています。

開発

Node 24（.nvmrc を参照）と pnpm が必要です。

pnpm install
pnpm dev        # http://localhost:4321
pnpm verify     # lint, format check, tests, type check and build

シークレットがなくてもページをビルドできます。Contact ページの API ルートには、.env.example に記載されているサーバー変数が必要です。本番環境では、これらの変数は Vercel のみに設定されています。

エンドツーエンドテスト

Playwright は、本番ビルド（先に pnpm build を実行）に対して Chromium、Firefox、WebKit でテストを実行します。サイトマップにあるすべてのページ、両方のテーマでの WCAG 2.2 AA に対する axe チェック、ターミナル、メニュー、テーマ切り替え、言語切り替え、スクロール時のアニメーションを検証します。

pnpm exec playwright install   # once, downloads the browsers
pnpm test:e2e                  # all browsers
pnpm test:visual               # screenshots, in Docker (see below)
pnpm test:visual --update-snapshots   # after an intended visual change

スクリーンショットの表示はオペレーティングシステムごとに異なるため、ビジュアルテストは公式 Playwright イメージを使った Linux 上でのみ実行されます。CI で実行するほか、Docker が必要な pnpm test:visual を使ってローカルでも実行できます。コミットする前に、e2e/__screenshots__/ 内の変更された画像を確認してください。

パフォーマンス予算

Lighthouse CI は、シミュレーションしたモバイル環境でホームページ、プロジェクトページ、About ページを監査し、それぞれ 3 回実行します（中央値）。カテゴリのスコアが 95 未満、Largest Contentful Paint が 2 s を超える、またはページの圧縮済み JavaScript の読み込み量が 60 KB を超えると、プルリクエストは失敗します。予算は lighthouserc.cjs に設定されています。

pnpm build && pnpm test:lighthouse   # reports in .lighthouseci/

ファイルの配置場所

パス	内容
src/data/	唯一の信頼できる情報源です。プロフィール、職務経歴、スキル、プロジェクトを格納します。ビルド時に Zod で検証します。
src/i18n/	ロケール、翻訳済みルート、UI の文字列を格納します。
src/views/	ページごとのコンポーネントです。両方のロケールで共用します。src/pages/ は URL をビューに割り当てるだけです。
src/components/	表示領域（site、home、about、projects、ui）ごとにコンポーネントをまとめています。
src/styles/	デザイントークンとグローバルスタイルを格納します。
e2e/	Playwright によるエンドツーエンド、アクセシビリティ、ビジュアルの各テストを格納します。
GLOSSARY.md	ドメイン用語を定義します。コードとコピーでは、ここに記載された用語を使用してください。
docs/adr/	アーキテクチャ上の決定事項を格納します。

デプロイ

Vercel はプッシュのたびにビルドします。プルリクエストにはプレビュー環境がデプロイされ、master は https://inomov.online にデプロイされます。