Back to the Basics Back to the Basics

전자정부 표준프레임워크(eGovFrame)는 단순한 템플릿 수준을 넘어, 현업 시스템 개발에서의 효율성과 확장성을 높이기 위해 다양한 **공통컴포넌트(Common Components)**를 제공하고 있습니다. 이번 화에서는 공통컴포넌트의 구조, 종류, 실제 활용 방식, 그리고 현업에서 어떻게 확장해 적용할 수 있는지에 대해 집중적으로 다뤄보겠습니다. 공통컴포넌트란 무엇인가? 전자정부 표준프레임워크에서 공통컴포넌트란, 반복적으로 사용되는 기능을 재사용 가능하게 설계한 범용 모듈을 의미합니다. 예를 들어, 사용자 인증, 파일 업로드, 메일 전송, 게시판, 일정관리, 코드 관리 등은 대부분의 시스템에서 유사한 형태로 반복됩니다. 이러한 기능을 매번 새로 개발할 필요 없이 재사용하도록 만든 것이 바로 공통컴포..

FastAPI에서 CORS(Cross-Origin Resource Sharing) 정책을 설정하고, HTTP 보안 헤더를 적용하는 방법을 설명합니다. 프론트엔드 연동과 API 보안 강화를 위한 실전 설정 예제를 포함합니다.1. 왜 CORS 설정이 필요한가?브라우저 기반의 프론트엔드가 외부 API 서버와 통신하려고 할 때,서버가 CORS 정책을 명시적으로 허용하지 않으면 요청이 차단됩니다.예를 들어,Vue/React 앱이 http://localhost:3000에서 실행되고FastAPI 백엔드가 http://localhost:8000에 있다면다른 도메인 간 요청이므로 반드시 CORS 허용 설정이 필요합니다.2. FastAPI에서 CORS 설정 방법FastAPI는 Starlette의 미들웨어 구조를 그대로 사..

Spring Boot의 @Profile, application-{profile}.yml, 외부 설정 등 다양한 프로파일 기반 구성 전략을 정리합니다. 운영 환경 분리에 따른 실무 적용 예제도 포함되어 있습니다. Spring Boot는 다양한 실행 환경(개발, 테스트, 스테이징, 운영 등)에 맞춰 설정을 유연하게 분리하고 적용할 수 있도록 프로파일(Profile) 기능을 제공합니다. 실무에서는 이 기능을 얼마나 잘 활용하느냐에 따라 프로젝트의 유지보수성과 안정성이 크게 달라집니다. 이번 글에서는 프로파일을 기반으로 한 구성 전략을 심층적으로 파헤쳐봅니다.1. 프로파일이란 무엇인가?Spring의 프로파일은 조건부 Bean 등록 및 설정 파일 분리를 가능하게 해주는 기능입니다.예를 들어, 개발 환경에서는 H2..

Spring AI에서 Chroma Vector DB를 연동해 RAG 시스템을 구성하는 방법을 실습 중심으로 소개합니다. 문서 인덱싱, 벡터 저장, 유사도 기반 검색, LLM 응답까지의 전체 파이프라인을 구성합니다. 이전 글에서 우리는 RAG의 구조와 Vector Store의 역할에 대해 분석했습니다.이번 글에서는 그 개념을 실제 코드로 구현해보는 단계입니다.Spring AI가 제공하는 Chroma 연동 기능을 활용해 문서를 벡터로 저장하고,유사 문서를 검색한 뒤 LLM에 전달하는 전 과정을 구현해보겠습니다.개발 환경 준비Java 17+Spring Boot 3.2.xSpring AI 0.8.0Chroma (로컬 실행)OpenAI 또는 Hugging Face API 키1. 의존성 추가Chroma와 Embed..

트랜잭션 처리는 단순히 @Transactional 어노테이션을 붙이는 것으로 끝나지 않습니다. 실제 서비스 로직이 복잡해질수록 트랜잭션의 “전파(propagation)”와 “고립 수준(isolation level)”을 이해하고 적절히 사용하는 것이 중요해집니다. 이 글에서는 두 개념을 하나씩 짚어보며, 실전에서 어떤 상황에 어떤 전략을 택하는 것이 좋을지 깊이 있게 살펴보겠습니다. 트랜잭션 전파(Propagation) – 어떤 트랜잭션을 따를 것인가? 스프링은 메서드 실행 시, 현재 트랜잭션이 존재하는지 여부에 따라 새로운 트랜잭션을 생성하거나 기존 트랜잭션을 이어받는 전략을 Propagation 속성으로 제어할 수 있게 합니다. 자주 쓰는 전파 전략전파 옵션설명실전 사용 예REQUIRED기본값. 기..

RAG(Retrieval-Augmented Generation)는 외부 지식과 LLM을 결합해 보다 정확한 응답을 생성하는 대표적인 아키텍처입니다. 본 글에서는 RAG의 개념과 핵심 요소인 Vector Store의 구조와 역할, Spring AI에서의 구현 방식을 심층적으로 분석합니다. RAG, 이제 선택이 아닌 기본 전략이 되다 LLM을 활용한 서비스에서 자주 나오는 요구사항이 있습니다. “GPT에게 우리 회사 메뉴얼을 학습시켜야 합니다.”“PDF 문서를 기반으로 답을 해줬으면 해요.”“특정 용어는 우리 업계 기준에 맞게 설명되었으면 좋겠어요.” 이런 요구는 단순한 텍스트 생성만으로는 충족되지 않습니다.바로 이때 등장하는 전략이 **RAG(Retrieval-Augmented Generation)**입니..

스프링에서 자주 사용하는 @Controller와 @RestController, 그리고 @RequestMapping 애노테이션이 DispatcherServlet과 어떻게 연결되고 처리되는지 흐름 중심으로 설명합니다. @Controller와 @RestController는 뭐가 다른가요? 가장 간단히 정리하면:애노테이션반환 방식용도@Controller뷰 이름웹 페이지 응답 (HTML)@RestControllerHTTP 본문(JSON 등)API 응답즉, @RestController는 사실상 아래 두 가지의 합성입니다.@RestController== @Controller + @ResponseBody DispatcherServlet과 어떻게 연결될까? Spring MVC가 내부적으로 요청을 처리할 때, Dispa..

Spring MVC에서 요청이 들어오면 어떤 경로를 따라 응답이 만들어질까요? DispatcherServlet을 중심으로, HandlerMapping, Controller, ViewResolver까지의 흐름을 자연스럽게 정리합니다.Spring MVC의 진짜 시작점은?우리는 보통 컨트롤러부터 코드를 쓰기 시작합니다.@GetMapping("/hello")public String hello() { return "hello";}근데 정말 이게 전부일까요?이렇게 작성된 코드는 어떻게 실행되고, 어떻게 우리가 작성한 뷰 이름을 찾아가는 걸까요?그 중심에는 바로 DispatcherServlet이 있습니다.사실상 Spring MVC의 모든 요청은 DispatcherServlet을 거쳐서 흐릅니다.Dispatche..