👋 ようこそ

在溪維基へようこそ —— yunzaixi-dev が個人で維持管理しているオンラインドキュメントサイトです。

ドキュメント分類について

本サイトは「単一帰属 + 優先度判定」を採用し、重複と交差を避けています：

• 単一帰属：各ドキュメントは1つのメインカテゴリにのみ配置します。副次的なトピックは本文内のリンクで参照し、複数のディレクトリにコピーしないでください。
• 判定順序（高から低へ）：
  1. プライバシー/秘密鍵/未公開情報を含む → プライベート専区
  2. コース/学術/試験関連 → 大学専区
  3. サイト/リポジトリのメタ情報、歴史的経緯、保守規範 → 履歴専区
  4. 「主要な配置場所」で分類：ブラウザ/クライアント → フロントエンド；サーバー/ビジネス/API → バックエンド；CI/CD/配信プロセス → DevOps；計算/ストレージ/ネットワーク/データベース/クラウド/監視プラットフォーム → インフラストラクチャ
  5. 具体的な技術実装と弱い関連性を持つ効率/プロセス/習慣 → ワークフロー専区
  6. その他の公開可能な汎用コンテンツ → パブリック専区
• 境界ルール：実行場所は使用言語より優先；デプロイ/プラットフォーム構築はインフラストラクチャ、配信パイプラインはDevOpsに属します；プライバシーと学業判定は技術ドメインより優先します。
• 配置要件：ファイルは対応するディレクトリに配置する必要があり、必要に応じて frontmatter / サイドバーを同期更新してください。

履歴専区

• 範囲: 本サイトの歴史、技術実装、開発ログ、サイト管理者関連情報などを記録します。
• 除外: 具体的な技術コンテンツまたは学習ノート（技術ドメインで分類）、プライベートまたは未公開資料（プライベート専区へ）、学術コースコンテンツ（大学専区へ）。

フロントエンド専区

• 範囲: UI/インタラクション、ブラウザまたはクロスプラットフォームフレームワーク（Svelte/SvelteKit）、フロントエンドエンジニアリング（Vite/Webpack フロントエンド設定）、CSS/デザインシステム、Web API とコンポーネントライブラリ。
• 除外: サーバーサイドレンダリングのバックエンドロジック、API設計、データベースアクセス、デプロイ/リリースプロセス（バックエンド/インフラストラクチャ/DevOpsへ）。

バックエンド専区

• 範囲: ビジネスサービスと API 設計、BFF/GraphQL/REST、サーバーサイド言語とフレームワーク、ドメインモデリング、データアクセス層の実装、認証/セッションなどのサーバーサイド機能。
• 除外: データベース/メッセージキューのデプロイと運用（インフラストラクチャへ）、CI/CD とリリース戦略（DevOpsへ）。

DevOps専区

• 範囲: CI/CD パイプライン、ビルド/リリース/カナリアデプロイ戦略、環境差異管理、品質ゲート、SRE ツールチェーン、チーム規範。
• 除外: インフラストラクチャレベルのクラスタ/ネットワーク/ストレージ構築（インフラストラクチャへ）、ビジネス機能コーディング（フロントエンド/バックエンドへ）。

インフラストラクチャ専区

• 範囲: 計算/ストレージ/ネットワーク/オペレーティングシステム、コンテナとオーケストレーション（Kubernetes）、データベースとキャッシュ、メッセージキュー、監視/ログ/アラートプラットフォーム、クラウドサービス設定。
• 除外: 配信プロセスのみに関連するパイプラインスクリプト（DevOpsへ）、ビジネスレイヤーのデータアクセスコード（バックエンドへ）。

ワークフロー専区

• 範囲: 個人/チーム効率ツールとプロセス、自動化スクリプト、時間管理、ノート/ナレッジ管理方法、具体的な技術実装から切り離された作業習慣。
• 除外: 技術実装を主とするコンテンツ（対応する技術分類へ）、学術コース（大学専区へ）。

大学専区

• 範囲: コースノート、実験レポート、学術読書、試験復習、キャンパス内プロジェクト。
• 除外: エンタープライズプロジェクトまたは本番環境関連コンテンツ（技術ドメインで分類）、プライベート情報を含む資料（プライベート専区へ）。

