Feature #506
closedFeature #400: 동백쉴만한교회 홈페이지 CMS 요구사항 분석 및 개발 WBS 수립
Feature #415: [통합] 기능 연결·전체 QA·스테이징 배포
[통합-08] 전반적 홈페이지 편집 권한·미리보기·복원 UAT
Added by 성용 양 29 days ago. Updated 15 days ago.
100%
Description
목적¶
비개발 실사용자가 홈페이지 전반을 안전하게 수정할 수 있는지 인수 검증합니다.
전제·입력¶
- 선행: 통합-03~통합-06
작업 내용¶
- 메뉴·3종 페이지·이미지 수정 시나리오 (메인 블록·공통 설정은 A-10·A-11 완료 시에만 포함)
- 편집자 미리보기→승인자 게시→공개 반영 흐름
- 변경 이력·이전 버전 복원·잘못된 구성 차단
- PC·모바일 전체 화면 회귀
사용 기술·도구¶
관리자 UAT, 권한·미리보기·복원 점검
※ 완료된 일감의 기술·산출물은 계획 기준 요약이며 실제 구현은 연결된 GitHub PR을 따릅니다.
산출물¶
UAT 결과와 수정 PR
완료 기준¶
- 코드와 서버 접속 없이 대표 콘텐츠·구성 변경 가능
- 비공개 변경이 승인 전 노출되지 않음
- 실사용자 체크리스트와 운영 매뉴얼 승인
테스트·디버깅¶
- 메인 블록 대량 재정렬·삭제 영향
- 권한 없는 전역 설정 변경
- 복원 후 캐시·검색·SEO·반응형 일관성
이 일감에서 하지 않는 것¶
신규 기능은 하지 않는다
연결 일감·충돌 관리¶
- 선행: 통합-03~통합-06
- 주 소유 경로: 통합 E2E·UAT·운영 문서
성양 Updated by 성용 양 29 days ago Actions #1
- Follows Feature #447: [통합-06] 빈 환경 스테이징 배포·백업 복원 훈련 added
성양 Updated by 성용 양 29 days ago Actions #2
- Follows Feature #445: [통합-04] 보안·접근성·브라우저 회귀 QA added
성양 Updated by 성용 양 29 days ago Actions #3
- Follows Feature #444: [통합-03] 관리자 작성→공개 E2E 테스트 (관리자 1명·승인 없음) added
성양 Updated by 성용 양 29 days ago Actions #4
- Follows Feature #446: [통합-05] 주보 PDF 시각 비교·실물 인쇄 회귀 added
우심 Updated by 우섭 심 27 days ago Actions #8
- Status changed from In Progress to Resolved
- % Done changed from 50 to 100
UAT 완료 (2026-10-21, 스테이징 https://sulfite-footbath-next.ngrok-free.dev/church/)
결과: 36/36 통과
- 최고 관리자·편집자(교회 소개 담당)·주보 담당·승인자 계정으로 0~7번(준비, 고치기→승인→공개, 3종 페이지, 사진, 메뉴·권한, 변경 이력·복원, 주보, PC·휴대폰 화면) 시험
- 1-8(편집자 첫 화면에 반려 사유 안 보임)만 처음에 실패 → PR #39로 수정, 배포(main f7fd8e7) 뒤 재시험 통과
시험 중 고친 결함
- PR #39 반려 사유 표시·승인 문구 한국어
- PR #42 주보 수정 화면 자동 저장 끄기(자동 저장 뒤 직접 저장이 "다른 사람이 먼저 저장"으로 막힘)
- PR #43 휴대폰 메뉴 버튼 이름·본문 사진 대체 글(접근성)
- PR #44 관리자 영어·어색한 문구 한국어("출시된"→"게시됨" 등)
문서: docs/UAT_CHECKLIST.md (PR #41, 재시험 PR #45)
남은 개선 후보(U-1~U-17 중): 빈 상자·미리보기 탭 가림·사용자 이름 순서·메뉴 이름 불일치·게시판 번호·시드 첫 버전(A 확인), 역할 지정·"워크플로우" 용어(매뉴얼 보강), 41·42호 순서 이름 없는 줄(튜터 확인), 게시된 주보 수정 중 상태 표시, "7 Pages" 번역
시험 흔적(시험 문구·글·주보 "(UAT)")은 모두 정리함
성양 Updated by 성용 양 23 days ago Actions #11
한 줄 요약¶
실제 사용자처럼 스테이징 서버에서 시험(UAT)하다 발견한 문제들을 모두 고치고 재시험까지 통과했습니다(36/36).
왜 했나 (목적)¶
개발자가 "된다"고 확인한 것과, 교회 운영자가 실제로 써 볼 때 막히는 것은 다릅니다. 그래서 완성된 화면을 체크리스트로 하나씩 눌러 보고, 불편하거나 이상한 곳을 찾아 고치는 일감입니다.
어떤 순서로 했나¶
- 체크리스트 작성·시험: docs/UAT_CHECKLIST.md에 시험 항목을 만들고 스테이징 서버에서 진행(PR #41).
- 문제 발견 → 고치는 PR 작성: 아래 표 참고.
- 스테이징에 배포 후 1~8번 재시험: main f7fd8e7로 배포, 마이그레이션 4개 적용, 예시 데이터 다시 넣기, 백업 1회 실행해 "모든 항목 정상" 확인, 재시험 통과 → 36/36(PR #45).
- 추가 보완: 게시판 번호 표시(U-10)는 PR #62로 따로 고쳤습니다.
발견한 문제와 고친 방법¶
- U-6 (PR #39): 승인자가 반려 사유를 적어도 편집자의 첫 화면에는 페이지 이름만 보임 → 첫 화면 알림에 "— 사유: …"를 함께 보이게 함. 사유는 DB에 이미 저장되어 있었음.
- U-7 (PR #39): 관리자 화면 번역이 깨져 있었음("변경이 로 요청되었습니다…") → 문구를 "변경 요청됨 — 승인자 검토" 등으로 덮어씀.
- U-8 (PR #44, #45): 관리자 화면에 영어와 어색한 문구가 남아 있음 → 한국어로 수정, "7 Pages"는 "페이지 7개"로.
- U-12·U-13 (PR #43): 휴대폰 메뉴 버튼 이름이 불분명하고 본문 사진의 대체 글이 없음 → 버튼 이름과 대체 글 추가(시각장애인 접근성).
- U-16 (PR #42): 주보 수정 화면의 자동 저장이 의도치 않게 동작 → 자동 저장을 끔(저장 충돌 방지).
- U-10 (PR #62): 게시판 번호가 오래된 글부터 매겨져 있음 → 최신 글부터 큰 번호로 표시, 공지는 고정 글을 "공지"로 표시, 비공개 글은 번호 계산에서 제외.
사용한 도구¶
- Claude Code(AI 코딩 도구): PR #39는 "Generated with Claude Code"로 작성되었습니다.
- pytest / Ruff / Django check: 자동 테스트와 코드 검사. PR #62 기준 전체 428개 통과(Windows PDF 5개 건너뜀, PostgreSQL 전용 1개 제외).
- Windows + Docker(Linux) 양쪽 검증, Codex 자동 리뷰와 사람 리뷰(양성용 승인).
결정한 것과 이유¶
- 반려 사유를 첫 화면에 보여 주기로 함: 사유를 보려고 메뉴를 세 단계 들어가야 했기 때문입니다.
- 번역은 Wagtail 기본 번역 일부를 프로젝트에서 덮어쓰기: 기본 번역 자체가 깨져 있어 고칠 곳이 없었기 때문입니다.
- 스테이징 매일 백업 시간을 한국 저녁 8시로 변경: 학원 서버가 밤에 꺼질 수 있어서입니다. 백업 중 약 10초 홈페이지가 멈춥니다.
결과¶
UAT 36/36 통과. 완료 처리했습니다.
근거¶
GitHub PR #39, #41, #42, #43, #44, #45, #62.