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.
This commit is contained in:
Claude
2026-05-16 22:45:27 +09:00
committed by Affaan Mustafa
parent ec9ace9c54
commit 5a5a47e710
11 changed files with 2361 additions and 7 deletions

View File

@@ -0,0 +1,88 @@
# HarmonyOS アプリプロジェクト CLAUDE.md
これはHarmonyOSアプリケーション向けのプロジェクトレベルの CLAUDE.md サンプルです。プロジェクトのルートに配置してください。
## プロジェクト概要
[アプリの簡単な説明 - 機能、対象デバイス、APIレベル]
## 基本ルール
### 1. 技術スタックの制約
- プラットフォーム: HarmonyOSArkTS/TypeScript、最新の安定した公式APIを優先
- 状態管理: **V2のみ** (`@ComponentV2`, `@Local`, `@Param`, `@Event`, `@Provider`, `@Consumer`, `@Monitor`, `@Computed`)
- ルーティング: **Navigationのみ** (`Navigation` + `NavPathStack` + `NavDestination`)
- アーキテクチャ: モジュール型レイヤーを持つMVVM - ビューはレンダリングのみ、すべてのビジネスロジックはViewModelに
- コンポーネント優先順位: モジュール内再利用可能コンポーネント > クロスモジュール共有コンポーネント > サードパーティライブラリ
### 2. コード構成
- 大きなファイルを少数持つより、小さなファイルを多数持つ
- 高凝集、低結合
- ファイルあたり200〜400行を目標、最大800行
- 型ではなく機能/ドメインで整理する
### 3. コードスタイル
- コード、コメント、またはドキュメントに絵文字を使用しない
- イミュータビリティ - オブジェクトを直接変更しない
- 文字列にはダブルクォートを使用し、セミコロンが必要
- `var` は絶対に使用しない - `const` を優先し、次に `let`
- `any` 型は使用しない - すべてのメソッド、パラメーター、戻り値に完全な型アノテーションを付ける
- 命名: 変数/関数には `camelCase`、クラス/インターフェースには `PascalCase`、定数には `UPPER_SNAKE_CASE`
- ファイルヘッダー: `@file` + `@author`。すべてのメソッドに `@param``@returns` を含むJSDocが必要
### 4. レイアウトとインタラクション
- 均等分配には `layoutWeight(1)` を使用 - `SpaceAround`/`SpaceBetween` は避ける
- パーセンテージ/レイアウトウェイト/アダプティブユニットを使用 - ハードコードされた固定寸法は使用しない(アイコンを除く)
- UI定数はリソースとして定義し、`$r()` で参照する
- 新しい色リソースにはライトとダークの両テーマをサポートする
### 5. ビルドと検証
```bash
# HAPパッケージをビルド
hvigorw assembleHap -p product=default
```
- 実装のたびにビルドを実行してコンパイルを確認する
- 不明なAPI使用については公式のHuawei開発者ドキュメントを参照する - 推測しない
### 6. テスト
- TDD: テストを先に書く
- ユーティリティ関数とViewModelのユニットテスト
- 重要なユーザーフローのUIテスト
- ビジネスロジックのカバレッジ最低80%
### 7. セキュリティ
- シークレットをハードコードしない
- システムAPIを使用する前に `module.json5` でパーミッションを確認する
- すべてのユーザー入力を検証する
- すべてのネットワークリクエストにHTTPSを使用する
## ファイル構成
```
src/
|-- entry/ # アプリエントリー、フレームワーク初期化
|-- core/ # コアフレームワークレイヤー
|-- shared/ # 共有コントラクトレイヤー
|-- packages/ # ビジネス機能パッケージ
```
## 利用可能なコマンド
- `/plan` - 実装計画の作成
- `/code-review` - コード品質のレビュー
- `/build-fix` - ビルドエラーの修正
## Git ワークフロー
- コンベンショナルコミット: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`
- mainブランチへの直接コミットは禁止
- PRにはレビューが必要
- マージ前にすべてのテストが合格していること