テンプレート一覧に戻る
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形式