일단 뭐라도 해봅시다

1. 투명한 성경책?

Sat, 09 Aug 2025 07:59:55 GMT

1. 프로젝트 소개

1.1 왜 만들었나

우리 교회 목사님은 매주 성경 연구를 하시는데,
한 구절만 봐도 그 구절과 관련된 모든 주석과 자료를 다 읽고 준비하십니다.
그 과정에서 자료를 찾고, 열고, 비교하는 데 시간이 정말 많이 걸립니다.

그래서 생각했습니다.
“성경 한 구절만 입력해도, 그 구절과 연관된 수많은 자료와 논문을 한 번에 찾을 수 있으면 얼마나 좋을까? 담임목사님이 어린 시절 꾸신 꿈에 투명한 성경책을 봤는데, 책이 덮여있어도 투명하기 때문에 한눈에 성경 전체가 보였다고 하셨는데, 그걸 기술로 만들 수 있지 않을까?”

그게 바로 투명한 성경책입니다.
성경 본문을 절(verse) 단위로 저장하고,
질문이나 구절을 입력하면 관련 절과 자료를 한 번에 검색해서 보여주는 시스템입니다.
AI는 해석을 최소화하고, 근거 중심으로만 답합니다.

1.2 목표

투명성: 항상 출처(장:절)와 자료 목록을 같이 제시
정확성: 근거 데이터 내에서만 답변, 해석 최소화
편의성: 인터넷 없이 로컬에서 동작(Ollama 기반)
확장성: 성경 외에도 신학 논문, PDF, 설교문까지 검색 가능
심화 기능: 특정 구절에 대한 자료를 견해별로 그룹화하여 보여주기

1.3 주요 특징

특징	설명
절 단위 검색	성경은 절이 의미 최소 단위 → 절 단위로 색인
로컬 LLM	`gpt-oss:20b`를 Ollama로 구동, API 비용 X
벡터 검색	FAISS로 빠르고 정확한 임베딩 기반 검색
출처 필수	답변 끝에 항상 해당 절과 자료 출처 표시
견해별 그룹화	검색된 자료를 해석/주제별로 묶어 정리

1.4 어떻게 작동하나

사용자가 구절이나 질문 입력
예: “요한복음 3:16-20에 대한 자료를 모두 찾아줘, 그리고 견해별로 그룹으로 묶어 알려줘”
시스템이 입력을 벡터로 변환(임베딩)
FAISS에서 관련 절/자료 Top-K 검색
LLM이 검색 결과를 읽고 비슷한 견해끼리 그룹을 만듦
각 그룹은 그룹명, 내용 요약, 출처 목록을 포함
최종 결과를 사용자에게 전달

1.5 결과 예시

[요한복음 3:16-20에 대한 자료]

1. 구원론 중심 해석
   - 하나님이 세상을 사랑하여 구원을 베푸신다는 관점
   - 출처: 주석 A, 논문 B

2. 사랑과 헌신 강조
   - 믿는 자가 하나님의 사랑을 깨닫고 삶으로 실천해야 한다는 관점
   - 출처: 주석 C, 설교문 D

3. 심판과 빛/어둠 대비
   - 진리를 따르는 자와 그렇지 않은 자의 구분
   - 출처: 논문 E, 주석 F

1.6 기대 효과

목사님이 구절별로 주석·논문·자료를 찾는 시간을 대폭 단축
필요한 구절과 관련 자료를 한 번에 모아서 보여줌
AI가 아는 척 없이, 신뢰도 높은 근거 기반 답변 제공
연구자·설교자·성경 공부 모임 모두 활용 가능
다양한 관점을 한눈에 비교 가능 → 토론/연구 효율 상승

[python] pip 미러서버 패키지 없음 - ERROR: Could not find a version that satisfies the requirement

Wed, 12 Mar 2025 04:33:10 GMT

Topic

기본적으로 pip install을 하면 공식서버에서 패키지들을 다운받게 되는데 공식서버는 해외에 있기 때문에 속도가 느릴때가 많습니다. 그래서 보통 한국에서는 카카오 서버 등을 공식서버를 대신해 미러서버로 사용하게 되죠.

