Webサイトの画面フローを制御する

【ユーザー単位のセッション】
Session {
    FlowManager {
        flowSteps: {
            "UUID-001": "CONFIRM",   ← フロー1（タブ1で開いている）
            "UUID-002": "YOYAKU",    ← フロー2（タブ2で開いている）
            "UUID-003": "CONFIRM"    ← フロー3（タブ3で開いている）
        }
    }
}

【ユーザー単位のセッション】
Session {
    FlowManager {
        flowSteps: {
            "UUID-001": "CONFIRM",   ← フロー1（タブ1で開いている）
            "UUID-002": "YOYAKU",    ← フロー2（タブ2で開いている）
            "UUID-003": "CONFIRM"    ← フロー3（タブ3で開いている）
        }
    }
}

/**
 * 予約画面Controller
 * FlowManagerへの直接的な依存はAOPで分離
 */
@Controller
public class ReservationController {
    
    @Autowired
    private FlowManager flowManager;
    
    @Autowired
    private ReservationService reservationService;
    
    /**
     * A画面（予約入力画面）表示
     * フロー開始 - 新しいFlowIDを発行
     * 
     * @param model ビューに渡すデータ
     * @return A画面のビュー名
     */
    @GetMapping("/pageA")
    public String pageA(Model model) {
        
        // 新しいフローを開始 - FlowID発行
        String flowId = flowManager.startNewFlow("YOYAKU");
        
        // セッションから生成したHidden値をビューに渡す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "YOYAKU");
        
        // 空のフォームオブジェクト
        model.addAttribute("reservationForm", new ReservationForm());
        
        return "pageA";
    }
    
    /**
     * B画面（確認画面）へ遷移
     * AOP（@ValidateFlow）で自動的に検証
     * @param flowId リクエストから送信されたFlowID（Hidden）
     * @param step リクエストから送信されたステップ（Hidden）
     * @param form 予約フォーム（ユーザー入力データ）
     * @param model ビューに渡すデータ
     * @return B画面のビュー名
     */
    @PostMapping("/pageB")
    @ValidateFlow(currentStep = "YOYAKU", nextStep = "CONFIRM")
    public String pageB(@RequestParam String flowId,
                       @RequestParam String step,
                       @ModelAttribute ReservationForm form,
                       Model model) {
        
        // ★ ここに到達した時点で、AOPによる検証は完了している
        // ★ セッションのステップはYOYAKU → CONFIRM に更新されている
        
        // 業務処理
        
        // 次の画面用のHidden値をビューに渡す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "CONFIRM");
        model.addAttribute("reservationForm", form);
        
        return "pageB";
    }
    
    /**
     * A画面へ戻る（画面の「戻る」ボタン）
     * AOP（@StepBack）で自動的にステップを戻す
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param step リクエストから送信されたステップ（CONFIRM）
     * @param form 予約フォーム
     * @param model ビューに渡すデータ
     * @return A画面のビュー名
     */
    @PostMapping("/pageA/back")
    @StepBack(currentStep = "CONFIRM", previousStep = "YOYAKU")
    public String pageABack(@RequestParam String flowId,
                           @RequestParam String step,
                           @ModelAttribute ReservationForm form,
                           Model model) {
        
        // ★ AOPでstepBack(flowId, "CONFIRM", "YOYAKU")実行済み
        // ★ セッションのステップは既に CONFIRM → YOYAKU に戻されている
        
        // 入力データを復元してA画面に戻す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "YOYAKU");
        model.addAttribute("reservationForm", form);  // 入力データ復元
        
        return "pageA";
    }
}

/**
 * 予約画面Controller
 * FlowManagerへの直接的な依存はAOPで分離
 */
@Controller
public class ReservationController {
    
    @Autowired
    private FlowManager flowManager;
    
    @Autowired
    private ReservationService reservationService;
    
