이민기

합류 시점의 코드베이스는 AI 도구로 빠르게 구축된 MVP 단계로, 도메인 간 책임 경계가 불명확하고 중복·미사용 코드가 누적되어 변경 영향 범위를 예측하기 어려운 상태였습니다.
프론트엔드 2인 팀에서 구조 전환을 제안하고, 레거시 모듈을 FSD 기반 계층형 아키텍처로 재구성하며 기능 단위의 점진적 마이그레이션과 공통 라이브러리 추상화를 병행했습니다. 그 결과 10만 줄 이상의 레거시 코드를 제거하고 앱 번들 크기 15%(37MB → 32MB), gzip 크기 17%(12.1MB → 10.1MB)를 줄였으며, 변경 영향 범위를 기능 단위로 분리해 구조적 복잡도를 낮췄습니다.

단독 실행만 지원하던 제품을 다른 팀이 운영하는 기존 Module Federation 호스트에 Remote App으로 편입했습니다.
빌드 타임의 번들 구성과 런타임의 라우팅·초기화 방식 차이를 공통 인터페이스로 분리하고, 비즈니스 로직이 실행 환경에 직접 의존하지 않도록 구조를 재설계했습니다.
호스트와 shared 의존성·번들러를 맞추기 위해 Vite에서 Rspack으로 전환하며 빌드 시간을 75% 단축(22.3초 → 5.6초)했고, 하나의 코드베이스로 단독 실행과 통합 실행을 일관되게 운영할 수 있게 했습니다.

초기 렌더링 지연을 개선하기 위해 29MB 규모의 단일 벤더 파일과 다국어 리소스 로딩 방식을 주요 병목으로 보고, 리소스 로딩 구조를 재설계했습니다. 벤더 파일을 도메인별로 분리하고 i18n 리소스 동적 지연 로딩을 적용해, 초기 렌더링 시간을 약 62% 단축(1.2초 → 0.45초)했습니다.

구조를 정리한 뒤에도 같은 문제가 다시 쌓이지 않도록, AI 도구를 활용한 코드 작성 과정에서 발생할 수 있는 일관성 저하와 잠재적 결함을 구조적으로 차단하는 자동화된 검증 파이프라인을 구축했습니다. 모듈 간 의존성 검사, 정적 분석, 테스트 기반 오류 감지를 커밋 단계에 통합하여 일정 기준을 충족한 코드만 원격 저장소에 반영되도록 제한했습니다. 이를 통해 코드 리뷰에 소모되는 리소스를 줄이고, 빠른 개발 속도를 유지하면서도 프로덕션 수준의 코드 안정성을 확보했습니다.

기획 단계에서 블록체인 도메인 지식이 팀 내에 충분히 축적되지 않은 상태였습니다.
블록·트랜잭션·스마트 컨트랙트의 데이터 구조와 상호 관계를 정리해 기획자와 공유하고, 화면에 노출할 용어 체계와 정보 위계, 탐색 흐름을 직접 정의했습니다. 요구사항 정의와 구현을 하나의 기준으로 이어, 도메인 개념과 화면 구조가 어긋나지 않도록 했습니다.

신규 프로젝트의 구조를 처음부터 설계하면서, 인증·블록·트랜잭션 등 여러 도메인을 동시에 진행해야 하는 상황을 전제로 구조를 잡았습니다.
비즈니스 로직·엔티티·위젯을 기능 단위로 분리하는 Feature-Sliced Design(FSD)을 적용해 도메인 간 의존을 끊고, 순수 UI 컴포넌트에는 Atomic Design Pattern을 적용해 화면 조합 단위를 재사용할 수 있도록 했습니다. 그 결과 도메인별로 독립적으로 작업하고 검증할 수 있어, 기능이 늘어도 기존 코드를 되짚는 범위가 넓어지지 않도록 했습니다.

솔루션 문서 애플리케이션과 어드민 프론트엔드가 같은 UI를 공유해야 해, TurboRepo 기반 Monorepo로 앱과 공유 패키지를 분리했습니다. 디자인 시스템을 독립 패키지로 떼어내 Storybook으로 문서화하고, TypeScript·ESLint·TailwindCSS 설정까지 공용 패키지로 분리해 앱이 늘어도 동일한 규칙과 UI를 유지할 수 있도록 했습니다. 공용 컴포넌트 패키지에는 Jest와 Testing Library로 테스트를 붙여 80% 이상의 커버리지를 확보했습니다.

블록·트랜잭션·계정 데이터를 목록과 상세로 나누어 탐색하는 익스플로러를 구현했습니다. 스마트 컨트랙트는 파일 업로드, 컴파일 결과 확인, 배포 파라미터 설정을 단계별 화면으로 구성해 Admin에서 컴파일과 배포를 실행할 수 있도록 했습니다.

블록체인 기반 보안 토큰을 관리하는 시스템으로, 사용자·컨트랙트·트랜잭션 도메인이 MongoDB·NATS·블록체인 등 서로 다른 외부 시스템에 동시에 얽히는 구조였습니다.
외부 연동 코드가 비즈니스 로직에 섞이지 않도록 api·application·domain·infrastructure 계층을 분리하고 의존성 주입과 인터페이스 추상화를 적용했습니다. 저장 형태와 도메인 개념이 함께 바뀌지 않도록 DB Entity와 Domain Entity를 분리해, MSA 환경에서 NATS로 수신되는 컨트랙트·트랜잭션 이벤트를 도메인 규칙에 맞게 변환해 저장하도록 했습니다.

Express와 TypeScript 기반으로 인증·사용자·컨트랙트·트랜잭션·파일 5개 도메인 20여 개의 REST API를 설계·구현했습니다. 요청 검증 로직이 컨트롤러에 흩어지지 않도록 Joi 기반 검증 미들웨어를 도메인별로 구성하고, JWT 인증·인가와 일관된 에러 응답 포맷을 적용해 API 동작을 예측 가능하게 만들었습니다.

