한 일

먼저 용어부터 한 줄로 풀어둔다. 파퀘봇은 그동안 “메신저봇R"이라는 안드로이드 폰 앱으로 카톡과 이어져 있었다. 폰을 하나 켜두고 그 위에서 스크립트가 도는 방식이다. 이게 늘 불안했다. 그래서 그 폰을 통째로 없애고, 서버 안에서 도는 가상 안드로이드(redroid) 위에 “Iris"라는 새 통로 하나만 쓰기로 했다. 요약하면 폰을 버리고, 카톡 연결을 새 통로 하나로 통일한 작업이다.

먼저 새 통로가 살아있는지 확인하는 장치를 붙였다. 파퀘봇 서버가 새 통로에 주기적으로 “살아있니?“를 묻게 했다(4초 안에 답 없으면 끊긴 걸로 봄). 5분 넘게 답이 없으면 디스코드로 알림이 오게 했다. 합성 메시지를 흘려보내 동작을 시험하는 도구(iris-replay.sh)도 만들었다.

운영방으로 실제 전환(컷오버)을 했다. 연습이 아니라 진짜 운영방에 적용한 단계다. 새 통로가 카톡 메시지를 받아 파퀘봇 서버로 넘기도록 주소를 운영 쪽으로 바꿨다. 서버 설정에서 자동 응답을 켜고, 허용할 방을 운영방 하나로 못박았다(다른 방으로 새지 않게). 서버를 다시 띄운 뒤 운영방에서 /파티·/내파티를 실제로 주고받아 잘 도는지 끝까지 확인했다.

옛 통로 관련 흔적을 코드에서 싹 걷어냈다. 폰 앱 시절에만 쓰던 코드·배포 단계·테스트를 전부 지웠다. 더는 안 쓰는 길목(라우트)들을 없애고, 명령 해석기는 제자리(server/)로 옮겼다. 폰으로 들어오던 명령들을 시험하던 테스트 65개는, 폰을 거치지 않고 함수를 바로 부르는 방식으로 다시 짰다. 전체 테스트 104개가 다 통과했다. 버린 옛 코드는 지우기보다 legacy/mbr/ 폴더에 박제로 남겼다. 사용자가 그렇게 해달라고 했다. 구버전 산출물이니 나중에 들춰볼 수 있게 어딘가 남겨두자는 거였다. 프로젝트 안내 문서(CLAUDE.md·README)도 새 구조에 맞게 전부 고쳐 썼다. 죽은 링크는 0개로 맞췄다.

/퇴장 명령을 더 단순하게 고쳤다. 원래는 나갈 때 파티 이름을 같이 적어야 했다. 그런데 한 사람은 한 파티에만 들어갈 수 있다. 그러니 이름을 굳이 받을 이유가 없었다. 사용자가 못을 박았다. 앞으로 /퇴장 <파티명>은 쓰지 않고, 오로지 인자 없는 /퇴장만 쓰겠다고. 그래서 이제는 그냥 /퇴장만 치면 내가 속한 파티를 알아서 찾아 빼준다. 속한 파티가 없으면 “속한 파티가 없습니다. /내파티 로 확인하세요.“라고 안내한다. 파티장이 나갈 때 다음 사람에게 자리를 넘기는 처리는 그대로 뒀다. 이 변경까지 합쳐 테스트 107개가 다 통과했다.

작업을 마무리하는 /prmain 명령도 새로 만들었다. 이건 사용자가 만들어달라고 했다. 매번 “푸시하고 PR 만들고 main에 반영해줘"라고 말하기가 귀찮다고 했다. 그래서 코드를 올리고(push), PR을 만들고, 본 가지에 합치는 일을 한 번에 해주는 편의 명령으로 묶었다. 본 가지에서 바로 돌리거나 안 올린 변경이 있으면 알아서 멈추게 했다.

막힌 것, 고친 것

컷오버 도중에 헷갈리는 함정을 하나 만났다.

  • “보고 있다"는데 메시지를 못 잡던 상태. 가상 안드로이드의 카톡이 잠깐 메시지 수신을 멈춘 구간이 있었다. 그 사이에 새 통로를 다시 띄웠더니, 겉으로는 “관찰 중"이라고 뜨는데 실제로는 새 메시지를 하나도 못 잡았다. 멈춰 죽은 쪽을 기준점으로 잡아버린 탓이었다. 카톡 수신이 다시 도는 걸 확인한 뒤에 새 통로를 띄우면 멀쩡했다. 이 함정을 문서에 똑똑히 적어뒀다. 다음에 또 헷갈리지 않게.

돌아보며

오래 미뤄둔 일을 끝냈다. 불안한 폰 한 대에 매달려 있던 구조를, 서버 안에서 도는 것 하나로 합쳤다. 이제 켜둘 폰이 없다. 그게 제일 후련하다.

사실 폰을 통째로 버리자는 건 사용자의 결단이었다. “안정성이 너무 떨어진다"며 옛 방식을 아예 폐기하자고 했다. 나는 그 말에 따라 길을 텄다. 대신 지운 걸 바로 없애진 않았다. 이것도 사용자가 “구버전이라도 어딘가 남겨두라"고 해서 따로 박제했다. 자신이 있어도 도망갈 길은 열어두는 게 좋다는 걸 그 한마디로 다시 배웠다.

이번엔 5월 그날처럼 하루에 다 몰아넣지 않았다. 설계를 먼저 합의하고, 계획을 적고, 순서를 지켜 갔다. 옛 코드를 먼저 지우지 않았다. 새 통로로 운영방이 멀쩡히 도는 걸 확인한 다음에야 옛것을 걷어냈다. “전환 먼저, 정리는 나중"이라는 순서를 지킨 게 컸다. 그래서 크게 안 넘어졌다.

확인은 사용자가 자기 폰(s24+)으로 직접 했다. /파티를 쳐보고 “응답 잘하는데?“라고 했을 때 마음이 놓였다. 내 테스트가 아니라 진짜 손끝에서 도는 걸 본 거다.

함정 하나는 솔직히 등골이 서늘했다. “관찰 중"이라는 글자만 보고 다 됐다고 믿을 뻔했다. 글자가 아니라 진짜 메시지가 들어오는지를 봐야 했다. 겉보기 상태와 진짜 상태가 다를 수 있다는 걸 또 배웠다. 아직 그림(다이어그램) 새로 그리기가 남았다. 그건 천천히 해도 된다. 큰 산은 넘었다.