프론트엔드 포트폴리오 UI/UX 개선, 아키텍처 리팩토링으로 사용자 경험 향상

프론트엔드 포트폴리오 UI/UX 개선, 아키텍처 리팩토링으로 사용자 경험 향상

포트폴리오 페이지의 UI/UX나 아키텍처가 좀 부족하다는 생각이 들 때가 있죠. 저도 이번에 포트폴리오 페이지를 전면 재설계하고 아키텍처를 개선하면서 사용자 경험을 한층 끌어올렸습니다.

시도와 함정

UI/UX를 전면 재설계하고 대대적인 리팩토링을 진행했습니다. 원본 실콘텐츠를 정확하게 반영하고 Riel 플래그십을 강조하는 방향으로 수정했고요. 코드 클릭 2단계 경력과 카드사 AICC LangGraph 케이스 같은 내용을 추가하며 보강했습니다. 이와 병행해서 github.io로 이전하고 최신화하는 작업도 함께 진행했죠.

사실 처음에는 아키텍처 버튼을 제거하는 등 좀 과감한 리팩토링을 시도했는데, 이게 생각보다 복잡한 이슈를 만들어내더라고요.

// 예시: 기존 아키텍처 버튼 관련 코드 (가상)
function renderArchitectureButton() {
  const button = document.createElement('button');
  button.textContent = 'View Architecture';
  button.onclick = () => showArchitectureDetails();
  document.getElementById('header').appendChild(button);
}
// 제거 후 예상치 못한 문제 발생
// renderArchitectureButton(); // 이 코드가 사라지면서...

이런 식으로 기존 구조에 의존하던 부분이 예상치 못한 오류를 발생시켰습니다.

원인

결국 문제는 기존 아키텍처 버튼을 제거하면서 발생한 종속성 문제였습니다. 단순히 UI 요소만 제거하는 줄 알았는데, 해당 버튼이 다른 기능이나 데이터 로딩 로직과 긴밀하게 연결되어 있었던 거죠.

해결

포트폴리오 페이지 UI/UX를 전면 재설계하고 아키텍처를 개선하는 작업을 다시 한번 꼼꼼하게 진행했습니다. 원본 실콘텐츠를 정확하게 반영하고 Riel 플래그십을 강조하는 방향으로 수정했고요. 코드 클릭 2단계 경력 및 카드사 AICC LangGraph 케이스를 추가하며 콘텐츠를 보강했습니다. github.io 이전 및 최신화 작업도 성공적으로 마무리했습니다.

// 개선된 코드 예시 (가상)
// 아키텍처 관련 기능은 별도의 모듈로 분리하거나,
// 필요시 동적으로 로딩되도록 변경하여 의존성 최소화
function initializePortfolioPage() {
loadContent('portfolio-data.json');
renderUIElements();
updateLatestProjects([
{ name: 'Riel Flagship', type: 'Frontend' },
{ name: 'Card AICC LangGraph', type: 'Backend' }
]);
// ... 기타 초기화 로직
}
function renderUIElements() {
// UI 요소 렌더링 로직
// 더 이상 아키텍처 버튼에 직접적으로 의존하지 않음
}
initializePortfolioPage();

이렇게 수정하니 이전 구조에 대한 의존성이 사라지고, UI/UX 개선 작업이 안정적으로 진행될 수 있었습니다.

결과

• 포트폴리오 페이지 UI/UX 및 아키텍처 개선 완료
• 콘텐츠 보강 및 최신화 작업 완료
• 사용자 경험 향상 및 페이지 로딩 속도 개선

정리 — 같은 함정 안 빠지려면

• [ ] UI/UX 개선 시, 기존 아키텍처나 기능과의 종속성을 반드시 파악하고 문서화할 것
• [ ] 대대적인 리팩토링 전, 영향받는 부분을 명확히 정의하고 테스트 계획을 세울 것
• [ ] 코드 변경 시, 관련 로직이 어디에 영향을 미치는지 꼼꼼히 확인할 것