パブリック専区

• 範囲: 機密情報がなく、分野横断的な汎用知識、公開講演/読書抜粋、具体的な技術コンテキストなしでも理解できるコンテンツ。

• 除外: 未公開情報を含むまたはアクセス制御が必要な資料（プライベート専区へ）、技術実装の詳細（技術ドメインで分類）。

• 範囲: 個人プライバシー、秘密鍵、アカウント、内部資料、または未公開の計画を含むコンテンツ。

• 注意: トピックが他の分類にも該当する場合でも、最終的な帰属はプライベート専区となります。

ドキュメントツールチェーン

LaTeX について

LaTeX は TeX に基づくドキュメント組版ソフトウェアシステムです。LaTeX は高度で説明的なマークアップ言語を提供し、TeX の使用をより便利にします：TeX はドキュメントレイアウトを担当し、LaTeX はドキュメントコンテンツの処理を担当します。TeX のフォーマットコマンドは非常に基本的であるため、著者向けに章タイトル、脚注、相互参照、参考文献などのフォーマットとレイアウト要件を満たすための既成コマンドを提供します。

ドキュメントサイトの数式表現に LaTeX を使用しています

Markdown について

Markdown は軽量マークアップ言語で、プレーンテキストエディタを使用してフォーマットされたテキストを作成するために使用されます。John Gruber は 2004 年に Markdown を作成し、読みやすく、書きやすいマークアップ言語を実現することを目的としていました。

Markdown は広く使用されており、ブログ、インスタントメッセージング、大規模言語モデルで使用されており、オンラインフォーラム、コラボレーションソフトウェア、ドキュメントページ、README ファイルでも一般的です。

ドキュメントサイトのコンテンツ構築に Markdown を使用しています

バージョン管理と CI/CD

Git について

Git は高速でスケーラブルな分散バージョン管理システムで、非常に豊富なコマンドセットを備えており、高レベルの操作と内部メカニズムへの完全なアクセスの両方を提供します。

ドキュメントサイトのバージョン管理に Git を使用しています

GitHub について

GitHub は専有の開発者プラットフォームで、開発者がコードを作成、保存、管理、共有できるようにします。Git を使用して分散バージョン管理を実装し、GitHub 自体は各プロジェクトにアクセス制御、不具合追跡、ソフトウェア機能リクエスト、タスク管理、継続的インテグレーション、Wiki などの機能を提供します。

GitHub は 2018 年以降 Microsoft の子会社であり、本社はサンフランシスコにあります。

ドキュメントサイトのコードは GitHub プライベートリポジトリでホストされています

GitHub Actions について

GitHub Actions は GitHub が提供するワークフロー自動化プラットフォームで、コードリポジトリ内でソフトウェア開発プロセスのタスクを自動化、カスタマイズ、実行するために使用されます（一般的な用途には継続的インテグレーションと継続的デプロイが含まれます）。開発者が**「actions」（再利用可能な自動化コンポーネント）を作成、発見、再利用**し、複数の actions を設定可能なワークフローに組み合わせて、ビルド、テスト、公開、デプロイなどの作業を完了できるようにします。

GitHub Actions はイベント駆動メカニズムを採用しています：ワークフローは通常 YAML ファイルで定義され、特定のイベント発生時にトリガーされます（例：コードプッシュ、プルリクエスト、定時タスク、手動トリガーなど）。ワークフローは 1 つ以上のジョブで構成され、ジョブは「ランナー」と呼ばれる実行環境で実行されます；ランナーは GitHub がホストする環境でも、ユーザーが自ら管理する環境でもかまいません。

GitHub は 2018 年の GitHub Universe イベント期間中に GitHub Actions を公開し、リポジトリ内の自動化とワークフローオーケストレーション機能として位置付けました。

ドキュメントサイトは GitHub Actions でビルド、デプロイ、自動翻訳を実行しています

フロントエンドツールチェーン

V8 について

