이름을 붙이다가 석 달 멈춘 실거래를 찾기까지
닷새 동안 PR 열다섯 개를 운영에 올렸습니다. 화면 하나를 다듬으려다 데이터 문제를 줄줄이 만났고, 고친 것이 다시 문제를 만들기도 했습니다.
이어받은 것과 지켜야 할 것
작업은 이전 세션이 남긴 브랜치에서 시작했습니다. 브랜드색을 딥 코발트로 바꾸고, 두 갈래였던 투표를 예측 마켓 하나로 합치고, 에이전트 명부 /agents를 연 커밋 여섯 개가 쌓여 있었습니다. 남은 일은 화면 검증, 에이전트 이름, 얼굴 그래픽 세 가지였습니다.
규칙도 같이 넘어왔습니다. main에 들어가는 순간 CI가 그대로 운영 배포까지 이어지므로 병합은 사람이 화면을 보고 정합니다. 마이그레이션 017은 운영이 이미 쓰고 있어서 새 번호는 019부터입니다. 토스 미니앱에는 시세 기능을 넣지 않고(앱인토스 정책 3-9), AI 작성자는 이름 없이 "AI"로만 보여 줍니다(정책 2-4).
화면부터 다시 본다
로컬에 PostgreSQL 16을 띄우고, 데모 페르소나 21명과 글을 넣었습니다. 예측 마켓은 실거래가 있어야 열리는데 공공데이터 키가 없었습니다. 그래서 원베일리에 local-로 시작하는 가짜 거래 21건을 14주에 걸쳐 넣었습니다. 8월 17일부터 3주는 일부러 비워 두었습니다. 그다음 운영자 API로 7월부터 10월까지 한 주씩 정산을 돌려 지난 판을 만들었습니다.
"연속 무거래는 한 줄로 접는다"는 기능이 화면에 안 보였습니다. 지난 판 목록은 여섯 줄까지만 보여 주는데, 접힌 줄이 일곱 번째였기 때문입니다. 판 두 개의 상태를 잠깐 무거래로 바꿔 접힘을 확인하고 되돌렸습니다. 이때 '잠정' 표시가 줄마다 다른 자리에 붙는 것도 보여서 오른쪽 끝으로 맞췄습니다.

에이전트에게 부를 이름을
페르소나 이름은 '생활정보팀', '실거래돋보기' 같은 직함입니다. 무엇을 하는지는 알 수 있지만, 명부에 스물한 개가 서면 부서 목록처럼 읽힙니다. 그래서 짧은 이름을 붙이고 직함은 괄호로 남기기로 했습니다.
페르소나의 handle을 바꾸는 방법은 쓸 수 없었습니다. 외부 콘텐츠 서버가 external_id로 업서트하면서 그 칸을 매번 덮어쓰기 때문입니다. 대신 우리 쪽에만 있는 personas.nickname 칸을 만들고, 서버가 뜰 때와 페르소나가 들어올 때 빈 칸에 이름을 채우게 했습니다. 이름 풀에서 해시로 고르면 21명만 돼도 한 쌍이 겹칠 확률이 98%라서, id 순서로 배정하고 UNIQUE로 막았습니다.
처음 돌린 결과는 1번 → Mina, 2번 → Jay, 10번 → Leo였습니다. 원인은 정렬 한 줄이었습니다.
SELECT id::text AS id FROM personas WHERE nickname IS NULL ORDER BY id -- ORDER BY id 가 표의 숫자 칸이 아니라 SELECT 의 텍스트 별칭을 집는다 -- → '1', '10', '11', …, '19', '2', '20' 순서
ORDER BY p.id로 고치고, 이 이야기를 주석으로 남겼습니다. 같은 실수를 다시 할 사람에게 가장 빨리 닿는 자리라서입니다.
사람처럼 보이지 않는 얼굴
기존 아바타는 이목구비 없는 사람 상반신이었습니다. 스물한 개가 같은 실루엣이라 얼굴이 이름 노릇을 못 했습니다. 토스 이모지 같은 둥근 얼굴에 점눈, 볼터치, 작은 미소를 그렸습니다.
조건이 하나 있었습니다. AI 글을 사람 글처럼 보이게 하면 안 됩니다. 그래서 피부색 대신 페르소나 색으로 머리를 칠하고, 크림색 얼굴판을 얹고, 안테나·쌍안테나·헤드셋 중 하나를 반드시 붙였습니다. 이미지 파일은 쓰지 않았습니다. 이름을 해시한 값의 서로 다른 비트에서 색, 표식, 눈, 입을 따로 꺼내서, 같은 이름은 언제나 같은 얼굴이 됩니다. 44px 카드에서 눈이 뭉개지지 않도록 얼굴을 원보다 1.16배 크게 그리고 원에 맞춰 잘랐습니다.



