lou@blog $ _

[제주 성산] 도새기 상회 - 흑돼지 구이

Lou Park — Sun, 4 Jan 2026 23:40:34 +0900

성산 일출봉 근처 흑돼지를 먹으러 방문했던 곳이다.

흑돼지 자체가 맛있고 제주도에 워낙 맛있는 흑돼지 집도 많아서 참 고민이 많이되었는데...

성산 일대의 흑돼지 집들중에서 고기 질에대한 리뷰가 가장 좋은 곳은 여기였다.

사장님이 고기를 직접 구워주시는데, 고기 맛이 정말 좋다.

고사리랑 백김치도 같이 구워주고, 찍어먹을 소스도 멜젓에 소금 와사비 쌈장, 갈치속젓, 명란고추마요... 질릴틈이 없다.

그 중에서도 명란고추마요는 고기랑 신선한 조합이었는데, 나는 쭉 여기 찍어먹었다. 또 먹고싶다..

해물된장도 해물이 많이들어가서 아주 시원하다 (비싸긴함)

이번 제주 여행의 1픽이었다.

포이즌 필(Poison Pill) 패턴 : 멀티 스레드 프로세스를 안전하게 종료하는 방법

Lou Park — Sun, 28 Dec 2025 11:48:02 +0900

AI가 만들어낸 코드를 한 줄 한 줄 곱씹어 보던 중에 특이한 패턴을 발견했다.

@classmethod
def stop_processor(cls):
    """백그라운드 처리 스레드 중지"""
    cls._is_running = False
    cls._processing_queue.put(None)

나라면 스레드를 종료하기 위해서 그냥 is_running 플래그만 False로 바꿔놨을 것 같은데, 왜 Queue에다가 None이라는 이상한 값을 집어 넣는걸까?

포이즌 필 패턴

이는 안전하게 스레드를 종료하기 위한 포이즌 필(Poison Pill) 패턴이라고 한다.

Poison Pill

실생활에서 보이는 포이즌 필 패턴 예시가 재미있다.

식당에서 "CLOSED" 사인을 걸어두는 것을 예로들 수 있다. 영업종료 시간이 다가오면 식당주인은 문에 "CLOSED" 사인을 걸어둔다. 이는 더 이상 새로운 손님이 오는 것을 막지만, 지금 가게에 있는 손님들을 내쫓지는 않는다. 그들이 음식을 다 먹고, 계산하고 나갈 수 있도록 한다. 포이즌 필 메세지는 이렇듯 새로운 태스크가 처리되는 것을 막으면서도 현재 태스크를 마무리하고 안전하게 종료될 수 있도록 해준다.