Problem.

그런데 가끔씩? 아니 좀 자주.. 미러서버에 내가 쓰고 싶은 패키지 버전이 없을 때가 있습니다. 보통 최신버전이 없을 때가 많아서, 그동안 큰 문제가 안되었는데 오늘은 openmanus를 돌려보려는 과정에서 패키지가 없다하여, 이 문제를 해결해야 했습니다.

Question?

pip install에 대한 try catch 같은게 있지 않을까 생각을 하며 GPT 선생님께 여쭤보았습니다. 당연히 있더라구요. 기본은 속도가 빠른 미러서버를 쓰고, 없는 패키지 버전에 대해서만 공식서버를 사용하게 하는 것이 가능했습니다.

Answer!

pip에 대한 config 생성
```
mkdir -p ~/.pip
vi ~/.pip/pip.conf
```

config 작성

[global]
index-url = https://mirror.kakao.com/pypi/simple
extra-index-url = https://pypi.org/simple

이렇게 하면 기본은 카카오로 사용하고, 없을 경우에만 공식서버를 사용하게 되어 패키지 not found는 이제 보기 어렵게 됩니다. Good luck!

[ React ] onChange={this.onChangeSelectValue()}

코드가 위와 같이 되어있다면 딱히 이벤트가 없어도 onChangeSelectValue는 계속 call 될 수 있다. 그럴 땐 아래와 같이 onChange를 event로 감싸보자. 그렇게 하면 event가 일어날 때만 로직이 call된다.

통통 튀는 Spring-boot 2. DB 연동

Thu, 26 Aug 2021 11:33:00 GMT

1. Hello World!

기본 세팅을 했으니 모든 개발의 꽃인 Hello World!를 찍어보죠. 여기서부턴 드디어 뭔가 코드를 적게됩니다. 어렵지 않으니 천천히 따라하시면 됩니다.

프로젝트 폴더의 resources/static 폴더에 index.html 파일을 생성합니다. 파일을 생성하는 방법은 해당 폴더를 오른쪽 클릭해서 new -> file 누르시고 이름을 index.html로 정해주시면 됩니다.

index.html에 들어갈 코드입니다. 복사해서 붙여넣으세요.



    
       
        Index
    
    
        Hello World!

spring 프로젝트에서 resources 폴더에는 이름 뜻 그대로, 프로젝트의 "자원"이 될 수 있는 이미지나, html파일 등이 들어가게 됩니다. 이를 보통 정적(변하지 않는) 리소스라고 합니다.

이렇게 넣으신 후 서버를 껐다 키시고 (정지 눌렀다가 재생버튼 다시 누르시라는 말입니다) localhost:8080 에 가시면 우리는 World에 Hello를 외칠 수 있습니다.

2. MVC 패턴?

"여러분은 이제 spring 프로젝트로 Hello World를 시전한 어엿한 개발자가 되었습니다~ 축하드립니다!" 라고 하고 싶지만 그러면 맞을 수 있습니다. 이제 진짜 개발자처럼 보이기 위해서 MVC에 대해서 배워보죠.

MVC는 Model-View-Controller의 약자입니다. 이게 뭐냐 하고 물으신다면, 대답해드리는 것이 인지상정이겠죠? 간단하게 설명드리자면 아래와 같습니다.

Model : 프로젝트에서 실제 계산/비즈니스 로직이 일어나는 곳입니다. View: 프로젝트의 view, 말 그대로 화면입니다. Controller : Model과 View 사이에 껴서 데이터를 컨트롤 하는 곳입니다.

예시로 설명을 드릴게요. 지금 저희가 만들려고 하는 프로젝트에 글을 등록하는 기능을 저희가 구현해야 한다고 생각을 해봅시다.

맨 먼저 유저는 글쓰기 화면에서 글을 씁니다. 여기서 화면에 해당하는 곳이 View 입니다. 그리고 글을 다 쓰고 "저장" 버튼을 누르는 순간, 작성한 글 데이터는 API를 통해 스프링이 돌아가고 있는 서버로 전송됩니다.

