안녕하세요, 이상혁입니다

사내 전자동의서 에디터의 불편한 사용성 문제를 해결하기 위해 MCP(Model Context Protocol)를 도입해 Claude Desktop과 연동한 결과, 기존에 별도 UI 개발이 필요했던 목록 조회, 검색, 분석 기능들을 대화만으로 처리할 수 있게 되어 서비스 기능이 자연스럽게 확대되는 효과를 얻었지만, LLM이 의도한 방향으로 정확히 동작하게 하려면 아직 상세한 가이드가 필요한 상황이다.

이 글은 프론트엔드 공통 코드를 기존의 런타임 API 방식에서 빌드타임 코드 포함 방식으로 전환한 경험을 다룹니다. 빌드타임에 공통 코드를 객체로 변환해 타입 안정성과 자동완성을 높이고, 네트워크 의존성과 유지보수 부담을 크게 줄였습니다. 이로써 초기 화면 속도, 코드 관리 효율, 개발자 경험이 모두 개선되었습니다.

Modal과 Drawer 컴포넌트는 전통적으로 루트에 두고 전역 상태로 제어했지만, 스타일링 문제(z-index 등)가 있었습니다. React의 Portal을 활용하면 부모 DOM 계층을 벗어나 원하는 위치에 컴포넌트를 쉽게 렌더링할 수 있어 이런 문제를 해결할 수 있습니다. 실제 프로젝트에서 Portal을 이용해 Drawer를 구현하니 추가 CSS 없이도 원하는 UI를 손쉽게 만들 수 있습니다.