가입 화면의 운영 안내와 문의 경로를 실제 운영 정보로 연결 (2026-09-07)
- 기간: 2026-09-07. 사용자가 확정한 운영 정보를 먼저 제품에 넣어 v0.17.1에 포함하도록 요청했고, 릴리스 준비에서 최신 main과 통합했다.
- 랜딩: PR #1298, 이슈 #1297. 초기 head
90152234, 통합 base07c04f37. 최종 SHA·CI·staging 증거는 PR과 릴리스 준비 #1324에 기록한다. - 설계서: 없음(확정된 정보의 기존 화면 연결).
- 정본: onboarding props, desktop screens props, profile props, 검토 자료의 적용 범위.
- 도구/게이트: 기존 ci:local·법률문서 불변 검사·문서 사이트 빌드·가입 안내 행동 검사. SQL·pgTAP·기존 E2E 변경 없음.
1. 배경
운영 주체·보호책임자·공식 문의처는 확정됐지만 앱의 문의 경로와 로그인 안내가 이전 내용을 사용했다. 전체 새 법률문안과 동의·권한 구현은 아직 후속 작업이라 확정 정보와 검토 자료의 적용 범위를 구분해야 했다.
2. 문제 제기
로그인만으로 동의한 것으로 간주한다는 문구가 가입 단계의 실제 확인 흐름과 어긋났다. 운영 안내와 계정 삭제 안내 사이를 이동할 때 기존 가입 화면을 유지하고 문서를 처음부터 읽을 수 있어야 했다. 미확정 검토 자료를 개발 문서 사이트가 일반 페이지로 발행하면 확정된 법률문서로 오인할 수 있었다.
3. 해결 방안
사용자가 확정한 운영 주체·책임자·문의처·무료 운영·현재 공개 범위를 별도 안내로 제공한다. 안내 열람은 정보 조회이며 새 동의 이력을 쓰지 않는다. 기존 v1~v4 원문과 서버 요구 동의 버전을 보존하고 전체 v5 활성화·거부/철회 권한·사본 파기 구현은 후속으로 둔다.
4. 적용한 내용
public/legal/service-info.html과 앱 문의 주소를 연결했다. 모바일은 기존 문서 overlay 안에서 운영 안내와 계정 삭제 안내를 열고, 문서 이동 시 스크롤을 초기화하며 닫기/뒤로가기로 원래 화면에 돌아간다. 데스크톱은 새 탭 열람을 사용한다. 계정 삭제 안내는 운영 데이터와 복구용 사본의 처리를 구분한다.
미확정 v5 문안·검토·사실표는 저장소에 보존하고 VitePress 페이지/검색 대상에서 제외한다. README에는 적용 범위만 남긴다. 최신 main의 U01 버튼 연결은 유지했으며, 새 검토 자료와 행동 검사를 auth 영역 장부에 등록했다.
기존 Windows 체크아웃에서 CRLF가 검사에 걸렸다. 저장소의 LF 정규화 도구로 내용 변경 없이 해결하고 검사를 다시 통과했다.
5. 적용 결과
| 항목 | 결과 |
|---|---|
| 최신 main 통합 로컬 CI | verify-only 6단계 통과, 1분 42초. 2,881 pass·0 fail·DB 환경 의존 14 skip(총 2,895) |
| 앱/문서 build | 성공. 미확정 3개 문서의 개별 HTML이 생성되지 않음 |
| 법률문서 불변 | v1~v4 원문·서버 동의 버전 유지 |
| 최초 구현 브라우저 확인 | 모바일 운영 안내→계정 삭제 안내→닫기/뒤로가기·스크롤 초기화, 데스크톱 새 탭과 원래 로그인 화면 유지 |
| 원격/배포 | 최종 head의 CI 및 main 병합 후 staging은 PR/이슈에 실제 실행 링크로 기록 |
| 미실행/후속 | 새 v5 동의·철회·권한 구현, 실제 문의 메일 송수신, Production 배포는 이 PR의 완료로 합산하지 않음 |
6. 이번 개선으로 향상된 것
가입 전 현재 운영 정보를 확인하고 일관된 공식 문의 경로를 사용할 수 있다. 확정 안내와 미확정 문안의 공개 경계를 코드와 문서 설정으로 유지한다. 전체 아키텍처 작업의 완료 상태는 총괄 로드맵과 구분하며, 이슈는 v0.17.1 릴리스 전까지 스테이징 상태로 유지한다.