vignette/docs/decisions/backlog-policy-recommendations-2026-10-27.md

14 KiB

백로그 정책 결정 권장안 (2026-10-27)

상태: 소유자 검토 대기. 소유자가 2026-10-27 "권장안 문서로 한 번에 검토"를 선택했다. 각 항목의 소유자 결정 칸이 채워지기 전에는 아무것도 실행하지 않는다. 근거 조사는 같은 날 읽기 전용으로 했다(운영 NAS·DB 읽기, 코드·git 이력).

0. 같은 날 이미 확정된 결정

ID 소유자 결정 (2026-10-27) 처리
운영 로그인 읽기 순회 + 상담 연습 3회 이내 허용 인증 화면 재측정, JEV-002 대사 관찰, USER-LATENCY 실측에 사용
REQ-008 NAS 재부팅 실증 보류 공유 NAS라 다른 프로젝트도 멈춘다. 터널은 이미 자동 재시작 컨테이너다. 소유자 보류로 옮긴다
RETENTION-001 실제 적용·정기 실행 승인 → 켜기 보류(재확인 필요) 승인 질문에 "지금 적용해도 바로 지워지는 건 없다"고 잘못 안내했다(10-20 dry-run의 삭제 0건은 dry-run이라 항상 0). 2026-10-27 배포 전 측정: 원본 14,685건 중 7일 지난 14,195건이 일별 집계로 묶이고 90일 지난 9,375건(2026-06-28~)이 첫 실행에서 삭제된다. 코드와 compose 설정은 배포하되 env.nas에서 켜지 않았다. 배포 전 DB 백업 backups/pre-release-20261027-ea1a0d50.dump(12,277,784 bytes)에 원본이 남아 있다

1. 권장안 요약

# 항목 권장안 바꾸는 것 되돌리기
1 자동 배포 (PIPELINE-001) 도입하지 않는다. 승인 뒤 스크립트로 하는 수동 배포를 유지한다 없음. 백로그 항목 종료 언제든 다시 열 수 있다
2 터널 제거 지시 (INGRESS-001) 터널을 유지하고 제거 지시를 철회한다 문서의 "제거 대상" 문구 정리 대체 경로를 설계하면 다시 연다
3 백업 운영화 (BACKUP-001) 보존 결함을 고치고, 월 1회 복원 훈련, 외부 복제는 이 PC로 주 1회 암호화 복사 compose의 백업 사이드카 명령, 훈련 스크립트, PC 예약 작업 사이드카 명령을 이전으로 되돌린다
4 DB 변경 실행기 (MIGRATION-001) 도입하지 않는다. 트랜잭션 수동 적용과 영수증을 유지한다 없음 다시 열 수 있다
5 Node 전환 (NODE-001) 보류. FastAPI를 유지한다 없음. L1-001 제출 문서에는 "FastAPI 유지"로 쓴다 다시 열 수 있다
6 운영 티켓 자동화 (OPS-001) 하지 않는다 없음 다시 열 수 있다
7 eval_hook (EVALHOOK-001) 현행 유지. 턴 평가 hook은 지금처럼 주입하고 실패해도 상담을 막지 않는다. fast-loop 전용 hook은 FASTLOOP 재개 때 정한다 없음 —
8 음성 s2s·외부 fallback 시험 (VOICE-001·FASTLOOP-001) 보류 없음 다시 열 수 있다
9 .codex/ 폴더 전역 ~/.codex/agents/에 설치하고 프로젝트 사본을 지운다 이 PC의 Codex 설정 프로젝트 사본을 다시 둔다
10 GitHub 미러 기존 지시대로 private 미러 갱신을 재개한다 origin에 master push(2026-09-09 이후 멈춤) 미러 갱신 중단을 문서화
11 Cloudflare LAX 경로 계속 관찰한다 없음 —
12 손상 프로필 사진 참조 6건 (AVATAR-001) 6건의 avatar_url을 비운다(화면은 지금도 이니셜) 운영 DB 6행 이전 값 영수증으로 복원
13 운영 DB의 시험용 계정 지우지 않고 그대로 둔다. 목록만 영수증으로 남긴다 없음 —
14 라이브 코칭 프롬프트의 사례개념화 틀 유지한다 없음 문단을 B등급 공식 지침 문구로 바꿀 수 있다
15 소유자 계정의 0턴 진행 중 회기 4건 종료한다(P3·P4·P5·P7, 2026-08-18 생성, 발화 0) 운영 DB 4회기 상태 되돌릴 필요 없음(0턴은 집계 제외)
16 DB 커밋 확정 대기 (USER-LATENCY) 앱 DB 계정만 synchronous_commit=off로 바꾼다 운영 DB 역할 설정 1줄 ALTER ROLE ... RESET synchronous_commit

