public/kotalk
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

공개: KoTalk 최신 기준선

Browse source
This commit is contained in:
Ian 2026-04-16 09:24:26 +09:00
commit debf62f76e
572 changed files with 41689 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

43
문서/atlas/10-release-ops/01-version-manifest.md Normal file
View file

@ -0,0 +1,43 @@
# 버전 매니페스트
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 버전 매니페스트을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 버전 매니페스트은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 버전 매니페스트이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 버전 매니페스트은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 버전 매니페스트 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/02-windows-release-pipeline.md Normal file
View file

@ -0,0 +1,43 @@
# Windows 릴리즈 파이프라인
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: Windows 릴리즈 파이프라인을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- Windows 릴리즈 파이프라인은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 Windows 릴리즈 파이프라인이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 Windows 릴리즈 파이프라인은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 Windows 릴리즈 파이프라인 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/03-web-release-pipeline.md Normal file
View file

@ -0,0 +1,43 @@
# 웹 릴리즈 파이프라인
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 웹 릴리즈 파이프라인을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 웹 릴리즈 파이프라인은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 웹 릴리즈 파이프라인이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 웹 릴리즈 파이프라인은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 웹 릴리즈 파이프라인 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/04-android-release-pipeline.md Normal file
View file

@ -0,0 +1,43 @@
# Android 릴리즈 파이프라인
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: Android 릴리즈 파이프라인을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- Android 릴리즈 파이프라인은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 Android 릴리즈 파이프라인이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 Android 릴리즈 파이프라인은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 Android 릴리즈 파이프라인 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/05-download-host-routing.md Normal file
View file

@ -0,0 +1,43 @@
# 다운로드 호스트 라우팅
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 다운로드 호스트 라우팅을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 다운로드 호스트 라우팅은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 다운로드 호스트 라우팅이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 다운로드 호스트 라우팅은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 다운로드 호스트 라우팅 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/06-release-notes-style.md Normal file
View file

@ -0,0 +1,43 @@
# 릴리즈 노트 스타일
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 릴리즈 노트 스타일을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 릴리즈 노트 스타일은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 릴리즈 노트 스타일이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 릴리즈 노트 스타일은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 릴리즈 노트 스타일 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/07-screenshot-discipline.md Normal file
View file

@ -0,0 +1,43 @@
# 스크린샷 규율
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 스크린샷 규율을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 스크린샷 규율은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 스크린샷 규율이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 스크린샷 규율은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 스크린샷 규율 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/08-checksum-signature.md Normal file
View file

@ -0,0 +1,43 @@
# 체크섬 서명
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 체크섬 서명을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 체크섬 서명은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 체크섬 서명이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 체크섬 서명은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 체크섬 서명 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/09-rollback-playbook.md Normal file
View file

@ -0,0 +1,43 @@
# 롤백 플레이북
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 롤백 플레이북을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 롤백 플레이북은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 롤백 플레이북이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 롤백 플레이북은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 롤백 플레이북 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/10-observability-surface.md Normal file
View file

@ -0,0 +1,43 @@
# 관찰성 표면
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 관찰성 표면을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 관찰성 표면은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 관찰성 표면이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 관찰성 표면은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 관찰성 표면 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/11-backup-drills.md Normal file
View file

@ -0,0 +1,43 @@
# 백업 복구 훈련
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 백업 복구 훈련을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 백업 복구 훈련은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 백업 복구 훈련이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 백업 복구 훈련은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 백업 복구 훈련 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/12-alert-thresholds.md Normal file
View file

@ -0,0 +1,43 @@
# 경보 임계값
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 경보 임계값을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 경보 임계값은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 경보 임계값이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 경보 임계값은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 경보 임계값 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/13-secret-handling.md Normal file
View file

@ -0,0 +1,43 @@
# 비밀값 취급
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 비밀값 취급을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 비밀값 취급은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 비밀값 취급이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 비밀값 취급은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 비밀값 취급 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/14-public-status-page.md Normal file
View file