V8 は Google が開発したオープンソースの JavaScript と WebAssembly エンジンで、最初は 2008 年に Google Chrome とともにリリースされました。ジャストインタイムコンパイル（JIT）などの最適化技術を通じて JavaScript をマシンコードにコンパイルし、実行性能を向上させます；現在、Chrome、Node.js、および他の Chromium ベースのプロジェクトで広く使用されています。

ドキュメントサイトの実行環境は V8 です

Node.js について

Node.js は V8 ベースのクロスプラットフォーム JavaScript ランタイム環境で、イベント駆動と非ブロッキング I/O モデルを採用し、ネットワークサービスとコマンドラインツールの構築に一般的に使用されます。このプロジェクトは最初 Ryan Dahl によって 2009 年にリリースされ、npm を中心に大規模なサードパーティパッケージエコシステムが形成されました。

ドキュメントサイトのビルドと開発環境は Node.js です

TypeScript について

TypeScript は Microsoft が主導開発するオープンソースプログラミング言語で、JavaScript の型付きスーパーセットであり、JavaScript にコンパイルされます。静的型、インターフェース、ジェネリクスなどの機能を導入し、大規模 JavaScript プロジェクトの保守性とツールサポート（型チェックと自動補完など）を向上させます。

ドキュメントサイトの開発言語は TypeScript です

React について

React は Facebook（現 Meta）が維持するオープンソースフロントエンド UI ライブラリで、最初は 2013 年にリリースされました。コンポーネント化と宣言的レンダリングをコアとし、通常は単方向データフロー、Hooks などのメカニズムと組み合わせて、再利用可能なユーザーインターフェースを構築します。

ドキュメントサイトの UI フレームワークは React です

Yarn について

Yarn は JavaScript のパッケージマネージャで、Facebook などのチームによって 2016 年にリリースされ、依存関係インストールの速度と再現性を改善するために使用されます。lockfile（yarn.lock など）を通じて依存関係解決結果をロックし、キャッシュと並列ダウンロードなどのメカニズムを提供します。

ドキュメントサイトのパッケージマネージャは Yarn です

Vite について

Vite は現代的なフロントエンド開発向けのビルドツールと開発サーバーで、Evan You によって 2020 年にリリースされました。開発モードはネイティブ ESM のオンデマンド読み込みに基づき、本番ビルド段階では通常 Rollup を使用してバンドルし、より高速な起動とホットアップデート体験を実現します。

ドキュメントサイトのビルドツールは Vite です

Rspack について

Rspack はパフォーマンスを目標とするフロントエンドバンドルツールで、Rust で実装されたコアを採用し、Webpack エコシステム（設定、loader と plugin インターフェースなど）との互換性を強調しています。2023 年にオープンソース化され、大規模プロジェクトのビルド高速化とインクリメンタルコンパイルシナリオで一般的に使用されます。

ドキュメントサイトのビルドツールは Rspack です

Docusaurus について

Docusaurus は Facebook（現 Meta）がオープンソース化した静的サイトジェネレータで、主にドキュメントサイトの構築に使用され、最初は 2017 年にリリースされました。Markdown/MDX をメインコンテンツ形式とし、サイドバーナビゲーション、バージョン管理、多言語対応、テーマ、デプロイなどの機能を提供し、ドキュメントをエンジニアリング成果物として維持・公開するのに適しています。

ドキュメントサイトの開発フレームワークは Docusaurus です

開発原則

自動化は手作業に勝る。
宣言的は命令的に勝る。
不変性は可変性に勝る。
弾性は固定容量に勝る。
可観測性は極めて重要である。
失敗は例外ではなく常態である。
迅速な復旧は失敗の回避に勝る。
分散は単一依存に勝る。
標準はカスタマイズに勝る。
プラットフォーム機能は個人技術に勝る。
インフラストラクチャはコードのように管理されるべきである。
環境は一貫性があるべきで、たまたま動作するべきではない。
サービスは独立すべきで、相互に絡み合うべきではない。
スケーリングは水平であるべきで、垂直ではない。
リリースは頻繁で、ロールバック可能であるべきである。
セキュリティは組み込まれるべきで、事後対応ではない。