docs: add missing Japanese translations to complete zh-CN parity (ja-JP)

Add remaining files to match zh-CN documentation structure: - hooks/README.md — hooks architecture and customization guide - examples/ — 8 project CLAUDE.md templates (general, user, django, go, harmonyos, laravel, rust, saas-nextjs) - CHANGELOG.md — version history - the-openclaw-guide.md — OpenClaw guide (471 lines) Total: 11 files, 2362 insertions ja-JP now has full parity with zh-CN directory structure.
2026-05-18 14:53:05 +08:00 · 2026-05-16 22:45:27 +09:00
parent ec9ace9c54
commit 5a5a47e710
11 changed files with 2361 additions and 7 deletions
--- a/docs/ja-JP/examples/laravel-api-CLAUDE.md
+++ b/docs/ja-JP/examples/laravel-api-CLAUDE.md
@@ -0,0 +1,311 @@
+# Laravel API — プロジェクト CLAUDE.md
+
+> PostgreSQL、Redis、キューを使用したLaravel APIの実世界サンプル。
+> これをプロジェクトのルートにコピーしてサービスに合わせてカスタマイズしてください。
+
+## プロジェクト概要
+
+**スタック:** PHP 8.2+, Laravel 11.x, PostgreSQL, Redis, Horizon, PHPUnit/Pest, Docker Compose
+
+**アーキテクチャ:** コントローラー → サービス → アクションのモジュール型Laravelアプリ、Eloquent ORM、非同期処理のためのキュー、バリデーションのためのForm Request、一貫したJSONレスポンスのためのAPI Resource。
+
+## 重要なルール
+
+### PHP の規約
+
+- すべてのPHPファイルに `declare(strict_types=1)` を記述する
+- 型付きプロパティと戻り値の型をあらゆる場所で使用する
+- サービスとアクションには `final` クラスを優先する
+- コミット済みコードに `dd()` や `dump()` を使用しない
+- Laravel Pint（PSR-12）でフォーマットする
+
+### APIレスポンスエンベロープ
+
+すべてのAPIレスポンスは一貫したエンベロープを使用します:
+
+```json
+{
+  "success": true,
+  "data": {"...": "..."},
+  "error": null,
+  "meta": {"page": 1, "per_page": 25, "total": 120}
+}
+```
+
+### データベース
+
+- マイグレーションはgitにコミットする
+- EloquentまたはクエリビルダーをSQLクエリに使用する（パラメータ化されていない生SQLは禁止）
+- `where` または `orderBy` で使用されるカラムにインデックスを付ける
+- サービス内でモデルインスタンスの変更を避ける。リポジトリまたはクエリビルダーを通じた作成/更新を優先する
+
+### 認証
+
+- SanctumによるAPI認証
+- モデルレベルの認可にはポリシーを使用する
+- コントローラーとサービスで認証を強制する
+
+### バリデーション
+
+- バリデーションにはForm Requestを使用する
+- ビジネスロジック用にDTOへ入力を変換する
+- 派生フィールドに対してリクエストペイロードを信頼しない
+
+### エラーハンドリング
+
+- サービスでドメイン例外をスローする
+- `bootstrap/app.php` の `withExceptions` で例外をHTTPレスポンスにマップする
+- 内部エラーをクライアントに公開しない
+
+### コードスタイル
+
+- コードやコメントに絵文字を使用しない
+- 最大行長: 120文字
+- コントローラーは薄く。サービスとアクションがビジネスロジックを保持する
+
+## ファイル構成
+
+```
+app/
+  Actions/
+  Console/
+  Events/
+  Exceptions/
+  Http/
+    Controllers/
+    Middleware/
+    Requests/
+    Resources/
+  Jobs/
+  Models/
+  Policies/
+  Providers/
+  Services/
+  Support/
+config/
+database/
+  factories/
+  migrations/
+  seeders/
+routes/
+  api.php
+  web.php
+```
+
+## 主要なパターン
+
+### サービスレイヤー
+
+```php
+<?php
+
+declare(strict_types=1);
+
+final class CreateOrderAction
+{
+    public function __construct(private OrderRepository $orders) {}
+
+    public function handle(CreateOrderData $data): Order
+    {
+        return $this->orders->create($data);
+    }
+}
+
+final class OrderService
+{
+    public function __construct(private CreateOrderAction $createOrder) {}
+
+    public function placeOrder(CreateOrderData $data): Order
+    {
+        return $this->createOrder->handle($data);
+    }
+}
+```
+
+### コントローラーパターン
+
+```php
+<?php
+
+declare(strict_types=1);
+
+final class OrdersController extends Controller
+{
+    public function __construct(private OrderService $service) {}
+
+    public function store(StoreOrderRequest $request): JsonResponse
+    {
+        $order = $this->service->placeOrder($request->toDto());
+
+        return response()->json([
+            'success' => true,
+            'data' => OrderResource::make($order),
+            'error' => null,
+            'meta' => null,
+        ], 201);
+    }
+}
+```
+
+### ポリシーパターン
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use App\Models\Order;
+use App\Models\User;
+
+final class OrderPolicy
+{
+    public function view(User $user, Order $order): bool
+    {
+        return $order->user_id === $user->id;
+    }
+}
+```
+
+### Form Request + DTO
+
+```php
+<?php
+
+declare(strict_types=1);
+
+final class StoreOrderRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return (bool) $this->user();
+    }
+
+    public function rules(): array
+    {
+        return [
+            'items' => ['required', 'array', 'min:1'],
+            'items.*.sku' => ['required', 'string'],
+            'items.*.quantity' => ['required', 'integer', 'min:1'],
+        ];
+    }
+
+    public function toDto(): CreateOrderData
+    {
+        return new CreateOrderData(
+            userId: (int) $this->user()->id,
+            items: $this->validated('items'),
+        );
+    }
+}
+```
+
+### APIリソース
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+final class OrderResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'status' => $this->status,
+            'total' => $this->total,
+            'created_at' => $this->created_at?->toIso8601String(),
+        ];
+    }
+}
+```
+
+### キュージョブ
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use App\Repositories\OrderRepository;
+use App\Services\OrderMailer;
+
+final class SendOrderConfirmation implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public function __construct(private int $orderId) {}
+
+    public function handle(OrderRepository $orders, OrderMailer $mailer): void
+    {
+        $order = $orders->findOrFail($this->orderId);
+        $mailer->sendOrderConfirmation($order);
+    }
+}
+```
+
+### テストパターン（Pest）
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use function Pest\Laravel\actingAs;
+use function Pest\Laravel\assertDatabaseHas;
+use function Pest\Laravel\postJson;
+
+uses(RefreshDatabase::class);
+
+test('user can place order', function () {
+    $user = User::factory()->create();
+
+    actingAs($user);
+
+    $response = postJson('/api/orders', [
+        'items' => [['sku' => 'sku-1', 'quantity' => 2]],
+    ]);
+
+    $response->assertCreated();
+    assertDatabaseHas('orders', ['user_id' => $user->id]);
+});
+```
+
+### テストパターン（PHPUnit）
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+final class OrdersControllerTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_user_can_place_order(): void
+    {
+        $user = User::factory()->create();
+
+        $response = $this->actingAs($user)->postJson('/api/orders', [
+            'items' => [['sku' => 'sku-1', 'quantity' => 2]],
+        ]);
+
+        $response->assertCreated();
+        $this->assertDatabaseHas('orders', ['user_id' => $user->id]);
+    }
+}
+```