ユースケース（ユースケース）

タイトル: ユーザがログインする
アクター: 登録済みユーザ
前提条件: アカウントが作成済み
トリガー: ユーザがログインボタンを押す

メインフロー:
  1. システムがログイン画面を表示
  2. ユーザがメール + パスワードを入力
  3. ユーザが「ログイン」を押す
  4. システムが認証情報を検証
  5. システムがダッシュボードを表示

代替フロー（4a）:
  パスワード違い → エラー表示 + 再入力

例外フロー（4b）:
  3 回失敗 → アカウントロック + 通知メール

事後条件: セッション開始、最終ログイン日時更新

[ Presentation ] → [ Application / Use Case ] → [ Domain / Entity ]
                                                  ↑
[ Infrastructure / DB / API ] ──────────────────┘

// Use Case
export class CreateOrderUseCase {
  constructor(
    private orderRepo: OrderRepository,
    private inventoryService: InventoryService,
    private notifier: NotificationService,
  ) {}

  async execute(input: CreateOrderInput): Promise<CreateOrderOutput> {
    // 1. 商品の在庫確認
    const items = await this.inventoryService.checkStock(input.items);
    if (!items.allInStock) {
      throw new OutOfStockError(items.missing);
    }

    // 2. ドメインエンティティ作成
    const order = Order.create({
      userId: input.userId,
      items: items.products,
      shippingAddress: input.address,
    });

    // 3. 永続化
    await this.orderRepo.save(order);

    // 4. 在庫減算
    await this.inventoryService.reserveStock(items.products);

    // 5. 通知送信
    await this.notifier.sendOrderConfirmation(order);

    return { orderId: order.id, total: order.totalAmount() };
  }
}

Feature: ユーザログイン
  Scenario: 正しい認証情報でログイン
    Given ユーザが登録済みである
    And ユーザはログイン画面を開いている
    When 正しいメールとパスワードを入力する
    And ログインボタンを押す
    Then ダッシュボードに遷移する
    And セッションが開始される

graph LR
  User((ユーザ))
  Admin((管理者))
  UC1[商品検索]
  UC2[商品購入]
  UC3[在庫管理]
  UC4[ユーザ管理]

  User --> UC1
  User --> UC2
  Admin --> UC3
  Admin --> UC4

apps/jisakucom-api/src/
├── domain/             # Entity / Value Object
├── application/        # ★ Use Case（121 ファイル）
│   └── use-cases/
│       ├── product/
│       ├── ranking/
│       ├── seo-scoring/
│       └── ...
├── infrastructure/     # Repository 実装
└── presentation/       # HTTP Controller