c7cc94a09c
- 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>
9.9 KiB
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 - 배포 후 확인: 실적 [매출 업데이트] 정상 완료(쿠팡·네이버·토스 — 토스·네이버는 토큰 한 번 재발급), 회의록 업무 등록 표 [적용], 긴급 공지 띄움·[확인], 실적 설정 연결 테스트(칸 비우기 포함).
후속 개선안(이번 범위 밖 — 결함 수정과 분리)
- 프로젝트 화면 스크립트 분리:
project.js(약 1.2만 줄)를 공통 부품(편집기·날짜·멤버 선택·토스트, 공지 관리 화면도 씀) → 업무 상세 → 보드 → 수신함 → 목표 → 회의록 순으로 책임별 분리. 회의록 업무 등록 표의 저장 상태 처리(F03)를 다른 칸 저장(createFieldSaver)과 공통화. - 공통 가드 정리: 모듈마다 반복되는 "사용자 조회 → 모듈 권한 → 저장소 준비"를 공통 의존성으로. 프로젝트 멤버십 정책(
access.py)은 섞지 않는다. - 광고비 수동 보정 정책:
replace_ad_api_range()는 API 가 준 날의 직접 입력·업로드 값을 덮어쓴다. 원본(API) 값과 보정 값을 나눠 저장하거나, 입력 때 "다음 불러오기에서 덮어씀"을 알리는 방안 중 결정 필요. - 모달·키보드 UX 공통화: 긴급 공지 Tab 이 [확인]으로만 가서 본문 링크에 키보드로 못 감(포커스 순환·닫힌 뒤 복귀), 실적 자체 모달과 프로젝트 모달의 Esc·바깥 클릭·포커스 규칙 통일.
- 기타 보고서 항목: 업무 이동 시 완료 상태 정책 통일(
project/db.py프로젝트 이동 vs 섹션 이동), 미사용 import 정리(자동 삭제 금지 — 재노출 import 있음),requirements.txt버전 고정, 마이그레이션 누락 안내를 일반 사용자/관리자용으로 나누기,goals_autofit.browser.test.js회의록 측정 실패(원래부터) 원인 확인.