👋 ようこそ

在溪ウィキ へようこそ —— yunzaixi-dev が個人でメンテナンスしているオンラインドキュメントサイトです。

关于文档分区

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

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

ヒストリーエリア

• 範囲: 本サイトの履歴、技術実装、開発ログ、サイトオーナーに関する情報などを記録します。
• 除外: 具体的な技術内容や学習ノート（技術領域ごとに分類）、機密または未公開資料（プライベートへ）、学術講義内容（大学へ）。

フロントエンドエリア

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

バックエンドエリア

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

運用（DevOps）エリア

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

インフラストラクチャエリア

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

ワークフローエリア

• 範囲: 個人/チームの効率化ツールとプロセス、自動化スクリプト、時間管理、ノート/知識管理方法、具体的な技術実装からデカップリングされた仕事の習慣。
• 除外: 技術実装が主となるコンテンツ（対応する技術分類へ）、学術講義（大学へ）。

大学エリア

• 範囲: 講義ノート、実験レポート、学術リーディング、試験対策、学内プロジェクト。
• 除外: 企業プロジェクトや本番環境に関連する内容（技術領域ごとに分類）、プライバシーを含む資料（プライベートへ）。

パブリックエリア

• 範囲: 機密情報を含まず、領域を横断する汎用的な知識、公開プレゼンテーション/読書抜粋、具体的な技術コンテキストがなくても理解できる内容。

• 除外: 未公開情報を含む資料やアクセス制御が必要な資料（プライベートへ）、技術実装の詳細（技術領域ごとに分類）。

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

• 注意: トピックが同時に他の分類にも該当する場合でも、最終的にはプライベートエリアに帰属します。

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

LaTeX について

LaTeX は、TeX をベースとした文書作成用の組版システムです。LaTeX は、TeX の使用をより便利にするための、高度で記述的なマークアップ言語を提供します。TeX がドキュメントのレイアウトを担当し、LaTeX がドキュメントの内容の処理を担当します。TeX のフォーマットコマンドは非常に基礎的であるため、LaTeX は著者に対して、章のタイトル、脚注、相互参照、参考文献などのフォーマットやレイアウトの要件を満たすための既成のコマンドを提供します。

本ドキュメントサイトでは、数学的な数式を表現するために Latex を使用しています。

Markdown について

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

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

本ドキュメントサイトの内容は Markdown で構築されています。

バージョン管理と CICD

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 モデルを採用しています。ネットワークサービスやコマンドラインツールの構築によく使用されます。このプロジェクトは 2009 年に Ryan Dahl によって最初にリリースされ、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 は、モダンなフロントエンド開発向けのビルドツールおよび開発サーバーであり、2020 年に Evan You によってリリースされました。その開発モードはネイティブ ESM によるオンデマンド読み込みに基づいており、本番ビルド段階では通常 Rollup を使用してパッケージングを行うことで、より高速な起動とホットリロード体験を実現します。

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

Rspack について

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

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

Docusaurus について

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

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

開発原則

手作業よりも自動化。
命令型よりも宣言型。
可変よりも不変。
固定容量よりも弾力性。
オブザーバビリティ（可観測性）は極めて重要。
失敗は例外ではなく、常態である。
失敗の回避よりも迅速な復旧。
単一障害点への依存よりも分散化。
カスタマイズよりも標準。
個人のスキルよりもプラットフォームの能力。
インフラストラクチャはコードのように管理されるべきである。
環境は「たまたま動く」のではなく、一貫しているべきである。
サービスは相互に絡み合うのではなく、独立しているべきである。
拡張は垂直方向ではなく、水平方向であるべきである。
リリースは頻繁に行い、ロールバック可能であるべきである。
セキュリティは後付けではなく、組み込まれているべきである。