포이즌 필 시퀀스 다이어그램 (https://java-design-patterns.com/patterns/poison-pill)

내 코드에서는 Queue에 들어갈 수 있는 메세지 타입들을 따로 정의한 바가 없었기때문에, AI는 편한 방법으로 "None"을 넣는 것을 택했던 것이다. (이놈!!! 헷갈렸잖아~)

@classmethod
def stop_processor(cls):
    """백그라운드 처리 스레드 중지"""
    cls._is_running = False
    cls._processing_queue.put(None)

@classmethod
def _process_queue(cls):
    """
    큐에서 하나씩 꺼내서 순차 처리
    """
    while cls._is_running:
        try:
            # 리플레이 요청 확인 (1초마다)
            cls.check_replay_requests()

            # 큐에서 항목 가져오기 (1초 타임아웃)
            try:
                item = cls._processing_queue.get(timeout=1)
            except:
                # 큐가 비어있으면 queue.Empty 예외 발생
                continue

            if item is None:
                break  # 종료 신호

            # 튜플이면 (type, entry_id) 형태
            if isinstance(item, tuple):
                item_type, entry_id = item
                if item_type == RouletteStatus.REPLAY.value:
                    cls._replay_roulette(entry_id)
            else:
                # 일반 entry_id
                cls._spin_roulette(item)

            time.sleep(1)
        except Exception as e:
            logger.error(f"룰렛 처리 오류: {e}")

_process_queue는 별도 스레드에서 돌아가는 코드다. 주석에 보이는 것 처럼 item이 None(포이즌 필)인지 체크 후 종료 신호로 판단되면 즉시 루프를 종료한다. 이 코드에서는 큐에서 item을 가져오는 1초동안 스레드가 블로킹이 되는데, 포이즌 필 메세지가 없었다면 다음 사이클에나 종료되었을 것이다. 포이즌 필 메세지로 인해 대기중이던 스레드가 즉시 깨어나서 원하는 타이밍에 안전하게 종료된다.

포이즌 필 패턴 사용시 주의할 점

컨슈머가 여러개인 경우, 컨슈머의 수 만큼 포이즌 필을 넣어주어야한다.

참고 자료
https://java-design-patterns.com/patterns/poison-pill/

DASHI - 치지직 도네이션 연동 룰렛 업데이트

Lou Park — Sat, 27 Dec 2025 23:18:03 +0900

이번에 DASHI에서 업데이트한건 룰렛 기능이다.

예전에 트위치 시절, 투네이션에서 룰렛 기능을 제공했었다. 최소금액이상 후원하면 룰렛 후원에 참여할 수 있고, 방송에 변수를 줄 수 있다.

룰렛 기능을 개발하기 위해서는 생각보다 많은 것이 필요하다.

단순히 채팅 메세지를 받아 룰렛을 처리하는 작업 이외에도 OBS용 오버레이, 스트리머만 접근 가능한 룰렛 관리 화면을 준비해야한다. 예전같았다면 최소 일주일은 잡고 들어갔을테지만, 오늘 나는 10시간만에 모든 작업을 끝내버렸다. 바로, AI의 서포트 덕분이다.

이번 업데이트 회고를 작성하면서 AI와 함께 어떤식으로 개발했는지 공유해보려한다.

장애물 치우기

AI와 개발할때 가장 중요한 점은 일을 단계별로 쪼개야한다는 것이다.

어떤 목표지점에 도착하는게 일이라면 먼저 신발을 점검하고, 장애물을 확인하고, 장애물을 제거하고, 방향을 설정하고 달려야한다.

DASHI는 치지직 API를 통해 폴링하여 방송이 시작되었는지 지속적으로 체크한다. 방송이 시작되면 그때 채팅 서버에 붙어서 채팅 기록, 챗봇 서비스등을 가동시킨다. 방송이 끝나면 채팅 서비스도 마찬가지로 종료하고는 했는데, 이 부분은 방송을 녹화하는 프로세스에 이상이 생겼을때 챗봇의 작동까지도 영향을 주었고, 테스트도 어렵게 만들었다. (챗봇 수정도 직접 방송을 켜서해야했다.) 룰렛 기능이 붙는다면 채팅 메세지에 의해 작동하는 또 하나의 서비스가 생기는거니, 이번에 완전히 방송을 녹화하는 프로세스와 채팅 프로세스를 분리하는 작업이 필요했다. 그래서 룰렛 작업 전 AI를 이용해 dashi_bot이라는 챗봇용 컨테이너를 따로 파서 별도의 프로세스에서 동작하도록 변경해두었다.

기본 구조 만들기

새로 추가할 기능은 "룰렛"이야.
이 기획에 대해 충분히 이해하고, 개발 계획을 짜줘. 내가 빠뜨린 부분은 없는지도 점검해.

1. 룰렛 참여 메세지처리
도네이션할때, 메세지가 "!룰렛"으로 시작할 경우에 룰렛에 참여할 수 있어.
도네이션이 몰릴때 룰렛이 씹히지않도록 큐잉이 필요해.
도네이션에는 고유의 donationId가 있는데, 이를 이용해서 구분하면 될 것 같아. (
donations.json
 참고)
활성화된 룰렛이 없다면 무시하면돼.

2. 룰렛 UI 처리
룰렛은 OBS나 기타 방송프로그램에서 브라우저로 띄울 수 있도록 별도의 페이지에서 돌아가고(배경없이), 슬롯머신 같은 애니메이션이 보여. 누가 룰렛을 돌렸는지도 nickname이 떠야해.

3. 룰렛관리 페이지 처리
- 룰렛에 들어갈 아이템과 확률(%)를 설정
- 룰렛 활성화/비활성화
- InputField로도 설정할 수 있지만, 행간을 구분한 텍스트로도 조정가능한 인터페이스 제공 ex) 잠자기 10\n독서 90
- 룰렛 당첨 히스토리 제공

