넥스트리

VIZEND DAY WORKSHOP

company Pinned Post

VIZEND DAY WORKSHOP

확신을 설계하고, 가치를 실현하는 넥스트리

company Pinned Post

확신을 설계하고, 가치를 실현하는 넥스트리

다양한 도메인에서 쌓아온 실전 경험을 바탕으로, 고도의 안정성과 무한한 확장성을 동시에 갖춘 시스템 엔지니어링을 제공합니다.

React Query Key Factory 패턴 사용기

React Query Key Factory 패턴 사용기

1. 들어가며: 쿼리 키가 왜 중요한가 React Query(TanStack Query)를 처음 도입하면 대부분 이런 식으로 시작합니다. useQuery({ queryKey: ['product-list'], queryFn: fetchProducts }); useQuery({ queryKey: ['product', productId], queryFn: () => fetchProduct(productId) }); useQuery({ queryKey: ['project-health', productId], queryFn: () => fetchHealth(productId) }); 컴포넌트가 몇 개 없을

LLM 코딩 에이전트 작업 관리 방법

LLM 코딩 에이전트 작업 관리 방법

- Task/Plan Harness 적용기 - 1. 들어가며 최근 개발 업무에서 LLM 기반 코딩 도구를 사용하는 비중이 점점 커지고 있습니다. 저도 프로젝트 작업 생산성을 높이기 위해 Codex를 사용하기 시작했습니다. 처음에는 일반적인 방식으로 사용했습니다. 필요한 작업을 프롬프트로 설명하고, LLM이 작성한 결과를 검토한 뒤, 부족한 부분을 다시 요청하는 방식이었습니다. 간단한 수정이나 반복 작업에서는 이

메가 소프트웨어 시대의 암묵지 플랫폼

메가 소프트웨어 시대의 암묵지 플랫폼

서론: 소프트웨어 패러다임의 거대한 변화 인류의 기술 발전 역사는 도구의 진화와 그에 따른 결과물의 규모 확장이라는 일관된 법칙을 따라왔습니다. 과거의 목수는 장인의 숙련된 경험에 의존하여 손망치와 외날톱만을 가지고 집을 지었습니다. 이 시절의 건축은 철저히 개인의 역량에 수렴되었으며, 완성된 건축물은 소규모 단독 주택이나 마을의 작은 창고 수준을 벗어나기 어려웠습니다. 하나의 건물을

Text2SQL 구축 이야기

Text2SQL 구축 이야기

최근 AI 기술의 발전과 함께 데이터 활용 방식에도 큰 변화가 불고 있습니다. 제가 진행하고 있는 프로젝트에서도 LLM을 활용한 여러 기능들의 요구사항과 아이디어가 넘치고 있습니다. 그중 비즈니스 현업에서 쏟아지는 수많은 데이터 추출 요청(Ad Hoc)을 어떻게 하면 더 빠르고 정확하게 처리할 수 있을까에 대한 고민을 해결하기 위해, 'Text2SQL'

React Native 하이브리드 앱 시작하기

React Native 하이브리드 앱 시작하기

1. 들어가며 a. 왜 하이브리드 구조인가 React 웹 개발자가 처음 React Native를 접할 때 가장 먼저 마주하는 고민은 “기존 웹을 어디까지 재사용할 수 있는가”입니다. 모바일 앱을 만든다고 해서 모든 화면과 비즈니스 로직을 React Native로 다시 작성해야 하는 것은 아닙니다. 이미 React 웹 애플리케이션에 라우팅, 권한 처리, 상태 관리, API

대용량 엑셀 OOM 해결기

- SXSSF, FastExcel, StreamingResponseBody 적용 과정 - 1. 들어가며 사내에서 개발한 시스템은 Kafka, NATS JetStream과 유사한 사용성을 제공하는 경량 메시지 브로커 플랫폼의 모니터링 대시보드입니다. Event 메시지의 Pub/Sub 상태를 모니터링하고, Event Entry 로그를 조회하는 기능을 제공합니다. 이 중 Event Entry 로그를 엑셀로 다운로드하는 기능을 개발하면서 OOM 문제가 발생했습니다. 초기에는 일반적인 Apache POI

Redis로 완성한 일회용 코드 SSO

Redis로 완성한 일회용 코드 SSO

- 토큰 직접 노출을 줄이기 위한 임시 코드 발급, 소비, 중복 요청 제어 경험 - 1. 적용 배경 이번 작업은 내부 업무 시스템에서 별도의 수동 로그인 없이 설문 서비스 화면으로 진입할 수 있도록 SSO 흐름을 구성하는 과정에서 시작되었습니다. 사용자는 내부 업무 시스템에서 특정 메뉴나 대상 화면을 선택하고, 서비스 화면으로 자연스럽게 이동해야 했습니다.

프로시저로 끝낸 대용량 마이그레이션

프로시저로 끝낸 대용량 마이그레이션