2. 항목별 근거

1. 자동 배포 (PIPELINE-001)

  • 지금 배포는 Forgejo clone → SHA 대조 → NAS 빌드 → env.nas 사본·pin → up -d --no-deps → 검증 영수증 순서다. web 전용은 scripts/release-20261026-web.sh, API는 2026-10-20·25 스크립트가 NAS에 있다.
  • 자동화하면 소유자 승인 없이 운영이 바뀔 수 있다. AGENTS.md B.10은 배포를 소유자 확인 뒤 직접 하는 작업으로 묶는다. 배포 빈도(주 1~3회)도 자동화 비용을 정당화하지 못한다.

2. 터널 제거 지시 (INGRESS-001)

  • deployment-pipeline.md 목표 아키텍처에 "Cloudflare tunnel은 소유자 지시에 따라 제거 대상"이라고 적혀 있다.
  • 대안은 NAS 포트 개방이다. 그러면 공유기 포트포워딩, 인증서 갱신, 집 네트워크 노출, 고정 IP·DDNS가 필요하다. 터널은 들어오는 포트 없이 TLS를 준다.
  • 2026-10-25부터 터널은 자동 재시작 compose 컨테이너라 재부팅 장애 원인도 없어졌다. 제거할 이유가 남아 있지 않다.
  • 소유자에게 확인할 점: 원래 제거를 지시한 이유(비용, 의존성, 속도 등)가 따로 있었다면 알려 주시면 그 이유에 맞춰 다시 판단한다.

3. 백업 운영화 (BACKUP-001)

현재 상태(2026-10-27 확인):

  • 사이드카가 하루 1회 pg_dump -Fc → pg_restore -l 확인 → 확정한다. 최근 400시간 실패 0건, 보관 15개(10-13~10-27).
  • 같은 날 복원 훈련: 최신 백업을 네트워크 없는 임시 컨테이너에 --exit-on-error로 복원해 9초 만에 118개 표가 모두 들어왔다. 92개 표는 운영과 행 수가 같고 26개는 이후 사용량만큼 늘었다(줄어든 표 0). 영수증: NAS receipts/restore-drill-20261027T*.

발견한 결함:

  • 실패해도 14일 지난 백업을 지운다. 15일 넘게 연속 실패하면 자동 백업이 0개가 된다. 중단된 .partial 파일도 정리하지 않는다.
  • 실패는 stderr 한 줄뿐이고 알림이 없다. 백업은 DB와 같은 NAS에만 있고 암호화되지 않는다. 업로드 파일(프로필 사진 93개)은 백업 대상이 아니다.

권장안:

  1. 사이드카 명령 수정: 이번 회차가 성공했을 때만 오래된 백업을 지우고, 최신 7개는 기간과 무관하게 남긴다. 1시간 넘은 .partial은 정리한다. 업로드 폴더도 같은 날짜로 묶어 보관한다.
  2. 월 1회 복원 훈련: 오늘 쓴 scripts/restore-drill.sh를 저장소에 넣고 매월 실행 영수증을 남긴다.
  3. 외부 복제: 이 PC가 주 1회 최신 백업을 받아 암호화(7-Zip AES-256, 암호는 소유자 보관) 후 D:\vignette-backups\offsite에 보관한다. 이 PC가 꺼져 있으면 다음 기회에 받는다. 클라우드(Google Drive 등)를 원하시면 계정 연결이 필요하다.
  4. 실패 알림: 관리자 화면 상태 카드에 "마지막 백업 시각"을 보여 주고 26시간이 지나면 경고로 표시한다. 외부 계정이 필요 없다. 메일·메신저 알림을 원하시면 채널 계정이 필요하다.

