Files
dbx-main/docs/CODE_REVIEW_2026-10-15_RESULT.md
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

72 lines
9.9 KiB
Markdown

# 2026-10-15 코드 검토 — 조치 결과
원 보고서: `docs/CODE_REVIEW_2026-10-15.md`(edd5a97 기준, 수정하지 않음). 이 문서는 F01~F10 조치와 검증, 남은 위험, 후속 과제를 정리한다.
검증 환경: 로컬 PC, Python 3.12 가상환경 + `requirements.txt` + pytest 9.1.1, **로컬 PostgreSQL 16**(휴대용, localhost:55432 —
`scripts/sql` 의 init·마이그레이션을 그대로 적용, 단 008 의 `pg_trgm` 인덱스 줄만 제외), jsdom 24, 실제 Edge(Playwright).
운영 서버·운영 DB·실제 쇼핑몰·SMTP 에는 접속하지 않았다. 각 결함은 **원래 코드(edd5a97, 별도 git worktree)에서 같은 테스트로 먼저 재현**하고
수정 후 통과를 확인했다.
## 항목별
| | 원인(확인) | 조치 | 주요 위치 | 원래 코드 재현 → 수정 후 |
|---|---|---|---|---|
| F01 | 쿠팡 `_get()` 이 HTTP 200 비JSON 을 `{}` 로, `_pages()` 가 `data` 없음을 0건으로 → 기간 교체로 매출 삭제 | 2xx 비JSON·`data` 목록 없음 = `ApiError`. 정상 빈 목록(`data: []`, 성공 표시 + `null`)만 0건 | `adapters/coupang.py` `_get`·`_page_rows` | HTML 200 → `ok: True`(교체) → 실패·기존 매출 유지 |
| F02 | `apply_meeting_task` 가 줄을 잠근 연결 A 를 쥔 채 `create_task` 가 연결 B 에서 업무 커밋 | 확인은 잠그기 전, 업무 INSERT(`_insert_task`)·줄 연결을 **같은 연결·트랜잭션**, 줄이 바뀌었으면 409, 알림·메일은 커밋 뒤 | `project/db.py` `_insert_task`·`apply_meeting_task`, `project/router.py` `_task_create_checks/_fields/_created_effects`·`api_apply_quick_task` | 실제 PG + 연결 실패 트리거: 2회 시도에 고아 업무 2건 → 0건, 재시도 1건 |
| F03 | `persist()` 가 실패를 삼켜 `apply()` 가 이전 제목으로 [적용] | 칸별 미저장 추적, `persist()` 실패 전파, `saveRow()` 성공 전 [적용] 중단, 초안 유지·[다시 저장]·이탈 경고, 새로고침도 초안 보존 | `static/project.js` `initMeetQuickTasks` | `OLD SAVED TITLE` 로 [적용] → 요청 없음, 다시 저장 뒤 새 제목으로 |
| F04 | 인증정보 저장이 내부 토큰·만료를 그대로 둠, 토큰은 만료만 확인 | 저장 시 값이 실제로 바뀌면 내부 값 삭제(같은 값은 유지) + 네이버·토스 토큰을 발급 인증정보 지문(SHA-256)에 묶음(시험 입력값 포함), GS샵 방식 캐시도 키 지문 기준 | `credentials.py` `save`, `adapters/base.py` `credential_fingerprint`, `naver.py`·`toss.py`·`gsshop.py` | 키 변경 후 `OLD_ACCOUNT_TOKEN` → 새 토큰 |
| F05 | `_pages()` 가 상한 소진·커서 반복을 정상 종료로 | 쿠팡 `TooManyPages` → 구간 반으로(하루까지), 하루도 넘치면 실패. 네이버·카카오·토스(3곳)·GS샵도 상한 소진·커서 반복 = 실패 | `coupang.py` `_pages`·`_seller_orders`·`_rg_orders`, 각 어댑터 쪽 넘김 | 부분 목록 반환 → 실패 / 하루씩 끝까지 |
| F06 | `collect()` 반환 뒤 중지 확인 없이 `saving()` | `ShopProgress.begin_saving()` — 중지 확인과 전환을 `stop()` 과 같은 잠금에서, 저장 시작 뒤 중지는 거부 | `jobs.py`, `sync.py` | 중지 수락 후 저장·`done` → 저장 안 함·"중지됨" |
| F07 | 같은 ID 공지는 재조회해도 본문을 다시 그리지 않음, 확인에 읽은 내용 정보 없음 | 공지 `version`(updated_at μs), 버전이 바뀌면 다시 그리고 "수정됨" 안내, [확인]에 version → 다르면 409(기록 없음) | `notice/db.py`·`router.py`, `static/erp-notice.js`·`.css` | `VERSION ONE` 유지 → `VERSION TWO` 로 갱신 |
| F08 | `api_ack` 가 존재·수신자만 확인, `ack()` 는 무조건 INSERT | `ack()` 한 트랜잭션: 공지 행 `FOR SHARE` 잠금 + 수신자·표시 시각·취소 확인 후 기록(acked/already/stale/denied) | `notice/db.py` `ack`, `router.py` `api_ack` | 예약 공지 확인 기록 → 404·기록 없음, 동시 취소는 잠금 대기 후 거부 |
| F09 | 쇼핑몰 테스트 API 가 `clear` 를 버리고 시험도 상태 기록 | `clear` 를 빈 값으로(접근자 `cleared`), values·clear 가 있으면 저장 안 한 시험 — 상태·토큰 저장 안 함. 광고 테스트와 같은 `_cleared_keys` | `sync.py` `test_connection`, `router.py`, `credentials.py` | 저장된 `OLD-SELLER` 로 시험·상태 덮어씀 → 빈 값·상태 유지 |
| F10 | DB 테스트 파일이 import 때 가짜 `app.main` 을 바꿔 끼워 서로 덮어씀(DB 있어도 28건 실패), DB 없으면 NameError, 오래된 기대값, import 때 전역 `time.sleep` 대체 | DB 없으면 `pytestmark` skip, 가짜 `app.main`·`time.sleep` 은 파일 범위 fixture(직접 실행도 유지), 말레이시아 Ground 42칸·광고 API 기대값 갱신(검증 추가), `pytest.ini`·`requirements-dev.txt`·`tests/js/package.json`·`docs/TESTING.md` | `tests/test_project_module.py`·`test_cafe24_db.py`, `app/modules/cafe24/tests/test_cafe24.py`, `tests/test_malaysia_stock.py`, `tests/js/perf_manual.test.js` | 아래 실행 결과 |
## 실행한 테스트(이번 작업, 모두 실제 실행)
| 구분 | 명령 | 결과 |
|---|---|---|
| Python, DB 없음 | `python -m pytest -q` | **440 passed, 63 skipped**(DB 통합), 실패 0 — 작업 전 426 passed / 56 failed |
| Python, 로컬 PG | `PROJECT_TEST_DB_URL=… CAFE24_TEST_DB_URL=… python -m pytest -q` | **503 passed**, 실패 0 |
| 직접 실행 | `python tests/test_project_module.py` · `tests/test_cafe24_db.py` · `-m app.modules.cafe24.tests.test_cafe24` | 35 · 23 · 127 통과, DB 없으면 SKIP |
| jsdom | project_ui · goals_meeting_ui · goal_nav_ui · overdue_ui · notice_ui · perf_manual · help_ui | 전부 ALL PASS(178·244·—·12·12·51·—) |
| 실제 Edge | asset · goal_nav · help · image_copy · inbox_panel · perf_manual `.browser.test.js` | ALL PASS |
| 실제 Edge | `goals_autofit.browser.test.js` | 앞 7항목 통과 후 회의록 측정에서 `TypeError`(요소 없음) — **원래 코드에서도 같은 위치에서 실패**(이번 변경과 무관, 미조치) |
새 회귀 테스트: `app/modules/performance/tests/test_review_2026_10_15.py`(F01·F04·F05·F06·F09, 15건 — 원래 코드에서 14건 실패),
`tests/test_project_module.py::test_review_meeting_apply_is_one_transaction`(F02, 실제 PG), `tests/test_notice_db.py` 3건·`tests/test_notice.py`(F07·F08),
`tests/js/goals_meeting_ui.test.js` [2g9](F03), `tests/js/notice_ui.test.js` F07.
## 미검증·남은 위험
- **실제 쇼핑몰 응답**: F01 의 "성공 표시 + `data: null` = 빈 목록" 허용은 문서·기존 테스트 응답 기준 추정. 쿠팡이 빈 기간에 다른 모양을 주면
그 기간 수집이 실패로 나온다(데이터는 지워지지 않음 — 오류 문구로 드러남).
- **F05 다른 어댑터**: 상한·커서 반복을 실패로 바꿨을 뿐 기간 분할 재시도는 쿠팡만. 한 구간이 상한을 넘는 날(예: 네이버 하루 2만 건 초과)은
자동 복구 없이 실패로 알린다.
- **F04**: 배포 직후 네이버·토스는 지문 없는 기존 토큰 때문에 한 번 새 토큰을 받는다(토스는 문서상 잦은 재발급 제한 안내가 있으나 1회).
- **동시성**: F02·F08 은 로컬 단일 PostgreSQL 에서 트리거·잠금으로 검증. 운영 부하·연결 수 조건은 재현하지 않았다.
- **F06**: 전체 [업데이트 취소](job 단위)는 쇼핑몰 잠금과 다른 잠금이라, 저장 시작과 거의 동시에 들어온 전체 취소는 그 쇼핑몰 저장을 막지 못할 수
있다(기존 문서의 "저장 중이면 그 저장은 끝낸다"와 같은 동작). 쇼핑몰별 [중지]는 막힌다.
- **F07**: version 없는 예전 화면(브라우저 캐시)의 [확인]은 내용 확인을 건너뛴다 — 스크립트 버전을 올려 새로고침 때 바뀐다.
## 운영 적용 전 확인
- **마이그레이션 없음, 새 환경변수 없음.** 스키마 변경 없이 코드만.
- 웹만 다시 띄우면 된다(카페24 worker 코드는 바뀌지 않음 — 카페24 테스트 파일만 수정):
`cd /opt/www/main && git pull && docker compose up --build -d web`
- 배포 후 확인: 실적 [매출 업데이트] 정상 완료(쿠팡·네이버·토스 — 토스·네이버는 토큰 한 번 재발급), 회의록 업무 등록 표 [적용],
긴급 공지 띄움·[확인], 실적 설정 연결 테스트(칸 비우기 포함).
## 후속 개선안(이번 범위 밖 — 결함 수정과 분리)
1. **프로젝트 화면 스크립트 분리**: `project.js`(약 1.2만 줄)를 공통 부품(편집기·날짜·멤버 선택·토스트, 공지 관리 화면도 씀) → 업무 상세 → 보드
→ 수신함 → 목표 → 회의록 순으로 책임별 분리. 회의록 업무 등록 표의 저장 상태 처리(F03)를 다른 칸 저장(`createFieldSaver`)과 공통화.
2. **공통 가드 정리**: 모듈마다 반복되는 "사용자 조회 → 모듈 권한 → 저장소 준비"를 공통 의존성으로. 프로젝트 멤버십 정책(`access.py`)은 섞지 않는다.
3. **광고비 수동 보정 정책**: `replace_ad_api_range()` 는 API 가 준 날의 직접 입력·업로드 값을 덮어쓴다. 원본(API) 값과 보정 값을 나눠 저장하거나,
입력 때 "다음 불러오기에서 덮어씀"을 알리는 방안 중 결정 필요.
4. **모달·키보드 UX 공통화**: 긴급 공지 Tab 이 [확인]으로만 가서 본문 링크에 키보드로 못 감(포커스 순환·닫힌 뒤 복귀), 실적 자체 모달과
프로젝트 모달의 Esc·바깥 클릭·포커스 규칙 통일.
5. **기타 보고서 항목**: 업무 이동 시 완료 상태 정책 통일(`project/db.py` 프로젝트 이동 vs 섹션 이동), 미사용 import 정리(자동 삭제 금지 —
재노출 import 있음), `requirements.txt` 버전 고정, 마이그레이션 누락 안내를 일반 사용자/관리자용으로 나누기,
`goals_autofit.browser.test.js` 회의록 측정 실패(원래부터) 원인 확인.