최근 프로젝트에서 외부 시스템으로부터 유입되는 대용량 데이터를 시스템 내부 마스터 테이블로 안전하고 빠르게 이관(Migration)해야 하는 과제를 수행했습니다. 이 과정에서 마주한 기술적 한계와 이를 PostgreSQL의 Stored Procedure(저장 프로시저) 및 최적화 기법을 통해 어떻게 해결했는지, 상세한 아키텍처와 구현 코드를 바탕으로 공유해보고자 합니다. 1. 기존 애플리케이션(Java/Spring) 레벨 배치

ItemRule 리팩토링

뒤바뀐 필드가 만든 버그와 그 해결 백엔드 리팩토링 1. 들어가며 — 필드 이름이 반대로 저장되어 있었습니다 설문 템플릿 에디터를 통해 ItemRule을 등록하면, 프론트엔드에서 실제 규칙이 의도대로 동작하지 않는다는 버그 리포트가 들어왔습니다. StateRule의 경우 “이 항목이 선택되면 저 항목을 숨겨라”는 규칙을 등록했는데, 실제로는 반대로 동작하는 현상이었습니다. 처음엔 프론트엔드의 조건 평가 로직

API와 Kong Gateway 도입 배경

API와 Kong Gateway 도입 배경

1. 신규 기능 요구사항: 이기종 시스템 간 데이터 연동과 통계 가공 최근 제가 담당하고 있는 서비스에 신규 기능이 추가되었습니다. 타 시스템에 분산되어 있는 데이터를 직접 가져와, 우리 서비스의 목적에 맞게 정제(정리)하고 통계 데이터를 산출하여 사용자에게 직관적으로 보여주는 기능이었습니다. 이 기능을 구현하기 위해서는 두 가지 핵심 과제가 있었습니다. * 데이터

SI 프로젝트 관리

“왜 SI 프로젝트는 항상 막판에 터질까?” 현업 PM이 겪은 SI 프로젝트 5대 리스크와 현실적인 대응 전략 SI 프로젝트는 대부분 비슷하게 시작합니다. 제안 단계에서는 일정도 맞아 보이고, 인력도 충분해 보입니다.아키텍처도 그럴듯하고, 고객도 “잘 부탁드립니다”라고 이야기합니다. 그런데 개발이 50%쯤 넘어가는 시점부터 분위기가 바뀝니다. * 요구사항이 계속 추가되고 * 인터페이스 일정은 미뤄지고

Vizend Dock 리팩터링

Vizend Dock 리팩터링

1. 들어가며 Vizend Dock은 사용자의 인증 정보와 현재 작업 공간 정보를 관리하는 프론트엔드 공통 모듈입니다. 로그인 후 발급되는 access token과 refresh token뿐만 아니라 pavilion, cineroom, stage, actor와 같은 업무 컨텍스트를 보관하고, API 요청 시 필요한 인증 헤더와 Dock 컨텍스트를 interceptor를 통해 전달합니다. 따라서 Dock의 상태가 어긋나면 단순히 화면 한 곳이

Claude Code Hooks 사용 실습

Claude Code Hooks 사용 실습

지난 이론 편에 이어 Claude Code에서 Hooks(훅)을 실제로 등록하고 구동하는 과정을 실습합니다. AI 모델이 프로젝트 내의 파일을 수정할 때마다, 즉 Edit 또는 Write 도구 사용 후 자동으로 안내 메시지를 출력하는 가장 기초적인 포스트 툴 유즈(Post-command) 훅을 구현해 봅니다. 또한 최신 버전에서 변경된 /hooks 슬래시 명령어의 사용법과

Claude Code Hooks의 이해

Claude Code Hooks의 이해

Claude Code의 라이프사이클(생애주기)과 연동하여 특정 이벤트 시점에 작업을 자동 실행하는 Hooks(훅)의 개념과 필요성을 알아봅니다. 모델의 판단이나 기억에 의존하는 일반 프롬프트 및 CLAUDE.md 방식은 AI가 간혹 규칙을 무시할 수 있는 확률적 한계를 가집니다. 이를 보완하기 위해 AI가 반드시 수행해야 하는 규칙을 지정하는 결정적 제어 도구로서의 훅을

무중단 동적 라우팅 구현기

프로젝트 배경과 Spring Cloud Gateway 선택 이유 본 프로젝트는 급변하는 비즈니스 요구사항에 기민하게 대응하고 서비스 간 간섭 없는 개별 확장성(Scalability)을 확보하기 위해 마이크로서비스 아키텍처(MSA)를 전면 채택하였습니다. 특히 도메인별 전문성을 가진 다수의 개발사가 참여하는 '멀티 벤더(Multi-vendor) 협업 구조'로 진행되어 병렬 개발이 이루어졌습니다.

React Email 템플릿과 호환성

React Email 템플릿과 호환성