여기서 이 "글 데이터"를 서버에서 처음 받는 곳이 Controller 입니다.

컨트롤러는 데이터를 받아서, 실제 DB에 글 데이터를 입력하는 곳으로 보내줍니다. 여기가 Model입니다. 그리고 컨트롤러는 다시 '작성완료 되었다'는 내용을 받아서 화면에 넘겨줍니다.

그래서 최종적으로 유저는 "글 저장 완료!" 라는 화면을 보게 되는 것이죠.

MVC 패턴은 서로 분업을 해서 효율적으로 일을 처리하기 위한 하나의 구조라고 할 수 있습니다.

3. MVC를 작성해보자

controller 패키지를 생성합니다. 그리고 새로운 자바 파일을 만들어서 MyController라고 해줍니다. 단, 패키지를 생성하실 때, 사진처럼 맨 뒤에 controller라고 붙여줘야 합니다. 패키지 경로여서 다 지우고 쓰시면 안됩니다. 그리고 자바파일은 기본적으로 첫 글자가 대문자로 시작해야합니다.

MyController.class 파일 내용

여기서 @로 시작하는 코드는 어노테이션(Annotation)이라고 하는데, Spring에서 해당 코드가 어떤 역할을 하는지 찾기 편하게 달아주는 이름표라고 생각하시면 됩니다. 얘는 컨트롤러니까 @Controller 라고 이름을 달아주죠. @getMapping("url")은 get 방식이면서 "url"로 들어오는 요청에 대한 처리를 여기서 한다는 의미입니다. 자매품 @postMapping도 있습니다.

package com.eden.todoTest.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class MyController {

    @GetMapping("/")
    private String helloWorld(){
        return "index.html";
    }
}

이렇게 세팅하고 껐다 키시면, 익숙한 헬로월드를 보게 되실겁니다.

3. 드디어 DB!

드디어 말로만 듣던 데이터베이스(DB)라는 녀석을 다룰 차례입니다. 앞으로는 디비라고 할게요 ~~길고 한영도 귀찮으니~~. 일단 우리는 아는게 없으니, 디비의 개념부터 간단히 알아볼게요. 일단 우리가 웹사이트나 앱을 이용할 때, 1회용 데이터가 아닌 모든~ 데이터를 보관하는 저장소가 디비의 역할입니다. 자 이제, 디비를 만들어볼까요? 디비의 종류는 정말 많지만 크게 SQL을 쓰냐 안쓰냐로 갈립니다. 저희는 여기서 SQL디비 중에 mysql 계통인 mariaDB를 쓸거에요. 이유는 무료이기 때문이죠!

⬇️ MariaDB 설치는 아래의 링크를 참고해주세요 ⬇️

WINDOW - mariaDB 설치 MAC - mariaDB 설치

자 디비는 잘 설치하셨죠? 모르면 댓글 남겨주시거나 구글에 "mariaDB 설치" 검색하시면 많이 나오니까 링크 참고하셔서 진행해주세요. 앞으로 "개발에 관련된 검색은 무조건 GOOGLE!" 이거 명심해주세요. 설치가 되셨으면 터미널에 명령어를 한번 입력해보죠. 제대로 설치가 잘 되었다면 설치한 버전 정보가 나올거에요(버전은 저랑 달라도 상관없습니다). 여기까지 되셨으면 디비 설치 완료! 축하드립니다 ㅋㅋ 이제 다음 글에서 디비를 제대로 써보죠.

$ mysql --version

통통 튀는 Spring-boot 1. 시작하기

Fri, 24 Jul 2020 02:56:24 GMT

0. 스프링은 처음입니다만,

