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

9.9 KiB

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, 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 회의록 측정 실패(원래부터) 원인 확인.