4. DB 변경 실행기 (MIGRATION-001)

  • infra/db/init/NN은 첫 기동 전용이고, 기존 볼륨에는 트랜잭션으로 수동 적용한 뒤 영수증을 남긴다(migration 23·24·25가 이 방식으로 적용됐다).
  • 실행기를 넣으면 적용 이력 표·잠금·실패 복구를 새로 운영해야 한다. 변경 빈도가 낮아 지금 방식이 더 안전하다.

5. Node 전환 (NODE-001)

  • API 1283개·게이트웨이 82개 테스트가 FastAPI 위에 있다. 전환 이득을 뒷받침하는 측정이 없다.
  • 연관: L1-001(저작권·등재 문서)은 "FastAPI 유지 사유"를 쓰는 쪽으로 정리한다.

6. 운영 티켓 자동화 (OPS-001)

  • 관리자 화면에 티켓 목록(/admin/tickets)이 이미 있다. 자동으로 이슈·PR을 만드는 일은 승인·감사 경계만 늘린다.

7. eval_hook (EVALHOOK-001)

  • 지금 텍스트·음성 턴 생성에 evaluator.make_eval_hook이 주입되고, 평가가 실패하면 None으로 흡수해 상담을 막지 않는다(apps/api/app/services/evaluator.py).
  • 이 동작을 정책으로 확정한다. fast-loop(로컬 우선 분류기)용 hook은 FASTLOOP-001을 다시 열 때 정한다.

8. 음성 s2s·외부 fallback 시험 (VOICE-001·FASTLOOP-001)

  • 둘 다 학습자 발화나 음성을 외부 공급자로 보내는 범위를 넓힌다. 동의 문구·전송 가드·비용 승인이 먼저다. 파일럿(P3-001) 동의 체계가 서기 전에는 보류가 맞다.

