
실시간 협업 코딩 에디터
딩코 · 2022.11 ~ 2023.03 · 단독 개발
멘토와 수강생이 같은 코드를 보며 문제를 푸는 협업 에디터를 한 달 만에 단독으로 개발해 자사 교육 과정에 적용하고 외부 교육 서비스에 판매했습니다.
담당: 설계부터 상용화까지 단독 개발 (코드 동기화, 편집 권한, 실행 결과, 음성·영상 통화)
기술 스택
TypeScript
Next.js
Monaco Editor
Socket.IO
AgoraRTC
React Context
REST API
Emotion
프로젝트 소개
- 멘토와 수강생이 코드를 공유하며 함께 문제를 해결하는 온라인 협업 도구입니다. 편집기에서 코드를 작성하고 실행 결과를 확인하면서 음성·영상으로 피드백을 주고받을 수 있습니다.
- Next.js 13, Monaco Editor, Socket.IO, AgoraRTC로 한 달 일정 안에 단독 개발했고, 자사 교육 과정에 적용한 뒤 외부 교육 서비스에 판매했습니다.
동시 편집 방식 선택: 200ms 소프트 락
- 여러 사용자가 같은 코드를 편집할 때 충돌을 어떻게 다룰지가 핵심이었습니다. OT·CRDT는 서버 상태 관리와 충돌 해결 비용이 커서 한 달 일정에 맞지 않는다고 판단했습니다.
- 대신 한 사용자가 입력하는 동안 200ms 동안 편집을 잠그는 소프트 락 방식을 선택했습니다. 입력 중에는 상대방 입력에 throttle을 걸고, 지금 편집 중인 사용자를 화면에 표시해 충돌 자체를 줄였습니다.
A가 입력 시작
└─ emit("lock", { userId: A }) ── 서버 ──▶ B: 편집 중 표시 "A 입력 중"
B의 입력은 throttle로 지연
A 입력 중 (debounce로 묶어서 전송)
└─ emit("code", { from: A, value }) ── 서버 ──▶ B: 받은 코드로 교체 (재전송 안 함)
A 입력 멈춤 + 200ms 경과
└─ emit("unlock") ── 서버 ──▶ B: 다시 편집 가능코드가 반복 전송되는 문제 해결
- 상대방이 작성한 코드를 편집기에 반영할 때, 이를 새 입력으로 처리하면 서버로 다시 전송되어 무한 루프가 생겼습니다. 서버에서 받은 변경과 사용자가 직접 입력한 변경을 구분해 재전송 루프를 제거했습니다.
- 편집 권한을 가진 사용자의 입력만 공유하고, 키를 누를 때마다 전송하지 않도록 debounce로 전송 빈도를 조절했습니다. 편집 잠금 상태를 입력 제한에 반영하고, 편집 중 발생한 리렌더링 버그도 수정했습니다.
const isRemoteChange = useRef(false);
socket.on("code", ({ from, value }) => {
if (from === myId) return;
isRemoteChange.current = true; // 이번 변경은 서버에서 온 것
editor.setValue(value);
isRemoteChange.current = false;
});
editor.onDidChangeModelContent(() => {
if (isRemoteChange.current) return; // 받은 코드는 다시 보내지 않음
sendCode(editor.getValue()); // debounce 처리된 전송
});서비스 연동과 통화
- 다른 서비스에서 에디터로 진입할 때 전달하는 문제·유저·방 ID와 토큰을 AES로 암호화해 파라미터 노출을 막았습니다.
- 코드 실행·제출 REST API를 연결해 실행 결과를 편집기에서 확인하도록 했습니다. AgoraRTC 클라이언트와 통화 채널을 연결하고, 참가자의 미디어 공개·중단·퇴장에 맞춰 영상과 음성을 표시하거나 정리했습니다.
결과 및 경험
- 한 달 만에 자사 교육 과정에 적용했고, 외부 교육 서비스에 판매되었습니다.
- 완벽한 동시 편집보다 일정 안에 안정적으로 동작하는 방식을 고르는 것이 중요했습니다. debounce는 전송 횟수를 줄이지만 상대방에게 코드가 전달되는 시점에도 영향을 주기 때문에, 전송 주기와 잠금 시간, 편집 권한을 함께 조정해야 했습니다.