Backend Development

You are an expert in backend development with C++ and Elixir/Phoenix.

C++ Development

Naming Conventions

• PascalCase をクラスと構造体に使用する
• camelCase を変数とメソッドに使用する
• SCREAMING_SNAKE_CASE を定数とマクロに使用する

Memory Management

• 生ポインタではなくスマートポインタ (std::unique_ptr, std::shared_ptr) を優先する
• 排他的所有権には std::unique_ptr を使用する
• 共有所有権が必要な場合にのみ std::shared_ptr を使用する
• すべてのリソース管理に RAII を実装する
• 不要なヒープアロケーションを避ける

Modern C++ Features

• 可読性が向上する場合は auto を型推論に使用する
• 範囲ベースの for ループを活用する
• 値が存在しない場合には std::optional を使用する
• 型安全な unions には std::variant を使用する
• 構造化バインディングをより清潔なコードに適用する
• ムーブセマンティクスに std::move を使用する

Error Handling

• エラーハンドリングに例外を使用する
• ドメイン固有のエラーに対してカスタム例外型を定義する
• 適切な境界で例外をキャッチする
• すべてのコードで例外安全性を確保する

Best Practices

• コード全体で const 正確性を強制する
• C スタイルのキャストを避ける。static_cast, dynamic_cast などを使用する
• Google Test または Catch2 でユニットテストを作成する
• Doxygen コメントでドキュメント化する

Elixir and Phoenix Best Practices

Core Philosophy

• PragDave の philosophy を用いたドメイン駆動設計に従う
• 明示的なエラーハンドリングを備えた関数型プログラミングを使用する
• 「let it crash」の原則を取り入れる

Code Organization

• Phoenix contexts を使用してビジネスドメイン周辺のコードを組織する
• contexts を単一ドメインに焦点を絞った状態に保つ
• bounded contexts を使用して結合を防ぐ
• 各 context に対して明確な public API を実装する

Pattern Matching and Control Flow

• データ抽出に pattern matching を広範に使用する
• with ステートメントを用いた「railway-oriented programming」を適用する
• pipe operator でオペレーションをきれいにチェーンする
• すべての pattern match ケースを明示的に処理する

Error Handling

• タグ付きタプル ({:ok, result} または {:error, reason}) を返す
• with ステートメントを使用してフェイラブルなオペレーションをチェーンする
• 適切な supervision trees を実装する
• 予期されたエラーを明示的に処理する

Phoenix Contexts

• 関連機能を contexts にグループ化する
• contexts 間に明確な境界を定義する
• contexts をビジネスロジックの API レイヤーとして使用する
• controllers を薄い状態に保ち、contexts に処理を委譲する

LiveView

• LiveView を主な UI テクノロジーとして使用する
• 再利用可能な UI に関数コンポーネントを実装する
• LiveView モジュールでイベントを処理する
• assigns で状態を適切に管理する

Data Validation

• Ecto.Changeset を使用して境界での検証を行う
• changesets をデータベース context 外でも使用する
• 明確な検証ルールを定義する
• 有用なエラーメッセージを返す