Files
dbx-main/docs/CODE_REVIEW_2026-10-15.md
T
king c7cc94a09c fix: 2026-10-15 코드 검토 F01~F10 — 수집 실패 전파·트랜잭션 경계·저장 실패·공지 버전/확인 조건·테스트 체계
- F01 쿠팡: HTTP 200 비JSON·data 목록 없음은 수집 실패(기간 교체 안 함), 정상 빈 목록과 구분
- F02 회의록 [적용]: 업무 INSERT 와 줄 연결을 한 연결·한 트랜잭션(_insert_task), 확인은 잠그기 전·알림/메일은 커밋 뒤, 줄 바뀜 409
- F03 업무 등록 표: persist 실패 전파, 미저장이면 [적용] 중단, 초안 유지·다시 저장·이탈 경고
- F04 인증정보 변경 시 내부 토큰 삭제 + 네이버·토스 토큰을 발급 인증정보 지문(SHA-256)에 묶음, GS샵 방식 캐시도 키 지문 기준
- F05 쪽 수 상한·커서 반복 = 실패(쿠팡은 구간을 하루까지 나눠 재시도), 네이버·카카오·토스·GS샵 동일 기준
- F06 [중지] 확인과 저장 시작을 같은 잠금(begin_saving), 저장 시작 뒤 중지 불가
- F07/F08 긴급 공지: 내용 version·고친 공지 다시 그리기·확인에 version(409), 확인은 행 잠금 트랜잭션에서 수신자·표시 시각·취소 검증
- F09 쇼핑몰 연결 테스트도 clear 처리·저장 안 한 시험은 상태 유지(광고 테스트와 같은 계약)
- F10 DB 테스트 skip·가짜 app.main/time.sleep 파일 범위 fixture, 오래된 기대값 갱신, pytest.ini·requirements-dev·tests/js/package.json·docs/TESTING.md
- 결과·후속 과제: docs/CODE_REVIEW_2026-10-15_RESULT.md (마이그레이션·환경변수 변경 없음)

Python 440 passed/63 skipped(DB 없음), 503 passed(로컬 PostgreSQL), jsdom 7종·Edge 6종 통과

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 18:41:42 +09:00

167 lines
21 KiB
Markdown

