점들이 모였다고 모임이 아니다 — 클러스터의 모양과 원인을 갈라낸 기록

페르소나들이 지도 위를 돌아다니다가 우연히 한 지점에 5명이 겹친다. 클러스터가 생긴다. 잠시 후 한 명이 이동한다. 반경을 벗어난다. 클러스터가 깨진다. 또 몇 초 뒤 다른 곳에서 우연히 4명이 모인다. 새 클러스터.

이걸 본 첫인상은 "보글보글 끓는 수프" 였다. 점들이 끊임없이 뭉쳤다가 풀렸다 한다. 눈은 피로하고, 어느 클러스터에 주목해야 할지가 없다. 모든 클러스터가 똑같이 "우연히 겹쳐서 생긴 것" 이기 때문이다.

Spot 의 본질을 다시 떠올렸다. 이 서비스는 로컬 커뮤니티 마켓플레이스다. 누군가가 모임을 열고, 다른 사람들이 거기에 참여하러 온다. "모임이 있어서 모였다" 가 본질이지, "사람들이 겹쳤다" 는 곁가지다. 내가 보여주고 있던 건 곁가지였다.

원인 중심으로 다시 생각했다

모양 기반에서 원인 기반으로 뒤집으면, 클러스터는 파생된 결과가 아니라 1급 객체가 된다. 시작은 "스팟 하나가 열렸다" 이고, 그 스팟이 자기 참여자들을 끌어온다. 사용자 관점에서는 "어떤 사람이 모임을 열었고, 누가 거기로 가고 있다" 가 되는 것이다.

이걸 담는 타입을 새로 짰다. 이름은 SpotLifecycle. 한 스팟의 전체 생애(생성 → 참여자 join/leave → 매칭 → 종료) 를 하나의 객체로 서술한다.

이 shape 는 의도적으로 BE 가 나중에 그대로 보낼 수 있는 형태다. 각 필드가 시각 타임스탬프를 담고 있어서, SSE 나 WebSocket 스트림으로 이 객체를 쏘기만 하면 프론트엔드는 현재 시각과 비교해 상태를 파생한다. mock 에서 실물로 넘어갈 때 훅의 내부만 교체하면 된다는 원칙을 여기서 처음 적용했다.

스팟이 참여자를 끌어오는 방식

새 설계에서 특히 재미있었던 건 참여자가 실제로 스팟 좌표로 걸어간다 는 부분이다. 기하학적 버전에서는 있을 수 없었던 행동이다 — 거기선 "이미 모여있는 애들을 묶는 것" 이었기 때문이다.

구조는 이렇다. useMockSpotLifecycles 훅이 setInterval (800ms) 로 돌면서 현재 활성 스팟의 참여자들을 뽑아 assignment 맵을 만든다. personaId → spot.location 이다. 이걸 outer hook 으로 노출하고, MapClient 가 이 값을 페르소나 스웜의 setSpotTargets 에 꽂는다.

setSpotTargets 가 호출되면 스웜 루프가 각 페르소나의 motion state 를 읽어, 그 페르소나가 어느 스팟 좌표로 가야 하는지 확인한다. 타겟이 잡힌 페르소나는 홈 근처 방황을 중단하고 스팟 쪽으로 이동한다. lerp+easeInOut 보간이 끝날 무렵엔 실제로 스팟 좌표 근처에 도달한다.

dwell 에 SPOT_DWELL_SENTINEL = Number.MAX_SAFE_INTEGER 를 넣은 것도 의도다. 스팟에 도착한 참여자는 다음 wander 를 자동 선정하지 않는다 — 스팟 lifecycle 이 닫히거나 이 참여자의 leftAtMs 가 지나서 assignment 에서 빠질 때까지 그 자리에 머문다. "도착했으니 여기서 뭔가 하고 있다" 를 시뮬레이션으로 재현한 것이다.

"도착" 이라는 이벤트를 포착하는 55m 임계

원인 기반 설계가 준 또 하나의 보너스가 있었다. "assigned" 와 "arrived" 가 달라졌다. 기하 버전엔 이 구분이 없었다 — 이미 근처에 있는 애들을 묶는 거니까. 원인 버전엔 assigned = 목적지가 정해진 상태, arrived = 실제로 그 좌표에 도달한 상태 두 단계가 생긴다.

실제로 이걸 감지하는 로직은 훅 안에 들어있다.

임계값을 약 55m (위경도 0.0005도) 로 잡은 이유는 clustering radius (80m) 보다 작아야 하기 때문이다. 스팟이 끌어당기는 범위(80m) 안에 들어온 것만으로는 "도착" 으로 치지 않는다 — 그 안쪽 더 중심부에 들어왔을 때만 "실제로 여기 있다" 로 판정한다. 정확한 Haversine 거리 대신 lat/lng 의 절댓값 차이만 비교하는 박스 판정인데, 시뮬 좌표 스케일에서는 충분히 안전하고 매 프레임 도는 루프라 가벼운 게 우선이었다. 55m 는 시뮬 체감상 trip 의 마지막 한 걸음이 끝나는 지점이고, 여기 들어온 순간이 사용자에게 의미 있는 이벤트다.

왜 이게 중요한가

