연동 4장 · 응답 계약 & CRUD 한 바퀴

// 백엔드: web/dto/ActionResult.java
public class ActionResult {
    private boolean ok = false;      // 성공 여부
    private String message = "";     // 메시지(실패 사유 또는 성공 문구)
    private String type;             // success / info / warn / error
    private Object data;             // 성공 시 전달할 데이터
    private List<ObjectError> errors;
}

// 성공: ok=true, data 포함
return ActionResult.ok(userDto);
// 실패: ok=false, message 포함
return ActionResult.fail("저장에 실패했습니다");

// 검증 오류 응답(400) — ActionResult가 아님
{
  "status": 400,
  "error": "Bad Request",
  "message": "입력이 올바르지 않습니다",
  "validationErrors": {
    "email": "올바른 이메일 형식이 아닙니다",
    "userid": "필수 입력입니다"
  }
}

// 프론트: src/lib/api.ts
export interface SuccessResponse<T> {
  ok: true
  type: string
  message: string
  data: T | null
}
export interface ErrorResponse {
  ok: false
  message: string
  status: number
  errors?: Record<string, string>   // 검증 오류 시 채워짐
}

// 프론트: 목록 조회 (useQuery)
function useUserListQuery(pageable, filter) {
  return useQuery({
    queryKey: ["users", filter, pageable],   // 조건별 식별 키
    queryFn: () => api.get("/api/users", { ...filter, ...pageable }),
  })
}

// 프론트: 생성 (useMutation) + 성공 시 무효화
function useCreateUser() {
  const qc = useQueryClient()
  return useMutation({
    mutationFn: (req) => api.post("/api/users", req),   // 성공 SuccessResponse / 실패 ErrorResponse
    onSuccess: () => {
      // ["users"]로 무효화 → ["users", filter, pageable] 목록이 다시 조회됨
      qc.invalidateQueries({ queryKey: ["users"] })
    },
  })
}

// 백엔드: web/endpoint/UserAccountEndpoint.java
@RestController
@RequestMapping("/api/users")
public class UserAccountEndpoint {

  // 목록 조회 → PageDTO로 응답
  @GetMapping("")
  public PageDTO<UserDTO> listByPage(UserFilter filter, Pageable pageable) {
    var page = userRepo.listByPage(filter, pageable)
        .map(UserDTO::fromEntity);
    return PageDTO.fromPage(page);
  }

  // 생성 → @Valid 검증 후 save (반환 타입 void → 성공 시 본문 없는 200)
  @PostMapping("")
  @Transactional
  public void createUserAccount(@Valid @RequestBody UserCreateReq req) {
    var newUser = new User();
    newUser.setUserid(req.userid());
    newUser.setName(req.name());
    newUser.setEmail(req.email());
    newUser.setEncryptedPassword(passwordEncoder.encode(req.password())); // 비밀번호는 BCrypt로
    userRepo.save(newUser);   // 검증 통과 시 저장
  }
}