✨Feat: 프로필 수정 컴포넌트 구현

src/app/features/auth/api/authApi.ts

@@ -1,15 +1,21 @@
-import api from '@/app/shared/lib/axios'
+import authHttpClient from '@/app/shared/lib/axios'
 import { User as SignupResponse } from '@/app/shared/types/user.type'
 
 import { LoginRequest, LoginResponse, SignupRequest } from '../types/auth.type'
 import { AUTH_ENDPOINT } from './authEndpoint'
 
 export const login = async (data: LoginRequest): Promise<LoginResponse> => {
-  const response = await api.post<LoginResponse>(AUTH_ENDPOINT.LOGIN, data)
+  const response = await authHttpClient.post<LoginResponse>(
+    AUTH_ENDPOINT.LOGIN,
+    data,
+  )
   return response.data
 }
 
 export const signup = async (data: SignupRequest): Promise<SignupResponse> => {
-  const response = await api.post<SignupResponse>(AUTH_ENDPOINT.SIGNUP, data)
+  const response = await authHttpClient.post<SignupResponse>(
+    AUTH_ENDPOINT.SIGNUP,
+    data,
+  )
   return response.data
 }

src/app/features/auth/hooks/useLoginMutation.ts

@@ -22,11 +22,11 @@ export function useLoginMutation() {
     },
     onError: (error) => {
       if (axios.isAxiosError(error)) {
-        const severMessage = (
+        const serverMessage = (
           error.response?.data as { message?: string } | undefined
         )?.message
         const fallback = error.message || '로그인 실패'
-        showError(severMessage ?? fallback)
+        showError(serverMessage ?? fallback)
       } else {
         showError('알 수 없는 에러 발생')
       }

src/app/features/auth/hooks/useSignupMutation.ts

@@ -21,11 +21,11 @@ export function useSignupMutation() {
     },
     onError: (error) => {
       if (axios.isAxiosError(error)) {
-        const severMessage = (
+        const serverMessage = (
           error.response?.data as { message?: string } | undefined
         )?.message
         const fallback = error.message || '로그인 실패'
-        showError(severMessage ?? fallback)
+        showError(serverMessage ?? fallback)
       } else {
         showError('알 수 없는 에러 발생')
       }

src/app/features/mypage/api/mypageApi.ts

@@ -0,0 +1,36 @@
+import authHttpClient from '@lib/axios'
+
+import { User as UserDataResponse } from '@/app/shared/types/user.type'
+
+import {
+  UpdateProfileRequest,
+  UploadProfileImageResponse,
+} from '../types/mypage.type'
+import { MYPAGE_ENDPOINT } from './mypageEndPoint'
+
+export async function loadUser(): Promise<UserDataResponse> {
+  const response = await authHttpClient.get(MYPAGE_ENDPOINT.USER)
+  return response.data
+}
+
+export async function updateMyProfile(
+  data: UpdateProfileRequest,
+): Promise<UserDataResponse> {
+  const response = await authHttpClient.put<UserDataResponse>(
+    MYPAGE_ENDPOINT.USER,
+    data,
+  )
+  return response.data
+}
+
+export async function uploadProfileImage(
+  image: File,
+): Promise<UploadProfileImageResponse> {
+  const formData = new FormData()
+  formData.append('image', image)
+  const response = await authHttpClient.post<UploadProfileImageResponse>(
+    MYPAGE_ENDPOINT.IMAGE,
+    formData,
+  )
+  return response.data
+}

src/app/features/mypage/api/mypageEndPoint.ts

@@ -0,0 +1,4 @@
+export const MYPAGE_ENDPOINT = {
+  USER: `/${process.env.NEXT_PUBLIC_TEAM_ID}/users/me`,
+  IMAGE: `/${process.env.NEXT_PUBLIC_TEAM_ID}/users/me/image`,
+}

src/app/features/mypage/components/ProfileEditForm.tsx

@@ -0,0 +1,133 @@
+'use client'
+
+import Input from '@components/Input'
+import { showError, showSuccess } from '@lib/toast'
+import { isAxiosError } from 'axios'
+import { useRouter } from 'next/navigation'
+import { useEffect, useState } from 'react'
+import { Controller, useForm } from 'react-hook-form'
+
+import { useUpdateMyProfileMutation } from '../hook/useUpdateMyProfileMutation'
+import { useUploadProfileImageMutation } from '../hook/useUploadProfileImageMutation'
+import { useUserQuery } from '../hook/useUserQurey'
+import { mypageValidation } from '../schemas/mypageValidation'
+import ProfileImageUpload from './ProfileImageUpload'
+
+interface ProfileFormData {
+  profileImageUrl: string | null
+  nickname: string
+  email: string
+}
+
+export default function ProfileEditForm() {
+  const { data: user } = useUserQuery() // get으로 사용자 데이터 최신화
+  const router = useRouter() // useClientQuery를 사용 하여 해당 부분에만 렌더링을 진행하려 했으나 다른 부분도 연동되는 부분이 있기 때문에 라우터 사용
+  const {
+    control,
+    register,
+    handleSubmit,
+    reset,
+    formState: { errors },
+  } = useForm<ProfileFormData>({
+    mode: 'onChange',
+    defaultValues: {
+      profileImageUrl: user?.profileImageUrl,
+      nickname: user?.nickname,
+      email: user?.email,
+    },
+  })
+
+  const [profileImageFile, setProfileImageFile] = useState<File | null>(null)
+  const { mutateAsync: uploadImage } = useUploadProfileImageMutation()
+  const { mutateAsync: updateProfile } = useUpdateMyProfileMutation()
+
+  // 유저 정보가 비동기적으로 넘어오기 때문에 유저가 로딩된 시점에서 RHF을 초기화 하기 위함 (SSR 도입 시 변경 예정)
+  useEffect(() => {
+    if (user) {
+      reset({
+        profileImageUrl: user.profileImageUrl ?? null,
+        nickname: user.nickname ?? '',
+        email: user.email ?? '',
+      })
+    }
+  }, [user, reset])
+
+  async function onSubmit(data: ProfileFormData) {
+    try {
+      // 현재 이미지 URL을 초기값으로 설정 (변경이 없을 수도 있기 때문)
+      let imageUrl = data.profileImageUrl
+
+      // 새 이미지를 업로드한 경우 → 서버에 업로드 요청 (POST)
+      if (profileImageFile) {
+        const { profileImageUrl } = await uploadImage(profileImageFile)
+        imageUrl = profileImageUrl
+      }
+
+      // 닉네임과 이미지 URL을 포함한 사용자 프로필 정보 생성
+      const submitData = {
+        nickname: data.nickname,
+        profileImageUrl: imageUrl,
+      }
+
+      // 서버에 프로필 정보 수정 요청 (PUT)
+      await updateProfile(submitData)
+
+      // 사용자에게 성공 알림 + 컴포넌트 최신화
+      showSuccess('프로필 변경이 완료되었습니다.')
+      router.refresh()
+    } catch (error) {
+      if (isAxiosError(error)) {
+        // 서버 에러 메시지 우선 처리, 없으면 기본 메시지
+        const serverMessage = (
+          error.response?.data as { message?: string } | undefined
+        )?.message
+        const fallback = error.message || '프로필 변경에 실패하였습니다.'
+        showError(serverMessage ?? fallback)
+      } else {
+        showError('알 수 없는 에러 발생')
+      }
+    }
+  }
+
+  return (
+    <form
+      onSubmit={handleSubmit(onSubmit)}
+      className="BG-white flex h-auto w-full max-w-672 flex-col gap-24 rounded-8 p-24 font-medium"
+    >
+      <h2 className="text-2xl font-bold">프로필</h2>
+
+      <div className="flex justify-between gap-42 tablet:flex-col">
+        <Controller
+          name="profileImageUrl"
+          control={control}
+          render={({ field: { value, onChange } }) => (
+            <ProfileImageUpload
+              value={value} // 미리보기용 이미지 URL
+              onChange={onChange} // form 상태(profileImageUrl) 업데이트
+              onFileChange={(file) => setProfileImageFile(file)} // 서버 전송용 파일 저장
+            />
+          )}
+        />
+
+        <div className="flex flex-grow flex-col gap-16">
+          <Input labelName="이메일" {...register('email')} readOnly />
+          <Input
+            labelName="닉네임"
+            type="text"
+            placeholder="닉네임을 입력해 주세요"
+            autoComplete="off"
+            {...register('nickname', mypageValidation.nickname)}
+            hasError={!!errors.nickname}
+            errorMessage={errors.nickname?.message}
+          />
+          <button
+            type="submit"
+            className="BG-blue h-50 w-full rounded-8 text-white"
+          >
+            저장
+          </button>
+        </div>
+      </div>
+    </form>
+  )
+}

src/app/features/mypage/components/ProfileImageUpload.tsx

@@ -0,0 +1,102 @@
+'use client'
+
+import CloseCircleIcon from '@components/common/CloseCircleIcon/CloseCircleIcon'
+import PlusIcon from '@components/common/PlusIcon/PlusIcon'
+import WhitePenIcon from '@components/common/WhitePenIcon/WhitePenIcon'
+import Image from 'next/image'
+import { useEffect, useRef, useState } from 'react'
+
+interface Props {
+  value: string | null // RHF에서 연결된 이미지 URL 상태 (미리보기용)
+  onChange: (url: string | null) => void // RHF 필드 상태 변경 함수
+  onFileChange?: (file: File) => void // 실제 업로드할 파일을 상위에서 처리할 수 있게 전달
+}
+
+export default function ProfileImageUpload({
+  value,
+  onChange,
+  onFileChange,
+}: Props) {
+  const inputRef = useRef<HTMLInputElement | null>(null)
+  const [preview, setPreview] = useState<string | null>(null)
+
+  // RHF나 상위 컴포넌트로부터 받은 value가 바뀌면 미리보기를 갱신
+  useEffect(() => {
+    setPreview(value)
+  }, [value])
+
+  // 파일이 선택되었을 때 처리
+  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0]
+    if (!file) return
+
+    const url = URL.createObjectURL(file) // 로컬 미리보기 URL 생성
+    setPreview(url)
+    onChange(url) // RHF 상태 업데이트
+
+    // 서버 업로드용 파일을 상위로 전달
+    if (onFileChange) onFileChange(file)
+
+    // 같은 파일 다시 선택할 수 있도록 초기화
+    if (inputRef.current) inputRef.current.value = ''
+  }
+
+  // 이미지 삭제 처리
+  const handleDelete = () => {
+    if (preview && preview.startsWith('blob:')) {
+      URL.revokeObjectURL(preview) // 메모리 누수 방지
+    }
+    setPreview(null)
+    onChange(null) // RHF 상태 초기화
+    if (inputRef.current) inputRef.current.value = ''
+  }
+
+  return (
+    <div className="relative size-182 basis-182">
+      {/* 파일 선택 트리거 역할 */}
+      <label
+        htmlFor="userProfile"
+        className="BG-gray group relative flex size-full cursor-pointer items-center justify-center overflow-hidden rounded-lg"
+      >
+        {preview ? (
+          <>
+            {/* hover 시 연필 아이콘 */}
+            <div className="absolute inset-0 z-10 flex items-center justify-center bg-black/30 opacity-0 transition-opacity group-hover:opacity-100">
+              <WhitePenIcon size={30} />
+            </div>
+            {/* 이미지 미리보기 */}
+            <Image
+              src={preview}
+              alt="프로필 미리보기"
+              fill
+              className="z-0 object-cover"
+            />
+          </>
+        ) : (
+          // 아무 이미지도 없을 때 Plus 아이콘 표시
+          <PlusIcon className="Text-blue" />
+        )}
+      </label>
+
+      {/* 미리보기가 있을 때 삭제 버튼 표시 */}
+      {preview && (
+        <button
+          type="button"
+          onClick={handleDelete}
+          className="absolute right-5 top-5 z-20 opacity-50 hover:opacity-100"
+        >
+          <CloseCircleIcon className="Text-gray" />
+        </button>
+      )}
+
+      <input
+        id="userProfile"
+        type="file"
+        accept="image/*"
+        className="hidden"
+        ref={inputRef}
+        onChange={handleChange}
+      />
+    </div>
+  )
+}

src/app/features/mypage/hook/useUpdateMyProfileMutation.ts

@@ -0,0 +1,17 @@
+import { useMutation } from '@tanstack/react-query'
+import { AxiosError } from 'axios'
+
+import { User as UpdateProfileResponse } from '@/app/shared/types/user.type'
+
+import { updateMyProfile } from '../api/mypageApi'
+import { UpdateProfileRequest } from '../types/mypage.type'
+
+export function useUpdateMyProfileMutation() {
+  return useMutation<
+    UpdateProfileResponse,
+    AxiosError | Error,
+    UpdateProfileRequest
+  >({
+    mutationFn: updateMyProfile,
+  })
+}

src/app/features/mypage/hook/useUploadProfileImageMutation.ts

@@ -0,0 +1,11 @@
+import { useMutation } from '@tanstack/react-query'
+import { AxiosError } from 'axios'
+
+import { uploadProfileImage } from '../api/mypageApi'
+import { UploadProfileImageResponse } from '../types/mypage.type'
+
+export function useUploadProfileImageMutation() {
+  return useMutation<UploadProfileImageResponse, AxiosError | Error, File>({
+    mutationFn: uploadProfileImage,
+  })
+}

src/app/features/mypage/hook/useUserQurey.ts

@@ -0,0 +1,10 @@
+import { useQuery } from '@tanstack/react-query'
+
+import { loadUser } from '../api/mypageApi'
+
+export function useUserQuery() {
+  return useQuery({
+    queryKey: ['loadUser'],
+    queryFn: loadUser,
+  })
+}

src/app/features/mypage/schemas/mypageValidation.ts

@@ -0,0 +1,8 @@
+export const mypageValidation = {
+  nickname: {
+    pattern: {
+      value: /^[a-zA-Z가-힣]{1,10}$/,
+      message: '한글 또는 영어만 입력할 수 있으며, 최대 10자까지 가능합니다.',
+    },
+  },
+}

src/app/features/mypage/types/mypage.type.ts

@@ -0,0 +1,8 @@
+export interface UpdateProfileRequest {
+  nickname: string
+  profileImageUrl: string | null
+}
+
+export interface UploadProfileImageResponse {
+  profileImageUrl: string
+}

src/app/globals.css

@@ -78,3 +78,6 @@ body {
 .BG-drag-hovered {
   @apply bg-blue-100;
 }
+.Text-blue {
+  @apply text-[#83C8FA] dark:text-[#228DFF];
+}