mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-19 15:23:03 +08:00
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:
88
docs/ja-JP/examples/harmonyos-app-CLAUDE.md
Normal file
88
docs/ja-JP/examples/harmonyos-app-CLAUDE.md
Normal file
@@ -0,0 +1,88 @@
|
||||
# HarmonyOS アプリプロジェクト CLAUDE.md
|
||||
|
||||
これはHarmonyOSアプリケーション向けのプロジェクトレベルの CLAUDE.md サンプルです。プロジェクトのルートに配置してください。
|
||||
|
||||
## プロジェクト概要
|
||||
|
||||
[アプリの簡単な説明 - 機能、対象デバイス、APIレベル]
|
||||
|
||||
## 基本ルール
|
||||
|
||||
### 1. 技術スタックの制約
|
||||
|
||||
- プラットフォーム: HarmonyOS(ArkTS/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にはレビューが必要
|
||||
- マージ前にすべてのテストが合格していること
|
||||
Reference in New Issue
Block a user