Skip to content

Latest commit

 

History

History
30 lines (24 loc) · 3.01 KB

File metadata and controls

30 lines (24 loc) · 3.01 KB

1. ゴール / 非ゴール

  • ゴール: /example 配下のサンプルアプリで表示されるすべての英語 UI 文言・サンプルデータを自然な日本語に置き換え、表示崩れなく動作させる。
  • 非ゴール: ライブラリ本体(/src 配下)のロジック変更や i18n ライブラリ導入、ビルド設定の変更。

2. スコープと変更対象

  • 変更ファイル(新規/修正/削除): /example/src/App.tsx, /example/src/components/view-switcher.tsx, /example/src/helper.tsx, /example/public/index.html, /example/public/manifest.json, /example/README.md(必要に応じて)など UI 文言を含むもの。計画ファイルを本書で新規作成。
  • 影響範囲・互換性リスク: サンプル表示テキストのみ変更。ロジック・型定義に触れないため互換性リスクは極小。タスク ID や構造は維持。
  • 外部依存・Secrets の扱い: 追加なし。既存依存のみ使用し、Secrets は扱わない。

3. 設計方針

  • 責務分離 / データフロー: 既存コンポーネント構造を維持し、文字列リテラルのみ日本語化。タスクデータの name 等ユーザー表示項目を翻訳し、ID はそのまま。
  • エッジケース / 例外系 / リトライ方針: 確認ダイアログやログ出力も日本語化し意味が変わらないようにする。ロジックは変更しないため新規例外処理は不要。
  • ログと観測性(漏洩防止を含む): console 出力は日本語に揃えつつ ID など非機密情報のみを出力する現状方針を維持。

4. テスト戦略

  • テスト観点(正常 / 例外 / 境界 / 回帰): CRA デフォルトレンダリングテストが通ること(UI 文字列変更で落ちない)。表示文言は目視確認。
  • モック / フィクスチャ方針: 既存テストをそのまま使用。新規モック不要。
  • テスト追加の実行コマンド: npm test(ルートで lint/build/unit を含む)を実行。必要に応じて cd example && npm test -- --watch=false は省略可。

5. CI 品質ゲート

  • 実行コマンド(format / lint / typecheck / test / security): 既存 npm test により eslint・build・unit を網羅。追加のセキュリティスキャンは無し。dnd-kit 導入後に npm run lint を個別追加実行し、警告のみでエラーなしであることを確認。
  • 通過基準と失敗時の対応: すべて成功すること。失敗時は該当箇所の文言変更を見直し、ロジック差分がないか確認。

6. ロールアウト・運用

  • ロールバック方法: 変更ファイルを元の英語文言へ戻すか Git でリバートする。
  • 監視・運用上の注意: デモ用途のため特別な監視なし。起動確認で UI 文言が日本語になっていることを確認。

7. オープンな課題 / ADR 要否

  • 未確定事項: なし。
  • ADR に残すべき判断: なし(文言置換のみのため)。