허접하지만 룰렛 기능을 위한 첫 프롬프트는 이랬다.
처음에는 기본 구조를 잡는게 중요하다. 처음 프롬프트에서 세부적인 디테일(e. g. 룰렛이 비활성화 되었을때 유저가 !룰렛 을 외치면 오류 메세지를 보내)을 요구할 필요는 없다.

중요한 부분은 다음과 같다:

- 확률에따라 아이템이 확정된다

- 채팅 메세지를 받아서 룰렛 참여를 한다

- 참여한 룰렛은 큐로 관리한다

- 룰렛 오버레이 페이지가 있다

- 룰렛 관리 페이지가 있다

나머지는 기본 구조가 개발 된 후에 하나씩 수정할 수 있다.

Claude Code의 Plan Mode를 이용했는데, 실제로 구현하는 입장이라 추가로 몇가지 질문을 했다.

- 룰렛 오버레이 페이지와 서버간 연결을 SSE로 할것인지, WS로 할 것인지?

- 익명의 후원자가 룰렛에 참여할때 어떻게 표시할지?

- 룰렛 참여를 위한 최소 금액 설정이 필요한지?

Claude가 뽑아준 계획은 대략 이랬다.

모든 계획을 읽어보고 생각한것이 맞다면 첫번째 개발 사이클을 돌린다. 오류가 나는 것도 있고 여기저기 조금씩 고쳐서 실행해보면 기능이 되기는...된다!!!

이것이 첫번째 사이클의 룰렛 상태

일단 룰렛 스핀 부분에 표시된 글자와 실제로 당첨된 결과가 다르지만...어쨋든 채팅 메세지를 통해서 룰렛에 참여할 수 있고, 룰렛에 있는 항목에서 확률에 따라 결과를 결정한뒤 오버레이로 전송한다는 기본적인 기능이 된다는 점이 중요하다.

나누어서 다듬기

이제 다음 스텝은 각 파트별로 정복해나가는 것이다.

- 핵심 로직 및 데이터 모델

- 관리자 화면

- 룰렛 오버레이 디자인

- 관리자 권한 관리

파트별로 정복하면 좋은점은 AI를 병렬로 돌릴 수 있다는 점이있다.

예로 나는 Claude Code로 룰렛 오버레이 디자인을 깎으면서 Antigravity IDE에서는 DB에 룰렛 제목과 룰렛 히스토리에 당시 룰렛 상태 스냅샷을 추가하는 작업을 동시에 했다. 서로 건드리는 파일이 겹칠 일도 없으면서 일을 더 빠르게 처리할 수 있다.

세부적으로는 AI를 고문한다... 대략 이렇게....

- (치지직 도네이션 사진을 보여주며) 이런 스타일로 바꿔

- (폰트를 가져오며) 이 폰트를 적용해

- (효과음을 가져오며) Spin시에는 이 효과음을, Done때는 이 효과음을 재생해

- Done이 되면 Bounce하면서 콘페티가 보여지도록 해

- 아이템의 확률에 따라 디아블로 스타일로 고유 색을 정하고, Done 상태일때 배경색을 그 색으로 바꿔. 그리고 옆에는 확률을 표기해

그렇게 해서 룰렛 기능을 무사히 개발하게 되었다.

룰렛 관리자 화면

AI 덕분에 개발이 즐겁다. 예전처럼 고통스럽고 오류때문에 며칠을 골머리 앓고하던 일이 사라졌다.