    /**
     * A画面（予約入力画面）表示
     * フロー開始 - 新しいFlowIDを発行
     * 
     * @param model ビューに渡すデータ
     * @return A画面のビュー名
     */
    @GetMapping("/pageA")
    public String pageA(Model model) {
        
        // 新しいフローを開始 - FlowID発行
        String flowId = flowManager.startNewFlow("YOYAKU");
        
        // セッションから生成したHidden値をビューに渡す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "YOYAKU");
        
        // 空のフォームオブジェクト
        model.addAttribute("reservationForm", new ReservationForm());
        
        return "pageA";
    }
    
    /**
     * B画面（確認画面）へ遷移
     * AOP（@ValidateFlow）で自動的に検証
     * @param flowId リクエストから送信されたFlowID（Hidden）
     * @param step リクエストから送信されたステップ（Hidden）
     * @param form 予約フォーム（ユーザー入力データ）
     * @param model ビューに渡すデータ
     * @return B画面のビュー名
     */
    @PostMapping("/pageB")
    @ValidateFlow(currentStep = "YOYAKU", nextStep = "CONFIRM")
    public String pageB(@RequestParam String flowId,
                       @RequestParam String step,
                       @ModelAttribute ReservationForm form,
                       Model model) {
        
        // ★ ここに到達した時点で、AOPによる検証は完了している
        // ★ セッションのステップはYOYAKU → CONFIRM に更新されている
        
        // 業務処理
        
        // 次の画面用のHidden値をビューに渡す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "CONFIRM");
        model.addAttribute("reservationForm", form);
        
        return "pageB";
    }
    
    /**
     * A画面へ戻る（画面の「戻る」ボタン）
     * AOP（@StepBack）で自動的にステップを戻す
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param step リクエストから送信されたステップ（CONFIRM）
     * @param form 予約フォーム
     * @param model ビューに渡すデータ
     * @return A画面のビュー名
     */
    @PostMapping("/pageA/back")
    @StepBack(currentStep = "CONFIRM", previousStep = "YOYAKU")
    public String pageABack(@RequestParam String flowId,
                           @RequestParam String step,
                           @ModelAttribute ReservationForm form,
                           Model model) {
        
        // ★ AOPでstepBack(flowId, "CONFIRM", "YOYAKU")実行済み
        // ★ セッションのステップは既に CONFIRM → YOYAKU に戻されている
        
        // 入力データを復元してA画面に戻す
        model.addAttribute("flowId", flowId);
        model.addAttribute("step", "YOYAKU");
        model.addAttribute("reservationForm", form);  // 入力データ復元
        
        return "pageA";
    }
}

package com.example.reservation.annotation;

import java.lang.annotation.ElementType;
import java.lang. annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang. annotation.Target;

/**
 * フロー検証アノテーション
 * Controllerメソッドに付与することで、画面遷移の妥当性を検証する
 */
@Target(ElementType.METHOD)  // メソッドに対してのみ付与可能
@Retention(RetentionPolicy.RUNTIME)  // 実行時にアノテーション情報を保持
public @interface ValidateFlow {
    
    /**
     * 現在のステップ
     * リクエストで送信されるべきステップ値
     * @return ステップ名（例:  "YOYAKU", "CONFIRM"）
     */
    String currentStep();
    
    /**
     * 次のステップ
     * 検証OKの場合に進むべきステップ
     * @return ステップ名（例: "CONFIRM", "COMPLETE"）
     */
    String nextStep();
}

package com.example.reservation.annotation;

import java.lang.annotation.ElementType;
import java.lang. annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang. annotation.Target;

/**
 * フロー検証アノテーション
 * Controllerメソッドに付与することで、画面遷移の妥当性を検証する
 */
@Target(ElementType.METHOD)  // メソッドに対してのみ付与可能
@Retention(RetentionPolicy.RUNTIME)  // 実行時にアノテーション情報を保持
public @interface ValidateFlow {
    