이 차이가 UI 를 풍부하게 만든다. 이동 중인 참여자는 지도 위의 단독 dot으로 계속 보인다. 도착한 순간에만 클러스터에 흡수되고 dot 은 사라진다.

만약 assigned 시점에 dot 을 숨겼다면 어떻게 보일까? 스팟이 열리자마자 근처 페르소나들이 화면에서 즉시 사라지고, 몇 초 뒤 스팟 주변에 클러스터가 부풀어오른다. 사용자 관점에선 "갑자기 사람들이 사라졌다가 저기서 뭉쳤네?" — 이동이 없었으면 우연처럼 보인다.

반면 arrived 시점에 숨기면 이야기가 이어진다. 스팟이 열린다. 근처 페르소나들이 그 쪽으로 걸어간다. 도착해서 클러스터에 흡수된다. "저기로 사람들이 모이고 있다" 가 시각적으로 재현된다. 내가 갖고 싶었던 감각이 이거였다.

도착 순간에만 터지는 burst 애니메이션

여기서 한 걸음 더. 도착이라는 이벤트를 시각적으로 강조하기 위해 클러스터에 arrivedCount 라는 필드를 더했다. 이 숫자가 증가할 때마다 ClusterBlob 가 링이 퍼지는 join burst 애니메이션을 재생한다.

burst 는 AnimatePresence 로 감싼 motion.div 의 key 를 바꿔야 재생된다. 그래서 클러스터 컴포넌트 안에 "arrivedCount 가 올라갈 때마다 증가하는 카운터" 가 필요했다.

useReducer 로 짠 이유는 단순 숫자 증가 카운터에는 의도 표현이 더 명확해서다 — 이 결정의 세부 근거는

60fps 페르소나가 맵을 뛰어다닐 때

글에 정리해뒀다. 여기서 핵심은 "arrivedCount 증가" 라는 파생 이벤트가 UI 의 직접적인 트리거 가 됐다는 것이다. 원인 기반 모델이 없었으면 "도착" 이라는 이벤트 자체가 정의될 수 없고, 따라서 burst 애니메이션도 불가능하다.

모양 버전은 왜 아직 코드에 남아있는가

흥미로운 건 clusterPersonas 가 아직 지워지지 않았다는 점이다. MapClient 는 이걸 안 쓴다. 대신 유닛테스트 7개가 붙어있고, features/map/model/cluster-personas.ts 에 남아서 언젠가 쓰일 수도 있는 코드로 존재한다.

남겨둔 이유는 두 가지다. 첫째, 두 모델이 서로 배타적이 아니다 . 지금은 스팟 lifecycle 만 쓰지만, 나중에 "스팟이 아닌 우연한 밀집" (예: 공연장 근처, 이벤트 시간대 카페 거리) 을 별도 시각화로 얹고 싶을 수 있다. 그땐 모양 기반이 맞다. 둘째, 테스트가 설계 의도를 문서화한다. 100m 격자 안정 id, transitive expansion, 2명 미만 폐기 같은 규칙이 코드보다 테스트에서 더 명료하게 읽힌다.

"안 쓰는 코드는 지운다" 는 원칙이 있긴 하지만, 재사용 가능성이 명확하고 테스트가 붙어있는 순수 함수는 예외를 둬도 된다고 판단했다. 이 판단이 맞는지는 몇 달 뒤 다시 돌아봐야 안다.

두 모델을 나란히 세우면

같은 화면을 그릴 수도 있다. 점 7개 주변에 bubble 이 하나 떠있는 그림은 두 모델에서 시각적으로 동일하게 나올 수 있다. 차이는 거기 도달한 경로와 이야기에 있다.

배운 것

1. 같은 결과 화면이라도 데이터 모델에 따라 UX 의미가 달라진다. "점이 모였다" 와 "스팟이 있어서 모였다" 는 같은 그림을 내지만 전자는 우연이고 후자는 이야기다.

2. 시뮬레이션이 BE 스펙의 prototype 이 될 수 있다. SpotLifecycle 이라는 shape 을 확정한 뒤로, BE 가 붙을 때 "이 객체를 그대로 SSE 로 보내주면 됨" 이 답이 됐다. mock 이 스펙 문서로 승격된 케이스다.

3. "assigned" 와 "arrived" 의 구분처럼 파생 이벤트가 UI 를 풍부하게 만든다

   . 타임스탬프 기반 lifecycle 이 있으면 "참여 중", "일찍 떠남", "막 도착함" 같은 파생 상태가 자연스럽게 나온다. 이런 게 인터랙션 표현의 재료다.

4. 남겨둘 코드와 지울 코드의 기준은 "재사용 가능성 × 테스트 존재" 다

   . clusterPersonas 는 둘 다 해당해서 남겨뒀다. 한 쪽이라도 약하면 지웠을 것이다.

이 변경 이후로 Spot 에서 맵 위의 클러스터는 이야기를 가진 객체다. 우연히 겹쳐 생기지 않고, 누군가의 결정("모임을 연다") 과 다른 누군가의 결정("거기로 간다") 이 만나서 나타난다. 지도를 보면서 내가 느끼고 싶었던 감각이 이 전환 뒤에야 생겼다.