Spot — 지도 위에 만든 로컬 커뮤니티, 그 기록의 시작

KD 팀의 HLMN 리팩토링이나 졸업 프로젝트 때도 느꼈지만, 개발을 해놓고 나면 "이걸 왜 이렇게 짰지?"에 대한 기록이 늘 빠져있다. 코드는 남지만 선택의 이유는 머릿속에서 휘발된다. Spot에선 그걸 미리 잡아두고 싶었다.

그리고 Spot은 백엔드 대부분이 아직 없다. 지금은 프론트엔드가 mock으로 서비스의 흐름을 먼저 만들고, 나중에 BE 팀이 붙을 때 그 mock이 스펙 문서가 된다. 이런 구조에서 설계 결정은 문서로 남겨두지 않으면 BE가 붙을 때 맥락이 증발한다.

이 섹션의 글들은 Spot을 만들면서 내가 실제로 부딪힌 문제와 선택을 정리한다. 순서대로 읽지 않아도 되고, 개념과 "왜 다른 방식이 아니었는지"를 중심으로 쓴다.

지금까지 쓴 주제는 세 개다. 앞으로 FSD 마이그레이션 회고, Serwist 전환, Tailwind v4 @theme 이야기가 따라 붙을 예정이다.

Spot은 여전히 개발 중이고 피봇 중이다. BE가 붙기 전에 FE가 먼저 만든 mock 세계가 어떻게 스펙 문서로 증발하지 않게 할지, 그리고 페르소나 시뮬레이션이라는 "가짜 실시간"을 어떻게 실제처럼 보이게 할지 — 앞으로의 주제가 거기에 있다.