# Main-app 독립 코드 검토 — 2026-10-15
검토 대상: `edd5a97` 현재 소스. 최근 변경 비교 기준은 `061f18d`(2026-10-08 마지막 커밋), 10월 10일 이후 비병합 커밋 62건이다. 비교 구간에는 132개 파일, 14,619줄 추가·1,389줄 삭제가 있다. 변경이 집중된 프로젝트/회의록, 실적/광고비, 신규 긴급 공지를 중점적으로 읽었고 공통 인증·사용자 저장소, 쿠팡 밀크런 무게 표시, 카페24 관련 코드와 테스트도 확인했다.
이 검토는 로컬 소스·가짜 API/저장소를 이용한 실패 주입·일부 실제 Edge 브라우저 테스트에 근거한다. 운영 서버·운영 DB·실제 쇼핑몰에는 접속하지 않았다. 실제 PostgreSQL 동시성 및 운영 화면 전체의 시각 검증은 수행하지 않았다. 아래의 “재현”은 따로 표시하지 않는 한 로컬 대역 환경에서의 재현이다.
## 판단
모듈 경계, 쇼핑몰별 어댑터, 인증정보 암호화, 프로젝트 접근 판단의 공통화, 카페24 쓰기 안전장치는 갖춰져 있다. 기능 추가 과정에서 문제가 쌓인 부분은 **실패를 다음 단계로 전달하는 방식, 여러 저장 작업의 원자성, 비슷한 화면과 API 사이의 규칙 일치**다. 이를 우선 고치는 편이 효과적이다.
P1 2건과 P2 7건의 기능 문제, 별도의 테스트 유지보수 문제를 확인했다. 운영에서 이미 발생했다는 의미는 아니다. 정상 성공 경로의 기존 테스트는 대부분 통과하지만 아래 실패 경로는 놓치고 있다.
작성 도구: 최근 확인한 커밋 `5a4ceea`, `5eaeee2`, `4eda10d`, `66a99e2`, `e7b1e17` 본문에 `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`가 있다. Claude를 사용해 개발했다는 기록은 확인된다. 개별 코드의 작성 주체나 검증 수준을 이 표기만으로 단정할 수는 없다.
## 확인한 기능 문제
### F01 · P1 · 잘못된 쿠팡 응답을 정상 0건으로 받아 기존 매출을 비울 수 있음
- 위치: `app/modules/performance/adapters/coupang.py:298`, `:324`; `app/modules/performance/sync.py:134`; `app/modules/performance/db.py:239`.
- HTTP 200 응답이 JSON이 아니면 `_get()`이 오류 대신 `{}`를 만든다. `_pages()`는 이를 주문 0건으로 처리한다. 수집 서비스는 성공으로 판단하고 `replace_events(..., [])`를 호출한다. 실제 저장소는 해당 기간 기존 실데이터를 삭제하고 새 행이 없으면 그대로 커밋한다.
- 재현: 모든 쿠팡 요청에 `200 / <html>maintenance</html>`을 주입했다. 결과는 `sync_ok=True`, 교체할 사건 목록 `[]`였다. 운영 데이터 삭제는 실행하지 않았다.
- 영향: 프록시·점검 응답이나 응답 규격 이상이 매출 0원으로 반영될 수 있다. 자동 수집에도 같은 경로가 사용된다.
- 권장: JSON 파싱 실패와 필수 응답 구조 누락은 `ApiError`로 중단한다. 정상적인 빈 목록임을 확인한 경우에만 기간 교체를 허용한다. HTTP 200이라는 사실만으로 수집 성공을 판단하지 않는다.
### F02 · P1 · 회의록 [적용]에서 업무 생성과 회의록 연결이 별도 트랜잭션임
- 위치: `app/modules/project/db.py:3738`, 특히 `:3759`; `app/modules/project/router.py:4015`; `app/modules/project/db.py:664`.
- `apply_meeting_task()`는 회의록 줄을 잠근 트랜잭션 안에서 `create()` 콜백을 부른다. 콜백은 `_create_task_for()` → `create_task()`로 들어가 **다른 DB 연결에서 업무를 생성하고 커밋**한다. 이후 원래 연결에서 회의록 줄에 `task_id`를 기록한다.
- 재현: 실제 저장소 메서드에 트랜잭션 동작을 모사하는 연결 대역을 넣고, 업무 생성 후 `UPDATE goal_meeting_tasks`에서 실패하도록 했다. 바깥 트랜잭션이 롤백돼도 업무는 남았다. 재시도하면 같은 회의록 줄에서 업무가 하나 더 생겼다.
- 영향: 생성됐지만 회의록과 연결되지 않은 업무, 재시도 시 중복 업무. 같은 줄 잠금이 정상 동시 클릭은 막아도 이 실패 구간은 막지 못한다.
- 권장: 하나의 DB 연결·트랜잭션에서 업무 생성과 줄 연결을 끝낸다. 알림은 커밋 뒤 처리한다. 회의록 줄 ID를 이용한 생성 중복 방지도 함께 두는 것이 좋다.
- 추가 구조 위험: 연결 하나를 잡은 상태에서 같은 풀의 다른 연결을 요구한다. 기본 최대 연결 수가 5라 동시 [적용]이 몰릴 때 풀 대기 문제도 검증해야 한다. 이 동시성 현상은 실제 PostgreSQL에서 재현하지 않았다.
### F03 · P2 · 회의록 제목 저장 실패 후에도 [적용]이 진행됨
- 위치: `app/static/project.js:11460`, `:11473`, `:11633`.
- `persist()`가 실패를 토스트로 알린 뒤 예외를 삼켜 Promise를 성공 상태로 끝낸다. `apply()`는 `await r.chain`이 끝나면 저장 성공 여부를 확인하지 않고 [적용] API를 부른다.
- 재현: 저장된 제목 `OLD SAVED TITLE`을 `NEW UNSAVED TITLE`로 바꾸고 제목 PUT만 500으로 응답하게 했다. [적용]을 누르자 서버에는 이전 제목으로 업무가 생성됐다. 같은 실패 상태에서 페이지 이탈 경고도 없었다.
- 영향: 사용자가 방금 입력한 내용과 실제 생성된 업무가 달라진다. 이후 목록 재조회로 실패한 초안이 사라질 수도 있다.
- 권장: 실패를 호출자에게 전달하고 미저장 상태를 유지한다. 저장이 성공할 때까지 [적용]을 중단하며 재시도·이탈 경고를 제공한다. 기존 업무 상세 창의 저장 대기·실패 처리 방식을 재사용할 수 있다.
### F04 · P2 · API 계정 정보를 바꿔도 이전 계정의 토큰을 계속 사용함
- 위치: `app/modules/performance/credentials.py:138`; `app/modules/performance/adapters/naver.py:228`; 토스도 같은 토큰 재사용 구조.
- 인증정보 저장은 전달한 항목만 갱신한다. `client_id`·`client_secret`·`account_id` 등이 바뀌어도 내부의 `access_token`·만료 시각을 무효화하지 않는다. 수집기는 만료까지 남은 시간이 충분하면 이전 토큰을 그대로 쓴다.
- 재현: 이전 네이버 계정 토큰을 저장하고 새 client ID·secret·판매자 ID를 저장했다. 다음 `_token()` 결과는 `OLD_ACCOUNT_TOKEN`이었다.
- 영향: 계정 변경 후에도 예전 계정의 매출을 수집할 수 있다. 연결 테스트가 새 입력값으로 성공해도 실제 수집과 다른 계정을 사용할 여지가 있다.
- 권장: 토큰의 기반이 되는 인증정보가 바뀌면 종속 토큰과 캐시를 무효화한다. 갱신을 한 트랜잭션으로 처리하고, 수집 대상 판매자 식별자도 확인한다.
### F05 · P2 · 페이지 수 상한에 도달해도 불완전한 수집을 성공으로 반환함
- 위치: `app/modules/performance/adapters/coupang.py:62`, `:324`; 유사 반복 제한이 있는 다른 어댑터도 같은 기준으로 점검 필요.
- `_pages()`는 `MAX_PAGES=400`을 모두 소진해도 다음 커서가 남았는지 확인하지 않고 `out`을 반환한다. 커서가 반복되는 경우도 정상 종료처럼 처리한다.
- 재현: 상한을 2로 낮추고 두 번째 응답에도 다음 커서를 넣었다. 예외 없이 두 페이지 결과가 반환됐다. 실제 2만 건을 호출한 것은 아니다.
- 영향: 큰 조회 구간의 일부 주문만 수집해 기간 전체를 교체할 수 있다. 부분 수집을 전체 성공으로 표시한다.
- 권장: 마지막 페이지임을 확인하지 못하면 교체를 중단한다. 조회 기간을 더 나누거나 명확한 수집 불완전 오류를 반환한다. 페이지 반복 방지와 수집 완료 판정은 구분해야 한다.
### F06 · P2 · 수집 중 [중지]를 받아들인 뒤에도 저장할 수 있음
- 위치: `app/modules/performance/jobs.py:47`, `:92`; `app/modules/performance/sync.py:120`.
- 중지 검사는 주로 다음 API 호출 전과 진행 단계 갱신 때 이뤄진다. `collect()` 반환 직후에는 중지 상태를 확인하지 않고 `saving()`으로 전환한다. 마지막 API 요청 중 들어온 중지나 마지막 정규화 중의 중지를 놓칠 수 있다.
- 재현: `collect()`가 끝나기 직전에 `ShopProgress.stop()`을 호출했다. 중지 요청은 `True`로 수락됐지만, 교체 저장이 실행되고 최종 상태도 `done`이었다.
- 영향: 사용자는 “저장하지 않고 중지”를 기대했지만 데이터가 바뀔 수 있다.
- 권장: 중지 확인과 `running → saving` 전환을 동일 잠금에서 처리한다. 저장을 시작한 뒤 들어온 요청에는 중지 불가를 명확히 반환한다.
### F07 · P2 · 열린 긴급 공지의 내용이 바뀌어도 화면은 이전 내용을 유지함
- 위치: `app/static/erp-notice.js:39`.
- 재조회 시 표시 중인 공지 ID가 여전히 존재하면 본문을 갱신하지 않고 개수만 다시 그린다.
- 재현: 같은 ID의 본문을 `VERSION ONE`에서 `VERSION TWO`로 바꿔 다음 조회에 반환했다. 화면 본문은 계속 `VERSION ONE`이었다.
- 영향: 관리자가 정정한 내용을 읽지 못한 채 [확인]을 누를 수 있다. `reshow=true`로 같은 공지를 다시 띄우는 경우도 현재 열린 창에는 정정 본문이 즉시 반영되지 않는다.
- 권장: `updated_at`이나 공지 버전을 수신 응답에 포함하고 버전 변경 시 다시 그린다. 확인 요청에도 읽은 버전을 보내도록 하면 수정 전 내용을 읽은 확인 기록을 구분할 수 있다.
### F08 · P2 · 아직 표시되지 않은 예약 공지도 [확인] 처리 가능함
- 위치: `app/modules/notice/router.py:103`; `app/modules/notice/db.py:175` 부근 `ack()`.
- 라우터는 공지 존재 여부와 수신 대상 여부만 확인한다. 주석과 달리 `show_at`과 `cancelled_at`을 검사하지 않고, 저장소도 추가 검사를 하지 않는다.
- 재현: 2099년 표시 예정인 공지와 취소된 공지에 각각 확인 요청을 보냈다. 둘 다 HTTP 200으로 확인 저장 경로가 호출됐다.
- 영향: 공지 ID를 아는 수신자가 예약 공지를 미리 확인 처리할 수 있고, 해당 공지는 실제 표시 시각에 pending 목록에서 제외된다. ID만으로 비수신자가 본문을 읽는 문제를 확인한 것은 아니다.
- 권장: 표시 시각·취소 여부·수신 대상을 확인 INSERT와 동일한 DB 문장 또는 트랜잭션에서 검증한다.
### F09 · P2 · 공통 API 설정 창의 “칸 비우고 연결 테스트”가 쇼핑몰에서는 적용되지 않음
- 위치: `app/static/performance.js:887`, `:899`; `app/modules/performance/router.py:761`; 광고용 경로 `:605`와 비교.
- 공통 화면은 선택 입력칸을 비우면 `clear`를 전송하고 빈 값으로 연결을 시험한다고 안내한다. 광고 테스트 API는 이를 처리하지만 쇼핑몰 테스트 API는 `clear`를 버린다.
- 재현: 저장된 네이버 `account_id`가 있는 상태에서 `clear:["account_id"]`를 보냈다. 테스트는 저장된 계정 값을 읽었고, `unsaved=False`로 결과를 반환했다.
- 영향: 지운 판매자 ID나 선택 항목이 그대로 사용돼 잘못된 연결 테스트 결과를 볼 수 있다. 저장하지 않은 테스트인데 기존 연결 상태를 변경할 수도 있다.
- 권장: 쇼핑몰 테스트에도 광고 테스트와 같은 `cleared` 전달·임시 테스트 판정을 적용한다. 공통 화면을 쓰는 API들의 계약을 통일한다.
## 테스트 체계에서 확인한 문제
### F10 · P2 · 일괄 테스트가 신뢰할 수 있는 기본 상태로 유지되지 않음
검증 환경은 Python 3.12 계열 별도 가상환경에 `requirements.txt`와 pytest를 설치했다. `.env` 자동 로딩을 비활성화하고 데이터 경로는 저장소 밖 임시 폴더로 지정했다. 운영 인증정보를 사용하지 않았다.
전체 실행:
```text
pytest -q tests app/modules/performance/tests app/modules/cafe24/tests app/modules/dispatch/tests
426 passed, 56 failed, 2 skipped, 29 subtests passed
```
- 실패 54개: `tests/test_cafe24_db.py`, `tests/test_project_module.py`는 DB 설정이 없을 때 import 준비만 생략하고 pytest의 테스트 수집은 막지 않는다. `ST`, `ADMIN`, `RUN` 등이 없어 `NameError`로 실패했다. 파일을 직접 실행하는 자체 러너의 skip 처리만 있다. 이 54개를 운영 기능 결함으로 해석하면 안 된다.
- 실패 2개: `tests/test_malaysia_stock.py:176`, `:187`은 랙 36칸·A/B만 기대하지만 현재 구현에는 Ground 6칸이 추가돼 42칸이다. 현재 구조에 맞춘 기대값 갱신이 필요하다.
- 위 세 파일을 제외한 확인 실행: `407 passed, 2 skipped, 29 subtests passed`. 실제 DB 통합 테스트는 수행하지 못했다.
- jsdom UI 테스트 6개 파일 실행: 프로젝트·회의록·목표 탐색·마감 알림·공지 5개 파일 통과. 실적 수동 입력 파일은 3개 검증 실패. 새 구글 광고 데이터·상세 보기·광고 설정 행 추가를 기대값에 반영하지 않은 경우다. 이 세 검증도 최신 요구와 맞춰 정리해야 한다.
- 실제 Edge 테스트: `inbox_panel.browser.test.js`, `perf_manual.browser.test.js`, `image_copy.browser.test.js` 통과. 저장 실패 시 수신함 패널 유지·전환 대기, 900/1400px 수동 입력 칸 크기 유지, 이미지 원본 크기 복사를 확인했다. API 응답은 테스트 대역이다.
- `app/modules/cafe24/tests/test_cafe24.py:29`에서 import 시 `products.time.sleep`을 직접 대체한다. `time`은 공유 모듈이므로 다른 테스트의 `time.sleep`까지 바뀐다. fixture/patch 범위 안으로 옮겨 테스트 간 간섭을 없애야 한다.
권장: pytest 공통 진입점과 개발 의존성 명세를 두고, DB 없는 검증은 명시적으로 skip한다. 별도 PostgreSQL 통합 검증과 브라우저 검증을 CI에서 분리해 실행한다. 테스트 수보다 실패·재시도·부분 수집·트랜잭션 경계가 실제로 검증되는지가 중요하다.
## 중복·비대화·유지보수
### 1. 프로젝트 화면 스크립트의 책임을 나눌 시점
`app/static/project.js`는 약 1만 2천 줄로 프로젝트 보드, 업무 상세, 설명 편집기, 댓글/첨부, 수신함, 목표, 회의록, 공통 부품을 함께 담고 있다. 최근 비교 구간에서 이 파일에만 1,775줄이 추가되고 403줄이 삭제됐다. 프로젝트 저장소와 라우터도 각각 수천 줄이다.
`PJLib` 부품을 쓰기 위해 공지 관리 화면도 이 큰 파일을 불러온다. `PJ_LIB_ONLY`로 초기화를 막는 안전장치는 있지만, 편집기·날짜 선택·멤버 선택·토스트를 작은 공통 모듈로 빼면 의존 관계와 테스트 범위가 줄어든다. 이후 업무 상세, 보드, 수신함, 목표, 회의록 순으로 책임을 나누는 편이 좋다. 파일 수만 늘리는 기계적인 분할은 피한다.
### 2. 인증·페이지 가드가 여러 모듈에 반복됨
`_require_user`가 vacation/malaysia/cupang/dispatch/expense/project에 반복되고 설정 필요 화면과 `_guard`도 비슷하게 복제돼 있다. 모듈별 접근 정책은 유지하되 “현재 사용자 조회 → 모듈 권한 → 저장소 준비”라는 반복 절차는 공통 의존성으로 합칠 수 있다.
기존 `project/access.py`처럼 정책을 한 곳에 모은 부분은 유지할 가치가 있다. 프로젝트 멤버십 정책까지 범용 가드에 섞으면 권한 판단이 흐려질 수 있다.
### 3. 공통 화면과 서버 구현이 서로 다른 규칙으로 발전함
F09가 실제 사례다. 같은 입력창을 쓰지만 광고와 쇼핑몰 테스트 API의 `clear` 처리가 다르다. F03도 일반 업무 상세 창에 있는 저장 실패 방어가 회의록 업무 등록 표에 빠진 사례다. 공통 요청·저장 상태 처리를 먼저 정리하고 모듈별 동작을 얹는 방향이 유효하다.
업무 생성·수정·프로젝트 이동의 완료 상태/담당자 처리도 여러 경로에 분산돼 있어 비교 검증이 필요하다. 예를 들어 프로젝트 이동은 완료 섹션 진입은 처리하지만, 완료 업무를 미완료 섹션으로 이동할 때는 기존 완료 시각을 유지한다(`project/db.py:986`). 같은 프로젝트 안의 섹션 이동은 완료를 해제하는 경로가 있다. 의도한 정책을 정한 뒤 일치시킬 필요가 있다. 이 항목은 확정 버그 수에 포함하지 않았다.
### 4. 안 쓰는 import보다 규칙 중복을 먼저 정리
Ruff의 `F821,F811,F401` 검사에서 12건이 나왔고 전부 미사용 import 분류였다. 이 검사에서는 미정의 이름과 함수 재정의가 검출되지 않았다. 12건에는 `asset/__init__.py`의 router 재노출처럼 유지해야 할 항목도 포함된다. 자동 삭제하면 안 된다.
명백한 정리 후보는 cupang 라우터의 `json`·`SHIP_METHODS`, project 라우터의 `Depends`, 일부 DB 파일의 `timezone` 등이다. 운영 오류 예방 효과는 F01~F09와 저장 계약 정리 쪽이 훨씬 크다. 현재 소스를 근거 없이 “불필요한 코드가 대부분”이라고 평가할 정도는 아니다.
### 5. 문서·의존성 관리
- 필독 문서에 휴가 “준비중/미개발”, 관리자 자동 전체 권한 등 현재 구현과 어긋나는 설명이 남아 있다. `project/__init__.py`의 권한 요약도 현재 4등급·멤버십 기준과 다르다.
- `SERVER_ARCHITECTURE.md`는 main-app 배포 경로를 여러 후보로 안내하지만 상위 지침은 `/opt/www/main`으로 확정한다. 다른 서비스 경로와 구분하는 설명으로 정리해야 한다.
- `requirements.txt`는 대부분 하한만 있어 같은 커밋을 나중에 빌드하면 다른 라이브러리 조합이 설치된다. 검증한 버전 조합을 잠그고 계획적으로 갱신하는 편이 재현에 유리하다. 이번 설치 환경에서도 Starlette의 테스트 클라이언트 관련 deprecation 경고가 나왔다. 이 경고를 현재 운영 장애로 해석하지는 않는다.
## UI/UX 개선 제안 — 결함과 구분
1. 자동 저장 상태를 화면 전체에 일관되게 제공한다. 회의록 업무 등록 표에도 “저장 중/실패/재시도”가 지속적으로 보여야 한다. 토스트만으로 실패를 알리면 나중에 어떤 줄이 미저장인지 알기 어렵다.
2. 광고비 직접 입력과 자동 수집의 우선순위를 설명한다. 현재 `replace_ad_api_range()`는 API가 반환한 날짜의 수동·업로드 금액도 덮어쓰도록 명시적으로 구현돼 있다. 자동 수집을 켠 채 보정 입력한 사용자에게는 값이 되돌아가는 경험이 된다. 버그로 단정하지 않고 정책 개선 대상으로 본다. 원본 값과 수동 보정 값을 분리하거나 입력 시 덮어쓰기 예정임을 알리는 방안이 있다.
3. 긴급 공지의 키보드 탐색을 개선한다. Tab을 무조건 [확인] 버튼으로 돌리기 때문에 본문 링크에 키보드로 접근할 수 없다(`erp-notice.js`의 keydown 처리). 본문의 접근 가능한 요소를 포함해 포커스를 순환시키고 닫힐 때 이전 위치로 복귀하는 편이 좋다.
4. 큰 화면 표의 키보드 조작·포커스·모달 닫힘을 공통화한다. `performance.js`의 자체 모달과 프로젝트의 모달은 동작 규칙이 다르다. 같은 사용자가 모듈을 옮겨 다닐 때 조작 방식이 일치하도록 정리할 수 있다.
5. 마이그레이션 누락·DB 장애 안내는 일반 사용자용 문구와 관리자 진단을 구분한다. 현재 일부 화면은 SQL 파일명과 환경변수를 바로 보여 준다. 사용자는 “사용 준비 중/관리자에게 문의”를 보고 관리자는 구체적인 진단을 확인하게 하면 된다.
## 문제로 판정하지 않은 부분
- Google Ads 개발자 토큰 제거와 기본 버전 v26은 기억에 의존하지 않고 공식 문서를 확인했다. v26은 2026-10-14 릴리스로 확인되고, 개발자 토큰 정책도 변경 안내가 있다. 이를 잘못된 구현으로 지적하지 않았다. [Google Ads 릴리스 노트](https://developers.google.com/google-ads/api/docs/release-notes), [개발자 토큰 정책](https://developers.google.com/google-ads/api/docs/api-policy/developer-token?hl=en).
- 카페24는 원격 반영 여부 불명과 로컬 기록 실패를 구분하고 lease·쓰기 잠금·백업·기록 복구 경로를 마련했다. 검토 중 이런 보호 장치를 확인했다. 실제 쇼핑몰과의 운영 검증까지 통과했다고 주장하는 것은 아니다.
- 수신함 패널의 저장 완료 대기와 이미지 복사, 실적 수동 입력 시 열 너비 유지는 이번 브라우저 검증을 통과했다.
## 권장 진행 순서
1. F01·F02: 수집 검증과 트랜잭션 경계를 먼저 고친다.
2. F03·F04·F05·F06: 저장 실패 전파, 계정 변경 시 토큰 무효화, 수집 완료 판정, 중지-저장 전환을 보강한다.
3. F07·F08·F09: 공지 버전/확인 조건과 공통 설정창 API 계약을 맞춘다.
4. F10: 테스트 진입점·기대값·전역 대체를 정리하고, 위 실패 상황을 회귀 검증에 넣는다.
5. 이 검증을 유지하면서 공통 부품과 프로젝트 스크립트를 단계적으로 나눈다.
이번 작업에서는 애플리케이션 소스와 기존 테스트를 수정하지 않았다. 이 보고서만 저장소에 추가했다. 원래 있던 미추적 `api doc/` 폴더도 변경하지 않았다.