---
title: "vhagar DevOps Codex 세션 핸드오프 정정본"
from: codex
to: ["claude-code", "jadong"]
project: "keeper-direct"
date: 2026-05-08T16:58:30.185060+09:00
status: sent
type: report
---

# 핸드오프: vhagar DevOps Codex 세션 (2026-05-08)

> 다음 작업자: vhagar에서 새로 여는 Codex/Claude DevOps 세션
> 기준 시각: 2026-05-08 16:55 KST
> 프로젝트: `keeper-direct`
> 운영 URL: https://www.keeper-direct.ceo
> 문서클라우드: https://ai.shinjadong.cloud/projects/keeper-direct/

## 0. BLUF

vhagar를 DevOps control box로 쓰는 방향이 현재 가장 빠르다. 프로덕션 앱 서버나 AWS 서버 안에 개인 Claude/Codex OAuth 세션을 넣지 말고, vhagar에서 Codex/Claude CLI, git, Vercel, Supabase, AWS CLI를 열어 운영 감시/배포/테스트를 담당시키면 된다.

현재 keeper-direct 프로덕션은 `main` 커밋 `f18c422`가 배포되어 있고, `/diagnose` 중복 번호/중복 매장 차단 제거까지 반영됐다. `staging`은 이 핸드오프 문서 커밋까지 포함한 최신 상태를 pull하면 되며, 마지막 코드 변경 커밋은 `5cc33d9`다.

## 1. 지금 기준 배포 상태

| 항목 | 값 |
|---|---|
| 로컬 현재 브랜치 | `staging` |
| `origin/staging` | 이 문서가 포함된 최신 staging. `git rev-parse --short origin/staging`으로 확인 |
| `origin/main` | `f18c422 Allow duplicate diagnose submissions` |
| 프로덕션 alias | `https://www.keeper-direct.ceo` |
| 현재 Vercel prod 배포 | `keeper-direct-3j6itzfdi-shinjadongs-projects.vercel.app` |
| Vercel deployment id | `dpl_D184bzQT5ZrYFeEeVyxXHoW1R7Vk` |
| 최근 prod error log | 2026-05-08 16:03 기준 `No logs found` |

## 2. 오늘 반영된 프로덕션 핫픽스

### 관리자 로그인

- 이용진 팀장 관리자 전화번호 추가: `01065151433`
- 파일: `lib/keeper-out/admin-auth.ts`
- prod 반영 커밋: `6a7319a`

### `/diagnose` 사진/속도/실패 처리

- 사진 최소 1장으로 완화
- 사진 업로드 압축/병렬화
- 사진 실패는 리드 저장을 막지 않도록 처리
- Supabase Realtime 대상 테이블 활성화
- prod 반영 커밋: `7269349`

### 제출 성공 화면 오류 수정

- 기존에는 lead 저장 실패가 나도 성공 화면으로 넘어가는 문제가 있었다.
- 지금은 lead 저장 성공을 확인한 뒤에만 `review_pending`으로 이동한다.
- 사진 첨부/SMS/이벤트/지급 side effect는 백그라운드 처리.
- prod 반영 커밋: `0102045`

### 중복 번호/중복 매장 차단 제거

- 제거 대상:
  - `app/api/keeper-out/diagnose/verify/route.ts`
  - `app/api/keeper-out/diagnose/request-otp/route.ts`
  - `app/api/keeper-out/diagnose/route.ts`
- Supabase production unique index 제거:
  - `uniq_keeper_outbound_leads_phone`
  - `uniq_leads_phone`
  - `idx_leads_naver_place_unique`
- 대체 일반 index 생성:
  - `idx_keeper_leads_phone`
  - `idx_keeper_leads_naver_place_id`
- migration 파일:
  - `supabase/migrations/20260508_keeper_outbound_allow_duplicate_leads.sql`
- staging 커밋: `5cc33d9`
- main/prod 커밋: `f18c422`
- 프로덕션 테스트:
  - 같은 테스트 번호 `01000000000`
  - 같은 테스트 매장 ID `codex_duplicate_test_20260508`
  - `/api/keeper-out/diagnose/verify` 2회 연속 `200 OK`
  - 테스트 리드 2건 생성됨

## 3. vhagar에서 바로 시작하는 순서

```bash
cd ~/projects/keeper-direct
git fetch origin main staging
git checkout staging
git pull --ff-only origin staging
git status --short --branch
```

예상:

```text
## staging...origin/staging
```

로컬에 기존 더티 파일이 있으면 무시하지 말고 먼저 `git status`를 읽는다. 자동님/다른 AI가 만든 변경일 수 있으니 `git reset --hard`, `git checkout --`, `rm -rf`는 금지다.

## 4. 세션 시작 루틴

### 전략/컨텍스트 로드

```bash
test -f ~/.openclaw/workspace/STRATEGY.md && sed -n '1,220p' ~/.openclaw/workspace/STRATEGY.md

CB=~/projects/consciousness-bridge
$CB/.venv/bin/python -m src.main --pull
```

### AI Comms inbox 확인

```bash
curl -s https://ai.shinjadong.cloud/api/comms/inbox/codex?status=sent | python3 -m json.tool
```

작업을 잡으면:

```bash
curl -s -X PATCH https://ai.shinjadong.cloud/api/comms/msg/{id}/status \
  -H "Content-Type: application/json" \
  -d '{"status":"claimed"}'
```

완료 보고는:

```bash
curl -s -X POST https://ai.shinjadong.cloud/api/comms/msg \
  -H "Content-Type: application/json" \
  -d '{
    "from": "codex",
    "to": ["claude-code", "jadong"],
    "type": "result",
    "project": "keeper-direct",
    "title": "작업 결과 제목",
    "summary_for_ai": "짧은 요약",
    "content_md": "## 결과\n\n..."
  }'
```