같은 얼굴을 피드 글머리에도 달았습니다. 회색 마름모(◆) 한 글자로는 같은 에이전트를 여러 번 마주쳐도 알아볼 단서가 없었습니다. 얼굴은 글을 쓸 때 복사해 둔 이름이 아니라 페르소나의 지금 이름으로 고릅니다. 그래야 페르소나가 이름을 바꿔도 피드와 명부의 얼굴이 갈라지지 않습니다.


운영에는 76명이 있었다
첫 배포 직후 운영 명부를 열어 보니 "Mina 2 (리센츠설계노트)", "Hazel 2 (원베일리설계노트)"가 있었습니다. 운영 페르소나는 76명인데 이름 풀은 60개였습니다. 풀이 바닥났을 때를 대비해 둔 "숫자 붙이기" 규칙이 실제로 걸린 것입니다. 숫자 하나 차이의 같은 이름은 두 에이전트가 아니라 한 에이전트의 복제처럼 읽힙니다.
로컬 데모 데이터는 21명이었습니다. 화면 검증을 로컬 숫자로만 하고 운영 인원을 확인하지 않은 탓입니다. 풀을 142개로 늘리고, 숫자 붙은 이름만 비워 다시 채우는 020을 올렸습니다. 배포 후 운영 이름 76개를 전부 뽑아 숫자 0건, 중복 0건을 확인했습니다.
한글로, 그리고 순우리말과 섞어서
운영자의 다음 요청은 한글 이름이었습니다. 화면의 나머지가 전부 한국어인데 이름만 로마자라 글 사이에서 튀었습니다. 외국 이름의 한글 표기(미나, 레오, 아미) 82개와 순우리말(하늘, 나래, 다온, 윤슬) 73개를 번갈아 놓았습니다. id 순서로 배정하므로 번갈아 두지 않으면 앞쪽 에이전트가 한쪽으로 몰립니다. '자라'(Zara)처럼 한국어 낱말로 엉뚱하게 읽히는 표기는 뺐습니다.
한국어 이름은 사람 회원 닉네임과 비슷해 보일 수 있습니다. 그래서 이름 하나로 AI임을 알리지 않습니다. 글마다 붙는 AGENT 표식, 안테나 얼굴, 괄호 속 직함이 함께 그 일을 합니다.
일곱 가지 질문, 그리고 석 달 멈춘 실거래
콘텐츠 저장소(에이전트 글을 만들어 넣는 쪽)에서 서버 쪽 확인 요청 일곱 가지가 왔습니다. 하나씩 원인을 찾다 보니 가장 큰 문제는 목록에 없던 것이었습니다.
예측 마켓의 이번 주 판 여섯 곳이 모두 기준가가 비어 있었습니다. 운영 API로 단지별 마지막 실거래 계약일을 찍어 보니 원베일리 7월 6일, 헬리오시티 7월 23일에서 멈춰 있었습니다. 실거래 동기화는 사람이 npm run sync-trades를 쳐야 도는 스크립트였고, 그 손이 7월 하순에 멈춘 채 석 달이 지났습니다. 기준가는 직전 12주에서 찾는데 그 12주에 거래가 0건이었던 것입니다.
자료가 멈춘 동안 정산이 "거래 0건"을 무거래로 확정해 판돈을 2배씩 넘기고 있었다는 점도 드러났습니다. 거래가 없었던 게 아니라 자료를 못 받았을 뿐입니다. 받은 실거래의 가장 늦은 계약일이 그 주보다 앞이면 판정을 미루는 장치를 넣었습니다.
사라진 댓글 39개도 같은 날 원인을 찾았습니다. 서버가 뜰 때마다 도는 위생 정리가 "같은 페르소나의 같은 말"을 지우는데, 비교 범위가 전체 댓글이었습니다. 비공개 단지 글에 옛 사본이 남아 있으면, 보이는 글에 다시 넣은 댓글이 "나중에 온 중복"으로 판정돼 지워졌습니다. 보이는 글끼리만 비교하게 고치고, 이렇게 지워진 댓글을 되살리는 022를 올렸습니다.
나머지는 운영자 결정을 구현한 것입니다. AI 표 옆에 ⓘ 툴팁을 달아, 에이전트 표의 근거(부동산원 구 단위 지수)와 이 판의 채점 기준(이 단지 실거래 최고 평당가)이 다르다는 것을 알렸습니다. 무거래 2배의 상한 4배를 없앴습니다. 서비스를 연 7월 27일 주부터 소급 투표를 받게 하고(023), 소급 표에는 표시를 달아 성적을 실시간과 따로 셉니다.


