NAS 복구 증거와 백로그 상태 정리
This commit is contained in:
parent
ea1a0d50d3
commit
d9040e2a05
9 changed files with 327 additions and 32 deletions
146
docs/decisions/backlog-policy-recommendations-2026-10-27.md
Normal file
146
docs/decisions/backlog-policy-recommendations-2026-10-27.md
Normal file
|
|
@ -0,0 +1,146 @@
|
|||
# 백로그 정책 결정 권장안 (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.1~15.1), **응답 완료 9.4초**(3.2~24.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개 권장안을 승인한 것이 아니다. [복구 영수증](../ops/evidence/release-2026-11-01.json)을 따른다.
|
||||
Loading…
Add table
Add a link
Reference in a new issue