즐겁지만... 동시에 조금은 두려워진다. 그런 고통을 겪으며 성장한 것 같았는데, 이제 그런건 없다. 팔이 떨어질 것 같이 아파도 연필로 꾹꾹 책 내용을 요약하며 공부하던 학생이 이젠 AI가 요약한 요약본만을 보면서 머리로 이해하고있다. 나는 내가 선택한 것이, 내가 만든 것이 남들과는 다르고 그게 훨씬 낫길 바란다. 이제는 그런 센스를 기르기가 점점 어려워지는 환경이 되는 것 같다.

[신대방] 경식이네알쌈주꾸미 - 주꾸미 정식

Lou Park — Sat, 20 Dec 2025 22:05:24 +0900

13000원짜리 주꾸미 정식이 아주 푸짐하게 나왔다.

술을 진탕 먹고 다음에 간거라 다들 많이 못먹었는데, 여기 주변에 살았다면 정말 자주갔을 것 같다.

칼칼한 시래기 된장국으로 스타트를 했는데 대박이었다.

주꾸미는 특별하진 않지만, 다른 여느 식당들만큼 통통하고 맛있다. 계란 부침에 계란도 정말 많이 들어간것 같았다.

주꾸미 먹고, 계란 부침먹고, 고사리먹고, 밥 먹고 싸이클을 돌리느라 정신없었다.

[내방] 양산도 - 가지장어덮밥

Lou Park — Sat, 20 Dec 2025 22:01:47 +0900

내방역 근처에 양산도라는 장어 덮밥집이 생겨서 방문해봤다.

난 장어를 정말 싫어하고...(뼈때문에) 장어 덮밥도 제대로된건 거의 처음이지만...이집이 맛있다는걸 단번에 알 수 있었다.

우선 메밀소바, 차완무시, 샐러드, 미소장국 이렇게 한 상 차림의 구성도 마음에 들었다.

그리고 장어는 빠짝 구워서 거의 뼈가 느껴지지않았다. 그러면서도 부드러운 가지가 바짝구운 장어와 밥사이에 아주 조화롭게 들어온다.

친구말에 의하면 가지장어가 제일 맛있었다고한다.

직접 RAG를 구축할 필요없게 해주는 Gemini File Search API

Lou Park — Tue, 2 Dec 2025 19:55:19 +0900

Chatbot을 만들면서 가장 귀찮았던건 RAG였다. RAG를 구현하기 위해 VectorDB라는 관리 포인트가 생기며, 임베딩 정책 및 모델 설정, 임베딩할 파일들을 관리하는 컴포넌트까지...RAG 구축 하나로 프로젝트가 복잡해지는 것은 순식간이다.

Gemini File Search API

지난 11월 6일, Google이 Gemini 3, Nano Banana Pro와 함께 Gemini File Search API를 발표했다. Gemini File Search API는 Gemini API에 구축된 RAG 시스템이다. 텍스트 파일 종류라면 대부분 지원하며, File Store를 생성하고 파일을 업로드하는 간단한 절차만으로 검색 기능을 추가할 수 있다.

나는 사내 API 문서를 바탕으로 API에 대한 질의를 할 수 있는 하는 MCP서버를 만들어보기 위해 OpenAPI Spec yaml 문서를 업로드해봤다.

def upload_file(self, file_path: str):
    operation = self.client.file_search_stores.upload_to_file_search_store(
        file=file_path,
        file_search_store_name=self.file_search_store.name,  # type: ignore
        config={
            "display_name": Path(file_path).name,
            "mime_type": self.guess_mime_type(file_path),
        },
    )
    # 완료될때까지 operation 업데이트
    while not operation.done:
        time.sleep(2)
        operation = self.client.operations.get(operation)

파일을 청킹하고, 오버랩은 얼마나 할것이며...모델은 뭘 쓸 것인지 구구절절 설정한 것이 하나도 없다.

def search(self, query: str):
    prompt = f"""
    You are an expert API assistant.
    Using the provided OpenAPI specification, find the APIs that are most relevant to the user's query: "{query}"

    List the relevant APIs with their Method, Path, and a brief summary.
    Explain *why* they are relevant.
    """

    response = self.client.models.generate_content(
        model=self.model,
        contents=prompt,
        config=types.GenerateContentConfig(
            tools=[
                types.Tool(
                    file_search=types.FileSearch(
                        file_search_store_names=[self.file_search_store.name]  # type: ignore
                    )
                )
            ]
        ),
    )
    return response.text