안녕하세요. 여러분과 함께 삽질을 시작할 에덴입니다. 저는 주로 node, vue와 같이 js를 주로 다루다가 필요에 의해 스프링을 시작하게 되었습니다. 저도 오래 전 학원에서 잠깐 들춰본 것 외에 스프링은 처음입니다. 그래서 다른 분들 포스트에 비해 정확하지 않을 수 있으니, 부족한 점은 언제라도 말씀해주시면 바로 수정하겠습니다.

1. 과연 할 수 있을까?

하나. 아래의 기술 스택을 가진 TO-DO 서비스를 만든다. 하나. 될 때까지 포기하지 않는다!!!!!!!! -> 이게 제일 중요합니다. 제가 포기하지 않길..

기술스택 :

Bankend : spring-boot + jpa, graphQL Frontend : React + Apollo, Antdesign DB: MySQL(MariaDB) deploy : AWS

2. 삽질의 시작 - 작업준비

자, 이제 Spring-boot 프로젝트를 시작해보죠! 기존의 Spring 프레임워크는 정말 세팅하는데 하루종일 걸렸어요. xml 기반의 세팅은 정말 끔찍했고 뻑하면 빈을 찾을 수 없었다고 합니다만 ~~그건 제 탓입니다.~~ 다행히도 요즘 많이 사용하고 있는 spring-boot는 이니셜라이져라는 툴을 제공함으로 단 3분만에 기본 프로젝트를 구축할 수 있게 해주었습니다. Thx God!

스프링부트 이니셜라이져 링크

이 링크로 가면 간단한 설정만으로 세팅된 프로젝트 파일을 다운받을 수 있습니다. 먼저 프로젝트 세팅에서 캡처와 같이 작성하고, 단 영어로 작성해야합니다. 그리고 ADD 버튼을 눌러 부가 라이브러리들을 추가해준다음, 다 끝나면 Generate 버튼을 눌러 다운받으시면 세팅 끝!

그리고 저는 여기서 IDE(코드편집기)로 인텔리제이를 사용할 예정입니다. 최애인 vscode를 사용하고 싶었지만, 자바에는 인텔리가 더 최적화가 잘되어 있는듯하네요;; 여러분 편한거 쓰시면 됩니다만, 따라하기 편하시려면 같은 툴 쓰시는게 나을거에요. 인텔리는 저도 아직은 30일 체험판 쓰니까 다운받고 30일안에 끝내시면 됩니다 ㅋㅋ

인텔리제이 다운

3. 한번 켜봅시다

이니셜라이져로 다운받은 파일을 압축풀고, IDE로 실행하면 아래와 같은 화면을 만나게 되실거에요. 기본 빌드 끝나고 나면 우측 상단의 그냥 빨간 네모로 표시한 재생버튼 눌러주세요. 그러면 자동으로 스프링이 켜져야 하는데.. 그렇지 않고 아마 이런 에러를 만나시게 될겁니다?

"이런 에러" : 에러의 내용을 간단히 설명드리자면, "너 JPA쓴다며, 쓸려면 url을 줘야지 왜 안줘?" 입니다. 그래서 우리는 "알겠어 안쓰면 되잖아"로 대답을 하면 문제가 해결됩니다. - JPA는 나중에 DB를 다룰 때 사용합니다.

그러면 당황하지 않고 build.gradle 파일을 열어서 jpa 라이브러리를 // 으로 일단 주석처리 해주시면 됩니다. 그리고 build.gradle파일을 수정하면 옆에 코끼리 아이콘이 나올거에요. 코끼리가 다시 빌드해주는 친구입니다. 코끼리를 누르면 수정된 내용으로 다시 빌드를 합니다. 그리고 재생 버튼을 누르면 정상적으로 스프링이 실행됩니다. 스프링이 실행되면 맨 밑줄에 이렇게 나옵니다.

Started TodoTestApplication in 1.163 seconds (JVM running for 1.578)

이걸 확인하시고 인터넷 창을 여셔서 localhost:8080 을 입력하시면 이렇게 에러가 나오게 됩니다. 아직 지정해준 내용이 없으니 당연한 에러입니다. 여기까지 나오셨으면 기본 내용은 성공이니 다음으로 넘어가시면 됩니다.