UI/UX 개발자로 실무를 진행 하면서 수많은 최신 웹 기술의 발전을 체감해 왔습니다. React, Vue.js 같은 프레임워크와 Flexbox, Grid 같은 모던 CSS 레이아웃 덕분에 화면을 구성하는 작업은 과거에 비해 비약적으로 편리해졌습니다. 하지만 단 한 곳, ‘이메일 템플릿’ 영역만큼은 예외였습니다. 이번 반장노트 프로젝트에서 사용자에게 발송되는 3종의 이메일 (아이디 찾기, 비밀번호

비동기 처리로 Markdown 추출 최적화

비동기 처리로 Markdown 추출 최적화

1. 개요 문서 관리 시스템에는 여러 문서의 데이터를 추출하고, 이를 기반으로 추가적인 AI 처리를 수행하는 기능이 존재했습니다. 특히 사용자가 다수의 문서를 선택하면 시스템은 각 문서의 내용을 Markdown 형태로 변환한 뒤 AI 서버로 전달하여 후속 분석이나 가공 작업을 수행하도록 설계되어 있었습니다. 초기 기능 구현 단계에서는 기능 자체를 우선적으로 완성하는 데 초점을

효과적인 커뮤니케이션

1. 프로젝트 성공과 커뮤니케이션 넥스트리의 개발자들은 대부분 프로젝트 조직 안에서 업무를 수행합니다. 즉, 단순히 개인 단위 개발 업무만 수행하는 것이 아니라 다양한 이해관계자와 협업하며 하나의 목표를 향해 움직입니다. 그렇다면 우리는 매번 프로젝트를 성공적으로 완료하고 있습니까? 여기서 말하는 프로젝트 성공이란 단순히 기능을 개발하는 것을 의미하지 않습니다. 정해진 일정 안에서 고객이 만족할

그리드를 넘어 히트맵으로

1. 배경 및 문제 상황 A 프로젝트에서는 사용자 활동 데이터를 연 단위로 시각화하기 위해 365일 히트맵 UI를 구현해야 하는 요구사항이 있었습니다. 처음에는 단순히 “히트맵”이라는 공통 개념만 생각하고 접근하였기 때문에, 프로젝트에 이미 포함되어 있던 ApexCharts를 활용하는 것이 가장 효율적인 선택이라고 판단하였습니다. 이미 운영 중인 차트 라이브러리를 재사용하면 신규 의존성을 추가하지

Legacy 데이터 통합 아키텍처

Legacy 데이터 통합 아키텍처

1. 프로젝트 배경과 데이터 통합의 필요성 현대 기업 경영 환경에서 프로젝트 관리 시스템은 단순 업무 관리 도구를 넘어 기업 운영의 핵심 플랫폼으로 자리잡고 있습니다. 특히 대규모 조직에서는 프로젝트 진행 현황, 일정, 리소스, 관계 데이터 등을 기반으로 다양한 의사결정이 이루어집니다. 이 과정에서 가장 중요한 요소 중 하나가 바로 데이터의 신뢰성과 무결성입니다.

Private Registry SSL 장애 정복

Private Registry SSL 장애 정복

1. 배경 및 문제 상황 최근 프로젝트 운영 중 Kubernetes 환경에서 특정 Pod가 정상적으로 기동되지 못하고 ImagePullBackOff 오류를 반복적으로 발생시키는 상황이 발생하였습니다. 기존에 이미 실행 중이던 Pod들은 문제 없이 정상 동작하고 있었기 때문에 초기에는 Registry 자체 장애가 아닌 것으로 판단하였습니다. 하지만 새로운 Deployment 배포 이후 새롭게 생성되는 Pod들만 지속적으로 이미지

N8n 기반 LLM 검증기 활용

N8n 기반 LLM 검증기 활용

1. 개요 RAG(Retrieval-Augmented Generation) 기반 AI 시스템인 Lakey를 개발하면서 가장 먼저 고민했던 부분은 “LLM의 답변을 얼마나 신뢰할 수 있는가”였습니다. 초기 개발 단계에서는 단순히 문서를 검색하고 LLM이 답변을 생성하도록 구성하였습니다. 하지만 실제 테스트를 진행해보니 몇 가지 문제가 발생하기 시작했습니다. 가장 대표적인 문제는 Hallucination 현상이었습니다. LLM은 실제 문서에 존재하지

SPI를 활용한 Keycloak 커스터마이징

SPI를 활용한 Keycloak 커스터마이징

1. 도입 배경 프로젝트에서 인증 및 권한 관리 시스템을 설계하면서 가장 중요하게 고려했던 요소는 보안의 신뢰성이었습니다. 특히 병원 시스템은 일반 서비스보다 훨씬 더 엄격한 보안 기준을 요구합니다. 환자 개인정보와 의료 데이터를 다루기 때문에 인증 체계의 안정성과 확장성이 매우 중요했습니다. 초기 단계에서는 자체 인증 시스템을 직접 구현하는 방안도 검토하였습니다. 하지만 인증

Site footer