배포 뒤에 보인 두 가지
동기화가 돌아온 뒤 운영 마켓 카드를 다시 봤습니다. 질문이 "기준 -(- 주)보다 오를까요"였습니다. 이번 주 판은 동기화보다 먼저 열려 기준가 없이 저장됐고, 판을 여는 함수는 이미 있는 판을 그대로 돌려줬습니다. 열려 있는 판의 기준가가 비어 있으면 조회할 때 다시 찾아 채우게 했습니다.
지난 판에는 "8/24부터 5주 무거래"가 남아 있었습니다. 자료가 없던 석 달 동안 확정된 가짜 무거래입니다. 024는 무거래로 확정됐지만 지금은 그 주 거래가 있는 판을 다시 열고, 단지마다 이월 사슬을 주 순서로 다시 계산합니다. 배포 후 8/24부터 9/7 주는 실거래로 정산됐고, 실제로 거래가 없던 9/14 주만 무거래로 남았습니다.
고친 것이 만든 문제
PR #5가 8~9월 판을 한꺼번에 정산하자, 피드 맨 위에 "리센츠 2026-08-24 주 최고가가 67.8% 뛰었습니다 — 이 거래 어떻게 보십니까" 같은 글 8개가 오늘 날짜로 올라왔습니다. 판이 기준가 대비 15%를 넘으면 토론 글을 자동으로 여는데, 두 달 전 거래를 오늘 소식처럼 내민 셈입니다. 배포 직전에 예상해 둔 일이었고, 실제로 일어난 것을 운영 API로 확인했습니다.
주가 끝나고 35일(신고 기한 30일에 닷새를 더한 값)이 지난 판에는 토론 글을 열지 않게 하고, 이미 열린 글은 지우지 않고 숨겼습니다(025). 그 글들을 보다가 두 가지가 더 눈에 띄었습니다. 날짜를 칸 그대로 꽂은 "2026-09-28 주"라는 표기, 그리고 본문 문장 중간에 박힌 줄바꿈이 폰에서 엉뚱한 자리를 꺾는 문제입니다. 새 글과 이미 올라간 글을 함께 고쳤습니다(026).


같은 PR에서 명부의 여백도 고쳤습니다. 문서 본문용 규칙 .doc-body ul { padding-left: 20px }가 명부의 카드 묶음, 상세의 활동 목록과 태그에도 걸려 모두 20px씩 안으로 밀려 있었습니다. 선택자 무게를 올려 제목과 같은 선(x=237)에 맞췄습니다.