어드민에서 스마트 컨트랙트를 직접 다룰 수 있도록 solc 기반 컴파일 파이프라인을 구현했습니다. OpenZeppelin 등 외부 라이브러리의 import 경로를 해석하는 콜백을 직접 구성하고, 컴파일 산출물인 ABI·bytecode를 저장해 재사용할 수 있게 했습니다. 배포·실행·조회를 각각 독립된 유스케이스로 분리하고, 컴파일 오류는 API 에러 포맷으로 변환해 프론트엔드에서 실패 원인을 그대로 확인할 수 있도록 했습니다.

데이터베이스나 외부 시스템 상태에 의존하면 도메인 로직 검증이 불안정해질 수 있다고 보고, Jest와 Mock 객체로 사용자 등록·인증 등 주요 로직을 인프라와 분리해 독립적으로 검증했습니다. 운영 중 서버 상태를 확인할 수 있도록 Prometheus 메트릭 수집을 연동하고, 빌드 단계에서 API 문서를 자동 생성해 프론트엔드와의 연동 기준을 코드와 일치시켰습니다. 여러 Node.js 서비스가 공통으로 쓰는 코드는 npm·Nexus 사설 저장소로 패키지화해 버전 일관성을 유지하며 재사용할 수 있도록 했습니다.

PASS 앱 안에서 동작해야 했지만 OS마다 웹뷰 엔진이 달라(Android는 Chrome WebView, iOS는 WebKit) 같은 코드가 어떤 환경에서 실행될지 사전에 확정할 수 없었습니다.
실행 환경을 런타임에 판별하는 훅을 만들어 앱 내부와 일반 브라우저를 구분하고, 계약서 다운로드처럼 환경마다 동작이 다른 기능은 네이티브 브릿지 호출과 웹 표준 방식 두 갈래로 분기해 구현했습니다. 로딩 표시나 웹뷰 종료처럼 앱이 제어해야 하는 동작도 브릿지로 위임해, 하나의 코드베이스로 두 환경을 모두 지원하도록 했습니다.

촉박한 일정에 맞춰 화면을 먼저 구현하다 보니 컴포넌트가 혼재되어 변경 비용이 커지고, 디자인과 구현물 간 피드백도 늦어졌습니다.
공통 UI를 Atomic Design Pattern으로 계층화하고 Storybook에 59개 컴포넌트 스토리를 구성해 디자이너와 구현물을 같은 화면에서 확인할 수 있게 했습니다. 또한 Jest와 React Testing Library로 주요 화면 16개에 테스트를 작성해 95% 이상의 테스트 커버리지를 확보했습니다.

전자계약의 진위성과 무결성을 어떻게 증명할지 정의하고 서비스 흐름에 반영하는 작업을 주도했습니다.
원본 문서와 완성 계약서의 해시를 각각 보관하고, 서명자마다 서명 시점의 문서 해시와 서명 이미지 해시를 함께 기록하도록 설계해 서명 순서에 따라 계약 상태를 검증할 수 있는 구조를 만들었습니다. 화면에서는 식별정보를 직접 비교하지 않고 해시로 대조해 본인의 서명 영역을 판별하도록 구현했습니다.

초기 개발 일정상 여러 외부 라이브러리를 혼용해 초기 렌더링 속도가 저하되어, 컴포넌트 스타일링을 일원화하고 이미지 최적화·레이지 로딩·코드 스플릿팅을 적용했습니다. 이를 통해 초기 로딩 시간을 약 68% 단축(4.1초 → 1.3초)하고 Lighthouse 성능 점수를 65점에서 94점으로 높였습니다.

자체 네트워크 구성을 검증하기 위해 Cosmos SDK v0.50.1 기반으로 체인을 구성하고 chain-id·denom·스테이킹 파라미터를 목적에 맞게 조정한 뒤, 사내 PC 기반 Ubuntu Linux 환경에서 밸리데이터 노드 4대와 RPC 노드 2대를 연결한 P2P 테스트넷 인프라를 구축했습니다. 또한 PingPub 대시보드를 연결해 테스트 네트워크의 노드 상태를 실시간으로 확인할 수 있도록 했습니다.

다양한 OS 환경에서 노드를 일관되게 실행할 수 있도록 Makefile 기반 바이너리 빌드와 Shell 스크립트 기반 설치 자동화를 구성했습니다. 이를 통해 반복적인 노드 설치 과정을 표준화하고 테스트넷 구성 시간을 줄였습니다.

기존 카드 태깅 방식은 인증 수단이 분실되거나 양도되면 본인 여부를 확인할 수 없다는 한계가 있었습니다.
이를 신원 증명 문제로 보고, 회사가 Issuer로서 QR 코드를 통해 직원(Holder)에게 VC(Verifiable Credentials)를 발급하고, 직원이 출퇴근 시스템(Verifier)에 VP(Verifiable Presentation)를 제출해 증명하는 출퇴근 인증 프로세스를 설계했습니다. 인증 정보를 중앙 시스템이 아니라 사용자가 보유하는 구조로 두어, 개인정보를 최소한으로 제출하면서 본인을 증명할 수 있도록 했습니다.

설계한 인증 프로세스가 실제로 동작하는지 확인하기 위해 Hyperledger VON·Aries Cloud Agent·Indy Tails Server로 테스트 환경을 구성하는 작업에 참여했습니다. VC 발급과 VP 검증 흐름을 개념 증명(PoC)으로 검증해, 데이터 주권을 사용자에게 두는 신원 인증 구조가 기술적으로 성립한다는 것을 확인했습니다.