    /**
     * 現在のステップ
     * リクエストで送信されるべきステップ値
     * @return ステップ名（例:  "YOYAKU", "CONFIRM"）
     */
    String currentStep();
    
    /**
     * 次のステップ
     * 検証OKの場合に進むべきステップ
     * @return ステップ名（例: "CONFIRM", "COMPLETE"）
     */
    String nextStep();
}

package com.example.reservation.annotation;

import java.lang.annotation.ElementType;
import java.lang. annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang. annotation.Target;

/**
 * ステップバック（戻る）アノテーション
 * 画面の「戻る」ボタン用
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface StepBack {
    
    /**
     * 現在のステップ
     */
    String currentStep();
    
    /**
     * 戻り先のステップ
     */
    String previousStep();
}

package com.example.reservation.annotation;

import java.lang.annotation.ElementType;
import java.lang. annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang. annotation.Target;

/**
 * ステップバック（戻る）アノテーション
 * 画面の「戻る」ボタン用
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface StepBack {
    
    /**
     * 現在のステップ
     */
    String currentStep();
    
    /**
     * 戻り先のステップ
     */
    String previousStep();
}

package com.example.reservation.flow;

import org.springframework.context.annotation.Scope;
import org.springframework.context.annotation.ScopedProxyMode;
import org.springframework.stereotype.Component;

import java.util.Map;
import java.util.UUID;
import java.util.concurrent.ConcurrentHashMap;

/**
 * フロー管理クラス
 */
@Component
@Scope(value = "session", proxyMode = ScopedProxyMode. TARGET_CLASS)
public class FlowManager {
    
    /**
     * FlowIDとステップのマッピング
     * Key: FlowID (UUID)
     * Value: 現在のステップ (例: "YOYAKU", "CONFIRM", "COMPLETE")
     */
    private Map<String, String> flowSteps = new ConcurrentHashMap<>();
    
    /**
     * 新しいフローを開始
     * 
     * シーケンス図での呼び出し:
     * - ControllerA->>FlowMgr: startNewFlow YOYAKU
     * - FlowMgr-->>ControllerA: flowId=UUID-001
     * 
     * @param initialStep 初期ステップ（例: "YOYAKU"）
     * @return 生成されたFlowID
     */
    public String startNewFlow(String initialStep) {
        // UUIDで一意なFlowIDを生成
        String flowId = UUID.randomUUID().toString();
        
        // セッション内のMapに保存
        // 例: { "UUID-001": "YOYAKU" }
        flowSteps.put(flowId, initialStep);
        
        return flowId;
    }
    
    /**
     * フロー検証 & 次ステップへ進行
     * 
     * シーケンス図での呼び出し:
     * - ControllerB->>FlowMgr:  validateAndNextStep
     *     flowId:  UUID-001
     *     currentStep: YOYAKU
     *     nextStep: CONFIRM
     * - FlowMgr-->>ControllerB: true 検証OK
     * 
     * 検証内容:
     * 1. FlowIDの存在チェック（セッションタイムアウト検出）
     * 2. リクエストのstepとセッションのstepの一致確認（ブラウザバック検出）
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param currentStep リクエストから送信された現在のステップ
     * @param nextStep 次に進むべきステップ
     * @return true:  検証OK（ステップ更新済み）, false: 検証NG
     */
    public boolean validateAndNextStep(String flowId, String currentStep, String nextStep) {
        // 1. FlowIDの存在チェック
        if (!flowSteps.containsKey(flowId)) {
            // セッションタイムアウトまたは不正なFlowID
            return false;
        }
        
        // 2. セッション内のステップを取得
        String sessionStep = flowSteps.get(flowId);
        
        // 3. リクエストのステップとセッションのステップが一致するか確認
        if (!currentStep.equals(sessionStep)) {
            // ブラウザバックや不正な画面遷移を検出
            // 例: リクエスト=CONFIRM, セッション=COMPLETE → NG（二重送信）
            return false;
        }
        
        // 4. 検証OKの場合、セッションを次のステップに更新
        // 例: UUID-001: YOYAKU → CONFIRM
        flowSteps.put(flowId, nextStep);
        
        return true;
    }
    