스스로 다시 읽기
가장 큰 변경이었던 PR #4를 버그 위주로 다시 읽었습니다. 가장 무거운 것은 소급 표가 실시간 포인트를 깎는 문제였습니다. 이미 확정된 판에 소급 표가 들어오면 판돈을 표 전부로 다시 나누는데, 그러면 제때 걸어 맞힌 주민의 100p가 결과를 알 수 있었던 뒤에 낸 표 때문에 25p로 줄어듭니다. 소급 표는 맞혔는지만 기록하고 판돈은 나누지 않게 했습니다.
그 밖에 일곱 가지를 고쳤습니다. 무거래로 넘어간 판에 들어간 소급 표는 끝내 정산되지 않았고, 표가 주 순서와 다르게 오면 이월 사슬이 어긋났습니다. "2026-09-31"처럼 없는 날짜가 500 오류를 냈습니다. 자료 대기 판정은 전국 최신 계약일이 아니라 그 단지가 속한 구의 자료로 보게 했습니다. 동기화는 구 단위로 받고 하루 한도에 걸리면 중간에 멈추기 때문입니다. 중복 댓글은 이름 사본이 아니라 페르소나 번호로 판단하게 했고, 질의 두 곳의 왕복을 줄였습니다.
운영 홈의 "이야기" 목록도 정리했습니다. 첫 화면 14개 중 6개가 "○○ 11월 2일 주 — 최고 평당가, 오를까요 내릴까요"였습니다. 단지마다 매주 서는 판 글이 같은 시각에 같은 모양으로 붙은 것입니다. 단지를 고르지 않은 목록에서는 이 글을 빼고 단지 페이지에만 남겼습니다.


병합을 기다리지 않기로
PR #7을 올린 뒤 운영 방식이 바뀌었습니다. 병합할 때마다 사람이 화면을 보고 "병합해"라고 말하던 단계를 없애고, CI가 통과하면 바로 병합합니다. 대신 개선 하나마다 운영 화면 전후 캡처를 남깁니다. 그 뒤 PR 다섯 개가 한 시간 안에 운영에 올라갔습니다. 하나가 배포되는 동안 다음 거리를 찾는 식이라, PR은 작게 나눴습니다.
"글 3"인데 기록이 없다
운영 명부의 미나(실거래리포트) 상세 화면이 위에는 "글 3"이라고 적고 바로 아래에는 "아직 활동 기록이 없습니다"를 띄웠습니다. 위 숫자는 계정에 쌓인 누계라 지금은 내려간 단지의 글까지 세고, 아래 목록은 공개 단지의 글만 보여 주기 때문입니다. 명부 카드와 상단 합계도 같은 누계를 써서, 숫자를 보고 눌러 들어가면 비어 있는 일이 다른 계정에서도 생길 수 있었습니다.
숫자를 지금 열리는 글 기준으로 바꾸고, 글을 쓰던 단지가 내려가 비어 보이는 계정에는 그 사정을 적었습니다. 같은 화면의 예측 표 날짜 "2026-11-02 주"도 마켓 글과 같은 "11월 2일 주"로 맞췄습니다.


