fandhe-backend

AI によるセキュリティ脆弱性発見リスクに備え、Rust で新規構築する軽量・高速・高並行なバックエンドフレームワークです。axum 級の性能を目標に、プラグインによる拡張（WebRTC / WebSocket）、多様な通信規格（GraphQL / tRPC）、OpenAPI 自動生成・容易なロギングを備えます。

正式名称は fandhe-backend に確定しています（決定経緯・可用性証跡・新旧マッピングは docs/design/framework-naming.md 参照）。

インストール

crates.io（v0.1.0、2026-07-21 公開済み。v0.2.0 は準備中で CHANGELOG.md 参照）から最小コアのみを使う場合は:

cargo add fandhe-backend-core

プラグインは Cargo feature で着脱します（pay-for-what-you-use。無効な feature の依存・コードはバイナリに一切含まれません）:

# 例: WebSocket プラグインを有効化
cargo add fandhe-backend-core --features websocket

# 例: 複数 feature の同時有効化
cargo add fandhe-backend-core --features graphql,openapi,cors

公開対象クレートは fandhe-backend-http / fandhe-backend-routes / fandhe-backend-core と fandhe-backend-plugin-*（websocket / graphql / openapi / webrtc / webrtc-proxy / tracing / hub-wiring / cors / compression / static）の 13 クレートで、すべて同一バージョン（lockstep）で公開します。現時点の crates.io 公開版は 0.1.0、リポジトリの実装は 0.2.0（未公開、公開手順は CHANGELOG.md・docs/design/crates-io-release.md 参照）です。通常は fandhe-backend-core の feature 経由で利用し、個別クレートを直接依存に追加する必要はありません（fandhe-backend-plugin-hub-wiring のみ独立クレートとして直接利用します）。

Getting Started

crates.io からの依存追加〜最小サーバ起動までの最短手順は docs/guide/getting-started.md を、 feature 構成別のサンプル（websocket / graphql / webrtc 系 / tracing / openapi / cors / compression / static / hub-wiring）は docs/guide/feature-samples.md を、拡張点の実装まで含むチュートリアルは docs/guide/tutorial.md を参照してください。利用者向けドキュメントサイトは https://fandhe-ai.github.io/fandhe-backend/ にあります。

仕様

仕様書（ブレスト〜PoC〜要件定義〜タスク分解〜ロードマップ）は Fandhe-AI/fandhe-backend-spec で管理し、docs/spec/ にサブモジュールとして取り込んでいます。

git clone --recurse-submodules git@github.com:Fandhe-AI/fandhe-backend.git
# 既存クローンの場合
git submodule update --init

ドキュメント	内容
`docs/spec/04-requirements.md`	MoSCoW 優先度付き要件（REQ-1〜15）・受け入れ基準
`docs/spec/05-tasks.md`	タスク分解（全 56 タスク・依存関係・工数）
`docs/spec/06-roadmap.md`	マイルストーン MS-1〜MS-6・着手判定

開発の進め方

docs/spec/06-roadmap.md のマイルストーンに従って実装します。

MS-1: 基盤構築（cargo workspace・CI・依存監査ベースライン）・最小コア（HTTP/1.1・3 種拡張点）・プラグイン機構
MS-2〜MS-4: Must 要件（性能ベンチマーク・セキュリティ・OpenAPI 自動生成ほか）
MS-5〜MS-6: Should 要件（GraphQL / tRPC・WebRTC / WebSocket プラグイン・micro-service-hub 共通配線）

実装着手の最初のタスクは TASK-1.1（cargo workspace・CI 基盤整備）です。

コントリビュート

開発フロー・コミット規約・設計原則は CONTRIBUTING.md を参照してください。

ライセンス

本プロジェクトは MIT ライセンスと Apache License 2.0 のデュアルライセンスで提供されます。あなたが本プロジェクトへ提出する Contribution は、明示的な別段の定めがない限り、上記デュアルライセンスの下で提供されるものとみなされます（詳細は CONTRIBUTING.md を参照）。

crates.io への公開手順（名前確保・所有権・リリース CI）は docs/design/crates-io-release.md で定めています。