def search_apis_tool(query: str) -> str:
    """
    Search for APIs using Gemini's semantic understanding of the full OpenAPI spec.

    Args:
        query: The search query (e.g., "How do I buy items?", "Find APIs related to user profile").

    Returns:
        A natural language answer with relevant API details, grounded in the spec.
    """
    try:
        return search_api.search(query)
    except Exception as e:
        return f"Error searching with Gemini: {str(e)[:100]}"

API를 검색하는 도구의 코드도 매우 간단해졌다. (Gemini 의존적이지만)

Gemini API를 그대로 사용하면서, 도구로서 File Search를 넘겨주면 된다. 어떤 파일 스토어를 사용할지 설정할 수 있으며, 메타 데이터를 통한 필터링도 가능하다.

자세한 사용법은 공식 문서를 참고하기를 바란다.

[Android] Room이 생성한 Dao 구현체 확인방법

Lou Park — Tue, 2 Dec 2025 00:58:38 +0900

오늘 @Upsert 어노테이션을 사용해서 Collection 데이터를 넘겼을때 과연 "트랜잭션처리가 되는가?"에 대해서 검증해야할 일이 있었다. Room을 당연한듯이 사용하고는 했지만 너무 추상화되어있어서 내부 동작을 알지 못했다. 당연히- 트랜잭션처리가 될거라고, 되어야만 한다고 생각했지만, 어림짐작으로 그치지 않고 코드로 확실하게 보고싶었다.

PackageWhitelistDao_Impl

안드로이드 빌드를 한번 끝내면 generated/build에 내 Dao이름 + _Impl 이름으로 Dao의 구현체에대한 Java Class가 생성되어있는 것을 볼 수 있다.

upsert 함수가 이렇게 트랜잭션으로 감싸져 있는것을 확인했고, Room에 대한 흐릿한 불신을 지울 수 있게 되었다.

@Override
  public Object upsert(final List<? extends WhitelistTableEntity> entities,
      final Continuation<? super List<Long>> $completion) {
    return CoroutinesRoom.execute(__db, true, new Callable<List<Long>>() {
      @Override
      @NonNull
      public List<Long> call() throws Exception {
        __db.beginTransaction();
        try {
          final List<Long> _result = __upsertionAdapterOfWhitelistTableEntity.upsertAndReturnIdsList(entities);
          __db.setTransactionSuccessful();
          return _result;
        } finally {
          __db.endTransaction();
        }
      }
    }, $completion);
  }

[일본 마쓰야마] まめ楽 - 두부 정식

Lou Park — Sat, 25 Oct 2025 20:31:47 +0900

마쓰야마에서 유명한 요리는 단연 타이메시다.

타이메시도 정말 맛있는 음식이긴하지만, 마쓰야마에 지내는동안 그런 음식만 먹을수는 없지않은가..?!

도고 공원을 한바퀴 돌고, 독특한 두부정식을 점심으로 간단히 먹었었는데 정말 좋은 가격에 건강하고 든든한 한끼를 먹은느낌이었다.

특히 어묵이나 가지 등을 독특한 방식으로 조리한 반찬들이 맛있었다.

그리고 빨간 고추로 만든 유즈코쇼를 두부와 함께 먹도록하는데,

여기서 이 조합이 너무 신선해서 빨간 유즈코쇼를 하나 사왔다. 식사공간 바로옆이 식재료를 사갈수도있는 숍이다.

OAuth 2.0 관련 용어 공부

Lou Park — Wed, 22 Oct 2025 10:53:22 +0900

인가(Authorization)

확인된 사용자가 특정 자원에 접근할 권한이 있는지 확인 (권한 확인)

인증(Authentication)

사용자가 누구인지 확인 (로그인)

따라서 일반적인 순서: Authentication → Authorization

인증 서버(Authorization server)

OAuth 2.0 프레임워크의 구성요소로, 클라이언트가 인증 및 인가에 성공하면 Access Token을 발급한다.

