テンプレート一覧に戻る

Rust + Axum

Rust + Axum + tokio + sqlx のプロジェクト向けCLAUDE.md。型安全で高パフォーマンスなAPI開発に最適です。

上級rustaxumtokiosqlx
CLAUDE.md
# プロジェクト名

Rust + Axum で構築された高パフォーマンスAPIサーバー。

## 技術スタック

- **フレームワーク**: Axum 0.8+
- **言語**: Rust (2024 edition)
- **非同期ランタイム**: tokio
- **ORM**: sqlx (compile-time checked queries)
- **シリアライゼーション**: serde + serde_json
- **DB**: PostgreSQL 16

## コマンド

| コマンド | 用途 |
|---------|------|
| `cargo run` | 開発サーバー起動 |
| `cargo test` | テスト実行 |
| `cargo build --release` | リリースビルド |
| `cargo clippy` | Lint実行 |
| `cargo fmt` | フォーマット |
| `sqlx migrate run` | マイグレーション適用 |

## ディレクトリ構造

| パス | 役割 |
|-----|------|
| `src/main.rs` | エントリーポイント・ルーター |
| `src/handlers/` | リクエストハンドラー |
| `src/models/` | データモデル・DB構造体 |
| `src/services/` | ビジネスロジック |
| `migrations/` | SQLマイグレーション |

## コーディング規約

- `Result<T, E>` で明示的なエラー処理(`unwrap()` 禁止)
- `thiserror` でカスタムエラー型定義
- Extractorパターンでリクエスト解析
- `Arc<AppState>` で共有状態管理
- clippy warningゼロを維持
- unsafe禁止(明確な理由がない限り)

## Git規約

- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式

関連ガイド

検索

ガイドやテンプレートを検索...