려 작업 실수와 재발방지 원칙 문서 원본 보기

= 려 작업 실수와 재발방지 원칙 =

이 문서는 현과 함께 일하는 개인 에이전트 려가 실제 작업 중 저지른 실수와, 같은 실수를 반복하지 않기 위한 운영 원칙을 기록한다.

== 2026-06-27 충북교구레드플레그 /cbred 관리자 페이지 분리 누락 ==

=== 상황 ===

현은 `충북교구레드플레그` 관리자 화면을 요일별·단계별로 나누어 운영하도록 요청했다.

요구된 흐름은 다음과 같았다.

* 전주 결과
* 이번주 출결
* 목회자 발송현황
* 응답현황
* 발송현황

이 흐름은 단순한 한 화면 안의 요약 섹션이 아니라, 실제 관리자 업무가 단계별로 전환되는 별도 페이지 구조로 이해해야 했다.

=== 실제 실수 ===

려는 요구를 충분히 확인하지 않고 `/cbred` 한 페이지 안에 `#prev`, `#attendance`, `#pastor`, `#response`, `#delivery` 같은 앵커 섹션으로만 나누었다.

그 결과 겉으로는 항목이 나뉘어 보였지만, 현이 요구한 "페이지 분리"는 구현되지 않았다.

=== 원인 ===

* "요일별로 달라져야 한다"는 말을 화면 구성의 강조 순서로만 해석했다.
* "페이지를 나누라"는 요구를 실제 라우트와 URL 단위 분리로 고정하지 않았다.
* 작업 완료 보고 전에 URL 단위로 페이지가 분리되었는지 직접 확인하지 않았다.
* 사용자의 불만이 나온 뒤에도 처음에는 코드 위치 확인만 하고 실제 수정 전에 진행 상황을 길게 설명했다.

=== 재발 방지 원칙 ===

앞으로 현이 "페이지를 나누라", "화면을 분리하라", "단계별 페이지"라고 말하면 다음을 기본값으로 한다.

* 앵커 링크가 아니라 실제 URL 라우트를 만든다.
* 사이드 메뉴와 상단 이동 버튼도 `#id`가 아니라 별도 경로를 가리키게 한다.
* 각 페이지는 독립 제목, 독립 본문, 독립 처리 흐름을 가져야 한다.
* 완료 보고 전에는 최소한 각 URL이 실제로 열리는지 확인한다.
* "수정 완료"라고 말하기 전에 사용자의 표현을 기준으로 수용 조건을 다시 대조한다.

== /cbred 페이지 분리 기준 ==

`/cbred` 계열 화면은 다음 구조를 기준으로 한다.

* `/cbred` - 주간 운영 개요
* `/cbred/prev` - 전주 결과
* `/cbred/attendance` - 이번주 출결
* `/cbred/pastor` - 목회자 발송현황
* `/cbred/response` - 응답현황
* `/cbred/delivery` - 발송현황
* `/cbred/settings` - 수집 설정

설정 저장 같은 POST 동작은 기존 호환성을 위해 `/cbred/settings`에서 처리하되, 저장 후 설정 페이지로 돌아가게 한다.

== 작업 태도 원칙 ==

* 현이 화를 낼 만한 지점에서는 변명보다 바로 원인, 현재 상태, 다음 조치를 말한다.
* 이미 지적받은 요구사항은 구현 전까지 "완료"라고 표현하지 않는다.
* 중간 보고는 짧게 하되, 실제 작업을 멈추지 않는다.
* 한 번 틀린 해석은 로컬 메모리와 위키 기록 양쪽에 남긴다.

[[분류:최동우기획]]
[[분류:려운영기록]]