    /**
     * ステップを戻す（画面の「戻る」ボタン用）
     * 
     * シーケンス図での呼び出し:
     * - ControllerA->>FlowMgr: stepBack
     *     flowId:  UUID-002
     *     currentStep: CONFIRM
     *     previousStep: YOYAKU
     * - FlowMgr-->>ControllerA: true 検証OK
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param currentStep リクエストから送信された現在のステップ
     * @param previousStep 戻り先のステップ
     * @return true: 検証OK（ステップ更新済み）, false: 検証NG
     */
    public boolean stepBack(String flowId, String currentStep, String previousStep) {
        // 1. FlowIDの存在チェック
        if (!flowSteps.containsKey(flowId)) {
            return false;
        }
        
        // 2. セッション内のステップを取得
        String sessionStep = flowSteps.get(flowId);
        
        // 3. リクエストのステップとセッションのステップが一致するか確認
        if (! currentStep.equals(sessionStep)) {
            return false;
        }
        
        // 4. 検証OKの場合、セッションを前のステップに戻す
        // 例: UUID-002: CONFIRM → YOYAKU
        flowSteps.put(flowId, previousStep);
        
        return true;
    }
    
    /**
     * FlowIDを削除（フロー完了時やクリーンアップ時）
     * 
     * @param flowId 削除するFlowID
     */
    public void removeFlow(String flowId) {
        flowSteps.remove(flowId);
    }
    
    /**
     * 現在のステップを取得（デバッグ用）
     * 
     * @param flowId FlowID
     * @return 現在のステップ、存在しない場合はnull
     */
    public String getCurrentStep(String flowId) {
        return flowSteps.get(flowId);
    }
}

package com.example.reservation.flow;

import org.springframework.context.annotation.Scope;
import org.springframework.context.annotation.ScopedProxyMode;
import org.springframework.stereotype.Component;

import java.util.Map;
import java.util.UUID;
import java.util.concurrent.ConcurrentHashMap;

/**
 * フロー管理クラス
 */
@Component
@Scope(value = "session", proxyMode = ScopedProxyMode. TARGET_CLASS)
public class FlowManager {
    
    /**
     * FlowIDとステップのマッピング
     * Key: FlowID (UUID)
     * Value: 現在のステップ (例: "YOYAKU", "CONFIRM", "COMPLETE")
     */
    private Map<String, String> flowSteps = new ConcurrentHashMap<>();
    
    /**
     * 新しいフローを開始
     * 
     * シーケンス図での呼び出し:
     * - ControllerA->>FlowMgr: startNewFlow YOYAKU
     * - FlowMgr-->>ControllerA: flowId=UUID-001
     * 
     * @param initialStep 初期ステップ（例: "YOYAKU"）
     * @return 生成されたFlowID
     */
    public String startNewFlow(String initialStep) {
        // UUIDで一意なFlowIDを生成
        String flowId = UUID.randomUUID().toString();
        
        // セッション内のMapに保存
        // 例: { "UUID-001": "YOYAKU" }
        flowSteps.put(flowId, initialStep);
        
        return flowId;
    }
    
