kotalk/문서/39-admin-operations-support-and-trust-playbook.md
2026-04-16 09:24:26 +09:00

2.3 KiB

Admin, Operations, Support, And Trust Playbook

목적

오픈소스 메신저가 실제 사용 도구가 되려면 기능만큼 운영 신뢰가 중요하다.
이 문서는 계정 지원, 장애 공지, 보안 대응, 릴리즈 운영, 사용자 문의 처리까지 포함한 운영 플레이북을 정의한다.

핵심 원칙

  • 장애는 숨기지 않는다
  • 문제를 사용자 탓으로 돌리지 않는다
  • 설명은 짧고 차분하게 한다
  • 운영 문구는 공격적이거나 과장되지 않아야 한다

운영자가 다뤄야 하는 사건

  • 로그인/세션 문제
  • 메시지 전송 지연
  • 첨부 업로드 실패
  • 다운로드 링크 문제
  • 잘못된 릴리즈 배포
  • 보안 문의
  • 오탐 차단 또는 접근 불가 문제

사용자 지원 흐름

  1. 증상 확인
  2. 현재 상태 알림
  3. 임시 우회 안내
  4. 복구 시각 또는 다음 점검 시각 안내
  5. 해결 후 요약 공지

상태 페이지와 저장소 역할

  • README는 제품과 채널 상태의 요약
  • PROJECT_STATUS는 현재 구현 및 라이브 상태
  • CHANGELOG는 버전 변동 내역
  • Releases는 산출물 접근 지점
  • 문서 폴더는 의사결정과 설계 근거

장애 커뮤니케이션 원칙

  • 문제가 확인되었습니다
  • 현재 영향 범위는 ... 입니다
  • 임시로 이렇게 사용할 수 있습니다
  • 다음 업데이트 시점은 ... 입니다

이 네 문장을 벗어나 복잡한 변명으로 흐르지 않는다.

신뢰를 깎는 운영 패턴

  • 오류 코드를 그대로 사용자에게 던짐
  • 로그인 문제를 설명 없이 재시도로만 돌림
  • 릴리즈 링크가 깨졌는데 상태 문서는 그대로 둠
  • 스크린샷과 실제 UI가 어긋난 채 방치

보안 사건 대응

  • 영향 범위 파악
  • 관련 채널 임시 제한
  • 사용자 안내
  • 비밀값 회전
  • 사후 문서화

릴리즈 운영

  • 각 버전마다 Windows 산출물, Android 산출물, 최신 스크린샷, 릴리즈 노트를 묶는다
  • latest 링크와 버전별 링크를 분리한다
  • 다운로드 호스트와 원격 Releases가 같은 버전을 가리키게 한다

완료 기준

  • 사용자가 장애를 겪더라도 관리되고 있다는 인상을 받아야 한다.
  • 저장소와 배포 표면이 운영 미숙으로 신뢰를 깎지 않아야 한다.