이 `POST /api/comms/msg`가 문서클라우드 발행 경로다. 생성 후 `html_file`이 반환되고, 프로젝트 페이지에 자동으로 나타난다.

## 5. 브랜치/배포 규칙

| 브랜치 | 용도 | 배포 |
|---|---|---|
| `staging` | 기본 작업/검증 | Vercel preview |
| `main` | 프로덕션 | `https://www.keeper-direct.ceo` |

원칙:

- 기본 작업은 `staging`.
- 검증 후 `main` merge/push.
- 영업 필드가 막힌 P0 핫픽스만 `main` 직접 반영 가능.
- `main` force push 금지.
- 기존 더티 파일/유저 변경 revert 금지.

## 6. 빠른 운영 점검 명령

### 프로덕션 alias 확인

```bash
vercel inspect https://www.keeper-direct.ceo
```

### 최근 production 에러 로그

```bash
vercel logs https://www.keeper-direct.ceo --since 20m --level error --no-follow
```

### 페이지 smoke test

```bash
curl -sS -o /dev/null -w "diagnose %{http_code} %{time_total}\n" \
  https://www.keeper-direct.ceo/diagnose

curl -sS -o /dev/null -w "admin login %{http_code} %{time_total}\n" \
  https://www.keeper-direct.ceo/keeper-out/admin/login
```

### AI Comms health

```bash
curl -s https://ai.shinjadong.cloud/api/comms/health | python3 -m json.tool
```

### Supabase production DB 확인

Production direct Supabase project ref는 `hvcrbdpjxfszhwrtcygq`.

```bash
python3 ~/.openclaw/workspace/skills/supabase/scripts/supabase_sql.py hvcrbdpjxfszhwrtcygq --stdin --json <<'SQL'
select indexname, indexdef
from pg_indexes
where schemaname = 'public'
  and tablename = 'keeper_outbound_leads'
  and (indexname ilike '%phone%' or indexname ilike '%naver_place%');
SQL
```

기대: phone/naver_place_id는 unique가 아니라 일반 index다.

## 7. DevOps agent MVP 설계

vhagar에 먼저 상시 세션을 둔다.

```bash
tmux new -s keeper-ops
```

초기 감시 대상:

- `https://www.keeper-direct.ceo/diagnose` 200 여부
- `https://www.keeper-direct.ceo/keeper-out/admin/login` 200 여부
- Vercel production deployment 상태
- Vercel production error logs
- Supabase DB/API health
- `https://ai.shinjadong.cloud/api/comms/health`
- `https://ai.shinjadong.cloud/api/comms/inbox/codex?status=sent`

권장 구조:

```text
vhagar
  - Codex/Claude CLI 로그인
  - git/vercel/supabase/aws CLI
  - ops-agent 또는 tmux 세션
  - AI Comms inbox polling

Vercel/Supabase/AWS
  - 프로덕션 서비스 실행
  - vhagar에서 상태 조회/배포/검증
```

금지:

- 프로덕션 서버에 개인 Claude/Codex OAuth 저장
- 앱 서버를 만능 AI 작업 머신으로 사용
- AWS 보안그룹/공유기 포트포워딩을 불필요하게 개방
- `CloudWatch Logs` 대량 수집, `NAT Gateway`, 새 EC2 상시 운영 등 비용 증가 구조를 1단계에서 도입

## 8. 비용 판단

현재 단계에서는 vhagar polling 중심이 맞다. AWS에 새 서버를 띄우거나 CloudWatch/EventBridge/SSM을 과하게 붙일 필요 없다.

1단계 비용은 사실상 vhagar 전기세/회선 비용이다. AWS 쪽은 기존 리소스 조회 위주로만 쓴다.

나중에 장애가 반복되면 그때 다음 순서로 확장한다.

1. systemd timer로 smoke test 자동화
2. AI Comms alert 자동 생성
3. Vercel/Supabase 장애 패턴별 runbook 추가
4. CloudWatch/EventBridge/SSM 자동복구는 마지막 단계

## 9. 현재 로컬 작업트리 주의

이 문서를 작성한 laptop_predator 작업트리는 원래부터 더티 파일이 많았다. 이 핸드오프 커밋은 새 문서 파일만 포함해야 한다.

관측된 unrelated 변경:

- `CLAUDE.md`
- `docs/dashboard-backlog/README.md`
- `lib/keeper-out/catchrank.ts`
- `.github/`
- `app/api/keeper-out/catchrank/sync-places/`
- `app/landing/*`
- `context/*`
- `data/*`
- `docs/2026-trend-report-recon/`
- `public/assets/`
- 여러 `scripts/*`

새 작업자는 이 파일들을 임의로 되돌리지 않는다.

## 10. 새 세션 첫 응답 가이드

vhagar에서 Codex를 열면 먼저 이렇게 확인한다.

```text
BLUF: keeper-direct staging은 이 핸드오프 문서까지 포함한 최신 상태, main/prod는 f18c422까지 반영된 상태입니다.
staging의 마지막 코드 변경은 5cc33d9 중복 제출 허용 커밋입니다.
중복 번호/중복 매장 차단은 제거됐고, www.keeper-direct.ceo alias는 최신 production 배포를 보고 있습니다.
이제 vhagar DevOps 세션으로 AI Comms inbox와 production smoke test부터 확인하겠습니다.
```

그 다음 바로 `git status`, AI Comms inbox, Vercel inspect, smoke test를 실행한다.