    /**
     * フロー検証 & 次ステップへ進行
     * 
     * シーケンス図での呼び出し:
     * - ControllerB->>FlowMgr:  validateAndNextStep
     *     flowId:  UUID-001
     *     currentStep: YOYAKU
     *     nextStep: CONFIRM
     * - FlowMgr-->>ControllerB: true 検証OK
     * 
     * 検証内容:
     * 1. FlowIDの存在チェック（セッションタイムアウト検出）
     * 2. リクエストのstepとセッションのstepの一致確認（ブラウザバック検出）
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param currentStep リクエストから送信された現在のステップ
     * @param nextStep 次に進むべきステップ
     * @return true:  検証OK（ステップ更新済み）, false: 検証NG
     */
    public boolean validateAndNextStep(String flowId, String currentStep, String nextStep) {
        // 1. FlowIDの存在チェック
        if (!flowSteps.containsKey(flowId)) {
            // セッションタイムアウトまたは不正なFlowID
            return false;
        }
        
        // 2. セッション内のステップを取得
        String sessionStep = flowSteps.get(flowId);
        
        // 3. リクエストのステップとセッションのステップが一致するか確認
        if (!currentStep.equals(sessionStep)) {
            // ブラウザバックや不正な画面遷移を検出
            // 例: リクエスト=CONFIRM, セッション=COMPLETE → NG（二重送信）
            return false;
        }
        
        // 4. 検証OKの場合、セッションを次のステップに更新
        // 例: UUID-001: YOYAKU → CONFIRM
        flowSteps.put(flowId, nextStep);
        
        return true;
    }
    
    /**
     * ステップを戻す（画面の「戻る」ボタン用）
     * 
     * シーケンス図での呼び出し:
     * - ControllerA->>FlowMgr: stepBack
     *     flowId:  UUID-002
     *     currentStep: CONFIRM
     *     previousStep: YOYAKU
     * - FlowMgr-->>ControllerA: true 検証OK
     * 
     * @param flowId リクエストから送信されたFlowID
     * @param currentStep リクエストから送信された現在のステップ
     * @param previousStep 戻り先のステップ
     * @return true: 検証OK（ステップ更新済み）, false: 検証NG
     */
    public boolean stepBack(String flowId, String currentStep, String previousStep) {
        // 1. FlowIDの存在チェック
        if (!flowSteps.containsKey(flowId)) {
            return false;
        }
        
        // 2. セッション内のステップを取得
        String sessionStep = flowSteps.get(flowId);
        
        // 3. リクエストのステップとセッションのステップが一致するか確認
        if (! currentStep.equals(sessionStep)) {
            return false;
        }
        
        // 4. 検証OKの場合、セッションを前のステップに戻す
        // 例: UUID-002: CONFIRM → YOYAKU
        flowSteps.put(flowId, previousStep);
        
        return true;
    }
    
    /**
     * FlowIDを削除（フロー完了時やクリーンアップ時）
     * 
     * @param flowId 削除するFlowID
     */
    public void removeFlow(String flowId) {
        flowSteps.remove(flowId);
    }
    
    /**
     * 現在のステップを取得（デバッグ用）
     * 
     * @param flowId FlowID
     * @return 現在のステップ、存在しない場合はnull
     */
    public String getCurrentStep(String flowId) {
        return flowSteps.get(flowId);
    }
}

package com.example.reservation. aop;

import com.example. reservation.annotation.StepBack;
import com.example.reservation.annotation.ValidateFlow;
import com.example.reservation.exception.InvalidFlowException;
import com.example.reservation.flow.FlowManager;
import org.aspectj. lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang. annotation.Aspect;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

import javax.servlet.http.HttpServletRequest;

/**
 * フロー検証Aspect
 * @ValidateFlow および @StepBack アノテーションが付与されたメソッドに対して
 * 画面遷移の妥当性を検証する
 * 
 * - Controllerメソッド実行前に validateAndNextStep または stepBack を実行
 * - 検証NGの場合はControllerメソッドを実行せず、エラー画面を返す
 */
@Aspect
@Component
public class FlowValidationAspect {
    
    @Autowired
    private FlowManager flowManager;
    
