命名規則とコードスタイル

// 1. 意味のある名前をつける
// 悪い例
const d = new Date();
const n = users.length;
const tmp = calculateTotal(items);

// 良い例
const currentDate = new Date();
const userCount = users.length;
const orderTotal = calculateTotal(items);

// 2. 動詞で始まる関数名
// 悪い例
function data() { /* ... */ }
function user(id: number) { /* ... */ }

// 良い例
function fetchData() { /* ... */ }
function findUserById(id: number) { /* ... */ }

// 3. 真偽値は is/has/can で始める
// 悪い例
const active = true;
const permission = user.role === "admin";

// 良い例
const isActive = true;
const hasPermission = user.role === "admin";
const canEdit = hasPermission && isActive;

// 1. 省略しすぎ
const usrNm = "田中";     // 悪い
const userName = "田中";    // 良い

// 2. 数字の接尾辞
const data1 = fetch("/api/users");
const data2 = fetch("/api/posts");
// ↓
const userData = fetch("/api/users");
const postData = fetch("/api/posts");

// 3. 型情報を名前に含めない
const userArray = [/* ... */];   // 悪い
const users = [/* ... */];        // 良い

const nameString = "田中";       // 悪い
const name = "田中";              // 良い

// 4. 否定形を避ける
const isNotActive = false;       // 悪い（二重否定になりやすい）
const isActive = true;            // 良い

// スペース2つが TypeScript/JavaScript の標準
function processOrder(order: Order): void {
  if (order.status === "pending") {
    const total = calculateTotal(order.items);
    sendConfirmation(order.email, total);
  }
}

// あり（推奨: 多くのプロジェクトで採用）
const name = "田中";
const age = 28;

// なし（一部のプロジェクトで採用）
const name = "田中"
const age = 28

// プロジェクト内で統一する
// 悪い例: スタイルが混在
const user_name = "田中";      // snake_case
const userAge = 28;              // camelCase
const UserEmail = "a@b.com";    // PascalCase

// 良い例: 全て camelCase で統一
const userName = "田中";
const userAge = 28;
const userEmail = "a@b.com";

// なぜこの処理が必要かを説明
// 税率は2024年10月時点の軽減税率（食品8%）を適用
const TAX_RATE = 0.08;

// TODO: パフォーマンス改善が必要（1000件超でタイムアウト）
function processLargeDataset(data: unknown[]): void {
  // ...
}

/**
 * ユーザーの年齢を検証する
 * @param age - 検証する年齢
 * @returns 有効な年齢なら true
 */
function isValidAge(age: number): boolean {
  return age >= 0 && age <= 150;
}

// 悪い例: コードを読めば分かることを書いている
const count = 0; // カウントを0に設定
users.push(newUser); // ユーザーを追加

// 良い例: コード自体が説明になっている（コメント不要）
const initialCount = 0;
users.push(newUser);