Bearer 인증

OAuth 2.0 프레임워크에서 사용하는 토큰 인증 방식. HTTP 통신시 Header에 “Authorization: Bearer ”과 같은 형식으로 사용한다. Basic 인증방식만으로는 사용자의 권한을 정교하게 제어할 수 없기 때문에 등장했다. 형식은 *불투명한(Opaque) 문자열일수도 있고, JWT일수도 있다. Bearer 토큰에는 서버가 클라이언트의 권한을 확인할 수 있는 메타데이터가 포함되어 있어야한다. 이때문에 서버는 토큰을 발급만하고 보관할 필요가 없고, 빠르게 토큰 검증을 할 수 있다.

Basic 인증

가장 기본적인 인증방식. HTTP 통신시 Header에 “Authorization: Basic base64(:)”와 같은 형식으로 사용한다. 사용자 ID와 비밀번호를 base64로 인코딩한 형식이다. base64는 쉽게 디코딩가능하기 때문에 HTTPS, SSL/TLS로 통신해야 안전하다.

불투명 토큰(Opaque token)

클라이언트에게는 의미가 없지만 서버의 데이터베이스에서 권한 데이터를 조회하는 참조 키 역할을 하는 무작위의 고유한 문자열이다. 다음은 불투명 토큰의 예시이다: M-oxIny1RfaFbmjMX54L8Pl-KQEPeQvF6awzjWFA3iq

JWT와는 달리 자체적으로 정보를 포함하지 않으므로, 서버는 백엔드 데이터베이스를 조회해서 이 토큰이 가진 권한 데이터를 별도로 가져오는 절차를 거쳐야한다.

PKCE (Profile Key for Code Exchange)

암시적 흐름(Implicit Flow)은 권한 부여서버가 바로 토큰을 반환하는 방법이다. 하지만 OAuth 2.1 부터는 공식적으로 사용이 중단되었는데, URL에 Access Token이 노출되고, Refresh Token을 사용할 수 없어서 클라이언트가 안전하지 않은 방법으로 Access Token을 저장할 수 있다는 보안 문제가 있었기 때문이다. 이제 클라이언트 전용 앱에서는 권한 부여 코드 플로우(Authorization Code Flow) + PKCE를 사용해야한다.

PKCE는 인증 코드 가로채기 공격을 방지하여 인증 플로우를 시작한 클라이언트만이 토큰 교환에 성공할 수 있도록 보장한다.

*PKCE 인증 코드 흐름:

클라이언트가 43~128자의 랜덤 URL 안전 문자열로 코드 검증자(Code Verifier)를 생성한다.
클라이언트는 코드 검증자를 SHA-256과 같은 암호화 해시 함수로 해싱하고, 해시를 Base64 문자열로 인코딩한다. 이렇게 생성된 문자열을 코드 챌린지(Code Challenge)라고 한다.
클라이언트가 인증요청시 코드 챌린지를 포함한다. code_challenge_method 매개변수는 코드 챌린지를 생성하는데 사용된 해싱 알고리즘 (e. g., S256 for SHA-256)을 지정한 것이다.

GET /authorize?response_type=code
...
&code_challenge=YOUR_CODE_CHALLENGE
&code_challenge_method=S256

4. 클라이언트는 코드 검증자를 나중에 사용하기 위해 어딘가 저장하고, 인증 코드(Authorization Code)를 수신하면 토큰 요청을 코드 검증자와 함께 인증 서버로 보내야한다.

POST /token
...
&code=YOUR_AUTHORIZATION_CODE
...
&code_verifier=YOUR_CODE_VERIFIER

5. 인증서버는 코드 검증자와 코드 챌린지를 검증하여 클라이언트가 동일한 플로우에서 진행하고 있다는 것을 확인한다. 검증이 실패하면 인증 서버는 토큰 요청을 거절하면된다.

참고 자료

https://docs.tosspayments.com/resources/glossary/bearer-auth

https://auth-wiki.logto.io/ko

[논현] 성천막국수 - 막국수

Lou Park — Sun, 28 Sep 2025 12:31:32 +0900