    /**
     * @ValidateFlow アノテーションが付与されたメソッドの実行前後に処理を行う
     * 
     * @param joinPoint 実行対象のメソッド情報
     * @param validateFlow アノテーション情報
     * @return Controllerメソッドの戻り値
     * @throws Throwable メソッド実行時の例外
     */
    @Around("@annotation(validateFlow)")
    public Object validateFlow(ProceedingJoinPoint joinPoint, ValidateFlow validateFlow) throws Throwable {
        
        // 1. HTTPリクエストを取得
        ServletRequestAttributes attributes = 
            (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        
        if (attributes == null) {
            throw new InvalidFlowException("リクエスト情報の取得に失敗しました");
        }
        
        HttpServletRequest request = attributes. getRequest();
        
        // 2. リクエストパラメータからflowIdとstepを取得
        String flowId = request.getParameter("flowId");
        String step = request.getParameter("step");
        
        // 3. パラメータの存在チェック
        if (flowId == null || step == null) {
            throw new InvalidFlowException("必須パラメータが不足しています");
        }
        
        // 4. アノテーションから期待するステップを取得
        String expectedCurrentStep = validateFlow.currentStep();
        String nextStep = validateFlow.nextStep();
        
        // 5. FlowManagerで検証 & ステップ更新
        boolean valid = flowManager.validateAndNextStep(flowId, expectedCurrentStep, nextStep);
        
        if (! valid) {
            // 検証NG:  ブラウザバックや不正な画面遷移を検出
            // 例: リクエストstep=CONFIRM, セッションstep=COMPLETE
            //     → 二重送信を検出
            
            // Controllerメソッドを実行せず、エラー画面を返す
            return "error";
        }
        
        // 6. 検証OK:  Controllerメソッドを実行        
        Object result = joinPoint.proceed();
        
        return result;
    }
    
    /**
     * @StepBack アノテーションが付与されたメソッドの実行前後に処理を行う
     * 画面の「戻る」ボタン用
     * 
     * @param joinPoint 実行対象のメソッド情報
     * @param stepBack アノテーション情報
     * @return Controllerメソッドの戻り値
     * @throws Throwable メソッド実行時の例外
     */
    @Around("@annotation(stepBack)")
    public Object stepBack(ProceedingJoinPoint joinPoint, StepBack stepBack) throws Throwable {
        
        // 1. HTTPリクエストを取得
        ServletRequestAttributes attributes = 
            (ServletRequestAttributes) RequestContextHolder. getRequestAttributes();
        
        if (attributes == null) {
            throw new InvalidFlowException("リクエスト情報の取得に失敗しました");
        }
        
        HttpServletRequest request = attributes.getRequest();
        
        // 2. リクエストパラメータからflowIdとstepを取得
        String flowId = request.getParameter("flowId");
        String step = request.getParameter("step");
        
        // 3. パラメータの存在チェック
        if (flowId == null || step == null) {
            throw new InvalidFlowException("必須パラメータが不足しています");
        }
        
        // 4. アノテーションから期待するステップを取得
        String expectedCurrentStep = stepBack. currentStep();
        String previousStep = stepBack.previousStep();
                
        // 5. FlowManagerでステップを戻す
        // シーケンス図:
        // - ControllerA->>FlowMgr:  stepBack
        // - 検証処理
        // - FlowMgr-->>ControllerA: true 検証OK
        // - セッション更新: UUID-002: CONFIRM → YOYAKU
        boolean valid = flowManager. stepBack(flowId, expectedCurrentStep, previousStep);
        
        if (!valid) {
            return "error";
        }
        
        // 6. 検証OK:  Controllerメソッドを実行
        Object result = joinPoint.proceed();
        
        return result;
    }
}

package com.example.reservation. aop;

import com.example. reservation.annotation.StepBack;
import com.example.reservation.annotation.ValidateFlow;
import com.example.reservation.exception.InvalidFlowException;
import com.example.reservation.flow.FlowManager;
import org.aspectj. lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang. annotation.Aspect;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

import javax.servlet.http.HttpServletRequest;

/**
 * フロー検証Aspect
 * @ValidateFlow および @StepBack アノテーションが付与されたメソッドに対して
 * 画面遷移の妥当性を検証する
 * 
 * - Controllerメソッド実行前に validateAndNextStep または stepBack を実行
 * - 検証NGの場合はControllerメソッドを実行せず、エラー画面を返す
 */
@Aspect
@Component
public class FlowValidationAspect {
    