9. .codex/ 폴더

  • AGENTS.md B.8은 워커 정의를 전역 ~/.codex/agents/에 두고 프로젝트 .codex/는 쓰지 않는다고 적는다(openai/codex#26408 회피).
  • 실제로는 전역 폴더가 없고, 프로젝트 .codex/agents/*.toml 4개가 유일한 정의다. 내용은 docs/ops/codex-agents/ 참조 사본과 같다.
  • 권장: docs/ops/codex-agents/README.md 절차로 전역 설치(toml 4개 복사, ~/.codex/config.toml의 [agents] 확인) 뒤 프로젝트 사본을 지운다. ~/.codex/config.toml은 과거 손상 백업이 여러 개 있으니 편집 전 사본을 남긴다.

10. GitHub 미러

  • 목표 아키텍처는 "github.com은 private로 백업/미러만 유지한다(제거 아님)"이다. 그런데 origin/master는 2026-09-09 aa951c6c에서 멈춰 있다.
  • 권장: 저장소가 private인지 확인한 뒤 git push origin master로 갱신을 재개하고, 릴리스 절차에 미러 push를 넣는다.

11. Cloudflare LAX 경로

  • 한국 요청이 LAX 거점으로 처리된다. 2026-10-26 글꼴·이미지 경량화로 공개 로그인 첫 접속은 708,839 bytes로 줄었고, 인증 화면 순회(캐시 끔)도 화면 오류 0이다. 실제 사용자 진단 보고가 생기면 다시 본다.

12. 손상 프로필 사진 참조 (AVATAR-001)

  • 운영 확인(2026-10-27): 업로드 사진 참조 9건 중 정상 3건은 200, 6건은 404다. 404인 6건의 파일은 모두 과거 E2E가 올린 70바이트 시험 PNG(sha256 903790997f00…)이고, 주인은 2026-08-18~28에 만들어진 onbo…·swee… 시험용 계정이다.
  • 손상 대비 코드(깨진 파일 404, 화면 이니셜 대체)는 2026-09-01부터 운영에 있다. AVATAR-001의 검증 부분은 이것으로 닫는다.
  • NAS manifest 모드는 옛 Windows 공개 런타임 전용 설계라 켜지 않는다.
  • 권장: 6건의 avatar_url을 비운다. 화면은 지금도 이니셜이라 바뀌는 것이 없고, 데이터만 정합해진다. 이전 값은 영수증에 남긴다.

13. 운영 DB의 시험용 계정

  • 운영 계정 1,387개 중 1,342개가 hs.ac.kr, 그중 이름이 시험용 접두어(e2e·onboard·sweep·test 등)인 계정이 60개다. 옛 Windows 공개 런타임 시절 E2E가 운영 DB를 쓴 흔적으로 보인다.
  • 지우면 회기·평가 기록이 연쇄 삭제되고 집계가 바뀐다. 권장은 그대로 두고 목록만 영수증으로 남기는 것이다. 파일럿 전에 집계에서 빼야 하면 그때 표시 열을 추가한다.

14. 라이브 코칭 프롬프트의 사례개념화 틀

  • 2026-08-28부터 라이선스 C/D 근거(0615 워크북 포함)는 외부 AI 근거 목록에서 빠진다. API·DB·E2E가 이를 고정한다.
  • 시스템 프롬프트에는 "첫 회기 호소를 신체·인지·정서·행동·대인관계로 나누고 촉발사건을 단정 없이 탐색한다" 수준의 짧은 일반 틀 문단이 있다. 워크북 원문이 아니고, 워크북 자료에도 "식별성이 제거된 분석틀 요약은 사용 권한 확인됨"이라고 적혀 있다.
  • 권장: 유지한다. 더 엄격히 하려면 이 문단을 B등급 공식 지침 문구로 바꿀 수 있다.

15. 소유자 계정의 0턴 진행 중 회기

  • 2026-10-27 확인: 소유자 계정에 2026-08-18에 만들어진 발화 0개 진행 중 회기가 P3·P4·P5·P7 4건 남아 있다. 같은 페르소나로 새 회기를 열면 409로 이 회기로 이동한다.
  • 0턴 회기는 완료·배지 집계에서 빠진다(REQ-010). 종료해도 잃는 기록이 없다. 상담 연습 허락 범위 밖이라 결정을 받은 뒤 종료한다.

16. DB 커밋 확정 대기 (USER-LATENCY)

  • 2026-10-27 운영 실측(소유자 계정 상담 연습 2회기·7턴, 텍스트 입력, 마이크 미사용): 보낸 뒤 글 표시 중앙값 5.3초(3.115.1), 응답 완료 9.4초(3.224.8), 음성 준비 13.4초(5.5~30.4). 글이 보인 뒤 완료까지 중앙값 3.2초, 완료 뒤 음성 합성까지 중앙값 4.2초다.
  • 글 표시와 완료 사이에는 감사 기록 커밋과 턴 저장 커밋이 있다. 평가는 이미 백그라운드다. 같은 날 NAS 확정 쓰기는 4KB당 약 265ms(20회 5,314ms)였고, DB는 synchronous_commit=on이라 커밋마다 디스크 확정을 기다린다. 2026-10-25 /auth/me 1~4초 지연도 같은 원인이었다.
  • 이미 하는 일(코드, 의미 변화 없음): 감사 기록 커밋을 done 뒤로 옮겨 커밋 한 번을 사용자 대기에서 뺀다.
  • 권장: 앱 DB 계정(vignette 역할)만 synchronous_commit=off로 둔다. 커밋은 디스크 확정을 기다리지 않고 WAL 기록기가 0.2초 단위로 확정한다.
    • 얻는 것: 턴 저장·로그인 확인 등 모든 쓰기 요청에서 커밋당 0.3~0.9초 대기가 사라진다.
    • 잃을 수 있는 것: NAS 정전·커널 멈춤 같은 사고 때 마지막 약 0.6초 안에 커밋된 기록이 사라질 수 있다. DB가 깨지지는 않는다(일관성 유지). 컨테이너 재시작·정상 종료에는 영향이 없다.
    • 되돌리기: ALTER ROLE vignette RESET synchronous_commit; 한 줄.
  • 대안: NAS 디스크를 SSD로 옮기거나 다른 프로젝트의 쓰기 부하를 줄인다(공유 호스트라 소유자 결정).

3. 소유자 결정 기록

# 소유자 결정 날짜
1~16 (검토 대기)

2026-11-01 상태 정정

추가 권장안 1~16은 모두 미승인이다. 위 RETENTION-001의 켜기 보류는 10/27 당시 기록이다. 이후 소유자의 별도 재승인에 따라 coordinator가 11/1 영구 백업을 보존하고 활성화·첫 자동 실행을 검증했다. 이는 위 16개 권장안을 승인한 것이 아니다. 복구 영수증을 따른다.