@ -0,0 +1,43 @@
# 공개 상태 페이지
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 공개 상태 페이지을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 공개 상태 페이지은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 공개 상태 페이지이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 공개 상태 페이지은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 공개 상태 페이지 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/15-release-truthfulness.md Normal file
View file

@ -0,0 +1,43 @@
# 릴리즈 정직성
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 릴리즈 정직성을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 릴리즈 정직성은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 릴리즈 정직성이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 릴리즈 정직성은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 릴리즈 정직성 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/16-artifact-retention.md Normal file
View file

@ -0,0 +1,43 @@
# 산출물 보존
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 산출물 보존을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 산출물 보존은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 산출물 보존이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 산출물 보존은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 산출물 보존 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/17-gitea-release-flow.md Normal file
View file

@ -0,0 +1,43 @@
# Gitea 릴리즈 플로우
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: Gitea 릴리즈 플로우을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- Gitea 릴리즈 플로우은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 Gitea 릴리즈 플로우이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 Gitea 릴리즈 플로우은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 Gitea 릴리즈 플로우 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/18-os-route-design.md Normal file
View file

@ -0,0 +1,43 @@
# OS별 다운로드 라우트
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: OS별 다운로드 라우트을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- OS별 다운로드 라우트은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 OS별 다운로드 라우트이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 OS별 다운로드 라우트은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 OS별 다운로드 라우트 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/19-release-regression.md Normal file
View file

@ -0,0 +1,43 @@
# 릴리즈 회귀 추적
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 릴리즈 회귀 추적을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 릴리즈 회귀 추적은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 릴리즈 회귀 추적이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 릴리즈 회귀 추적은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 릴리즈 회귀 추적 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

43
문서/atlas/10-release-ops/20-ops-readiness-gate.md Normal file
View file

@ -0,0 +1,43 @@
# 운영 준비도 게이트
## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 운영 준비도 게이트을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
## 왜 중요한가
- 운영 준비도 게이트은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.
## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.
## 표준 흐름
1. 사용자는 운영 준비도 게이트이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.
## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 운영 준비도 게이트은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.
## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 운영 준비도 게이트 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.
## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피
## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.

34
문서/atlas/10-release-ops/README.md Normal file
View file

@ -0,0 +1,34 @@
# 릴리즈와 운영 신뢰
이 묶음은 릴리즈와 운영 신뢰 관점에서 사용자 체감 간편함을 세부 주제로 분해한 아틀라스다.
## 범위
- 주요 목적: 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
## 현재 산출물에 대한 비판적 요약
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
## 문서 목록
- [버전 매니페스트](./01-version-manifest.md)
- [Windows 릴리즈 파이프라인](./02-windows-release-pipeline.md)
- [웹 릴리즈 파이프라인](./03-web-release-pipeline.md)
- [Android 릴리즈 파이프라인](./04-android-release-pipeline.md)
- [다운로드 호스트 라우팅](./05-download-host-routing.md)
- [릴리즈 노트 스타일](./06-release-notes-style.md)
- [스크린샷 규율](./07-screenshot-discipline.md)
- [체크섬 서명](./08-checksum-signature.md)
- [롤백 플레이북](./09-rollback-playbook.md)
- [관찰성 표면](./10-observability-surface.md)
- [백업 복구 훈련](./11-backup-drills.md)
- [경보 임계값](./12-alert-thresholds.md)
- [비밀값 취급](./13-secret-handling.md)
- [공개 상태 페이지](./14-public-status-page.md)
- [릴리즈 정직성](./15-release-truthfulness.md)
- [산출물 보존](./16-artifact-retention.md)
- [Gitea 릴리즈 플로우](./17-gitea-release-flow.md)
- [OS별 다운로드 라우트](./18-os-route-design.md)
- [릴리즈 회귀 추적](./19-release-regression.md)
- [운영 준비도 게이트](./20-ops-readiness-gate.md)