    @Autowired
    private FlowManager flowManager;
    
    /**
     * @ValidateFlow アノテーションが付与されたメソッドの実行前後に処理を行う
     * 
     * @param joinPoint 実行対象のメソッド情報
     * @param validateFlow アノテーション情報
     * @return Controllerメソッドの戻り値
     * @throws Throwable メソッド実行時の例外
     */
    @Around("@annotation(validateFlow)")
    public Object validateFlow(ProceedingJoinPoint joinPoint, ValidateFlow validateFlow) throws Throwable {
        
        // 1. HTTPリクエストを取得
        ServletRequestAttributes attributes = 
            (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        
        if (attributes == null) {
            throw new InvalidFlowException("リクエスト情報の取得に失敗しました");
        }
        
        HttpServletRequest request = attributes. getRequest();
        
        // 2. リクエストパラメータからflowIdとstepを取得
        String flowId = request.getParameter("flowId");
        String step = request.getParameter("step");
        
        // 3. パラメータの存在チェック
        if (flowId == null || step == null) {
            throw new InvalidFlowException("必須パラメータが不足しています");
        }
        
        // 4. アノテーションから期待するステップを取得
        String expectedCurrentStep = validateFlow.currentStep();
        String nextStep = validateFlow.nextStep();
        
        // 5. FlowManagerで検証 & ステップ更新
        boolean valid = flowManager.validateAndNextStep(flowId, expectedCurrentStep, nextStep);
        
        if (! valid) {
            // 検証NG:  ブラウザバックや不正な画面遷移を検出
            // 例: リクエストstep=CONFIRM, セッションstep=COMPLETE
            //     → 二重送信を検出
            
            // Controllerメソッドを実行せず、エラー画面を返す
            return "error";
        }
        
        // 6. 検証OK:  Controllerメソッドを実行        
        Object result = joinPoint.proceed();
        
        return result;
    }
    
    /**
     * @StepBack アノテーションが付与されたメソッドの実行前後に処理を行う
     * 画面の「戻る」ボタン用
     * 
     * @param joinPoint 実行対象のメソッド情報
     * @param stepBack アノテーション情報
     * @return Controllerメソッドの戻り値
     * @throws Throwable メソッド実行時の例外
     */
    @Around("@annotation(stepBack)")
    public Object stepBack(ProceedingJoinPoint joinPoint, StepBack stepBack) throws Throwable {
        
        // 1. HTTPリクエストを取得
        ServletRequestAttributes attributes = 
            (ServletRequestAttributes) RequestContextHolder. getRequestAttributes();
        
        if (attributes == null) {
            throw new InvalidFlowException("リクエスト情報の取得に失敗しました");
        }
        
        HttpServletRequest request = attributes.getRequest();
        
        // 2. リクエストパラメータからflowIdとstepを取得
        String flowId = request.getParameter("flowId");
        String step = request.getParameter("step");
        
        // 3. パラメータの存在チェック
        if (flowId == null || step == null) {
            throw new InvalidFlowException("必須パラメータが不足しています");
        }
        
        // 4. アノテーションから期待するステップを取得
        String expectedCurrentStep = stepBack. currentStep();
        String previousStep = stepBack.previousStep();
                
        // 5. FlowManagerでステップを戻す
        // シーケンス図:
        // - ControllerA->>FlowMgr:  stepBack
        // - 検証処理
        // - FlowMgr-->>ControllerA: true 検証OK
        // - セッション更新: UUID-002: CONFIRM → YOYAKU
        boolean valid = flowManager. stepBack(flowId, expectedCurrentStep, previousStep);
        
        if (!valid) {
            return "error";
        }
        
        // 6. 検証OK:  Controllerメソッドを実行
        Object result = joinPoint.proceed();
        
        return result;
    }
}