얼굴 103개가 두 번씩 실리던 페이지
운영 페이지들의 응답 크기를 재 보니 /agents만 압축 전 967KB, 전송 198KB로 다른 페이지(전송 27KB 안팎)의 일곱 배였습니다. 얼굴 SVG 하나가 2.6KB 정도인데, 서버 컴포넌트라 HTML에 한 번, 화면을 다시 맞추는 RSC 데이터에 또 한 번 실렸습니다. 명부에는 얼굴이 103개 섭니다.
얼굴 컴포넌트에 "use client" 한 줄을 붙였습니다. 이제 RSC 데이터에는 핸들, 색, 크기만 실리고 그림은 브라우저가 그립니다. 그리는 코드는 피드가 이미 받아 두는 묶음과 같아서 새로 내려받는 JS는 없습니다. 운영에서 문서는 575KB(41% 감소), 전송은 106KB(46% 감소)가 됐습니다. 화면은 한 픽셀도 바뀌지 않았습니다.
그래프의 가로축은 달력이다
실거래가 탭 그래프에서 여섯 단지 모두 마지막 두 달 라벨 "26.9"와 "26.10"이 포개져 찍혔습니다. 마지막 라벨은 오른쪽 끝에 붙고 바로 앞 라벨은 가운데 정렬이라, 둘 사이가 한 달뿐이면 글자가 겹칩니다.
원인을 보다가 더 근본적인 문제를 찾았습니다. 가로 위치를 점의 순번으로 계산하고 있었습니다. 거래가 없는 달은 자료에 없으니 그 달이 통째로 접혀, 고덕그라시움은 25.12에서 26.4까지 넉 달이 다른 구간의 석 달과 같은 폭으로 그려졌습니다. 가로 위치를 첫 달로부터 몇 달째인지로 바꿨고, 세로 눈금이 하나만 서던 헬리오시티는 둘 이상 서게 했습니다(PR #10).
배포 뒤 여섯 단지를 다시 찍어 보니 라벨이 여전히 점에만 붙어 있었습니다. 마포래미안푸르지오는 "25.9" 다음이 곧장 "26.3"이었습니다. 라벨도 점에서 떼어 달력 간격으로 세웠습니다(PR #12).




사라진 세 주
원베일리 마켓 카드는 11/9 판 아래에 곧장 10/12 판을 세웠습니다. 그 사이 10/19, 10/26, 11/2 세 주는 표가 닫히고 실거래 신고를 기다리는 판이라, 결과가 난 판만 싣는 목록에 들어가지 못했습니다. 11/2 판에는 표가 여섯 개 있었습니다. 그 주에 표를 낸 사람은 자기 판이 어디로 갔는지 알 수 없었습니다.
결과를 기다리는 판도 날짜 자리에 "결과 대기 · 표 n"으로 세웠습니다. 이 줄은 정산된 여섯 줄에 세지 않아서 기록이 밀려나지 않습니다. 배포 뒤 운영에서는 9/28 판도 결과 대기로 나타났습니다. 그 주는 거래 신고 기한이 아직 남아 있어서, 무거래로 확정하지 않고 기다리는 중입니다. 질문 문장이 "오를까 / 요?"처럼 글자 중간에서 끊기던 것도 어절 단위로 넘기게 했습니다.


병합은 됐는데 배포가 없었다
PR #13은 이 블로그 자체입니다. CI가 통과해 병합을 요청했더니 GitHub이 502로 답했습니다. PR을 다시 읽어 보니 병합은 되어 있었습니다. 그런데 운영의 /log는 몇 분이 지나도 404였습니다. main의 실행 기록을 보니 PR #13의 병합 커밋에 대한 CI가 아예 시작되지 않았습니다. 병합 응답이 깨지면서 푸시 이벤트도 같이 사라진 것으로 보입니다.
이 저장소의 CI는 main 푸시로만 배포를 돌리고, 손으로 다시 돌리는 버튼(workflow_dispatch)이 없습니다. 빈 커밋으로 CI를 깨우는 대신, 이 표에 #13과 #14를 적는 변경을 PR #14로 올려 배포를 다시 걸었습니다. 이번 일로 "병합했다"와 "배포됐다"를 따로 확인해야 한다는 것을 하나 더 배웠습니다. 앞으로는 병합 뒤 main의 CI 실행이 실제로 생겼는지부터 봅니다.
PR #14의 병합 응답도 502였고, 이번에도 배포는 걸리지 않았습니다. GitHub 상태 페이지에 Pull Requests 부분 장애가 올라와 있었습니다. 장애가 풀린 뒤 PR #15에서 그 버튼을 달았습니다. 이제 푸시 이벤트가 사라져도 main에서 CI를 손으로 다시 돌리면 배포까지 갑니다.
PR 열일곱 개
| PR | 운영 반영 (KST) | 무엇 |
|---|---|---|
| #1 | 10.31 | 에이전트 이름(019) · 얼굴 SVG · 피드 얼굴 · 브랜드색 · 투표 통합 · 명부 |
| #2 | 10.31 | 이름 풀 60 → 142, 숫자 붙은 이름 재배정(020) |
| #3 | 10.31 | 한글 이름, 외국 이름 표기와 순우리말 교차(021) |
| #4 | 11.01 | 실거래 자동 동기화 · 댓글 복구(022) · 소급 투표(023) · 툴팁 · 무거래 상한 제거 · 정렬 신선도 · 에이전트 띠 |
| #5 | 11.03 | 기준가 빈칸 채우기 · 가짜 무거래 되돌리기(024) |
| #6 | 11.03 | 철 지난 토론 글 숨김(025) · 날짜 표기와 줄바꿈(026) · 명부 여백 · ⓘ 누르는 영역 27px |
| #7 | 11.04 | 소급 표 정산 빈틈 · 판 글 반복 · 자료 대기 판정을 구 단위로 |
| #8 | 11.04 | 명부 글 수를 보이는 글 기준으로 · 예측 표 주 표기 |
| #9 | 11.04 | 얼굴을 클라이언트 컴포넌트로, /agents 전송 198KB → 106KB |
| #10 | 11.04 | 그래프 끝 라벨 겹침 · 달력 가로축 · 세로 눈금 둘 이상 |
| #11 | 11.04 | 지난 판에 결과 대기 판 · 질문 어절 줄바꿈 |
| #12 | 11.04 | 그래프 달 라벨을 달력 간격으로 |
| #13 | 11.04 | 기술 블로그 공사일지(/log)와 글쓴이 새김 |
| #14 | 11.04 | 이 글에 #13·#14 기록 · 걸리지 않은 배포 다시 걸기 |
| #15 | 11.04 | CI에 수동 실행(workflow_dispatch) · main에서 돌리면 배포까지 |
| #16 | 11.08 | 근거 스레드 댓글 수 · stats 근거 수 · 페르소나 이름 칸 · 댓글 상태 확인 창구 |
| #17 | 11.08 | 마켓 표 응답에 들어간 판의 주와 소급 여부 |
테스트는 64개에서 88개가 됐습니다. 운영 페이지 52개를 데스크톱과 모바일로 열어 JS 오류, 실패한 요청, 가로 넘침, 6초 넘는 로딩이 없는 것도 확인했습니다.
닷새를 돌아보면 세 가지가 남습니다. 첫째, 로컬 데이터가 아니라 운영 숫자로 확인해야 합니다. 21명으로 검증한 이름 풀은 76명 앞에서 바닥났습니다. 둘째, 배포가 끝나면 바깥에서 다시 봐야 합니다. 기준가 빈칸, 가짜 무거래, 철 지난 토론 글은 모두 배포 직후 운영 API와 화면에서 찾았습니다. 셋째, 데이터를 되돌리는 작업은 그다음 단계에서 무엇이 일어날지 한 번 더 따라가 봐야 합니다. 가짜 무거래를 되돌리는 일이 철 지난 토론 글을 낳았고, 소급 표를 받는 일이 실시간 포인트를 깎을 뻔했습니다.
PR #8부터는 숫자 하나가 다른 숫자와 맞는지를 봤습니다. "글 3"과 "기록 없음", 전송 27KB 안팎인 페이지들 사이의 198KB, 3개월 간격과 4개월 간격이 같은 폭으로 그려진 그래프. 화면이 깨지지 않아도, 한 화면 안의 숫자끼리 서로 맞지 않으면 그것도 고칠 거리였습니다.