135 Commits

Author SHA1 Message Date
king 81b1204693 fix(project): 권한 우회·작업 혼선·저장 유실 등 16개 항목 수정 — 지금 권한 기준·읽기 전용 연결 작업·원자적 파일 댓글
권한(서버)
- 공통 권한 모듈 access.py: 모든 판단을 "지금" 권한으로 — 내 작업·수신함·알림·멘션·검색·상세·공유 링크·
  댓글·첨부·알림/메일 수신자에서 권한을 잃은 사람 제외(기록은 이력으로 보존)
- 소유자 변경·남을 소유자로 지정한 생성은 관리자만, 새 소유자는 권한 있는 등록 사용자
- 삭제는 생성자 규칙 + 지금 권한(멤버에서 빠진 생성자 거절), 댓글 수정·삭제도 지금 권한
- @태그는 볼 수 있는 사람만(mention_skipped), 태그 후보 all-users?task_id=, 새 담당자 권한 검사
- 연결(멀티호밍) 작업은 연결된 프로젝트 멤버에게 읽기 전용(task_link_scope), 볼 수 없는 연결 프로젝트 숨김

저장·동기화(화면)
- 작업 창 세대(taskGen)·블록 ctxSeq 로 늦은 A 응답이 B 를 덮지 않게(A→B, A→B→A, 이미지 업로드 중 전환)
- 자동 저장 성공/실패 반환, 실패 칸 재시도, 닫기·전환 전 저장 확인(버리기/계속 편집), 미저장 이탈 경고
- 실시간 동기화 observed/applied 분리·실패 재시도·겹침 방지, snapshot?scope=all 로 전체 범위 반영·권한 회수 안내
- 한국시간 기준 오늘(kstTodayIso), 한글 조합 중 Enter 는 제출하지 않음, 댓글 연타·재전송 중복 방지(client_token)

기타
- 파일 댓글은 본문+파일 한 트랜잭션(POST /comments/files), 실패 파일 표시·유지, 작업 창 댓글에 첨부 표시
- 날짜 범위 검증(부분 수정은 최종 상태), 완료 섹션에 바로 만든 작업 완료 처리·알림
- 마감 알림 발송 기록+수신함 알림 원자적(실패 시 재시도), 권한 없는 수신자 제외
- 테스트: tests/test_project_module.py(로컬 PostgreSQL 11개), tests/js/project_ui.test.js(jsdom 51개)
- 문서(PROJECT_MODULE 6-10·도움말·CLAUDE.md), project.js/css 캐시 버전 20260930g, 새 마이그레이션·환경변수 없음

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 16:46:11 +09:00
king ae2e3eb943 Merge branch 'feat/performance' into feat/project — 매출 업데이트 취소 2026-09-30 15:06:47 +09:00
king da63b93302 feat(performance): 매출 업데이트 취소 버튼
- 진행 창 [업데이트 취소](시작한 사람·관리자) → POST /api/sync/jobs/{id}/cancel
- 어댑터가 API 호출 직전마다 ctx.progress.check() — 취소면 Cancelled 로 멈추고 저장하지 않음(기존 매출 그대로),
  차례가 안 온 쇼핑몰은 취소됨으로 건너뜀, 이미 끝난 쇼핑몰 결과는 유지
- 취소 실행은 perf_sync_runs failed + 업데이트 취소, 연결 상태는 바꾸지 않음
- 테스트 1개 추가(30개 통과), performance.js/css 캐시 버전, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:06:25 +09:00
king a2d2382d71 Merge branch 'feat/performance' into feat/project — GS샵 매출 = 협력사 지급액 2026-09-30 15:01:42 +09:00
king 8b3e6dffc5 fix(performance): GS샵 매출 = supGiveAmt(협력사 지급액) — 협력사 포털 주문 통계 금액과 같은 항목
- 9월 실데이터: 6호세트 포털 176,715 ÷ 9 = 19,635 = API supGiveAmt(판매가 23,100·고객 결제 20,330),
  7호세트 45,900 × 85%, 주부체험 9,900 × 90% — 상품마다 GS 수수료율이 달라 판매가로는 못 맞춤
- 9/1~9/29 지급액 4,972,689 vs 포털 순주문 4,823,074(주문일↔매출인식일 차이)
- 이미 GS 수수료를 뺀 금액이라 GS샵 수수료율은 0% 로 둔다(문서·어댑터 설명)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 15:01:27 +09:00
king 898dc1153c Merge branch 'feat/performance' into feat/project — GS샵 매출 수집 2026-09-30 14:53:29 +09:00
king b765fb8fb8 feat(performance): GS샵 매출 수집 — 매출 내역 custChrAmt(할인 후 고객 결제금액), 매출인식일 기준
- 9/3 실데이터로 항목 확인: salePrice − dcTotAmt = custChrAmt, supGiveAmt = 협력사 지급액
- 매출 내역 한 줄 = 사건, SALE 이 아닌 줄은 RETURN 음수, 배송비 제외, replace_range
- GS API 에는 주문일 기준 조회가 없어 포털 주문 통계(총주문금액)와 날짜 기준이 다름 — 문서에 기록
- 원본 데이터 확인에 날짜별 현재 규칙 매출(열 이름은 쇼핑몰별 day_cols)
- 테스트 1개 추가(29개 통과), performance.js 캐시 버전

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 14:53:13 +09:00
king 7c283312b4 Merge branch 'feat/performance' into feat/project — GS샵 운영 KEY 변형 2026-09-30 14:36:51 +09:00
king f4fadec0a4 fix(performance): GS샵 운영 KEY — 16진수 키 변형(글자 그대로·16진수 풀기·앞 32자)도 시도
- 포털 운영 KEY 가 16진수 글자라 키를 바이트로 쓰는 법을 모드와 함께 차례로 시도, 통과한 조합 기억
- 입력칸·안내 문구를 "운영 KEY"로(개발 KEY 아님), 연결 성공 문구에 통과한 방식 표시

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 14:36:36 +09:00
king 74f59c0a94 Merge branch 'feat/performance' into feat/project — GS샵 연결·원본 확인 2026-09-30 14:28:04 +09:00
king e56c5685ca feat(performance): GS샵 연결 테스트·원본 데이터 확인 — 제휴 API AES256 토큰
- 인증: 헤더 supCd + token = base64(AES256(yyyyMMddHHmmss + 협력사코드)), 암호화 모드는 문서에 없어
  CBC(IV=키 앞 16) → ECB → CBC(IV=0) 순서로 시도하고 통과한 모드 기억, HTTP 200 + result=fail 401 도 인증 실패로
- 운영 주소 withgs-api.gsshop.com, 매출 내역(매출인식일, 10일씩·쪽 넘김)·배송비 내역
- 설정 "쇼핑몰 원본 데이터 확인"에 GS샵 — 응답 항목 이름이 문서에 없어 실데이터로 매출 규칙 확정 예정
  (그 전까지 매출 수집은 연동 준비 중)
- 입력칸 라벨: 협력사코드(supCd)·AES256 암복호화 키(저장된 값 그대로 사용)
- 테스트 1개 추가(28개 통과), 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 14:27:49 +09:00
king 67cd73b963 Merge branch 'feat/performance' into feat/project — 매출 업데이트 진행 창 2026-09-30 13:57:11 +09:00
king 3203ff87a4 feat(performance): 매출 업데이트 진행 창 — 쇼핑몰별·전체 진행 막대
- POST /api/sync background=true 로 수집을 백그라운드 스레드에서 돌리고 작업 번호를 바로 돌려줌,
  GET /api/sync/jobs/{id}·/api/sync/current 로 진행 상황 조회(jobs.py, 메모리 보관)
- 어댑터 진행 알림(ctx.progress plan/step/add): 네이버 = 일, 11번가·카페24 = 조회 구간, 받은 자료 건수
- 창: 쇼핑몰마다 막대(대기·수집 중 n/전체·저장 중·완료 n건·실패·건너뜀·경과), 전체 막대(평균),
  수집 없는/인증정보 없는 쇼핑몰은 건너뜀 한 줄, 창을 닫아도 서버에서 계속
- [매출 업데이트]·[과거 매출 가져오기] 모두 진행 창 사용, 이미 진행 중이면 그 진행 상황을 보여 줌
- 테스트 1개 추가(27개 통과), performance.js/css 캐시 버전, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:56:57 +09:00
king e398e9d906 Merge branch 'feat/performance' into feat/project — 네이버 매출 = 판매금액(총) 2026-09-30 13:47:06 +09:00
king 077c92fa32 fix(performance): 네이버 매출 = 판매분석 "판매금액(총)" — 결제 뒤 취소·반품 포함, 배송비 제외
- 9/1 판매분석 매출 4,455,600원(판매금액(총)): 할인 뒤 금액, 배송비 별도, 환불은 환불일에 따로 빠짐
- 처음 규칙(취소·반품 빼고 배송비 더함)은 4,245,300원으로 달랐음
- 입금대기·미입금 취소만 제외, 결제 뒤 취소·반품도 결제일 매출에 포함
- 원본 데이터 확인 표에 결제 뒤 취소·반품분·배송비(참고) 열 추가
- performance.js 캐시 버전 20260930x, 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:46:57 +09:00
king e845f47043 Merge branch 'feat/performance' into feat/project — 네이버 스마트스토어 매출 수집 2026-09-30 13:34:03 +09:00
king a5f90a0343 feat(performance): 네이버 스마트스토어 매출 수집 — 커머스API 토큰·결제일 기준 주문 조회
- 인증: bcrypt 전자서명(client_secret_sign) → OAuth2 client_credentials 토큰, 암호화 저장·만료 5분 전 재발급,
  401 이면 한 번 새로 받아 재호출, 연결 테스트는 항상 새 토큰
- 수집: 조건형 상품 주문 상세 조회(rangeType=PAYED_DATETIME) 하루씩·페이지, 호출 간격·429 재시도
- 1차 매출 규칙: 주문 단위, 결제일, totalPaymentAmount 합 + 배송비(한 번, 배송비 할인 뺌),
  취소·반품 완료·미입금 취소 제외, replace_range
- 설정 화면 "쇼핑몰 원본 데이터 확인"을 네이버·11번가 공용으로 — 네이버는 항목·상태별 합계와
  날짜별 현재 규칙 매출(개인정보는 값 숨김)
- requirements: bcrypt, 테스트 3개 추가(26개 통과), 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:33:53 +09:00
king 21019ac5f1 style(project): 연간 목표 — 관리자 도구 버튼 33px → 30px
- project.js/css 캐시 버전 20260930f

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 13:00:43 +09:00
king 7a9f55c804 style(project): 연간 목표 — 관리자 도구 막대 1.5배 크기, 파스텔 주황 배경
- 도구 버튼 22px → 33px(글자·아이콘도 1.5배)
- 막대 배경 #ffe3c7, 버튼 올림 #ffc98f
- project.js/css 캐시 버전 20260930e

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 12:10:41 +09:00
king ac2615805b fix(project): 연간 목표 — 왼쪽 이름 세로 가운데 정렬
- 구분·항목 이름 칸 vertical-align: middle
- 관리자 도구(✎ 색 ↑ ↓ + ×)는 칸 아래에 떠 있는 막대로 — 숨은 도구가 자리를 차지해 이름이 위로 치우치던 문제
- project.js/css 캐시 버전 20260930d

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 12:04:46 +09:00
king 220fb6e7d1 feat(project): 연간 목표 — 연간 열 90px, 머리·이름 가운데 정렬, 이름 칸 너비 조절·기억
- 연간 열 너비 90px 고정
- 맨 위 머리 줄과 왼쪽 이름 두 칸(구분·항목) 가운데 정렬
- 이름 두 칸은 머리 칸 오른쪽 끝을 끌어 너비 조절(48~320px, 더블클릭 = 기본 72px),
  브라우저에 기억(localStorage pj_goal_col_w)
- project.js/css 캐시 버전 20260930c

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 11:54:55 +09:00
king 7de93e78d7 fix(project): 연간 목표 — 월 칸 너비 85px, 영역 색에 색 없음 + 연한 16색
- 표 칸 너비를 여백 포함(border-box)으로 — 150px 이 padding 만큼 171px 로 늘던 문제, 월 칸 85px
- 좁아진 칸에 맞춰 숫자·글 칸 안쪽 여백 6px
- 색 바꾸기 팝업: 맨 위 색 없음(흰 배경) + 연한 16색(8칸×2줄, 기존 8색 포함)
- project.js/css 캐시 버전 20260930b

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 11:32:25 +09:00
king 86ee50b2e6 Merge branch 'feat/performance' into feat/project — 서버가 feat/project 로 실적 모듈까지 함께 돌도록 2026-09-30 11:22:09 +09:00
king ec78dd328d feat(project): 연간 목표 — 사이드바 "목표" → 연도 → 그해 전체 목표 표
- 사이드바 휴지통 아래 "목표": 누르면 연도 목록이 펼쳐지고(올해는 항상), 관리자는 + 연도 추가
- /project/goals/{연도}: 매출(목표·실적·달성)·로아스(목표·실적) 월별 숫자 + 업무 영역
  (상품·마케팅·컨텐츠·유통[콜라보·인플·쿠팡·기타])별 연간·월별 글을 스프레드시트처럼 한 표에
- 매출 연간 합계·달성률은 화면에서 계산, 칸별 즉시 저장, 영역 이름·색·순서·줄 추가/삭제
- 입력·구조 변경은 관리자만, 조회는 project 권한자 전원
- 새 연도는 가장 가까운 이전 연도의 영역 구성을 복사(처음이면 기본 4개 영역)
- DB 마이그레이션 013(goal_years·goal_metrics·goal_areas·goal_rows·goal_cells), 문서·도움말 갱신
- project.js/css 캐시 버전 20260930a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 11:13:54 +09:00
king f037ea7de0 fix(performance): 11번가 매출 — 정산된 주문은 정산 판매금액합계(배송비 줄 포함)
셀러오피스 "판매 상세내역"(정산) 대조: 9/10 주문은 상품 83,800 + 배송비 줄 3,000
= 86,800 인데 주문 목록의 dlvCst 는 0 이라 주문 목록만으로는 3,000 이 빠진다.
정산 API 의 selPrcAmt 합(121,700 = 34,900 + 3,000 + 83,800)은 판매 상세내역과 같다.

- 정산 내역을 [기간, 기간+45일(오늘까지)] 불러 결제일(ordStlEndDt)로 거르고
  주문별 selPrcAmt 합을 매출로(정산확정 상태, cupnAmt = 11번가 부담 할인)
- 정산 전 주문만 주문 상태 목록의 ordAmt + 배송비
- 사건을 주문 단위(11st:{ordNo})로 — 정산 전/후가 같은 ID 라 바뀌어도 한 건
- 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 01:24:58 +09:00
king 40d94e2892 feat(performance): 11번가 매출 수집 — 주문 상태 목록 기준, 결제일·판매금액+배송비
"11번가 원본 데이터 확인"(9/9~9/29) 실데이터로 확정:
- 주문 상태 목록(결제완료·발송대기·배송중·배송완료)은 지금 그 상태인 주문만 주고,
  배송완료 목록에 구매확정 주문도 남는다. 취소된 주문은 취소완료 목록으로 빠진다
- ordAmt − ordPayAmt = 11번가 부담 쿠폰(tmallApplyDscAmt 11,060), 수수료는
  판매금액 기준(34,900 × 13% = 4,537)

- fetch_orders: 목록 4개를 [기간, 기간+30일(오늘까지)] 7일씩 불러 주문일(결제일)이
  기간 안인 줄만, 주문번호+순번 중복 제거
- SALE 금액 = ordAmt + 배송비(주문번호마다 최댓값을 가장 앞 줄에 한 번),
  ordAmt − ordPayAmt 는 discount_amount 에. 구매자 정보는 raw 에 넣지 않음
- replace_range(11st: 접두어) — 다시 받으면 취소·반품된 주문이 빠진다
- "해당 건이 없습니다"(-1)는 0건. 테스트 추가, 미구현 시험은 G마켓으로

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 01:20:18 +09:00
king 7d96f2e738 fix(performance): 11번가 원본 데이터 확인 — "해당 건 없음"은 0건, 기간 조회·구매확정 후보
9/9 확인 결과: 취소·반품 주소는 코드 -1 "해당 건이 없습니다"(= 0건)인데 실패로
표시했고, 주문 목록 4개는 지금 그 상태인 주문만 주는 듯해 이미 구매확정된
9/9 주문이 어디에도 없었다. 정산 내역은 정산확정일 기준일 가능성이 있다.

- 결과 문구가 "해당 건이 없습니다" 류면 오류가 아니라 0건
- 기간 조회(최대 31일, 7일씩 나눠 호출) — 매출일부터 정산확정일까지 넓게 확인
- 구매확정 목록 후보 주소 추가
- 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 01:14:32 +09:00
king 1952e4f0b1 feat(performance): 11번가 원본 데이터 확인 도구 — 후보 조회 주소별 동작·항목 합계
11번가 셀러 API 의 주문·클레임 상세 문서는 로그인 뒤에만 있어 조회 주소와
금액 항목 이름을 공개 자료로 확정할 수 없다. 추측으로 매출 수집을 짜지 않고
실데이터로 확정하기 위해:

- ElevenstAdapter.reconcile(day): 결제완료·발송대상·배송중·배송완료·취소신청·
  취소완료·반품신청·반품완료·정산 후보 주소를 그날로 호출 → 동작 여부(404 등 오류),
  건수, 항목별 채워진 줄·숫자 합계·예시 값. 개인정보 항목은 이름만(값 숨김)
- 설정 화면 "11번가 원본 데이터 확인" 카드
- 테스트 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 00:47:55 +09:00
king 6376092bb7 fix(performance): 11번가 연결 테스트 — XML 아닌 응답은 실패, 성공 알림은 초록 체크
- 11번가가 200 으로 웹페이지(IP 차단 안내 등)나 XML 아닌 응답을 주면 "0건 정상"으로
  오판할 수 있어 실패로 처리
- 공용 알림 창 erpAlert(msg, { tone: "ok" }) — 경고 삼각형 대신 초록 체크.
  기존 호출은 그대로. 실적 연결 테스트 성공 알림에 적용

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 00:40:40 +09:00
king c93ab2fbd8 feat(performance): 11번가 연결 테스트 — openapikey 로 결제완료 주문 실제 조회
11번가 셀러 API 키 입력·IP 등록을 마쳤는데 연결 테스트가 "다음 단계에서
구현"만 돌려줘 이 서버에서 통하는지 알 수 없었다.

- test_connection: GET /rest/ordservices/complete/{오늘0000}/{오늘2359},
  헤더 openapikey (공식 이용방법 문서). 셀러 API 는 등록 IP 에서만 호출됨
- XML 응답(euc-kr 선언) 직접 디코딩 후 파싱, result_code 오류·401/403 구분,
  연결 실패 시 등록 IP 확인 안내
- 기존 테스트가 실제 11번가를 부르지 않게 httpx 대체 + 11번가 테스트 추가
- 매출 수집은 아직(맞출 셀러오피스 화면 정한 뒤)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 00:31:57 +09:00
king dd6a849fbd feat(performance): 쿠팡 연결 테스트 — HMAC(CEA) 서명으로 발주서 실제 조회
쿠팡 OPEN API 키를 입력했지만 연결 테스트가 "다음 단계에서 구현"만 돌려줘
키가 이 서버에서 통하는지 알 수 없었다. 키는 판매자당 1개이고 사방넷용
(연동업체 선택)으로 발급한 키는 이 서버 IP 에서 막힐 수 있어 먼저 확인이 필요.

- CEA HMAC-SHA256 서명(signed-date + METHOD + path + query, 공식 예제 방식),
  쿠팡 예시와 같은 쿼리 인코딩(+ → %2B, : 유지)
- test_connection: 오늘 결제완료 발주서(v5 ordersheets) 1건 조회
- 401/403 → 인증 실패 + "연동업체 키면 자체개발로 바꾸고 이 서버 IP 허용" 안내
- 매출 수집은 아직 — 맞출 WING 화면을 정한 뒤 구현(주석에 API 조사 결과)
- 테스트: 서명 형식·쿼리 인코딩·403 메시지·비밀값 미노출

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 00:14:06 +09:00
king b52b182d47 fix(performance): 카페24 마켓 통합관리 미사용 — MARKET_MAP 비우기, "카페24 경유" 표시 제거
이 쇼핑몰은 카페24 마켓 통합관리로 들어오는 매출이 없다(사용자 확인). 설정 화면에
네이버·쿠팡 등 9개 쇼핑몰이 "카페24 경유"로 표시돼 카페24 수집분이 그 열로 가는
것처럼 보였다.

- MARKET_MAP = {} — 카페24로 들어온 주문은 market_id 와 관계없이 카페24 열
  (경로 기능은 남겨 두고, 쓰게 되면 매핑만 넣으면 됨)
- 경로 시험은 테스트용 매핑 주입(_with_markets)으로 유지 + 기본값 비어 있음 테스트
- 문서·대조 안내 문구 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:59:06 +09:00
king 1129db9e21 fix(performance): 주문 내역 창 고정 열 제목 배경 투명 문제 + 취소 행 전체 서식
- 창(.perf-modal)은 document.body 에 붙어 .perf 밖이라 --perf-soft 등 색 변수가
  없어 고정된 열 제목 배경이 투명 → 내용이 겹쳐 보였다. 색 변수를 .perf-modal 에도
  정의하고 열 제목 배경·아래 줄을 명시
- 취소 행은 행 전체를 기울임 + 취소선 + 회색

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:55:53 +09:00
king bfa55bf367 feat(performance): 일자별 표 날짜 mm/dd(요일)·폭 210px, 주문 내역 창 열 제목 고정·취소 표시
- 일자별 × 쇼핑몰: 날짜 "09/01(화)" 형식, 공휴일 이름은 날짜 바로 오른쪽,
  날짜 열 너비 210px 고정
- 주문 내역 창: 열 제목 가운데·굵게·150%(18px), 창을 스크롤해도 위에 고정
- 구분 "취소"는 기울임 + 취소선 + 회색

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:52:29 +09:00
king 643ff25f27 fix(performance): 카페24 환불 — 네이버페이만·전체취소 배송비 포함, 0원 결제 주문은 0원
9/4·9/16·9/25 대조 결과:
- 9/4 환불 122,100 = 환불 목록 98,700 + 네이버페이 취소 19,900 + 그 주문 배송비
  3,500 (주문 전체취소) — 우리는 배송비를 빠뜨려 −3,500 (9/14 −7,000 도 같은 유형)
- 9/16 환불 201,100 = 환불 목록 그대로 — 우리가 더 뺀 9,900 은 톡체크아웃
  (KAKAOPAY) 환불 기록 없는 취소. 카페24 는 네이버페이만 센다 (9/21 도 같은 유형)
- 9/25 결제: 실결제·적립금·네이버포인트는 카페24 와 같은데 합계만 +9,900 —
  네 값이 모두 0인 주문(가상계좌·휴대폰 9,900)을 상품식으로 넣었기 때문.
  카페24 는 0원 (9/11 +24,900 도 같은 유형)

- unrefunded_claims: 네이버페이(NCHECKOUT) 주문만, 주문 전체가 취소·반품되면
  배송비(− 배송비 할인·쿠폰)를 마지막 클레임 품목에 한 번 더함
- _paid_total: 상품식 대체 제거
- 대조 표에 품목별 배송비 포함액 표시, 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 23:03:50 +09:00
king 2f86445077 feat(performance): 카페24 대조에 환불 목록 없는 취소·반품 건별 표
결제합계 공식 교체 후 남은 차이는 결제 2일(9/25 +9,900, 9/11 +24,900)과
환불 5일(9/21·9/16 +9,900, 9/11 +26,400, 9/14 −7,000, 9/4 −3,500).
−3,500/−7,000 은 환불 목록에 없는 취소(네이버페이 등)의 배송비 환불을 안 넣은
것으로 보여, 그 건들을 건별로(뺀 금액·품목 결제금액·쿠폰·주문 전체취소 여부·
주문 배송비) 표시한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 22:53:43 +09:00
king 398e5181fd fix(performance): 카페24 결제합계 = 실결제 + 적립금 + 예치금 + 네이버포인트
9/23 대조 진단으로 확인: 카페24 일별 매출내역 결제합계 1,874,738 =
실결제 1,713,128(initial payment_amount) + 적립금 10,110 + 예치금 0 +
네이버포인트 151,500(주문 naver_point). "상품구매금액 + 배송비 − 할인 − 쿠폰"은
1,874,800 으로 할인 필드에 안 잡히는 차이(62원)가 남는다 — 카페24 화면의
상품구매금액은 결제 금액에서 거꾸로 맞춘 값. 상품추가할인은 0 이라 원인 아님.

- order_total / order_total_now: 실결제 + 적립금 + 예치금 + 네이버포인트
  (모두 0인 주문만 상품식)
- 품목 상품추가할인 차감 제거(직전 커밋의 잘못된 추정)
- 대조 표: 실결제·적립금·예치금·네이버포인트 줄을 카페24 열과 비교,
  상품식은 참고 줄로
- 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 22:08:18 +09:00
king 20d19792dd feat(performance): 카페24 대조에 원본 금액 필드 합계 진단 + 이상 주문 목록
품목 상품추가할인(additional_discount_price)을 빼도록 바꿨는데도 일별 비교
결과가 그대로(+62, +260 …)라, 카페24 상품구매금액과의 차이가 어느 원본 필드에
있는지 추측하지 않고 찾기 위해:

- reconcile 결과에 diag: 그날 결제 주문 전체의 금액성 숫자 필드 합계
  (initial_order_amount / actual_order_amount / items / 주문 최상위). 이름에
  price·amount·discount·point·fee 등이 들어간 필드만 — 계좌·연락처 제외
- odd_orders: 상품금액이 100원 단위가 아니거나 판매가×수량 합과 다른 주문(최대 60건)
  + 품목의 0 아닌 금액 필드
- 화면: 판매가 합계 − 카페24 상품구매금액 = 찾는 금액, 같은 값 필드 강조
- performance.js 캐시 버전 올림(이전 커밋에서 빠짐)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 21:49:12 +09:00
king 6f43f8066a fix(performance): 카페24 결제합계에서 품목 상품추가할인 빼기 + 대조 표에 카페24 열별 차이
일별 비교 결과 결제합계가 틀린 날은 모두 카페24 상품구매금액이 100원 단위가
아닌 날이고, 차이만큼 더하면 정확히 100원 단위가 된다(9/23 1,860,738+62,
9/22 2,620,740+260, 9/12 7,889,287+13 …). 카페24 화면의 상품구매금액은
품목 상품추가할인(items[].additional_discount_price, 문서: 상품추가할인액)을
뺀 값인데, initial_order_amount 에는 이 할인이 없어 우리가 그만큼 많았다.

- order_total: 판매가 합계 − 품목 상품추가할인 + 배송비 − 할인 − 쿠폰
- order_total_now: 취소·반품 품목의 추가할인은 제외
- 대조 표: 상품구매금액을 추가할인 뺀 값으로 + 판매가 합계·추가할인 세부 줄
- 일별 비교에서 날짜를 눌러 연 대조 표에 붙여넣은 카페24 열과 열별 차이 표시
- 테스트 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 21:43:50 +09:00
king 614332a1e6 feat(performance): 카페24 일별 매출내역 붙여넣기로 날짜별 한 번에 비교
카페24 화면과 몇몇 날짜만 안 맞는데 어느 날·어느 쪽(결제/환불)인지,
저장값이 예전 규칙이라서인지 규칙 자체가 틀린 건지 구분할 방법이 없었다.

- GET /performance/api/marketplaces/{code}/daily-check?from=&to=&live=1 (관리자, 62일)
  db   = 저장된 날짜별 결제합계·결제 건수·환불합계(c24: 사건 전체 = 카페24 화면 범위)
  live = 지금 API·현재 규칙으로 다시 계산(adapter.collect, 저장 안 함)
- 설정 → 카페24 매출 대조 카드에 "일별 한 번에 비교": 카페24 표 붙여넣기 →
  날짜별 차이(저장값/API), 판정(일치 / 다시 가져오면 해결 / 규칙 차이(결제·환불)),
  [다시 가져오기] 버튼, 날짜 클릭 시 그날 상세 대조
- 테스트 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 21:36:32 +09:00
king 1d12ac878b fix(performance): 카페24 환불합계를 일별 매출내역과 같게 — 적립금 환불 + 네이버페이 취소
실데이터 대조 결과 카페24 일별 매출 환불합계 =
  환불 목록(실제 환불액 + 적립금·예치금 환불)
  + 환불 목록에 없는 취소·반품(네이버페이 취소 등, 품목 취소일 기준)
9/26: 178,220 + 1,080 + 96,500 = 275,800, 9/27: 145,000 + 55,800 = 200,800 일치.

- normalize_refund 금액에 적립금·예치금 환불 포함(refund_total)
- unrefunded_claims: orders date_type=cancel_date|return_complete_date 의 C40~43/R40~43
  품목 중 앞뒤 60일 환불 목록에 없는 주문 → CANCEL/RETURN 사건(c24:{품목코드}-CL)
- 대조 화면 환불합계를 적용 규칙으로 표시 + "적용 규칙" 후보
- 테스트 추가

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:59:24 +09:00
king b3ee219858 feat(performance): 카페24 매출 대조 — 금액이 줄어든 주문 건별 + 주문취소일 조회
결제일 기준 후보도 카페24 환불합계와 맞지 않음(9/26, 9/27). 9/26 결제 주문의
(결제 당시 − 현재) 205,200 중 환불 기록은 148,320 뿐이라, 환불 API 에 안 잡히는
취소(네이버페이 등)를 찾기 위해 줄어든 주문을 건별로(채널·결제수단·품목 상태·
네이버페이 클레임·취소일·환불 기록) 표시. 클레임 조회에 cancel_date 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:52:57 +09:00
king 1eca66838b feat(performance): 카페24 매출 대조 — 결제일 기준 환불 후보
9/26 에 실제로 일어난 환불은 4건(178,220)뿐인데 카페24 환불합계는 275,800.
카페24 일별 매출이 환불을 원 주문 결제일에 빼는지 확인하기 위해 후보 추가:
- 그날 결제한 주문이 오늘까지 환불된 금액(실제 / 적립금 포함, 환불일 표시)
- 그날 결제한 주문의 결제 당시 금액 − 현재 금액(actual_order_amount)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:49:02 +09:00
king 370834b58b feat(performance): 카페24 매출 대조 — 환불합계 후보·환불 건별·취소/반품 완료 품목
9/26 은 결제합계가 카페24와 같고 환불만 97,580 모자라며 완료일·접수일·적립금
어느 기준으로도 맞지 않아, 환불 API 에 빠진 건을 찾는 진단을 추가.
- 환불합계 후보 표: 카페24 화면 값을 입력하면 같은 줄 강조
- 환불 건별 목록(완료일·접수일 기준 합침, 계좌 등 개인정보 제외)
- 그날 취소/반품/교환 완료 품목(orders date_type=*_complete_date, embed=items)
  품목 판매가·결제금액·쿠폰·환불 기록 유무

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:44:21 +09:00
king a19c1f4cab feat(performance): 매출 업데이트는 보고 있는 기간을 가져오기 + 카페24 환불 기준 비교
- 대시보드 [매출 업데이트]가 최근 7일 고정이 아니라 지금 보고 있는 기간(오늘까지)을 가져온다
  ("이번달"이면 1일~오늘). 모듈 권한자 92일까지, 더 긴 기간(최대 366일)은 관리자만. 미래 기간은 400
- 카페24 매출 대조에 "환불 기준 비교": 환불완료일(완료) vs 환불접수일(전체 상태·상태별),
  실제 환불액만 / 적립금·예치금 포함 — 9/23~27 순매출이 카페24보다 크게 나오는 원인 확인용

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:21:08 +09:00
king fb7c29833e fix(performance): 카페24 매출 대조 채널 표를 market_id × 주문경로로 — self 를 "PC"로 잘못 표시하던 문제
실데이터 확인: market_id "self" 는 PC 전용이 아니라 자체몰 전체이고, 그 안에 주문경로 "PC쇼핑몰"·"모바일웹"이
섞여 있다. 구분을 "자체몰"로 고치고, (market_id, 주문경로) 한 쌍을 한 줄로 나눠 표시.
환불도 원 주문의 주문경로로 같은 줄에 붙인다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:11:27 +09:00
king ef12a34600 feat(performance): 카페24 매출 대조 — 채널별 PC/모바일 주문 분리 + 결제수단별 표
- 주문 채널별 표에 PC 주문 / 모바일 주문(주문의 order_from_mobile 기준 — PC 채널이어도 휴대폰 주문은 모바일)
  건수·결제합계, 카페24 열(자체몰) 합계 줄
- 결제수단별 표(카페24 열 주문의 payment_method_name 조합별 주문수·결제합계·비중)
- 대조 카드를 설정 화면 가로 전체 폭으로(넓은 표가 잘리지 않게), 자체몰 채널 이름 정리(PC)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 17:04:51 +09:00
king f63f82d642 fix(performance): 카페24 market_id 의 자체몰 채널(모바일웹·네이버페이·톡체크아웃)을 자체몰로 분류
실데이터 대조 결과 "다른 마켓 연동"으로 보이던 주문은 mobile(모바일웹)·NCHECKOUT(네이버페이)·
KAKAOPAY(톡체크아웃) — 모두 카페24 자체몰 주문. 금액은 이미 카페24 열이었지만 대조 표시가 오해를 불렀다.

- SELF_CHANNELS 로 자체몰 채널 명시, channel_kind(self/market/unknown)
- MARKET_MAP 에서 결제수단과 헷갈리는 일반 이름(naver, kakao 등) 제거
- 매출 대조: "카페24 열 / 다른 쇼핑몰 열" + "주문 채널별" 표(자체몰 채널/외부 마켓/알 수 없는 채널)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:59:16 +09:00
king 19396f1745 feat(performance): 카페24 마켓 연동 주문을 해당 쇼핑몰 열로 집계
- 카페24 마켓 통합관리가 가져온 주문(market_id ≠ self)을 MARKET_MAP 으로 네이버·쿠팡·11번가 등 열에
  (SaleEvent.marketplace_code). 연결표에 없는 마켓은 카페24 열 — 전체 합계는 카페24 일별 매출내역과 같음
- 환불도 원 주문의 마켓으로 같은 열에
- 카페24 사건 ID 에 c24: 접두어, 기간 교체는 카페24 열 + 다른 열의 c24: 행만 — 직접 연동분은 보존
- 매출 대조 마켓별 표에 "반영 열", 설정 화면에 "카페24 경유" 표시

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:54:10 +09:00
king 4cb37688ed feat(performance): 카페24 매출 대조에 다른 마켓 연동 주문을 마켓별(market_id·주문경로)로 표시
9/28 대조 결과 자체몰 + 다른 마켓 연동 합계가 카페24 일별 매출내역과 모든 줄에서 일치(공식 확인).
어느 마켓 주문인지 확인할 수 있게 market_id 별 주문수·결제합계·환불·순매출 표를 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:46:28 +09:00
king 27ee92c0a6 fix(performance): 카페24 매출을 카페24 "일별 매출내역" 기준으로(결제합계·환불합계) + 매출 대조 도구
원인: 품목 결제금액(배송비 제외)을 매출로, 취소·반품 완료일의 품목 금액을 환불로 잡아
카페24 화면(결제합계 = 상품구매금액 + 배송비 − 할인 − 쿠폰, 환불합계 = 환불완료일 실제 환불액)과 달랐다.

- SALE: 결제일 기준 주문 단위 결제합계(initial_order_amount — 결제 당시 금액)
- CANCEL/RETURN: GET /admin/refunds 환불완료일, 실제 환불액(환불코드 R=반품)
- 환불도 원 주문 market_id 로 자체몰만(다른 마켓 연동 주문 제외)
- 기간 교체(replace_range): 동기화한 기간의 카페24 실데이터를 지우고 새로 넣음(한 트랜잭션,
  테스트 데이터 제외) — 예전 품목 단위 행이 남아 이중 집계되지 않게
- 설정 화면 "카페24 매출 대조": 날짜별로 카페24 화면 열 순서대로 원천 금액 합산(자체몰/마켓 구분, 저장 안 함)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:38:44 +09:00
king 04a1fddd95 feat(performance): 카페24 주문 매출 수집 연동 + 과거 매출 가져오기
카페24 (Admin API GET /admin/orders, 문서 2026-09-01 기준)
- 결제(SALE): date_type=pay_date, embed=items — 결제된 주문의 품목 결제금액(할인 반영·배송비 제외), 결제일
- 취소(CANCEL): cancel_complete_date, 품목 C40~C43 만 음수(입금전취소 C47~C49 제외)
- 반품(RETURN): return_complete_date, 품목 R40~R43 음수, 부분 반품은 claim_quantity 비율
- 자체몰 주문만(market_id=self) — 카페24로 연동된 다른 마켓 주문은 이중 집계 방지로 제외
- 60일 단위 분할(한 호출 3개월 미만), limit 1000 페이지 넘김, 개인정보 미저장(raw 는 금액·상태만)
- 기존 app/integrations/cafe24 토큰·클라이언트 재사용, 연결 테스트는 주문 권한까지 확인
- DEFAULT_SCOPES 에 mall.read_order 추가(읽기만) — 카페24 상품관리 → 시스템에서 재연결 필요

과거 매출 가져오기(설정, 관리자): 기간 지정 수집(최대 366일), 일반 사용자는 403

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:25:25 +09:00
king 6e175d0bac fix(performance): 매출 업데이트 결과 — 인증정보 미설정 쇼핑몰은 실패(빨강)가 아닌 회색 한 줄로
실패는 인증 실패·API 오류처럼 손봐야 하는 것만 표시. 미설정/연동 준비 중은 이름만 모아 표시.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:16:07 +09:00
king aa669553db feat(performance): 실적(쇼핑몰 통합 매출) 모듈 1단계 — 대시보드·설정·보안·어댑터 구조
- 네 영역 분리: ① 수집(adapters/ 쇼핑몰 10곳 + sync.py) ② 보안(security/ + credentials.py)
  ③ 계산·저장(calc.py + db.py) ④ 화면(dashboard.py, router.py, templates, performance.css/js)
- 대시보드: 기간(오늘/이번주/이번달/올해/직접선택, 이전·다음), 쇼핑몰 필터, KPI 5개(진행 중 기간은
  직전 기간 같은 경과일 대비), 일자×쇼핑몰 표(주간합계, 총매출/수수료/차감매출 전환), 일별 추이·
  쇼핑몰 비중(SVG), 월 누적(비중)·연간 누적, 금액 클릭 → 주문 상세
- 설정(관리자): 사용/매출 집계, 수수료율 이력(적용 시작일), 쇼핑몰별 API 인증정보 입력·연결 테스트·
  연결 상태, 마스터 키 상태·재암호화, 테스트(모의) 데이터 생성/삭제
- 인증정보: 설정 화면 입력 → AES-256-GCM(키 버전, AAD=쇼핑몰+항목) 암호화 저장, secret 원문은
  화면으로 다시 보내지 않음, 오류·로그·raw 는 비밀값 가린 뒤 저장. 마스터 키는 APP_ENCRYPTION_KEY(.env)
- 매출 기준일: 결제=결제일, 취소·반품=발생일. 금액 원 단위 정수, 수수료 반올림은 calc.commission 한 곳
- 동기화: 같은 쇼핑몰 동시 실행 차단(running 부분 유니크), 쇼핑몰별 실패 격리, 중복 방지 UNIQUE+UPSERT
- 카페24 어댑터는 기존 app/integrations/cafe24 OAuth 토큰 재사용, 나머지는 입력칸만(수집은 다음 단계)
- performance_db 초기화 스크립트, 권한키 performance(설정은 is_admin), 문서·.env.example

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 16:07:46 +09:00
king b95206dcf4 fix(project): 보드 카드 고정 머리를 섹션 제목 바로 아래에 붙임(위 8px 틈으로 스크롤 줄이 비치던 문제)
sticky 는 스크롤 영역의 padding 안쪽에 붙으므로 top 을 .pj-col-body padding-top 만큼 음수(-8px)로.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:50:39 +09:00
king 52c1b004e6 fix(project): 타임라인 드래그를 날짜 칸 단위로(반나절에 걸리던 문제) — snap 을 가장 가까운 날 0시로
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:42:45 +09:00
king 6dfc6109a4 feat(project): 타임라인 카드 — 하위 작업은 개수 말풍선만(펼치기 제거), 설명 있으면 설명 아이콘
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:36:04 +09:00
king d2a65e5c37 fix(project): 타임라인이 통째로 안 보이던 문제 + 정적 파일 캐시 버전 올림
- vis 는 첫 rangechanged 뒤의 changed 에서야 타임라인을 보이게 하는데, changed 안에서 setWindow 한
  범위의 rangechanged 가 비동기로 늦게 와 다시 그리지 않아 visibility:hidden 로 남던 문제 —
  rangechanged 에서 아직 숨어 있으면 redraw()
- project.js/css 캐시 버전(?v=)을 20260929e 로 — 그동안 파일을 고치고도 올리지 않아
  브라우저가 예전 파일을 쓸 수 있었다

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:29:37 +09:00
king 72c23011fe fix(project): 타임라인 날짜 색 어긋남 수정, 날짜 밑 공휴일 이름, Ctrl+휠 축소 한계
- 날짜 라벨 색을 그린 뒤 class 로 달던 방식(paintTLDays)이 vis 라벨 재사용 때 다른 날짜에
  색이 남던 문제 — 색을 라벨 태그로 싣고(<em> 빨강, <i> 파랑) CSS 로 칠함
- 공휴일은 날짜 밑에 줄인 이름(<abbr title=전체 이름>, 캘린더 날짜 팝업과 같은 규칙),
  날짜 줄은 두 줄 높이로 년·월 줄을 가리지 않게
- zoomMax 를 "하루 = 날짜 글자 폭" 구간으로 — 더 줄이면 이틀 간격 라벨로 날짜가 빠지던 문제

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 14:11:41 +09:00
king 2c904ebd3e fix(project): 보드를 다시 그려도 섹션 스크롤 위치 유지(작업 창 닫기·완료 체크 후 맨 위로 튀던 문제)
- renderBoard 가 섹션별 세로 스크롤(.pj-col-body)과 보드 가로 스크롤을 저장했다가 되돌림
- 작업 창을 닫을 때 펼친 카드의 하위 작업을 먼저 받아 온 뒤 한 번에 다시 그림
  ("불러오는 중"으로 짧아진 채 그리면 스크롤이 위로 밀림)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 13:57:02 +09:00
king e9b498dd04 feat(project): 보드 최상위 작업 카드에도 설명이 있으면 설명 아이콘
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 13:43:05 +09:00
king 8859fb0aeb feat(project): 보드 카드 하위 작업 추가 줄 — 이름을 쓴 채 바깥을 누르면 Enter 처럼 만들고 닫기
- 문서 pointerdown(onOutsideDown)으로 바깥 누름 감지, 한글 조합 중인 마지막 글자까지 반영
- 날짜 팝업·담당자 메뉴·그 줄 안은 제외, 마감일을 고르면 입력칸으로 포커스 복귀
- 보드를 다시 그릴 때 카드별 이전 리스너를 떼어 쌓이지 않게

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 13:22:23 +09:00
king 972b7e4d78 feat(project): 타임라인 드래그로 날짜 이동·이름 클릭 시 작업 창, 하루 폭 = 날짜 글자 폭, 고해상도 배율 축 잘림 수정
- 화면 배율(pj-ui-scale)에서 타임라인만 zoom 을 1 로 되돌리고 크기는 --tz 로 줄임
  (vis-timeline 이 zoom 안에서 하단 년·월 축을 잘라 그리고 끌기가 마우스와 어긋나던 문제)
- 카드를 선택 없이 바로 끌어 하루 단위로 이동(itemsAlwaysDraggable, 하위 작업 카드 포함),
  끈 거리를 일 단위로 반올림해 원래 날짜에 더함(시각 유지)
- 작업 이름 클릭 → 오른쪽 작업 창(끌고 놓은 click 은 무시)
- 처음 보기 범위: 하루 칸 = "30일 (수)" 글자 폭, maxMinorChars 도 맞춤(저장 키 pj_tl_window2)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 13:19:27 +09:00
king 962dc93e84 feat(project): 하위 작업 댓글·설명 아이콘, 카드 상단 고정, 색상표 32색
- 지난 마감일 말풍선은 "마감일 지남"(dueTip)
- 날짜 팝업: 마감일을 고르면 저장 후 바로 닫힘(시작일 선택 땐 열어 둠)
- 하위 작업 줄에 댓글(개수+말풍선)·설명(줄글) 아이콘(subMetaHtml) — 작업 창·보드 카드 공용
- 하위 작업을 펼친 보드 카드는 윗부분(.pj-card-head)을 sticky 로 컬럼 맨 위에 고정
- 프로젝트·섹션 색상표 16색 → 32색(아래 2줄 진한 색), 진한 칸은 흰 체크

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 11:53:04 +09:00
king 07e957a11f fix(project): 하위 작업 입력칸 브라우저 자동완성 끄기, 다른 작업 열 때 입력값 비움
- 하위 작업·댓글·섹션/프로젝트 이름 칸에 autocomplete="off" — 크롬/엣지가
  예전에 쳤던 문구 목록을 띄우지 않게.
- 작업 창을 열 때 하위 작업 추가 칸(제목·담당자·마감일)을 비우고 taskId 를
  끊음 — 쓰다 만 제목이 다른 작업으로 따라가거나, 상세 로딩 중 Enter 로
  이전 작업에 붙던 버그 수정.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 10:06:45 +09:00
king 634c390f7c fix(project): 공휴일 표에 제헌절(7/17) 추가 — 2026년부터 공휴일
쿠팡 모듈 holidays.py 와 같은 기준(대체공휴일 대상 아님). 캘린더·타임라인·
날짜 팝업이 모두 이 표를 쓴다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 02:53:34 +09:00
king ce7879f43d feat(project): 날짜 팝업 공휴일 숫자 밑에 휴일 이름 표시
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 02:50:03 +09:00
king f1e7de585d feat(project): 날짜 팝업에 일요일·공휴일 빨강, 토요일 파랑
KR_HOLIDAYS 를 Jinja 전역(pj_kr_holidays)으로 두고 공용 사이드바에서
window.PJ_HOLIDAYS 로 넘겨, 프로젝트 관리 모든 화면의 마감일/시작일
팝업(openDatePopover)이 국경일·공휴일·대체공휴일을 빨강으로 칠한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 02:43:45 +09:00
king ff69c7e0b1 style(project): 답글 화살표를 둥글게 꺾이는 SVG 로, 크기 90%
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 21:20:57 +09:00
king 8119859189 fix(project): 댓글칸 멤버 태그 목록을 @ 아이콘 윗부분에 띄움
@ 버튼이 있는 입력칸은 멤버 목록을 그 버튼 위쪽(오른쪽 끝 맞춤)에 띄우고,
위 공간이 없을 때만 아래로. 설명란 태그 목록은 기존대로 커서 아래.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 21:19:43 +09:00
king 60265f0cf6 feat(project): 댓글 입력칸 @태그 버튼, 답글 들여쓰기 + ↳ 화살표
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 21:15:26 +09:00
king 5be647b14f feat(project): 작업 창 댓글 입력칸을 창 하단에 고정(아사나식)
입력칸을 스크롤 영역(.pj-modal-body) 밖 #pj-comment-dock 으로 옮겨
항상 보이고, 끝까지 스크롤해도 마지막 내용이 입력칸 위에서 멈춘다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 21:08:59 +09:00
king 2b6b598ea0 style(project): 섹션 제목 옆 작업 개수를 제목 글자 세로 가운데로
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 21:01:50 +09:00
king de140304b9 style(project): 제목 전체에 프로젝트 색 배경, 아이콘 1.2배·세로 가운데, 섹션 추가 110px
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 20:56:10 +09:00
king 10610b119f feat(project): 아사나식 머리(제목·탭 2줄)·섹션 추가 위치·팝업 제목 KSN 프로그램
- 프로젝트 제목(색 네모 아이콘+이름)+멤버 / 뷰 탭을 왼쪽 위 2줄로
- "전체 프로젝트" 스코프면 제목을 "전체 프로젝트"로, 멤버 숨김
- "+ 섹션 추가"를 마지막 섹션 바로 오른쪽으로, 위쪽 바 "+ 작업 추가" 제거
- 수신함 오른쪽 작업 창(embed) 맨 위에 "프로젝트로 이동" 버튼
- 하위 작업에 또 하위 작업이 있으면 "N ⤷" 아이콘(작업 창·카드 펼침)
- erp-dialog: 화면별 제목(window.ERP_DIALOG_TITLE)·erpPrompt 추가,
  project.js 의 alert/confirm/prompt 를 공용 창으로(제목 "KSN 프로그램")

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 20:43:36 +09:00
king 43b2ce7ad0 fix(project): 완료 취소 시 완료 이력 줄도 숨김 — 지금 완료 상태일 때 마지막 완료 1건만 표시
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 18:14:45 +09:00
king 4fb8b37d9c feat(project): 실시간 저장·댓글 답글/반응·완료 이력·수신함 오른쪽 작업 창·화면 배율 토글
- 작업 창 저장 버튼 제거 → 칸별 실시간 저장(새 작업은 제목 입력 시 생성)
- 댓글 답글·이모티콘 반응(마이그레이션 012), @태그 아이콘+이름 칩, 이모티콘 선택기
- 작업 완료 시 댓글 사이에 "OO 님이 이 작업을 완료했습니다" 이력 표시
- 수신함 "확인" → 페이지 이동 없이 오른쪽 패널(iframe embed)에 작업 창
- 프로젝트 제목 클릭 수정, 긴 작업 제목 자동 줄바꿈
- 상단 바 화면 배율 토글(2880x1620·200%용, .erp-app zoom .75)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 18:11:34 +09:00
king 3882dd7ad3 fix(cafe24): 품목 이미지 주소에 도메인이 두 번 붙어 오는 경우 복구
카페24 GET variants 의 image 가 "https://miras.co.krhttps://cafe24img.poxo.com/
miraskitchen/web/product/extra/big/…" 처럼 쇼핑몰 도메인 뒤에 CDN 전체 주소를
또 붙여 돌려준다(추가이미지를 품목 이미지로 쓴 경우). 그대로 src 에 넣어 깨져
옵션 썸네일이 "없음"으로 보였다. 문자열 안에 http(s):// 가 또 있으면 마지막
주소부터 쓴다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 00:44:20 +09:00
king 89f055f24b fix(cafe24): 옵션 썸네일 — 슬래시 없는 상대경로도 쇼핑몰 주소로, 말풍선에 경로 표시
- "web/product/…" 처럼 앞 슬래시 없는 경로도 image_base 를 붙인다
  (http/https/data/blob 이 아니면 전부 쇼핑몰 기준).
- 썸네일 말풍선에 실제 이미지 경로를, "없음"에는 불러오지 못한 경로들을
  보여준다 — 품목 이미지(/web/product/extra/big/… 추가이미지)가 어디서
  오는지 화면에서 바로 확인할 수 있게.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 00:42:11 +09:00
king e0dc818eab fix(cafe24): 대표이미지 적용 안 됨 + 옵션 썸네일 "없음" 오표시
- 대표이미지: NNEditor 업로드 경로를 PUT detail_image 에 넣던 방식은 카페24가
  반영하지 않았다. 문서의 전용 API POST /admin/products/{no}/images 에
  base64 data URI + image_upload_type=A 로 등록하고, 응답의 새 경로 4개로
  화면·스냅샷을 맞춘다(응답에 updated_date 가 없어 스냅샷 시각은 등록 시각).
- 옵션 썸네일: 카페24는 option_link_image 등을 "/web/product/big/…" 상대경로로
  준다. 그대로 src 에 넣어 우리 도메인에서 404 → "없음"으로 보였다. 옵션 GET 에
  image_base(쇼핑몰 주소)를 내려 붙여 그리고, 후보(버튼→연결→품목 이미지)가
  깨지면 다음 후보로 넘어간다. 카페24로 되보내는 hidden 값은 원본 그대로.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 00:33:17 +09:00
king 81cd0ed0e9 feat(project): 타임라인에서 하위 작업 펼치기(아사나식)
- 카드의 "N ⤷ ▸" 를 누르면 그 작업의 하위 작업을 받아 바로 아래에 각자 날짜
  자리의 작은 카드(점선 테두리, 끌어 옮기기 없음)로 추가, 다시 누르면(▾) 접기.
  vis order 로 부모 바로 뒤에 쌓이게, 날짜 없는 하위 작업은 안내만
- 하위 작업 카드 더블클릭 = 열기, 우클릭 = 열기 / 상위 작업 열기
- 펼친 상태·받아 둔 하위 작업은 타임라인을 다시 그려도 유지, 작업 창이 닫히면
  다시 받는다
- 도움말 13장 갱신, 정적 파일 버전 20260926v

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 15:33:20 +09:00
king 8f485be428 feat(project): 타임라인을 아사나식 카드로 + 섹션 색 + 하위 작업 아이콘
- 작업 아이템을 vis template(요소 반환 → 정화 없음)으로 그린다: 담당자 사진 ·
  제목 · 하위 작업이 있으면 "N ⤷" 아이콘 · 댓글 💬N(누르면 대화창) / 둘째 줄
  "마감일: 9월 23일" 또는 "시작 – 마감". 기간 막대는 행 색을 옅게 + 왼쪽 선,
  하루짜리는 흰 카드 + 왼쪽 선, 글자는 막대 밖으로 이어서 보임. 완료는 취소선
- 행 색: "이 프로젝트"는 섹션에 지정한 색(없으면 프로젝트 색), 행 이름 앞 색 네모
  (groupTemplate), 행 배경 띠도 같은 색
- 주말 세로줄 옅은 회색
- 도움말 13장 갱신, 정적 파일 버전 20260926u

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 15:28:05 +09:00
king 4c9a9199ad fix(project): 캘린더 — 댓글 아이콘은 대화창만, 한 달이 스크롤 없이, 막대가 공휴일 이름을 안 가리게
- 캘린더 막대의 댓글 말풍선을 누르면 막대 누르기(편집 창 열기·드래그)를
  시작하지 않는다 — 댓글 대화창만 열린다
- 캘린더 보기를 세로로 채우고 주(행)가 남은 높이를 나눠 씀(주 최소 134px → 82px),
  주마다 막대 줄 수를 실제 높이로 계산(다 들어가면 전부, 넘치면 "+N 더"),
  창 크기가 바뀌면 다시 계산
- 공휴일 이름을 날짜 숫자와 한 줄에 — 34px 아래부터 그리는 막대에 가려지지 않음
- 정적 파일 버전 20260926t

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 15:16:24 +09:00
king 6a778a3702 feat(project): 타임라인 날짜 색을 캘린더와 같게(토 파랑, 일·국경일·대체공휴일 빨강)
- 프로젝트 화면 데이터에 공휴일 표(store.KR_HOLIDAYS) 추가
- 타임라인 minorLabels 에 보이지 않는 표시 글자(빨강 U+2063 / 파랑 U+2064)를
  붙이고, 다시 그릴 때마다(changed) 표시를 보고 색 클래스를 단다 — vis 는 확대
  단계에 따라 요일 class 를 안 붙이고 공휴일은 모르므로 직접 판단
- 도움말 13장에 날짜 색 안내, 정적 파일 버전 20260926s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 15:07:48 +09:00
king 7743361607 fix(project): 설명 체크리스트를 진짜 글머리 기호처럼 + 서식 도구 상단 고정
- 체크박스를 글자 속 <input> 대신 글머리 자리에 CSS 로 그린다(li::before) —
  체크박스 왼쪽에 글자가 들어가던 버그 해결, Enter·빈 줄 Enter·Backspace 는
  브라우저 글머리 목록 동작 그대로. 체크 여부는 li data-checked="true",
  글자보다 왼쪽(체크박스)을 누르면 체크/해제. 새 줄은 체크 안 된 채로 시작
- 예전 방식(<input type=checkbox>) 체크리스트는 열 때 자동으로 새 방식으로 변환
- 서버 정리기: li 의 data-checked="true" 만 허용
- 서식 도구 줄 sticky — 설명을 아래로 스크롤해도 설명 구간 안에서는 위에 붙어 있음
- 정적 파일 버전 20260926r

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:43:08 +09:00
king 5b0c5905b2 feat(project): 설명 체크박스를 글머리 목록처럼(체크리스트) + 작업 창 스크롤바 정리
- ☑ = 체크리스트 켜기/끄기: 지금 줄(고른 줄들)을 <ul class="pj-checklist"> 로,
  줄마다 체크박스. Enter 로 새 줄에도 체크박스, 빈 줄 Enter 는 목록 끝.
  체크리스트 안에서 글머리·번호 버튼은 체크박스를 빼고 그 목록으로.
  체크한 줄은 흐리게 + 취소선
- 서버 정리기: ul 의 class 는 pj-checklist 하나만 허용(태그별 허용 class 표)
- 작업 창 스크롤 영역: 가로 스크롤 제거(설명란 음수 여백 때문에 생기던 것),
  오른쪽 여백까지 넓혀 세로 스크롤바를 창 오른쪽 끝으로
- 도움말 8장 체크리스트 설명 갱신, 정적 파일 버전 20260926q

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:32:58 +09:00
king f8ff75127b style(project): 작업 설명란을 아사나처럼 테두리 없이 내용만큼 늘어나게
- .pj-desc-editor: max-height 300px·내부 스크롤·테두리 제거 — 설명 길이대로
  아래로 계속 늘어나고 스크롤은 작업 창 전체가 한다
- 음수 여백으로 글자를 다른 칸과 같은 왼쪽 끝에 맞춰 가로 폭 전부 사용,
  마우스를 올리거나 입력 중일 때만 옅은 바탕
- 정적 파일 버전 20260926p

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:25:41 +09:00
king f265a59c3f fix(project): 설명 서식 도구의 이미지 추가 아이콘만 위로 떠 있던 문제
이미지 추가 버튼은 파일 선택용 <label> 이라 팝업 공용 규칙
".pj-modal-card label"(display:block + margin-bottom:12px)이 버튼 모양을
덮어써 혼자 위로 올라가 있었다. label.pj-desc-fmtbtn 에서 inline-flex·
margin 0 등으로 되돌린다. 정적 파일 버전 20260926o.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:22:15 +09:00
king e6c3d8c8cb style(project): 설명 서식 도구 아이콘을 한 줄로 정렬
글자(B·I·U·S)·기호(☰•·❝)·이모지(🔗)·"✕서식"이 섞여 높이가 들쭉날쭉하던
서식 도구 버튼을 모두 같은 아이콘 글꼴(Material Symbols, 20px)로 바꾸고
아이콘 줄 높이를 크기에 맞춰 수동 위치 보정(top:4px)을 없앴다 — 모든 아이콘의
위·아래 끝이 한 줄에 맞는다. 도움말 8장 서식 도구 설명도 아이콘으로 갱신.
정적 파일 버전 20260926n.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:20:30 +09:00
king 84f291bc76 feat(project): 설명 편집 서식 도구에 취소선·체크박스 추가
- 취소선: 서식 도구 S 버튼 + Ctrl+Shift+X (execCommand strikeThrough)
- 체크박스: ☑ 버튼으로 커서 자리에 넣고, 누를 때마다 checked 속성을 직접
  바꿔 저장·다시 열기에도 체크 상태 유지
- 서버 설명 정리기: s/strike/del 허용, input 은 type="checkbox" 만(checked 외
  속성 없음, 다른 종류는 태그째 버림)
- 도움말 8장 서식 도구 설명 갱신, 정적 파일 버전 20260926m

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 14:16:29 +09:00
king b7569f508c feat(project): 프로젝트 관리 도움말 페이지 + 상단 바 ? 아이콘
- /project/help — 처음 쓰는 사람을 위한 기능 안내 20장(용어·화면 구성·권한·
  프로젝트·보기/필터·보드·하위 작업·작업 편집 창·날짜·목록·캘린더·타임라인·
  대시보드·내 작업·댓글/@태그·수신함/알림·검색/공유·휴지통·단축키/FAQ).
  왼쪽 목차(읽는 위치 강조), 단계 번호·버튼 이름 칩·팁/주의 상자
- 로그아웃 오른쪽 ? 아이콘(새 탭) — erp_base 에 topbar_after_logout 블록을
  두고 프로젝트 관리 화면(보드·내 작업·수신함·휴지통·도움말)만 채운다
- 정적 파일 버전 20260926l

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 13:54:07 +09:00
king e7e5161bdf feat(project): 섹션 편집도 프로젝트와 같은 아사나 16색 색상표 + 밝은 색 위 글자 대비
- STAGE_COLOR_PALETTE = COLOR_PALETTE — 모든 편집창이 같은 색상표
- 섹션: 첫 칸(연회색)은 "색 없음"(NULL, 기본 회색 머리), 색 없는 섹션은 첫 칸이
  선택된 채 열림. 예전 10색으로 칠한 섹션은 저장해도 그대로(LEGACY_STAGE_COLORS)
- isLightColor: 연노랑·하늘·연분홍 등 밝은 색 위에서는 섹션 머리·사이드바 배지·
  프로젝트 제목의 글자·아이콘을 어둡게
- 정적 파일 버전 20260926k

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 13:24:19 +09:00
king af0f87c215 style(project): 프로젝트 새로 만들기·수정 팝업 너비를 여백 포함 480px 로
padding(22px×2)이 width 480px 바깥에 더해져 실제 524px 이던 것을
box-sizing: border-box 로 맞춘다. 정적 파일 버전 20260926j.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 13:15:37 +09:00
king e800a3937d style(project): 프로젝트 팝업 마감일은 라벨 옆 달력 아이콘, 아이콘 격자 스크롤 제거
- "시작일 · 마감일" → "마감일", 라벨 오른쪽에 날짜 버튼. 날짜가 없으면 점선 원
  달력 아이콘만(enhanceDateInput iconOnly), 있으면 아이콘 + 날짜(시작일은 팝업의
  "+ 시작일"). 새 프로젝트 팝업 마감일도 같게
- 아이콘 격자 높이 제한 제거 — 스크롤 없이 전부 보이고 팝업이 그만큼 길어짐
- 정적 파일 버전 20260926i

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 13:12:20 +09:00
king c77ce8e151 feat(project): 프로젝트 색상·아이콘을 아사나식으로(16색 + 아이콘 42종)
- 색상표: 아사나 프로젝트 16색(8칸×2줄, 고른 색에 체크), 새 프로젝트 기본 파랑.
  예전 팔레트 색 프로젝트는 그대로 유지(수정 팝업이 첫 칸으로 바꾸지 않음)
- 아이콘: 아사나 프로젝트 아이콘과 같은 종류 42개(Material Symbols, self-host
  글꼴에 전부 있는 것 확인). 새 프로젝트·수정 팝업에 아이콘 격자(첫 칸 Aa=없음),
  사이드바 배지·프로젝트 제목에 흰 아이콘
- DB: projects.icon (scripts/sql/project_db_011_project_icon.sql). 아이콘은
  고르거나 바꿨을 때만 보내서 011 적용 전에도 다른 생성·수정은 그대로 동작,
  아이콘을 고르면 "마이그레이션 011 필요" 안내(503)
- 색상·아이콘 칸을 label 대신 div 로(글자를 누르면 첫 버튼이 눌리던 문제)
- 정적 파일 버전 20260926h

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 13:07:46 +09:00
king 426febe5d5 style(project): 마감일 말풍선은 "마감일 변경"만, 완료 작업도 지난 마감일은 빨강 유지
- 보드 카드·작업 팝업 하위 작업 줄의 마감일 말풍선에서 날짜 괄호 제거
- dueInfo: 완료된 작업은 오늘·내일 초록만 빼고, 지난 마감일 빨강은 그대로
  (지연 개수·대시보드·"지연" 필터는 예전처럼 미완료만 센다)
- 정적 파일 버전 20260926g

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 12:56:54 +09:00
king 73780db63d feat(project): 멤버 이름(이메일 아이디) 첫 글자를 대문자로 표기
- JS: idOf 가 capName 을 거쳐 King·Bj 처럼 표시(담당자·협업자·멤버 목록·
  전체 멤버·@멘션 칩/토큰·대시보드 등 전부)
- 서버: 캘린더 막대 라벨·휴지통 "삭제한 사람", 템플릿(수신함 작성자·
  프로젝트 멤버 말풍선·담당자 선택지)
- 저장값·API id·멘션/검색 기준(이메일)은 그대로, 화면에 그릴 때만 바꿈
- 정적 파일 버전 20260926f

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 12:11:57 +09:00
king ee8c2395ae feat(project): 대시보드 "예정된 작업 합계(담당자별)"는 관리자에게만
사람별 업무량이 드러나는 차트라 is_admin 일 때만 그린다. 나머지 타일·차트는 그대로.
정적 파일 버전 20260926e.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 11:51:44 +09:00
king de9daf7bad style(project): 작업 팝업 협업자 줄을 담당자 칸과 같은 모양으로
- 라벨·간격을 담당자 칸(.pj-meta-cell)과 같게, 그룹 아이콘 제거
- 협업자는 담당자 버튼처럼 "아이콘 + 이름", 빼기(×)는 마우스를 올렸을 때만
- 없으면 점선 원 "협업자 없음"(누르면 추가 메뉴), + 버튼은 한 명 이상일 때만
- 추가 메뉴도 "아이콘 + 이름"
- 정적 파일 버전 20260926d

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 11:44:24 +09:00
king 069d7a4081 fix(project): 남은 옛 용어 정리 — 팔로우→협업자, 단계→섹션, 첨부→첨부 파일
- 작업 팝업 협업자 줄 버튼: "팔로우 / 팔로우 취소" → "협업자로 참여 / 협업자에서 나가기"
- 섹션 오류 메시지 2곳: "단계를 찾을 수 없습니다" / "단계 이름은 필수" → 섹션
- 휴지통 목록 "첨부 N" → "첨부 파일 N"
- 용어 표에 버튼 문구 추가, 정적 파일 버전 20260926c

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 02:28:02 +09:00
king 4bfb1ffa98 style(project): 섹션 스크롤바를 카드 오른쪽 회색 여백 한가운데로
- .pj-col-body 를 컬럼 오른쪽 여백(6px)까지 넓히고(margin-right:-6px),
  12px 트랙 가운데에 6px 막대(투명 테두리 3px + background-clip)
- scrollbar-gutter: stable — 스크롤 유무와 상관없이 모든 컬럼의 카드 폭 동일
- 정적 파일 버전 20260926b

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 02:23:39 +09:00
king 98369af504 style(project): 보드 섹션 좌우 여백 축소 + 섹션 세로 스크롤바 화살표 제거·투명 바탕
- .pj-col 좌우 padding 12px → 6px(색 헤더의 음수 여백도 맞춤)
- .pj-col-body 스크롤바: ::-webkit-scrollbar 로 6px 막대만(버튼 없음, 트랙 투명).
  크롬은 scrollbar-width 를 주면 webkit 스타일을 무시하고 화살표 막대를 그려서
  표준 속성은 파이어폭스(@supports not selector(::-webkit-scrollbar))에만
- 정적 파일 버전 20260926a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 02:20:26 +09:00
king 6acf69ba29 feat(project): 보드 카드 하위 작업 목록에 "+ 하위 작업 추가"(아사나식 인라인 입력)
- 펼친 하위 작업 맨 아래 "+ 하위 작업 추가" — 누르면 새 줄(작업 이름 입력 ·
  마감일 점선 달력 · 담당자 점선 아이콘)이 열리고 Enter 로 바로 생성, 줄은 열린
  채 다음 입력. Esc/빈 채로 벗어나면 닫힘
- 8초 실시간 새로고침으로 보드가 다시 그려져도 입력값·포커스 유지(subDrafts)
- fix: 날짜 팝업·우클릭 메뉴가 열린 직후(같은 틱) 닫히면 문서 리스너가 남아
  이후 Esc 를 계속 삼키던 경쟁 조건 — 등록 전에 이미 닫혔는지 확인
- 정적 파일 버전 20260925k

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 22:11:01 +09:00
king 87c73c65af feat(project): 댓글 속 웹페이지 주소를 새 탭 링크로 + 주소 붙여넣기 보장
- 작업 팝업 댓글 목록·댓글 대화창 본문을 linkifyToHtml 로 그린다
  (https://… / www.… → target=_blank rel=noopener 링크, 나머지는 이스케이프)
- 대화창 입력칸 붙여넣기: 클립보드에 글자가 있으면 글자 우선(글자+그림을
  함께 복사하는 프로그램에서 주소가 그림으로 가로채이던 문제), 그림만 있을 때 첨부
- 정적 파일 버전 20260925j

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 20:06:49 +09:00
king b324a9c413 feat(project): 댓글 말풍선을 한 번 클릭하면 댓글 대화창(더블클릭 → 클릭)
- 문서 캡처 단계 클릭 처리로 .pj-cmt-badge[data-task-id] 를 받아 카드·행·
  캘린더 막대의 클릭(작업 열기)보다 먼저 대화창을 연다
- 캘린더 막대·목록 행의 말풍선도 눌리는 배지로(data-task-id)
- 정적 파일 버전 20260925i

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 20:02:30 +09:00
king d9fba4ad1f feat(project): 모든 날짜 칸을 아사나식 날짜 팝업으로(브라우저 기본 달력 제거)
- enhanceDateInput: input[type=date] 를 숨기고 날짜 버튼을 붙여 openDatePopover 를
  연다. input 은 값 저장소로 남아 기존 .value·change 코드가 그대로 동작
- 새 프로젝트 마감일, 프로젝트 수정 시작일·마감일(버튼 하나, 팝업의 "+ 시작일"),
  하위 작업 추가 줄 마감일에 적용
- 정적 파일 버전 20260925h

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 19:50:32 +09:00
king 3620482913 feat(project): 작업 팝업의 하위 작업 줄을 아사나식으로(드래그 순서·아이콘·날짜)
- ⠿ 손잡이로 끌어 하위 작업 순서 변경
  (PUT /project/api/tasks/{id}/subtasks/order → db.reorder_subtasks)
- 담당자는 아이콘만(아바타/점선 원), 누르면 아이콘+이름 메뉴
- 마감일은 날짜 글자만(없으면 점선 달력 아이콘), 누르면 아사나식 날짜 팝업
- 제목 칸은 글자 길이만큼, 줄의 빈 곳을 누르면 하위 작업 열기
- 완료는 ✓ 아이콘, 삭제는 우클릭 메뉴로(줄의 × 제거)
- 정적 파일 버전 20260925g

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 19:44:39 +09:00
king ea15c90a61 refactor(project): 화면 용어를 아사나 한국어판에 맞춰 통일
화면·버튼·말풍선·알림창·메일·수신함 알림 문구와 문서의 용어를 바꾼다.
코드 식별자·DB 컬럼·API 주소·코드 주석은 그대로(동작 변화 없음).

- 업무 → 작업 (하위/상위 작업, 내 작업 포함, 뒤 조사도 맞춤)
- 세션 → 섹션, 팔로워 → 협업자, 리스트 → 목록, 달력 → 캘린더
- 알림센터 → 수신함, 첨부 → 첨부 파일, 링크 복사 → 작업 링크 복사
- 연결된 프로젝트 → 프로젝트 칸 + "다른 프로젝트에 추가"
- 담당자 선택 (미지정) → 담당자 없음
- "@태그"는 그대로
- docs/PROJECT_MODULE.md 맨 위에 용어 표, 정적 파일 버전 20260925f

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 18:47:08 +09:00
king 91347f8aef feat(project): 하위 업무도 업무처럼 팝업에서 똑같이 편집(아사나식)
하위 업무를 누르면 상위 업무가 아니라 그 하위 업무 자신의 팝업이 열려
제목·담당자·우선순위·마감일·설명·첨부·댓글·팔로워·하위 업무를 업무와
똑같이 고친다.

- 여는 곳: 보드 카드 하위 업무 줄 클릭 / 우클릭 "열기", 업무 팝업 하위
  업무 줄의 › 버튼, 공유 링크(/project/t/{id} 가 하위 업무 자신을 연다)
- 제목 위에 상위 업무 경로(누르면 상위 업무로), 세션 칸·프로젝트 연결은 숨김
- GET /api/tasks/{id} 에 parent_title 추가
- 저장해도 보드 목록에 카드로 끼어들지 않게 mergeTask 에서 제외
- 정적 파일 버전 20260925e

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 18:36:48 +09:00
king d5e02b04a4 feat(project): 보드에서 하위 업무 한 줄을 다른 업무 카드로 드래그해 옮기기
카드에 펼친 하위 업무 줄을 끌어 다른 카드에 놓으면 그 업무의 하위 업무로
옮긴다. 카드 자체 드래그(세션 이동)와 섞이지 않게 별도 드래그 타입을 쓰고,
놓을 수 있는 카드는 보라 테두리로 표시한다.

- API: POST /project/api/tasks/{id}/move-parent {parent_task_id}
- db.move_subtask: 받는 쪽은 같은 프로젝트의 최상위 업무만(순환 방지),
  활동 로그 subtask_moved, 목록 끝으로 정렬
- 정적 파일 버전 20260925d

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 18:28:56 +09:00
king db1ffdd636 feat(project): 카드 담당자 없음도 점선 원 사람 아이콘만(글자 없이)
보드 카드에서 담당자가 없으면 "담당자" 글자 없이 하위 업무 줄과 같은
점선 원 사람 아이콘만 보여준다(마감일 없음 아이콘과 같은 모양·크기).
정적 파일 버전 20260925c.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 18:23:13 +09:00
king c92337e25a feat(project): 카드 마감일 없음은 점선 원 달력 아이콘으로(하위 업무와 동일)
보드 카드에서 마감일이 없으면 "마감일" 글자 대신 하위 업무 줄과 같은
점선 원 달력 아이콘만 카드에 마우스를 올렸을 때 보여준다. 정적 파일 버전 20260925b.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 18:20:37 +09:00
king bbbe14b956 feat(project): 좌측 프로젝트 목록을 모든 화면에서 동일하게(순서변경·수정·삭제)
수신함·내 업무·휴지통 화면의 프로젝트 목록에도 프로젝트 화면과 같은
드래그 순서 변경(⣿)·✎ 수정·× 삭제·우클릭 메뉴를 붙인다.

- 트리 동작을 initProject 에서 공용 initSideTree 로 분리
- 새 프로젝트/수정 모달을 _side_modals.html 로 모아 네 화면이 include
- 수신함·휴지통에도 color_palette 전달, 정적 파일 버전 20260925a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 17:29:08 +09:00
king 56250e6027 feat(project): 업무 휴지통(3개월 보관·관리자 복구) + 하위 업무 우클릭 삭제
- 업무 삭제 시 지우기 직전 스냅샷(업무·하위 업무·댓글·팔로워·@태그·첨부
  기록·연결·활동 이력·마감 알림 기록)을 같은 트랜잭션에서 project_trash 에
  JSONB 로 남기고 삭제. 첨부 실물은 DATA_DIR/project/_trash/<id>/ 로 이동.
- 관리자 전용 휴지통(/project/trash, 좌측 메뉴): 원래 id 그대로 복구(중복·
  지워진 프로젝트·상위 없는 하위는 거부, 지워진 세션은 미지정으로).
  3개월 지난 항목은 휴지통 화면/삭제 때 영구 정리.
- 삭제 확인 공용화(confirmTaskDelete): 하위 업무가 있으면 'N개까지 모두
  삭제' 를 명확히 묻고, 휴지통 보관 안내. 카드 하위 업무 우클릭 메뉴
  (열기/완료/하위 업무 삭제).
- DB: project_db_010_trash.sql. 미적용이면 예전처럼 영구 삭제.
- 로컬 PostgreSQL 17 로 삭제→휴지통→복구·거부 조건·만료 정리 검증.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:51:33 +09:00
king 624145de56 feat(project): 아사나식 날짜 팝업 + 마감일 어제/오늘/내일 표기
- openDatePopover: '+ 시작일'/마감일 칸(직접 입력 가능), 월 달력(오늘 테두리,
  선택 파란 원, 기간 음영, 주말·다른 달 흐리게), 오늘/지우기, 앵커를 가리키는
  꼬리. 카드 마감일·카드 하위 업무·업무 팝업 마감일에 적용(브라우저 기본
  date 달력 대체). 카드·하위 업무는 시작일도 함께 저장.
- dueInfo: 어제(빨강)·오늘/내일(초록)·그 밖 mm/dd(요일), 지남 빨강 — 보드
  카드·하위 업무·업무 팝업·리스트·내 업무 표에 적용.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:29:59 +09:00
king de5fd15cf2 feat(project): 담당자 배정은 어디서나 아이콘 + 이름
- showContextMenu 항목에 icon(HTML)·checked(오른쪽 ✓) 지원.
- assigneeMenuItems: 카드·하위 업무 담당자 메뉴를 아바타 + 이름으로(미지정 =
  점선 원 사람 아이콘).
- enhanceAssigneeSelect: 업무 팝업 담당자·하위 업무 담당자·하위 업무 추가의
  <select> 를 아이콘 + 이름 버튼/메뉴로 대체(select 는 숨겨 값 저장소로 유지,
  value setter·옵션 변경을 따라감).
- 규칙 문서화(PROJECT_MODULE.md 3절).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:24:51 +09:00
king d050158492 feat(project): 모든 말풍선을 아사나식 공용 말풍선으로 통일
- 브라우저 기본 title 말풍선도 마우스를 올리는 순간 data-tip 으로 옮겨
  공용 말풍선(.pj-hovertip)으로 표시 → 기존·신규 모든 title= 이 같은 모양.
- 화면 끝 보정(말풍선은 안쪽, 꼬리는 커서 쪽), 위 공간 부족 시 아래로 뒤집기,
  누르기·스크롤 시 숨김, 짧은 페이드인.
- 대시보드 막대 툴팁도 같은 색·꼬리.
- 규칙 문서화(PROJECT_MODULE.md 3절, CLAUDE.md).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:20:37 +09:00
king 067d9c5083 feat(project): 카드 하위 업무 마감일 추가 아이콘
마감일 없는 하위 업무 줄에 마우스를 올리면 점선 원 달력 아이콘 +
'마감일 추가' 말풍선. 누르면 날짜 선택(있는 날짜도 클릭해 변경/지우기).
openDuePicker 에 저장 콜백 인자 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:18:02 +09:00
king 3563822087 feat(project): 카드 하위 업무 담당자 배정 아이콘 + 아사나식 말풍선
담당자 없는 하위 업무 줄에 마우스를 올리면 점선 원 사람 아이콘이 나타나고
'이 작업 배정' 말풍선. 누르면 프로젝트 멤버 목록에서 바로 배정(그 카드
목록만 다시 채움). 공용 hovertip 에 아래쪽 꼬리 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:15:35 +09:00
king 08b5d84c08 feat(project): 카드 하위 업무 펼치기/접기 부드러운 애니메이션
보드를 다시 그리지 않고 그 카드 안에서만 grid-template-rows 0fr↔1fr 전환
(.25s)으로 높이를 늘이고 줄인다. 목록을 먼저 받아 채운 뒤 펼쳐 높이가
두 번 튀지 않게. prefers-reduced-motion 이면 전환 없음.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:11:05 +09:00
king 9d89caf131 style(project): 카드 하위 업무 — 제목이 길어도 마감일 항상 표시
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:08:21 +09:00
king 801c19cee4 fix(project): 카드 하위 업무 펼치기가 토글째 사라지던 버그 + 아사나식 아이콘
GET /api/tasks/{id} 응답은 {task: {subtasks}} 인데 res.subtasks 를 읽어
하위 업무 0개로 판단 → 개수 동기화 로직이 토글을 없앴다. res.task.subtasks 로
수정. 하위 업무 아이콘을 아사나와 같은 모양(노드에서 두 갈래) SVG 로 교체.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:05:19 +09:00
king b2134ed0e4 feat(project): 아사나식 세션 머리(+ / … 메뉴) + 카드 하위 업무 펼치기
- 세션 머리: 이름 바로 오른쪽에 업무 수(숫자만), 오른쪽 끝 +(업무 추가)·…
  메뉴(업무 추가/이름 변경/세션 편집/세션 업무 모두 완료/완료 세션 지정·해제/
  삭제). 기존 ✎·☐·× 버튼 제거, 헤더 우클릭도 같은 메뉴.
- 카드: 하위 업무가 있으면 'N ⤷ ▾' 토글. 누르면 카드 아래로 하위 업무 목록
  (완료 체크·제목·마감·담당자) 펼침. 체크로 바로 완료 토글.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 00:02:11 +09:00
king 9080fc59f3 feat(project): 세션 기본 담당자 선택을 아이콘+이름 카드로
멤버 추가 창과 같은 모양(단일 선택 라디오, 맨 앞 '없음'), 고른 사람 강조.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 23:55:20 +09:00
king 3dbb613092 feat(project): 세션 기본 담당자
세션 편집 창에서 기본 담당자(프로젝트 멤버·owner)를 지정하면, 그 세션에
업무를 만들거나 다른 세션에서 옮겨올 때 담당자가 빈 업무만 자동 배정.
이미 담당자가 있으면 그대로. 보드 세션 머리에 담당자 아바타 표시,
새 업무 팝업은 기본 담당자를 미리 채움. 자동 배정도 일반 배정처럼
알림·팔로워·메일 처리.

DB: project_db_009 (project_stages.default_assignee_email). 미적용이어도
to_jsonb 로 읽어 동작, 지정 시도만 503 안내.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 23:51:38 +09:00
king 11fa0f6519 feat(project): 프로젝트 진입 시 기본 보기는 항상 보드
기억된 뷰(pj_view)는 달력 이전/다음달 이동(?y=&m= 새로고침) 때만 복원.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 22:38:03 +09:00
king b74e5a4a04 fix(holidays): 2026-09-28 추석 대체공휴일 제거
2026 추석 연휴(9/24~26)는 토요일만 겹쳐 대체공휴일 대상 아님
(설·추석은 일요일·다른 공휴일과 겹칠 때만). 프로젝트 달력·쿠팡
출고 달력·휴가 seed 에서 삭제.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:36:43 +09:00
king 86db89a220 feat(project): 좌측 전체 멤버 관리자 전용 + 수신함·내 업무 화면에도 표시
멤버 업무 팝업을 initProject 밖 공용 initMemberTasks 로 분리하고 마크업은
_member_tasks_modal.html 로 빼 세 화면이 include. 프로젝트 화면 밖에선
업무 더블클릭 시 그 업무의 프로젝트 화면(?task=)으로 이동.
/api/all-users 는 @태그 후보에도 쓰여 서버 제한 없이 화면에서만 숨김.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:24:38 +09:00
king f84abffcc7 fix(project): 댓글 채팅 팝업 불러오기 실패 — avatarHtml 스코프 밖 참조
채팅 공용 코드(initCommentsChat)가 프로젝트 화면 init 안에만 있는
avatarHtml 을 불러 ReferenceError. 상위 스코프 chatAvatarHtml 로 교체.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:19:14 +09:00
king ddff4b250d feat(project): 댓글 채팅에 상대방 프로필 아이콘 + 보드 세션 이름 클릭 인라인 변경
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 21:16:43 +09:00
king fabde9ed4f style(project): 업무 팝업 담당자 칸 축소 + 마감일 라벨 뒤 달력 아이콘
- 담당자 칸은 이름 길이만큼만(최대 150px), 남는 폭은 세션 칸이 쓴다.
- 마감일 칸에 "마감일" 라벨을 다시 두고 그 뒤에 달력 아이콘(날짜가 있으면
  아이콘 옆에 "09/25(목)").
- 캐시 버전 20260923f.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:48:24 +09:00
king 1471e0f89e feat(project): 업무 팝업 담당자·세션·우선순위·마감일 한 줄 + 마감일 달력 아이콘
- 네 항목을 한 줄(칸 사이 세로선)로 묶었다. 칸 안 아이콘은 빼고 라벨 글자만,
  담당자·세션 칸이 남는 폭을 나눠 갖는다. "담당자 없음" → "없음".
- 마감일은 달력 아이콘 버튼 하나. 날짜가 있으면 옆에 "09/25(목)", 지났으면
  빨간색. 누르면 showPicker() 로 브라우저 달력(지우기 포함). 실제 값은 숨긴
  #pj-t-due 가 그대로 들고 있어 저장·변경감지 로직은 바뀌지 않는다.
- 패널이 520px 이하면 2×2(담당자|세션 / 우선순위|마감일)로 접힌다.
- 캐시 버전 20260923e.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:42:46 +09:00
king 4c2f4fce6a feat(project): 업무 팝업 세션·우선순위·마감일을 한 줄로
세 항목이 한 줄씩 3행을 차지하던 것을 한 줄(칸 사이 세로선)로 묶었다.
- 첫 칸(세션) 라벨 폭을 위아래 행과 맞춰 아이콘·값이 같은 세로선에 온다.
- 우선순위·마감일 칸은 라벨 글자로 충분해 아이콘을 빼 폭을 아꼈다.
- 패널이 좁으면(560px 이하, container query) 마감일 칸만 다음 줄로
  넘어가고 값 위치는 다른 행과 맞춘다.
- 날짜 입력칸 폭이 .pj-modal-card input[type=date]{width:100%} 에 덮여
  셀 밖으로 넘치던 것을 선택자 강화로 수정.
- 캐시 버전 20260923d.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:37:54 +09:00
king 78b6e8df11 feat(project): 검색·필터·정렬 + 팔로워 + 마감 알림
검색·필터·정렬
- 좌측 사이드바 전체 검색(/api/search): 제목·설명·댓글, 볼 수 있는
  프로젝트의 업무(하위 업무 포함). 설명 HTML 태그에만 걸린 결과는 본문
  텍스트로 재확인해 제거. 어디서 걸렸는지 + 미리보기, 키보드(/ ↑↓ Enter).
- 프로젝트 화면 필터 바: 찾기·상태·담당자·마감·우선순위·정렬. visibleTasks()
  에서 걸러 보드/리스트/달력/타임라인/대시보드 모두 적용, 프로젝트별 기억.
  필터·정렬 중엔 보드 카드 순서 드래그 차단.
- 내 업무 화면에도 찾기·마감·우선순위 필터.

팔로워 · 알림
- task_followers(008): 만든 사람·담당자·댓글 작성자·@태그된 사람 자동 팔로우,
  기존 업무 백필. 업무 팝업에서 추가/빼기/내 팔로우 토글.
- 완료·댓글 인앱 알림 수신자: 프로젝트 멤버 전원 → 담당자 + 팔로워.
  008 미적용이면 예전 방식 폴백.
- 마감 알림(reminders.py, lifespan 에서 데몬 스레드): 영업일(주말·공휴일
  skip) 09시 KST 1회, 다음 영업일까지 마감/오늘 마감/지남(7일 이내).
  수신자 담당자(없으면 팔로워). task_reminders UNIQUE 로 중복 방지, 마감일
  바뀌면 재알림. PROJECT_REMINDER_EMAIL=true 면 요약 메일.
- 008: pg_trgm GIN 인덱스(제목·설명·댓글), 미완료 마감일 부분 인덱스.

버그
- 업무 팝업 담당자 선택지가 프로젝트 멤버뿐이라, 멤버 목록에 없는 담당자
  (프로젝트 owner, 멤버에서 빠진 사람)의 업무를 열고 저장하면 담당자가
  지워지던 문제 수정.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:28:19 +09:00
king b74f92523d perf: 쿠팡·배송·경비·말레이시아·휴가 라우터 async def → def
동기 psycopg/파일 I/O 를 async def 안에서 부르면 쿼리·엑셀 파싱 동안
이벤트 루프가 멈춰 앱 전체(다른 모듈 포함) 요청이 줄줄이 대기했다.
sync def 로 두면 FastAPI 가 스레드풀에서 돌린다.

- await 없는 핸들러 116개는 async 키워드만 제거(AST 로 기계 변환).
- 업로드: await up.read() → up.file.read() (쿠팡 매출/발주 업로드,
  경비 첨부 청크 읽기).
- 말레이시아 폼 핸들러 6개: request.form() 은 async 라 _request_form
  의존성(인증 뒤에 실행)으로 미리 받아 넘기고 본문은 def.
- Google Sheets writer: httplib2 가 스레드 안전하지 않고 같은 날짜
  시트를 동시에 쓰면 섞이므로 RLock 으로 직렬화.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 13:16:24 +09:00
90 changed files with 20655 additions and 1635 deletions
+26 -1
View File
@@ -67,7 +67,7 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
# ─── 프로젝트 관리 모듈 (project_db) — 아사나식 ─── # ─── 프로젝트 관리 모듈 (project_db) — 아사나식 ───
# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음). # 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
# DB/역할/스키마 생성: scripts/sql/project_db_init.sql 참고. # DB/역할/스키마 생성: scripts/sql/project_db_init.sql 참고.
# 진입 권한: 로그인한 회사 직원 전원(별도 권한키 없음). 프로젝트 생성/배정은 관리자만. # 진입 권한: 권한키 project. 프로젝트 생성은 누구나, 멤버 배정은 관리자만, 조회·수정은 멤버만.
# PROJECT_DB_URL=postgresql://project_app:replace-me@postgres-db:5432/project_db # PROJECT_DB_URL=postgresql://project_app:replace-me@postgres-db:5432/project_db
# ─── 메일 알림 (SMTP) — 프로젝트 업무 배정/완료 시 관리자 알림 ─── # ─── 메일 알림 (SMTP) — 프로젝트 업무 배정/완료 시 관리자 알림 ───
@@ -82,6 +82,14 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
# 알림 수신자(쉼표구분). 비워두면 ERP 관리자(admin) 전원에게 발송. # 알림 수신자(쉼표구분). 비워두면 ERP 관리자(admin) 전원에게 발송.
# PROJECT_NOTIFY_EMAIL=king@dbxcorp.co.kr # PROJECT_NOTIFY_EMAIL=king@dbxcorp.co.kr
# ─── 프로젝트 마감 알림 (project_db_008 필요) ───
# 매일 1회(영업일만, 주말·공휴일 skip) 미완료 업무의 D-1/당일/지연 알림을 수신함에 만든다.
# 수신자 = 담당자(없으면 팔로워). 같은 알림은 한 번만(task_reminders 로 중복 방지).
# PROJECT_REMINDERS=true # false 면 끔
# PROJECT_REMINDER_HOUR=9 # 실행 시각(KST, 0~23)
# PROJECT_REMINDER_EMAIL=false # true 면 수신자에게 요약 메일도(SMTP_* 필요)
# PUBLIC_BASE_URL=https://erp.example.com # 메일 속 업무 링크 앞부분
# ─── 카페24 상품 상세페이지 관리 모듈 (cafe24_db) ─── # ─── 카페24 상품 상세페이지 관리 모듈 (cafe24_db) ───
# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음). # 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
# DB/역할/스키마 생성: scripts/sql/cafe24_db_init.sql 참고. # DB/역할/스키마 생성: scripts/sql/cafe24_db_init.sql 참고.
@@ -138,3 +146,20 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
# 읽기 전용 역할 itemcode_ro 를 먼저 생성하고(아래 DSN), 낱개+세트 UNION 검색 SQL 사용: # 읽기 전용 역할 itemcode_ro 를 먼저 생성하고(아래 DSN), 낱개+세트 UNION 검색 SQL 사용:
# ITEMCODE_DB_URL=postgresql://itemcode_ro:replace-me@postgres-db:5432/itemcode_db # ITEMCODE_DB_URL=postgresql://itemcode_ro:replace-me@postgres-db:5432/itemcode_db
# ITEMCODE_SEARCH_SQL=SELECT item_code AS code, name AS name, '낱개' AS type FROM single_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s UNION ALL SELECT item_code AS code, name AS name, '세트' AS type FROM set_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s ORDER BY code ASC LIMIT %(limit)s # ITEMCODE_SEARCH_SQL=SELECT item_code AS code, name AS name, '낱개' AS type FROM single_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s UNION ALL SELECT item_code AS code, name AS name, '세트' AS type FROM set_items WHERE item_code ILIKE %(q)s OR name ILIKE %(q)s ORDER BY code ASC LIMIT %(limit)s
# ─── 실적(쇼핑몰 통합 매출) — app/modules/performance ───
# performance_db 전용. 미설정 시 모듈이 "설정 필요" 안내만 표시.
# 초기화: scripts/sql/performance_db_init.sql (docs/DATABASES.md 참고)
# PERFORMANCE_DB_URL=postgresql://performance_app:replace-me@postgres-db:5432/performance_db
#
# 쇼핑몰 API 인증정보(ID·Key·Secret·Token)는 여기에 넣지 않는다 —
# 실적 → 설정 화면에서 입력하면 아래 마스터 키로 AES-256-GCM 암호화해 DB 에 저장한다.
# 마스터 키는 DB 에 저장되지 않으며, 잃어버리면 저장된 인증정보를 복구할 수 없다(별도 안전 보관).
# 생성: openssl rand -hex 32 (64자 hex, 또는 32바이트 base64)
# APP_ENCRYPTION_KEY=
# APP_ENCRYPTION_KEY_VERSION=1
# 키 교체(rotation) 시: 새 키를 APP_ENCRYPTION_KEY 에, 버전을 올리고(예: 2),
# 예전 키는 APP_ENCRYPTION_KEY_V1= 로 남긴 뒤 설정 화면 [현재 키로 다시 암호화] → 완료 후 V1 삭제.
# APP_ENCRYPTION_KEY_V1=
# [매출 업데이트] 가 가져오는 기간(오늘 포함 최근 N일, 기본 7, 최대 90)
# PERFORMANCE_SYNC_DAYS=7
+4 -2
View File
@@ -35,8 +35,10 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아
- 휴가 관리 (`app/modules/vacation/`, `vacation_db`) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 `vacation`·`vacation_approver` - 휴가 관리 (`app/modules/vacation/`, `vacation_db`) — 월간 달력(구글식 bar)/연차·반차 신청/승인 워크플로/공휴일·연차 설정. 권한키 `vacation`·`vacation_approver`
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia` - 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md` - 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(업로드 → `POST /admin/products/images` → PUT `detail_image`+`image_upload_type=A`), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md` - 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(`POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A` — NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 업무 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 달력(FullCalendar)/타임라인(vis-timeline)/보드/리스트/대시보드 뷰 토글. 좌측 사이드바는 두 화면 공용(`templates/project/_side.html`). 보드는 아사나처럼 세션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 업무(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 업무가 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/업무/단계 CRUD — URL 의 세션·부모 업무가 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md` - 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(32색 — 아사나 16색 + 진한 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 iframe 패널(`/project/p/{pid}?task=&embed=1`, `html.pj-embed`). 상단 바 화면 배율 토글(`html.pj-ui-scale` → `.erp-app` zoom .75, 2880×1620·200%용) — **팝업은 반드시 `document.body` 에 붙인다**(배율 안의 fixed 좌표는 어긋남). 상세는 `docs/PROJECT_MODULE.md`
- 실적 (`app/modules/performance/`, `performance_db`) — 쇼핑몰 통합 매출. 네 영역 분리: ① 수집 `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리) ② 보안 `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py` ③ 계산 `calc.py`(주=월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py` ④ 화면 `dashboard.py`/`router.py`/템플릿. 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다. 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장. 매출 기준일: 결제=결제일, 취소·반품=발생일(`sync.sales_date_for`). 금액은 원 단위 정수. 권한키 `performance`, 설정 화면·API 는 `is_admin`. 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 상세는 `docs/PERFORMANCE_MODULE.md`
상세는 `docs/PROJECT_OVERVIEW.md`. 상세는 `docs/PROJECT_OVERVIEW.md`.
+4 -1
View File
@@ -33,7 +33,10 @@ STORE_SCOPES: tuple[str, ...] = ("mall.read_store", "mall.write_store")
# 실제로 요청하는 scope 묶음. 개발자센터 앱에 등록된 권한과 어긋나면 인증이 # 실제로 요청하는 scope 묶음. 개발자센터 앱에 등록된 권한과 어긋나면 인증이
# 거부되므로, 여기에 추가할 때는 앱 권한도 함께 확인해야 한다. # 거부되므로, 여기에 추가할 때는 앱 권한도 함께 확인해야 한다.
# 쓰지 않는 권한은 요청하지 않는다 — 토큰이 유출돼도 피해 범위를 좁히기 위함. # 쓰지 않는 권한은 요청하지 않는다 — 토큰이 유출돼도 피해 범위를 좁히기 위함.
DEFAULT_SCOPES: tuple[str, ...] = PRODUCT_SCOPES # 주문은 읽기만(실적 모듈의 매출 수집) — 앱에 쓰기 권한이 있어도 요청하지 않는다.
# 이 목록을 바꾸면 카페24 상품관리 → 시스템에서 한 번 다시 연결해야 새 권한이 토큰에 붙는다
# (기존 토큰은 예전 권한 그대로 계속 동작).
DEFAULT_SCOPES: tuple[str, ...] = PRODUCT_SCOPES + ("mall.read_order",)
DEFAULT_API_VERSION = "2026-03-01" DEFAULT_API_VERSION = "2026-03-01"
+42 -3
View File
@@ -346,9 +346,48 @@ def upload_image_bytes(client: Cafe24Client, data: bytes) -> str:
return paths[0] if paths else "" return paths[0] if paths else ""
def set_main_image(client: Cafe24Client, product_no: int, image_path: str) -> dict[str, Any]: def set_main_image(
"""대표이미지 교체 — 목록/작은목록/축소 이미지는 카페24가 리사이징(A 타입).""" client: Cafe24Client,
return update_product(client, product_no, detail_image=image_path, image_upload_type="A") product_no: int,
data: bytes,
*,
content_type: str = "image/jpeg",
shop_no: int = 1,
) -> dict[str, str]:
"""대표이미지 교체 — POST /admin/products/{no}/images (상품 이미지 등록).
body `{"shop_no":1,"request":{"image_upload_type":"A","detail_image":"data:<mime>;base64,…"}}`
→ `{"image":{detail_image, list_image, tiny_image, small_image}}` (새 /web/product/… 경로).
A(대표이미지등록)면 카페24가 상세이미지를 리사이징해 목록/작은목록/축소에도 넣는다.
⚠️ `/admin/products/images`(상세설명 에디터용, /web/upload/NNEditor/…) 로 올린 경로를
`PUT /admin/products/{no}` 의 detail_image 에 넣는 방식은 대표이미지가 바뀌지 않았다
(실물 — "업로드했는데 적용 안 됨"). 대표이미지는 반드시 이 전용 API 로 등록한다.
"""
import base64 # noqa: WPS433
if not data:
return {}
no = int(product_no)
b64 = base64.b64encode(data).decode("ascii")
payload = {
"shop_no": int(shop_no),
"request": {
"image_upload_type": "A",
"detail_image": f"data:{content_type or 'image/jpeg'};base64,{b64}",
},
}
response = client.post(f"/admin/products/{no}/images", json=payload, product_no=no, timeout=UPLOAD_TIMEOUT)
image = response.get("image")
if isinstance(image, list): # 문서는 dict — 목록으로 올 때도 첫 건을 쓴다
image = image[0] if image else {}
if not isinstance(image, dict):
return {}
return {
key: str(image.get(key) or "")
for key in ("detail_image", "list_image", "tiny_image", "small_image")
if image.get(key)
}
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
+19
View File
@@ -22,8 +22,10 @@
from __future__ import annotations from __future__ import annotations
import functools
import json import json
import os import os
import threading
from typing import Any from typing import Any
SCOPES = ["https://www.googleapis.com/auth/spreadsheets"] SCOPES = ["https://www.googleapis.com/auth/spreadsheets"]
@@ -40,6 +42,20 @@ def _hex_color(value: str) -> dict[str, float]:
} }
# 웹 핸들러가 sync def(스레드풀)라 여러 요청이 동시에 이 writer 를 쓸 수 있다.
# googleapiclient 의 HTTP 클라이언트(httplib2)는 스레드 안전하지 않고, 같은 날짜
# 시트를 동시에 지우고/쓰면 내용이 섞이므로 시트 작업은 한 번에 하나씩만 한다.
_LOCK = threading.RLock()
def _serialized(fn: Any) -> Any:
@functools.wraps(fn)
def wrapper(*args: Any, **kwargs: Any) -> Any:
with _LOCK:
return fn(*args, **kwargs)
return wrapper
class GoogleSheetsWriter: class GoogleSheetsWriter:
"""시트 1장을 통째로 다시 쓰는 용도의 얇은 래퍼.""" """시트 1장을 통째로 다시 쓰는 용도의 얇은 래퍼."""
@@ -153,6 +169,7 @@ class GoogleSheetsWriter:
).execute() ).execute()
return int(res["replies"][0]["addSheet"]["properties"]["sheetId"]) return int(res["replies"][0]["addSheet"]["properties"]["sheetId"])
@_serialized
def delete_sheet(self, *, spreadsheet_id: str, title: str) -> dict[str, Any]: def delete_sheet(self, *, spreadsheet_id: str, title: str) -> dict[str, Any]:
"""이름이 정확히 일치하는 시트 1장을 삭제한다. """이름이 정확히 일치하는 시트 1장을 삭제한다.
@@ -190,6 +207,7 @@ class GoogleSheetsWriter:
).execute() ).execute()
return {"ok": True, "action": "deleted", "title": title} return {"ok": True, "action": "deleted", "title": title}
@_serialized
def write_table( def write_table(
self, self,
*, *,
@@ -346,6 +364,7 @@ _writer: GoogleSheetsWriter | None = None
def get_writer() -> GoogleSheetsWriter: def get_writer() -> GoogleSheetsWriter:
"""프로세스 1개당 1회 초기화.""" """프로세스 1개당 1회 초기화."""
global _writer # noqa: PLW0603 global _writer # noqa: PLW0603
with _LOCK:
if _writer is None: if _writer is None:
_writer = GoogleSheetsWriter() _writer = GoogleSheetsWriter()
return _writer return _writer
+38 -1
View File
@@ -1,5 +1,6 @@
import inspect import inspect
import os import os
from contextlib import asynccontextmanager
from pathlib import Path from pathlib import Path
from typing import Any from typing import Any
@@ -23,6 +24,8 @@ from .modules.expense import CategoryStore, build_expense_store
from .modules.expense import router as expense_router from .modules.expense import router as expense_router
from .modules.malaysia import build_malaysia_itemcode, build_malaysia_store from .modules.malaysia import build_malaysia_itemcode, build_malaysia_store
from .modules.malaysia import router as malaysia_router from .modules.malaysia import router as malaysia_router
from .modules.performance import build_performance_store
from .modules.performance import router as performance_router
from .modules.project import build_project_store from .modules.project import build_project_store
from .modules.project import router as project_router from .modules.project import router as project_router
from .modules.vacation import build_vacation_store from .modules.vacation import build_vacation_store
@@ -48,6 +51,7 @@ MODULE_LABELS: dict[str, str] = {
"dispatch": "말레이시아 배송", "dispatch": "말레이시아 배송",
"project": "프로젝트 관리", "project": "프로젝트 관리",
"cafe24": "카페24 상품관리", "cafe24": "카페24 상품관리",
"performance": "실적",
"expense_approver": "개인경비", "expense_approver": "개인경비",
"vacation_approver": "휴가", "vacation_approver": "휴가",
} }
@@ -102,7 +106,18 @@ def build_google_oauth() -> OAuth:
return oauth return oauth
app = FastAPI(title="DBX 메인 페이지") @asynccontextmanager
async def _lifespan(app_: FastAPI): # noqa: ANN201
"""앱 시작 시 백그라운드 작업 시작.
- 프로젝트 업무 마감 알림(매일 1회, 기본 09시 KST) 스레드.
PROJECT_REMINDERS=false 면 안 돈다. 상세는 app/modules/project/reminders.py."""
from .modules.project.reminders import start_reminder_thread # noqa: WPS433
start_reminder_thread(getattr(app_.state, "project_store", None))
yield
app = FastAPI(title="DBX 메인 페이지", lifespan=_lifespan)
app.add_middleware( app.add_middleware(
SessionMiddleware, SessionMiddleware,
secret_key=_require_session_secret(), secret_key=_require_session_secret(),
@@ -124,6 +139,7 @@ _MODULE_TEMPLATE_DIRS = [
BASE_DIR / "modules" / "dispatch" / "templates", BASE_DIR / "modules" / "dispatch" / "templates",
BASE_DIR / "modules" / "project" / "templates", BASE_DIR / "modules" / "project" / "templates",
BASE_DIR / "modules" / "cafe24" / "templates", BASE_DIR / "modules" / "cafe24" / "templates",
BASE_DIR / "modules" / "performance" / "templates",
] ]
templates = Jinja2Templates(directory=str(BASE_DIR / "templates")) templates = Jinja2Templates(directory=str(BASE_DIR / "templates"))
templates.env.loader = ChoiceLoader( templates.env.loader = ChoiceLoader(
@@ -145,6 +161,12 @@ from .modules.dispatch.store import ( # noqa: E402
templates.env.filters["courier_logo"] = _courier_logo_url templates.env.filters["courier_logo"] = _courier_logo_url
templates.env.filters["courier_track"] = _courier_tracking_url templates.env.filters["courier_track"] = _courier_tracking_url
# 프로젝트 관리 날짜 팝업(일=빨강·토=파랑·공휴일=빨강)용 대한민국 공휴일 표 —
# 프로젝트 화면들이 공용 사이드바(_side.html)에서 window.PJ_HOLIDAYS 로 넘긴다.
from .modules.project.store import KR_HOLIDAYS as _PJ_KR_HOLIDAYS # noqa: E402
templates.env.globals["pj_kr_holidays"] = _PJ_KR_HOLIDAYS
oauth = build_google_oauth() oauth = build_google_oauth()
user_store = UserStore(DATA_DIR / "users.json") user_store = UserStore(DATA_DIR / "users.json")
@@ -177,6 +199,9 @@ app.state.project_store = build_project_store(dsn=env("PROJECT_DB_URL") or None)
# 카페24 상품관리: CAFE24_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내). # 카페24 상품관리: CAFE24_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
# 카페24 API 호출/토큰은 app/integrations/cafe24 공통 계층(CAFE24_* 환경변수). # 카페24 API 호출/토큰은 app/integrations/cafe24 공통 계층(CAFE24_* 환경변수).
app.state.cafe24_store = build_cafe24_store(dsn=env("CAFE24_DB_URL") or None) app.state.cafe24_store = build_cafe24_store(dsn=env("CAFE24_DB_URL") or None)
# 실적(쇼핑몰 통합 매출): PERFORMANCE_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
# 쇼핑몰 API 인증정보는 설정 화면에서 입력 → APP_ENCRYPTION_KEY 로 암호화해 performance_db 에 저장.
app.state.performance_store = build_performance_store(dsn=env("PERFORMANCE_DB_URL") or None)
# 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄. # 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄.
app.include_router(expense_router) app.include_router(expense_router)
@@ -186,6 +211,7 @@ app.include_router(malaysia_router)
app.include_router(dispatch_router) app.include_router(dispatch_router)
app.include_router(project_router) app.include_router(project_router)
app.include_router(cafe24_router) app.include_router(cafe24_router)
app.include_router(performance_router)
def public_url_for(request: Request, route_name: str) -> str: def public_url_for(request: Request, route_name: str) -> str:
@@ -368,6 +394,16 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
"status": "ready", "status": "ready",
"category": "운영", "category": "운영",
}, },
{
"key": "performance",
"title": "실적",
"subtitle": "Sales Performance",
"description": "여러 쇼핑몰의 매출을 일자·쇼핑몰별로 한 화면에서 보고 수수료 차감 매출을 계산합니다.",
"url": "/performance/",
"health_url": "/performance/health",
"status": "ready",
"category": "관리",
},
] ]
allowed = allowed_modules(user_rec) allowed = allowed_modules(user_rec)
for item in items: for item in items:
@@ -388,6 +424,7 @@ def _icon_svg(name: str) -> str:
"dispatch": '<rect x="1" y="3" width="15" height="13"/><path d="M16 8h4l3 3v5h-7V8z"/><circle cx="5.5" cy="18.5" r="2.5"/><circle cx="18.5" cy="18.5" r="2.5"/>', "dispatch": '<rect x="1" y="3" width="15" height="13"/><path d="M16 8h4l3 3v5h-7V8z"/><circle cx="5.5" cy="18.5" r="2.5"/><circle cx="18.5" cy="18.5" r="2.5"/>',
"project": '<rect x="3" y="4" width="18" height="16" rx="2"/><line x1="3" y1="9" x2="21" y2="9"/><line x1="8" y1="13" x2="13" y2="13"/><line x1="8" y1="16" x2="11" y2="16"/>', "project": '<rect x="3" y="4" width="18" height="16" rx="2"/><line x1="3" y1="9" x2="21" y2="9"/><line x1="8" y1="13" x2="13" y2="13"/><line x1="8" y1="16" x2="11" y2="16"/>',
"cafe24": '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9h10"/><path d="M7 13h7"/><path d="M7 17h4"/>', "cafe24": '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M7 9h10"/><path d="M7 13h7"/><path d="M7 17h4"/>',
"performance": '<path d="M3 3v18h18"/><rect x="7" y="12" width="3" height="6"/><rect x="12" y="8" width="3" height="10"/><rect x="17" y="5" width="3" height="13"/>',
"modules": '<rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/>', "modules": '<rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/>',
} }
body = paths.get(name, paths["modules"]) body = paths.get(name, paths["modules"])
+20 -13
View File
@@ -29,6 +29,7 @@ from typing import Any
from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
from app.timezone import now_kst
from . import store from . import store
from .common import read_lag_grace_minutes, require_store from .common import read_lag_grace_minutes, require_store
@@ -155,10 +156,13 @@ def product_image(
product_no: int, product_no: int,
file: UploadFile = File(...), file: UploadFile = File(...),
) -> dict[str, Any]: ) -> dict[str, Any]:
"""대표 이미지 교체. 업로드(/products/images) → PUT detail_image(A 타입). """대표 이미지 교체 — POST /products/{no}/images (A 타입, base64 직접 등록).
A(대표이미지등록) 타입이면 목록/작은목록/축소 이미지는 카페24가 리사이징한다. A(대표이미지등록) 타입이면 목록/작은목록/축소 이미지는 카페24가 리사이징한다.
이전 이미지 경로는 감사로그에 남긴다(되돌리려면 그 경로를 다시 넣는다). 응답의 새 경로 4개로 화면을 그리고 스냅샷에 남긴다(GET 은 한동안 예전 이미지).
이 응답엔 updated_date 가 없어 스냅샷 시각은 지금으로 둔다 — 그보다 이전 레코드를
돌려주는 GET 은 지연으로 보고 새 이미지를 덮어씌운다(store.overlay_recent_write).
이전 이미지 경로는 감사로그에 남긴다.
""" """
st, user = require_store(request) st, user = require_store(request)
actor = str(user.get("email") or "") actor = str(user.get("email") or "")
@@ -169,25 +173,26 @@ def product_image(
current, _ = load_product(st, api, product_no) current, _ = load_product(st, api, product_no)
except Cafe24Error as exc: except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc raise _http_from_cafe24(exc) from exc
if not current:
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
before = str(current.get("detail_image") or "") before = str(current.get("detail_image") or "")
try: try:
path = products.upload_image_bytes(api.client, data) images = products.set_main_image(
if not path: api.client, product_no, data, content_type=(file.content_type or "").lower()
raise Cafe24Error("카페24가 업로드 경로를 돌려주지 않았습니다.") )
updated = products.set_main_image(api.client, product_no, path) if not images.get("detail_image"):
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
except Cafe24Error as exc: except Cafe24Error as exc:
st.log_audit(actor=actor, action="set_main_image", product_no=product_no, st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
result="FAIL", detail=f"업로드/적용 실패: {exc}") result="FAIL", detail=f"등록 실패: {exc}")
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc) logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc raise _http_from_cafe24(exc) from exc
remember_write(st, product_no, updated if isinstance(updated, dict) else {}) merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
merged = {**current, **(updated if isinstance(updated, dict) else {})} remember_write(st, product_no, merged)
if not merged.get("detail_image"):
merged["detail_image"] = path
st.log_audit(actor=actor, action="set_main_image", product_no=product_no, st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
result="SUCCESS", detail=f"'{before}' → '{merged.get('detail_image')}' (업로드 {path})") result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor) logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor)
return {"ok": True, "product": _scalar_view(merged)} return {"ok": True, "product": _scalar_view(merged)}
@@ -294,8 +299,10 @@ def options_get(request: Request, product_no: int) -> dict[str, Any]:
loaded = _load_options_and_variants(st, api, product_no) loaded = _load_options_and_variants(st, api, product_no)
except Cafe24Error as exc: except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc raise _http_from_cafe24(exc) from exc
# image_base: 카페24가 "/web/product/…" 상대경로로 준 썸네일을 화면이 쇼핑몰 주소에
# 붙여 그리기 위한 값(그대로 src 에 넣으면 우리 도메인에서 찾다가 깨진다).
return {"ok": True, "option": loaded["option"], "variants": loaded["variants"], return {"ok": True, "option": loaded["option"], "variants": loaded["variants"],
"display_types": store.OPTION_DISPLAY_LABELS} "display_types": store.OPTION_DISPLAY_LABELS, "image_base": api.config.shop_base}
@product_info_router.post("/products/{product_no}/options") @product_info_router.post("/products/{product_no}/options")
@@ -125,7 +125,7 @@
{% endblock %} {% endblock %}
{% block scripts %} {% block scripts %}
<script src="/static/cafe24-options.js?v=20260919b"></script> <script src="/static/cafe24-options.js?v=20260928c"></script>
<script> <script>
(function () { (function () {
var pane = document.getElementById("cf24-editor-pane"); var pane = document.getElementById("cf24-editor-pane");
+28
View File
@@ -1193,6 +1193,34 @@ def test_upload_images_and_variants_wrappers():
assert client.calls[-1][0] == "DELETE" assert client.calls[-1][0] == "DELETE"
def test_set_main_image_uses_product_images_endpoint():
"""대표이미지는 POST /products/{no}/images 에 data URI 로 A 타입 등록 — 새 경로 4개를 돌려준다."""
client = _RouteClient({
"POST /admin/products/13/images": {"image": {
"shop_no": 1, "product_no": 13,
"detail_image": "https://d/web/product/big/x.png",
"list_image": "https://d/web/product/medium/x.png",
"tiny_image": "https://d/web/product/tiny/x.png",
"small_image": "https://d/web/product/small/x.png",
}},
})
out = products.set_main_image(client, 13, b"\x89PNG", content_type="image/png")
assert out == {
"detail_image": "https://d/web/product/big/x.png",
"list_image": "https://d/web/product/medium/x.png",
"tiny_image": "https://d/web/product/tiny/x.png",
"small_image": "https://d/web/product/small/x.png",
}
method, path, body = client.calls[-1]
assert (method, path) == ("POST", "/admin/products/13/images")
assert body["shop_no"] == 1
assert body["request"]["image_upload_type"] == "A"
assert body["request"]["detail_image"].startswith("data:image/png;base64,")
# 상품 PUT(detail_image 경로 넣기)은 더 이상 쓰지 않는다
assert not [c for c in client.calls if c[0] == "PUT"]
assert products.set_main_image(client, 13, b"") == {}
def _run_all(): def _run_all():
fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)] fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
for fn in fns: for fn in fns:
+1 -2
View File
@@ -52,8 +52,7 @@ _LUNAR_AND_SUBSTITUTE: dict[int, dict[str, str]] = {
"2026-08-17": SUBSTITUTE, # 광복절(8/15 토) "2026-08-17": SUBSTITUTE, # 광복절(8/15 토)
"2026-09-24": "추석 연휴", "2026-09-24": "추석 연휴",
"2026-09-25": "추석", "2026-09-25": "추석",
"2026-09-26": "추석 연휴", "2026-09-26": "추석 연휴", # 토요일만 겹침 → 대체 없음(설·추석은 일요일/공휴일 겹칠 때만)
"2026-09-28": SUBSTITUTE,
"2026-10-05": SUBSTITUTE, # 개천절(10/3 토) "2026-10-05": SUBSTITUTE, # 개천절(10/3 토)
}, },
2027: { 2027: {
+36 -36
View File
@@ -107,7 +107,7 @@ def _ym(request: Request) -> tuple[int, int]:
# 메인 — 월간 달력 + 선택일 출고 리스트 # 메인 — 월간 달력 + 선택일 출고 리스트
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/", response_class=HTMLResponse) @router.get("/", response_class=HTMLResponse)
async def index(request: Request) -> HTMLResponse: def index(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -332,7 +332,7 @@ def _push_to_google_sheet(store: Any, ship_date: str) -> dict[str, Any]:
@router.get("/export.xlsx") @router.get("/export.xlsx")
async def export_shipments_xlsx(request: Request, date: str = "") -> Any: def export_shipments_xlsx(request: Request, date: str = "") -> Any:
"""출고일 기준 출고리스트 엑셀 다운로드. 시트명 = YYYYMMDD.""" """출고일 기준 출고리스트 엑셀 다운로드. 시트명 = YYYYMMDD."""
from io import BytesIO # noqa: WPS433 from io import BytesIO # noqa: WPS433
@@ -371,7 +371,7 @@ async def export_shipments_xlsx(request: Request, date: str = "") -> Any:
# 출고 묶음 — 등록 / 수정 / 상세 # 출고 묶음 — 등록 / 수정 / 상세
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/new") @router.get("/new")
async def new_form(request: Request) -> RedirectResponse: def new_form(request: Request) -> RedirectResponse:
"""신규 등록 폼은 없앴다. 출고 묶음은 상자 계산의 [분배 확정] 으로만 만든다. """신규 등록 폼은 없앴다. 출고 묶음은 상자 계산의 [분배 확정] 으로만 만든다.
예전 링크/북마크가 404 나지 않도록 상자 계산으로 보낸다. 예전 링크/북마크가 404 나지 않도록 상자 계산으로 보낸다.
@@ -380,7 +380,7 @@ async def new_form(request: Request) -> RedirectResponse:
@router.get("/{shipment_id:int}", response_class=HTMLResponse) @router.get("/{shipment_id:int}", response_class=HTMLResponse)
async def detail(request: Request, shipment_id: int) -> HTMLResponse: def detail(request: Request, shipment_id: int) -> HTMLResponse:
"""출고 묶음 보기 — 상자 계산 화면과 같은 3열 구성(읽기 전용). """출고 묶음 보기 — 상자 계산 화면과 같은 3열 구성(읽기 전용).
수정 기능은 없앴다. 잘못 만들었으면 달력에서 삭제하고 다시 확정한다. 수정 기능은 없앴다. 잘못 만들었으면 달력에서 삭제하고 다시 확정한다.
@@ -431,7 +431,7 @@ async def detail(request: Request, shipment_id: int) -> HTMLResponse:
@router.get("/{shipment_id:int}/boxes.xlsx") @router.get("/{shipment_id:int}/boxes.xlsx")
async def export_box_list_xlsx(request: Request, shipment_id: int) -> Any: def export_box_list_xlsx(request: Request, shipment_id: int) -> Any:
"""상자 목록(상자번호·제품명·제품코드·수량) 엑셀 다운로드.""" """상자 목록(상자번호·제품명·제품코드·수량) 엑셀 다운로드."""
from io import BytesIO # noqa: WPS433 from io import BytesIO # noqa: WPS433
@@ -480,7 +480,7 @@ def _safe_next(raw: str, fallback: str) -> str:
@router.post("/{shipment_id:int}/delete") @router.post("/{shipment_id:int}/delete")
async def delete( def delete(
request: Request, request: Request,
shipment_id: int, shipment_id: int,
next: str = Form(""), next: str = Form(""),
@@ -505,7 +505,7 @@ async def delete(
@router.post("/{shipment_id:int}/hard-delete") @router.post("/{shipment_id:int}/hard-delete")
async def hard_delete( def hard_delete(
request: Request, request: Request,
shipment_id: int, shipment_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -526,7 +526,7 @@ async def hard_delete(
@router.post("/day-delete") @router.post("/day-delete")
async def day_delete( def day_delete(
request: Request, request: Request,
date: str = Form(...), date: str = Form(...),
next: str = Form(""), next: str = Form(""),
@@ -595,7 +595,7 @@ def _sales_filters(request: Request) -> dict[str, str]:
@router.get("/sales", response_class=HTMLResponse) @router.get("/sales", response_class=HTMLResponse)
async def sales_page(request: Request) -> HTMLResponse: def sales_page(request: Request) -> HTMLResponse:
"""매출 표 — 기간·센터·발주유형·검색어로 조회, 합계 표시.""" """매출 표 — 기간·센터·발주유형·검색어로 조회, 합계 표시."""
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -661,7 +661,7 @@ async def sales_page(request: Request) -> HTMLResponse:
@router.post("/sales/api") @router.post("/sales/api")
async def sales_create( def sales_create(
request: Request, request: Request,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -677,7 +677,7 @@ async def sales_create(
@router.post("/sales/api/{sale_id:int}") @router.post("/sales/api/{sale_id:int}")
async def sales_update( def sales_update(
request: Request, request: Request,
sale_id: int, sale_id: int,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
@@ -696,7 +696,7 @@ async def sales_update(
@router.post("/sales/api/{sale_id:int}/delete") @router.post("/sales/api/{sale_id:int}/delete")
async def sales_delete( def sales_delete(
request: Request, request: Request,
sale_id: int, sale_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -712,7 +712,7 @@ async def sales_delete(
@router.post("/sales/upload") @router.post("/sales/upload")
async def sales_upload( def sales_upload(
request: Request, request: Request,
files: list[UploadFile] = File(...), files: list[UploadFile] = File(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -728,7 +728,7 @@ async def sales_upload(
weekly_saved = 0 weekly_saved = 0
names: list[str] = [] names: list[str] = []
for up in files: for up in files:
data = await up.read() data = up.file.read() # sync def(스레드풀) — 동기 읽기
if not data: if not data:
continue continue
try: try:
@@ -757,7 +757,7 @@ async def sales_upload(
@router.get("/sales/export.xlsx") @router.get("/sales/export.xlsx")
async def sales_export_xlsx(request: Request) -> Any: def sales_export_xlsx(request: Request) -> Any:
"""현재 조회 조건 그대로 엑셀 다운로드.""" """현재 조회 조건 그대로 엑셀 다운로드."""
from io import BytesIO # noqa: WPS433 from io import BytesIO # noqa: WPS433
@@ -788,7 +788,7 @@ async def sales_export_xlsx(request: Request) -> Any:
# 상자 입수량 관리 # 상자 입수량 관리
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/box-rules", response_class=HTMLResponse) @router.get("/box-rules", response_class=HTMLResponse)
async def box_rules_page(request: Request) -> HTMLResponse: def box_rules_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -813,7 +813,7 @@ async def box_rules_page(request: Request) -> HTMLResponse:
@router.post("/box-rules") @router.post("/box-rules")
async def box_rule_upsert( def box_rule_upsert(
request: Request, request: Request,
product_code: str = Form(...), product_code: str = Form(...),
units_per_box: int = Form(...), units_per_box: int = Form(...),
@@ -839,7 +839,7 @@ async def box_rule_upsert(
@router.post("/box-rules/{rule_id}/delete") @router.post("/box-rules/{rule_id}/delete")
async def box_rule_delete( def box_rule_delete(
request: Request, request: Request,
rule_id: int, rule_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -859,7 +859,7 @@ async def box_rule_delete(
# 저장하지 않는 계산 전용 화면. 규칙은 cupang_box_rules 를 그대로 사용한다. # 저장하지 않는 계산 전용 화면. 규칙은 cupang_box_rules 를 그대로 사용한다.
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/box-calc", response_class=HTMLResponse) @router.get("/box-calc", response_class=HTMLResponse)
async def box_calc_page(request: Request) -> HTMLResponse: def box_calc_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -934,7 +934,7 @@ def _parse_po_sheet(ws: Any) -> dict[str, Any]:
@router.post("/api/box-calc/upload") @router.post("/api/box-calc/upload")
async def box_calc_upload( def box_calc_upload(
request: Request, request: Request,
files: list[UploadFile] = File(...), files: list[UploadFile] = File(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -977,7 +977,7 @@ async def box_calc_upload(
no_rule: set[str] = set() no_rule: set[str] = set()
for up in files: for up in files:
raw = await up.read() raw = up.file.read() # sync def(스레드풀) — 동기 읽기
name = up.filename or "(이름 없음)" name = up.filename or "(이름 없음)"
try: try:
wb = load_workbook(BytesIO(raw), data_only=True) wb = load_workbook(BytesIO(raw), data_only=True)
@@ -1105,7 +1105,7 @@ async def box_calc_upload(
@router.post("/api/box-calc") @router.post("/api/box-calc")
async def box_calc_api( def box_calc_api(
request: Request, request: Request,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1329,7 +1329,7 @@ def _pack_leftovers(results: list[dict[str, Any]]) -> list[dict[str, Any]]:
# 설정 — 제품명 카탈로그 관리 (itemcode_db 에서 등록) # 설정 — 제품명 카탈로그 관리 (itemcode_db 에서 등록)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/products", response_class=HTMLResponse) @router.get("/products", response_class=HTMLResponse)
async def products_page(request: Request) -> HTMLResponse: def products_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -1356,7 +1356,7 @@ async def products_page(request: Request) -> HTMLResponse:
@router.get("/api/products/all") @router.get("/api/products/all")
async def product_all( def product_all(
request: Request, _: dict[str, Any] = Depends(_require_user) request: Request, _: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
"""itemcode_db 전체 상품 목록(낱개+세트). 설정 화면 왼쪽 리스트 소스.""" """itemcode_db 전체 상품 목록(낱개+세트). 설정 화면 왼쪽 리스트 소스."""
@@ -1374,7 +1374,7 @@ async def product_all(
@router.post("/products/bulk") @router.post("/products/bulk")
async def product_bulk( def product_bulk(
request: Request, request: Request,
items: list[dict[str, Any]] = Body(..., embed=True), items: list[dict[str, Any]] = Body(..., embed=True),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1407,7 +1407,7 @@ async def product_bulk(
@router.post("/products") @router.post("/products")
async def product_upsert( def product_upsert(
request: Request, request: Request,
product_code: str = Form(...), product_code: str = Form(...),
product_name: str = Form(...), product_name: str = Form(...),
@@ -1432,7 +1432,7 @@ async def product_upsert(
@router.post("/products/{product_id:int}/active") @router.post("/products/{product_id:int}/active")
async def product_set_active( def product_set_active(
request: Request, request: Request,
product_id: int, product_id: int,
active: str = Form(...), active: str = Form(...),
@@ -1451,7 +1451,7 @@ async def product_set_active(
@router.post("/api/products/{product_id:int}/edit") @router.post("/api/products/{product_id:int}/edit")
async def product_edit( def product_edit(
request: Request, request: Request,
product_id: int, product_id: int,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
@@ -1476,7 +1476,7 @@ async def product_edit(
@router.post("/api/products/{product_id:int}/toggle") @router.post("/api/products/{product_id:int}/toggle")
async def product_toggle_active( def product_toggle_active(
request: Request, request: Request,
product_id: int, product_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1493,7 +1493,7 @@ async def product_toggle_active(
@router.post("/products/{product_id:int}/delete") @router.post("/products/{product_id:int}/delete")
async def product_delete( def product_delete(
request: Request, request: Request,
product_id: int, product_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1566,7 +1566,7 @@ def _clean_box_plan(raw: Any) -> list[dict[str, Any]]:
@router.post("/api/box-calc/confirm") @router.post("/api/box-calc/confirm")
async def box_calc_confirm( def box_calc_confirm(
request: Request, request: Request,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1705,7 +1705,7 @@ async def box_calc_confirm(
# 상자 계산 임시 저장 (화면 상태 스냅샷) # 상자 계산 임시 저장 (화면 상태 스냅샷)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/api/box-calc/drafts") @router.get("/api/box-calc/drafts")
async def box_calc_drafts_list( def box_calc_drafts_list(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
) -> JSONResponse: ) -> JSONResponse:
@@ -1716,7 +1716,7 @@ async def box_calc_drafts_list(
@router.get("/api/box-calc/drafts/{draft_id:int}") @router.get("/api/box-calc/drafts/{draft_id:int}")
async def box_calc_draft_get( def box_calc_draft_get(
request: Request, request: Request,
draft_id: int, draft_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1731,7 +1731,7 @@ async def box_calc_draft_get(
@router.post("/api/box-calc/drafts") @router.post("/api/box-calc/drafts")
async def box_calc_draft_save( def box_calc_draft_save(
request: Request, request: Request,
payload: dict[str, Any] = Body(...), payload: dict[str, Any] = Body(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1768,7 +1768,7 @@ async def box_calc_draft_save(
@router.delete("/api/box-calc/drafts/{draft_id:int}") @router.delete("/api/box-calc/drafts/{draft_id:int}")
async def box_calc_draft_delete( def box_calc_draft_delete(
request: Request, request: Request,
draft_id: int, draft_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1784,5 +1784,5 @@ async def box_calc_draft_delete(
@router.get("/health") @router.get("/health")
async def health() -> dict[str, str]: def health() -> dict[str, str]:
return {"status": "ok", "module": "cupang"} return {"status": "ok", "module": "cupang"}
+15 -15
View File
@@ -193,7 +193,7 @@ def _save_upload(upload: UploadFile | None, *, dest_dir: Path, slot: tuple) -> s
# 배치 목록 (메인) # 배치 목록 (메인)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/", response_class=HTMLResponse) @router.get("/", response_class=HTMLResponse)
async def batches_index(request: Request) -> HTMLResponse: def batches_index(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -216,7 +216,7 @@ async def batches_index(request: Request) -> HTMLResponse:
@router.get("/batches/new", response_class=HTMLResponse) @router.get("/batches/new", response_class=HTMLResponse)
async def batch_new(request: Request) -> HTMLResponse: def batch_new(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -237,7 +237,7 @@ async def batch_new(request: Request) -> HTMLResponse:
@router.post("/batches") @router.post("/batches")
async def batch_create( def batch_create(
request: Request, request: Request,
dispatch_date: str = Form(...), dispatch_date: str = Form(...),
platform: str = Form("TikTok"), platform: str = Form("TikTok"),
@@ -321,7 +321,7 @@ async def batch_create(
@router.post("/batches/{batch_id:int}/delete") @router.post("/batches/{batch_id:int}/delete")
async def batch_delete( def batch_delete(
request: Request, batch_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, batch_id: int, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
"""배치 삭제 — 슈퍼 관리자 전용(박스/상품/로그 CASCADE).""" """배치 삭제 — 슈퍼 관리자 전용(박스/상품/로그 CASCADE)."""
@@ -338,7 +338,7 @@ async def batch_delete(
@router.get("/batches/{batch_id:int}/download") @router.get("/batches/{batch_id:int}/download")
async def batch_download( def batch_download(
request: Request, batch_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, batch_id: int, user: dict[str, Any] = Depends(_require_user)
) -> Response: ) -> Response:
"""배치 다운로드: 업로드 원본(라벨 PDF + 데이터 엑셀) + 취합 출고 엑셀을 zip 으로 묶음.""" """배치 다운로드: 업로드 원본(라벨 PDF + 데이터 엑셀) + 취합 출고 엑셀을 zip 으로 묶음."""
@@ -406,7 +406,7 @@ async def batch_download(
@router.get("/stock-export") @router.get("/stock-export")
async def stock_export( def stock_export(
request: Request, date: str, user: dict[str, Any] = Depends(_require_user) request: Request, date: str, user: dict[str, Any] = Depends(_require_user)
) -> Response: ) -> Response:
"""선택한 날짜의 전 배치 출고 수량을 낱개로 분해해 사방넷 재고 업로드 xlsx 다운로드. """선택한 날짜의 전 배치 출고 수량을 낱개로 분해해 사방넷 재고 업로드 xlsx 다운로드.
@@ -478,7 +478,7 @@ async def stock_export(
@router.post("/stock-deduct") @router.post("/stock-deduct")
async def stock_deduct( def stock_deduct(
request: Request, request: Request,
date: str = Form(...), date: str = Form(...),
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -599,7 +599,7 @@ async def stock_deduct(
# 출고 작업 리스트 (1박스 = 1카드) # 출고 작업 리스트 (1박스 = 1카드)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/batches/{batch_id:int}", response_class=HTMLResponse) @router.get("/batches/{batch_id:int}", response_class=HTMLResponse)
async def batch_detail(request: Request, batch_id: int) -> HTMLResponse: def batch_detail(request: Request, batch_id: int) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -631,7 +631,7 @@ async def batch_detail(request: Request, batch_id: int) -> HTMLResponse:
@router.get("/batches/{batch_id:int}/picking", response_class=HTMLResponse) @router.get("/batches/{batch_id:int}/picking", response_class=HTMLResponse)
async def batch_picking(request: Request, batch_id: int) -> HTMLResponse: def batch_picking(request: Request, batch_id: int) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -662,7 +662,7 @@ async def batch_picking(request: Request, batch_id: int) -> HTMLResponse:
@router.get("/batches/{batch_id:int}/handover", response_class=HTMLResponse) @router.get("/batches/{batch_id:int}/handover", response_class=HTMLResponse)
async def batch_handover(request: Request, batch_id: int) -> HTMLResponse: def batch_handover(request: Request, batch_id: int) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -695,7 +695,7 @@ async def batch_handover(request: Request, batch_id: int) -> HTMLResponse:
# 상태 토글 (AJAX) + JSON API # 상태 토글 (AJAX) + JSON API
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.post("/parcels/{parcel_id:int}/toggle") @router.post("/parcels/{parcel_id:int}/toggle")
async def parcel_toggle( def parcel_toggle(
request: Request, request: Request,
parcel_id: int, parcel_id: int,
field: str = Form(...), field: str = Form(...),
@@ -717,7 +717,7 @@ async def parcel_toggle(
@router.post("/batches/{batch_id:int}/bulk") @router.post("/batches/{batch_id:int}/bulk")
async def parcels_bulk( def parcels_bulk(
request: Request, request: Request,
batch_id: int, batch_id: int,
field: str = Form(...), field: str = Form(...),
@@ -739,7 +739,7 @@ async def parcels_bulk(
@router.get("/api/batches/{batch_id:int}/parcels") @router.get("/api/batches/{batch_id:int}/parcels")
async def api_parcels( def api_parcels(
request: Request, batch_id: int, _: dict[str, Any] = Depends(_require_user) request: Request, batch_id: int, _: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
st = _store(request) st = _store(request)
@@ -749,7 +749,7 @@ async def api_parcels(
@router.get("/api/search") @router.get("/api/search")
async def api_search( def api_search(
request: Request, q: str = "", _: dict[str, Any] = Depends(_require_user) request: Request, q: str = "", _: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
"""주문번호/패키지번호/송장번호(부분 일치)로 박스 검색 → 받는 사람/배치 반환.""" """주문번호/패키지번호/송장번호(부분 일치)로 박스 검색 → 받는 사람/배치 반환."""
@@ -769,5 +769,5 @@ async def api_search(
@router.get("/health") @router.get("/health")
async def health() -> dict[str, str]: def health() -> dict[str, str]:
return {"status": "ok", "module": "dispatch"} return {"status": "ok", "module": "dispatch"}
+27 -27
View File
@@ -259,7 +259,7 @@ class CategoryBody(BaseModel):
# 페이지 # 페이지
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.get("/", response_class=HTMLResponse) @router.get("/", response_class=HTMLResponse)
async def expense_index(request: Request) -> HTMLResponse: def expense_index(request: Request) -> HTMLResponse:
from app.main import ( # noqa: WPS433 from app.main import ( # noqa: WPS433
build_erp_nav, build_erp_nav,
get_current_user_record, get_current_user_record,
@@ -318,7 +318,7 @@ async def expense_index(request: Request) -> HTMLResponse:
@router.get("/pending", response_class=HTMLResponse) @router.get("/pending", response_class=HTMLResponse)
async def pending_page(request: Request) -> HTMLResponse: def pending_page(request: Request) -> HTMLResponse:
"""승인자 대기열 — 제출 상태 항목 전체.""" """승인자 대기열 — 제출 상태 항목 전체."""
from app.main import ( # noqa: WPS433 from app.main import ( # noqa: WPS433
build_erp_nav, build_erp_nav,
@@ -355,7 +355,7 @@ async def pending_page(request: Request) -> HTMLResponse:
@router.get("/reports", response_class=HTMLResponse) @router.get("/reports", response_class=HTMLResponse)
async def reports_page(request: Request) -> HTMLResponse: def reports_page(request: Request) -> HTMLResponse:
"""월별/카테고리별 집계.""" """월별/카테고리별 집계."""
from app.main import ( # noqa: WPS433 from app.main import ( # noqa: WPS433
build_erp_nav, build_erp_nav,
@@ -429,7 +429,7 @@ def _approved_aggregate(
@router.get("/approved", response_class=HTMLResponse) @router.get("/approved", response_class=HTMLResponse)
async def approved_page(request: Request) -> HTMLResponse: def approved_page(request: Request) -> HTMLResponse:
"""전 직원 승인완료 항목 — 월별 + 직원별 합계.""" """전 직원 승인완료 항목 — 월별 + 직원별 합계."""
from app.main import ( # noqa: WPS433 from app.main import ( # noqa: WPS433
build_erp_nav, build_erp_nav,
@@ -569,7 +569,7 @@ def _build_approved_xlsx(
@router.get("/api/approved/export.xlsx") @router.get("/api/approved/export.xlsx")
async def approved_export( def approved_export(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
) -> StreamingResponse: ) -> StreamingResponse:
@@ -588,7 +588,7 @@ async def approved_export(
@router.get("/api/approved/attachments.zip") @router.get("/api/approved/attachments.zip")
async def approved_attachments_zip( def approved_attachments_zip(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
) -> StreamingResponse: ) -> StreamingResponse:
@@ -660,7 +660,7 @@ async def approved_attachments_zip(
# 승인자 설정 — 분류 관리 # 승인자 설정 — 분류 관리
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.get("/settings", response_class=HTMLResponse) @router.get("/settings", response_class=HTMLResponse)
async def settings_page(request: Request) -> HTMLResponse: def settings_page(request: Request) -> HTMLResponse:
"""승인자/관리자 설정 — 분류 추가/삭제.""" """승인자/관리자 설정 — 분류 추가/삭제."""
from app.main import ( # noqa: WPS433 from app.main import ( # noqa: WPS433
build_erp_nav, build_erp_nav,
@@ -694,7 +694,7 @@ async def settings_page(request: Request) -> HTMLResponse:
@router.get("/api/categories") @router.get("/api/categories")
async def list_categories( def list_categories(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
) -> JSONResponse: ) -> JSONResponse:
@@ -702,7 +702,7 @@ async def list_categories(
@router.post("/api/categories") @router.post("/api/categories")
async def add_category( def add_category(
request: Request, request: Request,
body: CategoryBody, body: CategoryBody,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
@@ -715,7 +715,7 @@ async def add_category(
@router.delete("/api/categories/{name}") @router.delete("/api/categories/{name}")
async def delete_category( def delete_category(
request: Request, request: Request,
name: str, name: str,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
@@ -733,7 +733,7 @@ async def delete_category(
# 항목 CRUD API # 항목 CRUD API
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.get("/api/items") @router.get("/api/items")
async def list_items( def list_items(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
) -> JSONResponse: ) -> JSONResponse:
@@ -747,7 +747,7 @@ async def list_items(
@router.post("/api/items") @router.post("/api/items")
async def create_item( def create_item(
request: Request, request: Request,
body: ExpensePayload, body: ExpensePayload,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -757,7 +757,7 @@ async def create_item(
@router.put("/api/items/{item_id}") @router.put("/api/items/{item_id}")
async def update_item( def update_item(
request: Request, request: Request,
item_id: str, item_id: str,
body: ExpensePayload, body: ExpensePayload,
@@ -782,7 +782,7 @@ async def update_item(
@router.delete("/api/items/{item_id}") @router.delete("/api/items/{item_id}")
async def delete_item( def delete_item(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -806,7 +806,7 @@ async def delete_item(
# 워크플로 API # 워크플로 API
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.post("/api/items/{item_id}/submit") @router.post("/api/items/{item_id}/submit")
async def submit_item( def submit_item(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -821,7 +821,7 @@ async def submit_item(
@router.post("/api/items/{item_id}/revert") @router.post("/api/items/{item_id}/revert")
async def revert_item( def revert_item(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -836,7 +836,7 @@ async def revert_item(
@router.post("/api/items/{item_id}/approve") @router.post("/api/items/{item_id}/approve")
async def approve_item( def approve_item(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
@@ -851,7 +851,7 @@ async def approve_item(
@router.post("/api/items/{item_id}/reject") @router.post("/api/items/{item_id}/reject")
async def reject_item( def reject_item(
request: Request, request: Request,
item_id: str, item_id: str,
body: RejectBody, body: RejectBody,
@@ -869,7 +869,7 @@ async def reject_item(
@router.post("/api/items/{item_id}/settle") @router.post("/api/items/{item_id}/settle")
async def settle_item( def settle_item(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
@@ -887,7 +887,7 @@ async def settle_item(
# 첨부 API # 첨부 API
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.get("/api/items/{item_id}/attachments") @router.get("/api/items/{item_id}/attachments")
async def list_attachments( def list_attachments(
request: Request, request: Request,
item_id: str, item_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -908,7 +908,7 @@ async def list_attachments(
@router.post("/api/items/{item_id}/attachments") @router.post("/api/items/{item_id}/attachments")
async def upload_attachment( def upload_attachment(
request: Request, request: Request,
item_id: str, item_id: str,
kind: str = Form("receipt"), kind: str = Form("receipt"),
@@ -943,7 +943,7 @@ async def upload_attachment(
chunk_size = 1024 * 256 chunk_size = 1024 * 256
try: try:
while True: while True:
chunk = await file.read(chunk_size) chunk = file.file.read(chunk_size) # sync def(스레드풀) — 동기 읽기
if not chunk: if not chunk:
break break
data.extend(chunk) data.extend(chunk)
@@ -953,7 +953,7 @@ async def upload_attachment(
detail=f"파일 크기 초과 (최대 {MAX_UPLOAD_BYTES // (1024*1024)}MB)", detail=f"파일 크기 초과 (최대 {MAX_UPLOAD_BYTES // (1024*1024)}MB)",
) )
finally: finally:
await file.close() file.file.close()
# 이미지면 가로 1000px 초과 시 비율 유지 축소 + JPEG q80 # 이미지면 가로 1000px 초과 시 비율 유지 축소 + JPEG q80
upload_ct = file.content_type upload_ct = file.content_type
@@ -988,7 +988,7 @@ async def upload_attachment(
@router.get("/api/attachments/{att_id}") @router.get("/api/attachments/{att_id}")
async def download_attachment( def download_attachment(
request: Request, request: Request,
att_id: str, att_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1019,7 +1019,7 @@ async def download_attachment(
@router.delete("/api/attachments/{att_id}") @router.delete("/api/attachments/{att_id}")
async def delete_attachment( def delete_attachment(
request: Request, request: Request,
att_id: str, att_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -1042,7 +1042,7 @@ async def delete_attachment(
# 엑셀 내보내기 # 엑셀 내보내기
# ──────────────────────────────────────────────────────────── # ────────────────────────────────────────────────────────────
@router.get("/api/export.xlsx") @router.get("/api/export.xlsx")
async def export_xlsx( def export_xlsx(
request: Request, request: Request,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
) -> StreamingResponse: ) -> StreamingResponse:
@@ -1110,5 +1110,5 @@ async def export_xlsx(
@router.get("/health") @router.get("/health")
async def health() -> dict[str, str]: def health() -> dict[str, str]:
return {"status": "ok", "module": "expense"} return {"status": "ok", "module": "expense"}
+50 -44
View File
@@ -134,11 +134,23 @@ def _base_ctx(request: Request, user: dict[str, Any], st: Any, *, wh: str) -> di
} }
async def _request_form(request: Request) -> Any:
"""폼 본문을 이벤트 루프에서 미리 읽어 핸들러에 넘겨준다.
`request.form()` 은 async 라 sync 핸들러 안에서 부를 수 없다. 이 의존성으로
폼만 먼저 받고, DB 를 쓰는 핸들러 본문은 `def` 로 두어 스레드풀에서 돌린다
(`async def` 안에서 동기 DB 를 부르면 쿼리 동안 앱 전체가 멈춘다).
"""
return await request.form()
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
# 재고 현황 (메인) # 재고 현황 (메인)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/", response_class=HTMLResponse) @router.get("/", response_class=HTMLResponse)
async def index(request: Request) -> HTMLResponse: def index(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -183,7 +195,7 @@ async def index(request: Request) -> HTMLResponse:
@router.get("/rack", response_class=HTMLResponse) @router.get("/rack", response_class=HTMLResponse)
async def rack_view(request: Request) -> HTMLResponse: def rack_view(request: Request) -> HTMLResponse:
"""창고 랙 보기 — 최근(취소 제외) 재고조사의 랙 입력을 칸별로 한눈에. """창고 랙 보기 — 최근(취소 제외) 재고조사의 랙 입력을 칸별로 한눈에.
읽기 전용. 각 칸에 어떤 상품이 몇 박스(× 입수량 = 총개수) 있는지 표시. 읽기 전용. 각 칸에 어떤 상품이 몇 박스(× 입수량 = 총개수) 있는지 표시.
@@ -219,8 +231,8 @@ async def rack_view(request: Request) -> HTMLResponse:
@router.post("/rack/save") @router.post("/rack/save")
async def rack_save( def rack_save(
request: Request, user: dict[str, Any] = Depends(_require_user) request: Request, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)
) -> RedirectResponse: ) -> RedirectResponse:
"""랙 보기에서 드래그로 재배치한 칸 구성을 저장(위치만 변경). """랙 보기에서 드래그로 재배치한 칸 구성을 저장(위치만 변경).
@@ -231,7 +243,6 @@ async def rack_save(
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
form = await request.form()
wh = str(form.get("warehouse_code") or "").strip() or _selected_wh(request, st) wh = str(form.get("warehouse_code") or "").strip() or _selected_wh(request, st)
latest = st.latest_rack_stocktake(warehouse_code=wh) latest = st.latest_rack_stocktake(warehouse_code=wh)
if not latest: if not latest:
@@ -245,7 +256,7 @@ async def rack_save(
@router.post("/reset") @router.post("/reset")
async def reset_data( def reset_data(
request: Request, user: dict[str, Any] = Depends(_require_user) request: Request, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
"""전체 창고 재고 수량 데이터 초기화 — 슈퍼관리자 전용. """전체 창고 재고 수량 데이터 초기화 — 슈퍼관리자 전용.
@@ -263,7 +274,7 @@ async def reset_data(
@router.post("/items/{item_code}/purge") @router.post("/items/{item_code}/purge")
async def purge_orphan_item( def purge_orphan_item(
request: Request, item_code: str, user: dict[str, Any] = Depends(_require_user) request: Request, item_code: str, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
"""미등록(malaysia_items 에 없는) 코드의 이동 이력 삭제 — 슈퍼관리자 전용. """미등록(malaysia_items 에 없는) 코드의 이동 이력 삭제 — 슈퍼관리자 전용.
@@ -294,7 +305,7 @@ async def purge_orphan_item(
# 입고 / 출고 등록 (그리드 일괄) # 입고 / 출고 등록 (그리드 일괄)
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/movements", response_class=HTMLResponse) @router.get("/movements", response_class=HTMLResponse)
async def movements_page(request: Request) -> HTMLResponse: def movements_page(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -347,7 +358,7 @@ async def movements_page(request: Request) -> HTMLResponse:
@router.post("/movements/apply") @router.post("/movements/apply")
async def movements_apply(request: Request, user: dict[str, Any] = Depends(_require_user)) -> RedirectResponse: def movements_apply(request: Request, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)) -> RedirectResponse:
"""낱개 + 세트 한 화면 일괄 적용 (버튼 하나). """낱개 + 세트 한 화면 일괄 적용 (버튼 하나).
form: movement_type(낱개용 IN/OUT/ADJUST), movement_date, warehouse_code, form: movement_type(낱개용 IN/OUT/ADJUST), movement_date, warehouse_code,
@@ -361,7 +372,6 @@ async def movements_apply(request: Request, user: dict[str, Any] = Depends(_requ
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
form = await request.form()
mtype = str(form.get("movement_type") or "").strip().upper() mtype = str(form.get("movement_type") or "").strip().upper()
if mtype not in ("IN", "OUT", "ADJUST"): if mtype not in ("IN", "OUT", "ADJUST"):
raise HTTPException(status_code=400, detail="이동 종류 오류") raise HTTPException(status_code=400, detail="이동 종류 오류")
@@ -441,7 +451,7 @@ async def movements_apply(request: Request, user: dict[str, Any] = Depends(_requ
@router.get("/movements/export") @router.get("/movements/export")
async def movements_export(request: Request) -> StreamingResponse: def movements_export(request: Request) -> StreamingResponse:
"""해당 일자/종류(IN/OUT)에 입출고된 낱개 수량을 엑셀로 내보낸다. """해당 일자/종류(IN/OUT)에 입출고된 낱개 수량을 엑셀로 내보낸다.
컬럼: A=사방넷 코드, B=수량, C=이름. 컬럼: A=사방넷 코드, B=수량, C=이름.
@@ -518,7 +528,7 @@ async def movements_export(request: Request) -> StreamingResponse:
@router.get("/movements/export-daily") @router.get("/movements/export-daily")
async def movements_export_daily(request: Request) -> StreamingResponse: def movements_export_daily(request: Request) -> StreamingResponse:
"""기간 전체를 상품(행) × 일자(열) 표로 엑셀 내보내기. """기간 전체를 상품(행) × 일자(열) 표로 엑셀 내보내기.
콤보(세트)는 등록 시 이미 BOM 으로 분해돼 구성 낱개 OUT movement 로 저장되므로 콤보(세트)는 등록 시 이미 BOM 으로 분해돼 구성 낱개 OUT movement 로 저장되므로
@@ -634,7 +644,7 @@ async def movements_export_daily(request: Request) -> StreamingResponse:
@router.get("/movements/export-compare") @router.get("/movements/export-compare")
async def movements_export_compare(request: Request) -> StreamingResponse: def movements_export_compare(request: Request) -> StreamingResponse:
"""임의 기준일 대비 자동 비교 엑셀 — 재고조사 확정 여부와 무관하게 movement 이력만으로 계산. """임의 기준일 대비 자동 비교 엑셀 — 재고조사 확정 여부와 무관하게 movement 이력만으로 계산.
기준일까지 누적재고(current_stock_as_of) + 기준일 다음날~종료일 일자별 순변동을 더한 기준일까지 누적재고(current_stock_as_of) + 기준일 다음날~종료일 일자별 순변동을 더한
@@ -773,7 +783,7 @@ async def movements_export_compare(request: Request) -> StreamingResponse:
@router.get("/rack/export") @router.get("/rack/export")
async def rack_export(request: Request) -> StreamingResponse: def rack_export(request: Request) -> StreamingResponse:
"""창고 랙 보기 데이터를 엑셀로 내보낸다. """창고 랙 보기 데이터를 엑셀로 내보낸다.
랙 보기와 동일 기준(latest_rack_stocktake)의 모든 칸 항목을 한 행씩. 랙 보기와 동일 기준(latest_rack_stocktake)의 모든 칸 항목을 한 행씩.
@@ -873,7 +883,7 @@ async def rack_export(request: Request) -> StreamingResponse:
# 일일 재고조사 # 일일 재고조사
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/stocktakes", response_class=HTMLResponse) @router.get("/stocktakes", response_class=HTMLResponse)
async def stocktakes_page(request: Request) -> HTMLResponse: def stocktakes_page(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -894,7 +904,7 @@ async def stocktakes_page(request: Request) -> HTMLResponse:
@router.post("/stocktakes") @router.post("/stocktakes")
async def stocktake_create( def stocktake_create(
request: Request, request: Request,
stocktake_date: str = Form(...), stocktake_date: str = Form(...),
warehouse_code: str = Form(...), warehouse_code: str = Form(...),
@@ -915,7 +925,7 @@ async def stocktake_create(
@router.get("/stocktakes/{stocktake_id:int}", response_class=HTMLResponse) @router.get("/stocktakes/{stocktake_id:int}", response_class=HTMLResponse)
async def stocktake_detail(request: Request, stocktake_id: int) -> HTMLResponse: def stocktake_detail(request: Request, stocktake_id: int) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -968,7 +978,7 @@ async def stocktake_detail(request: Request, stocktake_id: int) -> HTMLResponse:
@router.get("/stocktakes/{stocktake_id:int}/export-compare") @router.get("/stocktakes/{stocktake_id:int}/export-compare")
async def stocktake_export_compare(request: Request, stocktake_id: int) -> StreamingResponse: def stocktake_export_compare(request: Request, stocktake_id: int) -> StreamingResponse:
"""이 재고조사(마감) 이후 오늘까지 자동 비교 엑셀. """이 재고조사(마감) 이후 오늘까지 자동 비교 엑셀.
마감재고(재고조사 total_qty) + 마감 다음날부터 오늘까지의 순변동(IN-OUT±ADJUST±STOCKTAKE)을 마감재고(재고조사 total_qty) + 마감 다음날부터 오늘까지의 순변동(IN-OUT±ADJUST±STOCKTAKE)을
@@ -1102,14 +1112,13 @@ async def stocktake_export_compare(request: Request, stocktake_id: int) -> Strea
@router.post("/stocktakes/{stocktake_id:int}/lines/bulk") @router.post("/stocktakes/{stocktake_id:int}/lines/bulk")
async def stocktake_lines_bulk( def stocktake_lines_bulk(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)
) -> RedirectResponse: ) -> RedirectResponse:
"""그리드 일괄 저장. form: qty_<SKUCODE>... (낱개+세트). 빈칸은 스킵, 0 허용.""" """그리드 일괄 저장. form: qty_<SKUCODE>... (낱개+세트). 빈칸은 스킵, 0 허용."""
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
form = await request.form()
codes = [i["item_code"] for i in st.list_items(kind="individual")] codes = [i["item_code"] for i in st.list_items(kind="individual")]
codes += [i["item_code"] for i in st.list_items(kind="set")] codes += [i["item_code"] for i in st.list_items(kind="set")]
errors: list[str] = [] errors: list[str] = []
@@ -1161,8 +1170,8 @@ def _parse_rack_form(form: Any) -> list[dict[str, Any]]:
@router.post("/stocktakes/{stocktake_id:int}/lines/upload") @router.post("/stocktakes/{stocktake_id:int}/lines/upload")
async def stocktake_lines_upload( def stocktake_lines_upload(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)
) -> RedirectResponse: ) -> RedirectResponse:
"""엑셀 업로드로 SKU별 수량 일괄 입력(랙 입력 대신). daily_stocktake_line 을 직접 갱신한다. """엑셀 업로드로 SKU별 수량 일괄 입력(랙 입력 대신). daily_stocktake_line 을 직접 갱신한다.
@@ -1182,11 +1191,10 @@ async def stocktake_lines_upload(
if head["status"] != "draft": if head["status"] != "draft":
raise HTTPException(status_code=400, detail="작성중인 조사만 입력할 수 있습니다.") raise HTTPException(status_code=400, detail="작성중인 조사만 입력할 수 있습니다.")
form = await request.form()
upload = form.get("file") upload = form.get("file")
if upload is None or not getattr(upload, "filename", ""): if upload is None or not getattr(upload, "filename", ""):
raise HTTPException(status_code=400, detail="엑셀 파일을 선택하세요.") raise HTTPException(status_code=400, detail="엑셀 파일을 선택하세요.")
data = await upload.read() data = upload.file.read() # sync def(스레드풀) — 동기 읽기
if not data: if not data:
raise HTTPException(status_code=400, detail="빈 파일입니다.") raise HTTPException(status_code=400, detail="빈 파일입니다.")
@@ -1241,8 +1249,8 @@ async def stocktake_lines_upload(
@router.post("/stocktakes/{stocktake_id:int}/rack/bulk") @router.post("/stocktakes/{stocktake_id:int}/rack/bulk")
async def stocktake_rack_bulk( def stocktake_rack_bulk(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)
) -> RedirectResponse: ) -> RedirectResponse:
"""랙 입력 일괄 저장. """랙 입력 일괄 저장.
@@ -1251,7 +1259,6 @@ async def stocktake_rack_bulk(
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
form = await request.form()
entries = _parse_rack_form(form) entries = _parse_rack_form(form)
try: try:
st.replace_rack(stocktake_id=stocktake_id, entries=entries) st.replace_rack(stocktake_id=stocktake_id, entries=entries)
@@ -1263,7 +1270,7 @@ async def stocktake_rack_bulk(
@router.post("/stocktakes/{stocktake_id:int}/rack/load-previous") @router.post("/stocktakes/{stocktake_id:int}/rack/load-previous")
async def stocktake_rack_load_previous( def stocktake_rack_load_previous(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
"""직전 재고조사의 랙 저장값을 현재(작성중) 조사로 불러와 채운다. """직전 재고조사의 랙 저장값을 현재(작성중) 조사로 불러와 채운다.
@@ -1292,8 +1299,8 @@ async def stocktake_rack_load_previous(
@router.post("/stocktakes/{stocktake_id:int}/rack/finalize") @router.post("/stocktakes/{stocktake_id:int}/rack/finalize")
async def stocktake_rack_finalize( def stocktake_rack_finalize(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user), form: Any = Depends(_request_form)
) -> RedirectResponse: ) -> RedirectResponse:
"""랙 입력 저장 + 즉시 확정(한 번에). """랙 입력 저장 + 즉시 확정(한 번에).
@@ -1307,7 +1314,6 @@ async def stocktake_rack_finalize(
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
form = await request.form()
entries = _parse_rack_form(form) entries = _parse_rack_form(form)
try: try:
st.replace_rack(stocktake_id=stocktake_id, entries=entries) st.replace_rack(stocktake_id=stocktake_id, entries=entries)
@@ -1320,7 +1326,7 @@ async def stocktake_rack_finalize(
@router.post("/stocktakes/{stocktake_id:int}/lines/{line_id:int}/delete") @router.post("/stocktakes/{stocktake_id:int}/lines/{line_id:int}/delete")
async def stocktake_line_delete( def stocktake_line_delete(
request: Request, stocktake_id: int, line_id: int, request: Request, stocktake_id: int, line_id: int,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
) -> RedirectResponse: ) -> RedirectResponse:
@@ -1337,7 +1343,7 @@ async def stocktake_line_delete(
@router.post("/stocktakes/{stocktake_id:int}/finalize") @router.post("/stocktakes/{stocktake_id:int}/finalize")
async def stocktake_finalize( def stocktake_finalize(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -1357,7 +1363,7 @@ async def stocktake_finalize(
@router.post("/stocktakes/{stocktake_id:int}/cancel") @router.post("/stocktakes/{stocktake_id:int}/cancel")
async def stocktake_cancel( def stocktake_cancel(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
st = _store(request) st = _store(request)
@@ -1371,7 +1377,7 @@ async def stocktake_cancel(
@router.post("/stocktakes/{stocktake_id:int}/delete") @router.post("/stocktakes/{stocktake_id:int}/delete")
async def stocktake_delete( def stocktake_delete(
request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, user: dict[str, Any] = Depends(_require_user)
) -> RedirectResponse: ) -> RedirectResponse:
"""재고조사 완전 삭제 — 슈퍼관리자 전용.""" """재고조사 완전 삭제 — 슈퍼관리자 전용."""
@@ -1392,7 +1398,7 @@ async def stocktake_delete(
# JSON API # JSON API
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/api/warehouses") @router.get("/api/warehouses")
async def api_warehouses(request: Request, _: dict[str, Any] = Depends(_require_user)) -> JSONResponse: def api_warehouses(request: Request, _: dict[str, Any] = Depends(_require_user)) -> JSONResponse:
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
@@ -1400,7 +1406,7 @@ async def api_warehouses(request: Request, _: dict[str, Any] = Depends(_require_
@router.get("/api/items") @router.get("/api/items")
async def api_items(request: Request, kind: str = "", _: dict[str, Any] = Depends(_require_user)) -> JSONResponse: def api_items(request: Request, kind: str = "", _: dict[str, Any] = Depends(_require_user)) -> JSONResponse:
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
@@ -1409,13 +1415,13 @@ async def api_items(request: Request, kind: str = "", _: dict[str, Any] = Depend
@router.get("/api/bom") @router.get("/api/bom")
async def api_bom(request: Request, _: dict[str, Any] = Depends(_require_user)) -> JSONResponse: def api_bom(request: Request, _: dict[str, Any] = Depends(_require_user)) -> JSONResponse:
"""itemcode_db(set_components)에서 읽은 MY- 세트 BOM (읽기 전용).""" """itemcode_db(set_components)에서 읽은 MY- 세트 BOM (읽기 전용)."""
return JSONResponse({"bom": _bom_map(request)}) return JSONResponse({"bom": _bom_map(request)})
@router.get("/api/stock") @router.get("/api/stock")
async def api_stock(request: Request, wh: str = "", _: dict[str, Any] = Depends(_require_user)) -> JSONResponse: def api_stock(request: Request, wh: str = "", _: dict[str, Any] = Depends(_require_user)) -> JSONResponse:
st = _store(request) st = _store(request)
if st is None: if st is None:
raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정") raise HTTPException(status_code=503, detail="malaysia_stock_db 미설정")
@@ -1424,7 +1430,7 @@ async def api_stock(request: Request, wh: str = "", _: dict[str, Any] = Depends(
@router.post("/api/movements") @router.post("/api/movements")
async def api_movement_create( def api_movement_create(
request: Request, payload: dict[str, Any] = Body(...), user: dict[str, Any] = Depends(_require_user) request: Request, payload: dict[str, Any] = Body(...), user: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
st = _store(request) st = _store(request)
@@ -1448,7 +1454,7 @@ async def api_movement_create(
@router.post("/api/movements/set-out") @router.post("/api/movements/set-out")
async def api_set_out( def api_set_out(
request: Request, payload: dict[str, Any] = Body(...), user: dict[str, Any] = Depends(_require_user) request: Request, payload: dict[str, Any] = Body(...), user: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
st = _store(request) st = _store(request)
@@ -1472,7 +1478,7 @@ async def api_set_out(
@router.get("/api/stocktakes/{stocktake_id:int}/result") @router.get("/api/stocktakes/{stocktake_id:int}/result")
async def api_stocktake_result( def api_stocktake_result(
request: Request, stocktake_id: int, _: dict[str, Any] = Depends(_require_user) request: Request, stocktake_id: int, _: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
st = _store(request) st = _store(request)
@@ -1488,5 +1494,5 @@ async def api_stocktake_result(
@router.get("/health") @router.get("/health")
async def health() -> dict[str, str]: def health() -> dict[str, str]:
return {"status": "ok", "module": "malaysia"} return {"status": "ok", "module": "malaysia"}
+25
View File
@@ -0,0 +1,25 @@
"""실적(쇼핑몰 통합 매출) 모듈.
네 영역을 분리해 둔다(쇼핑몰 하나를 추가할 때 어댑터 파일 하나만 늘어나게).
① 쇼핑몰 API 수집 adapters/ (쇼핑몰별 어댑터) + sync.py (공통 동기화 서비스)
② 인증정보·보안 security/ (AES-256-GCM, 비밀값 가리기) + credentials.py
③ 매출 계산/저장 calc.py (기간·수수료·집계) + db.py (performance_db)
④ 대시보드/UI dashboard.py (화면 데이터 조립) + router.py + templates/performance/
데이터 저장은 performance_db 전용이다. PERFORMANCE_DB_URL 미설정 시
build_performance_store 는 None 을 반환하고 라우터가 "설정 필요" 안내를 보여 준다(앱은 죽지 않음).
"""
from typing import Any
from .router import router
__all__ = ["router", "build_performance_store"]
def build_performance_store(*, dsn: str | None) -> Any:
if not dsn:
return None
from .db import PerformanceDBStore # 지연 import (개발 환경 deps 없을 수 있음)
return PerformanceDBStore(dsn)
@@ -0,0 +1,5 @@
"""① 쇼핑몰 API 수집 — 쇼핑몰별 어댑터(공통 인터페이스는 base.py, 목록은 registry.py)."""
from .registry import all_adapters, get_adapter
__all__ = ["all_adapters", "get_adapter"]
+253
View File
@@ -0,0 +1,253 @@
"""① 쇼핑몰 API 수집 — 공통 인터페이스.
쇼핑몰 하나 = 어댑터 파일 하나. 새 쇼핑몰은 `MarketplaceAdapter` 를 상속한 파일을
만들고 `registry.py` 에 한 줄 추가하면 설정 화면·동기화·대시보드에 자동으로 붙는다.
흐름: 쇼핑몰 원본 → 어댑터(fetch_* → normalize_*) → 공통 SaleEvent → sync 서비스가 DB 저장
어댑터가 지켜야 할 것:
- 인증정보는 `ctx.credentials.get(key)` 로만 꺼낸다(복호화는 서버 안에서만).
- 새 토큰은 `ctx.credentials.set(key, value)` 로 저장한다(자동 암호화).
- 오류는 아래 AdapterError 계열로 던진다. 메시지에 비밀값을 넣지 않는다
(sync 서비스가 한 번 더 가리지만, 애초에 넣지 않는 것이 원칙).
- 금액은 원 단위 정수(int). 결제는 +, 취소/반품은 − 로 만든다.
- 날짜 기준을 섞지 않는다: order_date / payment_date / event_date 를 각각 채운다.
집계 기준일(sales_date)은 sync 서비스가 정한다(결제=결제일, 취소·반품=발생일).
"""
from __future__ import annotations
from abc import ABC
from dataclasses import dataclass, field
from datetime import date
from typing import Any, Iterable, Protocol
# 연결 상태 코드 → 화면 표시. DB CHECK 제약과 같은 목록.
STATUS_LABELS: dict[str, str] = {
"ok": "정상 연결",
"not_configured": "인증정보 미설정",
"auth_failed": "인증 실패",
"token_expired": "Token 만료",
"api_error": "API 오류",
"not_implemented": "연동 준비 중",
"unknown": "확인 전",
"disabled": "사용 중지", # DB 에는 저장하지 않는 화면 전용 상태(쇼핑몰 사용 OFF)
"cancelled": "취소됨", # 화면 전용 — 매출 업데이트 창에서 [업데이트 취소](연결 상태는 바꾸지 않음)
}
EVENT_TYPES = ("SALE", "CANCEL", "RETURN", "ADJUST")
# ════════════════════════════════════════════════════════════
# 오류 — status 가 곧 연결 상태 코드
# ════════════════════════════════════════════════════════════
class AdapterError(Exception):
status = "api_error"
def __init__(self, message: str = "") -> None:
super().__init__(message or STATUS_LABELS.get(self.status, "오류"))
self.message = message or STATUS_LABELS.get(self.status, "오류")
class NotConfigured(AdapterError):
status = "not_configured"
class AuthFailed(AdapterError):
status = "auth_failed"
class TokenExpired(AdapterError):
status = "token_expired"
class ApiError(AdapterError):
status = "api_error"
class NotImplementedYet(AdapterError):
status = "not_implemented"
class Cancelled(AdapterError):
"""사용자가 매출 업데이트를 취소함 — 어댑터가 ctx.progress.check() 에서 받는다. 연결 오류가 아니다."""
status = "cancelled"
# ════════════════════════════════════════════════════════════
# 설정 입력칸 · 공통 매출 사건
# ════════════════════════════════════════════════════════════
@dataclass(frozen=True)
class CredentialField:
"""설정 화면 입력칸 하나. secret=True 면 저장 후 값을 화면으로 다시 보내지 않는다.
internal=True 는 화면에 안 보이는 내부 값(access/refresh token 등) — 어댑터가 직접 저장.
"""
key: str
label: str
secret: bool = False
required: bool = True
help: str = ""
placeholder: str = ""
internal: bool = False
@dataclass
class SaleEvent:
"""쇼핑몰 원본을 공통 형식으로 바꾼 매출 사건 하나(주문 라인 단위 권장)."""
event_type: str # SALE / CANCEL / RETURN / ADJUST
external_event_id: str # 쇼핑몰 안에서 이 사건을 유일하게 가리키는 값(중복 방지 키)
external_order_id: str
event_date: date # 사건 발생일(결제=결제일, 취소=취소일, 반품=반품완료일)
amount: int # 원 단위 정수. 결제 +, 취소/반품 −
external_line_id: str = ""
order_date: date | None = None
payment_date: date | None = None
product_name: str = ""
option_name: str = ""
quantity: int = 0
discount_amount: int = 0
order_status: str = ""
raw: dict[str, Any] = field(default_factory=dict)
# 어느 쇼핑몰 열로 집계할지 — None 이면 이 어댑터의 쇼핑몰. 다른 쇼핑몰 주문을 대신 받아 오는
# 연동(예: 카페24 마켓 통합관리가 가져온 스마트스토어 주문)은 해당 쇼핑몰 코드를 넣는다.
marketplace_code: str | None = None
def validate(self) -> None:
if self.event_type not in EVENT_TYPES:
raise ValueError(f"알 수 없는 사건 종류: {self.event_type}")
if not self.external_event_id or not self.external_order_id:
raise ValueError("external_event_id / external_order_id 가 필요합니다.")
if not isinstance(self.amount, int) or isinstance(self.amount, bool):
raise ValueError("amount 는 원 단위 정수여야 합니다.")
if self.event_type == "SALE" and self.amount < 0:
raise ValueError("결제(SALE) 금액은 음수일 수 없습니다.")
if self.event_type in ("CANCEL", "RETURN") and self.amount > 0:
raise ValueError("취소/반품 금액은 음수(또는 0)여야 합니다.")
class CredentialAccessor(Protocol):
def get(self, key: str) -> str: ...
def set(self, key: str, value: str) -> None: ...
def has(self, key: str) -> bool: ...
class Progress:
"""수집 진행 알림(매출 업데이트 창의 진행 막대용). 기본은 아무것도 하지 않는다 — sync 가 진행 상황을 모으는
객체(jobs.ShopProgress)로 바꿔 넣는다.
어댑터: 조회를 시작하기 전에 plan(전체 단계 수, 단위) → 단계 하나(하루·조회 구간)를 끝낼 때마다
step(items=그 단계에서 받은 건수). 하다가 할 일이 늘면 add(늘어난 단계 수).
API 를 부르기 직전마다 check() — 사용자가 [업데이트 취소]를 눌렀으면 Cancelled 를 던져 거기서 멈춘다."""
def plan(self, total: int, unit: str = "단계") -> None:
return None
def add(self, n: int) -> None:
return None
def step(self, n: int = 1, *, items: int = 0) -> None:
return None
def check(self) -> None:
return None
@dataclass
class AdapterContext:
code: str
credentials: CredentialAccessor
app_state: Any = None # 공통 연동 계층 재사용(예: 카페24 토큰 저장소)
timeout_sec: float = 20.0
progress: Progress = field(default_factory=Progress)
# ════════════════════════════════════════════════════════════
# 어댑터
# ════════════════════════════════════════════════════════════
class MarketplaceAdapter(ABC):
code: str = ""
name: str = ""
auth_type: str = "api_key" # api_key / oauth / shared(공통 연동 계층 재사용)
docs_url: str = ""
implemented: bool = False # 실제 수집(fetch)이 구현됐는가
# True 면 동기화 때 그 기간(sales_date)의 이 쇼핑몰 실데이터를 지우고 새로 넣는다(한 트랜잭션).
# 쇼핑몰 API 가 "기간 안 결제·환불"을 빠짐없이 돌려줄 때만 켠다 — 규칙이 바뀌거나
# 주문이 사라져도 예전 행이 남지 않는다. False 면 같은 사건 ID 만 덮어쓴다(upsert).
replace_range: bool = False
# replace_range 일 때 이 어댑터가 만든 사건을 가려내는 외부 사건 ID 접두어. 다른 쇼핑몰 열로 보낸
# 사건(marketplace_code 지정)도 이 접두어로 찾아 함께 교체한다 — 그 쇼핑몰의 직접 연동분은 건드리지 않음.
event_prefix: str = ""
note: str = "" # 설정 화면 안내 문구
# ── 설정 ──────────────────────────────────────────────
def credential_fields(self) -> list[CredentialField]:
return []
def visible_fields(self) -> list[CredentialField]:
return [f for f in self.credential_fields() if not f.internal]
@property
def uses_shared_integration(self) -> bool:
return self.auth_type == "shared"
def validate_credentials(self, values: dict[str, str]) -> list[str]:
"""저장 전 검사. 값 자체를 오류 문구에 넣지 않는다."""
errors: list[str] = []
for f in self.visible_fields():
v = (values.get(f.key) or "").strip()
if f.required and not v:
errors.append(f"{f.label} 을(를) 입력하세요.")
elif v and len(v) > 2000:
errors.append(f"{f.label} 값이 너무 깁니다.")
return errors
def is_configured(self, ctx: AdapterContext) -> bool:
return all(ctx.credentials.has(f.key) for f in self.visible_fields() if f.required)
# ── 인증 ──────────────────────────────────────────────
def authenticate(self, ctx: AdapterContext) -> None:
"""API 호출 전 준비(토큰 발급 등). 기본은 할 일 없음."""
if not self.is_configured(ctx):
raise NotConfigured("필수 인증정보가 입력되지 않았습니다.")
def refresh_token(self, ctx: AdapterContext) -> None:
"""OAuth 쇼핑몰: refresh token 으로 access token 재발급 후 ctx.credentials.set(...)."""
return None
def test_connection(self, ctx: AdapterContext) -> str:
"""성공 시 사람이 읽을 짧은 문구 반환. 실패는 AdapterError."""
self.authenticate(ctx)
raise NotImplementedYet(f"{self.name} API 연동은 다음 단계에서 구현됩니다.")
# ── 수집 ──────────────────────────────────────────────
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
raise NotImplementedYet(f"{self.name} 주문 수집은 다음 단계에서 구현됩니다.")
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
return []
def normalize_order(self, raw: dict[str, Any]) -> list[SaleEvent]:
raise NotImplementedYet(f"{self.name} 주문 변환은 다음 단계에서 구현됩니다.")
def normalize_refund(self, raw: dict[str, Any]) -> list[SaleEvent]:
return []
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
"""기간의 주문·취소/반품을 받아 공통 사건으로 변환. (원본 건수, 사건 목록)."""
self.authenticate(ctx)
fetched = 0
events: list[SaleEvent] = []
for raw in self.fetch_orders(ctx, start, end):
fetched += 1
events.extend(self.normalize_order(raw))
for raw in self.fetch_refunds(ctx, start, end):
fetched += 1
events.extend(self.normalize_refund(raw))
for ev in events:
ev.validate()
return fetched, events
+770
View File
@@ -0,0 +1,770 @@
"""카페24 — 공통 연동 계층(app/integrations/cafe24) 재사용.
카페24는 이미 OAuth 로 연결해 쓰고 있다(상품관리). 실적 설정에서 인증정보를 따로
받지 않고, 같은 토큰 저장소(cafe24_db)와 클라이언트(재시도·429·토큰 자동 갱신)를 쓴다.
주문 읽기 권한(mall.read_order)이 필요하다 — config.DEFAULT_SCOPES 에 포함, 권한 추가 후
카페24 상품관리 → 시스템에서 한 번 다시 연결해야 한다.
카페24 관리자 "일별 매출내역"과 같은 기준으로 센다(Admin API 문서 2026-09-01 확인).
- 결제합계(SALE, +): GET /admin/orders date_type=pay_date(결제일), 결제된(paid=T) 주문마다
실결제금액 + 적립금 + 예치금 + 네이버포인트 = 고객이 실제로 낸 금액
(initial_order_amount 의 payment_amount·points_spent_amount·credits_spent_amount + 주문의 naver_point)
"상품구매금액 + 배송비 − 할인 − 쿠폰"은 할인 필드에 안 잡히는 차이(수십~수만 원)가 생겨 쓰지 않는다
(2026-09-23 실데이터: 카페24 1,874,738 = 1,713,128 + 10,110 + 151,500, 상품식은 1,874,800).
네 값이 모두 0인 주문도 0원(카페24와 같음).
환불은 따로 빼므로 취소 후 금액(actual_order_amount)이 아니라 결제 당시 금액을 쓴다.
- 환불합계(CANCEL/RETURN, −): GET /admin/refunds date_type=refund_date(환불완료일),
실제 환불액(actual_refund_amount). 환불코드가 R 로 시작하면 반품, 그 밖은 취소.
- 수집 기간을 통째로 다시 받는다(replace_range) — 결제·환불 모두 기간 안 날짜로 조회되므로
그 기간의 카페24 실데이터를 지우고 새로 넣는다. 규칙이 바뀌거나 주문이 사라져도 이중 집계 없음.
- 자체몰 주문(market_id 가 self/빈값)은 카페24 열. 카페24 마켓 통합관리로 들어온 다른 마켓 주문
(스마트스토어·쿠팡 등)은 MARKET_MAP 으로 해당 쇼핑몰 열에 넣는다(환불도 원 주문으로 판단).
현재 이 쇼핑몰은 마켓 통합관리를 쓰지 않아 MARKET_MAP 이 비어 있다 — 모두 카페24 열.
MARKET_MAP 에 없는 마켓은 카페24 열 — 전체 합계는 항상 카페24 일별 매출내역과 같다.
네이버페이 결제(order_place_id=NCHECKOUT)는 자체몰 주문이라 카페24 열.
카페24 가 만든 사건은 모두 외부 사건 ID 앞에 "c24:" — 다시 받을 때 이것만 골라 교체하므로
해당 쇼핑몰을 나중에 직접 연동해도 그 데이터는 건드리지 않는다(단, 같은 주문을 양쪽에서 받지 않게
직접 연동을 켜는 쇼핑몰은 MARKET_MAP 에서 빼야 한다).
- 한 호출 검색기간 3개월 미만 → 60일씩 나눠 요청. orders limit ≤ 1000, refunds limit ≤ 500, offset ≤ 15000.
- 개인정보(구매자 이름·주소·연락처·계좌)는 저장하지 않는다 — raw 에는 금액·상태 필드만.
- 할인 항목 구성·마켓 주문 포함 여부는 `reconcile()`(설정 화면 "카페24 매출 대조")로 카페24 화면과
대조해 확정한다.
"""
from __future__ import annotations
from datetime import date, timedelta
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
from typing import Any, Iterable
from .base import (
AdapterContext,
ApiError,
AuthFailed,
MarketplaceAdapter,
NotConfigured,
SaleEvent,
TokenExpired,
)
ORDER_SCOPE = "mall.read_order"
ORDER_LIMIT = 1000
REFUND_LIMIT = 500
LOOKUP_BATCH = 100
MAX_OFFSET = 15000
CHUNK_DAYS = 60
EVENT_PREFIX = "c24:"
# 매출 대조 전용 — 클레임 완료 주문 조회 날짜 유형과 "완료" 상태(입금전취소 C47~49 는 결제 전이라 제외)
CLAIM_DATE_TYPES = (("cancel_complete_date", "취소완료"), ("cancel_date", "주문취소일"),
("return_complete_date", "반품완료"), ("exchange_complete_date", "교환완료"))
CLAIM_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43", "E40"})
UNPAID_CANCEL = frozenset({"C47", "C48", "C49"})
# 환불 목록(/admin/refunds)에 없는 취소·반품(네이버페이 등) — 카페24 일별 매출 환불합계에는 들어간다(실데이터 확인)
NO_RECORD_DATE_TYPES = ("cancel_date", "return_complete_date")
NO_RECORD_DONE = frozenset({"C40", "C41", "C42", "C43", "R40", "R41", "R42", "R43"})
NO_RECORD_CHANNEL = "ncheckout" # 네이버페이만 — 톡체크아웃·자체몰의 환불 기록 없는 취소는 카페24 환불합계에 없다
REFUND_LOOKAROUND_DAYS = 60
# 카페24 자체몰 주문 채널 — market_id 는 외부 마켓만이 아니라 주문 채널·간편결제도 담는다
# (실데이터 확인 2026-09-30: mobile=모바일웹, NCHECKOUT=네이버페이, KAKAOPAY=톡체크아웃).
# 이 주문들은 카페24 자체몰 매출이다. 비교는 소문자로.
SELF_CHANNELS: dict[str, str] = {
# self 는 PC 전용이 아니다 — 주문경로(order_place_name)가 "PC쇼핑몰"·"모바일웹"으로 나뉘어 섞여 있다(실데이터 확인).
"": "자체몰", "self": "자체몰", "cafe24": "자체몰", "mobile": "모바일웹", "mobile_d": "모바일앱",
"ncheckout": "네이버페이", "kakaopay": "톡체크아웃",
}
# 카페24 마켓 통합관리가 가져온 외부 마켓 주문의 market_id(또는 order_place_id) → 우리 쇼핑몰 열.
# 이 쇼핑몰은 카페24 마켓 통합관리를 쓰지 않는다(2026-09 사용자 확인) — 비워 두어 카페24로 들어온 주문은 모두
# 카페24 열. 나중에 쓰게 되면 대조 화면 "주문 채널별" 표의 market_id 로 확인해 예: {"shopn": "naver"} 처럼 넣는다
# (그 쇼핑몰을 직접 연동한다면 넣지 않는다 — 같은 주문을 두 번 받게 됨). 결제수단과 헷갈리는 이름(naver, kakao) 금지.
MARKET_MAP: dict[str, str] = {}
def _key(value: Any) -> str:
return str(value or "").strip().lower()
def channel_kind(market_id: Any, order_place_id: Any = None) -> str:
"""self(자체몰 채널) / market(외부 마켓, 해당 쇼핑몰 열) / unknown(모르는 채널 → 카페24 열)."""
if market_id is None or _key(market_id) in SELF_CHANNELS:
return "self"
if _key(market_id) in MARKET_MAP or _key(order_place_id) in MARKET_MAP:
return "market"
return "unknown"
def target_code(market_id: Any, order_place_id: Any = None) -> str:
"""이 주문을 집계할 쇼핑몰 열. 자체몰 채널·모르는 채널은 카페24."""
if channel_kind(market_id, order_place_id) != "market":
return "cafe24"
return MARKET_MAP.get(_key(market_id)) or MARKET_MAP[_key(order_place_id)]
# 참고식(상품구매금액 + 배송비 − 할인 − 쿠폰)의 필드 — 결제합계는 PAID_FIELDS + naver_point 로 센다
DISCOUNT_FIELDS = ("membership_discount_amount", "set_product_discount_amount", "app_discount_amount",
"market_other_discount_amount", "shipping_fee_discount_amount")
COUPON_FIELDS = ("coupon_discount_price", "coupon_shipping_fee_amount")
AMOUNT_FIELDS = ("order_price_amount", "shipping_fee", *DISCOUNT_FIELDS, *COUPON_FIELDS,
"points_spent_amount", "credits_spent_amount", "payment_amount")
PAID_FIELDS = ("payment_amount", "points_spent_amount", "credits_spent_amount")
def _won(value: Any) -> int:
"""카페24 금액 문자열("29000.00") → 원 단위 정수."""
try:
return int(Decimal(str(value or "0")).quantize(Decimal(1), rounding=ROUND_HALF_UP))
except (InvalidOperation, ValueError):
return 0
def _day(value: Any) -> date | None:
""""2018-07-04T11:21:35+09:00" / "2017-07-10 15:55:51" → date (카페24 는 KST 로 준다)."""
s = str(value or "").strip()
if len(s) < 10:
return None
try:
return date.fromisoformat(s[:10])
except ValueError:
return None
def order_amounts(order: dict[str, Any]) -> dict[str, int]:
"""결제 당시 금액(initial_order_amount, 없으면 actual_order_amount) 항목별 원 단위 + 네이버포인트(주문 필드)."""
a = order.get("initial_order_amount") or order.get("actual_order_amount") or {}
return {**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "naver_point": _won(order.get("naver_point"))}
def goods_total(w: dict[str, int]) -> int:
"""참고식: 상품구매금액 + 배송비 − 할인 − 쿠폰."""
return (w["order_price_amount"] + w["shipping_fee"]
- sum(w[k] for k in DISCOUNT_FIELDS) - sum(w[k] for k in COUPON_FIELDS))
def _paid_total(w: dict[str, int]) -> int:
"""결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트. 넷 다 0인 주문은 카페24도 0원으로 센다
(9/25 가상계좌·휴대폰 9,900 주문 — 상품식으로 넣으면 그만큼 많아짐)."""
return sum(w[k] for k in PAID_FIELDS) + w["naver_point"]
def order_total(order: dict[str, Any]) -> int:
"""결제합계(결제 당시) — 카페24 일별 매출내역 결제합계와 같은 기준."""
return _paid_total(order_amounts(order))
def refund_total(refund: dict[str, Any]) -> int:
"""환불합계 = 실제 환불액 + 적립금·예치금 환불."""
return _won(refund.get("actual_refund_amount")) + _won(refund.get("used_points")) + _won(refund.get("used_credits"))
def order_total_now(order: dict[str, Any]) -> int:
"""취소·반품 반영 후 현재 결제합계(actual_order_amount). 없으면 결제 당시 금액."""
a = order.get("actual_order_amount") or order.get("initial_order_amount") or {}
return _paid_total({**{k: _won(a.get(k)) for k in AMOUNT_FIELDS}, "naver_point": _won(order.get("naver_point"))})
def is_self_market(market_id: Any) -> bool:
"""카페24 자체몰 채널(PC·모바일·네이버페이·톡체크아웃 등)인가."""
return channel_kind(market_id) == "self"
# 대조 진단 — 이름에 이 말이 들어간 숫자 필드만 합산(계좌·연락처 같은 개인정보 숫자는 이름이 달라 제외)
DIAG_WORDS = ("price", "amount", "discount", "point", "fee", "credit", "mileage", "sale", "benefit", "incentive", "coupon")
def _num(value: Any) -> Decimal | None:
if isinstance(value, bool) or value is None:
return None
try:
d = Decimal(str(value).strip())
except (InvalidOperation, ValueError):
return None
return d if d.is_finite() else None
def money_fields(obj: Any) -> dict[str, int]:
"""dict 의 금액성 숫자 필드(이름에 DIAG_WORDS) → 원 단위. 중첩은 한 단계까지 "부모.자식"."""
out: dict[str, int] = {}
if not isinstance(obj, dict):
return out
for k, v in obj.items():
if isinstance(v, dict):
for k2, v2 in money_fields(v).items():
out[f"{k}.{k2}"] = v2
continue
if not any(w in str(k).lower() for w in DIAG_WORDS):
continue
n = _num(v)
if n is not None:
out[str(k)] = int(n.quantize(Decimal(1), rounding=ROUND_HALF_UP))
return out
def _chunks(start: date, end: date) -> Iterable[tuple[date, date]]:
s = start
while s <= end:
e = min(end, s + timedelta(days=CHUNK_DAYS - 1))
yield s, e
s = e + timedelta(days=1)
class Cafe24Adapter(MarketplaceAdapter):
code = "cafe24"
name = "카페24"
auth_type = "shared"
implemented = True
replace_range = True
event_prefix = EVENT_PREFIX
docs_url = "https://apidocs.cafe24.com/docs/admin/get-orders"
note = ("카페24 상품관리에서 연결한 OAuth 토큰을 함께 씁니다(여기서 따로 입력하지 않음). "
"주문 읽기 권한이 필요해 권한 추가 후 한 번 다시 연결해야 합니다.")
# ── 연결 ──────────────────────────────────────────────
def is_configured(self, ctx: AdapterContext) -> bool:
return True
def _repo(self, ctx: AdapterContext):
return getattr(ctx.app_state, "cafe24_store", None) if ctx.app_state is not None else None
def shared_status(self, ctx: AdapterContext) -> dict:
from app.integrations.cafe24.config import load_config # 지연 import
from app.integrations.cafe24.tokens import TokenService # 지연 import
repo = self._repo(ctx)
config = load_config()
if repo is None:
return {"connected": False, "missing": config.missing or ["CAFE24_DB_URL"], "needs_reauth": False}
return TokenService(repo, config).status()
def authenticate(self, ctx: AdapterContext) -> None:
st = self.shared_status(ctx)
if not st.get("connected"):
if st.get("missing"):
raise NotConfigured("카페24 연동 환경변수가 설정되지 않았습니다.")
if st.get("needs_reauth") and str(st.get("reason", "")).startswith("refresh"):
raise TokenExpired("카페24 연결이 만료되었습니다. 카페24 상품관리 → 시스템에서 재연결하세요.")
raise AuthFailed("카페24에 연결되어 있지 않습니다. 카페24 상품관리 → 시스템에서 연결하세요.")
if ORDER_SCOPE not in str(st.get("scopes") or ""):
raise AuthFailed("카페24 토큰에 주문 읽기 권한(mall.read_order)이 없습니다. "
"카페24 상품관리 → 시스템에서 다시 연결하세요.")
def _client(self, ctx: AdapterContext):
from app.integrations.cafe24 import build_cafe24_api # 지연 import
return build_cafe24_api(self._repo(ctx)).client
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
from app.integrations.cafe24.errors import ( # 지연 import
Cafe24ApiError,
Cafe24AuthError,
Cafe24ConfigError,
Cafe24RateLimitError,
)
try:
return self._client(ctx).get(path, params=params)
except Cafe24ConfigError as exc:
raise NotConfigured(str(exc)) from None
except Cafe24AuthError as exc:
raise AuthFailed(str(exc)) from None
except Cafe24RateLimitError as exc:
raise ApiError(f"카페24 호출 제한(429): {exc}") from None
except Cafe24ApiError as exc:
status = getattr(exc, "status", None)
if status == 403:
raise AuthFailed(f"카페24 권한 오류(403): {exc}. 주문 권한 추가 후 재연결하세요.") from None
raise ApiError(f"카페24 API 오류({status}): {exc}") from None
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
self.authenticate(ctx)
today = today_kst().isoformat()
self._get(ctx, "/admin/orders", {"start_date": today, "end_date": today, "date_type": "pay_date", "limit": 1})
return "카페24 연결 정상(주문 조회 권한 확인)."
# ── 조회 ──────────────────────────────────────────────
def _paged(self, ctx: AdapterContext, path: str, key: str, params: dict[str, Any],
limit: int) -> Iterable[dict[str, Any]]:
offset = 0
while True:
if offset > MAX_OFFSET:
raise ApiError(f"카페24 조회 건수가 너무 많습니다({params.get('start_date')}~{params.get('end_date')}). "
"기간을 줄여 다시 시도하세요.")
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
rows = self._get(ctx, path, {**params, "limit": limit, "offset": offset}).get(key) or []
yield from rows
if len(rows) < limit:
return
offset += limit
def paid_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
for s, e in _chunks(start, end):
n = 0
for o in self._paged(ctx, "/admin/orders", "orders",
{"start_date": s.isoformat(), "end_date": e.isoformat(),
"date_type": "pay_date", "embed": "items"}, ORDER_LIMIT):
n += 1
yield o
ctx.progress.step(items=n)
def refunds(self, ctx: AdapterContext, start: date, end: date,
date_type: str = "refund_date") -> Iterable[dict[str, Any]]:
"""환불 목록. date_type: refund_date(환불완료일, 기본) / accepted_refund_date(환불접수일)."""
for s, e in _chunks(start, end):
n = 0
for r in self._paged(ctx, "/admin/refunds", "refunds",
{"start_date": s.isoformat(), "end_date": e.isoformat(),
"date_type": date_type}, REFUND_LIMIT):
n += 1
yield r
ctx.progress.step(items=n)
def claim_items(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
"""그날 취소완료·반품완료·교환완료된 주문의 클레임 품목(대조 전용). 환불 API 에 안 잡히는 건
(네이버페이 취소 등)을 찾기 위한 것. 조회 실패는 errors 에 담고 계속한다. 개인정보 제외."""
items: list[dict[str, Any]] = []
errors: list[str] = []
seen: set[str] = set()
full_cancel_shipping = 0
for date_type, label in CLAIM_DATE_TYPES:
try:
orders = list(self._paged(ctx, "/admin/orders", "orders",
{"start_date": day.isoformat(), "end_date": day.isoformat(),
"date_type": date_type, "embed": "items"}, ORDER_LIMIT))
except ApiError as exc:
errors.append(f"{label}: {exc}")
continue
for o in orders:
oid = str(o.get("order_id") or "")
its = o.get("items") or []
claimed = [i for i in its if str(i.get("order_status") or "")[:1] in ("C", "R", "E")
and str(i.get("order_status") or "") not in UNPAID_CANCEL]
if claimed and len(claimed) == len(its) and oid not in seen and \
all(str(i.get("order_status") or "") in CLAIM_DONE and str(i.get("order_status"))[:1] == "C" for i in its):
full_cancel_shipping += order_amounts(o)["shipping_fee"]
for i in claimed:
key = str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}")
if key in seen:
continue
seen.add(key)
status = str(i.get("order_status") or "")
qty = int(i.get("quantity") or 0)
items.append({
"via": label, "order_id": oid, "item_code": key,
"channel": str(o.get("order_place_name") or o.get("market_id") or ""),
"paid": o.get("paid") == "T", "pay_date": str(o.get("payment_date") or "")[:10],
"status": status, "status_text": str(i.get("status_text") or ""),
"done": status in CLAIM_DONE,
"claim_code": str(i.get("claim_code") or ""),
"product_name": str(i.get("product_name") or "")[:40], "quantity": qty,
"product_amount": (_won(i.get("product_price")) + _won(i.get("option_price"))) * qty,
"payment_amount": _won(i.get("payment_amount")),
"coupon": _won(i.get("coupon_discount_price")),
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
"cancel_date": str(i.get("cancel_date") or "")[:16],
"refund_date": str(i.get("refund_date") or "")[:16],
"return_confirmed_date": str(i.get("return_confirmed_date") or "")[:16],
})
seen.add(oid)
return {"items": items, "errors": errors, "full_cancel_shipping": full_cancel_shipping}
def unrefunded_claims(self, ctx: AdapterContext, start: date, end: date) -> list[dict[str, Any]]:
"""환불 목록에 기록이 없는 네이버페이 취소·반품 완료 품목. 날짜 = 품목 취소일(반품은 반품완료일).
금액 = 판매가(+옵션)×수량 − 품목 할인·쿠폰. 주문 전체가 취소·반품되면 배송비(− 배송비 할인·쿠폰)도 환불로
보고 그 주문의 마지막 클레임 품목에 한 번 더한다. 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 있으면
제외해 환불 목록 쪽과 두 번 빼지 않는다.
카페24 일별 매출 환불합계와 대조한 결과(2026-09): 네이버페이만 센다 — 톡체크아웃(KAKAOPAY)·자체몰의
환불 기록 없는 취소는 넣지 않는다(9/16 톡체크아웃 취소 9,900 제외, 9/4 네이버페이 전체취소 배송비 3,500 포함)."""
from app.timezone import today_kst # noqa: WPS433
found: dict[str, dict[str, Any]] = {}
for date_type in NO_RECORD_DATE_TYPES:
for s, e in _chunks(start, end):
scanned = 0
for o in self._paged(ctx, "/admin/orders", "orders",
{"start_date": s.isoformat(), "end_date": e.isoformat(),
"date_type": date_type, "embed": "items"}, ORDER_LIMIT):
scanned += 1
if NO_RECORD_CHANNEL not in (_key(o.get("market_id")), _key(o.get("order_place_id"))):
continue
oid = str(o.get("order_id") or "")
its = o.get("items") or []
claimed: list[tuple[date, str, dict[str, Any]]] = []
for i in its:
status = str(i.get("order_status") or "")
if status not in NO_RECORD_DONE:
continue
keys = (("cancel_date", "refund_date", "return_confirmed_date") if status[:1] == "C"
else ("return_confirmed_date", "refund_date", "cancel_date"))
day = next((d for d in (_day(i.get(k)) for k in keys) if d), None)
if day is not None:
claimed.append((day, str(i.get("order_item_code") or f"{oid}-{i.get('item_no')}"), i))
if not claimed:
continue
all_claimed = len(claimed) == len(its)
w = order_amounts(o)
ship = max(0, w["shipping_fee"] - w["coupon_shipping_fee_amount"] - w["shipping_fee_discount_amount"])
last = max((d, k) for d, k, _ in claimed)
for day, key, i in claimed:
if not (start <= day <= end):
continue
status = str(i.get("order_status") or "")
qty = int(i.get("quantity") or 0)
amount = max(0, (_won(i.get("product_price")) + _won(i.get("option_price"))) * qty
- _won(i.get("additional_discount_price")) - _won(i.get("coupon_discount_price"))
- _won(i.get("app_item_discount_amount")))
ship_refund = ship if all_claimed and (day, key) == last else 0
found[key] = {
"order_id": oid, "item_code": key, "status": status, "day": day,
"market_id": o.get("market_id"), "place_id": o.get("order_place_id"),
"place_name": o.get("order_place_name"), "order_date": _day(o.get("order_date")),
"quantity": qty, "amount": amount + ship_refund, "shipping_refund": ship_refund,
"product_name": str(i.get("product_name") or "")[:40],
"naver_pay_claim_status": str(i.get("naver_pay_claim_status") or ""),
# 대조용 — 주문 전체가 취소·반품됐는지, 그 주문 배송비
"order_all_claimed": all_claimed, "order_shipping_fee": w["shipping_fee"],
"item_payment_amount": _won(i.get("payment_amount")),
"coupon": _won(i.get("coupon_discount_price")),
}
ctx.progress.step(items=scanned)
if not found:
return []
lo = start - timedelta(days=REFUND_LOOKAROUND_DAYS)
hi = max(end, min(end + timedelta(days=REFUND_LOOKAROUND_DAYS), today_kst()))
ctx.progress.add(2 * len(list(_chunks(lo, hi)))) # 환불 목록 대조(완료일·접수일) — 찾은 게 있을 때만
refunded = {str(r.get("order_id") or "") for dt in ("refund_date", "accepted_refund_date")
for r in self.refunds(ctx, lo, hi, dt)}
return [c for c in found.values() if c["order_id"] not in refunded]
def market_ids(self, ctx: AdapterContext, refunds: list[dict[str, Any]]) -> dict[str, tuple[Any, Any, Any]]:
"""환불의 원 주문 (market_id, order_place_id, order_place_name) — 주문일 60일 구간·100건씩 묶어 조회.
못 찾으면 자체몰."""
pairs = sorted({(_day(r.get("order_date")) or date.min, str(r.get("order_id") or ""))
for r in refunds if r.get("order_id")})
out: dict[str, Any] = {}
i = 0
while i < len(pairs):
first = pairs[i][0]
group = [p for p in pairs[i:i + LOOKUP_BATCH] if (p[0] - first).days < CHUNK_DAYS]
ids = [oid for _, oid in group]
if first != date.min:
params = {"order_id": ",".join(ids), "start_date": first.isoformat(),
"end_date": group[-1][0].isoformat(), "date_type": "order_date", "limit": LOOKUP_BATCH}
for o in self._get(ctx, "/admin/orders", params).get("orders") or []:
out[str(o.get("order_id"))] = (o.get("market_id"), o.get("order_place_id"), o.get("order_place_name"))
i += len(group)
return out
# ── 수집(어댑터 공통 흐름) ──────────────────────────────
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
# 진행 막대: 60일 구간마다 결제 주문 1 + 환불 1 + 환불 없는 취소·반품(취소일·반품완료일) 2
c = len(list(_chunks(start, end)))
ctx.progress.plan(c * (2 + len(NO_RECORD_DATE_TYPES)), "구간")
yield from self.paid_orders(ctx, start, end)
def fetch_refunds(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
rows = [r for r in self.refunds(ctx, start, end) if str(r.get("status") or "T") == "T"]
markets = self.market_ids(ctx, rows)
for r in rows:
mid, place, _name = markets.get(str(r.get("order_id")), ("self", None, None))
yield {**r, "_market_id": mid, "_order_place_id": place}
for c in self.unrefunded_claims(ctx, start, end):
yield {**c, "_kind": "claim"}
def normalize_order(self, order: dict[str, Any]) -> list[SaleEvent]:
"""결제 주문 → SALE. 자체몰은 카페24 열, 마켓 연동 주문은 해당 쇼핑몰 열(MARKET_MAP)."""
if order.get("paid") != "T":
return []
pay_day = _day(order.get("payment_date"))
if pay_day is None:
return []
items = order.get("items") or []
names = [str(i.get("product_name") or "") for i in items if i.get("product_name")]
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
oid = str(order.get("order_id") or "")
target = target_code(order.get("market_id"), order.get("order_place_id"))
return [SaleEvent(
marketplace_code=target,
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}-PAY", external_order_id=oid,
order_date=_day(order.get("order_date")), payment_date=pay_day, event_date=pay_day,
amount=max(0, order_total(order)), product_name=name,
quantity=sum(int(i.get("quantity") or 0) for i in items), order_status="결제완료",
discount_amount=sum(order_amounts(order)[k] for k in DISCOUNT_FIELDS + COUPON_FIELDS),
raw={"order_id": oid, "market_id": order.get("market_id"), "order_place_id": order.get("order_place_id"),
"items": len(items), **{f"initial_{k}": v for k, v in order_amounts(order).items()}},
)]
def normalize_refund(self, refund: dict[str, Any]) -> list[SaleEvent]:
"""환불 → CANCEL/RETURN(−). 원 주문의 market_id 로 결제와 같은 쇼핑몰 열에 넣는다.
금액 = 실제 환불액 + 적립금·예치금 환불(카페24 일별 매출 환불합계와 같음, 실데이터 확인)."""
if refund.get("_kind") == "claim":
return self.normalize_claim(refund)
day = _day(refund.get("refund_date"))
code = str(refund.get("refund_code") or "")
if day is None or not code:
return []
amount = refund_total(refund)
return [SaleEvent(
marketplace_code=target_code(refund.get("_market_id"), refund.get("_order_place_id")),
event_type="RETURN" if code.upper().startswith("R") else "CANCEL",
external_event_id=f"{EVENT_PREFIX}{code}", external_order_id=str(refund.get("order_id") or ""),
external_line_id=",".join(refund.get("order_item_code") or []),
order_date=_day(refund.get("order_date")), event_date=day, amount=-amount,
quantity=-int(refund.get("quantity") or 0), order_status="환불완료",
raw={"refund_code": code, "order_id": refund.get("order_id"), "status": refund.get("status"),
"actual_refund_amount": refund.get("actual_refund_amount"),
"used_points": refund.get("used_points"), "used_credits": refund.get("used_credits"),
"quantity": refund.get("quantity"), "order_item_code": refund.get("order_item_code")},
)]
def normalize_claim(self, c: dict[str, Any]) -> list[SaleEvent]:
"""환불 목록에 없는 취소·반품 품목(네이버페이 등) → CANCEL/RETURN(−), 취소일(반품완료일)."""
if not c.get("amount") or c.get("day") is None:
return []
is_return = str(c.get("status"))[:1] == "R"
return [SaleEvent(
marketplace_code=target_code(c.get("market_id"), c.get("place_id")),
event_type="RETURN" if is_return else "CANCEL",
external_event_id=f"{EVENT_PREFIX}{c['item_code']}-CL", external_order_id=str(c.get("order_id") or ""),
external_line_id=str(c["item_code"]), order_date=c.get("order_date"), event_date=c["day"],
amount=-int(c["amount"]), quantity=-int(c.get("quantity") or 0), product_name=c.get("product_name") or "",
order_status="반품완료" if is_return else "취소완료",
raw={"order_id": c.get("order_id"), "item_code": c["item_code"], "status": c.get("status"),
"market_id": c.get("market_id"), "naver_pay_claim_status": c.get("naver_pay_claim_status"),
"no_refund_record": True},
)]
# ── 대조(설정 화면 "카페24 매출 대조") ─────────────────
def reconcile(self, ctx: AdapterContext, day: date) -> dict[str, Any]:
"""그날 결제 주문·환불을 항목별로 합산 — 카페24 일별 매출내역과 비교해 규칙을 확정하는 용도.
groups["self"] = 카페24 열(자체몰 채널 + 알 수 없는 채널), groups["market"] = 다른 쇼핑몰 열로 가는
외부 마켓 주문. by_channel = 주문 채널(market_id)별 내역. 개인정보는 담지 않는다.
"""
self.authenticate(ctx)
def empty() -> dict[str, int]:
return {"orders": 0, "items": 0, "lines": 0, **{k: 0 for k in AMOUNT_FIELDS},
"naver_point": 0, "goods_total": 0, "total": 0}
def channel(mid: Any, place: Any, place_name: Any = None) -> dict[str, Any]:
"""(market_id, 주문경로) 한 쌍 = 한 줄. self 안에도 PC쇼핑몰·모바일웹 경로가 섞여 있어 나눠 본다."""
mkey = "" if mid is None else str(mid)
pname = str(place_name or place or "")
kind = channel_kind(mid, place)
return by_channel.setdefault((mkey, pname), {
"market_id": mkey or "(없음)", "place": pname, "place_id": str(place or ""),
"label": SELF_CHANNELS.get(_key(mid), ""), "names": set(),
"kind": kind, "target": target_code(mid, place),
"orders": 0, "total": 0, "refund_count": 0, "refund_amount": 0,
# 기기 — 주문의 order_from_mobile(T=모바일에서 주문). PC 채널(self)에도 모바일 주문이 섞여 있다.
"pc_orders": 0, "pc_total": 0, "mobile_orders": 0, "mobile_total": 0,
})
groups = {"self": empty(), "market": empty()}
by_channel: dict[str, dict[str, Any]] = {}
by_payment: dict[str, dict[str, Any]] = {} # 결제수단 조합별(카페24 열 주문만)
unpaid = 0
paid_self: dict[str, int] = {} # 그날 결제된 카페24 열 주문 → (결제 당시 − 현재) 금액
reduced: dict[str, dict[str, Any]] = {} # 그중 금액이 줄어든 주문(취소·반품) — 환불 기록과 대조
# 진단 — 어떤 원본 필드가 카페24 화면 열과 맞는지 찾는 용도(결제 주문 전체, 개인정보 제외)
diag = {"order": {}, "initial": {}, "actual": {}, "item": {}}
odd: list[dict[str, Any]] = [] # 판매가×수량 합이 주문 상품금액과 다르거나 100원 단위가 아닌 주문
for o in self.paid_orders(ctx, day, day):
if o.get("paid") != "T":
unpaid += 1
continue
for part, src in (("order", {k: v for k, v in o.items() if not isinstance(v, (dict, list))}),
("initial", o.get("initial_order_amount")), ("actual", o.get("actual_order_amount"))):
for k, v in money_fields(src).items():
diag[part][k] = diag[part].get(k, 0) + v
its = o.get("items") or []
for i in its:
for k, v in money_fields(i).items():
diag["item"][k] = diag["item"].get(k, 0) + v
gross = sum((_won(i.get("product_price")) + _won(i.get("option_price"))) * int(i.get("quantity") or 0) for i in its)
opa = order_amounts(o)["order_price_amount"]
if (gross != opa or opa % 100) and len(odd) < 60:
odd.append({"order_id": str(o.get("order_id") or ""),
"channel": str(o.get("order_place_name") or o.get("market_id") or ""),
"order_price_amount": opa, "items_gross": gross, "total": order_total(o),
"items": [{"code": str(i.get("order_item_code") or ""), "status": str(i.get("order_status") or ""),
"quantity": int(i.get("quantity") or 0),
"fields": {k: v for k, v in money_fields(i).items() if v}} for i in its]})
ch = channel(o.get("market_id"), o.get("order_place_id"), o.get("order_place_name"))
total = order_total(o)
ch["orders"] += 1
ch["total"] += total
dev = "mobile" if str(o.get("order_from_mobile") or "").upper() == "T" else "pc"
ch[f"{dev}_orders"] += 1
ch[f"{dev}_total"] += total
if ch["target"] == "cafe24":
names = [str(n) for n in (o.get("payment_method_name") or o.get("payment_method") or []) if n]
pkey = " + ".join(names) or "(없음)"
pm = by_payment.setdefault(pkey, {"method": pkey, "orders": 0, "total": 0})
pm["orders"] += 1
pm["total"] += total
for n in (o.get("order_place_name"), o.get("order_place_id")):
if n:
ch["names"].add(str(n))
g = groups["self" if ch["target"] == "cafe24" else "market"]
g["orders"] += 1
g["items"] += sum(int(i.get("quantity") or 0) for i in o.get("items") or [])
g["lines"] += len(o.get("items") or [])
for k, v in order_amounts(o).items():
g[k] += v
g["goods_total"] += goods_total(order_amounts(o))
g["total"] += order_total(o)
if ch["target"] == "cafe24":
oid_ = str(o.get("order_id") or "")
paid_self[oid_] = order_total(o) - order_total_now(o)
if paid_self[oid_] > 0:
reduced[oid_] = {
"order_id": oid_, "channel": str(o.get("order_place_name") or o.get("market_id") or ""),
"payment": " + ".join(str(n) for n in (o.get("payment_method_name") or []) if n),
"initial": order_total(o), "now": order_total_now(o), "diff": paid_self[oid_],
"statuses": sorted({f"{i.get('order_status') or ''} {i.get('status_text') or ''}".strip()
for i in o.get("items") or []}),
"naver_pay": sorted({str(i.get("naver_pay_claim_status")) for i in o.get("items") or []
if i.get("naver_pay_claim_status")}),
"claim_dates": sorted({str(i.get(k))[:10] for i in o.get("items") or []
for k in ("cancel_date", "refund_date", "return_confirmed_date")
if i.get(k)}),
"refunded": 0, "refund_dates": [],
}
rows = [r for r in self.refunds(ctx, day, day) if str(r.get("status") or "T") == "T"]
markets = self.market_ids(ctx, rows)
refunds = {k: {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0,
"no_record_count": 0, "no_record": 0, "total": 0} for k in ("self", "market")}
for r in rows:
mid, place, place_name = markets.get(str(r.get("order_id")), ("self", None, None))
ch = channel(mid, place, place_name)
g = refunds["self" if ch["target"] == "cafe24" else "market"]
g["count"] += 1
for k in ("actual_refund_amount", "used_points", "used_credits"):
g[k] += _won(r.get(k))
g["total"] += refund_total(r)
ch["refund_count"] += 1
ch["refund_amount"] += refund_total(r)
no_record = self.unrefunded_claims(ctx, day, day)
for c in no_record:
ch = channel(c["market_id"], c["place_id"], c["place_name"])
g = refunds["self" if ch["target"] == "cafe24" else "market"]
g["no_record_count"] += 1
g["no_record"] += c["amount"]
g["total"] += c["amount"]
ch["refund_count"] += 1
ch["refund_amount"] += c["amount"]
channels_out = sorted(({**v, "names": sorted(v["names"])} for v in by_channel.values()),
key=lambda v: v["total"], reverse=True)
# 환불 기준 비교 — 카페24 "환불합계"가 어느 기준인지 확정하는 용도.
# 완료일(refund_date, 완료 T) vs 접수일(accepted_refund_date, 상태 T/F/M 전부)
# 각각 실제 환불액만 / 적립금·예치금 환불 포함
def rsum(items: Iterable[dict[str, Any]]) -> dict[str, int]:
out = {"count": 0, "actual_refund_amount": 0, "used_points": 0, "used_credits": 0}
for x in items:
out["count"] += 1
for k in ("actual_refund_amount", "used_points", "used_credits"):
out[k] += _won(x.get(k))
out["with_points"] = out["actual_refund_amount"] + out["used_points"] + out["used_credits"]
return out
accepted = list(self.refunds(ctx, day, day, "accepted_refund_date"))
status_names = {"T": "환불완료", "F": "환불전", "M": "환불보류"}
refund_basis = {
"completed": rsum(rows),
"accepted_all": rsum(accepted),
"accepted_by_status": [
{"status": s, "label": status_names.get(s, s or "(없음)"),
**rsum(x for x in accepted if str(x.get("status") or "") == s)}
for s in sorted({str(x.get("status") or "") for x in accepted})
],
}
# 환불 건별 목록(완료일 기준 + 접수일 기준, 환불코드로 합침) — 개인정보(이메일·계좌) 제외
extra = markets | self.market_ids(ctx, [a for a in accepted if str(a.get("order_id")) not in markets])
refund_list: dict[str, dict[str, Any]] = {}
for basis, items in (("completed", rows), ("accepted", accepted)):
for x in items:
code = str(x.get("refund_code") or "")
mid, place, place_name = extra.get(str(x.get("order_id")), ("self", None, None))
e = refund_list.setdefault(code, {
"refund_code": code, "order_id": str(x.get("order_id") or ""),
"channel": str(place_name or mid or ""), "status": str(x.get("status") or ""),
"accepted_date": str(x.get("accepted_refund_date") or "")[:16].replace("T", " "),
"refund_date": str(x.get("refund_date") or "")[:16].replace("T", " "),
"quantity": int(x.get("quantity") or 0),
"actual_refund_amount": _won(x.get("actual_refund_amount")),
"used_points": _won(x.get("used_points")), "used_credits": _won(x.get("used_credits")),
"cancel_fee_amount": _won(x.get("cancel_fee_amount")),
"methods": [str(m) for m in (x.get("refund_methods") or []) if m],
"in_completed": False, "in_accepted": False,
})
e["in_" + basis] = True
claims = self.claim_items(ctx, day)
refunded_orders = {r["order_id"] for r in refund_list.values()}
for c in claims["items"]:
c["has_refund"] = c["order_id"] in refunded_orders
def csum(pred) -> dict[str, int]:
sel = [c for c in claims["items"] if c["done"] and pred(c)]
return {"count": len(sel), "payment_amount": sum(c["payment_amount"] for c in sel),
"product_amount": sum(c["product_amount"] for c in sel)}
# 결제일 기준 — 그날 결제된 주문이 그 뒤(오늘까지) 환불된 금액. 카페24 일별 매출이 환불을 원 주문 결제일에
# 빼는지 확인하는 용도(최근일만 맞고 지난 날일수록 차이가 커지는 현상).
from app.timezone import today_kst # noqa: WPS433
later = [x for x in self.refunds(ctx, day, max(day, today_kst()))
if str(x.get("order_id") or "") in paid_self and str(x.get("status") or "T") == "T"]
by_pay = rsum(later)
by_pay["amount_diff"] = sum(v for v in paid_self.values() if v > 0)
by_pay["refund_dates"] = sorted({str(x.get("refund_date") or "")[:10] for x in later})
refund_basis["by_pay_date"] = by_pay
for x in later:
r_ = reduced.get(str(x.get("order_id") or ""))
if r_ is not None:
r_["refunded"] += _won(x.get("actual_refund_amount")) + _won(x.get("used_points")) + _won(x.get("used_credits"))
r_["refund_dates"] = sorted({*r_["refund_dates"], str(x.get("refund_date") or "")[:10]})
comp = refund_basis["completed"]
no_refund = csum(lambda c: not c["has_refund"])
claimed = csum(lambda c: True)
# 카페24 "환불합계" 후보 — 화면 값과 같은 줄을 찾는다(화면에서 값을 입력하면 강조)
candidates = [
{"key": "applied", "label": "적용 규칙 · 환불 목록(실제 + 적립금·예치금) + 환불 목록 없는 취소·반품(네이버페이 등)",
"amount": refunds["self"]["total"] + refunds["market"]["total"]},
{"key": "completed", "label": "환불완료일 · 실제 환불액 (이전 규칙)", "amount": comp["actual_refund_amount"]},
{"key": "completed_pts", "label": "환불완료일 · 실제 환불액 + 적립금·예치금", "amount": comp["with_points"]},
{"key": "pay_date", "label": "결제일 기준 · 그날 결제 주문의 환불(오늘까지) · 실제 환불액",
"amount": by_pay["actual_refund_amount"]},
{"key": "pay_date_pts", "label": "결제일 기준 · 그날 결제 주문의 환불(오늘까지) · 실제 + 적립금·예치금",
"amount": by_pay["with_points"]},
{"key": "pay_date_diff", "label": "결제일 기준 · 그날 결제 주문의 (결제 당시 금액 − 현재 금액)",
"amount": by_pay["amount_diff"]},
{"key": "accepted", "label": "환불접수일(전체 상태) · 실제 환불액", "amount": refund_basis["accepted_all"]["actual_refund_amount"]},
{"key": "accepted_pts", "label": "환불접수일(전체 상태) · 실제 + 적립금·예치금", "amount": refund_basis["accepted_all"]["with_points"]},
{"key": "claim_pay", "label": "취소·반품·교환 완료 품목 · 품목 결제금액", "amount": claimed["payment_amount"]},
{"key": "claim_prod", "label": "취소·반품·교환 완료 품목 · 판매가(+옵션)×수량", "amount": claimed["product_amount"]},
{"key": "claim_pay_ship", "label": "완료 품목 결제금액 + 전체취소 주문 배송비",
"amount": claimed["payment_amount"] + claims["full_cancel_shipping"]},
{"key": "completed_plus_noref", "label": "환불완료 실제 환불액 + 환불 기록 없는 완료 품목 결제금액",
"amount": comp["actual_refund_amount"] + no_refund["payment_amount"]},
{"key": "completed_pts_plus_noref", "label": "환불완료 (실제+적립금) + 환불 기록 없는 완료 품목 결제금액",
"amount": comp["with_points"] + no_refund["payment_amount"]},
]
return {"date": day.isoformat(), "orders": groups, "refunds": refunds, "unpaid_orders": unpaid,
"by_channel": channels_out, "refund_basis": refund_basis,
"refund_list": sorted(refund_list.values(), key=lambda r: r["refund_code"]),
"claims": claims, "refund_candidates": candidates,
"no_record_claims": [{**c, "day": c["day"].isoformat(),
"order_date": c["order_date"].isoformat() if c["order_date"] else None}
for c in no_record],
"reduced_orders": sorted(reduced.values(), key=lambda r: r["diff"] - r["refunded"], reverse=True),
"by_payment": sorted(by_payment.values(), key=lambda v: v["total"], reverse=True),
"diag": {part: dict(sorted(v.items())) for part, v in diag.items()}, "odd_orders": odd,
"formula": "결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트(결제 당시). 참고식 = 상품구매금액 + 배송비 − 할인("
+ ", ".join(DISCOUNT_FIELDS) + ") − 쿠폰(" + ", ".join(COUPON_FIELDS) + ")"}
+112
View File
@@ -0,0 +1,112 @@
"""쿠팡 — 쿠팡 윙(마켓플레이스) Open API.
인증: Vendor ID + Access Key + Secret Key 로 요청마다 HMAC 서명(CEA 헤더).
signed-date = UTC "yyMMddTHHmmssZ", message = signed-date + METHOD + path + query(물음표 없이, 보내는 그대로)
Authorization: CEA algorithm=HmacSHA256, access-key=…, signed-date=…, signature=hex(HMAC-SHA256(secret, message))
(공식 문서 developers.coupangcorp.com → 시작하기 → HMAC Signature 생성 / Python Example, 2026-09-30 확인)
OPEN API 키는 판매자당 1개(유효기간 180일). 발급 방식이 둘 —
· 연동업체 선택(사방넷 등 1곳만): 그 업체 서버에서 쓰는 키. 우리 서버에서 부르면 막힐 수 있다.
· 자체개발: 업체명·URL·허용 IP(최대 10개). 우리 서버 IP 를 넣어야 한다.
연결 테스트는 오늘 결제완료 발주서 1건을 실제로 조회해 키·IP 가 통하는지 확인한다.
매출 수집(fetch_orders)은 아직 — 어느 WING 화면과 맞출지 정한 뒤 구현한다.
· 발주서 목록(v5 ordersheets, 주문일 기준, 상태별 조회) + 반품/취소 요청(v6 returnRequests, 접수일 기준, 금액 없음)
· 매출내역(v1 revenue-history)은 매출인식일(구매확정 또는 배송완료+7일) 기준이라 결제일 기준 일별 매출과 다르다.
로켓(공급) 매출은 기존 쿠팡 밀크런 모듈의 cupang_sales 에 있다 — 필요 시 별도 연계.
"""
from __future__ import annotations
import hashlib
import hmac
import time
from typing import Any
from urllib.parse import quote, urlencode
from .base import (
AdapterContext,
ApiError,
AuthFailed,
CredentialField,
MarketplaceAdapter,
NotConfigured,
)
HOST = "https://api-gateway.coupang.com"
def signed_date(now: float | None = None) -> str:
return time.strftime("%y%m%dT%H%M%SZ", time.gmtime(now))
def authorization(method: str, path: str, query: str, access_key: str, secret_key: str,
*, now: float | None = None) -> str:
"""쿠팡 CEA HMAC 헤더. query 는 실제로 보내는 문자열 그대로(물음표 제외)."""
dt = signed_date(now)
sig = hmac.new(secret_key.encode("utf-8"), f"{dt}{method}{path}{query}".encode("utf-8"),
hashlib.sha256).hexdigest()
return f"CEA algorithm=HmacSHA256, access-key={access_key}, signed-date={dt}, signature={sig}"
def build_query(params: dict[str, Any]) -> str:
"""쿠팡 예시와 같은 인코딩 — '+' 는 %2B, ':' 는 그대로(2026-09-30%2B09:00)."""
return urlencode({k: v for k, v in params.items() if v is not None}, quote_via=quote, safe=":")
class CoupangAdapter(MarketplaceAdapter):
code = "coupang"
name = "쿠팡"
auth_type = "api_key"
docs_url = "https://developers.coupangcorp.com/"
note = ("쿠팡 윙 → 판매자정보 → 추가판매정보 → OPEN API 키 발급에서 확인합니다. 키는 판매자당 1개이며, "
"'연동업체(사방넷 등)'로 발급한 키는 이 서버에서 막힐 수 있습니다 — 그때는 '자체개발'로 바꾸고 "
"이 서버 IP 를 허용 IP 에 넣어야 합니다(연결 테스트로 확인).")
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("vendor_id", "Vendor ID(업체코드)", placeholder="A00012345"),
CredentialField("access_key", "Access Key", secret=True),
CredentialField("secret_key", "Secret Key", secret=True),
]
# ── 호출 ──────────────────────────────────────────────
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
import httpx # 지연 import
access, secret = ctx.credentials.get("access_key").strip(), ctx.credentials.get("secret_key").strip()
if not (access and secret):
raise NotConfigured("쿠팡 Vendor ID·Access Key·Secret Key 를 모두 입력하세요.")
query = build_query(params)
headers = {"Authorization": authorization("GET", path, query, access, secret),
"Content-Type": "application/json;charset=UTF-8"}
try:
res = httpx.get(f"{HOST}{path}?{query}", headers=headers, timeout=ctx.timeout_sec)
except httpx.HTTPError as exc:
raise ApiError(f"쿠팡 API 연결 실패: {type(exc).__name__}") from None
try:
body = res.json()
except ValueError:
body = {}
msg = str(body.get("message") or body.get("error") or res.text[:200] or "").strip()
if res.status_code in (401, 403):
raise AuthFailed(
f"쿠팡 인증 거부({res.status_code}): {msg}. Vendor ID·키가 맞는지 확인하세요. 키를 '연동업체(사방넷 등)'로 "
"발급했다면 이 서버에서 쓸 수 없을 수 있습니다 — WING 에서 '자체개발'로 바꾸고 이 서버 IP 를 허용 IP 에 "
"넣어야 합니다(사방넷 IP 도 함께 넣어야 사방넷이 계속 동작).")
if res.status_code >= 400:
raise ApiError(f"쿠팡 API 오류({res.status_code}): {msg}")
return body
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
self.authenticate(ctx)
vendor = ctx.credentials.get("vendor_id").strip()
today = today_kst().isoformat()
body = self._get(ctx, f"/v2/providers/openapi/apis/api/v5/vendors/{vendor}/ordersheets",
{"createdAtFrom": f"{today}+09:00", "createdAtTo": f"{today}+09:00",
"status": "ACCEPT", "maxPerPage": 1})
n = len(body.get("data") or [])
return (f"쿠팡 연결 정상(발주서 조회 권한 확인, 오늘 결제완료 {'있음' if n else '없음'}). "
"매출 수집은 다음 단계에서 구현됩니다.")
@@ -0,0 +1,329 @@
"""11번가 — 11번가 셀러 오픈API.
인증: 셀러오피스(openapi.11st.co.kr → 서비스등록·확인)에서 발급한 Open API Key 를 요청 헤더 `openapikey` 에 넣는다.
셀러 API 는 등록한 IP 에서만 호출된다("Seller API 정보 수정"에서 서버 IP 등록, 셀링툴(사방넷 등)과 함께 쓸 수 있음).
(공식 이용방법 openapi.11st.co.kr → OpenApiOperationGuide SERVICE_METHOD, 2026-09-30 확인)
응답은 XML(euc-kr). 없는 주소는 500 + resultCode -997 "등록된 API 정보가 존재하지 않습니다", 건이 없으면 -1 "해당 건이 없습니다".
매출(2026-09-30 실데이터·셀러오피스 "판매 상세내역"으로 확정):
- SALE = 주문 하나(`11st:{ordNo}`), 날짜 = 결제일.
- 정산된 주문: 정산 내역(/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}, 정산확정일 stlDy 기준)의
판매금액합계(selPrcAmt) 합 — 판매 상세내역과 같고 배송비(도서산간 등)가 별도 줄로 들어 있다.
예: 9/10 주문 = 83,800 + 배송비 줄 3,000 = 86,800 (주문 목록의 dlvCst 는 0 이라 주문 목록만으로는 모자람).
- 정산 전 주문: 주문 상태 목록 4개(결제완료·발송대기·배송중·배송완료 — 지금 그 상태인 주문만, 배송완료에 구매확정 주문도
남음)의 ordAmt(판매금액, 11번가 부담 쿠폰 전) + 배송비(dlvCst 최댓값 한 번). 정산되면 다음 업데이트 때 정산 값으로 바뀐다.
- ordAmt − ordPayAmt = 11번가 부담 할인(= 정산 cupnAmt/tmallApplyDscAmt). 수수료는 판매금액 기준(34,900 × 13% = 4,537).
- 취소·반품된 주문은 목록에서 빠진다 → 기간을 통째로 다시 받아(replace_range) 매출에서 빠진다(취소 사건을 따로 만들지 않음).
"""
from __future__ import annotations
import re
import xml.etree.ElementTree as ET
from datetime import date, timedelta
from typing import Any, Iterable
from .base import (
AdapterContext,
AdapterError,
ApiError,
AuthFailed,
CredentialField,
MarketplaceAdapter,
SaleEvent,
)
HOST = "https://api.11st.co.kr"
def _xml_text(content: bytes) -> str:
"""11번가 XML 은 euc-kr 선언이 많다 — 파이썬 XML 파서가 다바이트 인코딩 선언을 못 읽어 직접 풀고 선언을 뗀다."""
head = content[:200].decode("ascii", "ignore")
m = re.search(r"encoding=[\"']([\w-]+)", head)
enc = (m.group(1) if m else "utf-8").lower()
try:
text = content.decode("cp949" if enc in ("euc-kr", "euckr", "ks_c_5601-1987") else enc)
except (LookupError, UnicodeDecodeError):
text = content.decode("utf-8", "replace")
return re.sub(r"^\s*<\?xml[^>]*\?>", "", text)
def xml_result(content: bytes) -> tuple[str, str, int]:
"""(결과코드, 결과문구, 주문 수). 네임스페이스와 무관하게 태그 끝 이름으로 찾는다. XML 이 아니면 코드 "not-xml"."""
try:
root = ET.fromstring(_xml_text(content))
except ET.ParseError:
return "not-xml", "", 0
if root.tag.rsplit("}", 1)[-1].lower() == "html": # 오류 안내 웹페이지(IP 차단 등)
return "not-xml", "", 0
code = text = ""
orders = 0
for el in root.iter():
tag = el.tag.rsplit("}", 1)[-1].lower()
if tag in ("result_code", "resultcode") and not code:
code = (el.text or "").strip()
elif tag in ("result_text", "resulttext", "result_message", "message") and not text:
text = (el.text or "").strip()
elif tag == "order":
orders += 1
return code, text, orders
# 원본 데이터 확인용 후보 주소 — {s}/{e} = yyyyMMddHHmm, {d} = yyyyMMdd. 문서 미확인 경로가 섞여 있어
# 404 등 실패도 그대로 보여 준다(어느 주소가 살아 있는지 확인하는 것이 목적).
PROBE_PATHS: tuple[tuple[str, str, str], ...] = (
("complete", "결제완료(발주확인 전)", "/rest/ordservices/complete/{s}/{e}"),
("packaging", "발송처리 대상(발주확인 후)", "/rest/ordservices/packaging/{s}/{e}"),
("shipping", "배송중", "/rest/ordservices/shipping/{s}/{e}"),
("completed", "배송완료", "/rest/ordservices/completed/{s}/{e}"),
("cancelorders", "취소신청", "/rest/claimservice/cancelorders/{s}/{e}"),
("canceledorders", "취소완료", "/rest/claimservice/canceledorders/{s}/{e}"),
("returnorders", "반품신청", "/rest/claimservice/returnorders/{s}/{e}"),
("returnedorders", "반품완료", "/rest/claimservice/returnedorders/{s}/{e}"),
("purchaseconfirm", "구매확정(후보)", "/rest/ordservices/purchaseconfirm/{s}/{e}"),
("settlement", "정산 내역", "/rest/settlement/settlementList/{ds}/{de}"),
)
NO_DATA = re.compile(r"해당\s*건이\s*없|조회된?\s*(내역|건|데이터)이?\s*없") # 코드 -1 이어도 "0건"
PROBE_CHUNK_DAYS = 7
PROBE_MAX_DAYS = 31
# 개인정보로 보이는 항목 — 값은 보이지 않고 이름만(이름·연락처·주소·우편번호·아이디·메일·메모)
PERSONAL = re.compile(r"(nm|name|tel|tlphn|phone|hp|addr|zip|mail|id|memo|msg|pcc|clearance|birth)$|rcvr|ordnm|buyer",
re.IGNORECASE)
NUMBER = re.compile(r"^-?\d+(\.\d+)?$")
SAFE = re.compile(r"^(prd|opt|slct|dlvEtprs|dlvMthd|clm|reason|stl|sel)", re.IGNORECASE) # 상품·옵션·클레임 사유 등은 보임
def xml_records(content: bytes) -> list[dict[str, str]]:
"""응답에서 주문(또는 클레임·정산) 한 줄씩 — 자식이 모두 글자 항목인 요소를 한 줄로 본다(태그 끝 이름 → 값)."""
try:
root = ET.fromstring(_xml_text(content))
except ET.ParseError:
return []
out: list[dict[str, str]] = []
for el in root.iter():
kids = list(el)
if len(kids) >= 3 and all(len(k) == 0 for k in kids):
out.append({k.tag.rsplit("}", 1)[-1]: (k.text or "").strip() for k in kids})
return out
def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]:
"""항목별: 채워진 줄 수, 숫자면 합계, 개인정보 아니면 예시 값 하나."""
names: dict[str, dict[str, Any]] = {}
for r in records:
for k, v in r.items():
f = names.setdefault(k, {"name": k, "filled": 0, "numeric": True, "sum": 0.0, "sample": "",
"personal": bool(PERSONAL.search(k)) and not SAFE.match(k)})
if not v:
continue
f["filled"] += 1
if NUMBER.match(v) and f["numeric"]:
f["sum"] += float(v)
else:
f["numeric"] = False
if not f["sample"] and not f["personal"]:
f["sample"] = v[:40]
for f in names.values():
f["sum"] = int(round(f["sum"])) if f["numeric"] and f["filled"] else None
return list(names.values())
# 매출 수집 — 주문 상태 목록 4개(지금 그 상태인 주문만 준다). 배송완료 목록에는 구매확정된 주문도 남는다(실데이터 확인).
# 취소·반품된 주문은 이 목록들에서 빠진다 → 기간을 통째로 다시 받아(replace_range) 매출에서 자연히 빠지게 한다.
ORDER_PATHS = ("/rest/ordservices/complete/{s}/{e}", "/rest/ordservices/packaging/{s}/{e}",
"/rest/ordservices/shipping/{s}/{e}", "/rest/ordservices/completed/{s}/{e}")
ORDER_STATUS = {"complete": "결제완료", "packaging": "발송대기", "shipping": "배송중", "completed": "배송완료"}
# 목록의 날짜 조건이 주문일인지 상태 변경일(배송완료일 등)인지 문서로 확인 못 해, 기간 뒤로 넉넉히 더 불러
# 주문일로 거른다(나중에 배송완료된 주문도 빠지지 않게).
LOOKAHEAD_DAYS = 30
SETTLE_LOOKAHEAD_DAYS = 45 # 결제 → 정산확정(구매확정)까지 보통 1~3주
SETTLEMENT_PATH = "/rest/settlement/settlementList/{ds}/{de}"
EVENT_PREFIX = "11st:"
def _won(value: Any) -> int:
try:
return int(round(float(str(value or "0").replace(",", ""))))
except ValueError:
return 0
def _day(value: Any) -> date | None:
""""2026-09-09 15:13:16" / "2026/09/09" / "20260909" → date."""
s = re.sub(r"[^0-9]", "", str(value or ""))[:8]
if len(s) < 8:
return None
try:
return date(int(s[:4]), int(s[4:6]), int(s[6:8]))
except ValueError:
return None
def _n_chunks(lo: date, hi: date) -> int:
return max(0, ((hi - lo).days + PROBE_CHUNK_DAYS) // PROBE_CHUNK_DAYS)
class ElevenstAdapter(MarketplaceAdapter):
code = "elevenst"
name = "11번가"
auth_type = "api_key"
implemented = True
replace_range = True
event_prefix = EVENT_PREFIX
docs_url = "https://openapi.11st.co.kr/"
note = ("11번가 셀러오피스 → 오픈API 에서 발급한 키를 입력합니다. 셀러 API 는 등록한 IP 에서만 호출되므로 "
"'Seller API 정보 수정 → IP 직접 입력'에 이 서버의 외부 IP 를 넣어야 합니다.")
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("api_key", "Open API Key", secret=True),
]
# ── 수집 ──────────────────────────────────────────────
def _pages(self, ctx: AdapterContext, tmpl: str, lo: date, hi: date) -> Iterable[dict[str, str]]:
"""[lo, hi] 를 7일씩 나눠 한 주소를 부른다."""
s = lo
while s <= hi:
e = min(hi, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
ds, de = s.strftime("%Y%m%d"), e.strftime("%Y%m%d")
rows = xml_records(self._get(ctx, tmpl.format(s=f"{ds}0000", e=f"{de}2359", ds=ds, de=de)))
ctx.progress.step(items=len(rows))
yield from rows
s = e + timedelta(days=1)
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
"""결제일이 [start, end] 인 주문을 주문 단위로 합쳐 돌려준다.
1) 정산 내역 — 정산확정일 기준이라 [start, end+45일(오늘까지)] 를 불러 결제일(ordStlEndDt)로 거른다.
판매금액합계(selPrcAmt)는 셀러오피스 "판매 상세내역"과 같고 배송비 줄(도서산간 등)도 따로 들어 있다.
2) 아직 정산 전인 주문 — 주문 상태 목록 4개([start, end+30일]) 의 ordAmt + 배송비(dlvCst 최댓값 한 번).
같은 주문이 정산에 있으면 정산 값을 쓴다(정산되면 다음 업데이트 때 정산 값으로 바뀜)."""
from app.timezone import today_kst # noqa: WPS433
today = today_kst()
orders: dict[str, dict[str, Any]] = {}
def acc(oid: str, src: str, day: date) -> dict[str, Any]:
return orders.setdefault(oid, {"ordNo": oid, "_src": src, "_day": day, "amount": 0, "qty": 0,
"discount": 0, "ship": 0, "names": [], "opt": "", "raw": {}})
settle_hi = max(end, min(end + timedelta(days=SETTLE_LOOKAHEAD_DAYS), today))
hi = max(end, min(end + timedelta(days=LOOKAHEAD_DAYS), today))
# 진행 막대: 7일 구간마다 한 번 — 정산 내역 + 주문 상태 목록 4개
ctx.progress.plan(_n_chunks(start, settle_hi) + len(ORDER_PATHS) * _n_chunks(start, hi), "구간")
for r in self._pages(ctx, SETTLEMENT_PATH, start, settle_hi):
oid, day = str(r.get("ordNo") or ""), _day(r.get("ordStlEndDt"))
if not oid or day is None or not (start <= day <= end):
continue
o = acc(oid, "settlement", day)
o["amount"] += _won(r.get("selPrcAmt"))
o["qty"] += _won(r.get("ordQty"))
o["discount"] += _won(r.get("cupnAmt"))
if r.get("prdNm") and r["prdNm"] not in o["names"]:
o["names"].append(r["prdNm"])
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
for k in ("stlAmt", "selFee", "deductAmt", "bmStlDlvCst"):
o["raw"][k] = o["raw"].get(k, 0) + _won(r.get(k))
o["raw"]["stlDy"] = r.get("stlDy")
settled = set(orders)
seen: set[str] = set()
for tmpl in ORDER_PATHS:
status = ORDER_STATUS[tmpl.split("/")[3]]
for r in self._pages(ctx, tmpl, start, hi):
oid = str(r.get("ordNo") or "")
key = f"{oid}-{r.get('ordPrdSeq')}"
day = _day(r.get("ordStlEndDt") or r.get("ordDt"))
if not oid or oid in settled or key in seen or day is None or not (start <= day <= end):
continue
seen.add(key)
o = acc(oid, status, day)
o["amount"] += _won(r.get("ordAmt"))
o["ship"] = max(o["ship"], _won(r.get("dlvCst")))
o["qty"] += _won(r.get("ordQty"))
o["discount"] += max(0, _won(r.get("ordAmt")) - _won(r.get("ordPayAmt")))
if r.get("prdNm") and r["prdNm"] not in o["names"]:
o["names"].append(r["prdNm"])
o["opt"] = o["opt"] or str(r.get("slctPrdOptNm") or "")
o["raw"]["ordDt"] = r.get("ordDt")
for o in orders.values():
o["amount"] += o.pop("ship")
yield o
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
"""주문 하나 → SALE(결제일). 금액 = 정산 판매금액합계(정산 전이면 ordAmt + 배송비) — 11번가 부담 쿠폰 전 금액.
수수료가 판매금액 기준이라(34,900 × 13% = 4,537, 정산 실데이터) 판매자 매출은 할인 전 금액으로 본다."""
oid, day = str(o.get("ordNo") or ""), o.get("_day")
if not oid or day is None:
return []
names = o.get("names") or []
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
return [SaleEvent(
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0),
discount_amount=max(0, int(o.get("discount") or 0)),
order_status="정산확정" if o.get("_src") == "settlement" else str(o.get("_src") or ""),
raw={"source": o.get("_src"), **(o.get("raw") or {})},
)]
def _get(self, ctx: AdapterContext, path: str) -> bytes:
import httpx # 지연 import
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
headers = {"openapikey": ctx.credentials.get("api_key").strip(), "Accept": "application/xml"}
try:
res = httpx.get(f"{HOST}{path}", headers=headers, timeout=ctx.timeout_sec)
except httpx.HTTPError as exc:
raise ApiError(f"11번가 API 연결 실패: {type(exc).__name__} — 등록한 IP 가 이 서버 IP 인지 확인하세요.") from None
code, text, _ = xml_result(res.content)
detail = text or res.text[:200].strip()
if res.status_code in (401, 403):
raise AuthFailed(f"11번가 인증 거부({res.status_code}): {detail}. 키와 등록 IP(이 서버 외부 IP)를 확인하세요.")
if res.status_code >= 400:
raise ApiError(f"11번가 API 오류({res.status_code}): {detail}")
if code == "not-xml":
raise ApiError(f"11번가가 예상하지 못한 응답을 돌려줬습니다(XML 아님): {res.text[:120].strip()}")
if code and code not in ("0", "200", "00") and not NO_DATA.search(text):
raise ApiError(f"11번가 API 오류(코드 {code}): {detail}")
return res.content
# ── 원본 데이터 확인(설정 화면 "11번가 원본 데이터 확인") ─────────
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
"""후보 조회 주소마다 기간(day~to, 최대 31일, 7일씩 나눠)을 실제로 불러 동작 여부·줄 수·항목별 합계를 돌려준다.
셀러 API 상세 문서가 로그인 뒤에만 있어, 어느 주소·항목이 셀러오피스 화면 매출과 맞는지 실데이터로 확정하는 용도.
개인정보 항목(이름·연락처·주소·아이디 등)은 값 없이 이름만."""
self.authenticate(ctx)
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
chunks = []
s = day
while s <= to:
e = min(to, s + timedelta(days=PROBE_CHUNK_DAYS - 1))
chunks.append((s, e))
s = e + timedelta(days=1)
out = []
for key, label, tmpl in PROBE_PATHS:
row: dict[str, Any] = {"key": key, "label": label, "path": tmpl.split("/{")[0] + "/…"}
records: list[dict[str, str]] = []
error = ""
for s, e in chunks:
ds, de = s.strftime("%Y%m%d"), e.strftime("%Y%m%d")
try:
records += xml_records(self._get(ctx, tmpl.format(s=f"{ds}0000", e=f"{de}2359", ds=ds, de=de)))
except AdapterError as exc:
error = exc.message[:200]
break
if error:
out.append({**row, "ok": False, "error": error})
else:
out.append({**row, "ok": True, "count": len(records), "fields": field_summary(records)})
return {"date": day.isoformat(), "to": to.isoformat(), "probes": out}
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
self.authenticate(ctx)
d = today_kst().strftime("%Y%m%d")
body = self._get(ctx, f"/rest/ordservices/complete/{d}0000/{d}2359")
_, _, orders = xml_result(body)
return f"11번가 연결 정상(주문 조회 권한 확인, 오늘 결제완료 {orders}건)."
@@ -0,0 +1,23 @@
"""G마켓 — ESM(ESM Plus / ESM Trading API).
인증: ESM 마스터 ID + 판매자 ID + 발급 Secret Key 로 JWT 서명(연동 단계에서 확정).
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class GmarketAdapter(MarketplaceAdapter):
code = "gmarket"
name = "G마켓"
auth_type = "api_key"
docs_url = "https://etapi.gmarket.com/"
note = "ESM Plus 에서 발급한 API 인증정보를 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("master_id", "ESM 마스터 ID"),
CredentialField("seller_id", "G마켓 판매자 ID"),
CredentialField("secret_key", "Secret Key", secret=True),
]
+308
View File
@@ -0,0 +1,308 @@
"""GS샵 — GSSHOP 제휴 API(협력사 API V3, partners.gsshop.com → 제휴 API → 개발가이드).
인증(개발가이드 2026-09-30 확인): 요청 헤더
supCd = 협력사코드
token = AES256( Sysdate("yyyyMMddHHmmss") + 협력사코드 ) 예: "20181017174913" + "1036018"
AES256 암복호화 키는 partners.gsshop.com/api/apiMain 에 로그인하면 보인다.
암호화 모드(CBC/ECB, IV)와 키를 바이트로 쓰는 법은 문서에 없다 → 키 변형(글자 그대로 / 16진수 풀기 / 앞 32자,
key_variants) × 모드(CBC·IV=키 앞 16바이트 → ECB → CBC·IV=0) 순서로 시도하고 통과한 조합을 기억한다. 출력은 base64.
(포털 "운영 KEY" 는 16진수처럼 보이는 글자 — 32자면 글자 그대로 AES256, 64자면 16진수로 풀어 32바이트일 수 있다.)
token 이 틀리면 HTTP 200 + {"result":"fail","message":"키 인증 중 오류…","code":"401 UNAUTHORIZED"}.
주소: 운영 https://withgs-api.gsshop.com (개발가이드의 예시 주소 atwithgs-api 는 테스트용 — 두 곳 모두 응답 확인).
매출(Settlement API 1.0): GET /api/v2/settlement/out/sales/period?supCode=&fromDate=&toDate=&pageIdx=&rowsPerPage=
— 매출인식일(YYYYMMDD) 기준, 한 번에 10일까지, 쪽당 최대 1만 건. 응답 {data:[…], hasMorePage, totalCount, …}.
배송비는 /api/v2/settlement/out/sales/shippingFee/period(같은 조건).
응답 줄 항목(2026-09-30 실데이터 9/3 — 개발가이드 예시에는 없음): saleAwareDt(매출인식일), ordNo·ordItemNo·orgOrdNo,
ordType(SALE …), prdCd·prdNm, chrQty(수량), salePrice(할인 전 판매가 — 줄 합계), dcTotAmt(할인 합계),
custChrAmt(고객 결제금액 = salePrice − dcTotAmt), supGiveAmt(협력사 지급액, 수수료 차감), sup*DcAmt(협력사 부담 할인).
9/3: salePrice 211,100 − dcTotAmt 19,528 = custChrAmt 191,572, supGiveAmt 179,435, 배송비 내역 7,000.
**주문일 기준 조회 API 는 없다**(V3 문서에 주문 조회 없음) — 협력사 포털 주문 통계(총주문금액, 주문일)와는 기준이 달라
날짜별로 똑같이 맞출 수 없다.
매출 규칙 — 협력사 포털 주문 통계의 금액 = **supGiveAmt(협력사 지급액)**(2026-09-30, 9월 실데이터로 확인):
미라미라클 6호세트 포털 176,715 ÷ 9 = 19,635 = API 줄 supGiveAmt 19,635(판매가 23,100·고객 결제 20,330),
7호세트 39,015 = 45,900 × 85%, 주부체험 세트 8,910 = 9,900 × 90% — 상품마다 GS 수수료율이 달라 판매가 × 요율로는 못 맞춘다.
9/1~9/29: 지급액 4,972,689 / 포털 순주문 4,823,074(차이는 주문일 ↔ 매출인식일 기준 차이·취소분).
- 매출 내역 한 줄 = 사건 하나(`gs:{ordNo}-{ordItemNo}-{ordType}-{saleAwareDt}`), 날짜 = 매출인식일.
- 금액 = supGiveAmt, 배송비 제외. 이미 GS 수수료를 뺀 금액이라 **실적 설정의 GS샵 수수료율은 0%** 로 둔다.
ordType 이 SALE 이 아니면(취소·반품 등) 음수로(RETURN). 할인 = dcTotAmt. 기간을 통째로 다시 받는다(replace_range).
"""
from __future__ import annotations
import base64
from datetime import date, datetime, timedelta
from typing import Any, Iterable
from .base import (
AdapterContext,
AdapterError,
ApiError,
AuthFailed,
CredentialField,
MarketplaceAdapter,
NotConfigured,
SaleEvent,
)
from .elevenst import field_summary
HOST = "https://withgs-api.gsshop.com"
SALES_PATH = "/api/v2/settlement/out/sales/period"
SHIPPING_PATH = "/api/v2/settlement/out/sales/shippingFee/period"
DAILY_SALES_PATH = "/api/v2/settlement/out/sales"
CHUNK_DAYS = 10 # 기간 조회는 시작일부터 10일 이내
ROWS_PER_PAGE = 10000
MAX_PAGES = 50
PROBE_MAX_DAYS = 31
TOKEN_MODES = ("cbc-keyiv", "ecb", "cbc-zeroiv")
MODE_LABEL = {"cbc-keyiv": "AES/CBC(IV=키 앞 16바이트)", "ecb": "AES/ECB", "cbc-zeroiv": "AES/CBC(IV=0)"}
KEY_LABEL = {"text": "키 글자 그대로", "hex": "키 16진수 풀기", "first32": "키 앞 32자"}
def key_variants(aes_key: str) -> list[tuple[str, bytes]]:
"""AES 키로 쓸 수 있는 바이트 후보(시도 순서). 하나도 없으면 길이 오류."""
raw = aes_key.strip().encode("utf-8")
out: list[tuple[str, bytes]] = []
if len(raw) in (16, 24, 32):
out.append(("text", raw))
txt = aes_key.strip()
if len(txt) in (32, 48, 64) and all(c in "0123456789abcdefABCDEF" for c in txt):
out.append(("hex", bytes.fromhex(txt)))
if len(raw) > 32:
out.append(("first32", raw[:32]))
if not out:
raise AuthFailed(f"AES 키 길이가 올바르지 않습니다({len(raw)}자). 제휴 API 메인 화면의 운영 KEY 를 "
"[복사] 버튼으로 복사해 그대로 붙여 넣으세요.")
return out
def make_token(aes_key: str | bytes, sup_cd: str, now: datetime, mode: str) -> str:
"""token = base64(AES(yyyyMMddHHmmss + 협력사코드)), PKCS7(=PKCS5) 패딩. aes_key 가 글자면 그대로 바이트로."""
from cryptography.hazmat.primitives import padding # 지연 import
from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
key = aes_key if isinstance(aes_key, bytes) else aes_key.encode("utf-8")
if len(key) not in (16, 24, 32):
raise AuthFailed(f"AES 키 길이가 올바르지 않습니다({len(key)}바이트 — 16·24·32 중 하나여야 함). "
"제휴 API 메인 화면의 키를 그대로 붙여 넣으세요.")
plain = (now.strftime("%Y%m%d%H%M%S") + sup_cd).encode("utf-8")
padder = padding.PKCS7(128).padder()
data = padder.update(plain) + padder.finalize()
if mode == "ecb":
cipher = Cipher(algorithms.AES(key), modes.ECB())
elif mode == "cbc-zeroiv":
cipher = Cipher(algorithms.AES(key), modes.CBC(b"\0" * 16))
else:
cipher = Cipher(algorithms.AES(key), modes.CBC(key[:16]))
enc = cipher.encryptor()
return base64.b64encode(enc.update(data) + enc.finalize()).decode("ascii")
def _rows(body: dict[str, Any]) -> list[dict[str, Any]]:
data = body.get("data")
return [r for r in data if isinstance(r, dict)] if isinstance(data, list) else []
def _strs(row: dict[str, Any]) -> dict[str, str]:
"""원본 확인용 — 값은 모두 글자로(중첩은 JSON 글자 그대로 짧게)."""
return {str(k): ("" if v is None else str(v)) for k, v in row.items()}
EVENT_PREFIX = "gs:"
def _won(value: Any) -> int:
try:
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
except ValueError:
return 0
def _yyyymmdd(value: Any) -> date | None:
s = "".join(ch for ch in str(value or "") if ch.isdigit())[:8]
if len(s) < 8:
return None
try:
return date(int(s[:4]), int(s[4:6]), int(s[6:8]))
except ValueError:
return None
class GsshopAdapter(MarketplaceAdapter):
code = "gsshop"
name = "GS샵"
auth_type = "api_key"
implemented = True
replace_range = True
event_prefix = EVENT_PREFIX
docs_url = "https://partners.gsshop.com/api/apiDevGuide"
note = ("GS SHOP 협력사 포털(partners.gsshop.com) → 제휴 API 메인 화면의 협력사코드와 "
"운영 KEY(오른쪽 [복사] 버튼)를 입력합니다. 개발 KEY 가 아니라 운영 KEY 입니다.")
def __init__(self) -> None:
self._mode: dict[str, tuple[str, str]] = {} # 협력사코드 → 통과한 (키 변형, 암호화 모드)
def credential_fields(self) -> list[CredentialField]:
# 키 이름(vendor_code·api_key)은 처음 만든 입력칸 그대로 — 이미 저장한 값을 다시 넣지 않아도 되게.
return [
CredentialField("vendor_code", "협력사코드(supCd)", help="예: 1036018"),
CredentialField("api_key", "운영 KEY(AES256 암복호화 키)", secret=True,
help="제휴 API 메인 화면의 운영 KEY — [복사] 버튼으로 복사해 붙여 넣기"),
]
# ── 호출 ──────────────────────────────────────────────
def _creds(self, ctx: AdapterContext) -> tuple[str, str]:
sup = ctx.credentials.get("vendor_code").strip()
key = ctx.credentials.get("api_key").strip()
if not sup or not key:
raise NotConfigured("협력사코드와 AES256 키를 입력하세요.")
return sup, key
def _call(self, ctx: AdapterContext, path: str, params: dict[str, Any], how: tuple[str, str]) -> dict[str, Any]:
import httpx # 지연 import
from app.timezone import now_kst # noqa: WPS433
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
sup, key = self._creds(ctx)
key_bytes = dict(key_variants(key))[how[0]]
headers = {"supCd": sup, "token": make_token(key_bytes, sup, now_kst(), how[1]), "Accept": "application/json"}
try:
res = httpx.get(f"{HOST}{path}", params={"supCode": sup, **params}, headers=headers, timeout=ctx.timeout_sec)
except httpx.HTTPError as exc:
raise ApiError(f"GS샵 API 연결 실패: {type(exc).__name__}") from None
try:
body = res.json()
except ValueError:
raise ApiError(f"GS샵이 예상하지 못한 응답을 돌려줬습니다({res.status_code}): {res.text[:150].strip()}") from None
if not isinstance(body, dict):
body = {"data": body}
code = str(body.get("code") or "")
msg = str(body.get("message") or "")[:200]
if res.status_code in (401, 403) or (str(body.get("result")) == "fail" and ("401" in code or "403" in code)):
raise AuthFailed(f"GS샵 인증 거부({code or res.status_code}): {msg}")
if res.status_code >= 400 or str(body.get("result")) == "fail":
raise ApiError(f"GS샵 API 오류({code or res.status_code}): {msg or res.text[:150].strip()}")
return body
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
"""토큰 만드는 법(키 변형 × 암호화 모드)을 모르면 순서대로 시도 — 통과한 조합을 기억한다."""
sup, key = self._creds(ctx)
known = self._mode.get(sup)
if known:
return self._call(ctx, path, params, known)
tries = [(v, m) for v, _ in key_variants(key) for m in TOKEN_MODES]
last: AuthFailed | None = None
for how in tries:
try:
body = self._call(ctx, path, params, how)
except AuthFailed as exc:
last = exc
continue
self._mode[sup] = how
return body
raise AuthFailed(f"{last.message if last else 'GS샵 인증 실패'} — 토큰 만드는 방식 {len(tries)}가지 모두 거부. "
"협력사코드·운영 KEY 가 맞는지, 서버 시각이 정확한지 확인하세요.")
def _pages(self, ctx: AdapterContext, path: str, lo: date, hi: date) -> list[dict[str, Any]]:
"""[lo, hi] 를 10일씩 나눠 쪽을 넘겨 모두 받는다."""
out: list[dict[str, Any]] = []
s = lo
while s <= hi:
e = min(hi, s + timedelta(days=CHUNK_DAYS - 1))
for page in range(1, MAX_PAGES + 1):
body = self._get(ctx, path, {"fromDate": s.strftime("%Y%m%d"), "toDate": e.strftime("%Y%m%d"),
"pageIdx": page, "rowsPerPage": ROWS_PER_PAGE})
rows = _rows(body)
out.extend(rows)
if not body.get("hasMorePage") or not rows:
break
ctx.progress.step(items=len(out))
s = e + timedelta(days=1)
return out
# ── 수집 ──────────────────────────────────────────────
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
"""매출인식일이 [start, end] 인 매출 내역 줄. 같은 사건 ID 가 두 번 나오면 뒤에 번호를 붙여 둘 다 남긴다."""
ctx.progress.plan(max(1, ((end - start).days + CHUNK_DAYS) // CHUNK_DAYS), "구간")
seen: dict[str, int] = {}
for r in self._pages(ctx, SALES_PATH, start, end):
day = _yyyymmdd(r.get("saleAwareDt"))
if day is None or not (start <= day <= end):
continue
base = f"{r.get('ordNo')}-{r.get('ordItemNo')}-{r.get('ordType') or 'SALE'}-{day.strftime('%Y%m%d')}"
n = seen.get(base, 0)
seen[base] = n + 1
yield {**r, "_day": day, "_id": base if n == 0 else f"{base}-{n + 1}"}
def normalize_order(self, r: dict[str, Any]) -> list[SaleEvent]:
"""매출 내역 한 줄 → SALE(ordType=SALE) 또는 RETURN(그 밖, 음수). 금액 = supGiveAmt(협력사 지급액 — 포털 주문 통계 금액)."""
oid, day = str(r.get("ordNo") or ""), r.get("_day")
if not oid or day is None:
return []
kind = str(r.get("ordType") or "SALE").upper()
amount = abs(_won(r.get("supGiveAmt")))
is_sale = kind == "SALE"
return [SaleEvent(
event_type="SALE" if is_sale else "RETURN", external_event_id=f"{EVENT_PREFIX}{r['_id']}",
external_order_id=oid, external_line_id=str(r.get("ordItemNo") or ""), event_date=day,
payment_date=day if is_sale else None, amount=amount if is_sale else -amount,
product_name=str(r.get("prdNm") or "")[:200], quantity=abs(_won(r.get("chrQty"))),
discount_amount=abs(_won(r.get("dcTotAmt"))), order_status=kind[:50],
raw={"salePrice": _won(r.get("salePrice")), "custChrAmt": _won(r.get("custChrAmt")),
"orgOrdNo": str(r.get("orgOrdNo") or ""), "prdCd": str(r.get("prdCd") or "")},
)]
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
self.authenticate(ctx)
sup, _ = self._creds(ctx)
self._mode.pop(sup, None) # 입력값을 바꿨을 수 있으니 모드를 다시 찾는다
day = today_kst() - timedelta(days=1)
body = self._get(ctx, DAILY_SALES_PATH, {"stdDate": day.strftime("%Y%m%d"), "pageIdx": 1, "rowsPerPage": 10})
total = body.get("totalCount")
return (f"GS샵 연결 정상(매출 내역 조회 확인, 어제 매출 {total if total is not None else len(_rows(body))}건, "
f"토큰 {self._how_label(sup)}).")
def _how_label(self, sup: str) -> str:
v, m = self._mode.get(sup, ("", ""))
return f"{MODE_LABEL.get(m, m)}, {KEY_LABEL.get(v, v)}"
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
"""매출 내역·배송비 내역을 기간(최대 31일, 10일씩)으로 실제 불러 항목별 합계를 돌려준다(저장 안 함).
응답 항목 이름이 개발가이드에 없어 협력사 포털 매출 화면과 맞는 항목을 실데이터로 확정하는 용도."""
self.authenticate(ctx)
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
probes = []
got: dict[str, list[dict[str, Any]]] = {}
for key, label, path in (("sales", "매출 내역(매출인식일 기준)", SALES_PATH),
("shipping", "배송비 내역(매출인식일 기준)", SHIPPING_PATH)):
row: dict[str, Any] = {"key": key, "label": label, "path": path}
try:
rows = self._pages(ctx, path, day, to)
except AdapterError as exc:
probes.append({**row, "ok": False, "error": exc.message[:300]})
continue
got[key] = rows
probes.append({**row, "ok": True, "count": len(rows), "fields": field_summary([_strs(r) for r in rows])})
# 날짜별 현재 규칙 매출(supGiveAmt, SALE 아닌 줄은 음수) — 협력사 포털 매출 화면과 나란히 비교
days = []
d = day
while d <= to:
sales = [r for r in got.get("sales", []) if _yyyymmdd(r.get("saleAwareDt")) == d]
ret = [r for r in sales if str(r.get("ordType") or "SALE").upper() != "SALE"]
amt = sum(abs(_won(r.get("supGiveAmt"))) for r in sales if r not in ret) - sum(abs(_won(r.get("supGiveAmt"))) for r in ret)
days.append({"date": d.isoformat(), "orders": len({str(r.get("ordNo")) for r in sales if r not in ret}),
"amount": amt, "claimed": sum(abs(_won(r.get("supGiveAmt"))) for r in ret),
"ship": sum(_won(r.get("salePrice")) for r in got.get("shipping", [])
if _yyyymmdd(r.get("saleAwareDt")) == d)})
d += timedelta(days=1)
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
"day_cols": {"claimed": "그중 취소·반품(음수로 반영)", "ship": "배송비(참고, 매출 제외)"},
"rule": "매출인식일 기준 매출 내역 supGiveAmt(협력사 지급액 = 포털 주문 통계 금액) 합, SALE 이 아닌 줄은 빼기, "
"배송비 제외. 주문 통계는 주문일 기준이라 날마다 같지는 않고 기간이 길수록 가까워진다"}
+21
View File
@@ -0,0 +1,21 @@
"""카카오 — 카카오쇼핑(톡스토어) 판매자 API.
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class KakaoAdapter(MarketplaceAdapter):
code = "kakao"
name = "카카오"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 카카오쇼핑 판매자 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자(채널) ID"),
CredentialField("api_key", "API Key", secret=True),
]
@@ -0,0 +1,21 @@
"""롯데ON — 롯데ON 판매자 API.
인증: 거래처번호 + 발급 API Key(연동 단계에서 확정).
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class LotteonAdapter(MarketplaceAdapter):
code = "lotteon"
name = "롯데ON"
auth_type = "api_key"
note = "롯데ON 스토어센터에서 발급한 API 인증정보를 입력합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("trade_no", "거래처번호"),
CredentialField("api_key", "API Key", secret=True),
]
+63
View File
@@ -0,0 +1,63 @@
"""테스트(모의) 매출 데이터 — 실제 API 연동 전 화면 확인용.
같은 (쇼핑몰, 날짜)면 항상 같은 값이 나온다(재현 가능). 결제뿐 아니라 전체 취소·
부분 반품도 섞어 넣어 음수 반영과 합계를 확인할 수 있게 한다.
DB 에는 is_sample=TRUE 로 들어가며 설정 화면에서 한 번에 지울 수 있다.
"""
from __future__ import annotations
import random
from datetime import date, timedelta
from .base import SaleEvent
# 쇼핑몰별 하루 평균 주문 건수(모의값) — 화면에 차이가 보이도록만 다르게 둔다.
_DAILY_ORDERS = {
"cafe24": 9, "naver": 14, "coupang": 18, "ohouse": 4, "gmarket": 6,
"kakao": 3, "gsshop": 2, "elevenst": 4, "lotteon": 2, "toss": 1,
}
_PRODUCTS = (
("스테인리스 냄비 20cm", 39_000), ("프라이팬 28cm", 45_900), ("밀폐용기 5종 세트", 29_800),
("도마 대형", 19_900), ("칼 블록 세트", 89_000), ("주방 가위", 12_900),
("냄비 받침", 8_900), ("전골 냄비", 59_000),
)
def generate(code: str, start: date, end: date) -> list[SaleEvent]:
events: list[SaleEvent] = []
base = _DAILY_ORDERS.get(code, 3)
d = start
while d <= end:
rng = random.Random(f"perf-sample:{code}:{d.isoformat()}")
weekend = d.weekday() >= 5
n = max(0, int(rng.gauss(base * (0.7 if weekend else 1.0), base * 0.35)))
for i in range(n):
name, price = rng.choice(_PRODUCTS)
qty = 1 if rng.random() < 0.8 else rng.randint(2, 3)
discount = rng.choice((0, 0, 0, 1000, 2000, 3000))
amount = max(0, price * qty - discount)
order_id = f"SAMPLE-{code}-{d:%Y%m%d}-{i:03d}"
events.append(SaleEvent(
event_type="SALE", external_event_id=f"{order_id}-S", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=d, amount=amount,
product_name=name, quantity=qty, discount_amount=discount, order_status="결제완료",
raw={"sample": True},
))
roll = rng.random()
if roll < 0.05: # 전체 취소(당일~2일 뒤)
cd = min(end, d + timedelta(days=rng.randint(0, 2)))
events.append(SaleEvent(
event_type="CANCEL", external_event_id=f"{order_id}-C", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=cd, amount=-amount,
product_name=name, quantity=-qty, order_status="취소완료", raw={"sample": True},
))
elif roll < 0.08 and qty > 1: # 부분 반품(1개, 3~7일 뒤)
rd = min(end, d + timedelta(days=rng.randint(3, 7)))
events.append(SaleEvent(
event_type="RETURN", external_event_id=f"{order_id}-R", external_order_id=order_id,
external_line_id="1", order_date=d, payment_date=d, event_date=rd, amount=-price,
product_name=name, quantity=-1, order_status="반품완료", raw={"sample": True},
))
d += timedelta(days=1)
return events
+414
View File
@@ -0,0 +1,414 @@
"""네이버 스마트스토어 — 네이버 커머스API.
인증(공식 방식): 애플리케이션 ID + 시크릿으로 전자서명 → OAuth2 client_credentials 토큰.
client_secret_sign = base64( bcrypt.hashpw("{client_id}_{timestamp(ms)}", client_secret) )
POST https://api.commerce.naver.com/external/v1/oauth2/token
(client_id, timestamp, client_secret_sign, grant_type=client_credentials, type=SELF | SELLER+account_id)
토큰은 약 3시간 — 암호화 저장(access_token·access_token_expires_at)해 두고 만료 5분 전에 새로 받는다.
커머스API센터 애플리케이션에 **API 호출 IP(이 서버 외부 IP)** 를 등록해야 호출된다.
매출 수집 — 스마트스토어센터 **판매분석 "판매금액(총)"** 과 같은 기준(2026-09-30 사용자 확인: 9/1 매출 4,455,600원.
판매금액은 할인(판매자·네이버 부담) 뒤 금액, 배송비 332,486원은 별도, 환불 346,340원은 환불일에 따로 빠져 판매금액(순)):
- 조건형 상품 주문 상세 조회 GET /v1/pay-order/seller/product-orders
?from=…&to=…&rangeType=PAYED_DATETIME&pageSize=&page= — 결제일 기준, 한 번에 24시간까지(하루씩 부른다),
from 부터 180일 안의 주문만. 응답에 주문·상품주문 상세가 바로 들어 있다(네이버 안내: 소량·조회용 권장 API).
- SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(order.paymentDate).
금액 = 상품주문들의 결제금액(productOrder.totalPaymentAmount) 합 — 배송비 제외.
- 결제 뒤 취소·반품된 상품주문도 결제일 매출에 그대로 둔다(판매금액(총)). 입금대기·미입금 취소만 뺀다.
그래서 지난 날짜 매출이 나중에 줄지 않는다. 환불(판매금액(순))은 아직 따로 만들지 않는다.
- 구매자 이름·연락처·주소는 저장하지 않는다.
"""
from __future__ import annotations
import base64
import re
import time
from datetime import date, datetime, timedelta
from typing import Any, Iterable
from .base import (
AdapterContext,
AdapterError,
ApiError,
AuthFailed,
CredentialField,
MarketplaceAdapter,
NotConfigured,
SaleEvent,
TokenExpired,
)
HOST = "https://api.commerce.naver.com/external"
TOKEN_PATH = "/v1/oauth2/token"
ORDERS_PATH = "/v1/pay-order/seller/product-orders"
EVENT_PREFIX = "naver:"
PAGE_SIZE = 100
MAX_PAGES = 200 # 하루 2만 건 — 무한 반복 방지
TOKEN_MARGIN_SEC = 300 # 만료 5분 전이면 새로 받는다
CALL_INTERVAL_SEC = 0.35 # 초당 호출 제한(넘으면 429) — 호출 사이 간격
RETRY_429 = 3
PROBE_MAX_DAYS = 31
# 매출에서 빼는 상품주문 상태 — 결제되지 않은 것만(입금대기·미입금 취소). 결제 뒤 취소·반품된 것은 판매분석
# "판매금액(총)"처럼 결제일 매출에 그대로 둔다(환불은 판매분석에서도 환불일에 따로 빠진다).
EXCLUDED_STATUS = frozenset({"PAYMENT_WAITING", "CANCELED_BY_NOPAYMENT"})
CLAIMED_STATUS = frozenset({"CANCELED", "RETURNED"}) # 결제 뒤 취소·반품 완료 — 원본 확인 표에 참고로 따로 보여 줌
STATUS_KO = {
"PAYMENT_WAITING": "입금대기", "PAYED": "결제완료", "DELIVERING": "배송중", "DELIVERED": "배송완료",
"PURCHASE_DECIDED": "구매확정", "EXCHANGED": "교환", "CANCELED": "취소", "RETURNED": "반품",
"CANCELED_BY_NOPAYMENT": "미입금취소",
}
# 원본 데이터 확인 — 개인정보로 보이는 항목은 값 없이 이름만. 금액·상태·날짜·상품명 등은 보인다.
PERSONAL = re.compile(r"orderer|receiver|shippingAddress|takingAddress|returnAddress|pickupAddress|collectAddress|"
r"name$|tel|phone|address|zip|mail|memo|customsClearance|buyer|recipient", re.IGNORECASE)
SAFE = re.compile(r"(productName|productOption|optionCode|productClass|productId|deliveryCompany|reason|Status|Type|"
r"Date|Amount|Price|Fee|Quantity|Count|Id)$")
NUMBER = re.compile(r"^-?\d+(\.\d+)?$")
def _won(value: Any) -> int:
try:
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
except ValueError:
return 0
def _day(value: Any) -> date | None:
""""2026-09-29T10:11:12.0+09:00" → date(2026, 9, 29). 네이버 날짜는 한국 시간(+09:00)으로 온다."""
s = str(value or "")
m = re.match(r"(\d{4})-(\d{2})-(\d{2})", s)
if not m:
return None
try:
return date(int(m.group(1)), int(m.group(2)), int(m.group(3)))
except ValueError:
return None
def sign(client_id: str, client_secret: str, timestamp_ms: int) -> str:
"""커머스API 전자서명 — bcrypt(비밀번호 = "{client_id}_{timestamp}", 솔트 = 애플리케이션 시크릿) 을 base64."""
import bcrypt # 지연 import
try:
hashed = bcrypt.hashpw(f"{client_id}_{timestamp_ms}".encode("utf-8"), client_secret.encode("utf-8"))
except ValueError:
raise AuthFailed("애플리케이션 시크릿 형식이 올바르지 않습니다. 커머스API센터의 시크릿을 그대로 붙여 넣으세요.") from None
return base64.standard_b64encode(hashed).decode("ascii")
def product_order_items(body: Any) -> list[dict[str, Any]]:
"""조건형 조회 응답에서 상품주문 하나씩 {"order": {...}, "productOrder": {...}, ...} 로 꺼낸다.
응답 모양(data.contents[].content / data 목록 / 바로 목록)이 달라도 받아들인다."""
data = body.get("data", body) if isinstance(body, dict) else body
if isinstance(data, dict):
data = data.get("contents") or data.get("productOrders") or data.get("items") or []
out = []
for it in data if isinstance(data, list) else []:
if not isinstance(it, dict):
continue
c = it.get("content") if isinstance(it.get("content"), dict) else it
if isinstance(c.get("productOrder"), dict):
out.append(c)
return out
def has_next(body: Any, page: int, got: int) -> bool:
data = body.get("data") if isinstance(body, dict) else None
pg = data.get("pagination") if isinstance(data, dict) else None
if isinstance(pg, dict):
if "hasNext" in pg:
return bool(pg["hasNext"])
total = pg.get("totalPages") or pg.get("totalPage")
if total:
return page < int(total)
return got >= PAGE_SIZE
def flatten(obj: Any, prefix: str = "") -> dict[str, str]:
"""중첩 사전 → {"productOrder.totalPaymentAmount": "12000", …}. 목록은 건너뛴다(개수만)."""
out: dict[str, str] = {}
if isinstance(obj, dict):
for k, v in obj.items():
key = f"{prefix}.{k}" if prefix else str(k)
if isinstance(v, dict):
out.update(flatten(v, key))
elif isinstance(v, list):
out[key + "[]"] = str(len(v))
elif v is not None:
out[key] = str(v)
return out
def is_personal(key: str) -> bool:
last = key.rsplit(".", 1)[-1]
if "Address." in key or key.split(".")[0] in ("orderer",):
return True
return bool(PERSONAL.search(key)) and not SAFE.search(last)
def field_summary(records: list[dict[str, str]]) -> list[dict[str, Any]]:
"""항목별: 채워진 줄 수, 숫자면 합계, 개인정보 아니면 예시 값 하나."""
names: dict[str, dict[str, Any]] = {}
for r in records:
for k, v in r.items():
f = names.setdefault(k, {"name": k, "filled": 0, "numeric": True, "sum": 0.0, "sample": "",
"personal": is_personal(k)})
if v == "":
continue
f["filled"] += 1
if NUMBER.match(v) and f["numeric"]:
f["sum"] += float(v)
else:
f["numeric"] = False
if not f["sample"] and not f["personal"]:
f["sample"] = v[:40]
for f in names.values():
f["sum"] = int(round(f["sum"])) if f["numeric"] and f["filled"] else None
return sorted(names.values(), key=lambda f: f["name"])
def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
"""상품주문 → 주문 하나로 합침(결제일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
금액 = totalPaymentAmount 합(할인 뒤 상품 결제금액, 배송비 제외) = 판매분석 "판매금액(총)".
배송비·취소/반품분은 참고용(ship·claimed)으로만 모은다."""
orders: dict[str, dict[str, Any]] = {}
for c in items:
po, od = c.get("productOrder") or {}, c.get("order") or {}
oid = str(od.get("orderId") or po.get("orderId") or "")
day = _day(od.get("paymentDate") or po.get("paymentDate"))
status = str(po.get("productOrderStatus") or "")
if not oid or day is None or not (start <= day <= end) or status in EXCLUDED_STATUS:
continue
o = orders.setdefault(oid, {"orderId": oid, "_day": day, "amount": 0, "ship": 0, "claimed": 0, "qty": 0,
"discount": 0, "names": [], "opt": "", "statuses": [],
"order_day": _day(od.get("orderDate"))})
paid = _won(po.get("totalPaymentAmount"))
o["amount"] += paid
if status in CLAIMED_STATUS:
o["claimed"] += paid
o["ship"] += _won(po.get("deliveryFeeAmount")) - _won(po.get("deliveryDiscountAmount"))
o["qty"] += _won(po.get("quantity"))
o["discount"] += _won(po.get("productDiscountAmount"))
name = str(po.get("productName") or "")
if name and name not in o["names"]:
o["names"].append(name)
o["opt"] = o["opt"] or str(po.get("productOption") or "")
if status and status not in o["statuses"]:
o["statuses"].append(status)
return orders
class NaverAdapter(MarketplaceAdapter):
code = "naver"
name = "네이버 스마트스토어"
auth_type = "oauth"
implemented = True
replace_range = True
event_prefix = EVENT_PREFIX
docs_url = "https://apicenter.commerce.naver.com/"
note = ("커머스API센터에서 발급한 애플리케이션 ID/시크릿을 입력합니다. 애플리케이션의 API 호출 IP 에 "
"이 서버의 외부 IP 를 등록해야 호출됩니다.")
def __init__(self) -> None:
self._last_call = 0.0
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("client_id", "애플리케이션 ID(Client ID)"),
CredentialField("client_secret", "애플리케이션 시크릿(Client Secret)", secret=True),
CredentialField("account_id", "판매자 ID", required=False,
help="솔루션(SELLER) 방식으로 발급한 경우에만 입력 — 내 스토어 전용 애플리케이션은 비워 둡니다"),
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
]
# ── 인증 ──────────────────────────────────────────────
def _token(self, ctx: AdapterContext, *, force: bool = False) -> str:
"""저장된 토큰이 5분 넘게 남았으면 그대로, 아니면 새로 받아 암호화 저장."""
if not force:
tok = ctx.credentials.get("access_token")
try:
exp = float(ctx.credentials.get("access_token_expires_at") or 0)
except ValueError:
exp = 0.0
if tok and exp - time.time() > TOKEN_MARGIN_SEC:
return tok
return self._issue_token(ctx)
def _issue_token(self, ctx: AdapterContext) -> str:
import httpx # 지연 import
client_id = ctx.credentials.get("client_id").strip()
client_secret = ctx.credentials.get("client_secret").strip()
if not client_id or not client_secret:
raise NotConfigured("애플리케이션 ID와 시크릿을 입력하세요.")
ts = int(time.time() * 1000)
form = {"client_id": client_id, "timestamp": str(ts), "grant_type": "client_credentials",
"client_secret_sign": sign(client_id, client_secret, ts), "type": "SELF"}
account_id = ctx.credentials.get("account_id").strip()
if account_id:
form.update(type="SELLER", account_id=account_id)
try:
res = httpx.post(f"{HOST}{TOKEN_PATH}", data=form, timeout=ctx.timeout_sec,
headers={"Accept": "application/json"})
except httpx.HTTPError as exc:
raise ApiError(f"네이버 커머스API 연결 실패: {type(exc).__name__}") from None
body = self._json(res)
if res.status_code >= 400 or not body.get("access_token"):
msg = self._err_text(body, res)
if res.status_code in (400, 401, 403):
raise AuthFailed(f"네이버 토큰 발급 실패({res.status_code}): {msg}. 애플리케이션 ID·시크릿과 "
"API 호출 IP(이 서버 외부 IP) 등록을 확인하세요.")
raise ApiError(f"네이버 토큰 발급 오류({res.status_code}): {msg}")
tok = str(body["access_token"])
expires_in = _won(body.get("expires_in")) or 3 * 3600
ctx.credentials.set("access_token", tok)
ctx.credentials.set("access_token_expires_at", str(int(time.time()) + expires_in))
return tok
def authenticate(self, ctx: AdapterContext) -> None:
super().authenticate(ctx)
self._token(ctx)
def refresh_token(self, ctx: AdapterContext) -> None:
self._token(ctx, force=True)
# ── 호출 ──────────────────────────────────────────────
@staticmethod
def _json(res: Any) -> dict[str, Any]:
try:
body = res.json()
except ValueError:
return {}
return body if isinstance(body, dict) else {"data": body}
@staticmethod
def _err_text(body: dict[str, Any], res: Any) -> str:
parts = [str(body.get(k)) for k in ("code", "message", "error", "error_description") if body.get(k)]
inv = body.get("invalidInputs")
if isinstance(inv, list) and inv:
parts.append("; ".join(str(i.get("message") or i) if isinstance(i, dict) else str(i) for i in inv[:3]))
return " ".join(parts)[:300] or res.text[:200].strip() or "응답 없음"
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
"""GET — 호출 간격 유지, 429 는 잠깐 쉬고 다시, 401 이면 토큰을 새로 받아 한 번 더."""
import httpx # 지연 import
retried_auth = False
for attempt in range(RETRY_429 + 1):
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call)
if wait > 0:
time.sleep(wait)
headers = {"Authorization": f"Bearer {self._token(ctx)}", "Accept": "application/json"}
try:
res = httpx.get(f"{HOST}{path}", params=params, headers=headers, timeout=ctx.timeout_sec)
except httpx.HTTPError as exc:
raise ApiError(f"네이버 커머스API 연결 실패: {type(exc).__name__}") from None
finally:
self._last_call = time.monotonic()
if res.status_code == 429 and attempt < RETRY_429:
time.sleep(1.0 * (2 ** attempt))
continue
if res.status_code == 401 and not retried_auth:
retried_auth = True
self._token(ctx, force=True)
continue
body = self._json(res)
if res.status_code == 401:
raise TokenExpired(f"네이버 인증 만료·거부(401): {self._err_text(body, res)}")
if res.status_code == 403:
raise AuthFailed(f"네이버 권한 거부(403): {self._err_text(body, res)}. 애플리케이션의 API 권한(주문)과 "
"API 호출 IP 등록을 확인하세요.")
if res.status_code >= 400:
raise ApiError(f"네이버 API 오류({res.status_code}): {self._err_text(body, res)}")
return body
raise ApiError("네이버 API 호출 제한(429)이 계속됩니다. 잠시 뒤 다시 시도하세요.")
def _day_items(self, ctx: AdapterContext, d: date) -> list[dict[str, Any]]:
"""결제일이 d(한국 시간 0시~23:59:59.999)인 상품주문 전체 — 모든 상태."""
params: dict[str, Any] = {
"from": f"{d.isoformat()}T00:00:00.000+09:00", "to": f"{d.isoformat()}T23:59:59.999+09:00",
"rangeType": "PAYED_DATETIME", "pageSize": PAGE_SIZE,
}
out: list[dict[str, Any]] = []
for page in range(1, MAX_PAGES + 1):
body = self._get(ctx, ORDERS_PATH, {**params, "page": page})
items = product_order_items(body)
out.extend(items)
if not items or not has_next(body, page, len(items)):
break
return out
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
ctx.progress.plan((end - start).days + 1, "일") # 진행 막대: 하루 = 한 단계
d = start
while d <= end:
rows = self._day_items(ctx, d)
ctx.progress.step(items=len(rows))
yield from rows
d += timedelta(days=1)
# ── 수집 ──────────────────────────────────────────────
def fetch_orders(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
yield from group_orders(self._items(ctx, start, end), start, end).values()
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
oid, day = str(o.get("orderId") or ""), o.get("_day")
if not oid or day is None:
return []
names = o.get("names") or []
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
statuses = [STATUS_KO.get(s, s) for s in o.get("statuses") or []]
return [SaleEvent(
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
order_date=o.get("order_day"), payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0),
discount_amount=max(0, int(o.get("discount") or 0)), order_status="/".join(statuses)[:50],
)]
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
# 입력한 새 값으로 시험할 수 있으니 저장된 토큰을 쓰지 않고 항상 새로 받는다.
super().authenticate(ctx)
self._token(ctx, force=True)
items = self._day_items(ctx, today_kst())
return f"네이버 커머스API 연결 정상(토큰 발급·주문 조회 확인, 오늘 결제 상품주문 {len(items)}건)."
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
"""결제일 기준 기간(최대 31일)의 상품주문을 실제로 불러 항목별 합계·상태별 합계·날짜별 현재 규칙 매출을 돌려준다.
스마트스토어센터 화면 매출과 어느 항목이 맞는지 실데이터로 확정하는 용도. 개인정보 항목은 값 없이 이름만."""
self.authenticate(ctx)
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
try:
items = list(self._items(ctx, day, to))
except AdapterError as exc:
return {"date": day.isoformat(), "to": to.isoformat(), "probes": [
{"key": "payed", "label": "결제일 기준 상품주문", "path": ORDERS_PATH, "ok": False, "error": exc.message[:300]}]}
by_status: dict[str, list[dict[str, Any]]] = {}
for c in items:
by_status.setdefault(str((c.get("productOrder") or {}).get("productOrderStatus") or "?"), []).append(c)
probes = [{"key": "payed", "label": "결제일 기준 상품주문(전체 상태)", "path": ORDERS_PATH + " (PAYED_DATETIME)",
"ok": True, "count": len(items), "fields": field_summary([flatten(c) for c in items])}]
for st, rows in sorted(by_status.items()):
probes.append({"key": f"status-{st}", "label": f"상태 {STATUS_KO.get(st, st)}({st})"
+ (" — 매출 제외(미결제)" if st in EXCLUDED_STATUS else
" — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""), "path": "productOrderStatus",
"ok": True, "count": len(rows),
"fields": [f for f in field_summary([flatten(c) for c in rows])
if f["sum"] is not None and f["name"].startswith("productOrder.")]})
days = []
orders = group_orders(items, day, to)
d = day
while d <= to:
day_orders = [o for o in orders.values() if o["_day"] == d]
days.append({"date": d.isoformat(), "orders": len(day_orders), "amount": sum(o["amount"] for o in day_orders),
"claimed": sum(o["claimed"] for o in day_orders), "ship": sum(o["ship"] for o in day_orders)})
d += timedelta(days=1)
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
"rule": "결제일 기준 상품주문 totalPaymentAmount 합(할인 뒤, 배송비 제외, 결제 뒤 취소·반품분 포함, "
"미입금 제외) = 판매분석 '판매금액(총)'. 취소·반품분·배송비는 참고"}
@@ -0,0 +1,22 @@
"""오늘의집 — 파트너(판매자) API.
인증 방식·필드는 연동 단계에서 오늘의집 파트너 API 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class OhouseAdapter(MarketplaceAdapter):
code = "ohouse"
name = "오늘의집"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 오늘의집 파트너 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자 ID"),
CredentialField("api_key", "API Key", secret=True),
CredentialField("api_secret", "API Secret", secret=True, required=False),
]
@@ -0,0 +1,41 @@
"""쇼핑몰 어댑터 목록 — 새 쇼핑몰은 여기 한 줄 + 어댑터 파일 하나.
DB(perf_marketplaces)에 행이 없으면 설정 화면에서 쓸 수 없으므로, 새 쇼핑몰을
추가할 때는 scripts/sql 의 seed(INSERT … ON CONFLICT DO NOTHING)에도 한 줄 넣는다.
"""
from __future__ import annotations
from .base import MarketplaceAdapter
from .cafe24 import Cafe24Adapter
from .coupang import CoupangAdapter
from .elevenst import ElevenstAdapter
from .gmarket import GmarketAdapter
from .gsshop import GsshopAdapter
from .kakao import KakaoAdapter
from .lotteon import LotteonAdapter
from .naver import NaverAdapter
from .ohouse import OhouseAdapter
from .toss import TossAdapter
_ADAPTERS: tuple[MarketplaceAdapter, ...] = (
Cafe24Adapter(),
NaverAdapter(),
CoupangAdapter(),
OhouseAdapter(),
GmarketAdapter(),
KakaoAdapter(),
GsshopAdapter(),
ElevenstAdapter(),
LotteonAdapter(),
TossAdapter(),
)
_BY_CODE = {a.code: a for a in _ADAPTERS}
def all_adapters() -> tuple[MarketplaceAdapter, ...]:
return _ADAPTERS
def get_adapter(code: str) -> MarketplaceAdapter | None:
return _BY_CODE.get(code)
+22
View File
@@ -0,0 +1,22 @@
"""토스쇼핑 — 판매자 API.
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
class TossAdapter(MarketplaceAdapter):
code = "toss"
name = "토스쇼핑"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 토스쇼핑 판매자 API 문서로 확정합니다."
def credential_fields(self) -> list[CredentialField]:
return [
CredentialField("seller_id", "판매자 ID"),
CredentialField("api_key", "API Key", secret=True),
CredentialField("api_secret", "API Secret", secret=True, required=False),
]
+306
View File
@@ -0,0 +1,306 @@
"""③ 매출 계산 — 기간/주 계산, 수수료·반올림, 표·KPI 집계. DB·HTTP 와 무관한 순수 함수.
금액 규칙
- 모든 금액은 원 단위 정수(int). 부동소수점을 쓰지 않는다(수수료율만 Decimal).
- 수수료 = round_half_up(해당 일 쇼핑몰 매출 합계 × 그날 유효한 수수료율 / 100).
반올림은 `commission()` 한 곳에서만 한다. 취소/반품(음수)도 같은 규칙(0 에서 먼 쪽).
- 수수료 차감 매출 = 총매출 − 수수료.
- 수수료율은 이력(적용 시작일)으로 관리한다. 어떤 날의 요율 = 그날 이전(포함) 가장 최근
적용 시작일의 요율. 첫 요율보다 이전 날짜는 0%.
주 = 월요일 ~ 일요일.
"""
from __future__ import annotations
import calendar
from dataclasses import dataclass
from datetime import date, timedelta
from decimal import ROUND_HALF_UP, Decimal
from typing import Iterable, Mapping, Sequence
WEEKDAYS_KO = ("월", "화", "수", "목", "금", "토", "일")
PERIOD_KINDS = ("day", "week", "month", "year", "custom")
MAX_CUSTOM_DAYS = 366
# ════════════════════════════════════════════════════════════
# 금액
# ════════════════════════════════════════════════════════════
def commission(amount: int, rate_percent: Decimal) -> int:
"""수수료(원). 반올림 기준은 이 함수 한 곳 — ROUND_HALF_UP(0.5 는 0 에서 먼 쪽)."""
if not amount or not rate_percent:
return 0
value = Decimal(int(amount)) * Decimal(rate_percent) / Decimal(100)
return int(value.quantize(Decimal(1), rounding=ROUND_HALF_UP))
@dataclass
class Money:
gross: int = 0
commission: int = 0
@property
def net(self) -> int:
return self.gross - self.commission
def add(self, other: "Money") -> "Money":
self.gross += other.gross
self.commission += other.commission
return self
def as_dict(self) -> dict[str, int]:
return {"gross": self.gross, "commission": self.commission, "net": self.net}
def total(items: Iterable[Money]) -> Money:
out = Money()
for m in items:
out.add(m)
return out
RateTable = Mapping[str, Sequence[tuple[date, Decimal]]] # 쇼핑몰 → [(적용 시작일, 요율%)] 오름차순
def rate_on(rates: RateTable, code: str, d: date) -> Decimal:
current = Decimal(0)
for eff, rate in rates.get(code, ()):
if eff <= d:
current = Decimal(rate)
else:
break
return current
def build_cells(daily_amounts: Mapping[tuple[date, str], int], rates: RateTable) -> dict[tuple[date, str], Money]:
"""(날짜, 쇼핑몰) → 그날 매출 합계로 Money 를 만든다(수수료는 그날 요율)."""
return {
(d, code): Money(gross=int(amt), commission=commission(int(amt), rate_on(rates, code, d)))
for (d, code), amt in daily_amounts.items()
}
def pct_change(current: int, previous: int) -> float | None:
"""증감률(%). 비교 대상이 0 이하이면 의미 없는 값 대신 None."""
if previous <= 0:
return None
return round((current - previous) / previous * 100, 1)
# ════════════════════════════════════════════════════════════
# 기간
# ════════════════════════════════════════════════════════════
def week_start(d: date) -> date:
return d - timedelta(days=d.weekday())
def month_end(d: date) -> date:
return d.replace(day=calendar.monthrange(d.year, d.month)[1])
def _add_months(d: date, n: int) -> date:
y, m = divmod(d.month - 1 + n, 12)
year, month = d.year + y, m + 1
return date(year, month, min(d.day, calendar.monthrange(year, month)[1]))
def fmt_md(d: date) -> str:
return f"{d.month}/{d.day}"
def day_label(d: date) -> str:
"""일자별 표 날짜 — mm/dd(요일), 예: 09/01(화)."""
return f"{d.month:02d}/{d.day:02d}({WEEKDAYS_KO[d.weekday()]})"
@dataclass
class Period:
kind: str
anchor: date
start: date
end: date
label: str
prev_anchor: date
next_anchor: date
prev_label: str
next_label: str
@property
def days(self) -> int:
return (self.end - self.start).days + 1
def compare_range(self, today: date) -> tuple[date, date, str]:
"""직전 같은 길이 기간. 진행 중인 기간이면 같은 경과일수까지만(공정한 비교)."""
length = self.days
prev_start = self.start - timedelta(days=length)
if self.kind == "month":
prev_start = _add_months(self.start, -1)
elif self.kind == "year":
prev_start = self.start.replace(year=self.start.year - 1)
in_progress = self.start <= today < self.end
if in_progress:
elapsed = (today - self.start).days
prev_end = prev_start + timedelta(days=elapsed)
if self.kind == "month":
prev_end = min(prev_end, month_end(prev_start))
note = "같은 기간"
else:
if self.kind == "month":
prev_end = month_end(prev_start)
elif self.kind == "year":
prev_end = prev_start.replace(month=12, day=31)
else:
prev_end = self.start - timedelta(days=1)
note = ""
unit = {"day": "전일", "week": "전주", "month": "전월", "year": "전년"}.get(self.kind, "직전 기간")
return prev_start, prev_end, f"{unit} {note}".strip()
def resolve_period(
kind: str,
anchor: date,
*,
custom_from: date | None = None,
custom_to: date | None = None,
) -> Period:
kind = kind if kind in PERIOD_KINDS else "week"
if kind == "day":
return Period(kind, anchor, anchor, anchor,
f"{anchor.year}년 {anchor.month}월 {anchor.day}일 ({WEEKDAYS_KO[anchor.weekday()]})",
anchor - timedelta(days=1), anchor + timedelta(days=1), "전일", "다음날")
if kind == "week":
s = week_start(anchor)
e = s + timedelta(days=6)
label = (f"{s.year}년 {s.month}월 {s.day}일 ~ "
+ (f"{e.year}년 " if e.year != s.year else "") + f"{e.month}월 {e.day}일")
return Period(kind, anchor, s, e, label, s - timedelta(days=7), s + timedelta(days=7), "이전주", "다음주")
if kind == "month":
s = anchor.replace(day=1)
return Period(kind, anchor, s, month_end(s), f"{s.year}년 {s.month}월",
_add_months(s, -1), _add_months(s, 1), "이전달", "다음달")
if kind == "year":
s = date(anchor.year, 1, 1)
return Period(kind, anchor, s, date(anchor.year, 12, 31), f"{anchor.year}년",
date(anchor.year - 1, 1, 1), date(anchor.year + 1, 1, 1), "이전해", "다음해")
# custom
s = custom_from or anchor
e = custom_to or s
if e < s:
s, e = e, s
if (e - s).days + 1 > MAX_CUSTOM_DAYS:
e = s + timedelta(days=MAX_CUSTOM_DAYS - 1)
length = (e - s).days + 1
return Period("custom", s, s, e, f"{s.isoformat()} ~ {e.isoformat()}",
s - timedelta(days=length), e + timedelta(days=1), "이전", "다음")
def daterange(start: date, end: date) -> Iterable[date]:
d = start
while d <= end:
yield d
d += timedelta(days=1)
# ════════════════════════════════════════════════════════════
# 집계
# ════════════════════════════════════════════════════════════
def sum_range(cells: Mapping[tuple[date, str], Money], codes: Sequence[str], start: date, end: date) -> Money:
wanted = set(codes)
out = Money()
for (d, code), m in cells.items():
if code in wanted and start <= d <= end:
out.add(m)
return out
def by_code(cells: Mapping[tuple[date, str], Money], codes: Sequence[str], start: date, end: date) -> dict[str, Money]:
out = {c: Money() for c in codes}
for (d, code), m in cells.items():
if code in out and start <= d <= end:
out[code].add(m)
return out
def _row(kind: str, label: str, per_code: dict[str, Money], **extra) -> dict:
return {
"kind": kind,
"label": label,
"cells": {c: m.as_dict() for c, m in per_code.items()},
"total": total(per_code.values()).as_dict(),
**extra,
}
def main_table(period: Period, codes: Sequence[str], cells: Mapping[tuple[date, str], Money],
*, today: date, holidays: Mapping[str, str] | None = None) -> list[dict]:
"""일자 × 쇼핑몰 표. 일 행 + 주간합계(일요일 뒤 / 기간 끝) + 기간 합계.
연간 보기는 일 대신 월 행(1~12월)으로 줄인다.
"""
holidays = holidays or {}
rows: list[dict] = []
if period.kind == "year":
for m in range(1, 13):
s = date(period.start.year, m, 1)
e = month_end(s)
rows.append(_row("month", f"{m}월", by_code(cells, codes, s, e), future=s > today,
**{"from": s.isoformat(), "to": e.isoformat()}))
rows.append(_row("total", "연간 합계", by_code(cells, codes, period.start, period.end)))
return rows
week_codes: dict[str, Money] = {c: Money() for c in codes}
for d in daterange(period.start, period.end):
per_code = {c: cells.get((d, c), Money()) for c in codes}
iso = d.isoformat()
rows.append(_row("day", day_label(d), per_code, date=iso, weekday=d.weekday(),
holiday=holidays.get(iso, ""), future=d > today, today=d == today,
**{"from": iso, "to": iso}))
for c in codes:
week_codes[c].add(per_code[c])
if period.days > 1 and (d.weekday() == 6 or d == period.end):
ws = max(week_start(d), period.start)
label = "주간합계" if period.kind == "week" else f"주간합계 ({fmt_md(ws)}~{fmt_md(d)})"
rows.append(_row("week", label, week_codes, **{"from": ws.isoformat(), "to": d.isoformat()}))
week_codes = {c: Money() for c in codes}
if period.kind != "week" and period.days > 1:
rows.append(_row("total", "기간 합계", by_code(cells, codes, period.start, period.end)))
return rows
def month_summary(year: int, month: int, codes: Sequence[str], cells: Mapping[tuple[date, str], Money]) -> dict:
s = date(year, month, 1)
per = by_code(cells, codes, s, month_end(s))
tot = total(per.values())
rows = []
for c in codes:
m = per[c]
share = round(m.gross / tot.gross * 100, 1) if tot.gross > 0 else None
rows.append({"code": c, **m.as_dict(), "share": share})
rows.sort(key=lambda r: r["gross"], reverse=True)
return {"label": f"{year}년 {month}월", "rows": rows,
"total": {**tot.as_dict(), "share": 100.0 if tot.gross > 0 else None}}
def year_months(year: int, codes: Sequence[str], cells: Mapping[tuple[date, str], Money], *, today: date) -> dict:
rows = []
for m in range(1, 13):
s = date(year, m, 1)
future = s > today
money = sum_range(cells, codes, s, month_end(s))
rows.append({"month": m, "label": f"{m}월", "future": future,
**({"gross": None, "commission": None, "net": None} if future else money.as_dict())})
tot = sum_range(cells, codes, date(year, 1, 1), date(year, 12, 31))
return {"year": year, "rows": rows, "total": tot.as_dict()}
def daily_series(period: Period, codes: Sequence[str], cells: Mapping[tuple[date, str], Money]) -> list[dict]:
"""일별 추이 그래프용. 연간은 월별."""
if period.kind == "year":
out = []
for m in range(1, 13):
s = date(period.start.year, m, 1)
out.append({"label": f"{m}월", **sum_range(cells, codes, s, month_end(s)).as_dict()})
return out
return [{"label": fmt_md(d), "date": d.isoformat(), **sum_range(cells, codes, d, d).as_dict()}
for d in daterange(period.start, period.end)]
+126
View File
@@ -0,0 +1,126 @@
"""실적 모듈 공용 가드/서비스 생성 — router.py 가 쓴다(순환 import 방지로 분리).
권한(프론트에서 메뉴를 숨기는 것과 별개로 **서버에서** 항상 검사):
- 실적 대시보드/매출 업데이트/상세 조회 : 모듈 권한 `performance` (admin 은 자동)
- 실적 설정(수수료·API 인증정보·연결 테스트·테스트 데이터) : 관리자(is_admin)만
"""
from __future__ import annotations
from typing import Any
from fastapi import HTTPException, Request
from fastapi.responses import HTMLResponse, RedirectResponse
MODULE_KEY = "performance"
MODULE_NAME = "실적"
CONFIG_HELP = (
"실적 모듈이 아직 설정되지 않았습니다. "
"scripts/sql/performance_db_init.sql 로 performance_db 를 만들고 "
"PERFORMANCE_DB_URL 환경변수를 설정한 뒤 컨테이너를 재기동하세요."
)
def get_store(request: Request) -> Any:
return getattr(request.app.state, "performance_store", None)
def key_ring():
"""마스터 키 — 호출할 때마다 환경변수에서 읽는다(DB 에는 없다)."""
from .security.crypto import KeyRing # noqa: WPS433
return KeyRing.from_env()
def key_status() -> dict[str, Any]:
"""설정 화면용 — 키가 설정됐는지/버전만. 키 값은 절대 넣지 않는다."""
from .security.crypto import CryptoConfigError # noqa: WPS433
try:
ring = key_ring()
except CryptoConfigError as exc:
return {"ok": False, "message": str(exc), "current_version": None, "versions": []}
return {"ok": True, "message": "", "current_version": ring.current_version, "versions": ring.versions}
def services(request: Request, store: Any):
"""(CredentialService, SyncService)."""
from .credentials import CredentialService # noqa: WPS433
from .sync import SyncService # noqa: WPS433
creds = CredentialService(store, key_ring)
return creds, SyncService(store, creds, app_state=request.app.state)
def require_user(request: Request) -> dict[str, Any]:
from app.main import get_current_user_record # noqa: WPS433
from app.store import has_module # noqa: WPS433
user = get_current_user_record(request)
if user is None:
raise HTTPException(status_code=401, detail="로그인이 필요합니다.")
if not has_module(user, MODULE_KEY):
raise HTTPException(status_code=403, detail=f"{MODULE_NAME} 모듈 권한이 없습니다.")
return user
def require_admin(request: Request) -> dict[str, Any]:
from app.store import is_admin # noqa: WPS433
user = require_user(request)
if not is_admin(user):
raise HTTPException(status_code=403, detail="실적 설정은 관리자만 변경할 수 있습니다.")
return user
def require_store(request: Request, *, admin: bool = False) -> tuple[Any, dict[str, Any]]:
user = require_admin(request) if admin else require_user(request)
st = get_store(request)
if st is None:
raise HTTPException(status_code=503, detail=CONFIG_HELP)
return st, user
def guard(request: Request, *, admin: bool = False):
"""페이지 진입부. tuple(store, user) 이 아니면 그대로 응답으로 돌려준다."""
from app.main import get_current_user_record, render_template # noqa: WPS433
from app.store import has_module, is_admin # noqa: WPS433
user = get_current_user_record(request)
if user is None:
return RedirectResponse(url="/login", status_code=303)
if not has_module(user, MODULE_KEY) or (admin and not is_admin(user)):
reason = "실적 설정은 관리자만 볼 수 있습니다." if admin else f"{MODULE_NAME} 접근 권한이 없습니다."
return render_template(request, "denied.html",
{"reason": reason, "user": user, "is_admin": is_admin(user)}, status_code=403)
st = get_store(request)
if st is None:
return render_config_needed(request, user)
return st, user
def render_config_needed(request: Request, user: dict[str, Any]) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
return render_template(
request, "denied.html",
{"reason": CONFIG_HELP, "user": user, "is_admin": is_admin(user),
"nav_items": build_erp_nav(user, active=MODULE_KEY)},
status_code=503,
)
def base_ctx(user: dict[str, Any], *, active_tab: str, page_title: str = "실적") -> dict[str, Any]:
from app.main import build_erp_nav # noqa: WPS433
from app.store import is_admin # noqa: WPS433
return {
"user": user,
"is_admin": is_admin(user),
"nav_items": build_erp_nav(user, active=MODULE_KEY),
"active_tab": active_tab,
"page_title": page_title,
"page_subtitle": "쇼핑몰 통합 매출",
}
+174
View File
@@ -0,0 +1,174 @@
"""② 쇼핑몰 API 인증정보 — 저장(암호화) / 화면용 요약 / 어댑터용 복호화 접근자 / 재암호화.
흐름: 설정 화면 입력 → 이 서비스(암호화) → perf_credentials(암호문)
어댑터 → CredentialAccessor.get() → 서버 안에서만 복호화
화면으로 돌려주는 값
- secret 항목: 값 있음/없음(has_value)만. 원문·일부·길이 모두 보내지 않는다.
- 일반 항목(Vendor ID 등): 확인용으로 원문을 보여 준다(이것도 DB 에는 암호문).
"""
from __future__ import annotations
from typing import Any, Callable
from .adapters.base import MarketplaceAdapter
from .security.crypto import KeyRing, decrypt, encrypt, needs_reencrypt
def aad_for(code: str, key: str) -> str:
"""암호문을 (쇼핑몰, 항목)에 묶는 추가 인증 데이터."""
return f"perf:{code}:{key}"
class CredentialAccessor:
"""어댑터 전용 — 서버 안에서만 복호화. 값은 처음 꺼낼 때 한 번 복호화해 둔다."""
def __init__(self, store: Any, code: str, ring_loader: Callable[[], KeyRing], *,
overrides: dict[str, str] | None = None, persist: bool = True, user: str = "") -> None:
self._store = store
self._code = code
self._ring_loader = ring_loader
self._rows = store.credential_rows(code) if store is not None else {}
self._cache: dict[str, str] = {}
self._overrides = {k: v for k, v in (overrides or {}).items() if v}
self._persist = persist
self._user = user
def has(self, key: str) -> bool:
return bool(self._overrides.get(key)) or key in self._rows
def get(self, key: str) -> str:
if key in self._overrides:
return self._overrides[key]
if key in self._cache:
return self._cache[key]
row = self._rows.get(key)
if not row:
return ""
value = decrypt(row["encrypted_value"], aad=aad_for(self._code, key), ring=self._ring_loader())
self._cache[key] = value
return value
def set(self, key: str, value: str) -> None:
"""어댑터가 새로 받은 토큰 등을 저장. 테스트(persist=False)면 메모리에만."""
self._cache[key] = value
if not self._persist or self._store is None:
return
ring = self._ring_loader()
self._store.upsert_credential(
self._code, key, encrypted_value=encrypt(value, aad=aad_for(self._code, key), ring=ring),
key_version=ring.current_version, user=self._user or "system",
)
self._rows[key] = {"encrypted_value": "", "key_version": ring.current_version}
def known_secrets(self) -> list[str]:
"""가리기(redact)용 — 지금까지 꺼낸 원문들."""
return [v for v in list(self._cache.values()) + list(self._overrides.values()) if v]
class CredentialService:
def __init__(self, store: Any, ring_loader: Callable[[], KeyRing]) -> None:
self._store = store
self._ring_loader = ring_loader
def accessor(self, code: str, *, overrides: dict[str, str] | None = None, persist: bool = True,
user: str = "") -> CredentialAccessor:
return CredentialAccessor(self._store, code, self._ring_loader, overrides=overrides,
persist=persist, user=user)
# ── 화면용 요약(비밀 원문 없음) ─────────────────────────
def describe(self, adapter: MarketplaceAdapter) -> dict[str, Any]:
rows = self._store.credential_rows(adapter.code)
fields = []
decrypt_error = ""
for f in adapter.visible_fields():
row = rows.get(f.key)
item: dict[str, Any] = {
"key": f.key, "label": f.label, "secret": f.secret, "required": f.required,
"help": f.help, "placeholder": f.placeholder, "has_value": row is not None,
"updated_at": row["updated_at"].isoformat(timespec="seconds") if row and row.get("updated_at") else "",
}
if row is not None and not f.secret:
try:
item["value"] = decrypt(row["encrypted_value"], aad=aad_for(adapter.code, f.key),
ring=self._ring_loader())
except Exception as exc: # noqa: BLE001 — 키 없음/손상: 값 없이 안내만
item["value"] = ""
decrypt_error = str(exc) if "환경변수" in str(exc) else "저장된 값을 복호화하지 못했습니다."
fields.append(item)
return {"fields": fields, "decrypt_error": decrypt_error,
"configured": all(x["has_value"] for x in fields if x["required"])}
def configured_codes(self, adapters: list[MarketplaceAdapter]) -> dict[str, bool]:
keys = self._store.credential_keys_by_code()
out = {}
for a in adapters:
if a.uses_shared_integration:
out[a.code] = True
continue
have = keys.get(a.code, set())
required = [f.key for f in a.visible_fields() if f.required]
out[a.code] = bool(required) and all(k in have for k in required)
return out
# ── 저장 ────────────────────────────────────────────────
def merged_values(self, adapter: MarketplaceAdapter, values: dict[str, str]) -> dict[str, str]:
"""검사용 — 새 입력 + (빈 칸은) 기존 값 존재 여부. 비밀 원문은 꺼내지 않고 표식만."""
rows = self._store.credential_rows(adapter.code)
merged = {}
for f in adapter.visible_fields():
v = (values.get(f.key) or "").strip()
merged[f.key] = v if v else ("__stored__" if f.key in rows else "")
return merged
def save(self, adapter: MarketplaceAdapter, values: dict[str, str], *, clear: list[str] | None = None,
user: str = "") -> list[str]:
"""빈 칸 = 기존 값 유지. clear 에 든 항목은 삭제. 저장한 항목 키 목록 반환."""
allowed = {f.key for f in adapter.visible_fields()}
ring = self._ring_loader()
saved = []
for key, raw in values.items():
if key not in allowed:
continue
v = (raw or "").strip()
if not v:
continue
self._store.upsert_credential(
adapter.code, key, encrypted_value=encrypt(v, aad=aad_for(adapter.code, key), ring=ring),
key_version=ring.current_version, user=user,
)
saved.append(key)
for key in clear or []:
if key in allowed and key not in saved:
self._store.delete_credential(adapter.code, key)
return saved
# ── 마스터 키 교체 후 재암호화 ─────────────────────────
def reencrypt_all(self) -> dict[str, int]:
"""예전 키 버전으로 된 암호문을 현재 키로 다시 암호화. (재암호화 수, 실패 수)."""
ring = self._ring_loader()
done = failed = 0
for row in self._store.all_credential_rows():
token = row["encrypted_value"]
if not needs_reencrypt(token, ring):
continue
code, key = row["marketplace_code"], row["credential_key"]
try:
plain = decrypt(token, aad=aad_for(code, key), ring=ring)
except Exception: # noqa: BLE001
failed += 1
continue
self._store.upsert_credential(
code, key, encrypted_value=encrypt(plain, aad=aad_for(code, key), ring=ring),
key_version=ring.current_version, user="rekey",
)
done += 1
return {"reencrypted": done, "failed": failed}
def key_versions_in_use(self) -> dict[int, int]:
counts: dict[int, int] = {}
for row in self._store.all_credential_rows():
v = int(row["key_version"])
counts[v] = counts.get(v, 0) + 1
return counts
+201
View File
@@ -0,0 +1,201 @@
"""④ 대시보드/설정 화면 데이터 조립 — 저장소 조회 + calc 계산 결과를 템플릿 컨텍스트로.
HTTP 와 무관하다(store 만 주입). 라우터는 파라미터 파싱·권한만 하고 여기로 넘긴다.
"""
from __future__ import annotations
from datetime import date, timedelta
from decimal import Decimal
from typing import Any, Mapping, Sequence
from . import calc
from .adapters.base import STATUS_LABELS
from .adapters.registry import all_adapters, get_adapter
def _sales_marketplaces(store: Any) -> list[dict[str, Any]]:
"""대시보드 열 = 사용 ON + 매출 집계 ON 인 쇼핑몰(설정 순서)."""
known = {a.code for a in all_adapters()}
return [m for m in store.list_marketplaces() if m["enabled"] and m["include_in_sales"] and m["code"] in known]
def display_status(marketplace: Mapping[str, Any], status_row: Mapping[str, Any] | None,
configured: bool) -> str:
if not marketplace.get("enabled"):
return "disabled"
adapter = get_adapter(marketplace["code"])
if adapter is not None and not adapter.uses_shared_integration and not configured:
return "not_configured"
return (status_row or {}).get("status") or "unknown"
def build_dashboard(store: Any, *, kind: str, anchor: date, today: date,
custom_from: date | None = None, custom_to: date | None = None,
selected: Sequence[str] = (), holidays: Mapping[str, str] | None = None,
configured: Mapping[str, bool] | None = None) -> dict[str, Any]:
markets = _sales_marketplaces(store)
all_codes = [m["code"] for m in markets]
codes = [c for c in all_codes if c in set(selected)] or all_codes
names = {m["code"]: m["name"] for m in markets}
short = {c: _short_name(names[c]) for c in all_codes}
period = calc.resolve_period(kind, anchor, custom_from=custom_from, custom_to=custom_to)
cmp_start, cmp_end, cmp_label = period.compare_range(today)
# 월·연 누적의 기준일 — 선택 기간이 오늘을 포함하면 오늘(이번주가 다음 달로 걸쳐도
# "이번달"), 지난 기간이면 기간 끝, 앞으로의 기간이면 기간 시작.
if period.end < today:
ref = period.end
elif period.start <= today:
ref = today
else:
ref = period.start
month_period = calc.resolve_period("month", ref)
year_period = calc.resolve_period("year", ref)
m_cmp_start, m_cmp_end, m_cmp_label = month_period.compare_range(today)
y_cmp_start, y_cmp_end, y_cmp_label = year_period.compare_range(today)
q_start = min(period.start, cmp_start, m_cmp_start, y_cmp_start)
q_end = max(period.end, year_period.end)
cells = calc.build_cells(store.daily_amounts(q_start, q_end, codes), store.rate_table())
cur = calc.sum_range(cells, codes, period.start, period.end)
prev = calc.sum_range(cells, codes, cmp_start, cmp_end)
mtd = calc.sum_range(cells, codes, month_period.start, month_period.end)
m_prev = calc.sum_range(cells, codes, m_cmp_start, m_cmp_end)
ytd = calc.sum_range(cells, codes, year_period.start, year_period.end)
y_prev = calc.sum_range(cells, codes, y_cmp_start, y_cmp_end)
has_prev = prev.gross != 0 or prev.commission != 0
period_word = {"day": "오늘" if period.start == today else "해당일", "week": "이번주" if period.start <= today <= period.end else "해당 주",
"month": "이번달" if period.start <= today <= period.end else "해당 월",
"year": "올해" if period.start <= today <= period.end else "해당 연도",
"custom": "선택 기간"}[period.kind]
kpis = [
{"key": "gross", "label": f"{period_word} 총매출", "value": cur.gross, "primary": True,
"delta": calc.pct_change(cur.gross, prev.gross), "cmp": cmp_label},
{"key": "net", "label": f"{period_word} 수수료 차감 매출", "value": cur.net, "primary": True,
"delta": calc.pct_change(cur.net, prev.net), "cmp": cmp_label},
{"key": "commission", "label": f"{period_word} 수수료", "value": cur.commission,
"delta": calc.pct_change(cur.commission, prev.commission) if has_prev else None, "cmp": cmp_label,
"invert": True},
{"key": "mtd", "label": f"{month_period.label} 누적 매출", "value": mtd.gross,
"delta": calc.pct_change(mtd.gross, m_prev.gross), "cmp": m_cmp_label},
{"key": "ytd", "label": f"{year_period.label} 누적 매출", "value": ytd.gross,
"delta": calc.pct_change(ytd.gross, y_prev.gross), "cmp": y_cmp_label},
]
share = calc.by_code(cells, codes, period.start, period.end)
statuses = store.statuses()
configured = configured or {}
problems = []
for m in markets:
if m["code"] not in codes:
continue
st = display_status(m, statuses.get(m["code"]), configured.get(m["code"], False))
if st in ("auth_failed", "token_expired", "api_error"):
problems.append({"code": m["code"], "name": m["name"], "label": STATUS_LABELS[st],
"error": (statuses.get(m["code"]) or {}).get("last_error", "")})
m_qs = "" if len(codes) == len(all_codes) else "".join(f"&m={c}" for c in codes)
def url(kind: str, anchor_d: date | None = None, start: date | None = None, end: date | None = None) -> str:
if kind == "custom":
return f"?period=custom&from={start.isoformat()}&to={end.isoformat()}{m_qs}"
return f"?period={kind}&d={anchor_d.isoformat()}{m_qs}"
if period.kind == "custom":
length = timedelta(days=period.days)
prev_url = url("custom", start=period.start - length, end=period.start - timedelta(days=1))
next_url = url("custom", start=period.end + timedelta(days=1), end=period.end + length)
else:
prev_url = url(period.kind, period.prev_anchor)
next_url = url(period.kind, period.next_anchor)
nav = {
"prev": prev_url, "next": next_url,
"quick": [
{"key": "day", "label": "오늘", "url": url("day", today),
"active": period.kind == "day" and period.start == today},
{"key": "week", "label": "이번주", "url": url("week", today),
"active": period.kind == "week" and period.start <= today <= period.end},
{"key": "month", "label": "이번달", "url": url("month", today),
"active": period.kind == "month" and period.start <= today <= period.end},
{"key": "year", "label": "올해", "url": url("year", today),
"active": period.kind == "year" and period.start <= today <= period.end},
],
"m_qs": m_qs,
}
return {
"nav": nav,
"period": period,
"period_kind": period.kind,
"today": today.isoformat(),
"codes": codes,
"all_codes": all_codes,
"names": names,
"short_names": short,
"selected_all": len(codes) == len(all_codes),
"kpis": kpis,
"table": calc.main_table(period, codes, cells, today=today, holidays=holidays),
"month": calc.month_summary(month_period.start.year, month_period.start.month, codes, cells),
"year": calc.year_months(year_period.start.year, codes, cells, today=today),
"chart_daily": calc.daily_series(period, codes, cells),
"chart_share": [{"code": c, "name": names[c], **share[c].as_dict()} for c in codes],
"problems": problems,
"last_update_at": store.last_update_at(),
"running": store.running_codes(),
"no_marketplaces": not all_codes,
}
def _short_name(name: str) -> str:
return {"네이버 스마트스토어": "네이버", "토스쇼핑": "토스"}.get(name, name)
def build_settings(store: Any, *, configured: Mapping[str, bool], key_info: Mapping[str, Any],
key_versions_in_use: Mapping[int, int], sample_count: int) -> dict[str, Any]:
from app.timezone import today_kst # noqa: WPS433
from .adapters.cafe24 import MARKET_MAP # noqa: WPS433
statuses = store.statuses()
rates = store.rate_table()
today = today_kst()
via_cafe24 = set(MARKET_MAP.values()) # 카페24 마켓 통합관리 경유로 매출이 들어오는 쇼핑몰
rows = []
by_code = {m["code"]: m for m in store.list_marketplaces()}
for adapter in all_adapters():
m = by_code.get(adapter.code)
if m is None:
continue
st_row = statuses.get(adapter.code) or {}
st = display_status(m, st_row, configured.get(adapter.code, False))
cur_rate = calc.rate_on(rates, adapter.code, today)
has_rate = bool(rates.get(adapter.code))
rows.append({
"code": adapter.code, "name": m["name"], "enabled": m["enabled"],
"include_in_sales": m["include_in_sales"],
"rate": _fmt_rate(cur_rate) if has_rate else "",
"rate_history": len(rates.get(adapter.code, ())),
"auth_type": adapter.auth_type, "shared": adapter.uses_shared_integration,
"implemented": adapter.implemented, "note": adapter.note, "docs_url": adapter.docs_url,
"configured": configured.get(adapter.code, False),
"via_cafe24": adapter.code in via_cafe24,
"status": st, "status_label": STATUS_LABELS.get(st, st),
"last_test_at": st_row.get("last_test_at"), "last_test_ok": st_row.get("last_test_ok"),
"last_sync_at": st_row.get("last_sync_at"), "last_success_sync_at": st_row.get("last_success_sync_at"),
"last_error": st_row.get("last_error") or "", "last_error_at": st_row.get("last_error_at"),
})
stale = {v: n for v, n in key_versions_in_use.items() if key_info.get("current_version") and v != key_info["current_version"]}
return {"rows": rows, "key_info": key_info, "key_versions_in_use": dict(key_versions_in_use),
"stale_key_rows": sum(stale.values()), "sample_count": sample_count,
"default_sample_from": today.replace(month=1, day=1).isoformat(),
"default_sample_to": today.isoformat()}
def _fmt_rate(rate: Decimal) -> str:
s = f"{Decimal(rate):f}"
if "." in s:
s = s.rstrip("0").rstrip(".")
return s
+385
View File
@@ -0,0 +1,385 @@
"""performance_db PostgreSQL 저장소.
- 드라이버: psycopg 3 (`psycopg[binary,pool]`) — 다른 모듈과 동일 패턴.
- 연결 정보: 환경변수 `PERFORMANCE_DB_URL`
(예: postgresql://performance_app:<pwd>@postgres-db:5432/performance_db)
- 스키마는 앱이 만들지 않는다. `scripts/sql/performance_db_init.sql` 을 superuser 가 사전 적용.
- 연결 풀은 lazy open — 부팅 시 DB 가 잠시 끊겨도 컨테이너가 죽지 않게.
이 저장소는 인증정보를 **암호문 그대로만** 읽고 쓴다. 암·복호화는 credentials.py 의 몫.
"""
from __future__ import annotations
from datetime import date, datetime, timedelta
from decimal import Decimal
from typing import Any, Iterable
from psycopg.rows import dict_row
from psycopg.types.json import Jsonb
from psycopg_pool import ConnectionPool
from app.timezone import to_kst_iso
# running 상태로 이 시간 넘게 남은 동기화는 죽은 것으로 보고 정리한다(서버 재시작 등).
STALE_RUN_AFTER = timedelta(minutes=30)
def _iso(v: Any) -> Any:
if isinstance(v, datetime):
return to_kst_iso(v)
if isinstance(v, date):
return v.isoformat()
return v
class PerformanceDBStore:
def __init__(self, dsn: str, *, min_size: int = 1, max_size: int = 5):
self._pool = ConnectionPool(
conninfo=dsn,
min_size=min_size,
max_size=max_size,
kwargs={"row_factory": dict_row, "autocommit": True},
open=False,
)
self._pool.open(wait=False)
def close(self) -> None:
self._pool.close()
# ════════════════════════════════════════════════════════════
# 쇼핑몰 기본 설정
# ════════════════════════════════════════════════════════════
def list_marketplaces(self) -> list[dict[str, Any]]:
with self._pool.connection() as conn:
rows = conn.execute("SELECT * FROM perf_marketplaces ORDER BY sort_order, code").fetchall()
return [{k: _iso(v) for k, v in r.items()} for r in rows]
def update_marketplace(self, code: str, *, enabled: bool | None = None,
include_in_sales: bool | None = None) -> dict[str, Any] | None:
sets, params = [], []
if enabled is not None:
sets.append("enabled = %s")
params.append(bool(enabled))
if include_in_sales is not None:
sets.append("include_in_sales = %s")
params.append(bool(include_in_sales))
if not sets:
return None
params.append(code)
with self._pool.connection() as conn:
row = conn.execute(
f"UPDATE perf_marketplaces SET {', '.join(sets)} WHERE code = %s RETURNING *", params
).fetchone()
return {k: _iso(v) for k, v in row.items()} if row else None
# ════════════════════════════════════════════════════════════
# 수수료율 이력
# ════════════════════════════════════════════════════════════
def rate_table(self) -> dict[str, list[tuple[date, Decimal]]]:
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT marketplace_code, effective_from, rate_percent FROM perf_commission_rates "
"WHERE rule_type = 'marketplace' ORDER BY marketplace_code, effective_from"
).fetchall()
out: dict[str, list[tuple[date, Decimal]]] = {}
for r in rows:
out.setdefault(r["marketplace_code"], []).append((r["effective_from"], Decimal(r["rate_percent"])))
return out
def list_rates(self, code: str) -> list[dict[str, Any]]:
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT id, rate_percent, effective_from, memo, created_by, created_at "
"FROM perf_commission_rates WHERE marketplace_code = %s AND rule_type = 'marketplace' "
"ORDER BY effective_from DESC",
(code,),
).fetchall()
return [{k: (str(v) if isinstance(v, Decimal) else _iso(v)) for k, v in r.items()} for r in rows]
def set_rate(self, code: str, *, rate_percent: Decimal, effective_from: date,
memo: str = "", user: str = "") -> None:
"""같은 적용 시작일이면 덮어쓴다(오타 수정), 다르면 이력으로 추가."""
with self._pool.connection() as conn:
conn.execute(
"""
INSERT INTO perf_commission_rates
(marketplace_code, rule_type, rate_percent, effective_from, memo, created_by)
VALUES (%s, 'marketplace', %s, %s, %s, %s)
ON CONFLICT (marketplace_code, rule_type, effective_from) DO UPDATE
SET rate_percent = EXCLUDED.rate_percent, memo = EXCLUDED.memo,
created_by = EXCLUDED.created_by, created_at = now()
""",
(code, rate_percent, effective_from, memo, user),
)
def delete_rate(self, code: str, rate_id: int) -> bool:
with self._pool.connection() as conn:
cur = conn.execute(
"DELETE FROM perf_commission_rates WHERE id = %s AND marketplace_code = %s", (rate_id, code)
)
return cur.rowcount > 0
# ════════════════════════════════════════════════════════════
# 인증정보(암호문)
# ════════════════════════════════════════════════════════════
def credential_rows(self, code: str) -> dict[str, dict[str, Any]]:
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT credential_key, encrypted_value, key_version, updated_at, updated_by "
"FROM perf_credentials WHERE marketplace_code = %s",
(code,),
).fetchall()
return {r["credential_key"]: r for r in rows}
def credential_keys_by_code(self) -> dict[str, set[str]]:
with self._pool.connection() as conn:
rows = conn.execute("SELECT marketplace_code, credential_key FROM perf_credentials").fetchall()
out: dict[str, set[str]] = {}
for r in rows:
out.setdefault(r["marketplace_code"], set()).add(r["credential_key"])
return out
def upsert_credential(self, code: str, key: str, *, encrypted_value: str, key_version: int,
user: str = "") -> None:
with self._pool.connection() as conn:
conn.execute(
"""
INSERT INTO perf_credentials (marketplace_code, credential_key, encrypted_value, key_version, updated_by)
VALUES (%s, %s, %s, %s, %s)
ON CONFLICT (marketplace_code, credential_key) DO UPDATE
SET encrypted_value = EXCLUDED.encrypted_value, key_version = EXCLUDED.key_version,
updated_by = EXCLUDED.updated_by
""",
(code, key, encrypted_value, key_version, user),
)
def delete_credential(self, code: str, key: str) -> None:
with self._pool.connection() as conn:
conn.execute(
"DELETE FROM perf_credentials WHERE marketplace_code = %s AND credential_key = %s", (code, key)
)
def all_credential_rows(self) -> list[dict[str, Any]]:
with self._pool.connection() as conn:
return conn.execute(
"SELECT marketplace_code, credential_key, encrypted_value, key_version FROM perf_credentials"
).fetchall()
# ════════════════════════════════════════════════════════════
# 연결 상태
# ════════════════════════════════════════════════════════════
def statuses(self) -> dict[str, dict[str, Any]]:
with self._pool.connection() as conn:
rows = conn.execute("SELECT * FROM perf_connection_status").fetchall()
return {r["marketplace_code"]: {k: _iso(v) for k, v in r.items()} for r in rows}
def record_test(self, code: str, *, status: str, ok: bool, error: str = "") -> None:
with self._pool.connection() as conn:
conn.execute(
"""
INSERT INTO perf_connection_status (marketplace_code, status, last_test_at, last_test_ok,
last_error, last_error_at)
VALUES (%s, %s, now(), %s, %s, CASE WHEN %s = '' THEN NULL ELSE now() END)
ON CONFLICT (marketplace_code) DO UPDATE
SET status = EXCLUDED.status, last_test_at = now(), last_test_ok = EXCLUDED.last_test_ok,
last_error = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error
ELSE EXCLUDED.last_error END,
last_error_at = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error_at
ELSE now() END
""",
(code, status, ok, error, error),
)
def record_sync(self, code: str, *, status: str, ok: bool, error: str = "") -> None:
with self._pool.connection() as conn:
conn.execute(
"""
INSERT INTO perf_connection_status (marketplace_code, status, last_sync_at,
last_success_sync_at, last_error, last_error_at)
VALUES (%s, %s, now(), CASE WHEN %s THEN now() END, %s, CASE WHEN %s = '' THEN NULL ELSE now() END)
ON CONFLICT (marketplace_code) DO UPDATE
SET status = EXCLUDED.status, last_sync_at = now(),
last_success_sync_at = CASE WHEN %s THEN now()
ELSE perf_connection_status.last_success_sync_at END,
last_error = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error
ELSE EXCLUDED.last_error END,
last_error_at = CASE WHEN EXCLUDED.last_error = '' THEN perf_connection_status.last_error_at
ELSE now() END
""",
(code, status, ok, error, error, ok),
)
# ════════════════════════════════════════════════════════════
# 매출 사건
# ════════════════════════════════════════════════════════════
def upsert_events(self, code: str, events: Iterable[dict[str, Any]], *, is_sample: bool = False) -> int:
"""같은 (쇼핑몰, 사건 종류, 외부 사건 ID)는 덮어쓴다 — 여러 번 동기화해도 중복 없음."""
rows = self._event_rows(code, events, is_sample)
if not rows:
return 0
with self._pool.connection() as conn:
with conn.transaction():
with conn.cursor() as cur:
cur.executemany(self._UPSERT_SQL, rows)
return len(rows)
def replace_events(self, code: str, start: date, end: date, events: Iterable[dict[str, Any]],
*, id_prefix: str = "") -> int:
"""기간(sales_date) 안 이 어댑터가 만든 실데이터(is_sample 아님)를 지우고 새로 넣는다 — 한 트랜잭션.
지우는 대상: 이 쇼핑몰(code)의 행 + (id_prefix 가 있으면) 다른 쇼핑몰 열로 보냈던 이 어댑터의 행
(external_event_id 가 id_prefix 로 시작). 다른 쇼핑몰의 직접 연동분·테스트 데이터는 건드리지 않는다.
실패하면 롤백되어 예전 데이터가 그대로 남는다."""
rows = self._event_rows(code, events, False)
with self._pool.connection() as conn:
with conn.transaction():
if id_prefix:
conn.execute(
"DELETE FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s "
"AND (marketplace_code = %s OR left(external_event_id, %s) = %s)",
(start, end, code, len(id_prefix), id_prefix),
)
else:
conn.execute(
"DELETE FROM perf_sales_events WHERE marketplace_code = %s AND is_sample = FALSE "
"AND sales_date BETWEEN %s AND %s",
(code, start, end),
)
if rows:
with conn.cursor() as cur:
cur.executemany(self._UPSERT_SQL, rows)
return len(rows)
@staticmethod
def _event_rows(code: str, events: Iterable[dict[str, Any]], is_sample: bool) -> list[tuple]:
"""행마다 집계할 쇼핑몰 = 사건의 marketplace_code(다른 쇼핑몰 대신 받은 주문), 없으면 code."""
return [
(e.get("marketplace_code") or code, e["event_type"], e["external_event_id"], e["external_order_id"],
e.get("external_line_id", ""),
e.get("order_date"), e.get("payment_date"), e["event_date"], e["sales_date"],
e.get("product_name", ""), e.get("option_name", ""), int(e.get("quantity") or 0),
int(e["amount"]), int(e.get("discount_amount") or 0), e.get("order_status", ""),
Jsonb(e.get("raw") or {}), is_sample)
for e in events
]
_UPSERT_SQL = """
INSERT INTO perf_sales_events
(marketplace_code, event_type, external_event_id, external_order_id, external_line_id,
order_date, payment_date, event_date, sales_date, product_name, option_name, quantity,
amount, discount_amount, order_status, raw_data, is_sample, synced_at)
VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, now())
ON CONFLICT (marketplace_code, event_type, external_event_id) DO UPDATE
SET external_order_id = EXCLUDED.external_order_id, external_line_id = EXCLUDED.external_line_id,
order_date = EXCLUDED.order_date, payment_date = EXCLUDED.payment_date,
event_date = EXCLUDED.event_date, sales_date = EXCLUDED.sales_date,
product_name = EXCLUDED.product_name, option_name = EXCLUDED.option_name,
quantity = EXCLUDED.quantity, amount = EXCLUDED.amount,
discount_amount = EXCLUDED.discount_amount, order_status = EXCLUDED.order_status,
raw_data = EXCLUDED.raw_data, is_sample = EXCLUDED.is_sample, synced_at = now()
"""
def daily_amounts(self, start: date, end: date, codes: list[str]) -> dict[tuple[date, str], int]:
if not codes:
return {}
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT sales_date, marketplace_code, SUM(amount)::BIGINT AS amount "
"FROM perf_sales_events WHERE sales_date BETWEEN %s AND %s AND marketplace_code = ANY(%s) "
"GROUP BY sales_date, marketplace_code",
(start, end, codes),
).fetchall()
return {(r["sales_date"], r["marketplace_code"]): int(r["amount"] or 0) for r in rows}
def daily_breakdown(self, code: str, start: date, end: date, *, id_prefix: str = "") -> list[dict[str, Any]]:
"""쇼핑몰 화면(일별 매출내역) 대조용 — 날짜별 결제(SALE 합·건수)·환불(그 밖, 양수)·마지막 수집 시각.
id_prefix 가 있으면 이 어댑터가 다른 쇼핑몰 열로 보낸 사건까지 합친다(카페24 화면 합계와 같은 범위)."""
where = "(marketplace_code = %s OR left(external_event_id, %s) = %s)" if id_prefix else "marketplace_code = %s"
params: tuple = (code, len(id_prefix), id_prefix) if id_prefix else (code,)
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT sales_date, "
" COALESCE(SUM(amount) FILTER (WHERE event_type = 'SALE'), 0)::BIGINT AS paid, "
" COUNT(*) FILTER (WHERE event_type = 'SALE')::INT AS orders, "
" COALESCE(-SUM(amount) FILTER (WHERE event_type <> 'SALE'), 0)::BIGINT AS refund, "
" MAX(synced_at) AS synced_at "
f"FROM perf_sales_events WHERE is_sample = FALSE AND sales_date BETWEEN %s AND %s AND {where} "
"GROUP BY sales_date ORDER BY sales_date",
(start, end, *params),
).fetchall()
return [{"date": r["sales_date"].isoformat(), "paid": int(r["paid"]), "orders": int(r["orders"]),
"refund": int(r["refund"]), "synced_at": _iso(r["synced_at"])} for r in rows]
def list_events(self, code: str, start: date, end: date, *, limit: int = 500) -> list[dict[str, Any]]:
"""금액 클릭 상세(Drill-down). raw_data 는 보내지 않는다."""
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT id, event_type, external_order_id, external_line_id, order_date, payment_date, "
" event_date, sales_date, product_name, option_name, quantity, amount, "
" discount_amount, order_status, is_sample "
"FROM perf_sales_events WHERE marketplace_code = %s AND sales_date BETWEEN %s AND %s "
"ORDER BY sales_date, external_order_id, event_type LIMIT %s",
(code, start, end, limit),
).fetchall()
return [{k: _iso(v) for k, v in r.items()} for r in rows]
def sample_count(self) -> int:
with self._pool.connection() as conn:
row = conn.execute("SELECT COUNT(*) AS n FROM perf_sales_events WHERE is_sample").fetchone()
return int(row["n"] or 0)
def delete_sample_events(self) -> int:
"""테스트 데이터만(is_sample) 지운다 — 조건이 있는 삭제."""
with self._pool.connection() as conn:
cur = conn.execute("DELETE FROM perf_sales_events WHERE is_sample = TRUE")
return cur.rowcount
# ════════════════════════════════════════════════════════════
# 동기화 실행(중복 실행 방지)
# ════════════════════════════════════════════════════════════
def start_run(self, code: str, *, trigger: str, range_from: date, range_to: date, user: str) -> int | None:
"""running 행을 만든다. 이미 돌고 있으면 None(부분 유니크 인덱스로 막힘)."""
import psycopg # noqa: WPS433
with self._pool.connection() as conn:
conn.execute(
"UPDATE perf_sync_runs SET status = 'failed', finished_at = now(), "
"error = '중단됨(시간 초과로 정리)' "
"WHERE marketplace_code = %s AND status = 'running' AND started_at < now() - %s",
(code, STALE_RUN_AFTER),
)
try:
row = conn.execute(
"INSERT INTO perf_sync_runs (marketplace_code, trigger, range_from, range_to, started_by) "
"VALUES (%s, %s, %s, %s, %s) RETURNING id",
(code, trigger, range_from, range_to, user),
).fetchone()
except psycopg.errors.UniqueViolation:
return None
return int(row["id"])
def finish_run(self, run_id: int, *, ok: bool, fetched: int = 0, upserted: int = 0, error: str = "") -> None:
with self._pool.connection() as conn:
conn.execute(
"UPDATE perf_sync_runs SET status = %s, fetched_count = %s, upserted_count = %s, "
"error = %s, finished_at = now() WHERE id = %s",
("success" if ok else "failed", fetched, upserted, error, run_id),
)
def last_update_at(self) -> str | None:
"""대시보드 "마지막 업데이트" — 성공한 동기화 중 가장 최근."""
with self._pool.connection() as conn:
row = conn.execute(
"SELECT MAX(finished_at) AS t FROM perf_sync_runs WHERE status = 'success'"
).fetchone()
return _iso(row["t"]) if row and row["t"] else None
def running_codes(self) -> list[str]:
with self._pool.connection() as conn:
rows = conn.execute(
"SELECT marketplace_code FROM perf_sync_runs WHERE status = 'running' "
"AND started_at >= now() - %s",
(STALE_RUN_AFTER,),
).fetchall()
return [r["marketplace_code"] for r in rows]
+201
View File
@@ -0,0 +1,201 @@
"""매출 업데이트 진행 상황 — 백그라운드 수집 작업(쇼핑몰별 진행 막대)을 메모리에 둔다.
- [매출 업데이트]·[과거 매출 가져오기]는 수집을 백그라운드 스레드로 돌리고 작업 번호를 바로 돌려준다.
화면은 GET /performance/api/sync/jobs/{id} 를 0.8초마다 불러 쇼핑몰별·전체 진행 막대를 그린다.
- 어댑터가 ctx.progress.plan()/step() 으로 알린 단계를 ShopProgress 가 모은다(쇼핑몰마다 단위가 다르다 —
네이버 "일", 11번가·카페24 "구간").
- 웹 프로세스 하나(uvicorn 단일 워커) 기준 — 워커를 여러 개로 늘리면 진행 상황을 DB 로 옮겨야 한다.
서버를 다시 켜면 진행 중 작업 정보는 사라진다(수집 결과는 DB 에 이미 저장된 만큼 남음).
- [업데이트 취소]: SyncJob.cancel() → 각 쇼핑몰이 다음 API 호출 직전(ShopProgress.check)에 Cancelled 로 멈춘다.
수집 중에 멈춘 쇼핑몰은 DB 에 아무것도 쓰지 않는다(저장은 수집이 끝난 뒤 한 트랜잭션). 저장 중이면 그 저장은 끝낸다.
아직 차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다.
"""
from __future__ import annotations
import threading
import time
import uuid
from datetime import date
from typing import Any
from .adapters.base import Cancelled, Progress
MAX_JOBS = 20
_LOCK = threading.Lock()
_JOBS: dict[str, "SyncJob"] = {}
# 끝났지만 막대에서 빼는 쇼핑몰(수집할 수 없어 바로 끝난 것) — 전체 진행률 계산에서 제외
PASSIVE_STATUS = frozenset({"not_implemented", "not_configured"})
class ShopProgress(Progress):
"""쇼핑몰 하나의 진행 상황. state: waiting → running → saving → done | error | skipped | cancelled."""
def __init__(self, code: str, name: str, *, active: bool = True, job: "SyncJob | None" = None) -> None:
self.code, self.name, self.active, self.job = code, name, active, job
self.state = "waiting"
self.done = self.total = self.items = self.upserted = 0
self.unit = "단계"
self.status = self.label = self.message = ""
self.started_at = self.finished_at = 0.0
self._lock = threading.Lock()
# ── 어댑터가 부르는 쪽(Progress) ──
def plan(self, total: int, unit: str = "단계") -> None:
with self._lock:
self.total, self.unit, self.done = max(0, int(total)), unit or "단계", 0
def add(self, n: int) -> None:
with self._lock:
self.total += max(0, int(n))
def check(self) -> None:
if self.cancel_requested and self.state == "running":
raise Cancelled("사용자가 업데이트를 취소했습니다.")
@property
def cancel_requested(self) -> bool:
return bool(self.job is not None and self.job.cancel_requested)
def step(self, n: int = 1, *, items: int = 0) -> None:
self.check()
with self._lock:
self.done += max(0, int(n))
self.items += max(0, int(items))
if self.total and self.done > self.total: # 계획보다 많이 돌면 전체를 늘려 100% 를 넘지 않게
self.total = self.done
# ── sync 가 부르는 쪽 ──
def start(self) -> None:
with self._lock:
self.state, self.started_at = "running", time.time()
def saving(self) -> None:
with self._lock:
self.state = "saving"
def finish(self, *, upserted: int, message: str = "") -> None:
with self._lock:
self.state, self.upserted, self.message, self.status = "done", int(upserted), message, "ok"
if self.total:
self.done = self.total
self.finished_at = time.time()
def fail(self, *, status: str, label: str, message: str) -> None:
with self._lock:
self.state, self.status, self.label, self.message = "error", status, label, message
if status in PASSIVE_STATUS:
self.active = False
self.finished_at = time.time()
def cancelled(self) -> None:
with self._lock:
self.state, self.status, self.message = "cancelled", "cancelled", "취소됨"
self.finished_at = time.time()
def skip(self, message: str) -> None:
with self._lock:
self.state, self.status, self.message = "skipped", "running", message
self.finished_at = time.time()
@property
def finished(self) -> bool:
return self.state in ("done", "error", "skipped", "cancelled")
def fraction(self) -> float:
if self.finished:
return 1.0
if self.state == "saving":
return 0.98
if self.state == "running" and self.total:
return min(0.97, self.done / self.total)
return 0.0
def snapshot(self) -> dict[str, Any]:
with self._lock:
return {
"code": self.code, "name": self.name, "active": self.active, "state": self.state,
"done": self.done, "total": self.total, "unit": self.unit, "items": self.items,
"upserted": self.upserted, "status": self.status, "label": self.label, "message": self.message,
"fraction": round(self.fraction(), 4),
"elapsed": round((self.finished_at or time.time()) - self.started_at, 1) if self.started_at else 0,
}
class SyncJob:
def __init__(self, *, user: str, start: date | None, end: date | None) -> None:
self.id = uuid.uuid4().hex[:12]
self.user, self.start, self.end = user, start, end
self.created_at = time.time()
self.finished_at = 0.0
self.shops: list[ShopProgress] = []
self.error = ""
self.last_update_at: str | None = None
self.cancel_requested = False
self.cancelled_by = ""
self._lock = threading.Lock()
def set_targets(self, targets: list[tuple[str, str, bool]], start: date, end: date) -> dict[str, ShopProgress]:
with self._lock:
self.start, self.end = start, end
self.shops = [ShopProgress(code, name, active=active, job=self) for code, name, active in targets]
return {s.code: s for s in self.shops}
def cancel(self, user: str = "") -> None:
"""[업데이트 취소] — 돌고 있는 쇼핑몰은 다음 API 호출 직전에, 기다리는 쇼핑몰은 차례가 오면 멈춘다."""
with self._lock:
if not self.finished_at and not self.cancel_requested:
self.cancel_requested, self.cancelled_by = True, user
def finish(self, *, error: str = "", last_update_at: str | None = None) -> None:
with self._lock:
self.error, self.last_update_at, self.finished_at = error, last_update_at, time.time()
@property
def finished(self) -> bool:
return bool(self.finished_at)
def snapshot(self) -> dict[str, Any]:
with self._lock:
shops = [s.snapshot() for s in self.shops]
active = [s for s in shops if s["active"]]
return {
"id": self.id, "finished": self.finished, "error": self.error, "user": self.user,
"cancel_requested": self.cancel_requested,
"from": self.start.isoformat() if self.start else None, "to": self.end.isoformat() if self.end else None,
"elapsed": round((self.finished_at or time.time()) - self.created_at, 1),
"last_update_at": self.last_update_at, "shops": shops,
"overall": {
"shops": len(active),
"finished": sum(1 for s in active if s["state"] in ("done", "error", "skipped", "cancelled")),
"fraction": round(sum(s["fraction"] for s in active) / len(active), 4) if active else
(1.0 if self.finished else 0.0),
"items": sum(s["items"] for s in shops), "upserted": sum(s["upserted"] for s in shops),
},
}
def create_job(*, user: str, start: date | None, end: date | None) -> SyncJob:
job = SyncJob(user=user, start=start, end=end)
with _LOCK:
_JOBS[job.id] = job
if len(_JOBS) > MAX_JOBS: # 오래된 끝난 작업부터 정리
for jid, j in sorted(_JOBS.items(), key=lambda kv: kv[1].created_at):
if len(_JOBS) <= MAX_JOBS:
break
if j.finished:
del _JOBS[jid]
return job
def get_job(job_id: str) -> SyncJob | None:
with _LOCK:
return _JOBS.get(job_id)
def running_job() -> SyncJob | None:
"""지금 돌고 있는 작업(가장 최근). 없으면 None — 다른 사람이 누른 업데이트도 같이 보여 주려고."""
with _LOCK:
live = [j for j in _JOBS.values() if not j.finished]
return max(live, key=lambda j: j.created_at) if live else None
+411
View File
@@ -0,0 +1,411 @@
"""실적 모듈 라우터 (prefix=/performance).
화면
GET /performance/ 대시보드(모듈 권한)
GET /performance/settings 실적 설정(관리자)
JSON API — 모듈 권한
POST /performance/api/sync 매출 업데이트(사용 중인 쇼핑몰 전부, 쇼핑몰별 실패 격리)
background=true 면 백그라운드로 돌리고 작업 번호를 바로 돌려줌
GET /performance/api/sync/jobs/{id} 매출 업데이트 진행 상황(쇼핑몰별·전체 진행 막대)
GET /performance/api/sync/current 지금 돌고 있는 업데이트(없으면 null)
POST /performance/api/sync/jobs/{id}/cancel 업데이트 취소(시작한 사람 또는 관리자)
GET /performance/api/events 금액 클릭 상세(쇼핑몰+기간)
JSON API — 관리자
PUT /performance/api/marketplaces/{code} 사용/매출 집계 여부
POST /performance/api/marketplaces/{code}/rates 수수료율(적용 시작일)
DELETE /performance/api/marketplaces/{code}/rates/{id}
GET /performance/api/marketplaces/{code}/credentials 입력칸 + 저장 여부(비밀 원문 없음)
GET /performance/api/marketplaces/{code}/daily-check 일별 매출 비교(저장값 + 지금 API 값)
PUT /performance/api/marketplaces/{code}/credentials 저장(암호화)
POST /performance/api/marketplaces/{code}/test 연결 테스트(저장값 또는 새 입력값)
POST /performance/api/sample-data 테스트 데이터 생성/삭제
POST /performance/api/rekey 마스터 키 교체 후 재암호화
핸들러는 동기 DB 라 `def` 로 둔다(FastAPI 가 스레드풀에서 실행).
"""
from __future__ import annotations
from datetime import date
from decimal import Decimal, InvalidOperation
from typing import Any
from fastapi import APIRouter, Body, HTTPException, Query, Request
from fastapi.responses import HTMLResponse, JSONResponse
from app.timezone import today_kst
from . import common
from .adapters.registry import all_adapters, get_adapter
router = APIRouter(prefix="/performance", tags=["performance"])
MAX_EVENT_DAYS = 31
MAX_CHECK_DAYS = 62 # 쇼핑몰 화면 일별 비교(카페24 일별 매출내역 붙여넣기)
MAX_BACKFILL_DAYS = 366
MAX_USER_SYNC_DAYS = 92 # 관리자가 아니어도 가져올 수 있는 기간(이번달·직접선택 짧은 기간)
def _parse_date(value: Any, *, field: str = "날짜") -> date | None:
if value in (None, ""):
return None
try:
return date.fromisoformat(str(value)[:10])
except ValueError:
raise HTTPException(status_code=400, detail=f"{field} 형식이 올바르지 않습니다(YYYY-MM-DD).") from None
def _holidays() -> dict[str, str]:
try:
from app.modules.project.store import KR_HOLIDAYS # noqa: WPS433 — 공휴일 표 공유(읽기 전용)
return dict(KR_HOLIDAYS)
except Exception: # noqa: BLE001
return {}
def _code_or_404(store: Any, code: str):
adapter = get_adapter(code)
if adapter is None or code not in {m["code"] for m in store.list_marketplaces()}:
raise HTTPException(status_code=404, detail="알 수 없는 쇼핑몰입니다.")
return adapter
@router.get("/health")
def health(request: Request) -> JSONResponse:
st = common.get_store(request)
return JSONResponse({"ok": st is not None, "module": "performance",
"encryption_key": common.key_status()["ok"]})
# ════════════════════════════════════════════════════════════
# 화면
# ════════════════════════════════════════════════════════════
@router.get("/", response_class=HTMLResponse)
def dashboard_page(
request: Request,
period: str = "week",
d: str | None = None,
from_: str | None = Query(None, alias="from"),
to: str | None = None,
m: list[str] = Query(default=[]),
metric: str = "gross",
):
from app.main import render_template # noqa: WPS433
g = common.guard(request)
if not isinstance(g, tuple):
return g
store, user = g
from .dashboard import build_dashboard # noqa: WPS433
today = today_kst()
anchor = _parse_date(d) or today
creds, _ = common.services(request, store)
ctx = build_dashboard(
store, kind=period, anchor=anchor, today=today,
custom_from=_parse_date(from_), custom_to=_parse_date(to), selected=m,
holidays=_holidays(), configured=creds.configured_codes(list(all_adapters())),
)
ctx["metric"] = metric if metric in ("gross", "commission", "net") else "gross"
return render_template(request, "performance/index.html", {**common.base_ctx(user, active_tab="dashboard"), **ctx})
@router.get("/settings", response_class=HTMLResponse)
def settings_page(request: Request):
from app.main import render_template # noqa: WPS433
g = common.guard(request, admin=True)
if not isinstance(g, tuple):
return g
store, user = g
from .dashboard import build_settings # noqa: WPS433
creds, _ = common.services(request, store)
ctx = build_settings(
store, configured=creds.configured_codes(list(all_adapters())), key_info=common.key_status(),
key_versions_in_use=creds.key_versions_in_use(), sample_count=store.sample_count(),
)
return render_template(request, "performance/settings.html",
{**common.base_ctx(user, active_tab="settings", page_title="실적 설정"), **ctx})
# ════════════════════════════════════════════════════════════
# JSON API — 모듈 권한
# ════════════════════════════════════════════════════════════
@router.post("/api/sync")
def api_sync(request: Request, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
"""from/to 가 없으면 최근 N일(PERFORMANCE_SYNC_DAYS). 기간 지정은 대시보드 [매출 업데이트](보고 있는 기간)와
설정 [과거 매출 가져오기]가 쓴다 — 모듈 권한자는 92일까지, 그보다 길면(최대 366일) 관리자만."""
store, user = common.require_store(request)
_, sync = common.services(request, store)
codes = [str(c) for c in (payload.get("codes") or []) if get_adapter(str(c))]
start = _parse_date(payload.get("from"), field="시작일")
end = _parse_date(payload.get("to"), field="종료일")
if start or end:
from app.store import is_admin # noqa: WPS433
end = end or today_kst()
start = start or end
if end < start:
start, end = end, start
if end > today_kst():
end = today_kst()
if start > end:
raise HTTPException(status_code=400, detail="앞으로의 기간은 가져올 수 없습니다.")
days = (end - start).days + 1
if days > MAX_BACKFILL_DAYS:
raise HTTPException(status_code=400, detail=f"한 번에 {MAX_BACKFILL_DAYS}일까지 가져올 수 있습니다.")
if days > MAX_USER_SYNC_DAYS and not is_admin(user):
raise HTTPException(status_code=403,
detail=f"{MAX_USER_SYNC_DAYS}일보다 긴 기간은 관리자만 가져올 수 있습니다.")
if payload.get("background"):
return JSONResponse(_start_background_sync(store, sync, start=start, end=end, codes=codes or None,
user=user["email"]))
results = sync.sync_all(start=start, end=end, codes=codes or None, user=user["email"])
return JSONResponse({"results": results, "last_update_at": store.last_update_at()})
def _start_background_sync(store: Any, sync: Any, *, start: date | None, end: date | None,
codes: list[str] | None, user: str) -> dict[str, Any]:
"""수집을 스레드로 돌리고 작업 번호를 바로 돌려준다. 이미 돌고 있는 업데이트가 있으면 새로 시작하지 않고
그 작업을 보여 준다(같은 쇼핑몰 동시 실행은 어차피 막혀 있다)."""
import logging # noqa: WPS433
import threading # noqa: WPS433
from . import jobs # noqa: WPS433
live = jobs.running_job()
if live is not None:
return {"job": live.snapshot(), "joined": True}
job = jobs.create_job(user=user, start=start, end=end)
def run() -> None:
error = ""
try:
sync.sync_all(start=start, end=end, codes=codes, user=user, job=job)
except Exception as exc: # noqa: BLE001 — 스레드 밖으로 새지 않게, 화면에는 "오류"로
logging.getLogger("performance.sync").exception("background sync failed")
error = f"업데이트 중 오류: {type(exc).__name__}"
last = None
try:
last = store.last_update_at()
except Exception: # noqa: BLE001
pass
job.finish(error=error, last_update_at=last)
threading.Thread(target=run, name=f"perf-sync-{job.id}", daemon=True).start()
return {"job": job.snapshot(), "joined": False}
@router.get("/api/sync/jobs/{job_id}")
def api_sync_job(request: Request, job_id: str) -> JSONResponse:
common.require_store(request)
from . import jobs # noqa: WPS433
job = jobs.get_job(job_id)
if job is None:
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
return JSONResponse({"job": job.snapshot()})
@router.post("/api/sync/jobs/{job_id}/cancel")
def api_sync_cancel(request: Request, job_id: str) -> JSONResponse:
"""[업데이트 취소] — 시작한 사람 또는 관리자. 돌고 있는 쇼핑몰은 다음 API 호출 직전에 멈추고(저장 전이면 DB 그대로),
기다리는 쇼핑몰은 건너뛴다. 이미 저장이 끝난 쇼핑몰 결과는 그대로 남는다."""
from app.store import is_admin # noqa: WPS433
from . import jobs # noqa: WPS433
_, user = common.require_store(request)
job = jobs.get_job(job_id)
if job is None:
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
if job.user and job.user != user["email"] and not is_admin(user):
raise HTTPException(status_code=403, detail="업데이트를 시작한 사람이나 관리자만 취소할 수 있습니다.")
job.cancel(user["email"])
return JSONResponse({"job": job.snapshot()})
@router.get("/api/sync/current")
def api_sync_current(request: Request) -> JSONResponse:
common.require_store(request)
from . import jobs # noqa: WPS433
job = jobs.running_job()
return JSONResponse({"job": job.snapshot() if job else None})
@router.get("/api/events")
def api_events(request: Request, code: str, from_: str = Query(..., alias="from"), to: str | None = None) -> JSONResponse:
store, _ = common.require_store(request)
_code_or_404(store, code)
start = _parse_date(from_)
end = _parse_date(to) or start
if end < start:
start, end = end, start
if (end - start).days + 1 > MAX_EVENT_DAYS:
raise HTTPException(status_code=400, detail=f"상세 조회는 {MAX_EVENT_DAYS}일 이내만 가능합니다.")
rows = store.list_events(code, start, end)
return JSONResponse({"rows": rows, "truncated": len(rows) >= 500})
# ════════════════════════════════════════════════════════════
# JSON API — 관리자(설정)
# ════════════════════════════════════════════════════════════
@router.put("/api/marketplaces/{code}")
def api_update_marketplace(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
_code_or_404(store, code)
row = store.update_marketplace(
code,
enabled=bool(payload["enabled"]) if "enabled" in payload else None,
include_in_sales=bool(payload["include_in_sales"]) if "include_in_sales" in payload else None,
)
return JSONResponse({"marketplace": row})
@router.post("/api/marketplaces/{code}/rates")
def api_set_rate(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
store, user = common.require_store(request, admin=True)
_code_or_404(store, code)
raw = str(payload.get("rate_percent", "")).strip().rstrip("%").strip()
try:
rate = Decimal(raw)
except InvalidOperation:
raise HTTPException(status_code=400, detail="수수료율은 숫자로 입력하세요(예: 5, 10.8, 15.35).") from None
if not rate.is_finite() or rate < 0 or rate > 100:
raise HTTPException(status_code=400, detail="수수료율은 0 ~ 100 사이여야 합니다.")
if rate != rate.quantize(Decimal("0.001")):
raise HTTPException(status_code=400, detail="수수료율은 소수점 셋째 자리까지 입력할 수 있습니다.")
effective_from = _parse_date(payload.get("effective_from"), field="적용 시작일")
if effective_from is None:
raise HTTPException(status_code=400, detail="적용 시작일을 입력하세요.")
store.set_rate(code, rate_percent=rate, effective_from=effective_from,
memo=str(payload.get("memo") or "")[:200], user=user["email"])
return JSONResponse({"rates": store.list_rates(code)})
@router.get("/api/marketplaces/{code}/rates")
def api_list_rates(request: Request, code: str) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
_code_or_404(store, code)
return JSONResponse({"rates": store.list_rates(code)})
@router.delete("/api/marketplaces/{code}/rates/{rate_id}")
def api_delete_rate(request: Request, code: str, rate_id: int) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
_code_or_404(store, code)
if not store.delete_rate(code, rate_id):
raise HTTPException(status_code=404, detail="수수료 이력을 찾지 못했습니다.")
return JSONResponse({"rates": store.list_rates(code)})
@router.get("/api/marketplaces/{code}/credentials")
def api_get_credentials(request: Request, code: str) -> JSONResponse:
"""입력칸 정의 + 저장 여부만. secret 항목의 원문은 보내지 않는다."""
store, _ = common.require_store(request, admin=True)
adapter = _code_or_404(store, code)
creds, _ = common.services(request, store)
info = creds.describe(adapter)
return JSONResponse({"code": code, "name": adapter.name, "shared": adapter.uses_shared_integration,
"note": adapter.note, "docs_url": adapter.docs_url,
"key": common.key_status(), **info})
def _clean_values(adapter, payload: dict[str, Any]) -> dict[str, str]:
allowed = {f.key for f in adapter.visible_fields()}
values = payload.get("values") or {}
if not isinstance(values, dict):
raise HTTPException(status_code=400, detail="values 형식이 올바르지 않습니다.")
return {k: str(v) for k, v in values.items() if k in allowed and v is not None}
@router.put("/api/marketplaces/{code}/credentials")
def api_save_credentials(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
store, user = common.require_store(request, admin=True)
adapter = _code_or_404(store, code)
if adapter.uses_shared_integration:
raise HTTPException(status_code=400, detail=f"{adapter.name}은(는) 공통 연동을 사용해 여기서 입력하지 않습니다.")
if not common.key_status()["ok"]:
raise HTTPException(status_code=503, detail=common.key_status()["message"])
creds, _ = common.services(request, store)
values = _clean_values(adapter, payload)
clear = [str(k) for k in (payload.get("clear") or [])]
merged = creds.merged_values(adapter, values)
for k in clear:
if k in merged and not values.get(k):
merged[k] = ""
errors = adapter.validate_credentials(merged)
if errors:
raise HTTPException(status_code=400, detail=" ".join(errors))
saved = creds.save(adapter, values, clear=clear, user=user["email"])
return JSONResponse({"saved": saved, **creds.describe(adapter)})
@router.post("/api/marketplaces/{code}/test")
def api_test_connection(request: Request, code: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
"""values 가 있으면 저장하지 않은 새 입력값으로 시험(빈 칸은 저장된 값 사용)."""
store, user = common.require_store(request, admin=True)
adapter = _code_or_404(store, code)
_, sync = common.services(request, store)
values = {k: v for k, v in _clean_values(adapter, payload).items() if v.strip()}
result = sync.test_connection(code, values=values or None, user=user["email"])
return JSONResponse(result)
@router.get("/api/marketplaces/{code}/reconcile")
def api_reconcile(request: Request, code: str, date_: str = Query(..., alias="date"), to: str | None = None) -> JSONResponse:
"""쇼핑몰 화면(예: 카페24 일별 매출내역)과 비교용 — 그날 원천 금액 항목별 합계. DB 는 바꾸지 않는다."""
store, user = common.require_store(request, admin=True)
_code_or_404(store, code)
day = _parse_date(date_)
_, sync = common.services(request, store)
return JSONResponse(sync.reconcile(code, day, to=_parse_date(to, field="종료일"), user=user["email"]))
@router.get("/api/marketplaces/{code}/daily-check")
def api_daily_check(request: Request, code: str, from_: str = Query(..., alias="from"), to: str | None = None,
live: bool = False) -> JSONResponse:
"""쇼핑몰 화면 일별 매출과 날짜별 비교 — 저장값(db) + live=1 이면 지금 API 로 다시 계산한 값(저장 안 함)."""
store, user = common.require_store(request, admin=True)
_code_or_404(store, code)
start = _parse_date(from_)
end = _parse_date(to) or start
if end < start:
start, end = end, start
if (end - start).days + 1 > MAX_CHECK_DAYS:
raise HTTPException(status_code=400, detail=f"일별 비교는 {MAX_CHECK_DAYS}일 이내만 가능합니다.")
_, sync = common.services(request, store)
return JSONResponse(sync.daily_check(code, start, end, live=live, user=user["email"]))
@router.post("/api/sample-data")
def api_sample_data(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
action = payload.get("action")
if action == "delete":
return JSONResponse({"deleted": store.delete_sample_events(), "sample_count": store.sample_count()})
if action != "generate":
raise HTTPException(status_code=400, detail="action 은 generate 또는 delete 입니다.")
today = today_kst()
start = _parse_date(payload.get("from")) or today.replace(month=1, day=1)
end = _parse_date(payload.get("to")) or today
if end < start:
start, end = end, start
if (end - start).days > 400:
raise HTTPException(status_code=400, detail="테스트 데이터는 한 번에 400일까지 만들 수 있습니다.")
codes = [m["code"] for m in store.list_marketplaces() if m["enabled"]]
_, sync = common.services(request, store)
n = sync.generate_samples(start, end, codes)
return JSONResponse({"generated": n, "sample_count": store.sample_count()})
@router.post("/api/rekey")
def api_rekey(request: Request) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
if not common.key_status()["ok"]:
raise HTTPException(status_code=503, detail=common.key_status()["message"])
creds, _ = common.services(request, store)
return JSONResponse({**creds.reencrypt_all(), "versions_in_use": creds.key_versions_in_use()})
@@ -0,0 +1 @@
"""② API 인증정보 보안 — 암호화(crypto) · 비밀값 가리기(redact)."""
+161
View File
@@ -0,0 +1,161 @@
"""쇼핑몰 인증정보 암호화 — AES-256-GCM(인증 암호화) + 키 버전.
- 라이브러리: `cryptography` 의 AESGCM (직접 만든 알고리즘 없음).
- 해시가 아니라 **복호화 가능한** 암호화다 — API Secret/Token 은 나중에 원문이 필요하다.
- 마스터 키는 DB 에 두지 않는다. 환경변수(.env)에서만 읽는다.
APP_ENCRYPTION_KEY 현재 키(32바이트). `openssl rand -hex 32` 의 64자 hex
또는 32바이트 base64/base64url 둘 다 받는다.
APP_ENCRYPTION_KEY_VERSION 현재 키의 버전 번호(기본 1).
APP_ENCRYPTION_KEY_V{n} 키 교체 중 남겨 두는 예전 키(버전 n). 재암호화가
끝나면 지운다.
암호문 형식: ``v{버전}:{base64url(nonce 12바이트 + 암호문 + tag 16바이트)}``
AAD(추가 인증 데이터)로 "어느 쇼핑몰의 어느 항목"인지를 묶는다
(예: ``perf:coupang:secret_key``). DB 에서 암호문을 다른 행/칸으로 옮겨 붙이면
복호화가 실패한다.
"""
from __future__ import annotations
import base64
import binascii
import os
import re
from dataclasses import dataclass, field
from typing import Mapping
KEY_ENV = "APP_ENCRYPTION_KEY"
VERSION_ENV = "APP_ENCRYPTION_KEY_VERSION"
_OLD_KEY_RE = re.compile(r"^APP_ENCRYPTION_KEY_V(\d+)$")
_TOKEN_RE = re.compile(r"^v(\d+):([A-Za-z0-9_\-]+={0,2})$")
_NONCE_LEN = 12
class CryptoConfigError(RuntimeError):
"""마스터 키가 없거나 형식이 틀림 — 설정 문제."""
class DecryptError(RuntimeError):
"""복호화 실패(키 버전 없음/키 바뀜/손상/다른 칸의 암호문). 원문·키는 메시지에 넣지 않는다."""
def _parse_key(raw: str, *, name: str) -> bytes:
value = (raw or "").strip()
if not value:
raise CryptoConfigError(f"{name} 가 비어 있습니다.")
if re.fullmatch(r"[0-9a-fA-F]{64}", value):
return bytes.fromhex(value)
try:
padded = value + "=" * (-len(value) % 4)
decoded = base64.urlsafe_b64decode(padded.replace("+", "-").replace("/", "_"))
except (binascii.Error, ValueError):
decoded = b""
if len(decoded) == 32:
return decoded
raise CryptoConfigError(
f"{name} 형식이 올바르지 않습니다. 32바이트 키가 필요합니다 "
"(`openssl rand -hex 32` 로 만든 64자 hex 권장)."
)
@dataclass(frozen=True)
class KeyRing:
"""현재 키 + (교체 중이면) 예전 키들. 키 값은 repr 에 나오지 않는다."""
current_version: int
_keys: Mapping[int, bytes] = field(repr=False)
@classmethod
def from_env(cls, environ: Mapping[str, str] | None = None) -> "KeyRing":
env = os.environ if environ is None else environ
raw_current = (env.get(KEY_ENV) or "").strip()
if not raw_current:
raise CryptoConfigError(
f"{KEY_ENV} 환경변수가 설정되지 않았습니다. "
"`openssl rand -hex 32` 로 값을 만들어 .env 에 넣고 컨테이너를 재기동하세요."
)
try:
version = int((env.get(VERSION_ENV) or "1").strip())
except ValueError:
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.") from None
if version < 1:
raise CryptoConfigError(f"{VERSION_ENV} 는 1 이상의 정수여야 합니다.")
keys: dict[int, bytes] = {}
for name, raw in env.items():
m = _OLD_KEY_RE.match(name)
if m and (raw or "").strip():
keys[int(m.group(1))] = _parse_key(raw, name=name)
keys[version] = _parse_key(raw_current, name=KEY_ENV)
return cls(current_version=version, _keys=keys)
@property
def versions(self) -> list[int]:
return sorted(self._keys)
def key(self, version: int) -> bytes:
try:
return self._keys[version]
except KeyError:
raise DecryptError(
f"암호화 키 버전 v{version} 이 서버에 없습니다. "
f"{KEY_ENV}_V{version} 환경변수를 확인하세요."
) from None
def _aesgcm(key: bytes):
from cryptography.hazmat.primitives.ciphers.aead import AESGCM # 지연 import
return AESGCM(key)
def encrypt(plaintext: str, *, aad: str, ring: KeyRing) -> str:
"""평문 → ``v{버전}:{...}``. 항상 현재 키로 암호화한다."""
if plaintext is None:
raise ValueError("암호화할 값이 없습니다.")
nonce = os.urandom(_NONCE_LEN)
ct = _aesgcm(ring.key(ring.current_version)).encrypt(
nonce, plaintext.encode("utf-8"), aad.encode("utf-8")
)
body = base64.urlsafe_b64encode(nonce + ct).decode("ascii")
return f"v{ring.current_version}:{body}"
def key_version_of(token: str) -> int:
m = _TOKEN_RE.match(token or "")
if not m:
raise DecryptError("암호문 형식이 올바르지 않습니다.")
return int(m.group(1))
def decrypt(token: str, *, aad: str, ring: KeyRing) -> str:
"""``v{버전}:{...}`` → 평문. 실패 원인은 알려 주되 값은 절대 담지 않는다."""
m = _TOKEN_RE.match(token or "")
if not m:
raise DecryptError("암호문 형식이 올바르지 않습니다.")
version = int(m.group(1))
try:
raw = base64.urlsafe_b64decode(m.group(2))
except (binascii.Error, ValueError):
raise DecryptError("암호문이 손상되었습니다.") from None
if len(raw) <= _NONCE_LEN:
raise DecryptError("암호문이 손상되었습니다.")
from cryptography.exceptions import InvalidTag # 지연 import
try:
pt = _aesgcm(ring.key(version)).decrypt(raw[:_NONCE_LEN], raw[_NONCE_LEN:], aad.encode("utf-8"))
except InvalidTag:
raise DecryptError(
"복호화하지 못했습니다. 마스터 키가 바뀌었거나 값이 손상되었습니다. "
"인증정보를 다시 입력해야 할 수 있습니다."
) from None
return pt.decode("utf-8")
def needs_reencrypt(token: str, ring: KeyRing) -> bool:
"""현재 키 버전이 아닌 암호문인가(키 교체 후 재암호화 대상)."""
try:
return key_version_of(token) != ring.current_version
except DecryptError:
return False
@@ -0,0 +1,95 @@
"""비밀값 가리기 — 오류 메시지·로그·원본 데이터(raw_data)에 인증정보가 남지 않게.
원칙은 "애초에 남기지 않는다"이고, 이 모듈은 그래도 섞여 들어올 수 있는 값을
걸러내는 마지막 방어선이다.
- `redact_text(text, known_secrets)`: 문자열 안의 비밀값을 가린다.
· 알고 있는 실제 비밀값(저장된 인증정보 원문)은 어디에 있든 통째로 치환
· "Authorization: ...", "Bearer ...", "Basic ...", 쿠키
· key=value / "key": "value" 형태에서 key 가 비밀 이름(password, secret, token …)인 값
· 길이 제한(기본 300자)
- `redact_mapping(obj)`: dict/list 를 깊이 복사하며 비밀 이름 키의 값을 가린다.
- `mask(value)`: 꼭 보여야 할 때 앞 4자 + **** + 뒤 4자(짧으면 전부 가림).
"""
from __future__ import annotations
import re
from typing import Any, Iterable
MASK = "****"
# 이름만 보고 비밀로 판단하는 키(대소문자 무시, 부분 일치).
_SENSITIVE_NAME = re.compile(
r"(pass(word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key|private[_\-]?key|"
r"authorization|auth[_\-]?header|cookie|session|signature|credential|client[_\-]?secret|"
r"refresh|bearer|x[_\-]?api)",
re.IGNORECASE,
)
# 헤더 이름 뒤의 "인증 방식 + 값" 한 덩어리(예: Bearer xxx, CEA algorithm=…, signature=…).
_AUTH_HEADER = re.compile(
r"(?i)\b(authorization|proxy-authorization)[\"']?\s*[:=]\s*[\"']?"
r"(?:(?:bearer|basic|digest|cea|hmac\S*)\s+)?[^\s\"',;}\]]+"
)
_BEARER = re.compile(r"(?i)\b(bearer|basic|cea)\s+[A-Za-z0-9._~+/=\-]{6,}")
_COOKIE = re.compile(r"(?i)\b(set-cookie|cookie)\s*[:=]\s*[^\r\n]+")
_KV = re.compile(
r"""(?ix)
(["']?) # 여는 따옴표(선택)
([A-Za-z0-9_\-\.]*? # 키 이름
(?:pass(?:word|wd)?|pwd|secret|token|api[_\-]?key|access[_\-]?key|
private[_\-]?key|signature|credential|client[_\-]?secret|refresh)
[A-Za-z0-9_\-\.]*)
\1\s*[:=]\s*
(["']?)([^"'&\s,;}\]]+)\3
"""
)
DEFAULT_MAX_LEN = 300
def is_sensitive_name(name: str) -> bool:
return bool(_SENSITIVE_NAME.search(name or ""))
def mask(value: str | None) -> str:
v = value or ""
if len(v) < 12:
return MASK
return f"{v[:4]}{MASK}{v[-4:]}"
def redact_text(
text: Any,
known_secrets: Iterable[str] = (),
*,
max_len: int = DEFAULT_MAX_LEN,
) -> str:
s = "" if text is None else str(text)
for secret in sorted({x for x in known_secrets if x and len(x) >= 4}, key=len, reverse=True):
s = s.replace(secret, MASK)
s = _AUTH_HEADER.sub(lambda m: f"{m.group(1)}: {MASK}", s)
s = _COOKIE.sub(lambda m: f"{m.group(1)}: {MASK}", s)
s = _BEARER.sub(lambda m: f"{m.group(1)} {MASK}", s)
s = _KV.sub(lambda m: f"{m.group(1)}{m.group(2)}{m.group(1)}={MASK}", s)
if max_len and len(s) > max_len:
s = s[:max_len] + "…"
return s
def redact_mapping(obj: Any, known_secrets: Iterable[str] = ()) -> Any:
secrets = tuple(known_secrets)
if isinstance(obj, dict):
out: dict[str, Any] = {}
for k, v in obj.items():
if is_sensitive_name(str(k)):
out[k] = MASK
else:
out[k] = redact_mapping(v, secrets)
return out
if isinstance(obj, (list, tuple)):
return [redact_mapping(v, secrets) for v in obj]
if isinstance(obj, str):
return redact_text(obj, secrets, max_len=0) if secrets else obj
return obj
+235
View File
@@ -0,0 +1,235 @@
"""① 수집 서비스 — 쇼핑몰 API → 어댑터 → 공통 사건 → DB. 화면(버튼)과 분리된 공통 로직.
- 버튼(매출 업데이트)·연결 테스트·향후 cron/worker 모두 이 서비스를 부른다.
- 같은 쇼핑몰은 동시에 한 번만(perf_sync_runs 의 running 부분 유니크 인덱스).
- 쇼핑몰 하나가 실패해도 나머지는 계속한다. 실패한 쇼핑몰만 상태가 오류로 바뀐다.
- 오류 문구·원본 데이터는 비밀값을 가린 뒤에만 저장/로그한다.
매출 기준일(sales_date) — 한 곳에서만 정한다(`sales_date_for`):
결제(SALE) = 결제일(payment_date, 없으면 event_date)
취소/반품 = 발생일(event_date) — 지난 실적이 나중에 바뀌지 않게
"""
from __future__ import annotations
import logging
import os
from dataclasses import asdict
from datetime import date, timedelta
from typing import Any, Iterable
from app.timezone import today_kst
from .adapters.base import STATUS_LABELS, AdapterContext, AdapterError, Cancelled, MarketplaceAdapter, SaleEvent
from .adapters.registry import all_adapters, get_adapter
from .credentials import CredentialService
from .security.crypto import CryptoConfigError, DecryptError
from .security.redact import redact_mapping, redact_text
logger = logging.getLogger("performance.sync")
DEFAULT_SYNC_DAYS = 7
def sync_days() -> int:
try:
return max(1, min(90, int(os.getenv("PERFORMANCE_SYNC_DAYS", str(DEFAULT_SYNC_DAYS)))))
except ValueError:
return DEFAULT_SYNC_DAYS
def sales_date_for(ev: SaleEvent) -> date:
if ev.event_type == "SALE":
return ev.payment_date or ev.event_date
return ev.event_date
def event_row(ev: SaleEvent, known_secrets: Iterable[str] = ()) -> dict[str, Any]:
row = asdict(ev)
row["sales_date"] = sales_date_for(ev)
row["raw"] = redact_mapping(ev.raw or {}, known_secrets)
return row
class SyncService:
def __init__(self, store: Any, creds: CredentialService, *, app_state: Any = None) -> None:
self._store = store
self._creds = creds
self._app_state = app_state
def _ctx(self, adapter: MarketplaceAdapter, *, overrides: dict[str, str] | None = None,
persist: bool = True, user: str = "") -> AdapterContext:
acc = self._creds.accessor(adapter.code, overrides=overrides, persist=persist, user=user)
return AdapterContext(code=adapter.code, credentials=acc, app_state=self._app_state)
@staticmethod
def _failure(exc: Exception, ctx: AdapterContext | None) -> tuple[str, str]:
known = ctx.credentials.known_secrets() if ctx is not None else []
if isinstance(exc, AdapterError):
return exc.status, redact_text(exc.message, known)
if isinstance(exc, (DecryptError, CryptoConfigError)):
return "not_configured", redact_text(str(exc), known)
return "api_error", redact_text(f"예상하지 못한 오류: {type(exc).__name__}: {exc}", known)
# ── 연결 테스트 ─────────────────────────────────────────
def test_connection(self, code: str, *, values: dict[str, str] | None = None, user: str = "") -> dict[str, Any]:
"""values 를 주면 저장하지 않은 새 입력값으로 시험(저장된 상태는 바꾸지 않음)."""
adapter = get_adapter(code)
if adapter is None:
return {"ok": False, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."}
unsaved = bool(values)
ctx = None
try:
ctx = self._ctx(adapter, overrides=values, persist=not unsaved, user=user)
message = adapter.test_connection(ctx)
status, ok = "ok", True
except Exception as exc: # noqa: BLE001 — 어떤 오류든 상태로 바꿔 화면에 보여 준다
status, message = self._failure(exc, ctx)
ok = False
logger.info("performance test %s: %s %s", code, status, message)
if not unsaved:
self._store.record_test(code, status=status, ok=ok, error="" if ok else message)
return {"ok": ok, "status": status, "label": STATUS_LABELS.get(status, status),
"message": message, "unsaved": unsaved}
# ── 동기화 ──────────────────────────────────────────────
def sync_marketplace(self, code: str, start: date, end: date, *, trigger: str = "manual",
user: str = "", progress: Any = None) -> dict[str, Any]:
"""progress: jobs.ShopProgress(매출 업데이트 창 진행 막대) — 없으면 알리지 않는다."""
adapter = get_adapter(code)
result: dict[str, Any] = {"code": code, "ok": False, "skipped": False, "fetched": 0, "upserted": 0}
if adapter is None:
if progress is not None:
progress.fail(status="api_error", label=STATUS_LABELS["api_error"], message="알 수 없는 쇼핑몰입니다.")
return {**result, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."}
if progress is not None and progress.cancel_requested: # [업데이트 취소] 뒤 차례가 온 쇼핑몰
progress.cancelled()
return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"}
run_id = self._store.start_run(code, trigger=trigger, range_from=start, range_to=end, user=user)
if run_id is None:
if progress is not None:
progress.skip("이미 다른 업데이트가 진행 중입니다.")
return {**result, "skipped": True, "status": "running", "message": "이미 업데이트 중입니다."}
if progress is not None:
progress.start()
ctx = None
try:
ctx = self._ctx(adapter, user=user)
if progress is not None:
ctx.progress = progress
fetched, events = adapter.collect(ctx, start, end)
if progress is not None:
progress.saving()
known = ctx.credentials.known_secrets()
rows = [event_row(ev, known) for ev in events]
# 다른 쇼핑몰 열로 보낸 사건 — 등록된 쇼핑몰이 아니면 이 쇼핑몰 열에 둔다(합계가 빠지지 않게).
registered = {m["code"] for m in self._store.list_marketplaces()}
for r in rows:
if r.get("marketplace_code") not in registered:
r["marketplace_code"] = code
if adapter.replace_range:
# 그 기간을 통째로 다시 받은 쇼핑몰 — 기간 안 예전 행을 지우고 새로 넣는다(한 트랜잭션).
rows = [r for r in rows if start <= r["sales_date"] <= end]
upserted = self._store.replace_events(code, start, end, rows, id_prefix=adapter.event_prefix)
else:
upserted = self._store.upsert_events(code, rows)
self._store.finish_run(run_id, ok=True, fetched=fetched, upserted=upserted)
self._store.record_sync(code, status="ok", ok=True)
if progress is not None:
progress.finish(upserted=upserted, message=f"{upserted}건 반영")
return {**result, "ok": True, "status": "ok", "fetched": fetched, "upserted": upserted,
"message": f"{upserted}건 반영"}
except Cancelled:
# 수집 중 취소 — 아직 아무것도 저장하지 않았다. 연결 상태(오류 표시)는 바꾸지 않는다.
self._store.finish_run(run_id, ok=False, error="업데이트 취소")
if progress is not None:
progress.cancelled()
return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"}
except Exception as exc: # noqa: BLE001 — 한 쇼핑몰 실패가 전체를 멈추지 않게
status, message = self._failure(exc, ctx)
logger.warning("performance sync %s failed: %s %s", code, status, message)
self._store.finish_run(run_id, ok=False, error=message)
self._store.record_sync(code, status=status, ok=False, error=message)
if progress is not None:
progress.fail(status=status, label=STATUS_LABELS.get(status, status), message=message)
return {**result, "status": status, "label": STATUS_LABELS.get(status, status), "message": message}
def sync_all(self, *, start: date | None = None, end: date | None = None, codes: list[str] | None = None,
trigger: str = "manual", user: str = "", job: Any = None) -> list[dict[str, Any]]:
"""job: jobs.SyncJob — 주면 쇼핑몰마다 진행 상황(ShopProgress)을 채운다(매출 업데이트 창)."""
end = end or today_kst()
start = start or (end - timedelta(days=sync_days() - 1))
enabled = {m["code"] for m in self._store.list_marketplaces() if m["enabled"]}
targets = [a for a in all_adapters() if a.code in enabled and (not codes or a.code in codes)]
progress: dict[str, Any] = {}
if job is not None:
# 수집이 구현되고 인증정보가 있는 쇼핑몰만 막대로(active), 나머지는 "건너뜀" 한 줄로 — 바로 끝나는
# 쇼핑몰이 전체 진행률을 부풀리거나, 아직 차례가 안 와서 진행률을 낮추지 않게.
def ready(a: MarketplaceAdapter) -> bool:
if not a.implemented:
return False
try:
return a.is_configured(self._ctx(a, user=user))
except Exception: # noqa: BLE001 — 확인이 안 되면 일단 막대로(실제 결과는 수집 때 나온다)
return True
progress = job.set_targets([(a.code, a.name, ready(a)) for a in targets], start, end)
return [self.sync_marketplace(a.code, start, end, trigger=trigger, user=user, progress=progress.get(a.code))
for a in targets]
# ── 쇼핑몰 화면과 대조 ────────────────────────────────
def reconcile(self, code: str, day: date, *, to: date | None = None, user: str = "") -> dict[str, Any]:
"""어댑터가 지원하면(reconcile) 그날 원천 금액을 항목별로 합산해 돌려준다. DB 는 바꾸지 않는다."""
adapter = get_adapter(code)
if adapter is None or not hasattr(adapter, "reconcile"):
return {"ok": False, "message": "이 쇼핑몰은 대조 기능을 지원하지 않습니다."}
ctx = None
try:
ctx = self._ctx(adapter, user=user)
return {"ok": True, **(adapter.reconcile(ctx, day, to=to) if to else adapter.reconcile(ctx, day))}
except Exception as exc: # noqa: BLE001
status, message = self._failure(exc, ctx)
return {"ok": False, "status": status, "label": STATUS_LABELS.get(status, status), "message": message}
def daily_check(self, code: str, start: date, end: date, *, live: bool = False, user: str = "") -> dict[str, Any]:
"""쇼핑몰 화면 일별 매출과 날짜별로 맞춰 보는 용도. DB 는 바꾸지 않는다.
db = 지금 저장된 값(날짜별 결제·환불·결제 건수)
live = live=True 일 때 지금 API·현재 규칙으로 다시 계산한 값(매출 업데이트와 같은 계산, 저장 안 함).
db 만 틀리고 live 가 맞으면 → 예전에 받은 뒤 규칙·주문이 바뀐 것(다시 가져오면 해결)."""
adapter = get_adapter(code)
if adapter is None:
return {"ok": False, "message": "알 수 없는 쇼핑몰입니다."}
prefix = adapter.event_prefix if adapter.replace_range else ""
out: dict[str, Any] = {"ok": True, "db": self._store.daily_breakdown(code, start, end, id_prefix=prefix)}
if not live:
return out
ctx = None
try:
ctx = self._ctx(adapter, user=user)
_, events = adapter.collect(ctx, start, end)
except Exception as exc: # noqa: BLE001
status, message = self._failure(exc, ctx)
return {**out, "live_error": f"{STATUS_LABELS.get(status, status)} — {message}"}
days: dict[str, dict[str, Any]] = {}
for ev in events:
d = sales_date_for(ev)
if not (start <= d <= end):
continue
row = days.setdefault(d.isoformat(), {"date": d.isoformat(), "paid": 0, "orders": 0, "refund": 0})
if ev.event_type == "SALE":
row["paid"] += ev.amount
row["orders"] += 1
else:
row["refund"] -= ev.amount
out["live"] = sorted(days.values(), key=lambda r: r["date"])
return out
# ── 테스트(모의) 데이터 ────────────────────────────────
def generate_samples(self, start: date, end: date, codes: list[str]) -> int:
from .adapters import mock # noqa: WPS433
n = 0
for code in codes:
n += self._store.upsert_events(code, (event_row(ev) for ev in mock.generate(code, start, end)),
is_sample=True)
return n
@@ -0,0 +1,7 @@
{# 실적 모듈 탭 — 설정 탭은 관리자에게만(서버도 관리자만 허용). #}
<nav class="perf-tabs" aria-label="실적 메뉴">
<a class="perf-tab{% if active_tab == 'dashboard' %} is-active{% endif %}" href="/performance/">실적</a>
{% if is_admin %}
<a class="perf-tab{% if active_tab == 'settings' %} is-active{% endif %}" href="/performance/settings">설정</a>
{% endif %}
</nav>
@@ -0,0 +1,242 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930g" />{% endblock %}
{%- macro won(v) -%}
{%- if v is none -%}<span class="perf-na"></span>
{%- elif v == 0 -%}<span class="perf-zero">–</span>
{%- else -%}{{ "{:,}".format(v) }}{%- endif -%}
{%- endmacro -%}
{#- 한 칸에 총매출/수수료/차감매출 세 값을 넣고, 보기 전환은 CSS(data-metric)로. -#}
{%- macro m3(m) -%}
<span class="v v-gross">{{ won(m.gross) }}</span><span class="v v-commission">{{ won(m.commission) }}</span><span class="v v-net">{{ won(m.net) }}</span>
{%- endmacro -%}
{% block content %}
<section class="perf" id="perf-dash" data-metric="{{ metric }}">
{% include "performance/_tabs.html" %}
<!-- ── 기간 · 필터 · 업데이트 ── -->
<div class="perf-toolbar">
<div class="perf-quick" role="group" aria-label="기간 선택">
{% for q in nav.quick %}
<a class="perf-seg{% if q.active %} is-active{% endif %}" href="{{ q.url }}">{{ q.label }}</a>
{% endfor %}
<button type="button" class="perf-seg{% if period_kind == 'custom' %} is-active{% endif %}" id="perf-custom-btn">직접선택</button>
</div>
<div class="perf-nav">
<a class="perf-nav-btn" href="{{ nav.prev }}" title="{{ period.prev_label }}">‹ {{ period.prev_label }}</a>
<span class="perf-nav-label">{{ period.label }}</span>
<a class="perf-nav-btn" href="{{ nav.next }}" title="{{ period.next_label }}">{{ period.next_label }} ›</a>
</div>
<form class="perf-custom" id="perf-custom" method="get" action="/performance/"{% if period_kind != 'custom' %} hidden{% endif %}>
<input type="hidden" name="period" value="custom" />
<input class="erp-input perf-date" type="date" name="from" value="{{ period.start.isoformat() }}" required />
<span class="perf-muted">~</span>
<input class="erp-input perf-date" type="date" name="to" value="{{ period.end.isoformat() }}" required />
{% for c in codes %}{% if not selected_all %}<input type="hidden" name="m" value="{{ c }}" />{% endif %}{% endfor %}
<button class="erp-btn erp-btn-outline" type="submit">조회</button>
</form>
<details class="perf-filter" id="perf-filter">
<summary class="erp-btn erp-btn-outline">쇼핑몰: {% if selected_all %}전체{% else %}{{ codes | length }}곳{% endif %}</summary>
<form class="perf-filter-pop" method="get" action="/performance/">
<input type="hidden" name="period" value="{{ period_kind }}" />
{% if period_kind == 'custom' %}
<input type="hidden" name="from" value="{{ period.start.isoformat() }}" />
<input type="hidden" name="to" value="{{ period.end.isoformat() }}" />
{% else %}
<input type="hidden" name="d" value="{{ period.anchor.isoformat() }}" />
{% endif %}
{% for c in all_codes %}
<label class="perf-check"><input type="checkbox" name="m" value="{{ c }}"{% if c in codes %} checked{% endif %} /> {{ names[c] }}</label>
{% endfor %}
<div class="perf-filter-act">
<button type="button" class="erp-btn erp-btn-ghost" data-perf-check-all>전체</button>
<button type="submit" class="erp-btn erp-btn-primary">적용</button>
</div>
</form>
</details>
<div class="perf-update">
<span class="perf-muted" id="perf-last-update">마지막 업데이트
<b>{{ (last_update_at or '')[:16] | replace('T', ' ') or '—' }}</b></span>
<button type="button" class="erp-btn erp-btn-primary" id="perf-sync-btn"{% if running %} disabled{% endif %}
title="지금 보고 있는 기간({{ period.label }}, 오늘까지)의 매출을 쇼핑몰에서 다시 가져옵니다">
{% if running %}업데이트 중…{% else %}매출 업데이트{% endif %}
</button>
</div>
</div>
{% if no_marketplaces %}
<div class="perf-notice">매출에 포함된 쇼핑몰이 없습니다. {% if is_admin %}<a href="/performance/settings">실적 설정</a>에서 쇼핑몰 사용을 켜세요.{% endif %}</div>
{% endif %}
{% if problems %}
<div class="perf-notice is-warn" id="perf-problems">
<b>연결 오류</b>
{% for p in problems %}<span class="perf-problem" title="{{ p.error }}">{{ p.name }} · {{ p.label }}</span>{% endfor %}
<span class="perf-muted">— 해당 쇼핑몰은 마지막 정상 수집분까지만 반영됩니다. 나머지는 정상입니다.</span>
</div>
{% endif %}
<div class="perf-notice" id="perf-sync-result" hidden></div>
<!-- ── KPI ── -->
<div class="perf-kpis">
{% for k in kpis %}
<div class="perf-kpi{% if k.primary %} is-primary{% endif %}">
<div class="perf-kpi-label">{{ k.label }}</div>
<div class="perf-kpi-value">₩{{ "{:,}".format(k.value) }}</div>
<div class="perf-kpi-delta">
{% if k.delta is none %}<span class="perf-muted">{{ k.cmp }} 비교 없음</span>
{% else %}
{% set up = k.delta > 0 %}
<span class="perf-delta {% if k.delta == 0 %}is-flat{% elif up != (k.invert or false) %}is-up{% else %}is-down{% endif %}">
{% if k.delta > 0 %}▲{% elif k.delta < 0 %}▼{% else %}–{% endif %} {{ "%.1f" | format(k.delta | abs) }}%</span>
<span class="perf-muted">{{ k.cmp }} 대비</span>
{% endif %}
</div>
</div>
{% endfor %}
</div>
<!-- ── 일자 × 쇼핑몰 ── -->
<div class="erp-card perf-card">
<div class="perf-card-head">
<h2 class="perf-h">{% if period_kind == 'year' %}월별 × 쇼핑몰{% else %}일자별 × 쇼핑몰{% endif %}</h2>
<div class="perf-metric" role="group" aria-label="표시 기준">
<button type="button" class="perf-seg" data-metric="gross">총매출</button>
<button type="button" class="perf-seg" data-metric="commission">수수료</button>
<button type="button" class="perf-seg" data-metric="net">수수료 차감 매출</button>
</div>
</div>
<div class="erp-table-wrap perf-table-wrap">
<table class="perf-table perf-main">
<thead>
<tr>
<th class="perf-th-label">{% if period_kind == 'year' %}월{% else %}날짜{% endif %}</th>
{% for c in codes %}<th title="{{ names[c] }}">{{ short_names[c] }}</th>{% endfor %}
<th class="perf-th-total">{% if period_kind == 'year' %}월 합계{% else %}일 합계{% endif %}</th>
</tr>
</thead>
<tbody>
{% for r in table %}
<tr class="perf-row-{{ r.kind }}{% if r.weekday == 5 %} is-sat{% endif %}{% if r.weekday == 6 or r.holiday %} is-sun{% endif %}{% if r.today %} is-today{% endif %}{% if r.future %} is-future{% endif %}">
<th class="perf-td-label" scope="row"{% if r.holiday %} title="{{ r.holiday }}"{% endif %}>
{{ r.label }}{% if r.holiday %}<small class="perf-hol">{{ r.holiday }}</small>{% endif %}
</th>
{% for c in codes %}
{% set m = r.cells[c] %}
<td class="perf-num{% if r['from'] and (m.gross or m.commission) %} is-link{% endif %}"
{% if r['from'] %}data-code="{{ c }}" data-from="{{ r['from'] }}" data-to="{{ r['to'] }}"{% endif %}>{{ m3(m) }}</td>
{% endfor %}
<td class="perf-num perf-td-total">{{ m3(r.total) }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
</div>
<!-- ── 그래프 ── -->
<div class="perf-grid2">
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">{% if period_kind == 'year' %}월별{% else %}일별{% endif %} 매출 추이</h2>
<span class="perf-muted perf-metric-name"></span></div>
<div class="perf-chart" id="perf-chart-daily"></div>
</div>
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">쇼핑몰별 비중</h2>
<span class="perf-muted">{{ period.label }}</span></div>
<div class="perf-chart" id="perf-chart-share"></div>
</div>
</div>
<!-- ── 월 누적 · 연간 누적 ── -->
<div class="perf-grid2">
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">{{ month.label }} 쇼핑몰별 누적 실적</h2></div>
<div class="erp-table-wrap">
<table class="perf-table">
<thead><tr><th class="perf-th-label">쇼핑몰</th><th>총매출</th><th>수수료</th><th>수수료 차감 매출</th><th>매출 비중</th></tr></thead>
<tbody>
{% for r in month.rows %}
<tr>
<th class="perf-td-label" scope="row">{{ names[r.code] }}</th>
<td class="perf-num">{{ won(r.gross) }}</td>
<td class="perf-num">{{ won(r.commission) }}</td>
<td class="perf-num">{{ won(r.net) }}</td>
<td class="perf-num perf-share">
{% if r.share is not none %}<span class="perf-bar" style="--w: {{ [r.share, 0] | max }}%"></span>{{ "%.1f" | format(r.share) }}%{% else %}<span class="perf-zero">–</span>{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
<tfoot>
<tr class="perf-row-total">
<th class="perf-td-label" scope="row">합계</th>
<td class="perf-num">{{ won(month.total.gross) }}</td>
<td class="perf-num">{{ won(month.total.commission) }}</td>
<td class="perf-num">{{ won(month.total.net) }}</td>
<td class="perf-num">{% if month.total.share is not none %}100%{% else %}<span class="perf-zero">–</span>{% endif %}</td>
</tr>
</tfoot>
</table>
</div>
</div>
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">{{ year.year }}년 누적</h2></div>
<div class="perf-year-sum">
<div><span>총매출</span><b>₩{{ "{:,}".format(year.total.gross) }}</b></div>
<div><span>수수료</span><b>₩{{ "{:,}".format(year.total.commission) }}</b></div>
<div><span>수수료 차감 매출</span><b>₩{{ "{:,}".format(year.total.net) }}</b></div>
</div>
<div class="erp-table-wrap">
<table class="perf-table perf-year">
<thead><tr><th class="perf-th-label">월</th><th>총매출</th><th>수수료</th><th>수수료 차감 매출</th></tr></thead>
<tbody>
{% for r in year.rows %}
<tr class="{% if r.future %}is-future{% endif %}">
<th class="perf-td-label" scope="row">{{ r.label }}</th>
<td class="perf-num">{{ won(r.gross) }}</td>
<td class="perf-num">{{ won(r.commission) }}</td>
<td class="perf-num">{{ won(r.net) }}</td>
</tr>
{% endfor %}
</tbody>
<tfoot>
<tr class="perf-row-total">
<th class="perf-td-label" scope="row">합계</th>
<td class="perf-num">{{ won(year.total.gross) }}</td>
<td class="perf-num">{{ won(year.total.commission) }}</td>
<td class="perf-num">{{ won(year.total.net) }}</td>
</tr>
</tfoot>
</table>
</div>
</div>
</div>
<p class="perf-foot perf-muted">
매출 기준: 결제는 결제일, 취소·반품은 발생일에 반영(음수). 수수료는 그날 적용되는 쇼핑몰 수수료율로 계산하며
일·쇼핑몰 단위로 원 미만 반올림합니다. 금액을 누르면 주문 목록을 볼 수 있습니다.
</p>
</section>
<script type="application/json" id="perf-data">{{ {
"names": names,
"codes": codes,
"daily": chart_daily,
"share": chart_share,
"period_kind": period_kind,
"period_start": period.start.isoformat(),
"period_end": period.end.isoformat(),
"today": today
} | tojson }}</script>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930zb" defer></script>{% endblock %}
@@ -0,0 +1,180 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930g" />{% endblock %}
{%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%}
{% block content %}
<section class="perf perf-settings" id="perf-settings">
{% include "performance/_tabs.html" %}
{% if not key_info.ok %}
<div class="perf-notice is-warn">
<b>암호화 마스터 키가 없습니다.</b> {{ key_info.message }}
— 키가 없으면 API 인증정보를 저장할 수 없습니다(수수료 설정·대시보드는 사용 가능).
</div>
{% endif %}
<div class="erp-card perf-card">
<div class="perf-card-head">
<h2 class="perf-h">쇼핑몰 설정</h2>
<span class="perf-muted">사용 · 매출 집계 · 수수료율은 바로 저장됩니다. API 인증정보는 [설정]에서 입력합니다.</span>
</div>
<div class="erp-table-wrap">
<table class="perf-table perf-set-table">
<thead>
<tr>
<th class="perf-th-label">쇼핑몰</th>
<th>사용</th>
<th>매출 집계</th>
<th>수수료율</th>
<th>API 설정</th>
<th>연결 상태</th>
<th>마지막 동기화</th>
<th></th>
</tr>
</thead>
<tbody>
{% for r in rows %}
<tr data-code="{{ r.code }}" data-name="{{ r.name }}">
<th class="perf-td-label" scope="row">{{ r.name }}</th>
<td class="perf-center">
<label class="perf-switch" title="사용 여부">
<input type="checkbox" data-field="enabled"{% if r.enabled %} checked{% endif %} /><span></span>
</label>
</td>
<td class="perf-center">
<label class="perf-switch" title="매출 집계에 포함">
<input type="checkbox" data-field="include_in_sales"{% if r.include_in_sales %} checked{% endif %} /><span></span>
</label>
</td>
<td class="perf-rate-cell">
<span class="perf-rate">{% if r.rate %}{{ r.rate }}%{% else %}<span class="perf-muted">미설정</span>{% endif %}</span>
<button type="button" class="erp-btn erp-btn-ghost erp-btn-sm" data-act="rate"
data-has-history="{{ 1 if r.rate_history else 0 }}">변경{% if r.rate_history > 1 %} · 이력 {{ r.rate_history }}{% endif %}</button>
</td>
<td>
{% if r.shared %}<span class="perf-pill">공통 연동</span>
{% elif r.configured %}<span class="perf-pill is-ok">설정완료</span>
{% else %}<span class="perf-pill">미설정</span>{% endif %}
{% if r.via_cafe24 %}<span class="perf-pill is-ok" title="카페24 마켓 통합관리로 들어온 이 쇼핑몰 주문을 카페24 수집 때 함께 반영합니다">카페24 경유</span>{% endif %}
</td>
<td>
<span class="perf-status st-{{ r.status }}"
title="마지막 연결 테스트: {{ when(r.last_test_at) }}{% if r.last_error %}&#10;최근 오류({{ when(r.last_error_at) }}): {{ r.last_error }}{% endif %}">
<i></i>{{ r.status_label }}</span>
{% if r.last_error and r.status not in ('ok', 'disabled') %}<div class="perf-err">{{ r.last_error }}</div>{% endif %}
</td>
<td class="perf-muted perf-nowrap" title="마지막 시도: {{ when(r.last_sync_at) }}">{{ when(r.last_success_sync_at) }}</td>
<td class="perf-nowrap">
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="creds">설정</button>
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="test">연결 테스트</button>
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
<p class="perf-foot perf-muted">
수수료율은 <b>적용 시작일</b>부터 반영되고, 그 전 실적은 예전 요율로 계산됩니다(과거 실적이 바뀌지 않음).
상태에 마우스를 올리면 마지막 연결 테스트 시각과 최근 오류를 볼 수 있습니다.
</p>
</div>
<div class="perf-grid2">
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">인증정보 암호화</h2></div>
<dl class="perf-dl">
<dt>마스터 키</dt>
<dd>{% if key_info.ok %}<span class="perf-pill is-ok">설정됨 · 현재 v{{ key_info.current_version }}</span>
{% set olds = key_info.versions | reject('equalto', key_info.current_version) | list %}
{% if olds %}<span class="perf-muted">(예전 키 v{{ olds | join(', v') }} 보관 중)</span>{% endif %}
{% else %}<span class="perf-pill is-bad">미설정</span>{% endif %}</dd>
<dt>저장된 항목</dt>
<dd>{% for v, n in key_versions_in_use.items() %}v{{ v }}: {{ n }}개{% if not loop.last %}, {% endif %}{% else %}<span class="perf-muted">없음</span>{% endfor %}</dd>
</dl>
{% if stale_key_rows %}
<p class="perf-notice is-warn">예전 키로 암호화된 항목이 {{ stale_key_rows }}개 있습니다.
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" id="perf-rekey">현재 키로 다시 암호화</button></p>
{% endif %}
<p class="perf-foot perf-muted">
API 인증정보는 서버에서 AES-256-GCM 으로 암호화해 DB 에 저장합니다. 마스터 키(APP_ENCRYPTION_KEY)는 DB 가 아닌
서버 환경변수에만 있으며, 키를 잃으면 저장된 인증정보를 복구할 수 없으니 별도로 안전하게 보관하세요.
</p>
</div>
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">과거 매출 가져오기</h2></div>
<p class="perf-muted">[매출 업데이트]는 최근 며칠만 가져옵니다. 처음 연동했거나 빠진 기간이 있으면 기간을 지정해 한 번에
가져오세요(연동된 쇼핑몰만, 최대 366일). 같은 주문은 덮어써서 여러 번 해도 중복되지 않습니다.</p>
<div class="perf-sample-form">
<input class="erp-input perf-date" type="date" id="perf-backfill-from" value="{{ default_sample_from }}" />
<span class="perf-muted">~</span>
<input class="erp-input perf-date" type="date" id="perf-backfill-to" value="{{ default_sample_to }}" />
<button type="button" class="erp-btn erp-btn-primary" id="perf-backfill">가져오기</button>
</div>
<div class="perf-notice" id="perf-backfill-result" hidden></div>
</div>
<div class="erp-card perf-card perf-card-wide">
<div class="perf-card-head"><h2 class="perf-h">쇼핑몰 원본 데이터 확인</h2></div>
<p class="perf-muted">쇼핑몰 API 를 기간(최대 31일)으로 실제 불러, 받은 항목·금액 합계를 보여 줍니다(저장하지 않음).
쇼핑몰 관리자 화면에서 매출이 있던 날을 넣고 결과를 알려 주시면 그 항목으로 매출 수집을 맞춥니다.
이름·연락처·주소 같은 개인정보는 값을 보이지 않습니다.<br>
· <b>네이버</b>: 결제일 기준 상품주문 전체(상태별 합계 포함)와 날짜별 "현재 규칙 매출" — 스마트스토어센터 매출과 비교해 주세요.<br>
· <b>11번가</b>: 주문·클레임·정산 조회 주소별 동작 여부. 정산은 정산일 기준일 수 있어 매출이 있던 날부터 넉넉히(예: 3주).<br>
· <b>GS샵</b>: 매출 내역·배송비 내역(매출인식일 기준)의 항목별 합계 — 협력사 포털 매출 화면의 같은 기간 숫자와 비교해 주세요.</p>
<div class="perf-sample-form">
<select class="erp-input" id="perf-probe-code" aria-label="쇼핑몰">
<option value="naver">네이버 스마트스토어</option>
<option value="elevenst">11번가</option>
<option value="gsshop">GS샵</option>
</select>
<input class="erp-input perf-date" type="date" id="perf-probe-date" value="{{ default_sample_to }}" />
<span class="perf-muted">~</span>
<input class="erp-input perf-date" type="date" id="perf-probe-to" value="{{ default_sample_to }}" />
<button type="button" class="erp-btn erp-btn-outline" id="perf-probe">불러오기</button>
</div>
<div id="perf-probe-result"></div>
</div>
<div class="erp-card perf-card perf-card-wide">
<div class="perf-card-head"><h2 class="perf-h">카페24 매출 대조</h2></div>
<p class="perf-muted">카페24 관리자 → 통계 → 일별 매출내역과 같은 날짜를 비교합니다. 그날 결제 주문과 환불을 카페24 API 에서
바로 합산하며(저장하지 않음), 자체몰과 다른 마켓 연동 주문을 나눠 보여 줍니다.</p>
<div class="perf-sample-form">
<input class="erp-input perf-date" type="date" id="perf-recon-date" value="{{ default_sample_to }}" />
<button type="button" class="erp-btn erp-btn-outline" id="perf-recon">대조</button>
</div>
<div id="perf-recon-result"></div>
<h3 class="perf-h" style="margin:18px 0 6px">일별 한 번에 비교</h3>
<p class="perf-muted">카페24 일별 매출내역 표를 그대로 복사해 붙여 넣으면 날짜마다 결제합계·환불합계를 저장된 값과 비교합니다.
[API 값도 계산]을 켜면 지금 규칙으로 카페24에서 다시 계산한 값(저장 안 함)도 함께 보여 줘, 저장값만 틀린 날(다시 가져오면 해결)과
규칙이 틀린 날을 나눠 볼 수 있습니다. 날짜를 누르면 위 대조를 그날로 엽니다.</p>
<textarea class="erp-input perf-paste" id="perf-daily-paste" rows="5"
placeholder="2026-09-29(화) 47 116 2,475,300 … 2,477,800 158,000 2,319,800"></textarea>
<div class="perf-sample-form" style="margin-top:6px">
<label class="perf-muted"><input type="checkbox" id="perf-daily-live" /> API 값도 계산(느림)</label>
<button type="button" class="erp-btn erp-btn-outline" id="perf-daily-check">비교</button>
</div>
<div id="perf-daily-result"></div>
</div>
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">테스트 데이터</h2>
<span class="perf-muted">현재 {{ "{:,}".format(sample_count) }}건</span></div>
<p class="perf-muted">실제 API 연동 전 화면 확인용 모의 매출입니다(사용 중인 쇼핑몰 대상). 실제 데이터와 구분되어 한 번에 지울 수 있습니다.</p>
<div class="perf-sample-form">
<input class="erp-input perf-date" type="date" id="perf-sample-from" value="{{ default_sample_from }}" />
<span class="perf-muted">~</span>
<input class="erp-input perf-date" type="date" id="perf-sample-to" value="{{ default_sample_to }}" />
<button type="button" class="erp-btn erp-btn-outline" id="perf-sample-gen">생성</button>
<button type="button" class="erp-btn erp-btn-danger" id="perf-sample-del"{% if not sample_count %} disabled{% endif %}>모두 삭제</button>
</div>
</div>
</div>
</section>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930zb" defer></script>{% endblock %}
File diff suppressed because it is too large Load Diff
+4 -2
View File
@@ -10,8 +10,10 @@
build_project_store 는 None 을 반환하고, 라우터가 "설정 필요" 안내 페이지를 build_project_store 는 None 을 반환하고, 라우터가 "설정 필요" 안내 페이지를
보여준다(앱은 죽지 않음). 보여준다(앱은 죽지 않음).
권한: 로그인한 회사(dbxcorp.co.kr) 직원은 모듈 진입 가능. 프로젝트 생성/삭제· 권한: 권한키 `project` 보유자는 모듈 진입·프로젝트 생성 가능. 삭제는 만든 사람만,
사용자 배정은 ERP 관리자(is_admin)만. 배정된 멤버는 서브프로젝트/업무/단계 관리. 사용자 배정은 ERP 관리자(is_admin)만. 배정된 멤버(또는 owner/관리자)만 그 프로젝트를
조회하고 서브프로젝트/업무/단계를 관리한다.
마감 알림 스레드: `reminders.py` (app.main 의 startup 에서 시작).
""" """
from typing import Any from typing import Any
+151
View File
@@ -0,0 +1,151 @@
"""프로젝트 관리 — 현재 접근 권한의 공통 기준(서버).
라우터·마감 알림이 같은 규칙을 쓰도록 한 곳에 모은다. 모든 판단은 "지금" 기준이다 —
예전에 멤버였거나 담당자·멘션·협업자로 기록돼 있어도, 지금 권한이 없으면 보이지도
바꾸지도 알림을 받지도 않는다(기록 자체는 업무 이력으로 남긴다).
프로젝트
관리(=보기·작업 CRUD) : 관리자(is_admin) · 프로젝트 owner · 배정 멤버. 모두 `project` 모듈 권한이 있어야 한다.
작업
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(삭제는 추가로 생성자 규칙)
READ : 원 소속 권한은 없지만, 이 작업(또는 상위 작업)이 연결된(멀티호밍) 프로젝트를 관리할 수 있음
→ 그 작업의 상세·하위 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다.
연결된 프로젝트 안에서의 섹션 이동(POST /links, 이미 연결된 경우)은 예전처럼 허용.
None : 권한 없음 → 403/목록에서 제외/알림·메일 대상 제외
"""
from __future__ import annotations
from typing import Any, Callable, Iterable
from . import store
FULL = "full"
READ = "read"
UserLookup = Callable[[str], "dict[str, Any] | None"]
def default_user_lookup(email: str) -> dict[str, Any] | None:
"""등록 사용자 레코드(app.main.user_store). 지연 import — 테스트는 lookup 을 직접 넘긴다."""
from app.main import user_store # noqa: WPS433
return user_store.get(store.norm_str(email, lower=True))
def _is_admin(user: dict[str, Any] | None) -> bool:
from app.store import is_admin # noqa: WPS433
return is_admin(user)
def can_use_module(user: dict[str, Any] | None) -> bool:
from app.store import has_module # noqa: WPS433
return bool(user) and has_module(user, "project")
def email_of(user: dict[str, Any] | None) -> str:
return store.norm_str((user or {}).get("email", ""), lower=True)
def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) -> bool:
"""프로젝트 관리(=보기·작업 CRUD) — 관리자 또는 owner/멤버. 모듈 권한이 없으면 False."""
if not can_use_module(user):
return False
if _is_admin(user):
return True
try:
pid = int(project_id)
except (TypeError, ValueError):
return False
return bool(st.is_member(project_id=pid, user_email=email_of(user)))
def visible_project_ids(st: Any, user: dict[str, Any]) -> set[int] | None:
"""관리할 수 있는 프로젝트 id 집합. 관리자는 None(=전체)."""
if _is_admin(user):
return None
if not can_use_module(user):
return set()
return {
int(p["id"]) for p in st.list_projects(include_archived=True, member_email=email_of(user))
}
def task_access(st: Any, user: dict[str, Any] | None, task: dict[str, Any] | None) -> str | None:
"""작업 하나에 대한 지금 권한: FULL / READ / None."""
if not task or not can_use_module(user):
return None
if can_manage_project(st, user, task.get("project_id")):
return FULL
for pid in link_scope(st, [int(task["id"])]).get(int(task["id"]), set()):
if can_manage_project(st, user, pid):
return READ
return None
def link_scope(st: Any, task_ids: Iterable[int]) -> dict[int, set[int]]:
"""작업 id → 이 작업 또는 상위 작업이 연결된 프로젝트 id 들. 연결 표가 없으면 빈 값."""
ids = [int(i) for i in task_ids]
if not ids:
return {}
try:
return st.task_link_scope(task_ids=ids)
except Exception: # noqa: BLE001 - 003 미적용(연결 기능 없음) → 연결로 보이는 작업 없음
return {}
def filter_visible_tasks(st: Any, user: dict[str, Any], tasks: list[dict[str, Any]],
*, key: str = "id") -> list[dict[str, Any]]:
"""목록에서 지금 볼 수 있는(FULL 또는 READ) 작업만 남긴다 — 내 작업·수신함·알림 공용."""
allowed = visible_project_ids(st, user)
if allowed is None:
return list(tasks)
ids = [int(t[key]) for t in tasks if t.get(key) is not None]
scope = link_scope(st, ids)
out = []
for t in tasks:
tid = t.get(key)
pid = t.get("project_id")
if pid is not None and int(pid) in allowed:
out.append(t)
elif tid is not None and scope.get(int(tid), set()) & allowed:
out.append(t)
return out
def email_task_access(st: Any, email: str, task: dict[str, Any],
lookup: UserLookup | None = None) -> str | None:
"""이메일(알림·멘션 대상)이 지금 이 작업을 볼 수 있는지. 등록 안 된 사람·모듈 권한 없는 사람은 None."""
rec = (lookup or default_user_lookup)(email)
if not rec:
return None
rec = {**rec, "email": rec.get("email") or email}
return task_access(st, rec, task)
def filter_recipients(st: Any, task: dict[str, Any], emails: Iterable[str],
lookup: UserLookup | None = None) -> list[str]:
"""알림·메일·멘션 대상 중 지금 이 작업을 볼 수 있는 사람만(순서 유지, 중복 제거)."""
out: list[str] = []
seen: set[str] = set()
for e in emails:
em = store.norm_str(e, lower=True)
if not em or em in seen:
continue
seen.add(em)
if email_task_access(st, em, task, lookup) is not None:
out.append(em)
return out
def can_assign(st: Any, email: str, project_id: Any, lookup: UserLookup | None = None) -> bool:
"""담당자·소유자 후보 — 등록된 사용자이고 project 모듈 권한이 있으며, 그 프로젝트를
관리할 수 있어야 한다(관리자 포함). 권한 없는 사람에게 작업 정보가 담긴 알림이 가지 않게."""
rec = (lookup or default_user_lookup)(email)
if not rec:
return False
rec = {**rec, "email": rec.get("email") or email}
return can_manage_project(st, rec, project_id)
+951 -36
View File
File diff suppressed because it is too large Load Diff
+197
View File
@@ -0,0 +1,197 @@
"""프로젝트 업무 마감 알림 — 아사나의 "마감일 임박/지남" 알림.
매일 한 번(기본 09시 KST, 영업일만) 미완료 업무를 훑어 수신함 알림을 만든다.
· due_soon — 다음 영업일까지 마감(금요일이면 토·일·월 마감분까지)
· due_today — 오늘 마감
· overdue — 마감이 지남(최근 7일 이내 마감분만 — 첫 적용 때 오래된 업무가
한꺼번에 쏟아지지 않게, 연휴로 며칠 건너뛰어도 놓치지 않게)
수신자는 담당자. 담당자가 없으면 팔로워 전원. 단, 지금 그 작업을 볼 수 있는 사람만.
중복 방지: task_reminders(업무, 종류, 마감일, 수신자) UNIQUE — 같은 알림은 한 번만
간다(재기동·여러 번 실행해도 안전). 마감일을 바꾸면 새 마감일 기준으로 다시 알린다.
발송 기록과 수신함 알림은 한 트랜잭션이라, 알림 생성이 실패하면 다음 실행에 다시 시도된다.
실행 방식: 웹 프로세스 안의 데몬 스레드(start_reminder_thread). 5분마다 깨어나
"오늘 아직 안 돌았고, 설정 시각이 지났고, 영업일이면" 한 번 돈다. 여러 프로세스가
동시에 돌아도 위 UNIQUE 덕분에 중복 알림이 없다.
환경변수:
PROJECT_REMINDERS false 면 끈다(기본 켜짐)
PROJECT_REMINDER_HOUR 실행 시각(KST 0~23, 기본 9)
PROJECT_REMINDER_EMAIL true 면 수신자에게 메일도 보낸다(사람별 1통 요약, 기본 끔).
SMTP_* 설정이 있어야 실제로 나간다.
PUBLIC_BASE_URL 메일 속 업무 링크의 앞부분(예: https://erp.dbxcorp.co.kr)
"""
from __future__ import annotations
import logging
import os
import threading
import time
from datetime import date, timedelta
from typing import Any
from app.timezone import now_kst
from . import access, store
logger = logging.getLogger("project.reminders")
KIND_DUE_SOON = "due_soon"
KIND_DUE_TODAY = "due_today"
KIND_OVERDUE = "overdue"
OVERDUE_WINDOW_DAYS = 7
def _env(name: str, default: str = "") -> str:
return (os.getenv(name, "") or "").strip() or default
def _env_bool(name: str, default: bool) -> bool:
v = _env(name).lower()
if not v:
return default
return v in ("1", "true", "yes", "on")
def is_workday(d: date) -> bool:
return d.weekday() < 5 and not store.holiday_name(d.isoformat())
def next_workday(d: date) -> date:
n = d + timedelta(days=1)
while not is_workday(n):
n += timedelta(days=1)
return n
def classify(due: date, today: date) -> str | None:
"""마감일 → 알림 종류(없으면 None)."""
if due == today:
return KIND_DUE_TODAY
if today < due <= next_workday(today):
return KIND_DUE_SOON
if today - timedelta(days=OVERDUE_WINDOW_DAYS) <= due < today:
return KIND_OVERDUE
return None
def _title_for(kind: str, task: dict[str, Any], today: date) -> str:
due = date.fromisoformat(task["due_date"][:10])
if kind == KIND_DUE_TODAY:
return f"오늘 마감: {task['title']}"
if kind == KIND_DUE_SOON:
days = (due - today).days
when = "내일" if days == 1 else f"{days}일 후"
return f"마감 임박({when}): {task['title']}"
return f"마감 지남({(today - due).days}일): {task['title']}"
def run_due_reminders(
st: Any, *, today: date | None = None, lookup: access.UserLookup | None = None,
) -> dict[str, int]:
"""한 번 실행. 새로 만든 알림 수를 종류별로 돌려준다.
- 수신자는 지금 그 작업을 볼 수 있는 사람만(access.filter_recipients) — 멤버에서 빠진 담당자·
협업자, 모듈 권한이 없어진 직원에게는 수신함 알림도 메일도 가지 않는다.
- 발송 기록(task_reminders)과 수신함 알림은 한 트랜잭션(add_reminder_notification) — 알림 생성이
실패하면 기록도 되돌려져 다음 실행에서 다시 시도된다. 같은 알림은 UNIQUE 로 한 번만(동시 실행 포함).
- 보장 범위: 수신함 알림까지. 메일(PROJECT_REMINDER_EMAIL)은 알림이 새로 만들어진 것만 요약해 한 번
보내며, 메일 발송 실패는 재시도하지 않는다(수신함 알림은 이미 남아 있다).
"""
today = today or now_kst().date()
start = today - timedelta(days=OVERDUE_WINDOW_DAYS)
end = next_workday(today)
counts = {KIND_DUE_SOON: 0, KIND_DUE_TODAY: 0, KIND_OVERDUE: 0}
digest: dict[str, list[tuple[str, dict[str, Any]]]] = {}
for t in st.list_open_tasks_due_between(start=start, end=end):
due = date.fromisoformat(t["due_date"][:10])
kind = classify(due, today)
if kind is None:
continue
assignee = store.norm_str(t.get("assignee_email"), lower=True)
wanted = [assignee] if assignee else store.normalize_emails(t.get("followers") or [])
try:
recipients = access.filter_recipients(st, t, wanted, lookup)
except Exception: # noqa: BLE001 - 권한 확인이 안 되면 이번엔 보내지 않는다(다음 실행에 재시도)
logger.warning("마감 알림 수신자 확인 실패: task=%s", t["id"])
continue
for rcpt in recipients:
title = _title_for(kind, t, today)
try:
created = st.add_reminder_notification(
task_id=t["id"], kind=kind, due_date=t["due_date"][:10], recipient_email=rcpt,
project_id=t["project_id"], title=title,
body=f"{t.get('project_name') or ''} · 마감 {t['due_date'][:10]}",
)
except Exception: # noqa: BLE001 - 기록도 되돌려졌으니 다음 실행에서 다시 시도
logger.warning("마감 알림 생성 실패(다음 실행에 재시도): task=%s", t["id"])
continue
if not created:
continue # 이미 보냄
counts[kind] += 1
digest.setdefault(rcpt, []).append((title, t))
if digest and _env_bool("PROJECT_REMINDER_EMAIL", False):
_send_digests(digest, today)
return counts
def _send_digests(digest: dict[str, list[tuple[str, dict[str, Any]]]], today: date) -> None:
from app.mail import send_email # noqa: WPS433
base = _env("PUBLIC_BASE_URL").rstrip("/")
for rcpt, items in digest.items():
lines = [f"{today.isoformat()} 마감 알림 — {len(items)}건", ""]
for title, t in items:
lines.append(f"· {title} [{t.get('project_name') or ''}]")
if base:
lines.append(f" {base}/project/t/{t['id']}")
send_email(
to=[rcpt],
subject=f"[DBX 프로젝트] 마감 알림 {len(items)}건 ({today.isoformat()})",
body="\n".join(lines) + "\n",
)
_started = False
_start_lock = threading.Lock()
def start_reminder_thread(st: Any) -> bool:
"""웹 프로세스 시작 시 1번. 이미 돌고 있거나 꺼져 있으면 False."""
global _started # noqa: PLW0603
if st is None or not _env_bool("PROJECT_REMINDERS", True):
return False
with _start_lock:
if _started:
return False
_started = True
try:
hour = min(23, max(0, int(_env("PROJECT_REMINDER_HOUR", "9"))))
except ValueError:
hour = 9
def _loop() -> None:
last_run: date | None = None
while True:
try:
now = now_kst()
today = now.date()
if last_run != today and now.hour >= hour and is_workday(today):
counts = run_due_reminders(st, today=today)
last_run = today
logger.info("마감 알림 실행: %s", counts)
except Exception as exc: # noqa: BLE001
if type(exc).__name__ == "UndefinedTable":
# 008 마이그레이션 미적용 — 오늘은 더 시도하지 않는다(로그 도배 방지)
logger.warning("마감 알림 skip — project_db_008 마이그레이션 필요")
last_run = now_kst().date()
else:
logger.warning("마감 알림 실패(%s) — 5분 뒤 재시도", type(exc).__name__)
time.sleep(300)
threading.Thread(target=_loop, name="project-reminders", daemon=True).start()
return True
File diff suppressed because it is too large Load Diff
+293 -29
View File
@@ -37,22 +37,104 @@ ACTION_ASSIGNED = "assigned"
ACTION_COMPLETED = "completed" ACTION_COMPLETED = "completed"
ACTION_STAGE_CHANGED = "stage_changed" ACTION_STAGE_CHANGED = "stage_changed"
ACTION_REOPENED = "reopened" ACTION_REOPENED = "reopened"
ACTION_SUBTASK_MOVED = "subtask_moved" # 하위 업무를 다른 상위 업무로 옮김(보드 드래그)
# 프로젝트 색상 팔레트(아사나 느낌) — UI 선택지 # 프로젝트 색상 팔레트 — 32색(8칸 × 4줄). 앞 16색은 아사나 프로젝트 색(아사나 색상표
# 순서 그대로), 뒤 16색은 같은 칸(열)에 대응하는 진한 색 — 3줄째 = 1줄째의 진한 색,
# 4줄째 = 2줄째의 진한 색.
# 새 프로젝트 기본색은 DEFAULT_PROJECT_COLOR(파랑). 예전 팔레트 색으로 만든 프로젝트는
# 그 색 그대로 둔다(검증은 hex 형식만 본다).
COLOR_PALETTE: tuple[str, ...] = ( COLOR_PALETTE: tuple[str, ...] = (
"#c7c4c4", # none(연회색)
"#f06a6a", # red
"#ec8d71", # orange
"#f1bd6c", # yellow-orange
"#f8df72", # yellow
"#aecf55", # yellow-green
"#5da283", # green
"#4ecbc4", # blue-green
"#9ee7e3", # aqua
"#4573d2", # blue "#4573d2", # blue
"#37a3a3", # teal "#8d84e8", # indigo
"#62a420", # green "#b36bd4", # purple
"#e8a33d", # amber "#f9aaef", # magenta
"#e8384f", # red "#f26fb2", # hot-pink
"#aa62e3", # purple "#fc979a", # pink
"#f06a6a", # coral "#6d6e6f", # cool-gray
"#5a6772", # slate # ── 진한 색 16가지 ──
"#9a9696", # warm-gray
"#c93c3c", # deep-red
"#cf6340", # burnt-orange
"#d9962e", # amber
"#cfae1f", # mustard
"#7ea32a", # olive
"#2f7d5b", # forest
"#1c9a92", # teal
"#2a9dc4", # cerulean
"#2c4fa3", # navy
"#5b50c4", # deep-indigo
"#7e3fa8", # deep-purple
"#c55cc0", # orchid
"#c73c86", # raspberry
"#a0714f", # brown
"#37383a", # charcoal
)
DEFAULT_PROJECT_COLOR = "#4573d2"
# 프로젝트 아이콘 — 아사나 프로젝트 아이콘 목록과 같은 종류를 Material Symbols
# (앱이 self-host 하는 아이콘 글꼴)의 이름으로. 빈 값/목록 밖 = 아이콘 없음(첫 글자).
PROJECT_ICONS: tuple[str, ...] = (
"format_list_bulleted", # 목록
"view_kanban", # 보드
"view_timeline", # 타임라인
"calendar_month", # 캘린더
"rocket_launch", # 로켓
"groups", # 사람들
"trending_up", # 그래프
"stars", # 별
"bug_report", # 버그
"lightbulb", # 전구
"language", # 지구
"settings", # 톱니
"menu_book", # 노트
"desktop_windows", # 모니터
"check_circle", # 체크
"adjust", # 과녁
"code", # 코드
"campaign", # 확성기
"forum", # 말풍선
"work", # 서류가방
"dashboard", # 페이지 레이아웃
"flag", # 깃발
"extension", # 퍼즐
"slideshow", # 발표
"confirmation_number", # 티켓
"shopping_basket", # 장바구니
"cloud", # 구름
"payments", # 돈
"favorite", # 하트
"redeem", # 선물
"trophy", # 트로피
"photo_camera", # 카메라
"palette", # 디자인
"school", # 교육
"local_shipping", # 배송
"inventory_2", # 재고
"storefront", # 상점
"science", # 실험
"videocam", # 영상
"description", # 문서
"handshake", # 협업
"build", # 도구
) )
# 세션(칸반 컬럼) 색상 팔레트 — 아사나 태그/커스텀필드에서 쓰는 10색. # 섹션(칸반 컬럼) 색상표 — 모든 편집창이 프로젝트 색상표(32색) 하나를 쓴다.
# 세션 생성/편집 팝업의 색상표가 이 순서 그대로 노출된다. # 섹션에서는 첫 칸(연회색 #c7c4c4, 아사나의 "색 없음")을 고르면 색 없음(NULL, 기본 회색 머리).
STAGE_COLOR_PALETTE: tuple[str, ...] = ( STAGE_COLOR_PALETTE: tuple[str, ...] = COLOR_PALETTE
STAGE_NO_COLOR = COLOR_PALETTE[0]
# 예전 섹션 색상표(10색) — 이 색으로 칠해 둔 섹션은 그대로 유지(저장해도 지워지지 않게).
LEGACY_STAGE_COLORS: tuple[str, ...] = (
"#4573d2", # blue "#4573d2", # blue
"#37a3a3", # teal "#37a3a3", # teal
"#62a420", # green "#62a420", # green
@@ -71,11 +153,11 @@ STAGE_COLOR_PALETTE: tuple[str, ...] = (
# vacation 모듈도 공휴일을 관리하지만(vacation_holidays 테이블) 그건 # vacation 모듈도 공휴일을 관리하지만(vacation_holidays 테이블) 그건
# 휴가 일수 계산용으로 vacation_db 에 강하게 결합돼 있고, 여기는 달력에 # 휴가 일수 계산용으로 vacation_db 에 강하게 결합돼 있고, 여기는 달력에
# 빨간 글씨로 "보여만" 주면 되는 용도라 별도 DB 연결 없이 정적 표로 둔다. # 빨간 글씨로 "보여만" 주면 되는 용도라 별도 DB 연결 없이 정적 표로 둔다.
# 근로자의 날(5/1)·제헌절(7/17)은 관공서 공휴일이 아니라서 제외했다 # 근로자의 날(5/1)은 관공서 공휴일이 아니라서 제외했다. 제헌절(7/17)은
# (vacation 모듈의 기존 2026년 시드와 동일 기준). 대체공휴일은 실제 # 2026년부터 다시 공휴일이라 넣었다(쿠팡 모듈 holidays.py 와 같은 기준).
# "관공서의 공휴일에 관한 규정" 대체공휴일 규정을 그대로 반영함(설날· # 대체공휴일은 "관공서의 공휴일에 관한 규정" 대체공휴일 규정을 그대로 반영함
# 추석·어린이날·삼일절/광복절/개천절/한글날·부처님오신날·성탄절 대상, # (설날·추석·어린이날·삼일절/광복절/개천절/한글날·부처님오신날·성탄절 대상,
# 신정·현충일은 대체 없음). 새 연도가 필요하면 이 표에 추가한다. # 신정·현충일·제헌절은 대체 없음). 새 연도가 필요하면 이 표에 추가한다.
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
KR_HOLIDAYS: dict[str, str] = { KR_HOLIDAYS: dict[str, str] = {
# 2026 # 2026
@@ -85,9 +167,10 @@ KR_HOLIDAYS: dict[str, str] = {
"2026-05-05": "어린이날", "2026-05-05": "어린이날",
"2026-05-24": "부처님오신날", "2026-05-25": "부처님오신날 대체", "2026-05-24": "부처님오신날", "2026-05-25": "부처님오신날 대체",
"2026-06-06": "현충일", "2026-06-06": "현충일",
"2026-07-17": "제헌절",
"2026-08-15": "광복절", "2026-08-17": "광복절 대체", "2026-08-15": "광복절", "2026-08-17": "광복절 대체",
# 추석 9/26 은 토요일만 겹침 → 대체공휴일 없음(설·추석은 일요일/공휴일 겹칠 때만).
"2026-09-24": "추석 연휴", "2026-09-25": "추석", "2026-09-26": "추석 연휴", "2026-09-24": "추석 연휴", "2026-09-25": "추석", "2026-09-26": "추석 연휴",
"2026-09-28": "추석 대체",
"2026-10-03": "개천절", "2026-10-05": "개천절 대체", "2026-10-03": "개천절", "2026-10-05": "개천절 대체",
"2026-10-09": "한글날", "2026-10-09": "한글날",
"2026-12-25": "성탄절", "2026-12-25": "성탄절",
@@ -99,6 +182,7 @@ KR_HOLIDAYS: dict[str, str] = {
"2027-05-05": "어린이날", "2027-05-05": "어린이날",
"2027-05-13": "부처님오신날", "2027-05-13": "부처님오신날",
"2027-06-06": "현충일", "2027-06-06": "현충일",
"2027-07-17": "제헌절",
"2027-08-15": "광복절", "2027-08-16": "광복절 대체", "2027-08-15": "광복절", "2027-08-16": "광복절 대체",
"2027-09-14": "추석 연휴", "2027-09-15": "추석", "2027-09-16": "추석 연휴", "2027-09-14": "추석 연휴", "2027-09-15": "추석", "2027-09-16": "추석 연휴",
"2027-10-03": "개천절", "2027-10-04": "개천절 대체", "2027-10-03": "개천절", "2027-10-04": "개천절 대체",
@@ -111,6 +195,7 @@ KR_HOLIDAYS: dict[str, str] = {
"2028-05-02": "부처님오신날", "2028-05-02": "부처님오신날",
"2028-05-05": "어린이날", "2028-05-05": "어린이날",
"2028-06-06": "현충일", "2028-06-06": "현충일",
"2028-07-17": "제헌절",
"2028-08-15": "광복절", "2028-08-15": "광복절",
"2028-10-02": "추석 연휴", "2028-10-03": "추석·개천절", "2028-10-04": "추석 연휴", "2028-10-02": "추석 연휴", "2028-10-03": "추석·개천절", "2028-10-04": "추석 연휴",
"2028-10-05": "개천절 대체", "2028-10-05": "개천절 대체",
@@ -123,6 +208,7 @@ KR_HOLIDAYS: dict[str, str] = {
"2029-05-05": "어린이날", "2029-05-07": "어린이날 대체", "2029-05-05": "어린이날", "2029-05-07": "어린이날 대체",
"2029-05-20": "부처님오신날", "2029-05-21": "부처님오신날 대체", "2029-05-20": "부처님오신날", "2029-05-21": "부처님오신날 대체",
"2029-06-06": "현충일", "2029-06-06": "현충일",
"2029-07-17": "제헌절",
"2029-08-15": "광복절", "2029-08-15": "광복절",
"2029-09-21": "추석 연휴", "2029-09-22": "추석", "2029-09-23": "추석 연휴", "2029-09-21": "추석 연휴", "2029-09-22": "추석", "2029-09-23": "추석 연휴",
"2029-09-24": "추석 대체", "2029-09-24": "추석 대체",
@@ -137,6 +223,7 @@ KR_HOLIDAYS: dict[str, str] = {
"2030-05-05": "어린이날", "2030-05-06": "어린이날 대체", "2030-05-05": "어린이날", "2030-05-06": "어린이날 대체",
"2030-05-09": "부처님오신날", "2030-05-09": "부처님오신날",
"2030-06-06": "현충일", "2030-06-06": "현충일",
"2030-07-17": "제헌절",
"2030-08-15": "광복절", "2030-08-15": "광복절",
"2030-09-11": "추석 연휴", "2030-09-12": "추석", "2030-09-13": "추석 연휴", "2030-09-11": "추석 연휴", "2030-09-12": "추석", "2030-09-13": "추석 연휴",
"2030-10-03": "개천절", "2030-10-03": "개천절",
@@ -177,16 +264,16 @@ def validate_project_name(name: Any) -> str:
def validate_task_title(title: Any) -> str: def validate_task_title(title: Any) -> str:
v = norm_str(title) v = norm_str(title)
if not v: if not v:
raise ValueError("업무 제목은 필수입니다.") raise ValueError("작업 제목은 필수입니다.")
if len(v) > 300: if len(v) > 300:
raise ValueError("업무 제목이 너무 깁니다(300자 이내).") raise ValueError("작업 제목이 너무 깁니다(300자 이내).")
return v return v
def validate_color(color: Any) -> str: def validate_color(color: Any) -> str:
v = norm_str(color) v = norm_str(color)
if not v: if not v:
return COLOR_PALETTE[0] return DEFAULT_PROJECT_COLOR
# 매우 단순한 hex 검증 — #RGB / #RRGGBB # 매우 단순한 hex 검증 — #RGB / #RRGGBB
if v.startswith("#") and len(v) in (4, 7): if v.startswith("#") and len(v) in (4, 7):
try: try:
@@ -194,13 +281,22 @@ def validate_color(color: Any) -> str:
return v.lower() return v.lower()
except ValueError: except ValueError:
pass pass
return COLOR_PALETTE[0] return DEFAULT_PROJECT_COLOR
def validate_project_icon(icon: Any) -> str | None:
"""프로젝트 아이콘 — PROJECT_ICONS 안의 이름만, 빈값/목록 밖은 None(첫 글자 표시)."""
v = norm_str(icon)
return v if v in PROJECT_ICONS else None
def validate_stage_color(color: Any) -> str | None: def validate_stage_color(color: Any) -> str | None:
"""세션 색상 — 팔레트 밖 값/빈값은 저장 안 함(NULL, 기본 회색 표시).""" """섹션 색상 — 색상표(또는 예전 10색) 안의 값만. 첫 칸(색 없음)·빈값·목록 밖은
저장 안 함(NULL, 기본 회색 머리)."""
v = norm_str(color).lower() v = norm_str(color).lower()
return v if v in STAGE_COLOR_PALETTE else None if v == STAGE_NO_COLOR:
return None
return v if (v in STAGE_COLOR_PALETTE or v in LEGACY_STAGE_COLORS) else None
def validate_date(d: Any) -> str | None: def validate_date(d: Any) -> str | None:
@@ -217,6 +313,30 @@ def validate_date(d: Any) -> str | None:
return v[:10] return v[:10]
DATE_RANGE_ERROR = "시작일이 마감일보다 늦을 수 없습니다."
TIME_RANGE_ERROR = "같은 날이면 시작 시각이 마감 시각보다 늦을 수 없습니다."
def validate_date_range(
start_date: Any, due_date: Any, start_time: Any = None, due_time: Any = None
) -> None:
"""최종 상태(부분 수정이면 기존 값 + 바꾼 값)의 날짜 범위 검사 — 프로젝트·작업 공용.
둘 다 있으면 start_date <= due_date. 같은 날이고 두 시각이 모두 있으면 start_time <= due_time.
한쪽이 비어 있는 입력은 허용. 값 형식 오류는 validate_date/validate_time 이 먼저 낸다.
"""
sd = validate_date(start_date)
dd = validate_date(due_date)
if sd and dd:
if sd > dd:
raise ValueError(DATE_RANGE_ERROR)
if sd == dd:
st = validate_time(start_time)
dt = validate_time(due_time)
if st and dt and st > dt:
raise ValueError(TIME_RANGE_ERROR)
def validate_time(t: Any) -> str | None: def validate_time(t: Any) -> str | None:
"""'HH:MM' 형식만 통과(초는 버림). 빈값/None 은 None(=종일).""" """'HH:MM' 형식만 통과(초는 버림). 빈값/None 은 None(=종일)."""
v = norm_str(t) v = norm_str(t)
@@ -233,12 +353,101 @@ def validate_time(t: Any) -> str | None:
return f"{hh:02d}:{mm:02d}" return f"{hh:02d}:{mm:02d}"
# ════════════════════════════════════════════════════════════
# 연간 목표 (마이그레이션 013) — 사이드바 "목표" → 연도
# ════════════════════════════════════════════════════════════
GOAL_METRICS: tuple[str, ...] = ("sales", "roas") # 매출 · 로아스
GOAL_KINDS: tuple[str, ...] = ("target", "actual") # 목표 · 실적
# 업무 영역 줄 배경색 — 스프레드시트처럼 연한 색 16가지(글자는 항상 진한 색, 8칸×2줄).
# 처음 8색(상품·마케팅·컨텐츠·유통 기본색 포함)은 예전 목록 그대로 들어 있다.
# 빈 문자열 = 색 없음(흰 배경, GOAL_NO_COLOR).
GOAL_AREA_COLORS: tuple[str, ...] = (
"#fcd9d9", "#fde4c8", "#fbe1d5", "#fff2c2", "#eef5c8", "#d9f2d0", "#c9ecd9", "#d3f0ee",
"#cfeaf7", "#dbe8fb", "#e3dcfb", "#f0cdec", "#fcdcec", "#eadcd0", "#d4d4d4", "#eef0f2",
)
GOAL_NO_COLOR = ""
# 새 연도를 만들 때 이전 연도가 없으면 이 영역으로 시작한다(이전 연도가 있으면 그 구조를 복사).
DEFAULT_GOAL_AREAS: tuple[tuple[str, str, tuple[str, ...]], ...] = (
("상품", "#fbe1d5", ("",)),
("마케팅", "#d9f2d0", ("",)),
("컨텐츠", "#d4d4d4", ("",)),
("유통", "#f0cdec", ("콜라보", "인플", "쿠팡", "기타")),
)
GOAL_TEXT_MAX = 4000
def validate_goal_year(y: Any) -> int:
try:
v = int(str(y).strip())
except (TypeError, ValueError):
raise ValueError("연도가 올바르지 않습니다.")
if not 2000 <= v <= 2100:
raise ValueError("연도는 2000 ~ 2100 사이여야 합니다.")
return v
def validate_goal_month(m: Any, *, allow_year: bool = False) -> int:
"""1~12월. allow_year 이면 0(연간)도 허용."""
try:
v = int(m)
except (TypeError, ValueError):
raise ValueError("월이 올바르지 않습니다.")
if not ((0 if allow_year else 1) <= v <= 12):
raise ValueError("월이 올바르지 않습니다.")
return v
def validate_goal_value(v: Any) -> float | None:
"""지표 숫자 — '1,234.5' 같은 쉼표·공백·% 는 떼고 읽는다. 빈값은 None(=지움)."""
s = norm_str(v).replace(",", "").replace("%", "").replace(" ", "")
if not s:
return None
try:
f = float(s)
except ValueError:
raise ValueError(f"숫자가 아닙니다: {v}")
if f != f or abs(f) >= 1e16: # NaN · NUMERIC(18,2) 범위 밖
raise ValueError(f"숫자 범위를 벗어났습니다: {v}")
return round(f, 2)
def validate_goal_area_name(name: Any) -> str:
v = norm_str(name)
if not v:
raise ValueError("업무 영역 이름을 입력하세요.")
if len(v) > 50:
raise ValueError("업무 영역 이름은 50자 이하로 입력하세요.")
return v
def validate_goal_row_label(label: Any) -> str:
v = norm_str(label)
if len(v) > 50:
raise ValueError("줄 이름은 50자 이하로 입력하세요.")
return v
def validate_goal_color(color: Any) -> str:
"""영역 색 — 16색 중 하나, 빈값/"none" 은 색 없음(""), 목록 밖은 첫 색."""
v = norm_str(color).lower()
if v in ("", "none"):
return GOAL_NO_COLOR
return v if v in GOAL_AREA_COLORS else GOAL_AREA_COLORS[0]
def validate_goal_text(body: Any) -> str:
v = str(body or "").replace("\r\n", "\n").strip()
if len(v) > GOAL_TEXT_MAX:
raise ValueError(f"칸 하나에 {GOAL_TEXT_MAX}자까지 쓸 수 있습니다.")
return v
def build_subject_assigned(*, project_name: str, task_title: str, assignee: str) -> str: def build_subject_assigned(*, project_name: str, task_title: str, assignee: str) -> str:
return f"[DBX 프로젝트] 업무 배정: {project_name} · {task_title} → {assignee}" return f"[DBX 프로젝트] 작업 배정: {project_name} · {task_title} → {assignee}"
def build_subject_completed(*, project_name: str, task_title: str) -> str: def build_subject_completed(*, project_name: str, task_title: str) -> str:
return f"[DBX 프로젝트] 업무 완료: {project_name} · {task_title}" return f"[DBX 프로젝트] 작업 완료: {project_name} · {task_title}"
def build_subject_project_done(*, project_name: str) -> str: def build_subject_project_done(*, project_name: str) -> str:
@@ -261,8 +470,12 @@ def build_subject_project_done(*, project_name: str) -> str:
_DESC_ALLOWED_TAGS: frozenset[str] = frozenset({ _DESC_ALLOWED_TAGS: frozenset[str] = frozenset({
"p", "br", "b", "strong", "i", "em", "u", "a", "img", "p", "br", "b", "strong", "i", "em", "u", "a", "img",
"ul", "ol", "li", "blockquote", "code", "pre", "span", "div", "ul", "ol", "li", "blockquote", "code", "pre", "span", "div",
# 취소선(서식 도구 "S" — 브라우저에 따라 strike/s/del 로 만든다)
"s", "strike", "del",
# 체크박스(서식 도구 "☑") — type="checkbox" 만, 속성은 checked 뿐(아래 _emit_start)
"input",
}) })
_DESC_VOID_TAGS: frozenset[str] = frozenset({"br", "img"}) _DESC_VOID_TAGS: frozenset[str] = frozenset({"br", "img", "input"})
# a: target/rel 은 "새 탭에서 열기"용. 화면(설명란)에서 링크를 클릭하면 # a: target/rel 은 "새 탭에서 열기"용. 화면(설명란)에서 링크를 클릭하면
# 새 탭으로 여는데, 저장했다 다시 열었을 때도 같은 동작이어야 해서 허용한다. # 새 탭으로 여는데, 저장했다 다시 열었을 때도 같은 동작이어야 해서 허용한다.
# span: 멘션 칩(@이름) 전용 — class="pj-mention" + data-email 만 남긴다. # span: 멘션 칩(@이름) 전용 — class="pj-mention" + data-email 만 남긴다.
@@ -270,6 +483,11 @@ _DESC_ALLOWED_ATTRS: dict[str, frozenset[str]] = {
"a": frozenset({"href", "target", "rel"}), "a": frozenset({"href", "target", "rel"}),
"img": frozenset({"src", "alt", "width", "height"}), "img": frozenset({"src", "alt", "width", "height"}),
"span": frozenset({"class", "data-email"}), "span": frozenset({"class", "data-email"}),
"input": frozenset({"type", "checked"}),
# ul: 체크리스트(서식 도구 ☑ — 줄마다 체크박스) 표시용 class="pj-checklist" 하나만
"ul": frozenset({"class"}),
# li: 체크리스트 줄의 체크 여부 — data-checked="true" 만(체크박스는 CSS 가 글머리처럼 그린다)
"li": frozenset({"data-checked"}),
} }
# URL 은 금지 목록이 아니라 허용 목록으로 검사한다. 금지 목록(javascript: 등)은 # URL 은 금지 목록이 아니라 허용 목록으로 검사한다. 금지 목록(javascript: 등)은
# "jav&#x09;ascript:" 처럼 중간에 탭/개행을 끼우면 통과하는데, 브라우저는 URL 을 # "jav&#x09;ascript:" 처럼 중간에 탭/개행을 끼우면 통과하는데, 브라우저는 URL 을
@@ -291,6 +509,8 @@ def inline_safe_content_type(content_type: Any) -> bool:
return norm_str(content_type, lower=True).split(";", 1)[0].strip() in INLINE_SAFE_CONTENT_TYPES return norm_str(content_type, lower=True).split(";", 1)[0].strip() in INLINE_SAFE_CONTENT_TYPES
# 멘션 칩: <span class="pj-mention" data-email="...">@이름</span> # 멘션 칩: <span class="pj-mention" data-email="...">@이름</span>
_MENTION_CLASS = "pj-mention" _MENTION_CLASS = "pj-mention"
# 태그별로 남길 수 있는 class 값(하나씩) — 그 밖의 class 는 버린다.
_DESC_ALLOWED_CLASS: dict[str, str] = {"span": _MENTION_CLASS, "ul": "pj-checklist"}
# script/style 은 태그 자체는 물론 그 안의 텍스트(코드)도 통째로 버린다 — # script/style 은 태그 자체는 물론 그 안의 텍스트(코드)도 통째로 버린다 —
# 허용 태그 목록에 없어 태그는 이미 안 남지만, HTMLParser는 이 둘의 내용을 # 허용 태그 목록에 없어 태그는 이미 안 남지만, HTMLParser는 이 둘의 내용을
# 별도 데이터로 넘기므로 handle_data 에서 따로 걸러야 한다. # 별도 데이터로 넘기므로 handle_data 에서 따로 걸러야 한다.
@@ -339,6 +559,14 @@ class _DescriptionSanitizer(HTMLParser):
return return
if tag not in _DESC_ALLOWED_TAGS: if tag not in _DESC_ALLOWED_TAGS:
return return
# input 은 체크박스만 — 다른 종류(text·file·hidden 등)는 태그째 버리고,
# 체크 여부 말고는 아무 속성도 남기지 않는다.
if tag == "input":
if (dict(attrs).get("type") or "").strip().lower() != "checkbox":
return
checked = any(name == "checked" for name, _ in attrs)
self.out.append('<input type="checkbox" checked>' if checked else '<input type="checkbox">')
return
allowed = _DESC_ALLOWED_ATTRS.get(tag, frozenset()) allowed = _DESC_ALLOWED_ATTRS.get(tag, frozenset())
# span 은 멘션 칩일 때만 속성을 갖는다 — class 가 pj-mention 이 아니면 # span 은 멘션 칩일 때만 속성을 갖는다 — class 가 pj-mention 이 아니면
# data-email 까지 통째로 버린다(평범한 span 으로만 남는다). # data-email 까지 통째로 버린다(평범한 span 으로만 남는다).
@@ -353,9 +581,11 @@ class _DescriptionSanitizer(HTMLParser):
continue continue
if name == "src" and not desc_url_is_safe(value, allow_data_image=True): if name == "src" and not desc_url_is_safe(value, allow_data_image=True):
continue continue
# class 는 멘션 칩 하나만 허용한다(임의 클래스로 화면 스타일을 # class 는 태그마다 정해진 값 하나만(멘션 칩·체크리스트) — 임의 클래스로
# 흔들 여지를 남기지 않는다). # 화면 스타일을 흔들 여지를 남기지 않는다.
if name == "class" and value.strip() != _MENTION_CLASS: if name == "class" and value.strip() != _DESC_ALLOWED_CLASS.get(tag):
continue
if name == "data-checked" and value.strip() != "true":
continue continue
kept.append(f'{name}="{_desc_escape_attr(value)}"') kept.append(f'{name}="{_desc_escape_attr(value)}"')
attr_text = (" " + " ".join(kept)) if kept else "" attr_text = (" " + " ".join(kept)) if kept else ""
@@ -441,6 +671,40 @@ def extract_mentions_from_html(html: str) -> list[str]:
return parser.emails return parser.emails
class _TextCollector(HTMLParser):
_BREAK_TAGS = frozenset({"br", "p", "div", "li", "blockquote", "pre"})
def __init__(self) -> None:
super().__init__(convert_charrefs=True)
self.parts: list[str] = []
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
if tag in self._BREAK_TAGS:
self.parts.append(" ")
def handle_data(self, data: str) -> None:
self.parts.append(data)
def html_to_text(html: str) -> str:
"""설명 HTML → 한 줄 평문(검색 확인·미리보기용). 공백은 하나로 줄인다."""
parser = _TextCollector()
parser.feed(html or "")
parser.close()
return re.sub(r"\s+", " ", "".join(parser.parts)).strip()
def search_snippet(text: str, query: str, *, width: int = 60) -> str:
"""text 에서 query 주변만 잘라 보여준다(앞뒤 … 표시). 없으면 앞부분."""
t = text or ""
i = t.lower().find((query or "").lower())
if i < 0:
return t[:width * 2] + ("…" if len(t) > width * 2 else "")
start = max(0, i - width)
end = min(len(t), i + len(query) + width)
return ("…" if start else "") + t[start:end] + ("…" if end < len(t) else "")
def normalize_emails(values: Any) -> list[str]: def normalize_emails(values: Any) -> list[str]:
"""임의 입력(리스트/문자열)을 소문자 이메일 목록으로 정리한다.""" """임의 입력(리스트/문자열)을 소문자 이메일 목록으로 정리한다."""
if isinstance(values, str): if isinstance(values, str):
@@ -0,0 +1,36 @@
{# 화면 배율 토글 — 2880×1620·200%(CSS 화면 폭 1440px)에서도 1920×1080 기준 화면처럼
보이도록 앱 화면을 0.75 로 줄인다(project.css html.pj-ui-scale, project.js initUiScaleToggle).
선택은 브라우저별로 기억(localStorage) — 그리기 전에 바로 적용해 깜빡임을 줄인다. #}
<script>
try { if (localStorage.getItem("pj_ui_scale") === "1") document.documentElement.classList.add("pj-ui-scale"); } catch (_) {}
</script>
<button type="button" class="pj-help-btn pj-ui-scale-btn" id="pj-ui-scale-btn" aria-label="화면 배율 전환">
<span class="material-symbols-outlined">fit_screen</span>
</button>
<script>
(function () {
var root = document.documentElement;
var btn = document.getElementById("pj-ui-scale-btn");
function sync() {
var on = root.classList.contains("pj-ui-scale");
btn.classList.toggle("is-on", on);
btn.title = on
? "화면 배율: 고해상도(2880×1620·200%)용 — 누르면 기본(1920×1080)"
: "화면 배율: 기본(1920×1080) — 누르면 고해상도(2880×1620·200%)용";
}
btn.addEventListener("click", function () {
var on = !root.classList.contains("pj-ui-scale");
root.classList.toggle("pj-ui-scale", on);
try { localStorage.setItem("pj_ui_scale", on ? "1" : "0"); } catch (_) {}
sync();
window.dispatchEvent(new Event("resize")); // 보드·타임라인 등 크기 다시 재기
});
sync();
})();
</script>
{# 프로젝트 관리 도움말 — 상단 바 로그아웃 오른쪽의 ? 아이콘(erp_base 의 topbar_after_logout).
새 탭으로 열어 하던 작업이 끊기지 않게 한다. #}
<a class="pj-help-btn" href="/project/help" target="_blank" rel="noopener"
title="프로젝트 관리 도움말" aria-label="프로젝트 관리 도움말">
<span class="material-symbols-outlined">help</span>
</a>
@@ -0,0 +1,19 @@
{# 멤버 업무 팝업 — 좌측 "전체 멤버"(관리자, 모든 화면)·프로젝트 멤버 칩 클릭.
project.js initMemberTasks() 가 배선. project/mytasks/inbox 공용. #}
<div class="pj-modal" id="pj-modal-member-tasks" hidden>
<div class="pj-modal-card pj-mt-card">
<h3 id="pj-mt-title">작업</h3>
<p class="pj-modal-hint">더블클릭하면 작업 편집 창이 열립니다.</p>
<div class="pj-mt-head" id="pj-mt-head">
<span class="pj-mt-h" data-sort="project">프로젝트<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="stage">섹션<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="title">작업<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="due">마감일<span class="pj-mt-sort-icon"></span></span>
</div>
<ul class="pj-mt-list" id="pj-mt-list"></ul>
<div class="pj-modal-actions">
<span style="flex:1"></span>
<button type="button" class="pj-btn pj-btn-primary" data-close>닫기</button>
</div>
</div>
</div>
@@ -1,16 +1,31 @@
{# ── 프로젝트 모듈 좌측 사이드바 (공용) ────────────────────────────── {# ── 프로젝트 모듈 좌측 사이드바 (공용) ──────────────────────────────
내 업무 화면(mytasks.html)과 프로젝트 화면(project.html)이 함께 쓴다. 수신함·내 업무·휴지통·프로젝트 화면이 함께 쓴다 — 어느 화면이든 프로젝트
목록은 똑같다(관리자: 드래그 순서 변경·✎ 수정·× 삭제·우클릭 메뉴).
변수: 변수:
mention_unread 미확인 @태그 개수 (수신함 배지) mention_unread 미확인 @태그 개수 (수신함 배지)
my_open_total 진행 중인 내 업무 개수 (내 업무 배지) my_open_total 진행 중인 내 업무 개수 (내 업무 배지)
nav_projects 프로젝트 목록(평면) nav_projects 프로젝트 목록(평면)
current_pid 지금 보고 있는 프로젝트 id (내 업무/수신함 화면이면 0) current_pid 지금 보고 있는 프로젝트 id (내 업무/수신함 화면이면 0)
side_active 'inbox' | 'mytasks' | '' — 개인 메뉴 활성 표시 side_active 'inbox' | 'mytasks' | 'trash' | 'goals' | '' — 개인 메뉴 활성 표시
goal_years "목표" 아래 연도 목록(router._goal_years_nav — 올해는 항상 포함)
goal_year_active 목표 화면에서 보고 있는 연도
is_admin 프로젝트 생성/수정/삭제 권한 is_admin 프로젝트 생성/수정/삭제 권한
프로젝트 수정/삭제(✎/×) 버튼은 그 동작을 배선하는 initProject 가 도는 목록 동작은 project.js 의 initSideTree(첫 화면을 같은 마크업으로 다시 그림),
프로젝트 화면에서만 그린다(current_pid 로 판별). #} 새 프로젝트/수정 모달은 각 화면이 include 하는 project/_side_modals.html. #}
<aside class="pj-side"> {# 날짜 팝업(openDatePopover)이 공휴일을 빨강으로 칠할 때 쓰는 표 — 이 사이드바는
프로젝트 관리의 모든 화면에 들어가므로 여기서 한 번 넘긴다(main.py 의 Jinja 전역). #}
<script>window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
<aside class="pj-side" data-is-admin="{{ 'true' if is_admin else 'false' }}"
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}"
data-me="{{ user.email }}">
<!-- 전체 검색 — 제목·설명·댓글, 내가 볼 수 있는 모든 프로젝트(하위 업무 포함).
결과를 누르면 그 업무 팝업(/project/t/{id})으로. 어디서든 "/" 키로 포커스. -->
<div class="pj-side-search">
<span class="material-symbols-outlined pj-side-search-ic">search</span>
<input type="search" id="pj-global-search" placeholder="전체 검색 ( / )" autocomplete="off" aria-label="작업 전체 검색" />
<div class="pj-search-results" id="pj-search-results" hidden></div>
</div>
<!-- 아사나처럼 맨 위에 개인 메뉴(수신함 / 내 업무). 내 업무는 접었다 펴는 <!-- 아사나처럼 맨 위에 개인 메뉴(수신함 / 내 업무). 내 업무는 접었다 펴는
패널이 아니라 오른쪽 화면 전체에 목록을 띄우는 별도 페이지다. --> 패널이 아니라 오른쪽 화면 전체에 목록을 띄우는 별도 페이지다. -->
<nav class="pj-side-nav"> <nav class="pj-side-nav">
@@ -22,35 +37,67 @@
</a> </a>
<a class="pj-side-navlink {% if side_active == 'mytasks' %}is-active{% endif %}" href="/project/"> <a class="pj-side-navlink {% if side_active == 'mytasks' %}is-active{% endif %}" href="/project/">
<span class="material-symbols-outlined pj-side-navic">checklist</span> <span class="material-symbols-outlined pj-side-navic">checklist</span>
<span class="pj-side-navtext">내 업무</span> <span class="pj-side-navtext">내 작업</span>
<span class="pj-side-navbadge pj-side-navbadge-open" id="pj-myopen-badge" <span class="pj-side-navbadge pj-side-navbadge-open" id="pj-myopen-badge"
{% if not my_open_total %}hidden{% endif %}>{{ my_open_total }}</span> {% if not my_open_total %}hidden{% endif %}>{{ my_open_total }}</span>
</a> </a>
{# 휴지통 — 관리자만 보이고(화면·복구 API 도 관리자 전용), 지운 업무를 3개월 보관. #}
{% if is_admin %}
<a class="pj-side-navlink {% if side_active == 'trash' %}is-active{% endif %}" href="/project/trash">
<span class="material-symbols-outlined pj-side-navic">delete</span>
<span class="pj-side-navtext">휴지통</span>
</a>
{% endif %}
{# 목표 — 누르면 바로 아래에 연도가 펼쳐지고, 연도를 누르면 오른쪽에 그해 전체 목표
(/project/goals/{연도}). 펼침 상태는 localStorage(pj_goal_open), 목표 화면에서는 항상 펼침.
연도 추가는 관리자만(마이그레이션 013). #}
{% set goal_open = side_active == 'goals' %}
<div class="pj-side-goal{% if goal_open %} is-open{% endif %}" id="pj-side-goal"
data-force-open="{{ 'true' if goal_open else 'false' }}">
<button type="button" class="pj-side-navlink pj-side-goal-toggle" id="pj-side-goal-toggle"
aria-expanded="{{ 'true' if goal_open else 'false' }}">
<span class="material-symbols-outlined pj-side-navic">flag</span>
<span class="pj-side-navtext">목표</span>
<span class="material-symbols-outlined pj-side-goal-caret">expand_more</span>
</button>
<div class="pj-side-goal-years" id="pj-side-goal-years"{% if not goal_open %} hidden{% endif %}>
{% for y in (goal_years or []) %}
<a class="pj-side-goal-year{% if side_active == 'goals' and y == goal_year_active %} is-active{% endif %}"
href="/project/goals/{{ y }}">{{ y }}년</a>
{% endfor %}
{% if is_admin %}
<button type="button" class="pj-side-goal-add" id="pj-goal-year-add"
data-next="{{ ((goal_years or [0]) | max) + 1 }}">+ 연도 추가</button>
{% endif %}
</div>
</div>
</nav> </nav>
<div class="pj-side-block"> <div class="pj-side-block pj-tree-block">
<div class="pj-side-head"> <div class="pj-side-head">
<span>프로젝트</span> <span>프로젝트</span>
{# 새 프로젝트 모달(#pj-modal-project)을 갖고 그 동작을 배선하는 {% if is_admin %}
화면에서만 보인다 — 수신함에는 그 모달이 없다. #}
{% if is_admin and side_active != 'inbox' %}
<button type="button" class="pj-icon-btn" id="pj-new-project-side" title="새 프로젝트">+</button> <button type="button" class="pj-icon-btn" id="pj-new-project-side" title="새 프로젝트">+</button>
{% endif %} {% endif %}
</div> </div>
{% macro nav_li(p) %} {% macro nav_li(p) %}
<li class="pj-tree-li" data-id="{{ p.id }}" <li class="pj-tree-li" data-id="{{ p.id }}"{% if is_admin %} draggable="true"{% endif %}
data-name="{{ p.name }}" data-desc="{{ p.description or '' }}" data-name="{{ p.name }}" data-desc="{{ p.description or '' }}"
data-start="{{ p.start_date or '' }}" data-due="{{ p.due_date or '' }}" data-start="{{ p.start_date or '' }}" data-due="{{ p.due_date or '' }}"
data-color="{{ p.color }}" data-status="{{ p.status or 'active' }}" data-color="{{ p.color }}" data-status="{{ p.status or 'active' }}"
data-creator="{{ p.created_by or '' }}"> data-creator="{{ p.created_by or '' }}" data-icon="{{ p.icon or '' }}">
<div class="pj-tree-row {% if p.id == current_pid %}is-active{% endif %}"> <div class="pj-tree-row {% if p.id == current_pid %}is-active{% endif %}">
<a class="pj-tree-link" href="/project/p/{{ p.id }}"> {% if is_admin %}<span class="pj-tree-handle" title="드래그로 순서 변경">⣿</span>{% endif %}
<span class="pj-tree-avatar" style="background: {{ p.color }}">{{ p.name[0] | upper }}</span> <a class="pj-tree-link" href="/project/p/{{ p.id }}"{% if is_admin %} draggable="false"{% endif %}>
<span class="pj-tree-avatar{% if p.icon %} has-icon{% endif %}" style="background: {{ p.color }}">{% if p.icon %}<span class="material-symbols-outlined pj-proj-ic">{{ p.icon }}</span>{% else %}{{ p.name[0] | upper }}{% endif %}</span>
<span class="pj-tree-name">{{ p.name }}</span> <span class="pj-tree-name">{{ p.name }}</span>
</a> </a>
{% if is_admin and current_pid %} {% if is_admin %}
<span class="pj-tree-acts"> <span class="pj-tree-acts">
<button type="button" class="pj-icon-btn pj-tree-edit" title="프로젝트 수정">✎</button> <button type="button" class="pj-icon-btn pj-tree-edit" data-id="{{ p.id }}"
data-name="{{ p.name }}" data-desc="{{ p.description or '' }}"
data-start="{{ p.start_date or '' }}" data-due="{{ p.due_date or '' }}"
data-color="{{ p.color }}" data-status="{{ p.status or 'active' }}" title="프로젝트 수정">✎</button>
<button type="button" class="pj-icon-btn pj-tree-del" data-id="{{ p.id }}" data-name="{{ p.name }}" data-creator="{{ p.created_by }}" title="프로젝트 삭제">×</button> <button type="button" class="pj-icon-btn pj-tree-del" data-id="{{ p.id }}" data-name="{{ p.name }}" data-creator="{{ p.created_by }}" title="프로젝트 삭제">×</button>
</span> </span>
{% endif %} {% endif %}
@@ -74,11 +121,11 @@
{% endif %} {% endif %}
</div> </div>
<!-- 전체 멤버 — 등록된 전체 직원(프로젝트 권한 보유자). 아이콘 클릭 시 <!-- 전체 멤버 — 등록된 전체 직원(프로젝트 권한 보유자). 관리자 전용
그 사람이 담당자인 업무를 팝업으로 보여준다(프로젝트/세션/마감일). (/api/all-users 도 관리자만). 아이콘 클릭 시 그 사람이 담당자인 업무를
이 팝업을 배선하는 코드가 initProject 안에 있어 프로젝트 화면에서만 팝업으로 보여준다(프로젝트/세션/마감일). 수신함·내 업무·프로젝트 화면
그린다(내 업무 화면에는 안 나온다). --> 모두에서 보인다 — 팝업 마크업은 _member_tasks_modal.html. -->
{% if current_pid %} {% if is_admin %}
<div class="pj-side-block"> <div class="pj-side-block">
<div class="pj-side-head"><span>전체 멤버</span></div> <div class="pj-side-head"><span>전체 멤버</span></div>
<div class="pj-allmembers-grid" id="pj-allmembers-grid">불러오는 중…</div> <div class="pj-allmembers-grid" id="pj-allmembers-grid">불러오는 중…</div>
@@ -0,0 +1,66 @@
{# ── 좌측 프로젝트 목록(project/_side.html)용 모달 (공용) ──────────────
"+" 새 프로젝트 / ✎ 프로젝트 수정 — 수신함·내 업무·휴지통·프로젝트 화면이
모두 include 한다(동작은 project.js 의 initSideTree). 관리자만 쓰므로
관리자에게만 그린다. 색상 원은 window.PJ_COLORS(color_palette, 32색),
아이콘은 window.PJ_ICONS(project_icons — Material Symbols 이름). #}
<script>
window.PJ_COLORS = {{ color_palette | tojson }};
window.PJ_ICONS = {{ (project_icons or []) | tojson }};
</script>
{% if is_admin %}
<!-- 새 프로젝트 모달 — 좌측 프로젝트 목록의 + 버튼 -->
<div class="pj-modal" id="pj-modal-project" hidden>
<div class="pj-modal-card">
<h3>새 프로젝트</h3>
<label>이름<input type="text" id="pj-f-name" placeholder="프로젝트 이름" autocomplete="off" /></label>
<label>설명<textarea id="pj-f-desc" rows="2"></textarea></label>
{# 날짜 칸은 project.js enhanceDateInput 이 아사나식 날짜 버튼으로 바꾼다(input 은 숨긴 값 저장소).
label 로 감싸지 않는다 — label 안의 버튼을 누르면 숨긴 input 이 다시 눌리는 문제가 생긴다. #}
<div class="pj-field-label pj-field-inline">마감일<input type="date" id="pj-f-due" /></div>
{# 색상·아이콘은 label 로 감싸지 않는다 — label 글자를 누르면 첫 버튼이 눌린다. #}
<div class="pj-field-label">색상
<span class="pj-color-palette" id="pj-f-colors"></span>
</div>
<div class="pj-field-label">아이콘
<div class="pj-icon-palette" id="pj-f-icons"></div>
</div>
<div class="pj-field-label">멤버
<div class="pj-member-picker" id="pj-f-members">불러오는 중…</div>
</div>
<div class="pj-modal-actions">
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-project">만들기</button>
</div>
</div>
</div>
<!-- 프로젝트 수정 모달 — 좌측 프로젝트 목록의 ✎ 버튼 / 우클릭 "수정" -->
<div class="pj-modal" id="pj-modal-edit" hidden>
<div class="pj-modal-card">
<h3>프로젝트 수정</h3>
<input type="hidden" id="pj-e-id" />
<label>이름<input type="text" id="pj-e-name" placeholder="프로젝트 이름" autocomplete="off" /></label>
<label>설명<textarea id="pj-e-desc" rows="2"></textarea></label>
{# 마감일 — 오른쪽 달력 아이콘(없으면 점선 원). 시작일은 날짜 팝업의 "+ 시작일"로 — enhanceDateInput(startInput) #}
<div class="pj-field-label pj-field-inline">마감일
<input type="date" id="pj-e-start" />
<input type="date" id="pj-e-due" />
</div>
<div class="pj-field-label">색상
<span class="pj-color-palette" id="pj-e-colors"></span>
</div>
<div class="pj-field-label">아이콘
<div class="pj-icon-palette" id="pj-e-icons"></div>
</div>
<label class="pj-time-toggle">
<input type="checkbox" id="pj-e-done" /> 프로젝트 완료 (목록 끝으로 이동·비활성)
</label>
<div class="pj-modal-actions">
<button type="button" class="pj-btn pj-btn-danger" id="pj-delete-project">삭제</button>
<span style="flex:1"></span>
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-edit">저장</button>
</div>
</div>
</div>
{% endif %}
@@ -0,0 +1,173 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %}
{# 연간 목표 — 좌측 사이드바 "목표" → 연도. 스프레드시트처럼 한 표에
① 매출(목표·실적·달성)·로아스(목표·실적) 월별 숫자
② 업무 영역(상품·마케팅·컨텐츠·유통 …)별 연간·월별 글.
입력·구조 변경은 관리자만(칸별 즉시 저장, project.js initGoals), 나머지는 보기만.
DB: project_db 013 (goal_years·goal_metrics·goal_areas·goal_rows·goal_cells). #}
<div class="pj-wrap pj-inbox-view pj-goal-view">
<div class="pj-layout">
{% with current_pid = 0, side_active = "goals" %}{% include "project/_side.html" %}{% endwith %}
<section class="pj-main">
<div class="pj-section-head">
<h2>{{ goal_year }}년 목표</h2>
{% if board %}
<div class="pj-goal-head-acts">
{% if is_admin %}
<label class="pj-goal-unit">매출 단위
<input type="text" id="pj-goal-unit" maxlength="20" placeholder="예: 백만원"
value="{{ board.sales_unit }}" data-year="{{ goal_year }}" />
</label>
<button type="button" class="pj-btn pj-btn-danger" id="pj-goal-year-del"
data-year="{{ goal_year }}">연도 삭제</button>
{% else %}
{% if board.sales_unit %}<span class="pj-goal-unit-ro">매출 단위: {{ board.sales_unit }}</span>{% endif %}
<span class="pj-goal-note">목표는 관리자만 입력할 수 있습니다.</span>
{% endif %}
</div>
{% endif %}
</div>
<div class="pj-view pj-goal-pane" id="pj-goal-pane">
{% if not goals_enabled %}
<div class="pj-empty">연간 목표가 아직 준비되지 않았습니다(DB 마이그레이션 013 필요).</div>
{% elif not board %}
<div class="pj-empty pj-goal-empty">
<p>{{ goal_year }}년 목표가 아직 없습니다.</p>
{% if is_admin %}
<p class="pj-goal-empty-sub">만들면 가장 가까운 이전 연도의 업무 영역 구성을 그대로 가져옵니다(처음이면 상품·마케팅·컨텐츠·유통).</p>
<button type="button" class="pj-btn pj-btn-primary" id="pj-goal-create" data-year="{{ goal_year }}">{{ goal_year }}년 목표 만들기</button>
{% endif %}
</div>
{% else %}
{% set sm = board.metrics.sales %}
{% set rm = board.metrics.roas %}
{% macro num_cell(metric, kind, labels, mo) -%}
<td class="pj-goal-numtd{% if mo == this_month %} is-now{% endif %}">
{%- if is_admin -%}
<input type="text" class="pj-goal-num" inputmode="decimal" autocomplete="off"
data-metric="{{ metric }}" data-kind="{{ kind }}" data-month="{{ mo }}"
value="{{ labels.get(mo, '') }}" />
{%- else -%}
<span class="pj-goal-num" data-metric="{{ metric }}" data-kind="{{ kind }}" data-month="{{ mo }}">{{ labels.get(mo, '') }}</span>
{%- endif -%}
</td>
{%- endmacro %}
<table class="pj-goal-table" id="pj-goal-table" data-year="{{ goal_year }}"
data-admin="{{ 'true' if is_admin else 'false' }}">
<thead>
<tr>
{# 오른쪽 끝을 끌어 이름 칸 너비 조절 — 브라우저에 기억(localStorage pj_goal_col_w) #}
<th class="pj-goal-c1"><span class="pj-goal-colresize" data-col="c1" title="끌어서 너비 조절"></span></th>
<th class="pj-goal-c2"><span class="pj-goal-colresize" data-col="c2" title="끌어서 너비 조절"></span></th>
<th class="pj-goal-year-col">연간</th>
{% for mo in months %}<th class="{% if mo == this_month %}is-now{% endif %}">{{ mo }}월</th>{% endfor %}
</tr>
</thead>
{# ── 숫자 지표 ── #}
<tbody class="pj-goal-kpi">
<tr>
<th class="pj-goal-c1" rowspan="3">매출</th>
<th class="pj-goal-c2">목표</th>
<td class="pj-goal-sum" data-metric="sales" data-kind="target"></td>
{% for mo in months %}{{ num_cell("sales", "target", sm.target_label, mo) }}{% endfor %}
</tr>
<tr>
<th class="pj-goal-c2">실적</th>
<td class="pj-goal-sum" data-metric="sales" data-kind="actual"></td>
{% for mo in months %}{{ num_cell("sales", "actual", sm.actual_label, mo) }}{% endfor %}
</tr>
<tr class="pj-goal-rate-row">
<th class="pj-goal-c2">달성</th>
<td class="pj-goal-rate" data-month="0"></td>
{% for mo in months %}<td class="pj-goal-rate{% if mo == this_month %} is-now{% endif %}" data-month="{{ mo }}"></td>{% endfor %}
</tr>
<tr>
<th class="pj-goal-c1" rowspan="2">로아스</th>
<th class="pj-goal-c2">목표</th>
<td class="pj-goal-sum pj-goal-sum-na"></td>
{% for mo in months %}{{ num_cell("roas", "target", rm.target_label, mo) }}{% endfor %}
</tr>
<tr>
<th class="pj-goal-c2">실적</th>
<td class="pj-goal-sum pj-goal-sum-na"></td>
{% for mo in months %}{{ num_cell("roas", "actual", rm.actual_label, mo) }}{% endfor %}
</tr>
</tbody>
{# ── 업무 영역 — 영역마다 tbody 하나, 배경은 영역 색 ── #}
{% for area in board.areas %}
<tbody class="pj-goal-area" data-area-id="{{ area.id }}" style="--goal-bg: {{ area.color or '#fff' }}">
{% for row in area.rows %}
<tr data-row-id="{{ row.id }}">
{% if loop.first %}
<th class="pj-goal-c1 pj-goal-area-name" rowspan="{{ area.rows | length }}">
<span class="pj-goal-area-text">{{ area.name }}</span>
{% if is_admin %}
<span class="pj-goal-tools">
<button type="button" class="pj-icon-btn" data-goal-act="area-rename" data-name="{{ area.name }}" title="이름 바꾸기">✎</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-color" data-color="{{ area.color }}" title="색 바꾸기"><span class="material-symbols-outlined">palette</span></button>
<button type="button" class="pj-icon-btn" data-goal-act="area-up" title="위로">↑</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-down" title="아래로">↓</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-add" title="줄 추가">+</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-del" data-name="{{ area.name }}" title="영역 삭제">×</button>
</span>
{% endif %}
</th>
{% endif %}
<th class="pj-goal-c2 pj-goal-row-label">
<span class="pj-goal-row-text">{{ row.label }}</span>
{% if is_admin %}
<span class="pj-goal-tools">
<button type="button" class="pj-icon-btn" data-goal-act="row-rename" data-label="{{ row.label }}" title="줄 이름 바꾸기">✎</button>
{% if area.rows | length > 1 %}
<button type="button" class="pj-icon-btn" data-goal-act="row-up" title="위로">↑</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-down" title="아래로">↓</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-del" data-label="{{ row.label }}" title="줄 삭제">×</button>
{% endif %}
</span>
{% endif %}
</th>
{% for mo in [0] + months %}
<td class="pj-goal-texttd{% if mo == 0 %} pj-goal-year-col{% endif %}{% if mo == this_month %} is-now{% endif %}">
{%- if is_admin -%}
<textarea class="pj-goal-text" rows="1" data-row="{{ row.id }}" data-month="{{ mo }}"
placeholder="{{ '연간 목표' if mo == 0 else '' }}">{{ row.cells.get(mo, '') }}</textarea>
{%- else -%}
<div class="pj-goal-text-ro">{{ row.cells.get(mo, '') }}</div>
{%- endif -%}
</td>
{% endfor %}
</tr>
{% endfor %}
</tbody>
{% endfor %}
</table>
{% if is_admin %}
<div class="pj-goal-foot">
<button type="button" class="pj-btn" id="pj-goal-area-add">+ 업무 영역 추가</button>
<span class="pj-goal-note">칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다.</span>
</div>
{% endif %}
{% endif %}
</div>
</section>
</div>
</div>
{% if goal_area_colors %}<script>window.PJ_GOAL_COLORS = {{ goal_area_colors | tojson }};</script>{% endif %}
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
{% endblock %}
@@ -0,0 +1,525 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project-help.css?v=20260926v" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %}
{# ── 프로젝트 관리 도움말 — 처음 쓰는 사람을 위한 기능 안내(정적 페이지, DB 불필요).
기능이 바뀌면 이 페이지도 같이 고친다(docs/PROJECT_MODULE.md 와 짝). ── #}
<div class="pjh">
<nav class="pjh-toc" aria-label="도움말 목차">
<p class="pjh-toc-title">목차</p>
<ol>
<li><a href="#terms">먼저 알아둘 용어</a></li>
<li><a href="#layout">화면 구성</a></li>
<li><a href="#roles">누가 무엇을 할 수 있나요</a></li>
<li><a href="#project">프로젝트 만들기·고치기</a></li>
<li><a href="#views">보기 전환과 필터</a></li>
<li><a href="#board">보드 — 섹션과 작업 카드</a></li>
<li><a href="#card-subtasks">카드에서 하위 작업 다루기</a></li>
<li><a href="#task">작업 편집 창</a></li>
<li><a href="#subtasks">작업 창의 하위 작업</a></li>
<li><a href="#dates">날짜 고르기</a></li>
<li><a href="#list">목록 보기</a></li>
<li><a href="#calendar">캘린더 보기</a></li>
<li><a href="#timeline">타임라인 보기</a></li>
<li><a href="#dashboard">대시보드</a></li>
<li><a href="#mytasks">내 작업</a></li>
<li><a href="#comments">댓글과 @태그</a></li>
<li><a href="#inbox">수신함과 알림</a></li>
<li><a href="#search">전체 검색과 공유 링크</a></li>
<li><a href="#trash">휴지통 (관리자)</a></li>
<li><a href="#tips">단축키와 자주 묻는 질문</a></li>
</ol>
</nav>
<div class="pjh-body">
<!-- 머리말 + 빠른 시작 -->
<header class="pjh-hero" id="top">
<h1>프로젝트 관리 도움말</h1>
<p>프로젝트 관리는 <b>아사나(Asana) 방식</b>으로 팀의 일을 정리하는 도구입니다.
프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다.
처음이라면 아래 다섯 단계만 따라 해도 바로 쓸 수 있어요.</p>
<div class="pjh-quick">
<div class="pjh-quick-step"><b>1단계</b>왼쪽 목록에서 <b style="display:inline;color:inherit">프로젝트</b>를 누릅니다.</div>
<div class="pjh-quick-step"><b>2단계</b>보드에서 <span class="pjh-ui">+ 작업 추가</span>로 할 일을 만듭니다.</div>
<div class="pjh-quick-step"><b>3단계</b>카드의 사람·달력 아이콘으로 담당자와 마감일을 정합니다.</div>
<div class="pjh-quick-step"><b>4단계</b>카드를 눌러 설명을 쓰고, 댓글에 <kbd>@</kbd>로 동료를 부릅니다.</div>
<div class="pjh-quick-step"><b>5단계</b>일을 마치면 <span class="pjh-ui">✓ 완료로 표시</span>를 누릅니다.</div>
</div>
</header>
<!-- 1. 용어 -->
<section class="pjh-sec" id="terms">
<h2><span class="pjh-num">1</span>먼저 알아둘 용어</h2>
<p class="pjh-lead">화면에 나오는 말은 아사나 한국어판과 같은 용어를 씁니다.</p>
<table class="pjh-table">
<tr><th>용어</th><th>뜻</th></tr>
<tr><td>프로젝트</td><td>함께 진행하는 일의 큰 묶음입니다. 예) “마케팅”, “신상품 출시”. 색상과 아이콘으로 구분합니다.</td></tr>
<tr><td>섹션</td><td>프로젝트 안의 단계나 분류입니다. 보드에서 세로 칸 하나가 섹션입니다. 예) “할 일 · 진행 중 · 검토 · 완료”.</td></tr>
<tr><td>작업</td><td>실제 할 일 하나입니다. 보드의 카드 한 장이 작업 하나입니다.</td></tr>
<tr><td>하위 작업</td><td>작업을 더 잘게 나눈 할 일입니다. 작업 안에 목록으로 붙습니다. 원래 작업은 <b>상위 작업</b>이라고 부릅니다.</td></tr>
<tr><td>담당자</td><td>그 작업을 책임지고 하는 사람 한 명입니다.</td></tr>
<tr><td>협업자</td><td>작업의 진행 소식(완료·댓글)을 함께 받는 사람들입니다. 만든 사람·담당자·댓글 쓴 사람·@태그된 사람은 자동으로 들어갑니다.</td></tr>
<tr><td>마감일 / 시작일</td><td>언제까지 끝낼지(마감일), 언제 시작하는지(시작일, 선택)입니다.</td></tr>
<tr><td>우선순위</td><td>높음 · 보통 · 낮음. 급한 일을 표시합니다.</td></tr>
<tr><td>@태그</td><td>설명이나 댓글에서 <kbd>@</kbd>를 누르고 사람을 고르면, 그 사람의 수신함에 작업이 쌓입니다.</td></tr>
<tr><td>수신함</td><td>나를 태그한 작업과 나에게 온 알림을 모아 보는 곳입니다.</td></tr>
<tr><td>내 작업</td><td>모든 프로젝트에서 내가 담당자인 작업만 모아 보는 곳입니다.</td></tr>
</table>
</section>
<!-- 2. 화면 구성 -->
<section class="pjh-sec" id="layout">
<h2><span class="pjh-num">2</span>화면 구성</h2>
<div class="pjh-map" aria-hidden="true">
<div class="pjh-map-top"><span><b>위쪽 바</b>화면 이름</span><span>🔔 알림 · 내 이름 · 로그아웃 · <b style="display:inline">?</b> 도움말</span></div>
<div class="pjh-map-side"><b>왼쪽 사이드바</b>전체 검색<br>수신함 · 내 작업 · 휴지통 · 목표<br>프로젝트 목록<br>완료 프로젝트<br>전체 멤버</div>
<div class="pjh-map-main"><b>가운데 작업 영역</b>왼쪽 위: 프로젝트 제목 · 멤버<br>그 아래: 보기 탭(보드 · 목록 · 캘린더 · 타임라인 · 대시보드)<br>오른쪽 위: 범위(이 프로젝트 / 전체 프로젝트)<br>필터 바<br>작업들</div>
</div>
<h3>왼쪽 사이드바</h3>
<ul>
<li><b>전체 검색</b> — 내가 볼 수 있는 모든 작업을 제목·설명·댓글로 찾습니다. (<a href="#search">18장</a>)</li>
<li><b>수신함</b> — 나를 태그한 작업과 알림. 숫자 배지는 아직 확인하지 않은 @태그 수입니다. (<a href="#inbox">17장</a>)</li>
<li><b>내 작업</b> — 내가 담당자인 작업 모음. 숫자 배지는 아직 끝나지 않은 작업 수입니다. (<a href="#mytasks">15장</a>)</li>
<li><b>휴지통</b> — 지운 작업을 3개월 보관합니다. 관리자에게만 보입니다. (<a href="#trash">19장</a>)</li>
<li><b>목표</b> — 누르면 바로 아래에 연도가 펼쳐집니다. 연도를 누르면 오른쪽에 그해 전체 목표가 한 표로 나옵니다 —
맨 위에 <b>매출</b>(목표·실적·달성률)과 <b>로아스</b>(목표·실적)를 달마다, 그 아래에 <b>업무 영역</b>(상품·마케팅·컨텐츠·유통 등)별로
연간·월별 계획을 적습니다. 매출의 <b>연간</b> 칸은 월 합계, <b>달성</b>은 실적÷목표(100% 이상 초록)로 저절로 계산됩니다.
<b>입력은 관리자만</b> 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 <b>+ 연도 추가</b>로 새해 목표를
만들고(이전 연도의 업무 영역 구성을 그대로 가져옴), 영역 이름 칸에 마우스를 올려 이름·색·순서·줄 추가·삭제를 합니다.</li>
<li><b>프로젝트</b> — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 <b>완료 프로젝트</b>에 흐리게 모입니다.</li>
<li><b>전체 멤버</b> — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.</li>
</ul>
<h3>위쪽 바</h3>
<ul>
<li><span class="pjh-ui"><span class="material-symbols-outlined">notifications</span></span> 종 아이콘 — 읽지 않은 알림 수가 표시되고, 누르면 수신함으로 갑니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">fit_screen</span></span> 화면 배율 — 누르면(파랗게 켜짐) 화면 전체를 75%로 줄입니다. 2880×1620 모니터를 Windows 배율 200%로 쓰면 화면이 꽉 차 보이는데, 이때 켜면 1920×1080 모니터와 같은 모습이 됩니다. 브라우저마다 기억합니다. 메뉴·말풍선 같은 작은 팝업은 원래 크기로 뜹니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">help</span></span> 물음표 — 지금 보고 있는 이 도움말을 새 탭으로 엽니다.</li>
</ul>
<h3>프로젝트 제목</h3>
<p>가운데 위 프로젝트 제목에 마우스를 올리면 테두리가 생깁니다. 누르면 그 자리에서 이름을 고칩니다 — <kbd>Enter</kbd>나 바깥을 누르면 저장, <kbd>Esc</kbd>는 취소. (그 프로젝트 멤버·관리자만)</p>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>여러 사람이 동시에 써도 걱정 없습니다. 다른 사람이 바꾼 내용은 <b>약 8초 안에</b> 내 화면에 자동으로 반영됩니다(새로고침하지 않아도 됩니다). 내가 입력 중인 창은 건드리지 않습니다.</div></div>
</section>
<!-- 3. 권한 -->
<section class="pjh-sec" id="roles">
<h2><span class="pjh-num">3</span>누가 무엇을 할 수 있나요</h2>
<p class="pjh-lead">프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.</p>
<table class="pjh-table">
<tr><th>할 수 있는 일</th><th>누가</th></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버</b>(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다.</td></tr>
<tr><td>작업·섹션·프로젝트 삭제</td><td><b>만든 사람만</b> 지울 수 있습니다(최고 관리자는 예외).</td></tr>
<tr><td>댓글 고치기·지우기</td><td>댓글을 쓴 사람(또는 관리자)만.</td></tr>
<tr><td>새 프로젝트, 프로젝트 수정·순서 바꾸기</td><td>관리자 (<span class="pjh-ui">+</span> · <span class="pjh-ui">✎</span> · <span class="pjh-ui">⣿</span> 버튼이 관리자에게만 보입니다)</td></tr>
<tr><td>멤버 배정·제외, 프로젝트 소유자 바꾸기</td><td>관리자</td></tr>
<tr><td>다른 프로젝트에서 연결돼 온 작업</td><td>원래 프로젝트 멤버가 아니면 <b>읽기만</b> — 내용·댓글·첨부는 보이지만 고치거나 댓글을 달 수 없습니다(연결된 보드 안에서 섹션 옮기기는 됩니다).</td></tr>
<tr><td>멤버에서 빠졌을 때</td><td>그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고, 예전 링크로도 열리지 않습니다. 새 알림도 오지 않습니다.</td></tr>
<tr><td>휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트</td><td>관리자</td></tr>
<tr><td>목표 보기</td><td>누구나 · <b>목표 입력·연도 추가·업무 영역 편집</b>은 관리자</td></tr>
</table>
</section>
<!-- 4. 프로젝트 -->
<section class="pjh-sec" id="project">
<h2><span class="pjh-num">4</span>프로젝트 만들기·고치기</h2>
<h3>새 프로젝트 만들기 (관리자)</h3>
<ol class="pjh-steps">
<li>왼쪽 사이드바 <b>프로젝트</b> 제목 옆의 <span class="pjh-ui">+</span>를 누릅니다.</li>
<li><b>이름</b>(필수)과 <b>설명</b>을 적습니다.</li>
<li><b>마감일</b> 옆 달력 아이콘을 눌러 날짜를 고릅니다(없어도 됩니다).</li>
<li><b>색상</b>(32가지)과 <b>아이콘</b>을 고릅니다. 아이콘 첫 칸 <span class="pjh-ui">Aa</span>를 고르면 아이콘 대신 이름 첫 글자가 나옵니다.</li>
<li>함께할 <b>멤버</b>에 체크하고 <span class="pjh-ui">만들기</span>를 누릅니다. 만든 사람은 자동으로 프로젝트 주인이 됩니다.</li>
</ol>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span>
<div>새 프로젝트는 섹션 없이 빈 보드로 시작합니다. 보드의 <span class="pjh-ui">+ 섹션 추가</span>로 “할 일 · 진행 중 · 완료”처럼 단계를 먼저 만들어 두면 편합니다. (<a href="#board">6장</a>)</div></div>
<h3>프로젝트 수정 (관리자)</h3>
<p>사이드바의 프로젝트 이름에 마우스를 올리면 오른쪽에 <span class="pjh-ui">✎</span>(수정)과 <span class="pjh-ui">×</span>(삭제)가 나옵니다.
이름에서 <b>마우스 오른쪽 버튼</b>을 눌러도 <span class="pjh-ui">열기 · 수정 · 삭제</span> 메뉴가 나옵니다.</p>
<ul>
<li>이름 · 설명 · 마감일(날짜 창의 <span class="pjh-ui">+ 시작일</span>로 시작일도) · 색상 · 아이콘을 바꿉니다.</li>
<li><b>프로젝트 완료</b>에 체크하면 목록 맨 아래 “완료 프로젝트”로 옮겨지고 흐리게 보입니다.</li>
<li>색이 밝으면(연노랑·하늘색 등) 글자와 아이콘이 자동으로 어둡게 바뀌어 잘 보입니다.</li>
</ul>
<h3>순서 바꾸기 (관리자)</h3>
<p>프로젝트 이름에 마우스를 올리면 왼쪽에 손잡이 <span class="pjh-ui">⣿</span>가 나옵니다. 잡고 위아래로 끌어 놓으면 순서가 저장됩니다.</p>
<h3>프로젝트 삭제</h3>
<p><span class="pjh-ui">×</span> 또는 우클릭 <span class="pjh-ui">삭제</span>. <b>프로젝트를 만든 사람만</b> 지울 수 있고, 안의 작업도 모두 함께 지워집니다.</p>
<div class="pjh-warn"><span class="material-symbols-outlined">warning</span>
<div>프로젝트 삭제는 되돌릴 수 없습니다. 끝난 프로젝트는 지우기보다 <b>프로젝트 완료</b>로 표시하는 것을 권합니다.</div></div>
<h3>멤버 배정 (관리자)</h3>
<p>프로젝트 화면 제목 오른쪽에 멤버 사진이 겹쳐서 보입니다.</p>
<ul>
<li><span class="pjh-ui">+</span> — 멤버를 추가합니다(프로젝트 관리 권한이 있는 직원 중에서 고릅니다).</li>
<li>사진에 마우스 → 이름이 보입니다. <b>클릭</b> → 그 사람이 이 프로젝트에서 맡은 작업 목록이 뜹니다.</li>
<li>사진에서 <b>우클릭</b> → <span class="pjh-ui">제외</span>로 멤버에서 뺍니다.</li>
</ul>
</section>
<!-- 5. 보기 전환과 필터 -->
<section class="pjh-sec" id="views">
<h2><span class="pjh-num">5</span>보기 전환과 필터</h2>
<h3>보기 탭</h3>
<p>프로젝트 화면 맨 위 왼쪽의 탭으로 같은 작업을 다른 모양으로 봅니다.</p>
<table class="pjh-table">
<tr><th>탭</th><th>이럴 때 좋아요</th></tr>
<tr><td>보드</td><td>섹션(단계)별 카드로 흐름을 볼 때. 카드를 끌어 단계를 옮깁니다. (<a href="#board">6장</a>)</td></tr>
<tr><td>목록</td><td>표처럼 한 줄씩 빠르게 훑고 정렬할 때. (<a href="#list">11장</a>)</td></tr>
<tr><td>캘린더</td><td>한 달 달력에서 일정을 볼 때. (<a href="#calendar">12장</a>)</td></tr>
<tr><td>타임라인</td><td>기간(시작~마감)을 막대로 보며 일정을 조정할 때. (<a href="#timeline">13장</a>)</td></tr>
<tr><td>대시보드</td><td>완료·미완료·지연 숫자와 차트로 진행 상황을 볼 때. (<a href="#dashboard">14장</a>)</td></tr>
</table>
<h3>범위: 이 프로젝트 / 전체 프로젝트</h3>
<p>화면 오른쪽 위 토글입니다. <b>이 프로젝트</b>는 지금 프로젝트만, <b>전체 프로젝트</b>는 내가 볼 수 있는 모든 프로젝트의 작업을 함께 보여줍니다.
전체 프로젝트일 때는 위 제목이 <b>전체 프로젝트</b>로 바뀌고, 카드 위에는 어느 프로젝트 작업인지 이름이 붙습니다.</p>
<h3>필터 바</h3>
<p>탭 아래 한 줄로 작업을 거르고 정렬합니다. 다섯 가지 보기 모두에 똑같이 적용되고, 프로젝트마다 이 브라우저에 기억됩니다.</p>
<ul>
<li><b>찾기</b> — 제목·설명·담당자에 들어간 글자로 거릅니다.</li>
<li><b>상태</b> — 전체 / 미완료 / 완료</li>
<li><b>담당자</b> — 전체 / 나 / 담당자 없음 / 특정 사람</li>
<li><b>마감</b> — 전체 / 마감 지남 / 오늘 마감 / 이번 주 마감 / 마감일 없음</li>
<li><b>우선순위</b> — 전체 / 높음 / 보통 / 낮음</li>
<li><b>정렬</b> — 기본 / 마감일순 / 우선순위순 / 제목순 / 담당자순 / 최근 생성순</li>
<li><span class="pjh-ui">초기화</span> — 필터를 모두 처음 상태로 되돌립니다.</li>
</ul>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>보드에서 카드 <b>순서</b>를 끌어 바꾸는 것은 “정렬: 기본”이고 필터를 쓰지 않을 때만 됩니다. 필터로 일부가 가려져 있으면 놓은 자리와 실제 순서가 어긋나기 때문입니다.</div></div>
</section>
<!-- 6. 보드 -->
<section class="pjh-sec" id="board">
<h2><span class="pjh-num">6</span>보드 — 섹션과 작업 카드</h2>
<p class="pjh-lead">보드는 섹션(세로 칸)이 옆으로 늘어선 화면입니다. 섹션이 많으면 가로로 스크롤되고, 한 섹션에 카드가 많으면 그 섹션 안에서만 세로로 스크롤됩니다.</p>
<h3>섹션 다루기</h3>
<ul>
<li><b>섹션 추가</b> — 마지막 섹션 바로 오른쪽의 <span class="pjh-ui">+ 섹션 추가</span>.</li>
<li><b>이름 바꾸기</b> — 섹션 이름을 누르면 그 자리에서 고칩니다. <kbd>Enter</kbd> 저장, <kbd>Esc</kbd> 취소.</li>
<li><b>순서 바꾸기</b> — 섹션 머리(이름 줄)를 잡고 좌우로 끌어 놓습니다.</li>
<li><b>… 메뉴</b>(머리 오른쪽 <span class="pjh-ui">…</span> 또는 머리 우클릭):
<ul>
<li><span class="pjh-ui">작업 추가</span> · <span class="pjh-ui">이름 변경</span></li>
<li><span class="pjh-ui">섹션 편집</span> — 색상과 <b>기본 담당자</b>를 정합니다. 색상 첫 칸(연회색)은 “색 없음”입니다.</li>
<li><span class="pjh-ui">섹션 작업 모두 완료</span> — 그 섹션의 미완료 작업을 한 번에 완료합니다.</li>
<li><span class="pjh-ui">완료 섹션으로 지정</span> — 이 섹션으로 옮긴 카드는 <b>자동으로 완료</b>되고, 밖으로 빼면 다시 미완료가 됩니다. 완료 섹션은 흐리게, 보드 끝에 놓입니다.</li>
<li><span class="pjh-ui">삭제</span> — 섹션을 만든 사람만. 안의 작업은 지워지지 않고 “미지정” 칸으로 모입니다.</li>
</ul>
</li>
</ul>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span>
<div><b>기본 담당자</b>를 정해 두면, 그 섹션에 담당자 없는 작업을 새로 만들거나 옮겨 올 때 그 사람이 자동으로 담당자가 됩니다. 예) “검토” 섹션의 기본 담당자 = 팀장.</div></div>
<h3>작업 카드 다루기</h3>
<ul>
<li><b>작업 추가</b> — 섹션 머리의 <span class="pjh-ui">+</span> 또는 섹션 맨 아래 <span class="pjh-ui">+ 작업 추가</span>. 오른쪽에 작업 편집 창이 열립니다.</li>
<li><b>열기</b> — 카드를 누르면 오른쪽에 작업 편집 창이 열립니다. (<a href="#task">8장</a>)</li>
<li><b>담당자·마감일 바로 바꾸기</b> — 카드의 사람 아이콘이나 날짜를 누르면 그 자리에서 바꿉니다. 비어 있으면 카드에 마우스를 올렸을 때 점선 원 아이콘이 나타납니다.</li>
<li><b>옮기기</b> — 카드를 끌어 다른 섹션에 놓으면 섹션이 바뀌고, 같은 섹션 안에서 위아래로 놓으면 순서가 바뀝니다.</li>
<li><b>우클릭 메뉴</b> — <span class="pjh-ui">열기 · 작업 링크 복사 · 완료로 표시 · 삭제</span></li>
<li><b>댓글</b> — 카드의 <span class="pjh-ui">💬 N</span>을 한 번 누르면 댓글 대화창이 열립니다. (<a href="#comments">16장</a>)</li>
</ul>
<h3>마감일 색의 의미</h3>
<table class="pjh-table">
<tr><th>표시</th><th>뜻</th></tr>
<tr><td style="color:#3f8f6b">오늘 · 내일</td><td>곧 마감(초록)</td></tr>
<tr><td style="color:#c22b10">어제 · 09/20(일)</td><td>마감이 지남(빨강). <b>완료한 작업도</b> 지난 마감일은 빨강으로 남아 늦게 끝낸 것을 알 수 있습니다.</td></tr>
<tr><td>09/30(수)</td><td>그 밖의 날짜(기본 글자색)</td></tr>
</table>
</section>
<!-- 7. 카드의 하위 작업 -->
<section class="pjh-sec" id="card-subtasks">
<h2><span class="pjh-num">7</span>카드에서 하위 작업 다루기</h2>
<p class="pjh-lead">하위 작업이 있는 카드에는 <span class="pjh-ui">3 ⤷ ▾</span> 처럼 개수 버튼이 붙습니다. 누르면 카드 아래로 하위 작업 목록이 펼쳐집니다.</p>
<ul>
<li><b>완료</b> — 줄 왼쪽 <span class="pjh-ui">✓</span>를 누릅니다.</li>
<li><b>마감일·담당자</b> — 줄 오른쪽 날짜나 사람 아이콘을 누르면 그 자리에서 바꿉니다.</li>
<li><b>열기</b> — 줄을 누르면 그 하위 작업이 작업처럼 편집 창으로 열립니다.</li>
<li><b>우클릭</b> — <span class="pjh-ui">열기 · 상위 작업 열기 · 완료로 표시 · 하위 작업 삭제</span></li>
<li><b>다른 작업으로 옮기기</b> — 하위 작업 한 줄을 끌어서 <b>다른 카드</b>에 놓으면 그 작업의 하위 작업이 됩니다(놓을 수 있는 카드는 보라색 테두리가 생깁니다). 같은 프로젝트 안에서만 옮길 수 있습니다.</li>
</ul>
<h3>+ 하위 작업 추가</h3>
<ol class="pjh-steps">
<li>펼친 목록 맨 아래 <span class="pjh-ui">+ 하위 작업 추가</span>를 누릅니다.</li>
<li>새 줄의 “작업 이름 입력” 칸에 이름을 씁니다.</li>
<li>필요하면 달력 아이콘으로 마감일, 사람 아이콘으로 담당자를 고릅니다.</li>
<li><kbd>Enter</kbd>를 누르면 만들어지고, 빈 줄이 다시 열려 다음 하위 작업을 이어서 쓸 수 있습니다.</li>
<li>이름을 쓴 채 <b>다른 곳을 누르면</b> <kbd>Enter</kbd>와 같이 만들어지고 줄이 닫힙니다.</li>
<li>만들지 않고 닫으려면 <kbd>Esc</kbd>를 누르거나, 빈 채로 다른 곳을 누릅니다.</li>
</ol>
</section>
<!-- 8. 작업 편집 창 -->
<section class="pjh-sec" id="task">
<h2><span class="pjh-num">8</span>작업 편집 창</h2>
<p class="pjh-lead">카드·목록 줄·캘린더 막대를 누르면 화면 오른쪽에 작업 편집 창이 열립니다. 창의 왼쪽 가장자리를 끌면 너비를 넓히거나 좁힐 수 있습니다.</p>
<h3>맨 위 버튼</h3>
<table class="pjh-table">
<tr><th>버튼</th><th>하는 일</th></tr>
<tr><td><span class="pjh-ui"><span class="material-symbols-outlined">link</span>공유</span></td><td>이 작업의 주소를 복사합니다. 메신저로 보내면 받은 멤버가 바로 이 작업을 엽니다.</td></tr>
<tr><td><span class="pjh-ui">✓ 완료로 표시</span></td><td>작업을 완료합니다. 다시 누르면 <span class="pjh-ui">↩ 완료 취소</span>.</td></tr>
<tr><td><span class="pjh-ui">삭제</span></td><td>작업을 지웁니다(만든 사람만). 하위 작업이 있으면 함께 지울지 한 번 더 묻습니다. 지운 작업은 휴지통에 3개월 보관됩니다.</td></tr>
<tr><td><span class="pjh-ui">저장됨</span></td><td>저장 버튼이 없습니다 — 고치는 즉시 저장되고, 버튼 줄 오른쪽에 <span class="pjh-ui">저장 중…</span> → <span class="pjh-ui">✓ 저장됨</span>이 잠깐 보입니다. 저장이 안 되면 <span class="pjh-ui">저장 실패 · 다시 시도</span>(눌러서 다시 저장)가 뜨고, 이 상태로 창을 닫거나 다른 작업을 열면 한 번 더 저장해 본 뒤 <b>버리고 넘어갈지 / 계속 편집할지</b> 묻습니다 — 모른 채 내용이 사라지지 않습니다. 이미지를 올리는 중이면 다 올라갈 때까지 기다렸다가 넘어갑니다.</td></tr>
</table>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div><b>실시간 저장</b> — 제목은 칸을 벗어나거나 <kbd>Enter</kbd>, 설명은 입력을 멈추고 1초쯤 뒤(또는 칸을 벗어날 때), 담당자·섹션·우선순위·마감일은 바꾸는 즉시 저장됩니다. 새 작업은 <b>제목을 쓰는 순간</b> 만들어집니다(제목 없이 닫으면 만들어지지 않습니다). 협업자 · 하위 작업 · 첨부 파일 · 다른 프로젝트 추가 · 댓글도 누르는 즉시 저장됩니다.</div></div>
<h3>제목과 기본 정보</h3>
<ul>
<li><b>제목</b> — 맨 위 큰 글씨를 눌러 바로 고칩니다.</li>
<li><b>담당자</b> — 사진+이름을 누르면 “아이콘 + 이름” 목록에서 고릅니다. <span class="pjh-ui">담당자 없음</span>도 있습니다.</li>
<li><b>섹션</b> — 이 작업이 들어갈 섹션을 고릅니다.</li>
<li><b>우선순위</b> — 높음 · 보통 · 낮음</li>
<li><b>마감일</b> — 달력 아이콘을 누르면 날짜 창이 열립니다. (<a href="#dates">10장</a>)</li>
</ul>
<h3>협업자</h3>
<ul>
<li>협업자는 사진+이름으로 보입니다. 사람에 마우스를 올리면 <span class="pjh-ui">×</span>가 나와 뺄 수 있습니다.</li>
<li>협업자가 없으면 점선 원 <span class="pjh-ui">협업자 없음</span>을 눌러 추가하고, 있으면 옆 <span class="pjh-ui">+</span>로 추가합니다.</li>
<li>오른쪽 <span class="pjh-ui">협업자로 참여</span> / <span class="pjh-ui">협업자에서 나가기</span>로 나 자신을 넣고 뺍니다.</li>
<li>협업자에게는 작업 완료와 새 댓글 알림이 갑니다.</li>
</ul>
<h3>설명</h3>
<ul>
<li>서식 도구(왼쪽부터): <span class="pjh-ui"><span class="material-symbols-outlined">format_bold</span></span> 굵게 · <span class="pjh-ui"><span class="material-symbols-outlined">format_italic</span></span> 기울임 · <span class="pjh-ui"><span class="material-symbols-outlined">format_underlined</span></span> 밑줄 · <span class="pjh-ui"><span class="material-symbols-outlined">format_strikethrough</span></span> 취소선(<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>X</kbd>) · <span class="pjh-ui"><span class="material-symbols-outlined">format_list_bulleted</span></span> 글머리 목록 · <span class="pjh-ui"><span class="material-symbols-outlined">format_list_numbered</span></span> 번호 목록 · <span class="pjh-ui"><span class="material-symbols-outlined">check_box</span></span> 체크박스 · <span class="pjh-ui"><span class="material-symbols-outlined">format_quote</span></span> 인용 · <span class="pjh-ui"><span class="material-symbols-outlined">link</span></span> 링크 · <span class="pjh-ui"><span class="material-symbols-outlined">format_clear</span></span> 서식 지우기 · <span class="pjh-ui"><span class="material-symbols-outlined">image</span></span> 이미지 넣기. 아이콘에 마우스를 올리면 이름이 나옵니다.</li>
<li><b>체크박스(체크리스트)</b> — 글머리 목록처럼 씁니다. <span class="pjh-ui"><span class="material-symbols-outlined">check_box</span></span>를 누르면 지금 줄(또는 고른 줄들)이 체크리스트가 되어 줄마다 체크박스가 붙습니다. <kbd>Enter</kbd>로 새 줄을 만들면 체크박스도 함께 생기고, 빈 줄에서 <kbd>Enter</kbd>를 누르면 목록이 끝납니다. 체크박스를 누르면 체크되고 그 줄은 흐리게 취소선이 그어집니다. 다시 <span class="pjh-ui"><span class="material-symbols-outlined">check_box</span></span>를 누르면 평범한 글로, 글머리·번호 버튼을 누르면 그 목록으로 바뀝니다. 체크 상태도 바로 저장됩니다.</li>
<li><b>이미지</b> — 캡처한 그림을 <kbd>Ctrl</kbd>+<kbd>V</kbd>로 바로 붙여 넣을 수 있습니다. 그림을 누르면 모서리를 끌어 크기를 바꾸거나 지울 수 있습니다.</li>
<li><b>링크</b> — 웹 주소를 붙여 넣으면 자동으로 링크가 되고, 누르면 새 탭에서 열립니다.</li>
<li><b>@태그</b> — <kbd>@</kbd>를 누르면 사람 목록이 뜹니다. 고른 사람의 수신함에 이 작업이 쌓입니다.</li>
</ul>
<h3>첨부 파일</h3>
<p><span class="pjh-ui">파일 추가</span>로 파일을 올립니다(한 파일 최대 20MB). 파일 이름을 누르면 내려받고, <span class="pjh-ui">×</span>로 지웁니다.</p>
<h3>프로젝트 (다른 프로젝트에 추가)</h3>
<p>작업 하나를 <b>여러 프로젝트의 보드에 동시에</b> 보이게 합니다. 예) 신상품 프로젝트의 작업을 디자인 프로젝트 보드에도 올리기.</p>
<ol class="pjh-steps">
<li>“프로젝트” 칸에서 프로젝트를 고릅니다.</li>
<li>그 프로젝트에서 들어갈 섹션을 고릅니다.</li>
<li><span class="pjh-ui">다른 프로젝트에 추가</span>를 누릅니다. 빼려면 이름 옆 <span class="pjh-ui">×</span>(연결 해제).</li>
</ol>
<p>작업은 하나라서 어느 보드에서 고쳐도 모두 같이 바뀝니다.</p>
<h3>댓글</h3>
<p>작업 창 맨 아래에 항상 고정된 댓글 칸에 쓰고 <kbd>Enter</kbd>(스크롤해도 그 자리에 있습니다). 칸 오른쪽 <span class="pjh-ui">☺</span>는 이모티콘, <span class="pjh-ui">@</span>는 멤버 태그입니다. 답글은 원 댓글 아래 들여 쓰여 <span class="pjh-ui">↳</span> 표시와 함께 보입니다. 내가 쓴 댓글은 <span class="pjh-ui">✎</span>로 고치고 <span class="pjh-ui">×</span>로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다. 댓글에 붙인 파일은 그 댓글 아래에 보이고(파일만 보낸 댓글도), 첨부 파일 목록에는 <span class="pjh-ui">댓글</span> 표시가 붙습니다.</p>
<p>댓글 대화창에서 파일을 보낼 때 보낼 수 없는 파일(빈 파일, 20MB 초과)이 있으면 댓글을 만들지 않고 그 파일만 빨갛게 표시합니다 — 빼고 다시 보내세요. 인터넷이 끊겨도 쓴 내용과 파일은 그대로 남아 다시 보낼 수 있고, 같은 댓글이 두 번 올라가지 않습니다. @태그는 이 작업을 볼 수 있는 사람만 고를 수 있습니다. 한글을 입력하는 중(조합 중)의 <kbd>Enter</kbd>는 글자 확정만 하고 보내지 않습니다.</p>
</section>
<!-- 9. 작업 창의 하위 작업 -->
<section class="pjh-sec" id="subtasks">
<h2><span class="pjh-num">9</span>작업 창의 하위 작업</h2>
<p class="pjh-lead">작업 편집 창 가운데 “하위 작업” 목록입니다. 한 줄에 하나씩, 아사나처럼 다룹니다.</p>
<ul>
<li><b>추가</b> — 목록 아래 입력칸에 이름을 쓰고, 필요하면 담당자·마감일을 고른 뒤 <span class="pjh-ui">추가</span> 또는 <kbd>Enter</kbd>.</li>
<li><b>순서 바꾸기</b> — 줄에 마우스를 올리면 왼쪽에 <span class="pjh-ui">⠿</span> 손잡이가 나옵니다. 잡고 위아래로 끌어 놓습니다.</li>
<li><b>완료</b> — <span class="pjh-ui">✓</span>를 누릅니다. 완료한 줄은 취소선이 그어집니다.</li>
<li><b>이름 고치기</b> — 이름 글자를 눌러 바로 고칩니다(칸은 이름 길이만큼만 차지합니다).</li>
<li><b>마감일·담당자</b> — 날짜 글자나 사람 아이콘을 누릅니다. 비어 있으면 줄에 마우스를 올렸을 때 점선 아이콘이 나옵니다.</li>
<li><b>열기</b> — 줄의 빈 곳이나 오른쪽 <span class="pjh-ui">›</span>를 누르면 그 하위 작업이 편집 창으로 열립니다.</li>
<li><b>하위 작업의 하위 작업</b> — 그 하위 작업 안에도 하위 작업이 있으면 이름 옆에 <span class="pjh-ui">N ⤷</span> 아이콘이 붙습니다(보드 카드의 펼친 목록도 같음).</li>
<li><b>삭제</b> — 줄에서 우클릭 → <span class="pjh-ui">하위 작업 삭제</span>.</li>
</ul>
<h3>하위 작업을 열었을 때</h3>
<p>하위 작업도 작업과 똑같이 설명 · 담당자 · 마감일 · 협업자 · 첨부 파일 · 댓글을 모두 쓸 수 있습니다. 제목 위에 <span class="pjh-ui">↰ 상위 작업 이름</span>이 보이고, 누르면 상위 작업으로 돌아갑니다. 하위 작업에는 섹션이 없어서 섹션 칸은 나오지 않습니다.</p>
</section>
<!-- 10. 날짜 -->
<section class="pjh-sec" id="dates">
<h2><span class="pjh-num">10</span>날짜 고르기</h2>
<p class="pjh-lead">마감일을 고르는 곳은 어디서나 같은 날짜 창이 열립니다.</p>
<ul>
<li><b>달력에서 고르기</b> — 날짜를 누릅니다. <span class="pjh-ui">‹</span> <span class="pjh-ui">›</span>로 달을 넘깁니다.</li>
<li><b>직접 입력</b> — 위 칸에 <code>2026-09-30</code>, <code>9/30</code>, <code>9월 30일</code>, <code>0930</code> 처럼 쓰고 <kbd>Enter</kbd>.</li>
<li><span class="pjh-ui">오늘</span> — 오늘 날짜로. <span class="pjh-ui">지우기</span> — 날짜를 비웁니다.</li>
<li><span class="pjh-ui">+ 시작일</span> — 기간이 있는 일이면 시작일도 넣습니다(보드 카드·프로젝트 수정에서).</li>
<li>창 바깥을 누르거나 <kbd>Esc</kbd>로 닫습니다.</li>
</ul>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>보드 카드와 하위 작업 줄에서는 날짜를 누르는 즉시 저장됩니다. 작업 편집 창의 마감일도 고르는 즉시 저장됩니다.</div></div>
</section>
<!-- 11. 목록 -->
<section class="pjh-sec" id="list">
<h2><span class="pjh-num">11</span>목록 보기</h2>
<ul>
<li><b>이 프로젝트</b> 범위에서는 섹션별로 묶여 보이고, <b>전체 프로젝트</b>에서는 프로젝트·섹션이 칸으로 나오는 표가 됩니다.</li>
<li>칸 제목(작업 · 담당자 · 섹션 · 우선순위 · 시작 · 마감)을 누르면 그 기준으로 정렬하고, 한 번 더 누르면 반대로 정렬합니다.</li>
<li>칸 제목 사이 경계를 끌면 칸 너비가 바뀝니다.</li>
<li>줄을 누르면 작업 편집 창, 우클릭하면 작업 메뉴, <span class="pjh-ui">💬</span>를 누르면 댓글 대화창이 열립니다.</li>
</ul>
</section>
<!-- 12. 캘린더 -->
<section class="pjh-sec" id="calendar">
<h2><span class="pjh-num">12</span>캘린더 보기</h2>
<ul>
<li>한 달 달력에 작업이 <b>시작일~마감일</b> 막대로 표시됩니다(시작일이 없으면 마감일 하루). 공휴일은 빨간색입니다.</li>
<li><span class="pjh-ui">‹</span> <span class="pjh-ui">›</span>로 지난달·다음 달로 갑니다.</li>
<li>막대를 <b>누르면</b> 작업 편집 창이 열리고, <b>끌어서 다른 날에 놓으면</b> 날짜가 옮겨집니다.</li>
<li>하루에 작업이 많으면 <span class="pjh-ui">+N</span>이 나옵니다. 누르면 그날 작업 목록이 뜹니다.</li>
<li>막대 우클릭 → 작업 메뉴(열기 · 작업 링크 복사 · 완료로 표시 · 삭제).</li>
</ul>
</section>
<!-- 13. 타임라인 -->
<section class="pjh-sec" id="timeline">
<h2><span class="pjh-num">13</span>타임라인 보기</h2>
<ul>
<li>기간이 있는(시작일 또는 마감일이 있는) 작업이 가로 막대로 나옵니다. <b>이 프로젝트</b>는 섹션별 줄, <b>전체 프로젝트</b>는 프로젝트별 줄이며 프로젝트 전체 기간이 옅은 배경으로 깔립니다.</li>
<li>작업은 아사나처럼 <b>카드</b>로 보입니다 — 담당자 사진 · 제목 · 하위 작업이 있으면 <span class="pjh-ui">N ⤷</span> · 댓글이 있으면 <span class="pjh-ui">💬 N</span>(누르면 댓글 대화창), 아래 줄에 “마감일: 9월 23일”처럼 날짜. 기간이 있는 작업은 기간만큼 막대로 늘어납니다.</li>
<li>카드에 하위 작업이 있으면 <span class="pjh-ui">N ⤷</span>(마우스를 올리면 “하위 작업 N개”), 설명이 있으면 줄글 아이콘이 붙습니다. 하위 작업은 작업 편집 창에서 봅니다.</li>
<li>줄 색은 <b>섹션 편집에서 정한 섹션 색</b>입니다(색이 없는 섹션은 프로젝트 색). 왼쪽 섹션 이름 앞에도 같은 색 네모가 붙습니다. 주말은 세로줄이 옅은 회색입니다.</li>
<li>카드(막대)를 <b>바로 끌면</b> 하루 단위로 기간 전체가 이동하고(하루짜리 작업은 마감일이 옮겨집니다), 기간 막대의 <b>양 끝을 끌면</b> 시작일이나 마감일만 바뀝니다. 먼저 눌러 선택하지 않아도 됩니다.</li>
<li>처음 열면 하루 칸이 날짜 글자(“30일 (수)”) 폭만큼이라 한 화면에 여러 날이 보입니다. <kbd>Ctrl</kbd> + 마우스 휠로 확대·축소(하루 칸이 날짜 글자 폭이 되면 더 줄어들지 않습니다), 빈 곳을 끌면 좌우로 이동합니다(보던 구간은 기억). <span class="pjh-ui">오늘</span>로 오늘 날짜로 돌아옵니다.</li>
<li>아래 날짜 줄은 캘린더와 같은 색입니다 — <span style="color:#1d4ed8;font-weight:700">토요일은 파랑</span>, <span style="color:#c22b10;font-weight:700">일요일·국경일·대체공휴일은 빨강</span>. 공휴일은 날짜 밑에 이름(예: 추석, 대체휴일)이 나오고, 마우스를 올리면 전체 이름이 보입니다.</li>
<li>카드의 <b>작업 이름을 누르면</b> 오른쪽에 작업 편집 창이 열립니다(더블클릭도 같음). <b>우클릭</b> → 작업 메뉴. 마우스를 올리면 작업 정보가 보입니다.</li>
</ul>
</section>
<!-- 14. 대시보드 -->
<section class="pjh-sec" id="dashboard">
<h2><span class="pjh-num">14</span>대시보드</h2>
<ul>
<li>위쪽 숫자 카드 4개: <b>완료된 작업 합계 · 미완료 작업 합계 · 마감일이 지난 작업 합계 · 작업 합계</b></li>
<li><b>미완료 작업 합계(섹션별)</b> — 섹션마다 남은 일이 몇 개인지 막대로 보여줍니다. 막대에 마우스를 올리면 숫자가 나옵니다.</li>
<li><b>작업 합계(완료 상태별)</b> — 완료와 미완료 비율을 도넛 차트로 보여줍니다.</li>
<li><b>예정된 작업 합계(담당자별)</b> — 사람별로 일정이 잡힌 미완료 작업 수(상위 10명). <b>관리자에게만</b> 보입니다.</li>
<li>범위(이 프로젝트/전체 프로젝트)와 필터 바 설정을 그대로 따라 계산합니다.</li>
</ul>
</section>
<!-- 15. 내 작업 -->
<section class="pjh-sec" id="mytasks">
<h2><span class="pjh-num">15</span>내 작업</h2>
<p class="pjh-lead">왼쪽 사이드바 <b>내 작업</b>(프로젝트 관리 첫 화면)은 모든 프로젝트에서 내가 담당자인 작업만 한 표로 보여줍니다.</p>
<ul>
<li>위쪽 탭 <span class="pjh-ui">진행 중 · 완료 · 전체</span>로 고릅니다. 옆에 전체 개수와 지연(마감 지남) 개수가 나옵니다.</li>
<li>찾기(제목·설명·프로젝트), 마감(마감 지남·오늘·이번 주·마감일 없음), 우선순위로 거를 수 있습니다.</li>
<li>칸 제목을 누르면 정렬합니다.</li>
<li>줄을 누르면 그 작업의 프로젝트 화면으로 가서 작업 편집 창이 바로 열립니다. 우클릭하면 작업 메뉴가 나옵니다.</li>
<li>내가 담당자인 하위 작업은 상위 작업 이름 아래에 들여 쓴 줄로 나옵니다.</li>
</ul>
</section>
<!-- 16. 댓글과 @태그 -->
<section class="pjh-sec" id="comments">
<h2><span class="pjh-num">16</span>댓글과 @태그</h2>
<h3>댓글 대화창</h3>
<p>카드·목록·캘린더·내 작업에 보이는 <span class="pjh-ui">💬 N</span>을 <b>한 번 누르면</b> 메신저처럼 생긴 댓글 대화창이 열립니다.</p>
<ul>
<li>입력칸에 쓰고 <span class="pjh-ui">전송</span> 또는 <kbd>Enter</kbd>.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">attach_file</span></span>로 파일을 붙이거나, 캡처한 이미지를 <kbd>Ctrl</kbd>+<kbd>V</kbd>로 붙여 넣습니다. 이미지는 작은 그림으로 보입니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">add_reaction</span></span>를 누르면 이모티콘 창이 열립니다. 종류별 탭으로 넘기거나 <b>검색</b>(예: 축하, 감사, 완료)으로 찾고, 누르면 커서 자리에 들어갑니다. 자주 쓴 이모티콘은 맨 위에 모입니다. 작업 팝업 아래 댓글 입력칸에도 같은 버튼이 있습니다.</li>
<li>웹 주소를 붙여 넣으면 링크가 되고, 누르면 새 탭에서 열립니다.</li>
<li>아직 읽지 않은 새 댓글이 있으면 말풍선이 깜빡이고 숫자가 빨간색으로 바뀝니다.</li>
</ul>
<h3>반응 · 답글 · 완료 표시 (아사나식)</h3>
<ul>
<li><b>반응</b> — 댓글에 마우스를 올리면 오른쪽 위에 👍 👀 🙌 ✅ 와 <span class="pjh-ui"><span class="material-symbols-outlined">add_reaction</span></span>가 뜹니다. 누르면 댓글 아래에 반응이 붙고(누른 사람 수), 내가 누른 반응은 파랗게 보입니다. 다시 누르면 취소됩니다. 반응에 마우스를 올리면 누가 눌렀는지 보입니다.</li>
<li><b>답글</b> — 같은 도구 모음의 <span class="pjh-ui"><span class="material-symbols-outlined">reply</span></span>. 작업 창에서는 원 댓글 아래 들여쓰기로 달리고, 댓글 대화창에서는 입력칸 위에 “OO 님에게 답글”이 뜬 뒤 보내면 말풍선 위에 원 댓글이 인용됩니다. 원 댓글을 지우면 답글도 함께 지워집니다.</li>
<li><b>작업 완료</b> — 작업을 완료하면 댓글 사이에 <span class="pjh-ui">✔ OO 님이 이 작업을 완료했습니다</span> 줄이 자동으로 생깁니다(댓글 수에는 세지 않습니다). 완료를 취소하면 이 줄도 사라지고, 다시 완료하면 마지막 완료 한 줄만 보입니다.</li>
<li><b>@태그 표시</b> — 댓글 속 <kbd>@아이디</kbd>는 프로필 아이콘 + 이름 칩으로 보입니다.</li>
</ul>
<h3>@태그로 동료 부르기</h3>
<ol class="pjh-steps">
<li>설명이나 댓글에서 <kbd>@</kbd>를 누릅니다.</li>
<li>이름 몇 글자를 치면 목록이 좁혀집니다. 방향키와 <kbd>Enter</kbd> 또는 마우스로 고릅니다.</li>
<li>저장(설명) 또는 전송(댓글)하면, 태그된 사람의 <b>수신함 → 나를 태그한 작업</b>에 이 작업이 올라가고 그 사람은 자동으로 협업자가 됩니다.</li>
</ol>
</section>
<!-- 17. 수신함과 알림 -->
<section class="pjh-sec" id="inbox">
<h2><span class="pjh-num">17</span>수신함과 알림</h2>
<h3>수신함 화면</h3>
<ul>
<li><b>나를 태그한 작업</b> — 누가 나를 @태그했는지와 함께 보입니다. <span class="pjh-ui">태그 모두 확인</span>으로 한 번에 확인 처리합니다.</li>
<li><b>알림</b> — 작업 배정 · 작업 완료 · 새 댓글 · 마감 알림이 쌓입니다. 항목을 누르면 읽음이 되고, <span class="pjh-ui">확인</span>을 누르면 수신함에 머문 채 <b>오른쪽에 그 작업 창</b>이 열립니다(나를 태그한 작업도 같음). 창 맨 위 <span class="pjh-ui">프로젝트로 이동</span>을 누르면 그 작업이 있는 프로젝트 화면으로 갑니다. 창을 닫으면(→| 또는 <kbd>Esc</kbd>) 다시 수신함입니다. <kbd>Ctrl</kbd>+클릭하면 새 탭에서 프로젝트 화면으로 엽니다.</li>
<li><span class="pjh-ui">알림 모두 읽음</span>으로 한 번에 읽음 처리합니다. 읽지 않은 알림에서 우클릭 → <span class="pjh-ui">읽음으로 표시</span>도 됩니다.</li>
</ul>
<h3>어떤 알림이 누구에게 가나요?</h3>
<table class="pjh-table">
<tr><th>알림</th><th>받는 사람</th></tr>
<tr><td>작업 배정</td><td>새로 담당자가 된 사람</td></tr>
<tr><td>작업 완료 · 새 댓글</td><td>담당자와 협업자</td></tr>
<tr><td>마감 알림</td><td>담당자(담당자가 없으면 협업자 전원). 영업일 아침 9시에 “내일 마감 · 오늘 마감 · 마감 지남”을 한 번씩 알려줍니다.</td></tr>
<tr><td>@태그</td><td>태그된 사람(수신함의 “나를 태그한 작업”)</td></tr>
</table>
<p>내가 한 행동은 나에게 알리지 않습니다. 회사 설정에 따라 작업 배정·완료는 관리자 메일로도 갑니다.</p>
</section>
<!-- 18. 검색과 공유 -->
<section class="pjh-sec" id="search">
<h2><span class="pjh-num">18</span>전체 검색과 공유 링크</h2>
<h3>전체 검색</h3>
<ul>
<li>왼쪽 사이드바 맨 위 검색창. 어느 화면에서든 <kbd>/</kbd> 키를 누르면 바로 검색창으로 갑니다.</li>
<li><b>2글자 이상</b> 입력하면 내가 볼 수 있는 모든 프로젝트의 작업(하위 작업 포함)을 <b>제목 · 설명 · 댓글</b>에서 찾습니다.</li>
<li>결과를 누르면 그 작업이 열립니다.</li>
</ul>
<h3>공유 링크</h3>
<ul>
<li>작업 편집 창의 <span class="pjh-ui">공유</span> 또는 우클릭 <span class="pjh-ui">작업 링크 복사</span>로 주소를 복사합니다.</li>
<li>받은 사람이 주소를 열면(로그인 전이면 로그인 후) 그 작업이 바로 열립니다. 하위 작업 링크는 하위 작업 자체가 열립니다.</li>
<li>그 프로젝트의 <b>멤버만</b> 열 수 있어 밖으로 새지 않습니다.</li>
</ul>
</section>
<!-- 19. 휴지통 -->
<section class="pjh-sec" id="trash">
<h2><span class="pjh-num">19</span>휴지통 (관리자)</h2>
<ul>
<li>지운 작업은 바로 사라지지 않고 <b>3개월 동안</b> 휴지통에 보관됩니다. 하위 작업 · 댓글 · 협업자 · 첨부 파일도 함께 보관됩니다.</li>
<li>관리자는 왼쪽 사이드바 <b>휴지통</b>에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다.</li>
<li><span class="pjh-ui">복구</span>를 누르면 원래 프로젝트 · 섹션 자리로 그대로 돌아옵니다. 복구된 줄의 <span class="pjh-ui">복구됨 · 열기</span>로 바로 열어 볼 수 있습니다.</li>
<li>3개월이 지나면 영구 삭제됩니다.</li>
</ul>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>하위 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.</div></div>
</section>
<!-- 20. 단축키와 FAQ -->
<section class="pjh-sec" id="tips">
<h2><span class="pjh-num">20</span>단축키와 자주 묻는 질문</h2>
<h3>단축키</h3>
<table class="pjh-table">
<tr><th>키</th><th>하는 일</th></tr>
<tr><td><kbd>/</kbd></td><td>전체 검색창으로 이동(입력 중이 아닐 때)</td></tr>
<tr><td><kbd>Esc</kbd></td><td>작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소</td></tr>
<tr><td><kbd>Enter</kbd></td><td>하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정</td></tr>
<tr><td><kbd>Ctrl</kbd> + 휠</td><td>타임라인 확대·축소</td></tr>
<tr><td>마우스 오른쪽 버튼</td><td>작업 · 하위 작업 · 섹션 · 프로젝트에서 바로가기 메뉴</td></tr>
</table>
<h3>자주 묻는 질문</h3>
<p><b>Q. 프로젝트가 목록에 안 보여요.</b><br>그 프로젝트의 멤버가 아니면 보이지 않습니다. 관리자에게 멤버 배정을 부탁하세요.</p>
<p><b>Q. 삭제 버튼을 눌렀는데 “삭제는 만든 사람만 할 수 있습니다”라고 나와요.</b><br>작업·섹션·프로젝트는 만든 사람만 지울 수 있습니다. 만든 사람이나 최고 관리자에게 부탁하세요.</p>
<p><b>Q. 작업을 잘못 지웠어요.</b><br>3개월 안이라면 관리자가 휴지통에서 복구할 수 있습니다.</p>
<p><b>Q. 카드 순서를 끌어도 안 바뀌어요.</b><br>필터를 쓰고 있거나 정렬이 “기본”이 아니면 순서를 바꿀 수 없습니다. 필터 바의 <span class="pjh-ui">초기화</span>를 누른 뒤 다시 해 보세요.</p>
<p><b>Q. 다른 사람이 바꾼 내용이 안 보여요.</b><br>보통 8초 안에 자동으로 반영됩니다. 오래 걸리면 새로고침(<kbd>F5</kbd>)하세요.</p>
<p><b>Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?</b><br>하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.</p>
<p><b>Q. 작업을 두 프로젝트에 같이 두고 싶어요.</b><br>작업 편집 창의 “프로젝트” 칸에서 <span class="pjh-ui">다른 프로젝트에 추가</span>를 쓰세요. (<a href="#task">8장</a>)</p>
</section>
</div>
</div>
<a class="pjh-top" href="#top" title="맨 위로" aria-label="맨 위로"><span class="material-symbols-outlined">arrow_upward</span></a>
<script>
// 목차 — 지금 읽고 있는 장을 강조한다(스크롤 위치 기준).
(function () {
var links = Array.prototype.slice.call(document.querySelectorAll(".pjh-toc a"));
var secs = links.map(function (a) { return document.querySelector(a.getAttribute("href")); });
if (!("IntersectionObserver" in window)) return;
var io = new IntersectionObserver(function (entries) {
entries.forEach(function (en) {
if (!en.isIntersecting) return;
var i = secs.indexOf(en.target);
links.forEach(function (a, k) { a.classList.toggle("is-active", k === i); });
});
}, { rootMargin: "-10% 0px -75% 0px" });
secs.forEach(function (s) { if (s) io.observe(s); });
})();
</script>
{% endblock %}
@@ -1,10 +1,12 @@
{% extends "erp_base.html" %} {% extends "erp_base.html" %}
{% block head_extra %} {% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260923b" /> <link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" /> <link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %} {% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %} {% block content %}
{# 내 업무/프로젝트 화면과 같은 2단 레이아웃 — 좌측은 공용 사이드바, {# 내 업무/프로젝트 화면과 같은 2단 레이아웃 — 좌측은 공용 사이드바,
내용은 오른쪽 프레임 안에서만 스크롤한다. #} 내용은 오른쪽 프레임 안에서만 스크롤한다. #}
@@ -23,16 +25,16 @@
<div class="pj-view pj-inbox-pane"> <div class="pj-view pj-inbox-pane">
<!-- 아사나 Inbox 처럼 "나를 태그(@)한 업무"를 맨 위에 리스트로 보여준다. <!-- 아사나 Inbox 처럼 "나를 태그(@)한 업무"를 맨 위에 리스트로 보여준다.
업무를 누르면 그 프로젝트 화면이 열리면서 업무 편집 팝업이 뜬다 "확인"을 누르면 수신함에 머문 채 오른쪽에 그 작업 창이 열린다
(?task= 파라미터 — project.js 가 처리). --> (프로젝트 화면을 ?task=&embed=1 로 iframe 에 — project.js initInboxTaskPanel). -->
<div class="pj-inbox-section"> <div class="pj-inbox-section">
<h3 class="pj-inbox-h3"> <h3 class="pj-inbox-h3">
나를 태그한 업무 나를 태그한 작업
<span class="pj-inbox-count" id="pj-mention-unread" <span class="pj-inbox-count" id="pj-mention-unread"
{% if not mention_unread %}hidden{% endif %}>{{ mention_unread }}</span> {% if not mention_unread %}hidden{% endif %}>{{ mention_unread }}</span>
</h3> </h3>
{% if not mentioned_tasks %} {% if not mentioned_tasks %}
<div class="pj-empty">태그된 업무가 없습니다.</div> <div class="pj-empty">태그된 작업이 없습니다.</div>
{% else %} {% else %}
<ul class="pj-inbox pj-mention-list" id="pj-mention-tasks"> <ul class="pj-inbox pj-mention-list" id="pj-mention-tasks">
{% for t in mentioned_tasks %} {% for t in mentioned_tasks %}
@@ -45,10 +47,11 @@
<span class="pj-inbox-proj" style="color: {{ t.project_color or '#4573d2' }}">● {{ t.project_name }}</span> <span class="pj-inbox-proj" style="color: {{ t.project_color or '#4573d2' }}">● {{ t.project_name }}</span>
{% if t.stage_name %} · {{ t.stage_name }}{% endif %} {% if t.stage_name %} · {{ t.stage_name }}{% endif %}
{% if t.due_label %} · 마감 {{ t.due_label }}{% endif %} {% if t.due_label %} · 마감 {{ t.due_label }}{% endif %}
{% if t.mention_actor %} · {{ t.mention_actor.split('@')[0] }}님이 태그{% endif %} {% if t.mention_actor %} · {% set nm = t.mention_actor.split('@')[0] %}{{ nm[:1]|upper }}{{ nm[1:] }}님이 태그{% endif %}
</div> </div>
</div> </div>
<a class="pj-btn pj-inbox-go" href="/project/p/{{ t.project_id }}?task={{ t.id }}">열기</a> <a class="pj-btn pj-inbox-go" href="/project/p/{{ t.project_id }}?task={{ t.id }}"
data-task-id="{{ t.id }}">확인</a>
</li> </li>
{% endfor %} {% endfor %}
</ul> </ul>
@@ -70,18 +73,23 @@
{% elif n.type == 'completed' %}task_alt {% elif n.type == 'completed' %}task_alt
{% elif n.type == 'comment' %}chat_bubble {% elif n.type == 'comment' %}chat_bubble
{% elif n.type == 'mention' %}alternate_email {% elif n.type == 'mention' %}alternate_email
{% elif n.type == 'due_soon' %}schedule
{% elif n.type == 'due_today' %}today
{% elif n.type == 'overdue' %}alarm
{% else %}notifications{% endif %} {% else %}notifications{% endif %}
</span> </span>
<div class="pj-inbox-body"> <div class="pj-inbox-body">
<div class="pj-inbox-title">{{ n.title }}</div> <div class="pj-inbox-title">{{ n.title }}</div>
{% if n.body %}<div class="pj-inbox-sub">{{ n.body }}</div>{% endif %} {% if n.body %}<div class="pj-inbox-sub">{{ n.body }}</div>{% endif %}
<div class="pj-inbox-meta"> <div class="pj-inbox-meta">
{% if n.actor_email %}{{ n.actor_email.split('@')[0] }} · {% endif %}{{ n.created_at[:16].replace('T',' ') }} {% if n.actor_email %}{% set nm = n.actor_email.split('@')[0] %}{{ nm[:1]|upper }}{{ nm[1:] }} · {% endif %}{{ n.created_at[:16].replace('T',' ') }}
</div> </div>
</div> </div>
{% if n.project_id %} {% if n.project_id %}
{# 작업 알림은 "확인" → 수신함에 머문 채 오른쪽에 작업 창(project.js initInboxTaskPanel) #}
<a class="pj-btn pj-inbox-go" <a class="pj-btn pj-inbox-go"
href="/project/p/{{ n.project_id }}{% if n.task_id %}?task={{ n.task_id }}{% endif %}">이동</a> href="/project/p/{{ n.project_id }}{% if n.task_id %}?task={{ n.task_id }}{% endif %}"
{% if n.task_id %}data-task-id="{{ n.task_id }}"{% endif %}>확인</a>
{% endif %} {% endif %}
</li> </li>
{% endfor %} {% endfor %}
@@ -93,5 +101,8 @@
</div> </div>
</div> </div>
<script src="/static/project.js?v=20260923b" defer></script> {% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
{% endblock %} {% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %} {% extends "erp_base.html" %}
{% block head_extra %} {% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260923b" /> <link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" /> <link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %} {% endblock %}
@@ -12,6 +12,8 @@
</a> </a>
{% endblock %} {% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %} {% block content %}
{# 프로젝트 모듈의 첫 화면 = 내 업무. 예전 프로젝트 홈(카드 그리드)은 없앴다. #} {# 프로젝트 모듈의 첫 화면 = 내 업무. 예전 프로젝트 홈(카드 그리드)은 없앴다. #}
<div class="pj-wrap pj-mytasks-view" data-me="{{ user.email }}" <div class="pj-wrap pj-mytasks-view" data-me="{{ user.email }}"
@@ -29,44 +31,46 @@
</div> </div>
<div class="pj-title-wrap"> <div class="pj-title-wrap">
<h1 class="pj-project-title"> <h1 class="pj-project-title">
<span class="pj-project-title-pill" style="--pj-color: #7b68ee">내 업무</span> <span class="pj-project-title-pill" style="--pj-color: #7b68ee">내 작업</span>
</h1> </h1>
</div> </div>
<div class="pj-mytasks-summary" id="pj-mytasks-summary"></div> <div class="pj-mytasks-summary" id="pj-mytasks-summary"></div>
</div> </div>
<!-- 검색·필터 — 정렬은 표 머리글 클릭(마감·우선순위 등). -->
<div class="pj-filterbar" id="pj-mt-filterbar">
<label class="pj-fb-search">
<span class="material-symbols-outlined">filter_list</span>
<input type="search" id="pj-mt-q" placeholder="내 작업에서 찾기 (제목·설명·프로젝트)" autocomplete="off" />
</label>
<select id="pj-mt-due" class="pj-fb-select" title="마감일">
<option value="all">마감: 전체</option>
<option value="overdue">마감 지남</option>
<option value="today">오늘 마감</option>
<option value="week">이번 주 마감</option>
<option value="none">마감일 없음</option>
</select>
<select id="pj-mt-priority" class="pj-fb-select" title="우선순위">
<option value="all">우선순위: 전체</option>
<option value="high">높음</option>
<option value="normal">보통</option>
<option value="low">낮음</option>
</select>
</div>
<div class="pj-view pj-mytasks-pane"> <div class="pj-view pj-mytasks-pane">
<table class="pj-table pj-mytasks-table" id="pj-mytasks-table"> <table class="pj-table pj-mytasks-table" id="pj-mytasks-table">
<thead></thead> <thead></thead>
<tbody></tbody> <tbody></tbody>
</table> </table>
<div class="pj-empty" id="pj-mytasks-empty" hidden>표시할 업무가 없습니다.</div> <div class="pj-empty" id="pj-mytasks-empty" hidden>표시할 작업이 없습니다.</div>
</div> </div>
</section> </section>
</div> </div>
</div> </div>
<!-- 새 프로젝트 모달 — 좌측 프로젝트 목록의 + 버튼(프로젝트 화면과 동일 폼) --> {% include "project/_side_modals.html" %}
<div class="pj-modal" id="pj-modal-project" hidden>
<div class="pj-modal-card">
<h3>새 프로젝트</h3>
<label>이름<input type="text" id="pj-f-name" placeholder="프로젝트 이름" /></label>
<label>설명<textarea id="pj-f-desc" rows="2"></textarea></label>
<label>마감일<input type="date" id="pj-f-due" /></label>
<label>색상
<span class="pj-color-palette" id="pj-f-colors"></span>
</label>
<div class="pj-field-label">멤버
<div class="pj-member-picker" id="pj-f-members">불러오는 중…</div>
</div>
<div class="pj-modal-actions">
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-project">만들기</button>
</div>
</div>
</div>
<!-- 댓글만 보는 채팅형 팝업 — 업무 행의 말풍선 아이콘 더블클릭 --> <!-- 댓글만 보는 채팅형 팝업 — 작업 행의 말풍선 아이콘 한 번 클릭 -->
<div class="pj-modal" id="pj-modal-comments" hidden> <div class="pj-modal" id="pj-modal-comments" hidden>
<div class="pj-modal-card pj-modal-chat"> <div class="pj-modal-card pj-modal-chat">
<div class="pj-chat-head"> <div class="pj-chat-head">
@@ -80,15 +84,14 @@
<span class="material-symbols-outlined">attach_file</span> <span class="material-symbols-outlined">attach_file</span>
<input type="file" id="pj-cm-file-input" multiple hidden /> <input type="file" id="pj-cm-file-input" multiple hidden />
</label> </label>
<input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" /> <input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" autocomplete="off" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button> <button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button>
</div> </div>
</div> </div>
</div> </div>
<script> {% include "project/_member_tasks_modal.html" %}
window.PJ_COLORS = {{ color_palette | tojson }};
</script>
<script id="pj-mytasks-data" type="application/json"> <script id="pj-mytasks-data" type="application/json">
{ {
"tasks": {{ my_tasks | tojson }}, "tasks": {{ my_tasks | tojson }},
@@ -97,5 +100,5 @@
"today": {{ today | tojson }} "today": {{ today | tojson }}
} }
</script> </script>
<script src="/static/project.js?v=20260923b" defer></script> <script src="/static/project.js?v=20260930g" defer></script>
{% endblock %} {% endblock %}
+177 -144
View File
@@ -1,23 +1,28 @@
{% extends "erp_base.html" %} {% extends "erp_base.html" %}
{% block head_extra %} {% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260923b" /> <link rel="stylesheet" href="/static/project.css?v=20260930g" />
<!-- 구글 머티리얼 심볼(담당자 아이콘 등) — self-host --> <!-- 구글 머티리얼 심볼(담당자 아이콘 등) — self-host -->
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" /> <link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<!-- 타임라인 vis-timeline — self-host --> <!-- 타임라인 vis-timeline — self-host -->
<link href="/static/vendor/vis-timeline/vis-timeline-graph2d.min.css" rel="stylesheet" /> <link href="/static/vendor/vis-timeline/vis-timeline-graph2d.min.css" rel="stylesheet" />
<!-- ?embed=1 — 수신함 오른쪽 패널(iframe) 안에서 작업 창만 보이는 모드. 첫 페인트 전에 표시. -->
<script>
if (new URLSearchParams(location.search).get("embed") === "1" && window.parent !== window) {
document.documentElement.classList.add("pj-embed");
}
</script>
{% endblock %} {% endblock %}
{% block topbar_actions %} {% block topbar_actions %}
<a class="pj-bell" href="/project/inbox" title="알림센터"> <a class="pj-bell" href="/project/inbox" title="수신함">
<span class="material-symbols-outlined">notifications</span> <span class="material-symbols-outlined">notifications</span>
<span class="pj-bell-badge" id="pj-bell-badge" hidden>0</span> <span class="pj-bell-badge" id="pj-bell-badge" hidden>0</span>
</a> </a>
{% if can_manage %}
<button type="button" class="pj-btn pj-btn-primary" id="pj-new-task">+ 업무 추가</button>
{% endif %}
{% endblock %} {% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %} {% block content %}
<div class="pj-wrap pj-project-view" <div class="pj-wrap pj-project-view"
data-project-id="{{ project.id }}" data-project-id="{{ project.id }}"
@@ -32,28 +37,27 @@
<!-- ── 우측: 뷰 ── --> <!-- ── 우측: 뷰 ── -->
<section class="pj-main"> <section class="pj-main">
<!-- 머리 — 아사나처럼 왼쪽 위에 두 줄: ① 프로젝트 아이콘·제목 + 멤버 아이콘,
② 뷰 탭(보드/목록/캘린더/타임라인/대시보드). 오른쪽엔 스코프 토글. -->
<div class="pj-toolbar"> <div class="pj-toolbar">
<div class="pj-view-tabs" id="pj-view-tabs"> <div class="pj-head-left">
<button type="button" class="pj-tab is-active" data-view="board">보드</button>
<button type="button" class="pj-tab" data-view="list">리스트</button>
<button type="button" class="pj-tab" data-view="calendar">달력</button>
<button type="button" class="pj-tab" data-view="timeline">타임라인</button>
<button type="button" class="pj-tab" data-view="dashboard">대시보드</button>
</div>
<!-- 프로젝트 제목 + 이 프로젝트의 멤버 아이콘. <!-- 프로젝트 제목 + 이 프로젝트의 멤버 아이콘.
예전엔 좌측 사이드바에 이름 목록으로 있던 것을 아사나처럼 제목 마우스를 올리면 이름(data-tip → initHoverTips), 클릭하면 그 사람이
옆 겹친 아바타로 옮겼다. 마우스를 올리면 이름(data-tip → 이 프로젝트에서 맡은 업무 팝업, 우클릭(관리자)하면 제외. 목록은
initHoverTips), 클릭하면 그 사람이 이 프로젝트에서 맡은 업무 renderMemberList 가 같은 마크업으로 다시 그린다.
팝업, 우클릭(관리자)하면 제외. 목록은 renderMemberList 가 "전체 프로젝트" 스코프에선 제목이 "전체 프로젝트"로 바뀌고 멤버는 숨긴다
같은 마크업으로 다시 그린다. --> (.pj-title-wrap.is-all-scope). -->
<div class="pj-title-wrap"> <div class="pj-title-wrap" id="pj-title-wrap">
<h1 class="pj-project-title"> <h1 class="pj-project-title">
<span class="pj-project-title-pill" style="--pj-color: {{ project.color or '#4573d2' }}">{{ project.name }}</span> <span class="pj-project-title-pill" style="--pj-color: {{ project.color or '#4573d2' }}"><span class="material-symbols-outlined pj-pill-ic">{{ project.icon or 'folder' }}</span><span class="pj-pill-name">{{ project.name }}</span></span>
</h1>
<h1 class="pj-project-title pj-all-title">
<span class="pj-project-title-all"><span class="material-symbols-outlined pj-pill-ic">apps</span><span class="pj-pill-name">전체 프로젝트</span></span>
</h1> </h1>
<div class="pj-title-members" id="pj-member-list"> <div class="pj-title-members" id="pj-member-list">
{% for m in members %} {% for m in members %}
<span class="pj-tmember" data-email="{{ m.user_email }}" <span class="pj-tmember" data-email="{{ m.user_email }}"
data-tip="{{ m.user_email.split('@')[0] }}{% if m.role == 'manager' %} (관리){% endif %}"> data-tip="{{ m.user_email.split('@')[0][:1]|upper }}{{ m.user_email.split('@')[0][1:] }}{% if m.role == 'manager' %} (관리){% endif %}">
{% if avatars.get(m.user_email | lower) %} {% if avatars.get(m.user_email | lower) %}
<img class="pj-avatar pj-tmember-av" src="{{ avatars[m.user_email | lower] }}" alt="" referrerpolicy="no-referrer" /> <img class="pj-avatar pj-tmember-av" src="{{ avatars[m.user_email | lower] }}" alt="" referrerpolicy="no-referrer" />
{% else %} {% else %}
@@ -66,6 +70,14 @@
<button type="button" class="pj-title-addmember" id="pj-add-member" title="멤버 배정">+</button> <button type="button" class="pj-title-addmember" id="pj-add-member" title="멤버 배정">+</button>
{% endif %} {% endif %}
</div> </div>
<div class="pj-view-tabs pj-view-tabs-line" id="pj-view-tabs">
<button type="button" class="pj-tab is-active" data-view="board">보드</button>
<button type="button" class="pj-tab" data-view="list">목록</button>
<button type="button" class="pj-tab" data-view="calendar">캘린더</button>
<button type="button" class="pj-tab" data-view="timeline">타임라인</button>
<button type="button" class="pj-tab" data-view="dashboard">대시보드</button>
</div>
</div>
<!-- 아사나처럼 기본은 "이 프로젝트"만 보여준다. 전체 프로젝트 보기는 <!-- 아사나처럼 기본은 "이 프로젝트"만 보여준다. 전체 프로젝트 보기는
예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여주는 모드. --> 예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여주는 모드. -->
<div class="pj-view-tabs" id="pj-scope-toggle"> <div class="pj-view-tabs" id="pj-scope-toggle">
@@ -74,6 +86,49 @@
</div> </div>
</div> </div>
<!-- 필터 바 — 보드·리스트·달력·타임라인·대시보드 모두에 적용(이미 받은 업무를
화면에서 거른다). 설정은 프로젝트별로 이 브라우저에 기억한다.
정렬은 보드 카드 순서와 리스트 기본 순서(열 제목 클릭 정렬이 우선). -->
<div class="pj-filterbar" id="pj-filterbar">
<label class="pj-fb-search">
<span class="material-symbols-outlined">filter_list</span>
<input type="search" id="pj-fb-q" placeholder="이 화면에서 찾기 (제목·설명·담당자)" autocomplete="off" />
</label>
<select id="pj-fb-status" class="pj-fb-select" title="완료 상태">
<option value="all">상태: 전체</option>
<option value="open">미완료</option>
<option value="done">완료</option>
</select>
<select id="pj-fb-assignee" class="pj-fb-select" title="담당자">
<option value="all">담당자: 전체</option>
<option value="me">나</option>
<option value="none">담당자 없음</option>
</select>
<select id="pj-fb-due" class="pj-fb-select" title="마감일">
<option value="all">마감: 전체</option>
<option value="overdue">마감 지남</option>
<option value="today">오늘 마감</option>
<option value="week">이번 주 마감</option>
<option value="none">마감일 없음</option>
</select>
<select id="pj-fb-priority" class="pj-fb-select" title="우선순위">
<option value="all">우선순위: 전체</option>
<option value="high">높음</option>
<option value="normal">보통</option>
<option value="low">낮음</option>
</select>
<select id="pj-fb-sort" class="pj-fb-select" title="정렬">
<option value="manual">정렬: 기본</option>
<option value="due">마감일순</option>
<option value="priority">우선순위순</option>
<option value="title">제목순</option>
<option value="assignee">담당자순</option>
<option value="created">최근 생성순</option>
</select>
<span class="pj-fb-count" id="pj-fb-count" hidden></span>
<button type="button" class="pj-fb-reset" id="pj-fb-reset" hidden>초기화</button>
</div>
<!-- 달력 (휴가 모듈과 동일한 월간 그리드) --> <!-- 달력 (휴가 모듈과 동일한 월간 그리드) -->
<div class="pj-view" data-view="calendar" hidden> <div class="pj-view" data-view="calendar" hidden>
<div class="pj-cal-head"> <div class="pj-cal-head">
@@ -116,18 +171,16 @@
</div> </div>
<div id="pj-timeline"></div> <div id="pj-timeline"></div>
</div> </div>
<!-- 보드(칸반=세션) — 아사나처럼 프로젝트에 들어오면 기본으로 보이는 화면. <!-- 보드(칸반=섹션) — 아사나처럼 프로젝트에 들어오면 기본으로 보이는 화면.
최대 4열 매이슨리로 배치하고, 세션이 늘어나면 pj-board 안에서만 섹션은 가로로 늘어나고 넘치면 pj-board 안에서만 가로 스크롤된다.
세로 스크롤된다(좌측 프로젝트 목록·우측 내 업무와 스크롤이 서로 "+ 섹션 추가"는 마지막 섹션 오른쪽에 붙는다. -->
안 얽히게 각자 독립). "+ 세션 추가" 버튼은 스크롤 영역 밖(고정
위치)에 있어 항상 보인다. -->
<div class="pj-view" data-view="board"> <div class="pj-view" data-view="board">
<div class="pj-board-toolbar">
<button type="button" class="pj-add-stage" id="pj-board-addstage" hidden>+ 세션 추가</button>
</div>
<div class="pj-board" id="pj-board"> <div class="pj-board" id="pj-board">
<div class="pj-board-canvas" id="pj-board-canvas"></div> <div class="pj-board-canvas" id="pj-board-canvas"></div>
</div> </div>
<!-- "+ 섹션 추가" — 아사나처럼 마지막 섹션 바로 오른쪽. renderBoard 가
매번 캔버스 맨 끝으로 옮겨 붙인다(여기 둔 건 첫 로드용 보관 자리). -->
<button type="button" class="pj-add-stage pj-board-addstage" id="pj-board-addstage" hidden>+ 섹션 추가</button>
<!-- 가로 스크롤 막대 — 네이티브 막대는 CSS 로 숨겨두므로(자동숨김 <!-- 가로 스크롤 막대 — 네이티브 막대는 CSS 로 숨겨두므로(자동숨김
환경 대응) 보드 바깥에 직접 그린다. JS(attachHScrollIndicator)가 환경 대응) 보드 바깥에 직접 그린다. JS(attachHScrollIndicator)가
pj-board 의 scrollLeft 와 동기화한다. --> pj-board 의 scrollLeft 와 동기화한다. -->
@@ -137,7 +190,7 @@
<div class="pj-view" data-view="list" hidden> <div class="pj-view" data-view="list" hidden>
<table class="pj-table" id="pj-list"> <table class="pj-table" id="pj-list">
<thead> <thead>
<tr><th>업무</th><th>담당자</th><th>세션</th><th>우선순위</th><th>시작</th><th>마감</th></tr> <tr><th>작업</th><th>담당자</th><th>섹션</th><th>우선순위</th><th>시작</th><th>마감</th></tr>
</thead> </thead>
<tbody></tbody> <tbody></tbody>
</table> </table>
@@ -152,61 +205,21 @@
</div> </div>
</div> </div>
<!-- 새 프로젝트 모달 — 좌측 프로젝트 목록의 + 버튼(홈 화면과 동일 폼) --> {% include "project/_side_modals.html" %}
<div class="pj-modal" id="pj-modal-project" hidden>
<div class="pj-modal-card">
<h3>새 프로젝트</h3>
<label>이름<input type="text" id="pj-f-name" placeholder="프로젝트 이름" /></label>
<label>설명<textarea id="pj-f-desc" rows="2"></textarea></label>
<label>마감일<input type="date" id="pj-f-due" /></label>
<label>색상
<span class="pj-color-palette" id="pj-f-colors"></span>
</label>
<div class="pj-field-label">멤버
<div class="pj-member-picker" id="pj-f-members">불러오는 중…</div>
</div>
<div class="pj-modal-actions">
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-project">만들기</button>
</div>
</div>
</div>
<!-- 프로젝트 수정 모달 — 좌측 프로젝트 목록의 ✎ 버튼 -->
<div class="pj-modal" id="pj-modal-edit" hidden>
<div class="pj-modal-card">
<h3>프로젝트 수정</h3>
<input type="hidden" id="pj-e-id" />
<label>이름<input type="text" id="pj-e-name" placeholder="프로젝트 이름" /></label>
<label>설명<textarea id="pj-e-desc" rows="2"></textarea></label>
<div class="pj-form-row">
<label>시작일<input type="date" id="pj-e-start" /></label>
<label>마감일<input type="date" id="pj-e-due" /></label>
</div>
<label>색상
<span class="pj-color-palette" id="pj-e-colors"></span>
</label>
<label class="pj-time-toggle">
<input type="checkbox" id="pj-e-done" /> 프로젝트 완료 (목록 끝으로 이동·비활성)
</label>
<div class="pj-modal-actions">
<button type="button" class="pj-btn pj-btn-danger" id="pj-delete-project">삭제</button>
<span style="flex:1"></span>
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-edit">저장</button>
</div>
</div>
</div>
<!-- 세션 추가/편집 모달 — 보드의 "+ 세션 추가" 버튼과 세션 헤더의 ✎(세션 편집) 공용 --> <!-- 세션 추가/편집 모달 — 보드의 "+ 세션 추가" 버튼과 세션 헤더의 ✎(세션 편집) 공용 -->
<div class="pj-modal" id="pj-modal-stage" hidden> <div class="pj-modal" id="pj-modal-stage" hidden>
<div class="pj-modal-card"> <div class="pj-modal-card">
<h3 id="pj-stage-modal-title">새 세션</h3> <h3 id="pj-stage-modal-title">새 섹션</h3>
<input type="hidden" id="pj-stg-id" /> <input type="hidden" id="pj-stg-id" />
<label>이름<input type="text" id="pj-stg-name" placeholder="세션 이름" /></label> <label>이름<input type="text" id="pj-stg-name" placeholder="섹션 이름" autocomplete="off" /></label>
<label>색상 <label>색상
<span class="pj-color-palette" id="pj-stg-colors"></span> <span class="pj-color-palette" id="pj-stg-colors"></span>
</label> </label>
<div class="pj-field-label">기본 담당자
<div class="pj-member-picker" id="pj-stg-assignee"></div>
<span class="pj-modal-hint pj-stg-assignee-hint">이 섹션에 작업을 새로 만들거나 카드를 옮겨오면, 담당자가 비어 있는 작업만 이 사람에게 자동 배정됩니다.</span>
</div>
<div class="pj-modal-actions"> <div class="pj-modal-actions">
<span style="flex:1"></span> <span style="flex:1"></span>
<button type="button" class="pj-btn" data-close>취소</button> <button type="button" class="pj-btn" data-close>취소</button>
@@ -226,14 +239,18 @@
<div class="pj-modal-actions pj-modal-actions-top"> <div class="pj-modal-actions pj-modal-actions-top">
<!-- 공유 — 이 업무의 퍼머링크(/project/t/{id})를 클립보드에 복사. <!-- 공유 — 이 업무의 퍼머링크(/project/t/{id})를 클립보드에 복사.
받은 사람이 열면 로그인 후 이 업무 팝업이 바로 뜬다(멤버만). --> 받은 사람이 열면 로그인 후 이 업무 팝업이 바로 뜬다(멤버만). -->
<button type="button" class="pj-btn pj-btn-share" id="pj-share-task" hidden title="이 업무 링크 복사"> <button type="button" class="pj-btn pj-btn-share" id="pj-share-task" hidden title="이 작업 링크 복사">
<span class="material-symbols-outlined">link</span> 공유 <span class="material-symbols-outlined">link</span> 공유
</button> </button>
<button type="button" class="pj-btn pj-btn-complete" id="pj-toggle-complete" hidden>✓ 완료로 표시</button> <button type="button" class="pj-btn pj-btn-complete" id="pj-toggle-complete" hidden>✓ 완료로 표시</button>
<button type="button" class="pj-btn pj-btn-danger" id="pj-delete-task" hidden>삭제</button> <button type="button" class="pj-btn pj-btn-danger" id="pj-delete-task" hidden>삭제</button>
<!-- 수신함 오른쪽 패널(?embed=1)에서만 보인다 — 이 작업이 있는 프로젝트 화면으로 이동. -->
<button type="button" class="pj-btn pj-btn-goto-project" id="pj-goto-project" title="이 작업이 있는 프로젝트 화면으로 이동">
<span class="material-symbols-outlined">open_in_new</span> 프로젝트로 이동
</button>
<span style="flex:1"></span> <span style="flex:1"></span>
<button type="button" class="pj-btn" data-close>취소</button> <!-- 저장 버튼 없음 — 칸마다 바로 저장된다(실시간 저장). 상태만 작게 표시. -->
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-task">저장</button> <span class="pj-autosave-state" id="pj-autosave-state" aria-live="polite"></span>
<!-- 패널 접기 — 아사나처럼 오른쪽 끝의 →| 아이콘으로도 닫을 수 있다. --> <!-- 패널 접기 — 아사나처럼 오른쪽 끝의 →| 아이콘으로도 닫을 수 있다. -->
<button type="button" class="pj-icon-btn pj-panel-collapse-btn" data-close title="패널 접기"> <button type="button" class="pj-icon-btn pj-panel-collapse-btn" data-close title="패널 접기">
<span class="material-symbols-outlined">last_page</span> <span class="material-symbols-outlined">last_page</span>
@@ -242,54 +259,76 @@
<!-- 아사나처럼 큰 제목은 이 무테 입력칸 하나뿐이다(위의 작은 안내줄은 <!-- 아사나처럼 큰 제목은 이 무테 입력칸 하나뿐이다(위의 작은 안내줄은
없앴다 — 버튼 줄 바로 아래 공간을 아낀다). --> 없앴다 — 버튼 줄 바로 아래 공간을 아낀다). -->
<input type="hidden" id="pj-t-id" /> <input type="hidden" id="pj-t-id" />
<input type="text" id="pj-t-title" class="pj-t-title-input" placeholder="업무 제목" /> <!-- 하위 업무를 열었을 때만 — 아사나처럼 제목 위에 상위 업무 경로. 누르면 상위 업무로. -->
<button type="button" class="pj-t-parent" id="pj-t-parent" hidden title="상위 작업 열기">
<span class="material-symbols-outlined">subdirectory_arrow_left</span>
<span class="pj-t-parent-title" id="pj-t-parent-title"></span>
</button>
<textarea id="pj-t-title" class="pj-t-title-input" rows="1" placeholder="작업 제목"></textarea>
<!-- 다른 프로젝트에서 연결돼 온 작업을 원 소속 권한 없이 열었을 때 — 보기만 된다(서버도 변경 거절). -->
<div class="pj-readonly-note" id="pj-t-readonly" hidden>
<span class="material-symbols-outlined">visibility</span>
<span>다른 프로젝트(<b id="pj-t-readonly-home"></b>)에서 연결된 작업이라 읽기만 할 수 있습니다. 변경은 원 소속 프로젝트 멤버만 할 수 있습니다.</span>
</div>
<div class="pj-modal-body"> <div class="pj-modal-body">
<div class="pj-modal-col-main"> <div class="pj-modal-col-main">
<!-- 메타 정보 — 아사나처럼 "라벨(좌) + 아이콘/값(우)" 목록형 한 줄씩. --> <!-- 메타 정보 — 아사나처럼 "라벨(좌) + 아이콘/값(우)" 목록형 한 줄씩. -->
<div class="pj-meta-list"> <div class="pj-meta-list">
<div class="pj-meta-row2"> <!-- 담당자 · 세션 · 우선순위 · 마감일 — 한 줄에 넷을 나란히(칸 사이 세로선).
<span class="pj-meta-label2">담당자</span> 칸 안 아이콘은 빼고 라벨 글자만 둔다. 담당자 칸은 이름 길이만큼만(최대
<span class="pj-meta-value2"> 150px), 남는 폭은 세션 칸이 쓴다. 마감일은 "마감일" 라벨 + 달력 아이콘
<span class="material-symbols-outlined pj-meta-ic">account_circle</span> 버튼 — 날짜가 있으면 아이콘 옆에 "09/25(목)" 처럼 짧게. 누르면 브라우저 달력이 뜬다
(진짜 값은 숨긴 #pj-t-due 가 들고 있다). 패널이 좁으면 2×2 로 접힌다. -->
<div class="pj-meta-row2 pj-meta-row-multi">
<div class="pj-meta-cell pj-meta-cell-assignee">
<span class="pj-meta-cell-label">담당자</span>
<select id="pj-t-assignee"> <select id="pj-t-assignee">
<option value="">담당자 없음</option> <option value="">없음</option>
{% for m in members %} {% for m in members %}
<option value="{{ m.user_email }}" data-name="{{ m.user_email.split('@')[0] }}"> {% set nm = m.user_email.split('@')[0] %}
{{ m.user_email.split('@')[0] }} <option value="{{ m.user_email }}" data-name="{{ nm[:1]|upper }}{{ nm[1:] }}">
{{ nm[:1]|upper }}{{ nm[1:] }}
</option> </option>
{% endfor %} {% endfor %}
</select> </select>
</span>
</div> </div>
<div class="pj-meta-row2"> <div class="pj-meta-cell pj-meta-cell-stage">
<span class="pj-meta-label2">세션</span> <span class="pj-meta-cell-label">섹션</span>
<span class="pj-meta-value2">
<span class="material-symbols-outlined pj-meta-ic">view_column</span>
<select id="pj-t-stage"> <select id="pj-t-stage">
{% for s in stages %} {% for s in stages %}
<option value="{{ s.id }}">{{ s.name }}</option> <option value="{{ s.id }}">{{ s.name }}</option>
{% endfor %} {% endfor %}
</select> </select>
</span>
</div> </div>
<div class="pj-meta-row2"> <div class="pj-meta-cell pj-meta-cell-priority">
<span class="pj-meta-label2">우선순위</span> <span class="pj-meta-cell-label">우선순위</span>
<span class="pj-meta-value2">
<span class="material-symbols-outlined pj-meta-ic">flag</span>
<select id="pj-t-priority"> <select id="pj-t-priority">
<option value="low">낮음</option> <option value="low">낮음</option>
<option value="normal" selected>보통</option> <option value="normal" selected>보통</option>
<option value="high">높음</option> <option value="high">높음</option>
</select> </select>
</span>
</div> </div>
<div class="pj-meta-row2"> <div class="pj-meta-cell pj-meta-cell-due">
<span class="pj-meta-label2">마감일</span> <span class="pj-meta-cell-label">마감일</span>
<span class="pj-meta-value2"> <button type="button" class="pj-due-btn" id="pj-t-due-btn" title="마감일 지정">
<span class="material-symbols-outlined pj-meta-ic">event</span> <span class="material-symbols-outlined">calendar_month</span>
<input type="date" id="pj-t-due" /> <span class="pj-due-text" id="pj-t-due-text"></span>
</span> </button>
<input type="date" id="pj-t-due" class="pj-due-native" tabindex="-1" aria-label="마감일" />
</div>
</div>
<!-- 팔로워(아사나의 협업자) — 완료·댓글 알림을 받는 사람. 만든 사람·담당자·
댓글 단 사람·@태그된 사람은 자동으로 들어온다. 저장 버튼과 무관하게 즉시 반영.
기존 업무에서만, 008 마이그레이션이 있어야 보인다. -->
<!-- 협업자 — 담당자 칸과 같은 모양(라벨 + 아이콘·이름). 없으면 점선 원 "협업자 없음". -->
<div class="pj-meta-row2 pj-followers-row" id="pj-followers-row" hidden>
<div class="pj-meta-cell pj-meta-cell-followers">
<span class="pj-meta-cell-label">협업자</span>
<span class="pj-follower-chips" id="pj-follower-chips"></span>
<button type="button" class="pj-follower-add" id="pj-follower-add" title="협업자 추가">+</button>
</div>
<button type="button" class="pj-follow-toggle" id="pj-follow-toggle">협업자로 참여</button>
</div> </div>
</div> </div>
</div> </div>
@@ -300,17 +339,21 @@
<span class="pj-extra-label">설명</span> <span class="pj-extra-label">설명</span>
<span class="pj-muted-sm" id="pj-desc-hint"></span> <span class="pj-muted-sm" id="pj-desc-hint"></span>
</div> </div>
{# 서식 도구 — 모든 버튼을 같은 아이콘 글꼴(Material Symbols)·같은 크기로 그려
한 줄에 딱 맞춰 선다(예전엔 글자·이모지가 섞여 높이가 들쭉날쭉했다). #}
<div class="pj-desc-fmtbar" id="pj-desc-fmtbar"> <div class="pj-desc-fmtbar" id="pj-desc-fmtbar">
<button type="button" class="pj-desc-fmtbtn" data-cmd="bold" title="굵게 (Ctrl+B)"><b>B</b></button> <button type="button" class="pj-desc-fmtbtn" data-cmd="bold" title="굵게 (Ctrl+B)"><span class="material-symbols-outlined">format_bold</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="italic" title="기울임 (Ctrl+I)"><i>I</i></button> <button type="button" class="pj-desc-fmtbtn" data-cmd="italic" title="기울임 (Ctrl+I)"><span class="material-symbols-outlined">format_italic</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="underline" title="밑줄 (Ctrl+U)"><u>U</u></button> <button type="button" class="pj-desc-fmtbtn" data-cmd="underline" title="밑줄 (Ctrl+U)"><span class="material-symbols-outlined">format_underlined</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="strikeThrough" title="취소선 (Ctrl+Shift+X)"><span class="material-symbols-outlined">format_strikethrough</span></button>
<span class="pj-desc-fmtsep"></span> <span class="pj-desc-fmtsep"></span>
<button type="button" class="pj-desc-fmtbtn" data-cmd="insertUnorderedList" title="글머리 기호 목록">☰•</button> <button type="button" class="pj-desc-fmtbtn" data-cmd="insertUnorderedList" title="글머리 기호 목록"><span class="material-symbols-outlined">format_list_bulleted</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="insertOrderedList" title="번호 매기기 목록">☰1</button> <button type="button" class="pj-desc-fmtbtn" data-cmd="insertOrderedList" title="번호 매기기 목록"><span class="material-symbols-outlined">format_list_numbered</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="formatBlock" data-arg="blockquote" title="인용구">❝</button> <button type="button" class="pj-desc-fmtbtn" data-cmd="insertCheckbox" title="체크박스 넣기"><span class="material-symbols-outlined">check_box</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="formatBlock" data-arg="blockquote" title="인용구"><span class="material-symbols-outlined">format_quote</span></button>
<span class="pj-desc-fmtsep"></span> <span class="pj-desc-fmtsep"></span>
<button type="button" class="pj-desc-fmtbtn" data-cmd="createLink" title="링크 삽입">🔗</button> <button type="button" class="pj-desc-fmtbtn" data-cmd="createLink" title="링크 삽입"><span class="material-symbols-outlined">link</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="removeFormat" title="서식 지우기">✕서식</button> <button type="button" class="pj-desc-fmtbtn" data-cmd="removeFormat" title="서식 지우기"><span class="material-symbols-outlined">format_clear</span></button>
<span class="pj-desc-fmtsep"></span> <span class="pj-desc-fmtsep"></span>
<label class="pj-desc-fmtbtn" id="pj-desc-imgbtn" title="이미지 추가"><span class="material-symbols-outlined">image</span><input type="file" id="pj-desc-img-input" accept="image/*" hidden /></label> <label class="pj-desc-fmtbtn" id="pj-desc-imgbtn" title="이미지 추가"><span class="material-symbols-outlined">image</span><input type="file" id="pj-desc-img-input" accept="image/*" hidden /></label>
</div> </div>
@@ -323,12 +366,12 @@
기존 업무 편집 시에만. --> 기존 업무 편집 시에만. -->
<div class="pj-task-extra pj-subtask-full" id="pj-subtask-block" hidden> <div class="pj-task-extra pj-subtask-full" id="pj-subtask-block" hidden>
<div class="pj-extra-head"> <div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">checklist</span> 하위 업무 <span class="material-symbols-outlined pj-gicon pj-gicon-sm">checklist</span> 하위 작업
</div> </div>
<ul class="pj-subtask-list" id="pj-subtask-list"></ul> <ul class="pj-subtask-list" id="pj-subtask-list"></ul>
<div class="pj-subtask-form"> <div class="pj-subtask-form">
<input type="text" id="pj-subtask-input" placeholder="하위 업무 제목…" /> <input type="text" id="pj-subtask-input" placeholder="하위 작업 제목…" autocomplete="off" />
<select id="pj-subtask-add-assignee"><option value="">(미지정)</option></select> <select id="pj-subtask-add-assignee"><option value="">담당자 없음</option></select>
<input type="date" id="pj-subtask-add-due" /> <input type="date" id="pj-subtask-add-due" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-subtask-add">추가</button> <button type="button" class="pj-btn pj-btn-primary" id="pj-subtask-add">추가</button>
</div> </div>
@@ -350,30 +393,36 @@
<!-- 연결된 프로젝트 — 멀티호밍(아사나식). --> <!-- 연결된 프로젝트 — 멀티호밍(아사나식). -->
<div class="pj-task-extra" id="pj-links-block" hidden> <div class="pj-task-extra" id="pj-links-block" hidden>
<div class="pj-extra-head"> <div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">link</span> 연결된 프로젝트 <span class="material-symbols-outlined pj-gicon pj-gicon-sm">link</span> 프로젝트
</div> </div>
<div class="pj-link-chips" id="pj-link-chips"></div> <div class="pj-link-chips" id="pj-link-chips"></div>
<div class="pj-link-form" id="pj-link-form"> <div class="pj-link-form" id="pj-link-form">
<select id="pj-link-project"><option value="">프로젝트 선택…</option></select> <select id="pj-link-project"><option value="">프로젝트 선택…</option></select>
<select id="pj-link-stage"><option value="">세션 선택…</option></select> <select id="pj-link-stage"><option value="">섹션 선택…</option></select>
<button type="button" class="pj-btn pj-btn-primary" id="pj-link-save">추가</button> <button type="button" class="pj-btn pj-btn-primary" id="pj-link-save">다른 프로젝트에 추가</button>
</div> </div>
</div> </div>
</div> </div>
<!-- 댓글(활동) — 팝업 너비 전체를 쓰는 맨 아래 줄. 길어지면 자체 <!-- 댓글(활동) — 팝업 너비 전체를 쓰는 맨 아래 줄. 길어지면 자체
스크롤 없이 팝업 전체(.pj-modal-body)와 함께 늘어난다. 스크롤 없이 팝업 전체(.pj-modal-body)와 함께 늘어난다.
입력칸은 여기 없고 아래 #pj-comment-dock(창 하단 고정)에 있다.
기존 업무 편집 시에만. --> 기존 업무 편집 시에만. -->
<div class="pj-task-extra pj-comment-full" id="pj-comment-block" hidden> <div class="pj-task-extra pj-comment-full" id="pj-comment-block" hidden>
<div class="pj-extra-head"> <div class="pj-extra-head">
<span class="pj-cmt-emoji">💬</span> 댓글 <span class="pj-cmt-emoji">💬</span> 댓글
</div> </div>
<ul class="pj-comment-list" id="pj-comment-list"></ul> <ul class="pj-comment-list" id="pj-comment-list"></ul>
<div class="pj-comment-form">
<input type="text" id="pj-comment-input" placeholder="댓글 입력…" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-comment-send">등록</button>
</div> </div>
</div> </div>
<!-- 댓글 입력칸 — 아사나처럼 작업 창 맨 아래에 항상 고정. 스크롤 영역(.pj-modal-body)
바깥이라 끝까지 내려도 마지막 내용은 이 칸 바로 위에서 멈추고 가리지 않는다. -->
<div class="pj-comment-dock" id="pj-comment-dock" hidden>
<div class="pj-comment-form">
<input type="text" id="pj-comment-input" placeholder="댓글을 추가하거나 @로 멤버를 태그하세요" autocomplete="off" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-comment-send">등록</button>
</div>
</div> </div>
</div> </div>
@@ -391,7 +440,7 @@
<label>역할 <label>역할
<select id="pj-m-role"> <select id="pj-m-role">
<option value="member" selected>멤버</option> <option value="member" selected>멤버</option>
<option value="manager">관리(서브·업무 관리)</option> <option value="manager">관리(서브·작업 관리)</option>
</select> </select>
</label> </label>
<div class="pj-modal-actions"> <div class="pj-modal-actions">
@@ -417,33 +466,15 @@
<span class="material-symbols-outlined">attach_file</span> <span class="material-symbols-outlined">attach_file</span>
<input type="file" id="pj-cm-file-input" multiple hidden /> <input type="file" id="pj-cm-file-input" multiple hidden />
</label> </label>
<input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" /> <input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" autocomplete="off" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button> <button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button>
</div> </div>
</div> </div>
</div> </div>
<!-- 전체 멤버 아이콘 클릭 팝업 — 그 사람이 담당자인 업무를 프로젝트/세션/마감일과 함께 나열 --> {% include "project/_member_tasks_modal.html" %}
<div class="pj-modal" id="pj-modal-member-tasks" hidden>
<div class="pj-modal-card pj-mt-card">
<h3 id="pj-mt-title">업무</h3>
<p class="pj-modal-hint">더블클릭하면 업무 편집 창이 열립니다.</p>
<div class="pj-mt-head" id="pj-mt-head">
<span class="pj-mt-h" data-sort="project">프로젝트<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="stage">세션<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="title">업무<span class="pj-mt-sort-icon"></span></span>
<span class="pj-mt-h" data-sort="due">마감일<span class="pj-mt-sort-icon"></span></span>
</div>
<ul class="pj-mt-list" id="pj-mt-list"></ul>
<div class="pj-modal-actions">
<span style="flex:1"></span>
<button type="button" class="pj-btn pj-btn-primary" data-close>닫기</button>
</div>
</div>
</div>
<script> <script>
window.PJ_COLORS = {{ color_palette | tojson }};
window.PJ_STAGE_COLORS = {{ stage_color_palette | tojson }}; window.PJ_STAGE_COLORS = {{ stage_color_palette | tojson }};
</script> </script>
<!-- 데이터 --> <!-- 데이터 -->
@@ -458,10 +489,12 @@
"projects": {{ projects_meta | tojson }}, "projects": {{ projects_meta | tojson }},
"stagesByProject": {{ stages_by_project | tojson }}, "stagesByProject": {{ stages_by_project | tojson }},
"boardStages": {{ board_stage_names | tojson }}, "boardStages": {{ board_stage_names | tojson }},
"avatars": {{ avatars | tojson }} "avatars": {{ avatars | tojson }},
"holidays": {{ (holidays or {}) | tojson }},
"today": {{ today | tojson }}
} }
</script> </script>
<script src="/static/vendor/vis-timeline/vis-timeline-graph2d.min.js"></script> <script src="/static/vendor/vis-timeline/vis-timeline-graph2d.min.js"></script>
<script src="/static/project.js?v=20260923b" defer></script> <script src="/static/project.js?v=20260930g" defer></script>
{% endblock %} {% endblock %}
@@ -0,0 +1,74 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %}
{# 휴지통 — 관리자 전용. 지운 업무(하위 업무·댓글·팔로워·첨부 포함)를 3개월
보관하고, [복구] 로 원래 id 그대로 되살린다(project_db 010). #}
<div class="pj-wrap pj-inbox-view pj-trash-view">
<div class="pj-layout">
{% with current_pid = 0, side_active = "trash" %}{% include "project/_side.html" %}{% endwith %}
<section class="pj-main">
<div class="pj-section-head">
<h2>휴지통</h2>
<span class="pj-trash-note">삭제한 작업은 3개월 동안 보관된 뒤 영구 삭제됩니다. 복구는 관리자만 할 수 있습니다.</span>
</div>
<div class="pj-view pj-inbox-pane">
{% if not trash_enabled %}
<div class="pj-empty">
휴지통이 아직 준비되지 않았습니다(DB 마이그레이션 010 필요). 지금은 삭제하면 바로 영구 삭제됩니다.
</div>
{% elif not items %}
<div class="pj-empty">휴지통이 비어 있습니다.</div>
{% else %}
<table class="pj-table pj-trash-table" id="pj-trash-table">
<thead>
<tr>
<th>작업</th>
<th>프로젝트</th>
<th>포함</th>
<th>삭제한 사람</th>
<th>삭제일</th>
<th>남은 보관</th>
<th></th>
</tr>
</thead>
<tbody>
{% for it in items %}
<tr data-id="{{ it.id }}">
<td class="pj-trash-title">{{ it.title }}</td>
<td>{{ it.project_name or '-' }}</td>
<td class="pj-trash-meta">
{% if it.task_count > 1 %}하위 작업 {{ it.task_count - 1 }}{% endif %}
{% if it.comment_count %}{% if it.task_count > 1 %} · {% endif %}댓글 {{ it.comment_count }}{% endif %}
{% if it.attachment_count %} · 첨부 파일 {{ it.attachment_count }}{% endif %}
{% if it.task_count <= 1 and not it.comment_count and not it.attachment_count %}-{% endif %}
</td>
<td>{{ it.deleted_by_id or '-' }}</td>
<td>{{ it.deleted_label }}</td>
<td>{% if it.days_left is not none %}{{ it.days_left }}일{% else %}-{% endif %}</td>
<td class="pj-trash-act">
<button type="button" class="pj-btn pj-btn-primary pj-trash-restore"
data-id="{{ it.id }}" data-title="{{ it.title }}" data-count="{{ it.task_count }}">복구</button>
</td>
</tr>
{% endfor %}
</tbody>
</table>
{% endif %}
</div>
</section>
</div>
</div>
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
{% endblock %}
+19 -19
View File
@@ -225,7 +225,7 @@ def _build_calendar(
# 메인 — 월간 달력 + 선택일 휴가 리스트 # 메인 — 월간 달력 + 선택일 휴가 리스트
# ════════════════════════════════════════════════════════════ # ════════════════════════════════════════════════════════════
@router.get("/", response_class=HTMLResponse) @router.get("/", response_class=HTMLResponse)
async def index(request: Request) -> HTMLResponse: def index(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -303,7 +303,7 @@ def _form_context(request: Request, user: dict[str, Any]) -> dict[str, Any]:
@router.get("/new", response_class=HTMLResponse) @router.get("/new", response_class=HTMLResponse)
async def new_form(request: Request) -> HTMLResponse: def new_form(request: Request) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
guard = _guard(request) guard = _guard(request)
@@ -342,7 +342,7 @@ def _payload_from_form(
@router.post("/new") @router.post("/new")
async def create( def create(
request: Request, request: Request,
vacation_type: str = Form(...), vacation_type: str = Form(...),
start_date: str = Form(...), start_date: str = Form(...),
@@ -373,7 +373,7 @@ async def create(
@router.get("/pending", response_class=HTMLResponse) @router.get("/pending", response_class=HTMLResponse)
async def pending_page(request: Request) -> HTMLResponse: def pending_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -406,7 +406,7 @@ async def pending_page(request: Request) -> HTMLResponse:
@router.get("/settings", response_class=HTMLResponse) @router.get("/settings", response_class=HTMLResponse)
async def settings_page(request: Request) -> HTMLResponse: def settings_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -447,7 +447,7 @@ async def settings_page(request: Request) -> HTMLResponse:
@router.post("/settings/holidays") @router.post("/settings/holidays")
async def holiday_upsert( def holiday_upsert(
request: Request, request: Request,
holiday_date: str = Form(...), holiday_date: str = Form(...),
name: str = Form(...), name: str = Form(...),
@@ -476,7 +476,7 @@ async def holiday_upsert(
@router.post("/settings/holidays/{holiday_id:int}/delete") @router.post("/settings/holidays/{holiday_id:int}/delete")
async def holiday_delete( def holiday_delete(
request: Request, request: Request,
holiday_id: int, holiday_id: int,
year: str = Form(""), year: str = Form(""),
@@ -498,7 +498,7 @@ async def holiday_delete(
@router.post("/settings/balances") @router.post("/settings/balances")
async def balance_upsert( def balance_upsert(
request: Request, request: Request,
user_email: str = Form(...), user_email: str = Form(...),
year: int = Form(...), year: int = Form(...),
@@ -523,7 +523,7 @@ async def balance_upsert(
@router.get("/api/calendar") @router.get("/api/calendar")
async def api_calendar( def api_calendar(
request: Request, user: dict[str, Any] = Depends(_require_user) request: Request, user: dict[str, Any] = Depends(_require_user)
) -> JSONResponse: ) -> JSONResponse:
"""달력 비동기 데이터(JSON). year/month 쿼리.""" """달력 비동기 데이터(JSON). year/month 쿼리."""
@@ -544,7 +544,7 @@ async def api_calendar(
@router.get("/export.xlsx") @router.get("/export.xlsx")
async def export_xlsx( def export_xlsx(
request: Request, user: dict[str, Any] = Depends(_require_user) request: Request, user: dict[str, Any] = Depends(_require_user)
) -> StreamingResponse: ) -> StreamingResponse:
from openpyxl import Workbook # 지연 import from openpyxl import Workbook # 지연 import
@@ -610,12 +610,12 @@ async def export_xlsx(
@router.get("/health") @router.get("/health")
async def health() -> dict[str, str]: def health() -> dict[str, str]:
return {"status": "ok", "module": "vacation"} return {"status": "ok", "module": "vacation"}
@router.get("/{request_id}", response_class=HTMLResponse) @router.get("/{request_id}", response_class=HTMLResponse)
async def detail(request: Request, request_id: str) -> HTMLResponse: def detail(request: Request, request_id: str) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433 from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -657,7 +657,7 @@ async def detail(request: Request, request_id: str) -> HTMLResponse:
@router.get("/{request_id}/edit", response_class=HTMLResponse) @router.get("/{request_id}/edit", response_class=HTMLResponse)
async def edit_form(request: Request, request_id: str) -> HTMLResponse: def edit_form(request: Request, request_id: str) -> HTMLResponse:
from app.main import render_template # noqa: WPS433 from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433 from app.store import is_admin # noqa: WPS433
@@ -698,7 +698,7 @@ async def edit_form(request: Request, request_id: str) -> HTMLResponse:
@router.post("/{request_id}/edit") @router.post("/{request_id}/edit")
async def update( def update(
request: Request, request: Request,
request_id: str, request_id: str,
vacation_type: str = Form(...), vacation_type: str = Form(...),
@@ -730,7 +730,7 @@ async def update(
@router.post("/{request_id}/submit") @router.post("/{request_id}/submit")
async def submit( def submit(
request: Request, request: Request,
request_id: str, request_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -746,7 +746,7 @@ async def submit(
@router.post("/{request_id}/approve") @router.post("/{request_id}/approve")
async def approve( def approve(
request: Request, request: Request,
request_id: str, request_id: str,
user: dict[str, Any] = Depends(_require_approver), user: dict[str, Any] = Depends(_require_approver),
@@ -762,7 +762,7 @@ async def approve(
@router.post("/{request_id}/reject") @router.post("/{request_id}/reject")
async def reject( def reject(
request: Request, request: Request,
request_id: str, request_id: str,
reject_reason: str = Form(...), reject_reason: str = Form(...),
@@ -781,7 +781,7 @@ async def reject(
@router.post("/{request_id}/cancel") @router.post("/{request_id}/cancel")
async def cancel( def cancel(
request: Request, request: Request,
request_id: str, request_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
@@ -803,7 +803,7 @@ async def cancel(
@router.post("/{request_id}/delete") @router.post("/{request_id}/delete")
async def delete( def delete(
request: Request, request: Request,
request_id: str, request_id: str,
user: dict[str, Any] = Depends(_require_user), user: dict[str, Any] = Depends(_require_user),
+54 -11
View File
@@ -28,6 +28,25 @@
var DEFAULT_TYPE = "S"; var DEFAULT_TYPE = "S";
// 썸네일 <img> onerror — data-fallback(줄바꿈 구분)의 다음 후보로, 없으면 "없음".
window.cf24ThumbFallback = function (img) {
var rest = (img.getAttribute("data-fallback") || "").split("\n").filter(Boolean);
var tried = (img.getAttribute("data-tried") ? img.getAttribute("data-tried") + "\n" : "") + img.getAttribute("src");
img.setAttribute("data-tried", tried);
if (rest.length) {
img.setAttribute("data-fallback", rest.slice(1).join("\n"));
img.title = "대체 이미지\n" + rest[0];
img.src = rest[0];
return;
}
img.onerror = null;
var empty = document.createElement("div");
empty.className = "cf24-opt-thumb-empty";
empty.textContent = "없음";
empty.title = "불러오지 못한 경로:\n" + tried;
img.replaceWith(empty);
};
window.cf24SetupOptions = function (ctx) { window.cf24SetupOptions = function (ctx) {
var root = ctx.root, no = ctx.productNo, modal = ctx.modal; var root = ctx.root, no = ctx.productNo, modal = ctx.modal;
var apiJson = ctx.apiJson, esc = ctx.escHtml, setMsg = ctx.setMsg; var apiJson = ctx.apiJson, esc = ctx.escHtml, setMsg = ctx.setMsg;
@@ -38,7 +57,7 @@
var count = root.querySelector("#cf24-options-count"); var count = root.querySelector("#cf24-options-count");
if (!openBtn || !body) return; if (!openBtn || !body) return;
var state = { option: null, variants: [], displayTypes: {}, orphans: [] }; var state = { option: null, variants: [], displayTypes: {}, orphans: [], imageBase: "" };
openBtn.addEventListener("click", function () { openBtn.addEventListener("click", function () {
var nameEl = document.getElementById("cf24-name-text"); var nameEl = document.getElementById("cf24-name-text");
@@ -53,6 +72,7 @@
state.option = data.option; state.option = data.option;
state.variants = data.variants || []; state.variants = data.variants || [];
state.displayTypes = data.display_types || {}; state.displayTypes = data.display_types || {};
state.imageBase = data.image_base || "";
render(); render();
}) })
.catch(function (err) { .catch(function (err) {
@@ -139,13 +159,36 @@
return ""; return "";
} }
// 카페24가 경로는 주지만 파일이 없는 경우가 있다(깨진 그림) — 실패하면 "없음"으로 바꾼다. // 카페24 이미지 경로는 "/web/product/big/…" 처럼 **상대경로**로 오기도 한다(옵션 연결
// 이미지 등). 그대로 src 에 넣으면 우리 도메인에서 찾다가 깨진다 — 쇼핑몰 주소를 붙인다.
// hidden 값(카페24에 다시 보내는 값)은 받은 그대로 둔다.
function imageUrl(path) {
path = String(path || "").trim();
if (!path) return "";
// 카페24 품목 image 가 "https://miras.co.krhttps://cafe24img.poxo.com/…/web/product/extra/big/…"
// 처럼 쇼핑몰 도메인 뒤에 CDN 전체 주소를 한 번 더 붙여 오는 경우가 있다(실물, 추가이미지).
// 안에 주소가 또 있으면 마지막 주소부터 쓴다.
var inner = path.match(/.(https?:\/\/.*)$/i);
if (inner) path = inner[1].replace(/^.*(https?:\/\/)/i, "$1");
if (path.indexOf("//") === 0) return "https:" + path;
if (/^(https?:|data:|blob:)/i.test(path)) return path;
// "/web/product/…" 또는 앞 슬래시 없는 "web/product/…" — 쇼핑몰 주소 기준
return state.imageBase ? state.imageBase + (path.charAt(0) === "/" ? "" : "/") + path : "";
}
// 후보(버튼 이미지 → 연결 이미지 → 품목 image) 중 첫 번째를 보여주고, 깨지면 다음
// 후보로 넘어간다(cf24ThumbFallback). 전부 실패하면 "없음".
var THUMB_EMPTY = '<div class="cf24-opt-thumb-empty">없음</div>'; var THUMB_EMPTY = '<div class="cf24-opt-thumb-empty">없음</div>';
function thumbHtml(src, title) { function thumbHtml(candidates, title) {
return src var urls = [];
? '<img class="cf24-opt-thumb" src="' + esc(src) + '" alt="" title="' + esc(title || "") + (Array.isArray(candidates) ? candidates : [candidates]).forEach(function (c) {
'" onerror="this.outerHTML=\'' + THUMB_EMPTY.replace(/"/g, "&quot;") + '\'" />' var u = imageUrl(c);
: THUMB_EMPTY; if (u && urls.indexOf(u) < 0) urls.push(u);
});
if (!urls.length) return THUMB_EMPTY;
// 말풍선에 실제 경로도 보인다 — 썸네일이 이상할 때 어느 이미지인지 바로 확인용
return '<img class="cf24-opt-thumb" src="' + esc(urls[0]) + '" alt="" title="' + esc((title ? title + "\n" : "") + urls[0]) +
'" data-fallback="' + esc(urls.slice(1).join("\n")) + '" onerror="cf24ThumbFallback(this)" />';
} }
// 썸네일 파일 선택 → 업로드 → hidden 두 개(option_image_file, option_link_image)에 경로 // 썸네일 파일 선택 → 업로드 → hidden 두 개(option_image_file, option_link_image)에 경로
@@ -220,8 +263,8 @@
var v = r.value || { option_text: "", option_image_file: "", option_link_image: "", option_color: "" }; var v = r.value || { option_text: "", option_image_file: "", option_link_image: "", option_color: "" };
var variant = r.variant; var variant = r.variant;
var isNewRow = r.index == null; var isNewRow = r.index == null;
var thumbSrc = v.option_image_file || v.option_link_image || var thumbSrc = [v.option_image_file, v.option_link_image,
(state.option && state.option.has_option ? variantImageFor(state.option.options[0].option_name, v.option_text) : ""); state.option && state.option.has_option ? variantImageFor(state.option.options[0].option_name, v.option_text) : ""];
var code = variant ? variant.variant_code : ""; var code = variant ? variant.variant_code : "";
// data-index: options 응답 안 위치(옵션 PUT 짝맞춤용, 새 행은 빈 값) / data-pos: 처음 그린 순서(순서 변경 판정용) // data-index: options 응답 안 위치(옵션 PUT 짝맞춤용, 새 행은 빈 값) / data-pos: 처음 그린 순서(순서 변경 판정용)
return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '">' + return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '">' +
@@ -801,7 +844,7 @@
'<label class="cf24-side-field"><span>옵션명</span><input type="text" name="option_name" value="' + esc(o.option_name) + '" /></label>' + '<label class="cf24-side-field"><span>옵션명</span><input type="text" name="option_name" value="' + esc(o.option_name) + '" /></label>' +
'<label class="cf24-side-field cf24-side-field-type"><span>표시방식</span>' + typeSelect(o.option_display_type || DEFAULT_TYPE, "option_display_type") + "</label></div>"; '<label class="cf24-side-field cf24-side-field-type"><span>표시방식</span>' + typeSelect(o.option_display_type || DEFAULT_TYPE, "option_display_type") + "</label></div>";
o.option_value.forEach(function (v, vi) { o.option_value.forEach(function (v, vi) {
var src = v.option_image_file || v.option_link_image || variantImageFor(o.option_name, v.option_text); var src = [v.option_image_file, v.option_link_image, variantImageFor(o.option_name, v.option_text)];
html += '<div class="cf24-opt-value" data-value="' + vi + '"><span class="cf24-opt-thumb-slot">' + thumbHtml(src) + "</span>" + html += '<div class="cf24-opt-value" data-value="' + vi + '"><span class="cf24-opt-thumb-slot">' + thumbHtml(src) + "</span>" +
'<input type="text" name="option_text" value="' + esc(v.option_text) + '" placeholder="옵션값 이름" />' + '<input type="text" name="option_text" value="' + esc(v.option_text) + '" placeholder="옵션값 이름" />' +
'<input type="hidden" name="option_image_file" value="' + esc(v.option_image_file) + '" />' + '<input type="hidden" name="option_image_file" value="' + esc(v.option_image_file) + '" />' +
@@ -822,7 +865,7 @@
variants.forEach(function (v) { variants.forEach(function (v) {
var label = v.options.map(function (o) { return o.value; }).join(" / ") || v.variant_code; var label = v.options.map(function (o) { return o.value; }).join(" / ") || v.variant_code;
html += '<tr class="cf24-v-item" data-code="' + esc(v.variant_code) + '">' + html += '<tr class="cf24-v-item" data-code="' + esc(v.variant_code) + '">' +
'<td class="cf24-v-imgcol">' + (v.image ? '<img class="cf24-v-img" src="' + esc(v.image) + '" alt="" />' : '<span class="cf24-v-img cf24-v-img-empty"></span>') + "</td>" + '<td class="cf24-v-imgcol">' + (imageUrl(v.image) ? '<img class="cf24-v-img" src="' + esc(imageUrl(v.image)) + '" alt="" />' : '<span class="cf24-v-img cf24-v-img-empty"></span>') + "</td>" +
'<td class="cf24-v-name" title="' + esc(label) + '">' + esc(label) + "</td>" + '<td class="cf24-v-name" title="' + esc(label) + '">' + esc(label) + "</td>" +
'<td class="cf24-v-syscode"><button type="button" class="cf24-v-copy" data-copy-text="' + esc(v.variant_code) + '">' + esc(v.variant_code) + "</button></td>" + '<td class="cf24-v-syscode"><button type="button" class="cf24-v-copy" data-copy-text="' + esc(v.variant_code) + '">' + esc(v.variant_code) + "</button></td>" +
'<td class="cf24-v-code"><input type="text" name="custom_variant_code" maxlength="40" value="' + esc(v.custom_variant_code) + '" /></td>' + '<td class="cf24-v-code"><input type="text" name="custom_variant_code" maxlength="40" value="' + esc(v.custom_variant_code) + '" /></td>' +
+19
View File
@@ -54,6 +54,11 @@
color: var(--color-callout-red, #c22b10); color: var(--color-callout-red, #c22b10);
} }
/* 성공 알림(erpAlert(msg, { tone: "ok" })) — 초록 체크 */
.erp-dialog-icon.is-ok {
color: #0f8a3a;
}
/* 확인(질문)용은 붉은 경고색 대신 차분한 검정으로 */ /* 확인(질문)용은 붉은 경고색 대신 차분한 검정으로 */
.erp-dialog-ask .erp-dialog-icon { .erp-dialog-ask .erp-dialog-icon {
color: var(--color-rich-black, #0a0a0a); color: var(--color-rich-black, #0a0a0a);
@@ -69,6 +74,20 @@
word-break: break-word; word-break: break-word;
} }
/* erpPrompt 입력창 — 메시지 아래, 버튼 위 */
.erp-dialog-input {
display: block;
width: calc(100% - 40px);
margin: -8px 20px 20px;
padding: 8px 10px;
box-sizing: border-box;
border: 1px solid var(--color-subtle-ash, #d4d4d4);
border-radius: 8px;
font: inherit;
font-size: var(--text-body, 14px);
}
.erp-dialog-input:focus { outline: none; border-color: var(--color-rich-black, #0a0a0a); }
.erp-dialog-actions { .erp-dialog-actions {
display: flex; display: flex;
justify-content: center; justify-content: center;
+47 -8
View File
@@ -7,6 +7,11 @@
쓰는 법 (기본 창과 달리 **비동기**다 — Promise 를 돌려준다): 쓰는 법 (기본 창과 달리 **비동기**다 — Promise 를 돌려준다):
erpConfirm("지울까요?").then(function (ok) { if (ok) ... }); erpConfirm("지울까요?").then(function (ok) { if (ok) ... });
erpAlert("실패했습니다.").then(...) erpAlert("실패했습니다.").then(...)
erpPrompt("주소를 입력하세요", "https://").then(function (v) { if (v) ... }); // 취소면 null
erpAlert("저장했습니다.", { tone: "ok" }) // 성공 알림 — 경고 삼각형 대신 초록 체크
창 제목은 기본 "No.1 King ERP 프로그램". 화면마다 바꾸려면 그 화면 스크립트에서
window.ERP_DIALOG_TITLE = "..." 를 두거나, 한 번만 options.title 로 넘긴다.
HTML 만으로 쓰려면 form 에 data-erp-confirm 을 달면 된다. 제출을 가로채 HTML 만으로 쓰려면 form 에 data-erp-confirm 을 달면 된다. 제출을 가로채
확인을 받은 뒤 통과시킨다(가로챈 제출은 form.submit() 으로 다시 보내므로 확인을 받은 뒤 통과시킨다(가로챈 제출은 form.submit() 으로 다시 보내므로
@@ -27,7 +32,20 @@
'<circle cx="12" cy="17.1" r="1.05" fill="currentColor"/>' + '<circle cx="12" cy="17.1" r="1.05" fill="currentColor"/>' +
"</svg>"; "</svg>";
// 성공(tone: "ok") — 원 안의 체크.
var ICON_OK =
'<svg width="32" height="32" viewBox="0 0 24 24" fill="none" aria-hidden="true">' +
'<circle cx="12" cy="12" r="9.2" stroke="currentColor" stroke-width="1.6"/>' +
'<path d="m7.6 12.3 3 3 5.8-6.2" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"' +
' stroke-linejoin="round"/>' +
"</svg>";
function titleOf(options) {
return options.title || window.ERP_DIALOG_TITLE || TITLE;
}
function build(message, options) { function build(message, options) {
var TITLE_TEXT = titleOf(options);
var backdrop = document.createElement("div"); var backdrop = document.createElement("div");
backdrop.className = "erp-dialog-backdrop"; backdrop.className = "erp-dialog-backdrop";
@@ -35,18 +53,18 @@
box.className = "erp-dialog" + (options.ask ? " erp-dialog-ask" : ""); box.className = "erp-dialog" + (options.ask ? " erp-dialog-ask" : "");
box.setAttribute("role", "alertdialog"); box.setAttribute("role", "alertdialog");
box.setAttribute("aria-modal", "true"); box.setAttribute("aria-modal", "true");
box.setAttribute("aria-label", TITLE); box.setAttribute("aria-label", TITLE_TEXT);
var title = document.createElement("h2"); var title = document.createElement("h2");
title.className = "erp-dialog-title"; title.className = "erp-dialog-title";
title.textContent = TITLE; title.textContent = TITLE_TEXT;
var body = document.createElement("div"); var body = document.createElement("div");
body.className = "erp-dialog-body"; body.className = "erp-dialog-body";
var icon = document.createElement("span"); var icon = document.createElement("span");
icon.className = "erp-dialog-icon"; icon.className = "erp-dialog-icon" + (options.tone === "ok" ? " is-ok" : "");
icon.innerHTML = ICON; icon.innerHTML = options.tone === "ok" ? ICON_OK : ICON;
var text = document.createElement("p"); var text = document.createElement("p");
text.className = "erp-dialog-message"; text.className = "erp-dialog-message";
@@ -54,6 +72,15 @@
// HTML 로 해석되지 않게. // HTML 로 해석되지 않게.
text.textContent = String(message == null ? "" : message); text.textContent = String(message == null ? "" : message);
// 입력창(erpPrompt) — 메시지 아래 한 줄.
var input = null;
if (options.prompt) {
input = document.createElement("input");
input.type = "text";
input.className = "erp-dialog-input";
input.value = options.defaultValue == null ? "" : String(options.defaultValue);
}
var actions = document.createElement("div"); var actions = document.createElement("div");
actions.className = "erp-dialog-actions"; actions.className = "erp-dialog-actions";
@@ -76,10 +103,11 @@
body.appendChild(text); body.appendChild(text);
box.appendChild(title); box.appendChild(title);
box.appendChild(body); box.appendChild(body);
if (input) box.appendChild(input);
box.appendChild(actions); box.appendChild(actions);
backdrop.appendChild(box); backdrop.appendChild(box);
return { backdrop: backdrop, box: box, ok: ok, cancel: cancel }; return { backdrop: backdrop, box: box, ok: ok, cancel: cancel, input: input };
} }
function open(message, options) { function open(message, options) {
@@ -94,7 +122,9 @@
document.removeEventListener("keydown", onKey, true); document.removeEventListener("keydown", onKey, true);
el.backdrop.remove(); el.backdrop.remove();
if (previous && typeof previous.focus === "function") previous.focus(); if (previous && typeof previous.focus === "function") previous.focus();
resolve(result); // 입력창이면 확인 = 입력한 글자, 취소 = null
if (el.input) resolve(result ? el.input.value : null);
else resolve(result);
} }
function onKey(e) { function onKey(e) {
@@ -106,7 +136,7 @@
close(true); close(true);
} else if (e.key === "Tab") { } else if (e.key === "Tab") {
// 포커스가 창 밖으로 나가지 않게 두 버튼 사이에서만 돈다. // 포커스가 창 밖으로 나가지 않게 두 버튼 사이에서만 돈다.
var focusable = el.cancel ? [el.cancel, el.ok] : [el.ok]; var focusable = (el.input ? [el.input] : []).concat(el.cancel ? [el.cancel, el.ok] : [el.ok]);
var index = focusable.indexOf(document.activeElement); var index = focusable.indexOf(document.activeElement);
e.preventDefault(); e.preventDefault();
var next = e.shiftKey ? index - 1 : index + 1; var next = e.shiftKey ? index - 1 : index + 1;
@@ -125,7 +155,8 @@
document.addEventListener("keydown", onKey, true); document.addEventListener("keydown", onKey, true);
document.body.appendChild(el.backdrop); document.body.appendChild(el.backdrop);
el.ok.focus(); if (el.input) { el.input.focus(); el.input.select(); }
else el.ok.focus();
}); });
} }
@@ -141,6 +172,14 @@
return open(message, opts).then(function () { return undefined; }); return open(message, opts).then(function () { return undefined; });
}; };
window.erpPrompt = function (message, defaultValue, options) {
var opts = options || {};
opts.ask = true;
opts.prompt = true;
opts.defaultValue = defaultValue;
return open(message, opts);
};
// data-erp-confirm 이 달린 폼은 제출 전에 확인을 받는다. // data-erp-confirm 이 달린 폼은 제출 전에 확인을 받는다.
document.addEventListener("submit", function (e) { document.addEventListener("submit", function (e) {
var form = e.target; var form = e.target;
+267
View File
@@ -0,0 +1,267 @@
/* ════════════════════════════════════════════════════
실적(쇼핑몰 통합 매출) — 정보 밀도 높은 관리자 대시보드.
기존 ERP 토큰(erp.css :root) 위에서만 쓴다. 색은 증감·상태·주말에만.
════════════════════════════════════════════════════ */
/* 색 변수 — 창(.perf-modal)은 document.body 에 붙어 .perf 밖이라 같이 정의한다 */
.perf, .perf-modal {
--perf-line: var(--color-subtle-ash);
--perf-soft: #fafafa;
--perf-up: #0f8a3a;
--perf-down: var(--color-callout-red);
--perf-sat: #1d4ed8;
--perf-sun: var(--color-callout-red);
}
.perf {
display: flex; flex-direction: column; gap: 12px;
font-variant-numeric: tabular-nums;
}
/* 공통 .erp-page 는 width:100% + padding 이라 부모보다 48px 넓어져 오른쪽이 잘린다.
전역 규칙은 다른 모듈에 영향이 있어, 실적 화면이 들어 있을 때만 border-box 로 맞춘다. */
.erp-page:has(> .perf) { box-sizing: border-box; }
.perf, .perf > * { min-width: 0; }
.perf-muted { color: var(--color-midtone-gray); font-size: 12px; }
.perf-nowrap { white-space: nowrap; }
.perf-center { text-align: center; }
/* 탭 */
.perf-tabs { display: flex; gap: 4px; border-bottom: 1px solid var(--perf-line); }
.perf-tab {
padding: 8px 14px; font-size: 13px; font-weight: 500; color: var(--color-midtone-gray);
border-bottom: 2px solid transparent; margin-bottom: -1px;
}
.perf-tab:hover { color: var(--color-rich-black); }
.perf-tab.is-active { color: var(--color-rich-black); border-bottom-color: var(--color-rich-black); }
/* 도구 막대 */
.perf-toolbar { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; }
.perf-quick, .perf-metric { display: inline-flex; border: 1px solid var(--perf-line); border-radius: 10px; padding: 2px; background: #fff; }
.perf-seg {
border: 0; background: transparent; font: inherit; font-size: 12px; font-weight: 500;
padding: 5px 11px; border-radius: 8px; cursor: pointer; color: var(--color-rich-black); white-space: nowrap;
}
.perf-seg:hover { background: var(--color-ghost-gray); }
.perf-seg.is-active { background: var(--color-deep-black); color: #fff; }
a.perf-seg.is-active, a.perf-seg.is-active:link, a.perf-seg.is-active:visited { color: #fff; }
.perf-nav { display: inline-flex; align-items: center; gap: 6px; }
.perf-nav-btn {
font-size: 12px; padding: 5px 9px; border: 1px solid var(--perf-line); border-radius: 8px; background: #fff;
white-space: nowrap;
}
.perf-nav-btn:hover { background: var(--color-ghost-gray); }
.perf-nav-label { font-weight: 600; font-size: 14px; min-width: 200px; text-align: center; }
.perf-custom { display: inline-flex; align-items: center; gap: 6px; }
.perf-custom[hidden] { display: none; }
/* 공통 .erp-input 의 min-width:240px 를 날짜칸에서만 푼다 */
.perf .erp-input.perf-date { width: 150px; min-width: 0; flex: 0 0 auto; padding: 5px 8px !important; font-size: 12px !important; }
.perf-modal .erp-input.perf-date { width: 150px; min-width: 0; }
.perf-filter { position: relative; }
.perf-filter > summary { list-style: none; cursor: pointer; }
.perf-filter > summary::-webkit-details-marker { display: none; }
.perf-filter-pop {
position: absolute; z-index: 20; top: calc(100% + 6px); left: 0; min-width: 220px;
background: #fff; border: 1px solid var(--perf-line); border-radius: 12px; padding: 10px;
box-shadow: 0 8px 24px rgba(0, 0, 0, .1); display: flex; flex-direction: column; gap: 4px;
}
.perf-check { display: flex; align-items: center; gap: 6px; font-size: 13px; padding: 3px 2px; cursor: pointer; }
.perf-filter-act { display: flex; justify-content: space-between; margin-top: 6px; }
.perf-update { margin-left: auto; display: inline-flex; align-items: center; gap: 10px; }
.perf-update b { color: var(--color-rich-black); font-weight: 600; }
/* 알림 */
.perf-notice {
font-size: 12.5px; padding: 8px 12px; border-radius: 10px; background: var(--perf-soft);
border: 1px solid var(--perf-line); display: flex; flex-wrap: wrap; gap: 6px 10px; align-items: center;
}
.perf-notice[hidden] { display: none; }
.perf-notice.is-warn { background: #fff7f5; border-color: #f3d2ca; }
.perf-notice.is-ok { background: #f3fbf5; border-color: #cdeccf; }
.perf-problem { padding: 1px 8px; border-radius: 999px; background: #fbe9e6; color: var(--perf-down); font-weight: 500; }
/* KPI */
.perf-kpis { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: 10px; }
.perf-kpi { border: 1px solid var(--perf-line); border-radius: 12px; padding: 12px 14px; background: #fff; min-width: 0; }
.perf-kpi.is-primary { border-color: #cfcfcf; box-shadow: inset 3px 0 0 var(--color-deep-black); }
.perf-kpi-label { font-size: 12px; color: var(--color-midtone-gray); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.perf-kpi-value { font-size: 22px; font-weight: 600; letter-spacing: -.5px; margin: 2px 0; white-space: nowrap; }
.perf-kpi.is-primary .perf-kpi-value { font-size: 24px; }
.perf-kpi-delta { font-size: 12px; display: flex; gap: 6px; align-items: baseline; flex-wrap: wrap; }
.perf-delta { font-weight: 600; }
.perf-delta.is-up { color: var(--perf-up); }
.perf-delta.is-down { color: var(--perf-down); }
.perf-delta.is-flat { color: var(--color-midtone-gray); }
/* 카드 */
.perf-card { padding: 12px 14px; }
.perf-card-head { display: flex; align-items: center; justify-content: space-between; gap: 10px; margin-bottom: 8px; flex-wrap: wrap; }
.perf-h { margin: 0; font-size: 14px; font-weight: 600; }
.perf-grid2 { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; }
.perf-grid2 > .perf-card-wide { grid-column: 1 / -1; } /* 표가 넓은 카드(매출 대조)는 한 줄 전체 */
.perf-foot { margin: 8px 0 0; line-height: 1.5; }
/* 표 */
.perf-table-wrap { overflow-x: auto; }
.perf-table { width: 100%; border-collapse: collapse; font-size: 12.5px; }
.perf-table th, .perf-table td { padding: 6px 8px; border-bottom: 1px solid #efefef; white-space: nowrap; }
.perf-table thead th {
font-size: 12px; font-weight: 500; color: var(--color-midtone-gray); text-align: right;
background: var(--perf-soft); border-bottom: 1px solid var(--perf-line); position: sticky; top: 0;
}
.perf-table thead th.perf-th-label { text-align: left; }
.perf-td-label { text-align: left; font-weight: 500; }
.perf-num { text-align: right; }
.perf-zero { color: #c9c9c9; }
.perf-na::before { content: ""; }
.perf-th-total, .perf-td-total { background: #f6f6f6; font-weight: 600; }
/* 날짜 열 너비 고정(210px) — 공휴일 이름이 날짜 오른쪽에 붙는다 */
.perf-main thead th.perf-th-label, .perf-main .perf-td-label { width: 210px; min-width: 210px; max-width: 210px; box-sizing: border-box; overflow: hidden; text-overflow: ellipsis; }
.perf-row-day.is-sat .perf-td-label { color: var(--perf-sat); }
.perf-row-day.is-sun .perf-td-label { color: var(--perf-sun); }
.perf-row-day.is-today .perf-td-label::after { content: "오늘"; margin-left: 6px; font-size: 10px; padding: 0 5px; border-radius: 999px; background: var(--color-deep-black); color: #fff; vertical-align: 1px; }
.perf-row-day.is-future td, .perf-row-month.is-future td, .perf-year tr.is-future td { color: #c9c9c9; }
.perf-hol { display: inline; margin-left: 6px; font-size: 11px; font-weight: 400; }
.perf-row-week th, .perf-row-week td { background: #f3f3f3; font-weight: 600; border-bottom: 1px solid var(--perf-line); }
.perf-row-week .perf-td-total { background: #e9e9e9; }
.perf-row-total th, .perf-row-total td { background: var(--color-deep-black); color: #fff; font-weight: 600; border-bottom: 0; }
.perf-row-total .perf-zero { color: #777; }
td.is-link { cursor: pointer; }
td.is-link:hover { background: #eef2ff; text-decoration: underline; }
/* 표시 기준 전환 — 한 칸에 3값, data-metric 으로 하나만 보인다 */
.perf .v { display: none; }
.perf[data-metric="gross"] .v-gross,
.perf[data-metric="commission"] .v-commission,
.perf[data-metric="net"] .v-net { display: inline; }
/* 비중 막대 */
.perf-share { position: relative; min-width: 110px; }
.perf-bar { position: absolute; left: 8px; bottom: 3px; height: 3px; width: calc((100% - 16px) * var(--w) / 100); background: #d4d4d4; border-radius: 2px; }
/* 연간 요약 */
.perf-year-sum { display: grid; grid-template-columns: repeat(3, 1fr); gap: 8px; margin-bottom: 8px; }
.perf-year-sum div { background: var(--perf-soft); border: 1px solid #efefef; border-radius: 10px; padding: 8px 10px; }
.perf-year-sum span { display: block; font-size: 11.5px; color: var(--color-midtone-gray); }
.perf-year-sum b { font-size: 16px; font-weight: 600; }
/* 그래프(SVG, performance.js 가 그림) */
.perf-chart { min-height: 220px; }
.perf-chart svg { display: block; width: 100%; height: auto; }
.perf-chart text { font-size: 10.5px; fill: var(--color-midtone-gray); font-family: var(--font-geist); }
.perf-chart .bar { fill: #1f1f1f; }
.perf-chart .bar.is-neg { fill: var(--perf-down); }
.perf-chart .bar:hover { fill: #555; }
.perf-chart .grid { stroke: #efefef; }
.perf-chart .axis { stroke: #d4d4d4; }
.perf-chart-empty { color: var(--color-midtone-gray); font-size: 12px; padding: 80px 0; text-align: center; }
/* 상세(Drill-down) 창 */
.perf-modal { position: fixed; inset: 0; z-index: 1000; background: rgba(0, 0, 0, .35); display: flex; align-items: center; justify-content: center; padding: 20px; }
.perf-modal-card { background: #fff; border-radius: 14px; width: min(1100px, 100%); max-height: 88vh; display: flex; flex-direction: column; box-shadow: 0 20px 60px rgba(0, 0, 0, .25); }
.perf-modal-card.is-narrow { width: min(560px, 100%); }
.perf-modal-head { display: flex; align-items: center; justify-content: space-between; gap: 10px; padding: 14px 16px; border-bottom: 1px solid var(--perf-line); }
.perf-modal-head h3 { margin: 0; font-size: 15px; font-weight: 600; }
.perf-modal-body { padding: 12px 16px; overflow: auto; }
.perf-modal-foot { display: flex; justify-content: flex-end; gap: 8px; padding: 12px 16px; border-top: 1px solid var(--perf-line); flex-wrap: wrap; align-items: center; }
.perf-modal-x { border: 0; background: none; font-size: 20px; cursor: pointer; color: var(--color-midtone-gray); }
.perf-ev-cancel td { color: var(--perf-down); }
/* 설정 */
.perf-set-table td, .perf-set-table th { vertical-align: middle; }
.perf-set-table thead th { text-align: left; }
.perf-set-table thead th:nth-child(2), .perf-set-table thead th:nth-child(3) { text-align: center; }
.perf-set-table thead th:nth-child(4) { text-align: right; padding-right: 60px; }
.perf-rate-cell { white-space: nowrap; }
.perf-rate { display: inline-block; min-width: 56px; text-align: right; font-weight: 600; margin-right: 4px; }
.perf-pill { display: inline-block; font-size: 11.5px; padding: 1px 8px; border-radius: 999px; background: var(--color-ghost-gray); color: var(--color-midtone-gray); white-space: nowrap; }
.perf-pill.is-ok { background: #e6f8e9; color: #0f8a3a; }
.perf-pill.is-bad { background: #fbe9e6; color: var(--perf-down); }
.perf-status { display: inline-flex; align-items: center; gap: 6px; font-size: 12.5px; white-space: nowrap; }
.perf-status i { width: 8px; height: 8px; border-radius: 50%; background: #bdbdbd; display: inline-block; }
.perf-status.st-ok i { background: #10b33a; }
.perf-status.st-auth_failed i, .perf-status.st-token_expired i, .perf-status.st-api_error i { background: var(--perf-down); }
.perf-status.st-not_configured i { background: #e0a526; }
.perf-status.st-disabled { color: var(--color-midtone-gray); }
.perf-err { font-size: 11px; color: var(--perf-down); max-width: 260px; white-space: normal; line-height: 1.35; margin-top: 2px; }
.perf-switch { position: relative; display: inline-block; width: 34px; height: 20px; cursor: pointer; }
.perf-switch input { opacity: 0; width: 0; height: 0; position: absolute; }
.perf-switch span { position: absolute; inset: 0; background: #d4d4d4; border-radius: 999px; transition: background .15s; }
.perf-switch span::after { content: ""; position: absolute; left: 3px; top: 3px; width: 14px; height: 14px; background: #fff; border-radius: 50%; transition: transform .15s; }
.perf-switch input:checked + span { background: var(--color-deep-black); }
.perf-switch input:checked + span::after { transform: translateX(14px); }
.perf-switch input:focus-visible + span { outline: 2px solid #93c5fd; outline-offset: 2px; }
.perf-dl { display: grid; grid-template-columns: 90px 1fr; gap: 6px 10px; margin: 0; font-size: 13px; }
.perf-dl dt { color: var(--color-midtone-gray); }
.perf-dl dd { margin: 0; }
.perf-sample-form { display: flex; align-items: center; gap: 6px; flex-wrap: wrap; margin-top: 8px; }
.perf-form { display: flex; flex-direction: column; gap: 12px; }
.perf-form-row { display: flex; flex-direction: column; gap: 4px; }
.perf-form-row > label { font-size: 12px; font-weight: 500; }
.perf-form-row .erp-input { width: 100%; box-sizing: border-box; }
.perf-form-help { font-size: 11.5px; color: var(--color-midtone-gray); }
.perf-secret-state { font-size: 11.5px; color: #0f8a3a; }
.perf-secret-state.is-empty { color: var(--color-midtone-gray); }
.perf-inline { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
.perf-test-result { font-size: 12.5px; margin-right: auto; }
.perf-test-result.is-ok { color: #0f8a3a; }
.perf-test-result.is-bad { color: var(--perf-down); }
@media (max-width: 1280px) {
.perf-kpis { grid-template-columns: repeat(3, minmax(0, 1fr)); }
}
@media (max-width: 980px) {
.perf-grid2 { grid-template-columns: 1fr; }
.perf-kpis { grid-template-columns: repeat(2, minmax(0, 1fr)); }
.perf-update { margin-left: 0; }
}
.perf-table tr.perf-row-match > *{background:#e7f6ec;font-weight:600}
.perf-paste { width: 100%; min-height: 96px; font-family: ui-monospace, Consolas, monospace; font-size: 12px; white-space: pre; resize: vertical; box-sizing: border-box; }
.perf-table tr.perf-row-diff > * { background: #fff7f5; }
.perf-diff-bad { color: var(--perf-down); font-weight: 600; }
.perf-diff-ok { color: #0f8a3a; }
.perf-link { background: none; border: 0; padding: 0; color: inherit; font: inherit; text-decoration: underline dotted; cursor: pointer; }
/* 주문 내역 창 — 열 제목은 가운데·굵게·150%, 창을 스크롤해도 위에 고정 */
.perf-ev-wrap { overflow: visible; }
.perf-ev-table thead th, .perf-ev-table thead th.perf-th-label {
text-align: center; font-weight: 700; font-size: 18px; color: var(--color-deep-black, #111);
position: sticky; top: -12px; z-index: 2;
}
.perf-ev-table thead th { background: var(--perf-soft, #fafafa); box-shadow: 0 1px 0 var(--perf-line, #e5e5e5); }
/* 취소 행 — 행 전체를 기울임 + 취소선 + 회색 */
.perf-ev-table tr.is-cancel td { font-style: italic; text-decoration: line-through; color: #9a9a9a; }
/* ── 매출 업데이트 진행 창 — 쇼핑몰별·전체 진행 막대(runSyncWithProgress) ── */
.perf-prog-card { width: min(640px, 100%); }
.perf-prog-row {
display: grid; grid-template-columns: 150px 1fr 44px; align-items: center; column-gap: 10px; row-gap: 3px;
padding: 9px 0; border-bottom: 1px solid var(--perf-line);
}
.perf-prog-name { font-size: 13px; font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.perf-prog-bar { height: 10px; border-radius: 999px; background: #eef0f3; overflow: hidden; }
.perf-prog-bar > span {
display: block; height: 100%; border-radius: inherit; background: var(--perf-sat);
transition: width .5s ease;
}
.perf-prog-pct { font-size: 12px; text-align: right; font-variant-numeric: tabular-nums; color: var(--color-midtone-gray); }
.perf-prog-text { grid-column: 2 / -1; font-size: 12px; color: var(--color-midtone-gray); overflow-wrap: anywhere; }
.perf-prog-row.is-done .perf-prog-bar > span { background: var(--perf-up); }
.perf-prog-row.is-error .perf-prog-bar > span { background: var(--perf-down); }
.perf-prog-row.is-error .perf-prog-text { color: var(--perf-down); }
.perf-prog-row.is-skip .perf-prog-bar > span { background: #b8bec7; }
/* 진행 중인 막대에 흐르는 빗금 — 멈춘 게 아니라는 표시 */
.perf-prog-row:not(.is-done):not(.is-error):not(.is-skip) .perf-prog-bar > span {
background-image: linear-gradient(45deg, rgba(255,255,255,.22) 25%, transparent 25%, transparent 50%,
rgba(255,255,255,.22) 50%, rgba(255,255,255,.22) 75%, transparent 75%, transparent);
background-size: 16px 16px; animation: perf-prog-flow 1s linear infinite;
}
@keyframes perf-prog-flow { from { background-position: 0 0; } to { background-position: 16px 0; } }
.perf-prog-row.is-total { border-bottom: none; border-top: 2px solid var(--perf-line); margin-top: 4px; padding-top: 12px; }
.perf-prog-row.is-total .perf-prog-name { font-weight: 700; }
.perf-prog-row.is-total .perf-prog-bar { height: 14px; }
.perf-prog-row.is-total .perf-prog-pct { font-weight: 700; color: inherit; }
@media (max-width: 560px) { .perf-prog-row { grid-template-columns: 1fr 44px; } .perf-prog-name { grid-column: 1 / -1; } .perf-prog-text { grid-column: 1 / -1; } }
/* [업데이트 취소] — 창 아래 왼쪽, 빨간 글자. 끝나면 숨김 */
.perf-prog-cancel { margin-right: auto; color: var(--perf-down); border-color: currentColor; }
.perf-prog-cancel[hidden] { display: none; }
.perf-prog-cancel:disabled { opacity: .6; cursor: default; }
File diff suppressed because it is too large Load Diff
+116
View File
@@ -0,0 +1,116 @@
/* ── 프로젝트 관리 도움말(/project/help, project/help.html) ──
왼쪽 목차(스크롤을 따라 현재 위치 강조) + 오른쪽 본문 카드. 처음 쓰는 사람이
읽기 쉽게 — 단계는 번호 동그라미, 화면의 버튼·메뉴 이름은 .pjh-ui 칩으로 표시. */
.pjh {
--pjh-ink: #1e1f21; --pjh-soft: #6d6e6f; --pjh-line: #e8eaee;
--pjh-accent: var(--pj-accent, #7b68ee); --pjh-tint: var(--pj-accent-tint, #f1eeff);
display: grid; grid-template-columns: 230px minmax(0, 1fr); gap: 28px;
max-width: 1180px; margin: 0 auto; padding: 4px 0 60px; color: var(--pjh-ink);
font-size: 14.5px; line-height: 1.7;
}
@media (max-width: 1000px) {
.pjh { grid-template-columns: minmax(0, 1fr); }
.pjh-toc { display: none; }
}
/* 목차 */
.pjh-toc { position: sticky; top: 12px; align-self: start; max-height: calc(100vh - 110px); overflow-y: auto; }
.pjh-toc-title { font-size: 12px; font-weight: 800; color: var(--pjh-soft); letter-spacing: .04em; margin: 0 0 8px 10px; }
.pjh-toc ol { list-style: none; margin: 0; padding: 0; counter-reset: toc; }
.pjh-toc li { counter-increment: toc; }
.pjh-toc a {
display: flex; gap: 8px; padding: 5px 10px; border-radius: 8px; color: #3d4046;
text-decoration: none; font-size: 13.5px; line-height: 1.45;
}
.pjh-toc a::before { content: counter(toc) "."; color: #9aa1a9; min-width: 18px; }
.pjh-toc a:hover { background: #f1f2f4; }
.pjh-toc a.is-active { background: var(--pjh-tint); color: var(--pjh-accent); font-weight: 700; }
/* 머리말 */
.pjh-hero {
background: linear-gradient(135deg, #f4f1ff 0%, #eef5ff 100%); border: 1px solid #e4defd;
border-radius: 16px; padding: 26px 30px; margin-bottom: 18px;
}
.pjh-hero h1 { margin: 0 0 6px; font-size: 24px; font-weight: 800; }
.pjh-hero p { margin: 0; color: #3d4046; }
.pjh-quick { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 10px; margin-top: 18px; }
.pjh-quick-step { background: #fff; border: 1px solid #e4defd; border-radius: 12px; padding: 12px 14px; font-size: 13.5px; line-height: 1.5; }
.pjh-quick-step b { display: block; color: var(--pjh-accent); font-size: 12px; margin-bottom: 2px; }
/* 본문 카드 */
.pjh-sec {
background: #fff; border: 1px solid var(--pjh-line); border-radius: 14px;
padding: 24px 30px; margin-bottom: 18px; scroll-margin-top: 16px;
}
.pjh-sec h2 { display: flex; align-items: center; gap: 10px; margin: 0 0 12px; font-size: 20px; font-weight: 800; }
.pjh-sec h2 .pjh-num {
display: inline-flex; align-items: center; justify-content: center; width: 30px; height: 30px;
border-radius: 9px; background: var(--pjh-tint); color: var(--pjh-accent); font-size: 15px; flex: none;
}
.pjh-sec h3 { margin: 22px 0 6px; font-size: 16px; font-weight: 800; }
.pjh-sec h3:first-of-type { margin-top: 8px; }
.pjh-sec p { margin: 6px 0; }
.pjh-sec ul { margin: 6px 0; padding-left: 20px; }
.pjh-sec li { margin: 3px 0; }
.pjh-lead { color: #3d4046; }
/* 단계(번호 동그라미) */
.pjh-steps { list-style: none; margin: 8px 0; padding: 0; counter-reset: step; }
.pjh-steps li { counter-increment: step; position: relative; padding: 2px 0 6px 36px; margin: 0; }
.pjh-steps li::before {
content: counter(step); position: absolute; left: 0; top: 3px; width: 24px; height: 24px;
border-radius: 50%; background: var(--pjh-accent); color: #fff; font-size: 12.5px; font-weight: 800;
display: flex; align-items: center; justify-content: center;
}
/* 화면 요소 이름(버튼·메뉴) 칩, 키보드 키 */
.pjh-ui {
display: inline-flex; align-items: center; gap: 3px; padding: 0 7px; border-radius: 6px;
background: #f1f2f4; border: 1px solid #e2e4e8; font-size: 13px; font-weight: 700; line-height: 22px;
white-space: nowrap; vertical-align: 1px;
}
.pjh-ui .material-symbols-outlined { font-size: 16px; }
.pjh kbd {
display: inline-block; min-width: 20px; padding: 0 6px; border-radius: 5px; text-align: center;
background: #fff; border: 1px solid #cfd3d9; box-shadow: 0 1px 0 #cfd3d9;
font: 700 12px/20px inherit; font-family: inherit; vertical-align: 1px;
}
.pjh-ic { font-size: 18px; vertical-align: -4px; color: var(--pjh-soft); }
/* 팁·주의 */
.pjh-tip, .pjh-note, .pjh-warn {
display: flex; gap: 10px; border-radius: 10px; padding: 10px 14px; margin: 10px 0; font-size: 13.5px; line-height: 1.6;
}
.pjh-tip { background: #f2faf5; border: 1px solid #cfe9da; }
.pjh-note { background: #f3f6ff; border: 1px solid #d6e0fb; }
.pjh-warn { background: #fff6f3; border: 1px solid #f6d6cc; }
.pjh-tip > .material-symbols-outlined { color: #3f8f6b; }
.pjh-note > .material-symbols-outlined { color: #4573d2; }
.pjh-warn > .material-symbols-outlined { color: #c24e2b; }
.pjh-tip > .material-symbols-outlined, .pjh-note > .material-symbols-outlined,
.pjh-warn > .material-symbols-outlined { font-size: 20px; flex: none; margin-top: 1px; }
/* 표 */
.pjh-table { width: 100%; border-collapse: collapse; margin: 8px 0; font-size: 13.5px; line-height: 1.55; }
.pjh-table th, .pjh-table td { border-bottom: 1px solid var(--pjh-line); padding: 8px 10px; text-align: left; vertical-align: top; }
.pjh-table th { background: #f7f8fa; font-weight: 800; color: #3d4046; white-space: nowrap; }
.pjh-table td:first-child { font-weight: 700; white-space: nowrap; }
/* 화면 구성 그림(아주 단순한 모형) */
.pjh-map {
display: grid; grid-template-columns: 170px 1fr; grid-template-rows: 44px 190px; gap: 8px;
margin: 12px 0; font-size: 12.5px; line-height: 1.45;
}
.pjh-map > div { border-radius: 10px; padding: 8px 12px; border: 1.5px dashed #c9c2f5; background: #faf9ff; }
.pjh-map b { display: block; color: var(--pjh-accent); }
.pjh-map-top { grid-column: 1 / -1; display: flex; align-items: center; justify-content: space-between; }
.pjh-map-side { grid-row: 2; }
.pjh-map-main { grid-row: 2; }
/* 맨 위로 */
.pjh-top {
position: fixed; right: 26px; bottom: 26px; width: 42px; height: 42px; border-radius: 50%;
display: inline-flex; align-items: center; justify-content: center; text-decoration: none;
background: var(--pjh-accent); color: #fff; box-shadow: 0 6px 18px rgba(123, 104, 238, .35);
}
.pjh-top:hover { filter: brightness(1.08); }
+1158 -77
View File
File diff suppressed because it is too large Load Diff
+4751 -761
View File
File diff suppressed because it is too large Load Diff
+1
View File
@@ -32,6 +32,7 @@ MODULE_KEYS: tuple[str, ...] = (
"dispatch", "dispatch",
"project", "project",
"cafe24", "cafe24",
"performance",
"expense_approver", "expense_approver",
"vacation_approver", "vacation_approver",
) )
+4 -2
View File
@@ -7,7 +7,7 @@
<link rel="stylesheet" href="/static/erp.css?v=20260615b" /> <link rel="stylesheet" href="/static/erp.css?v=20260615b" />
<link rel="stylesheet" href="/static/erp-shell.css?v=20260615b" /> <link rel="stylesheet" href="/static/erp-shell.css?v=20260615b" />
<link rel="stylesheet" href="/static/erp-attach-viewer.css" /> <link rel="stylesheet" href="/static/erp-attach-viewer.css" />
<link rel="stylesheet" href="/static/erp-dialog.css?v=20260819a" /> <link rel="stylesheet" href="/static/erp-dialog.css?v=20260930a" />
{% block head_extra %}{% endblock %} {% block head_extra %}{% endblock %}
</head> </head>
<body class="erp-body erp-app-body"> <body class="erp-body erp-app-body">
@@ -143,6 +143,8 @@
</div> </div>
</div> </div>
<a class="erp-btn erp-btn-outline" href="/logout">로그아웃</a> <a class="erp-btn erp-btn-outline" href="/logout">로그아웃</a>
{# 로그아웃 오른쪽 — 모듈별 도움말 버튼 등(예: 프로젝트 관리의 ? 아이콘) #}
{% block topbar_after_logout %}{% endblock %}
</div> </div>
</header> </header>
@@ -175,7 +177,7 @@
{# 공용 확인/경고 창. defer 를 쓰지 않는다 — 아래 {% block scripts %} 의 {# 공용 확인/경고 창. defer 를 쓰지 않는다 — 아래 {% block scripts %} 의
인라인 스크립트가 곧바로 erpConfirm/erpAlert 을 쓸 수 있어야 한다. #} 인라인 스크립트가 곧바로 erpConfirm/erpAlert 을 쓸 수 있어야 한다. #}
<script src="/static/erp-dialog.js?v=20260819a"></script> <script src="/static/erp-dialog.js?v=20260930a"></script>
<script src="/static/erp-attach-viewer.js" defer></script> <script src="/static/erp-attach-viewer.js" defer></script>
{% block scripts %}{% endblock %} {% block scripts %}{% endblock %}
</body> </body>
+24 -10
View File
@@ -64,7 +64,7 @@ app/modules/cafe24/ ← 상품관리 모듈
| `POST /cafe24/products/{product_no}/status` | 진열/판매 토글 (JSON: `{field, value}` → 적용 후 상태) | `cafe24` | | `POST /cafe24/products/{product_no}/status` | 진열/판매 토글 (JSON: `{field, value}` → 적용 후 상태) | `cafe24` |
| `POST /cafe24/products/{product_no}/name` | 상품명 변경 (JSON: `{name}` → 적용된 이름). 이전 이름은 감사로그 `rename_product` | `cafe24` | | `POST /cafe24/products/{product_no}/name` | 상품명 변경 (JSON: `{name}` → 적용된 이름). 이전 이름은 감사로그 `rename_product` | `cafe24` |
| `POST /cafe24/products/{product_no}/basic` | 상품명·판매가·공급가·소비자가 (JSON, 바뀐 것만 PUT). 감사로그 `update_basic` | `cafe24` | | `POST /cafe24/products/{product_no}/basic` | 상품명·판매가·공급가·소비자가 (JSON, 바뀐 것만 PUT). 감사로그 `update_basic` | `cafe24` |
| `POST /cafe24/products/{product_no}/image` | 대표 이미지 교체 (multipart `file`) — 업로드 후 PUT `detail_image` + `image_upload_type=A`. 감사로그 `set_main_image` | `cafe24` | | `POST /cafe24/products/{product_no}/image` | 대표 이미지 교체 (multipart `file`) — `POST /admin/products/{no}/images`(base64 data URI, `image_upload_type=A`). 감사로그 `set_main_image` | `cafe24` |
| `GET /cafe24/products/{product_no}/options` | 옵션 + 품목 조회 (JSON, 읽기 지연 보정 포함) | `cafe24` | | `GET /cafe24/products/{product_no}/options` | 옵션 + 품목 조회 (JSON, 읽기 지연 보정 포함) | `cafe24` |
| `POST /cafe24/products/{product_no}/options` | 옵션 생성 (`{option_name, values, display_type}`) — 조합형, 품목 자동 생성 | `cafe24` | | `POST /cafe24/products/{product_no}/options` | 옵션 생성 (`{option_name, values, display_type}`) — 조합형, 품목 자동 생성 | `cafe24` |
| `PUT /cafe24/products/{product_no}/options` | 옵션명·옵션값 이름/썸네일/표시방식 수정 + 옵션값 끝에 덧붙이기 (`{options:[...], option_list_type}` → 덧붙였으면 `added` 와 새 품목 포함) | `cafe24` | | `PUT /cafe24/products/{product_no}/options` | 옵션명·옵션값 이름/썸네일/표시방식 수정 + 옵션값 끝에 덧붙이기 (`{options:[...], option_list_type}` → 덧붙였으면 `added` 와 새 품목 포함) | `cafe24` |
@@ -306,10 +306,10 @@ code → access/refresh token 교환
cafe24_oauth_tokens 저장 cafe24_oauth_tokens 저장
``` ```
- scope 는 `app/integrations/cafe24/config.py` 의 `PRODUCT_SCOPES` = - scope 는 `app/integrations/cafe24/config.py` 의 `DEFAULT_SCOPES` =
`mall.read_product`, `mall.write_product`. `mall.read_product`, `mall.write_product`, `mall.read_order`(실적 모듈 매출 수집, 읽기만).
주문관리 추가 시 `ORDER_SCOPES` 를 합쳐 넘기고, 카페24 개발자센터 앱에서도 목록을 바꾸면 카페24 개발자센터 앱에도 그 권한이 있어야 하고(없으면 인증 거부),
권한을 추가한 뒤 **재인증**하면 된다. **재인증**해야 새 권한이 토큰에 붙는다. 재인증 전 기존 토큰은 예전 권한 그대로 계속 동작한다.
- access token 은 만료 2분 전부터 자동 갱신된다. 갱신은 토큰 행을 - access token 은 만료 2분 전부터 자동 갱신된다. 갱신은 토큰 행을
`SELECT ... FOR UPDATE` 로 잠근 채 수행 — web 컨테이너와 worker 컨테이너가 `SELECT ... FOR UPDATE` 로 잠근 채 수행 — web 컨테이너와 worker 컨테이너가
동시에 refresh 해서 한쪽 토큰이 무효화되는 것을 막는다(카페24는 refresh 동시에 refresh 해서 한쪽 토큰이 무효화되는 것을 막는다(카페24는 refresh
@@ -440,9 +440,21 @@ cafe24_oauth_tokens 저장
- **이미지 업로드**: `POST /admin/products/images` body `{"requests":[{"image":"<base64>"}]}` - **이미지 업로드**: `POST /admin/products/images` body `{"requests":[{"image":"<base64>"}]}`
→ `{"images":[{"path":"https://{domain}/web/upload/NNEditor/…"}]}`. 1장 10MB, 1호출 30MB, → `{"images":[{"path":"https://{domain}/web/upload/NNEditor/…"}]}`. 1장 10MB, 1호출 30MB,
1회 20장. 상품 대표이미지는 그 경로를 `PUT /admin/products/{no}` 의 `detail_image` 에 1회 20장. 이 경로는 상세설명 에디터·옵션 썸네일용이다.
넣고 `image_upload_type: "A"`(대표이미지등록 — 목록/작은목록/축소를 카페24가 리사이징). - **대표이미지**: `POST /admin/products/{no}/images` body `{"shop_no":1,"request":{
`B` 는 네 이미지를 각각 지정, `C` 는 웹FTP. "image_upload_type":"A","detail_image":"data:image/png;base64,…"}}` → `{"image":{detail_image,
list_image, tiny_image, small_image}}`(새 `/web/product/big|medium|tiny|small/…` 경로).
A(대표이미지등록)면 목록/작은목록/축소를 카페24가 리사이징, B 는 네 이미지를 각각 지정.
⚠️ 예전 방식(위 NNEditor 경로를 `PUT /admin/products/{no}` 의 `detail_image` 에 넣기)은
**대표이미지가 바뀌지 않았다**(실물, 2026-09-28 — "업로드했는데 적용 안 됨"). 이 응답엔
`updated_date` 가 없어 스냅샷 시각은 등록 시각(KST now)으로 남긴다.
- **이미지 경로는 상대경로로 올 수 있다**: `option_link_image` 등은 `/web/product/big/…` 처럼
도메인 없이 저장·응답된다(문서 예제). 화면은 옵션 GET 응답의 `image_base`(=쇼핑몰 주소
`shop_base`)를 붙여 그리고, 카페24에 되보내는 hidden 값은 받은 그대로 둔다. 예전에 이걸
"경로는 있는데 파일이 없다"로 오인해 "없음"으로 표시했다.
- **품목 `image` 는 도메인이 두 번 붙어 올 수 있다**(실물, 추가이미지 `/web/product/extra/big/…`):
`https://miras.co.krhttps://cafe24img.poxo.com/miraskitchen/web/product/extra/big/….jpg`.
화면(`imageUrl`)은 문자열 안에 `http(s)://` 가 또 있으면 마지막 주소부터 쓴다.
- **가격**: `price`(판매가) · `supply_price`(공급가, 문서상 "참조 목적") · `retail_price` - **가격**: `price`(판매가) · `supply_price`(공급가, 문서상 "참조 목적") · `retail_price`
(소비자가). 문자열 `"11000.00"` 형식으로 보낸다(`store.parse_price`). 쇼핑몰 설정의 (소비자가). 문자열 `"11000.00"` 형식으로 보낸다(`store.parse_price`). 쇼핑몰 설정의
"판매가 계산 기준"이 상품가(B)면 `price` 대신 `price_excluding_tax` 를 써야 한다는 문서 "판매가 계산 기준"이 상품가(B)면 `price` 대신 `price_excluding_tax` 를 써야 한다는 문서
@@ -463,7 +475,8 @@ cafe24_oauth_tokens 저장
- "옵션별 상품 이름" 은 옵션값(`option_text`)이고, "옵션별 썸네일" 은 `option_image_file` - "옵션별 상품 이름" 은 옵션값(`option_text`)이고, "옵션별 썸네일" 은 `option_image_file`
(+ `option_link_image` 에도 같은 경로) 이며, (+ `option_link_image` 에도 같은 경로) 이며,
화면의 옵션값 썸네일은 **`option_image_file` → `option_link_image` → 그 옵션값을 가진 화면의 옵션값 썸네일은 **`option_image_file` → `option_link_image` → 그 옵션값을 가진
품목의 `image`** 순으로 있는 것을 보여준다. 품목의 `image`** 순으로 있는 것을 보여주고, 불러오기에 실패하면 다음 후보로 넘어간다
(`cf24ThumbFallback`). 전부 실패해야 "없음".
- **통합 목록**(`app/static/cafe24-options.js`): 옵션이 1개(옵션명 하나)인 상품은 옵션값과 - **통합 목록**(`app/static/cafe24-options.js`): 옵션이 1개(옵션명 하나)인 상품은 옵션값과
품목이 1:1 이므로 한 행에 드래그핸들 · 썸네일 · 옵션값 이름 · 품목코드(클릭 복사) · 품목이 1:1 이므로 한 행에 드래그핸들 · 썸네일 · 옵션값 이름 · 품목코드(클릭 복사) ·
자체 품목코드 · 추가금액 · 진열 · 판매를 두고 「저장」 한 번에 옵션 PUT(이름/썸네일/ 자체 품목코드 · 추가금액 · 진열 · 판매를 두고 「저장」 한 번에 옵션 PUT(이름/썸네일/
@@ -522,7 +535,8 @@ cafe24_oauth_tokens 저장
1. <https://developers.cafe24.com> 로그인 → 앱 생성 1. <https://developers.cafe24.com> 로그인 → 앱 생성
2. Redirect URI 를 `.env` 의 `CAFE24_REDIRECT_URI` 와 **정확히 동일하게** 등록 2. Redirect URI 를 `.env` 의 `CAFE24_REDIRECT_URI` 와 **정확히 동일하게** 등록
(운영: `https://dbx.no1king.freeddns.org/cafe24/oauth/callback`) (운영: `https://dbx.no1king.freeddns.org/cafe24/oauth/callback`)
3. 권한(Scope)에 `mall.read_product`, `mall.write_product` 체크 3. 권한(Scope)에 상품(Product) 읽기+쓰기, 주문(Order) 읽기 이상 체크
(`mall.read_product`, `mall.write_product`, `mall.read_order` — 주문은 실적 모듈이 매출 수집에 사용)
4. 발급된 Client ID / Client Secret 을 `.env` 에 기입 4. 발급된 Client ID / Client Secret 을 `.env` 에 기입
### 5-2. DB 초기화 (superuser 로 1회) ### 5-2. DB 초기화 (superuser 로 1회)
+39
View File
@@ -11,6 +11,7 @@
| `cupang_db` | 쿠팡 밀크런 출고 묶음 / 출고 라인 / 입고센터 / 박스 입수량 규칙 | | `cupang_db` | 쿠팡 밀크런 출고 묶음 / 출고 라인 / 입고센터 / 박스 입수량 규칙 |
| `malaysia_stock_db` | 말레이시아 창고 재고관리 — 창고/아이템/세트 BOM/입출고 이력/일일 재고조사 | | `malaysia_stock_db` | 말레이시아 창고 재고관리 — 창고/아이템/세트 BOM/입출고 이력/일일 재고조사 |
| `cafe24_db` | 카페24 연동 — OAuth 토큰/상품 캐시/상세페이지 버전/예약/감사·API 로그 | | `cafe24_db` | 카페24 연동 — OAuth 토큰/상품 캐시/상세페이지 버전/예약/감사·API 로그 |
| `performance_db` | 실적(쇼핑몰 통합 매출) — 쇼핑몰 설정/수수료율 이력/API 인증정보(암호문)/연결 상태/매출 사건/동기화 기록 |
--- ---
@@ -336,6 +337,44 @@ cd /opt/www/main && docker compose up -d --build web
--- ---
## performance_db 스키마 / 초기화
DDL: `scripts/sql/performance_db_init.sql` (멱등). DB·역할(`performance_app`)·테이블·인덱스·트리거·쇼핑몰 10곳 seed 를
한 번에 생성. **JSON 폴백 없음** — `PERFORMANCE_DB_URL` 미설정 시 모듈이 "설정 필요" 안내만 표시. 상세는 `docs/PERFORMANCE_MODULE.md`.
| 테이블 | 용도 |
| --- | --- |
| `perf_marketplaces` | 쇼핑몰 코드·이름·사용 여부·매출 집계 여부·순서 |
| `perf_commission_rates` | 수수료율 이력(`rate_percent NUMERIC(7,3)`, `effective_from`). 그날 유효한 요율로 과거 실적 계산 |
| `perf_credentials` | API 인증정보. (쇼핑몰, 항목) 한 행 = **AES-256-GCM 암호문** + `key_version`. 토큰도 여기 |
| `perf_connection_status` | 연결 상태·마지막 테스트/동기화·최근 오류(비밀값 가린 문구) |
| `perf_sales_events` | 매출 사건(결제 +, 취소·반품 −, BIGINT 원). `UNIQUE(marketplace_code, event_type, external_event_id)`. `is_sample`=테스트 데이터 |
| `perf_sync_runs` | 동기화 기록. `status='running'` 부분 유니크 인덱스로 같은 쇼핑몰 동시 실행 차단 |
핵심 규칙:
- 인증정보는 **암호문만** 저장. 마스터 키 `APP_ENCRYPTION_KEY` 는 DB 가 아닌 `.env` 에만 있다 —
DB 백업만으로는 복호화할 수 없고, **키를 잃으면 인증정보를 다시 입력해야 한다**(키는 별도 안전 보관).
- 테스트 데이터 삭제는 `is_sample = TRUE` 조건 삭제만 한다(설정 화면 버튼).
### 운영 서버 초기화 (1회, 사용자 승인 후)
```bash
read -s -p "performance_app password: " APP_PWD; echo
docker exec -i postgres-db psql -U postgres \
-v app_password="$APP_PWD" \
< scripts/sql/performance_db_init.sql
# main-app .env 에 추가:
# PERFORMANCE_DB_URL=postgresql://performance_app:<APP_PWD>@postgres-db:5432/performance_db
# APP_ENCRYPTION_KEY=$(openssl rand -hex 32) # 별도 안전한 곳에도 백업
# APP_ENCRYPTION_KEY_VERSION=1
cd /opt/www/main && docker compose up -d --build
```
> 멱등 스크립트. 기존 DB 가 있으면 DROP 하지 않음.
---
## 백업 / 복구 (안전 절차) ## 백업 / 복구 (안전 절차)
### 백업 ### 백업
+4
View File
@@ -120,6 +120,10 @@ docker compose down # 컨테이너 제거 (볼륨 유지)
| `VACATION_DB_URL` | 휴가 관리 DB DSN (예: `postgresql://vacation_app:<pwd>@postgres-db:5432/vacation_db`). **필수** — 미설정 시 모듈 비활성(설정 필요 안내). 권한키 `vacation`/`vacation_approver` | | `VACATION_DB_URL` | 휴가 관리 DB DSN (예: `postgresql://vacation_app:<pwd>@postgres-db:5432/vacation_db`). **필수** — 미설정 시 모듈 비활성(설정 필요 안내). 권한키 `vacation`/`vacation_approver` |
| `ITEMCODE_DB_URL` | 상품 검색용 itemcode_db 읽기 전용 DSN. 미설정 시 검색 비활성(수동 입력). 테이블/컬럼은 `ITEMCODE_TABLE`/`ITEMCODE_CODE_COL`/`ITEMCODE_NAME_COL`/`ITEMCODE_TYPE_COL` 또는 `ITEMCODE_SEARCH_SQL` 로 지정 | | `ITEMCODE_DB_URL` | 상품 검색용 itemcode_db 읽기 전용 DSN. 미설정 시 검색 비활성(수동 입력). 테이블/컬럼은 `ITEMCODE_TABLE`/`ITEMCODE_CODE_COL`/`ITEMCODE_NAME_COL`/`ITEMCODE_TYPE_COL` 또는 `ITEMCODE_SEARCH_SQL` 로 지정 |
| `DATA_DIR` | 영구 데이터 경로 (Docker 볼륨 마운트). 첨부파일은 `$DATA_DIR/uploads/expense/{item_id}/` 에 저장 | | `DATA_DIR` | 영구 데이터 경로 (Docker 볼륨 마운트). 첨부파일은 `$DATA_DIR/uploads/expense/{item_id}/` 에 저장 |
| `PERFORMANCE_DB_URL` | 실적 DB DSN (예: `postgresql://performance_app:<pwd>@postgres-db:5432/performance_db`). **필수** — 미설정 시 실적 모듈 비활성(설정 필요 안내). 권한키 `performance` |
| `APP_ENCRYPTION_KEY` | 쇼핑몰 API 인증정보 암호화 마스터 키(32바이트, `openssl rand -hex 32`). DB 에 저장하지 않음. **분실 시 저장된 인증정보 복구 불가 — 별도 안전 보관**. 쇼핑몰별 ID/Key/Secret 은 `.env` 에 넣지 않고 실적 → 설정 화면에서 입력 |
| `APP_ENCRYPTION_KEY_VERSION` | 현재 마스터 키 버전(기본 1). 교체 시 올리고 예전 키는 `APP_ENCRYPTION_KEY_V{n}` 로 남긴 뒤 설정 화면에서 재암호화(`docs/PERFORMANCE_MODULE.md`) |
| `PERFORMANCE_SYNC_DAYS` | [매출 업데이트] 수집 기간(오늘 포함 최근 N일, 기본 7, 최대 90) |
--- ---
+249
View File
@@ -0,0 +1,249 @@
# 실적(쇼핑몰 통합 매출) 모듈
> `app/modules/performance/` · DB `performance_db` · URL `/performance/` · 권한키 `performance`
> 여러 쇼핑몰의 주문/매출을 **수집 → DB 저장 → 화면 조회** 구조로 한 화면에서 본다.
> API 장애·호출 제한이 있어도 이미 저장된 실적은 그대로 보인다.
## 1. 구조 — 네 영역 분리
| 영역 | 파일 | 역할 |
|---|---|---|
| ① 쇼핑몰 API 수집 | `adapters/base.py`, `adapters/<쇼핑몰>.py`, `adapters/registry.py`, `sync.py` | 어댑터 = 쇼핑몰 하나. `sync.py` 가 어댑터 결과를 공통 사건으로 DB 저장 |
| ② 인증정보·보안 | `security/crypto.py`, `security/redact.py`, `credentials.py` | AES-256-GCM 암·복호화, 비밀값 가리기, 저장/화면 요약/재암호화 |
| ③ 계산·저장 | `calc.py`, `db.py` | 기간·주(월~일)·수수료·반올림·집계(순수 함수) / performance_db |
| ④ 화면 | `dashboard.py`, `router.py`, `common.py`, `templates/performance/`, `static/performance.{css,js}` | 화면 데이터 조립, 라우트·권한, UI |
**쇼핑몰 추가 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄**(`perf_marketplaces`). 대시보드·설정·동기화는 자동으로 붙는다.
## 2. 어댑터 공통 인터페이스 (`MarketplaceAdapter`)
| 메서드 | 설명 |
|---|---|
| `credential_fields()` | 설정 화면 입력칸 정의(`CredentialField`: key/label/secret/required/help, `internal`=토큰 등 화면 비표시) |
| `validate_credentials(values)` | 저장 전 검사(값을 오류 문구에 넣지 않음) |
| `authenticate(ctx)` / `refresh_token(ctx)` | 토큰 발급·갱신. 새 토큰은 `ctx.credentials.set(key, value)` → 자동 암호화 저장 |
| `test_connection(ctx)` | 성공 문구 반환, 실패는 `AdapterError` 계열 |
| `fetch_orders` / `fetch_refunds(ctx, start, end)` | 원본 수집 |
| `normalize_order` / `normalize_refund(raw)` | 원본 → `SaleEvent` 목록 |
| `collect(ctx, start, end)` | 위를 묶어 (원본 건수, 사건 목록) — sync 서비스가 부른다 |
오류 클래스 = 연결 상태: `NotConfigured`(인증정보 미설정) · `AuthFailed`(인증 실패) · `TokenExpired` · `ApiError` · `NotImplementedYet`(연동 준비 중).
**연동 현황**: 카페24·11번가·네이버 스마트스토어·GS샵 = **구현됨**, 나머지 7개는 입력칸만 정의(수집은 `NotImplementedYet`). 쇼핑몰별 입력칸은
**연동 단계에서 공식 API 문서로 확정**한다.
### 카페24 (`adapters/cafe24.py`, 구현됨)
`auth_type="shared"` — 기존 `app/integrations/cafe24` OAuth 토큰(cafe24_db)과 클라이언트(재시도·429·토큰 자동 갱신)를
재사용한다. 토큰에 `mall.read_order` 가 있어야 한다(`DEFAULT_SCOPES` 포함, 권한 추가 후 카페24 상품관리 → 시스템에서 재연결).
**카페24 관리자 "일별 매출내역"과 같은 기준**으로 센다(처음의 품목 결제금액 방식은 배송비가 빠지고 환불 날짜 기준이 달라
화면과 맞지 않아 교체).
| 사건 | 조회 | 금액·날짜 |
|---|---|---|
| SALE(결제합계) | `GET /admin/orders` `date_type=pay_date`, `embed=items`, `paid=T` | +(실결제금액 + 적립금 + 예치금 + 네이버포인트), `initial_order_amount` + 주문 `naver_point`(결제 당시 금액 — 환불을 따로 빼므로 취소 후 금액 X), 결제일. 주문 1건 = 사건 1건(`{order_id}-PAY`) |
| CANCEL / RETURN(환불합계) | `GET /admin/refunds` `date_type=refund_date`, `status=T` | −(실제 환불액 + 적립금·예치금 환불), 환불완료일. 환불코드 R… = 반품, 그 밖 = 취소. 사건 ID = 환불코드 |
| CANCEL / RETURN(환불 목록 없는 취소·반품) | `GET /admin/orders` `date_type=cancel_date|return_complete_date`, `embed=items` — 품목 상태 C40~43/R40~43 이고 앞뒤 60일 환불 목록(완료일·접수일)에 그 주문이 없을 때 | −(판매가+옵션)×수량 − 품목 할인·쿠폰, 품목 취소일(반품은 반품완료일). 네이버페이 취소가 여기 해당 (네이버가 환불해 카페24 환불 목록에 없음). 사건 ID = `c24:{품목코드}-CL` (`unrefunded_claims`) |
- 할인 = 회원·세트상품·앱·마켓 기타·배송비 할인, 쿠폰 = 상품쿠폰 + 배송비쿠폰(`DISCOUNT_FIELDS`/`COUPON_FIELDS`).
- **기간 교체(`replace_range=True`)**: 결제·환불 모두 기간 안 날짜로 조회되므로 동기화 때 그 기간의 카페24 실데이터를 지우고
새로 넣는다(한 트랜잭션, 테스트 데이터 제외). 규칙이 바뀌어도 예전 행이 남지 않는다 → 규칙을 고친 뒤에는 같은 기간을
[과거 매출 가져오기]로 다시 받으면 된다.
- **주의 — `market_id` 는 외부 마켓만이 아니라 자체몰 주문 채널·간편결제도 담는다**(실데이터 확인 2026-09-30:
`mobile`=모바일웹, `NCHECKOUT`=네이버페이, `KAKAOPAY`=톡체크아웃). 이들은 `SELF_CHANNELS` 로 카페24 열.
대조 도구의 "주문 채널별" 표가 채널마다 자체몰 채널 / 외부 마켓 / 알 수 없는 채널(→ 카페24 열)을 보여 준다.
`MARKET_MAP` 에는 결제수단과 헷갈릴 수 있는 일반 이름(naver, kakao)을 넣지 않는다.
- **현재 `MARKET_MAP` 은 비어 있다** — 이 쇼핑몰은 카페24 마켓 통합관리를 쓰지 않는다(2026-09 사용자 확인). 카페24로 들어온
주문은 모두 카페24 열이고 설정 화면의 "카페24 경유" 표시도 나오지 않는다. 아래는 나중에 마켓 통합관리를 쓸 때의 동작.
- **마켓 연동 주문은 해당 쇼핑몰 열로**: 자체몰 채널은 카페24 열. 카페24 마켓 통합관리가 가져온
다른 마켓 주문은 `MARKET_MAP`(market_id 또는 order_place_id → 우리 쇼핑몰 코드)으로 네이버·쿠팡·11번가 등 열에 넣는다
(`SaleEvent.marketplace_code`). 연결표에 없는 마켓은 카페24 열 — **전체 합계는 항상 카페24 일별 매출내역과 같다**
(9/28 대조로 자체몰+마켓 합계가 모든 줄에서 일치 확인). 환불은 원 주문을 100건씩 조회해 같은 열로. 네이버페이는 자체몰.
- 카페24 가 만든 사건 ID 는 모두 `c24:` 접두어(`event_prefix`) — 다시 받을 때 카페24 열 + 다른 열의 `c24:` 행만 교체해
그 쇼핑몰의 **직접 연동분은 건드리지 않는다**. 어떤 쇼핑몰을 직접 API 로 연동하면 같은 주문을 두 번 받지 않도록 그 마켓을
`MARKET_MAP` 에서 빼야 한다. 설정 화면 API 설정 칸의 "카페24 경유" 표시 = 카페24 수집 때 함께 반영되는 쇼핑몰.
- 실제 market_id 값은 "카페24 매출 대조"의 마켓별 표(market_id / 주문경로 / 반영 열)로 확인하고, "(연결표 없음)"으로 나오는
마켓이 우리 쇼핑몰이면 `MARKET_MAP` 에 추가한다.
- 60일 단위 분할(한 호출 3개월 미만), orders limit 1000 / refunds limit 500 페이지. 개인정보는 저장하지 않는다.
- **카페24 매출 대조**(설정 화면, `GET /api/marketplaces/cafe24/reconcile?date=`): 그날 결제 주문·환불을 카페24 화면 열 순서대로
(주문수·품목수·상품구매금액·배송비·할인·쿠폰·결제합계·환불합계·순매출) 자체몰/다른 마켓으로 나눠 합산. 저장하지 않음.
카페24 화면과 다른 줄이 있으면 할인 항목 구성·마켓 포함 여부를 이 결과로 조정한다.
- **일별 한 번에 비교**(같은 카드, `GET /api/marketplaces/{code}/daily-check?from=&to=&live=1`, 최대 62일): 카페24 일별
매출내역 표를 붙여 넣으면(날짜 + 뒤 세 숫자 = 결제합계·환불합계·순매출, 첫 숫자 = 주문수) 날짜마다 저장값(`c24:` 사건 전체,
다른 마켓 열 포함)과 지금 API·현재 규칙으로 다시 계산한 값(`adapter.collect`, 저장 안 함)을 비교한다.
저장값만 틀림 → 예전 규칙으로 받은 것([다시 가져오기] 버튼), API 값도 틀림 → 규칙 차이(결제/환불) → 날짜 클릭으로 그날 대조.
날짜를 눌러 연 대조 표에는 붙여넣은 카페24 열(주문수·품목수·상품구매금액·배송비·할인·쿠폰·실결제·적립금·예치금·결제·환불·순매출)과
열별 차이가 같이 나온다.
- **결제합계 = 실결제금액 + 적립금 + 예치금 + 네이버포인트**(initial_order_amount 의 payment_amount·points_spent_amount·
credits_spent_amount + 주문의 naver_point). "상품구매금액 + 배송비 − 할인 − 쿠폰"은 할인 필드에 안 잡히는 차이가 있어 쓰지 않음
(2026-09-23: 카페24 1,874,738 = 1,713,128 + 10,110 + 151,500, 상품식 1,874,800). 네 값이 모두 0인 주문도 0원
(9/25 가상계좌·휴대폰 9,900 — 카페24도 0원).
- **환불 목록 없는 취소는 네이버페이(NCHECKOUT)만** 환불합계에 넣는다. 주문 전체가 취소·반품되면 배송비(− 배송비 할인·쿠폰)도
그 주문의 마지막 클레임 품목에 한 번 더한다. 톡체크아웃·자체몰의 환불 기록 없는 취소는 카페24 환불합계에 없음
(9/4: 98,700 + 네이버페이 19,900 + 배송비 3,500 = 122,100 / 9/16: 톡체크아웃 취소 9,900 제외 → 201,100).
### 11번가 (`adapters/elevenst.py`, 구현됨)
- 인증: 셀러오피스 Open API Key → 헤더 `openapikey`. **셀러 API 는 등록 IP 에서만** 호출된다(Seller API 정보 수정 →
IP 직접 입력에 운영 서버 외부 IP, 셀링툴 사방넷과 함께 사용 가능). 응답은 XML(euc-kr 선언 → 직접 디코딩).
- 없는 주소 = 500 + `-997 등록된 API 정보가 존재하지 않습니다`, 건 없음 = `-1 해당 건이 없습니다`(0건으로 처리).
- 상세 문서가 로그인 뒤에만 있어 설정 화면 **"11번가 원본 데이터 확인"**(`reconcile(day, to)`, 후보 주소별 동작·항목 합계,
개인정보 값 숨김)으로 실데이터를 보고 확정했다(2026-09-30).
- 주문 상태 목록 4개(`/rest/ordservices/complete|packaging|shipping|completed/{yyyyMMddHHmm}/{…}`)는 **지금 그 상태인 주문만**
준다. 배송완료 목록에 구매확정 주문도 남는다. 취소·반품된 주문은 목록에서 빠지고 `/rest/claimservice/canceledorders|…` 에 있다.
- SALE = **주문 하나**(`11st:{ordNo}`), 날짜 = 결제일.
- **정산된 주문**: 정산 내역(`/rest/settlement/settlementList/{yyyyMMdd}/{yyyyMMdd}`, 정산확정일 `stlDy` 기준 → 기간 뒤 45일
(오늘까지)을 더 불러 결제일 `ordStlEndDt` 로 거름)의 **판매금액합계 `selPrcAmt` 합**. 셀러오피스 "판매 상세내역"과 같고
배송비(도서산간 등)가 별도 줄로 들어 있다 — 9/10 주문 83,800 + 배송비 줄 3,000 = 86,800(주문 목록 `dlvCst` 는 0).
- **정산 전 주문**: 주문 상태 목록의 `ordAmt`(판매금액, 11번가 부담 쿠폰 전) + 배송비(`dlvCst` 최댓값 한 번). 기간 뒤 30일을 더
불러 주문일로 거른다. 정산되면 다음 업데이트 때 정산 값으로 바뀐다.
- `ordAmt − ordPayAmt` = 정산 `cupnAmt` = 11번가 부담 할인(`discount_amount`). 수수료는 판매금액 기준(34,900 × 13% = 4,537).
- `replace_range` — 기간을 통째로 다시 받아 취소·반품된 주문이 매출에서 빠진다(취소 사건을 따로 만들지 않음 → 지난 날짜
금액이 나중에 줄 수 있음). 구매자 이름·아이디·연락처는 저장하지 않는다.
### 네이버 스마트스토어 (`adapters/naver.py`, 구현됨)
- 인증: 커머스API센터 애플리케이션 ID·시크릿 → 전자서명 `client_secret_sign = base64(bcrypt.hashpw("{client_id}_{timestamp ms}",
client_secret))` → `POST https://api.commerce.naver.com/external/v1/oauth2/token`(form: client_id·timestamp·client_secret_sign·
grant_type=client_credentials·type=SELF, 판매자 ID 입력 시 type=SELLER+account_id). 토큰(약 3시간)은 `access_token`·
`access_token_expires_at`(internal, 암호화)으로 저장해 만료 5분 전까지 재사용, 401 이면 한 번 새로 받아 다시 호출.
[연결 테스트]는 입력값으로 시험하므로 항상 새 토큰. **애플리케이션의 API 호출 IP 에 운영 서버 외부 IP 등록 필요.**
의존성 `bcrypt`(requirements.txt).
- 수집: 조건형 상품 주문 상세 조회 `GET /v1/pay-order/seller/product-orders?from=&to=&rangeType=PAYED_DATETIME&pageSize=100&page=`
— 한 번에 **24시간까지**(하루씩 0시~23:59:59.999 +09:00), from 부터 180일 안 주문만(네이버 안내, GitHub discussions #1875·#2380).
응답 모양은 `data.contents[].content.{order, productOrder, …}` 로 보고 목록·`content` 유무가 달라도 받는다(`product_order_items`),
다음 쪽은 `pagination.hasNext`(없으면 100건 꽉 차면). 호출 간격 0.35초, 429 는 1·2·4초 쉬고 다시.
- **매출 규칙 = 스마트스토어센터 판매분석 "판매금액(총)"**(2026-09-30 사용자 확인): 판매분석 9/1 매출 4,455,600원 = 판매금액(총) —
할인(판매자·네이버 부담) 뒤 금액, **배송비(332,486원)는 별도**, 결제 뒤 취소·반품도 결제일에 포함하고 환불(346,340원)은 **환불일**에
따로 빼서 판매금액(순) 4,109,260원(예: 9/1 결제 0원인 상품에 환불 5건 75,040원). 주방세제 2.3L 16,640 = 17,900 − 네이버 부담 1,260.
처음 규칙(취소·반품 빼고 배송비 더함)은 4,245,300원으로 달랐다.
- SALE = 주문 하나(`naver:{orderId}`), 날짜 = 결제일(`order.paymentDate`), 금액 = 상품주문 `totalPaymentAmount` 합(배송비 제외),
할인 = `productDiscountAmount` 합. 결제 뒤 취소·반품(`CANCELED`·`RETURNED`)도 포함, 입금대기·미입금 취소만 뺀다
→ 지난 날짜 매출이 나중에 줄지 않는다. `replace_range`.
- 환불(판매금액(순))은 아직 사건으로 만들지 않는다 — 필요하면 클레임 완료일 기준 CANCEL/RETURN 을 추가.
- 설정 화면 **"쇼핑몰 원본 데이터 확인"**(네이버 선택): 결제일 기준 상품주문 전체의 항목별 합계, 상태별 합계, 날짜별
매출·그중 결제 뒤 취소/반품(참고)·배송비(참고). 개인정보(주문자·수령인·주소·연락처·메모)는 값 없이 이름만.
### GS샵 (`adapters/gsshop.py`, 구현됨)
- 문서: 협력사 포털 → 제휴 API → 개발가이드(`partners.gsshop.com/api/apiDevGuide`, 본문은 `/docs/withgs-api-docs.html` Redoc).
- 인증: 헤더 `supCd`(협력사코드) + `token` = base64(AES256(`yyyyMMddHHmmss` + 협력사코드)), 키는 제휴 API 메인 화면(로그인 후).
키 = 포털 제휴 API 메인의 **운영 KEY**(개발 KEY 아님). 문서에 암호화 모드·키를 바이트로 쓰는 법이 없어 키 변형(글자 그대로 /
16진수 풀기 / 앞 32자, `key_variants`) × 모드(CBC·IV=키 앞 16 → ECB → CBC·IV=0) 순서로 시도하고 통과한 조합을 기억.
토큰이 틀리면 **HTTP 200** + `{"result":"fail","code":"401 UNAUTHORIZED"}`. 운영 주소 `withgs-api.gsshop.com`(문서 예시
`atwithgs-api` 는 테스트용 — 두 곳 모두 응답). 입력칸 키는 처음 만든 `vendor_code`·`api_key` 그대로(라벨만 협력사코드·AES256 키).
- 매출: `GET /api/v2/settlement/out/sales/period?supCode&fromDate&toDate&pageIdx&rowsPerPage` — **매출인식일** 기준, 한 번에 10일,
쪽당 1만 건, `{data, hasMorePage, totalCount}`. 배송비는 `/shippingFee/period`. 응답 줄 항목 이름이 문서 예시에 없어
("property1") 실데이터로 확인(2026-09-30, 9/3): `saleAwareDt`·`ordNo`·`ordItemNo`·`ordType`(SALE…)·`prdNm`·`chrQty`·
`salePrice`(할인 전, 줄 합계)·`dcTotAmt`·`custChrAmt`(= salePrice − dcTotAmt, 고객 결제금액)·`supGiveAmt`(협력사 지급액).
9/3: 211,100 − 19,528 = 191,572, 지급 179,435, 배송비 내역 7,000.
- **주문일 기준 조회 API 는 없다** — 협력사 포털 주문 통계(총주문금액·주문일, 할인 후 금액: 45,900 × 85% = 39,015)와는 날짜 기준이
달라 날마다 똑같이 맞지 않는다(매출인식일 = 정산 기준).
- **매출 규칙**: 매출 내역 한 줄 = 사건(`gs:{ordNo}-{ordItemNo}-{ordType}-{saleAwareDt}`), 날짜 = 매출인식일,
금액 = **`supGiveAmt`(협력사 지급액)** = 협력사 포털 주문 통계의 금액(2026-09-30 확인: 6호세트 포털 176,715 ÷ 9 = 19,635 = API
supGiveAmt 19,635 — 판매가 23,100·고객 결제 20,330. 7호세트 45,900 × 85%, 주부체험 9,900 × 90% — 상품마다 GS 수수료율이 다름).
9/1~9/29 지급액 4,972,689 vs 포털 순주문 4,823,074 — 남는 차이는 주문일 ↔ 매출인식일·취소분. 이미 GS 수수료를 뺀 금액이라
**GS샵 수수료율은 0%**. 배송비 제외, `ordType` 이 SALE 이 아니면 RETURN 음수. `replace_range`.
원본 데이터 확인에 날짜별 현재 규칙 매출·취소/반품·배송비(참고).
### 연동 단계 체크리스트(쇼핑몰마다)
- 공식 문서로 인증 방식·호출 제한·페이지네이션·주문 상태 코드·취소/반품 API·날짜 필드 확인
- `SaleEvent` 규칙: 금액은 원 단위 **정수**, 결제 `+` / 취소·반품 `−`, `external_event_id` 는 쇼핑몰 안에서 사건을
유일하게 가리키는 값(중복 방지 키), `order_date`/`payment_date`/`event_date` 를 섞지 말고 각각 채운다
- 오류 메시지·`raw` 에 비밀값을 넣지 않는다(sync 가 한 번 더 가리지만 원칙은 넣지 않는 것)
- `implemented = True`, 단위 테스트(원본 샘플 → 사건 변환) 추가
## 3. 매출 기준·계산 (`calc.py`, `sync.sales_date_for`)
- **집계 기준일(`sales_date`)**: 결제 = 결제일(`payment_date`, 없으면 `event_date`), 취소·반품 = **발생일**.
지난주 실적이 나중에 바뀌지 않게 하려는 선택. `order_date`/`payment_date` 를 따로 보관하므로 기준을 바꿀 수 있다
(바꿀 곳은 `sales_date_for` 한 곳 + 기존 행 재계산).
- **수수료** = `round_half_up(일·쇼핑몰 매출 합 × 그날 요율 / 100)` — `calc.commission()` 한 곳. 음수(취소)도 같은 규칙.
주문별이 아니라 일·쇼핑몰 합계 단위 반올림이다.
- **수수료율 이력**: `perf_commission_rates(effective_from)`. 어떤 날의 요율 = 그날 이전 가장 최근 시작일의 요율,
첫 요율 이전은 0%. "처음부터(과거 전체)"는 `2000-01-01` 로 저장.
- **주** = 월요일~일요일. **증감률**: 진행 중인 기간은 직전 기간의 **같은 경과일수**까지와 비교(전주 같은 기간),
비교 대상이 0 이하면 표시하지 않음.
- **월·연 누적 기준일**: 선택 기간이 오늘을 포함하면 오늘(이번주가 다음 달에 걸쳐도 "이번달"), 지난 기간이면 기간 끝.
## 4. 인증정보 보안
- 저장: 설정 화면 입력 → 서버에서 **AES-256-GCM**(`cryptography` AESGCM) → `perf_credentials`
(항목 하나 = 행 하나, `encrypted_value = "v{키버전}:{base64url(nonce+암호문+tag)}"`, `key_version`).
- AAD = `perf:{쇼핑몰}:{항목}` — 암호문을 다른 칸으로 옮기면 복호화 실패.
- 화면으로는 secret 항목의 **저장 여부만** 보낸다(원문·일부·길이 X). 일반 항목(Vendor ID 등)만 원문 표시.
- 빈 칸 저장 = 기존 값 유지. 선택 항목은 "저장된 값 지우기".
- 저장 정책: [연결 테스트]는 **입력한 새 값으로 시험하고 저장하지 않음**(상태도 기록 안 함). [저장]은 테스트 결과와 무관하게
저장(쇼핑몰 일시 장애 대비) 후 자동으로 저장값 연결 테스트.
- 오류 메시지·로그·`raw_data` 는 `security/redact.py` 로 key/secret/token/password/Authorization/Cookie 를 가린 뒤 저장.
- 쇼핑몰 API 는 **백엔드에서만** 호출. 브라우저는 `/performance/api/*` 만 부른다.
### 마스터 키
| 변수 | 설명 |
|---|---|
| `APP_ENCRYPTION_KEY` | 현재 키(32바이트: `openssl rand -hex 32` 64자 hex 또는 base64). **DB·Git 에 넣지 않는다** |
| `APP_ENCRYPTION_KEY_VERSION` | 현재 키 버전(기본 1) |
| `APP_ENCRYPTION_KEY_V{n}` | 교체 중 남겨 두는 예전 키 |
교체 절차: 새 키를 `APP_ENCRYPTION_KEY`, 버전 +1, 예전 키를 `APP_ENCRYPTION_KEY_V{예전}` 에 → 재기동 →
설정 화면 [현재 키로 다시 암호화](`POST /performance/api/rekey`) → 예전 버전 0개 확인 후 `_V{n}` 삭제.
**키를 잃으면 저장된 인증정보는 복구할 수 없다** — 키는 서버 `.env` 와 별도 안전한 곳에 백업한다
(DB 백업만으로는 복호화 불가 — 의도된 설계).
## 5. 권한 (서버에서 검사)
| 기능 | 권한 |
|---|---|
| 대시보드 · 매출 업데이트 · 금액 상세 | `performance` (admin 자동) |
| 설정 화면 · 수수료 · 인증정보 · 연결 테스트 · 테스트 데이터 · 재암호화 | `is_admin` |
화면에서 설정 탭을 숨기는 것과 별개로 모든 설정 API 가 `common.require_store(admin=True)` 로 403 을 낸다.
## 6. 동기화 (`sync.py`)
- `SyncService.sync_all()` / `sync_marketplace()` — 버튼·향후 cron/worker 공용. 기본 기간: 오늘 포함 최근
`PERFORMANCE_SYNC_DAYS`(기본 7)일.
- **대시보드 [매출 업데이트]** = 지금 보고 있는 기간(오늘까지)을 `POST /api/sync {from, to}` 로 다시 가져온다
("이번달"이면 1일~오늘). 모듈 권한자는 92일까지, 더 긴 기간(올해 등, 최대 366일)은 관리자만.
- **과거 매출 가져오기**(설정 화면, 관리자): 같은 API 로 임의 기간(최대 366일). 같은 사건은 덮어써서 여러 번 해도 중복 없음.
- **진행 창**(두 버튼 공통, `runSyncWithProgress`): `POST /api/sync {…, background: true}` → 수집을 스레드로 돌리고 작업 번호를
바로 돌려줌 → 화면이 `GET /api/sync/jobs/{id}` 를 0.8초마다 불러 **쇼핑몰별 막대 + 전체 막대**를 그린다(`jobs.py`, 메모리 보관 —
uvicorn 단일 워커 기준, 서버 재시작 시 진행 정보만 사라짐). 어댑터가 `ctx.progress.plan(전체, 단위)`/`step(items=)`/`add(n)` 로
알린다 — 네이버 = 일, 11번가 = 7일 구간(정산 + 주문 상태 4개), 카페24 = 60일 구간(결제·환불·환불 없는 취소 2종, 대조 필요 시 +).
상태: 대기 → 수집 중 n/전체 · 받은 자료 → 저장 중 → 완료 n건 반영 | 실패 | 건너뜀. 수집이 없거나 인증정보가 없는 쇼핑몰은
막대에서 빼고 "건너뜀" 한 줄(전체 진행률에 안 넣음). 전체 = 막대 쇼핑몰 진행률 평균. 이미 돌고 있는 업데이트가 있으면 새로 시작하지
않고 그 진행 상황을 보여 준다(`GET /api/sync/current`). 창을 닫아도 수집은 계속된다.
- **[업데이트 취소]**(진행 창 왼쪽 아래, 시작한 사람·관리자, `POST /api/sync/jobs/{id}/cancel`): 돌고 있는 쇼핑몰은 다음 API 호출
직전(`ctx.progress.check()` → `Cancelled`)에 멈추고 **저장하지 않는다**(저장은 수집이 끝난 뒤 한 트랜잭션이라 기존 매출 그대로),
차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다. 이미 저장이 끝난 쇼핑몰 결과는 남고, 저장 중이던 쇼핑몰은 그 저장을 끝낸다.
취소된 실행은 `perf_sync_runs` 에 failed + "업데이트 취소", 연결 상태(`perf_connection_status`)는 바꾸지 않는다.
- 카페24 **환불합계 규칙(확정, 2026-09-29 실데이터)**: 카페24 "일별 매출내역" 환불합계 = 환불 목록의 (실제 환불액 + 적립금·예치금 환불)
+ 환불 목록에 없는 취소·반품(네이버페이 등, 취소일 기준). 9/26 = 178,220 + 1,080 + 네이버페이 취소 96,500 = 275,800,
9/27 = 145,000 + 네이버페이 55,800 = 200,800 으로 일치. 대조 도구에 환불합계 후보(값 입력 시 일치 줄 강조)·환불 건별·
취소/반품 완료 품목·그날 결제 주문 중 줄어든 주문 표가 있어 규칙이 어긋나면 이것으로 다시 찾는다.
- 같은 쇼핑몰 동시 실행 금지: `perf_sync_runs` 의 `status='running'` 부분 유니크 인덱스(30분 넘은 running 은 정리).
- 쇼핑몰 하나 실패 → 그 쇼핑몰만 상태 오류(`perf_connection_status`), 나머지 계속. 대시보드는 저장된 데이터로 계속 표시하고
상단에 오류 쇼핑몰만 표시.
- 중복 방지: `UNIQUE(marketplace_code, event_type, external_event_id)` + `ON CONFLICT DO UPDATE`.
## 7. 화면
- **대시보드** `/performance/?period=day|week|month|year|custom&d=&from=&to=&m=<쇼핑몰>…`
기간 버튼(오늘/이번주/이번달/올해/직접선택) + 이전/다음, 쇼핑몰 필터, KPI 5개, 일자×쇼핑몰 표(주간합계·기간합계, 연간은 월 행),
[총매출|수수료|수수료 차감 매출] 전환(서버가 세 값을 다 그리고 CSS 로 전환, 선택은 localStorage), 일별 추이·쇼핑몰 비중(SVG),
월 누적(비중), 연간 누적(월별, 지나지 않은 달 빈칸). 금액 클릭 → 주문 상세(`GET /api/events`, 31일 이내).
- **설정** `/performance/settings` — 사용/매출 집계 토글, 수수료율(적용 시작일·이력), API 설정 창, 연결 상태
(정상/미설정/인증 실패/Token 만료/API 오류/연동 준비 중/사용 중지, 마지막 테스트·동기화, 최근 오류), 마스터 키 상태·재암호화,
테스트 데이터 생성/삭제(`is_sample`).
## 8. 테스트
```bash
python -m app.modules.performance.tests.test_performance # 또는 pytest
```
암호화(왕복·AAD·변조·키 교체), 가리기, 수수료 반올림·요율 이력, 기간/주 계산, 표·누적 합계, 인증정보 비노출·재암호화,
동기화 격리·가리기·중복 방지·매출 기준일, 모의 데이터를 DB/네트워크 없이 검증한다.
+440 -99
View File
@@ -1,8 +1,29 @@
# 프로젝트 관리 모듈 (아사나식) — `app/modules/project/` # 프로젝트 관리 모듈 (아사나식) — `app/modules/project/`
> 회사(dbxcorp.co.kr) 직원이 프로젝트→세션→업무 3단계 구조를 달력/타임라인/ > 회사(dbxcorp.co.kr) 직원이 프로젝트→섹션→작업 3단계 구조를 캘린더/타임라인/
> 보드로 관리하는 아사나(Asana) 스타일 협업 모듈. DB는 `project_db` 전용. > 보드로 관리하는 아사나(Asana) 스타일 협업 모듈. DB는 `project_db` 전용.
**화면 용어는 아사나 한국어판에 맞춘다(2026-09-25 통일)** — 새 화면·메시지도 이 표를 따른다.
작업(예전 "업무") · 하위 작업 / 상위 작업 · 내 작업 · 섹션(예전 "세션"·"단계") ·
협업자(예전 "팔로워", 버튼은 "협업자로 참여 / 협업자에서 나가기" — 예전 "팔로우 / 팔로우 취소") ·
목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 작업 링크 복사 ·
프로젝트 칸 + "다른 프로젝트에 추가"(예전 "연결된 프로젝트") · 담당자 없음(예전 "(미지정)").
"@태그"는 그대로 쓴다. 코드 식별자·DB 컬럼(`tasks`, `stage_id`, `task_followers` 등)과 코드 주석은 예전 이름 그대로다.
**도움말** — `/project/help`(`project/help.html` + `static/project-help.css`), 프로젝트 관리 화면 상단 바 로그아웃
오른쪽 **?** 아이콘(`_help_btn.html`, `erp_base.html` 의 `topbar_after_logout` 블록)으로 새 탭에서 연다. 처음 쓰는 사람용
기능 설명 20장 — **화면 기능을 바꾸면 도움말도 같이 고친다.**
**멤버 이름 표기** — 이메일 아이디의 첫 글자만 대문자(king → King). JS 는 `idOf(email)`/`capName(s)`,
템플릿은 `{{ nm[:1]|upper }}{{ nm[1:] }}` 로 화면에 그릴 때만 바꾼다(API `id`·DB 값은 그대로 — 멘션·검색은 이메일 기준).
**프로젝트 색상·아이콘(아사나식)** — 색상표는 32색(`store.COLOR_PALETTE`, 8칸×4줄 — 위 2줄은 아사나 프로젝트 16색, 아래 2줄은 같은 열의 진한 색. 진한 칸은 체크를 흰색 `.is-dark`. 새 프로젝트
기본은 파랑 `DEFAULT_PROJECT_COLOR`). 예전 팔레트 색으로 만든 프로젝트는 그 색 그대로(수정 팝업이 첫 칸으로
바꾸지 않는다). 아이콘은 아사나 프로젝트 아이콘과 같은 종류 42개를 Material Symbols 이름으로(`store.PROJECT_ICONS`
— 아사나의 실제 아이콘 이미지는 쓰지 않는다), `projects.icon`(마이그레이션 011, NULL = 색 + 첫 글자).
새 프로젝트·프로젝트 수정 팝업의 "아이콘" 격자(`renderIconPalette`, 첫 칸 "Aa" = 아이콘 없음), 사이드바 배지·
제목 알약에 흰 아이콘(`projBadgeInner`). 아이콘은 고르거나 바꿨을 때만 서버로 보내므로 011 전에도 다른 수정은 된다.
**색상표는 모든 편집창이 이 하나** — 섹션 편집도 같은 32색(`STAGE_COLOR_PALETTE = COLOR_PALETTE`). 섹션에서 첫 칸(연회색)은
"색 없음"(NULL, 기본 회색 머리), 예전 10색으로 칠한 섹션은 그대로(`LEGACY_STAGE_COLORS`). 밝은 색(연노랑·하늘·연분홍 등)
위에서는 글자·아이콘을 어둡게(`isLightColor` → `.is-light`: 섹션 머리·사이드바 배지·제목 알약).
## 1. 개요 ## 1. 개요
| 항목 | 값 | | 항목 | 값 |
@@ -12,113 +33,217 @@
| 연결 env | `PROJECT_DB_URL` (미설정 시 "설정 필요" 안내, 앱은 죽지 않음) | | 연결 env | `PROJECT_DB_URL` (미설정 시 "설정 필요" 안내, 앱은 죽지 않음) |
| 진입 권한 | 권한키 `project` (관리자 페이지 토글로 직원별 부여, admin 자동) | | 진입 권한 | 권한키 `project` (관리자 페이지 토글로 직원별 부여, admin 자동) |
| 멤버 배정 후보 | `project` 권한 보유 등록 사용자 자동 목록 (`GET /project/api/assignable-users`) | | 멤버 배정 후보 | `project` 권한 보유 등록 사용자 자동 목록 (`GET /project/api/assignable-users`) |
| 생성 권한 | **프로젝트·세션·업무(하위 업무 포함) 생성은 로그인해 이 모듈에 접근할 수 있는 사용자 누구나.** 프로젝트를 만든 사람은 자동으로 owner 가 되어 그 프로젝트를 관리(`_can_manage`)할 수 있다. | | 생성 권한 | **프로젝트·섹션·작업(하위 작업 포함) 생성은 로그인해 이 모듈에 접근할 수 있는 사용자 누구나.** 프로젝트를 만든 사람은 자동으로 owner 가 되어 그 프로젝트를 관리(`_can_manage`)할 수 있다. 다른 사람을 owner 로 지정해 만드는 건 관리자만(비관리자가 `owner_email` 을 남으로 보내면 403) |
| 수정/이동 권한 | 서브프로젝트·업무·세션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 admin(`_require_manage`) | | 소유자 변경 | **관리자만**(2026-09-30). owner 는 멤버에서 빠져도 관리 권한이 남으므로, 일반 멤버가 스스로를 owner 로 바꿔 권한 회수를 피할 수 없게 `PUT /api/projects/{id}` 의 `owner_email` 변경은 비관리자 403(같은 값은 무시). 새 owner 는 `project` 권한이 있는 등록 사용자여야 한다(아니면 400) |
| 조회 권한 | 프로젝트 화면(`/p/{id}`)·멤버/세션/업무/활동/스냅샷 API 도 멤버·owner·admin 만(`_require_manage`). 비멤버는 403. `GET /api/users/tasks` 를 프로젝트 없이 부르면 내가 볼 수 있는 프로젝트의 업무만 돌려준다 | | 수정/이동 권한 | 서브프로젝트·작업·섹션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 admin(`_require_manage`). 작업 API 는 `_require_task(write=True)` = 원 소속 프로젝트 권한(FULL) |
| 입력 검증 | URL 의 세션이 URL 의 프로젝트 것인지(`_stage_of_project`), 업무 생성/수정·연결 시 세션이 그 프로젝트 것인지(`stage_in_project`), 하위 업무의 부모가 같은 프로젝트인지 확인 — 권한은 URL 의 project_id 로 보므로 이걸 안 보면 남의 프로젝트를 건드릴 수 있다 | | 조회 권한 | 프로젝트 화면(`/p/{id}`)·멤버/섹션/작업/활동/스냅샷 API 도 멤버·owner·admin 만(`_require_manage`). 비멤버는 403. `GET /api/users/tasks` 를 프로젝트 없이 부르면 내가 볼 수 있는 프로젝트의 작업만 돌려준다. 연결된(멀티호밍) 작업은 연결된 프로젝트 멤버에게 **읽기 전용**(6-10) |
| 삭제 권한 | **프로젝트·세션·업무 모두 "만든 사람만"**(슈퍼관리자 예외, 생성자 정보 없는 과거 데이터는 admin 허용) — `_can_delete` 하나로 통일 | | 지금 권한 기준 | 모든 판단은 **지금** 권한(`app/modules/project/access.py`) — 멤버에서 빠진 사람은 예전 담당자·멘션·협업자 기록이 있어도 내 작업·수신함·알림·검색·상세·공유 링크·댓글·첨부에서 그 작업이 보이지 않고, 새 알림·메일도 받지 않는다(기록은 이력으로 남김) |
| 입력 검증 | URL 의 섹션이 URL 의 프로젝트 것인지(`_stage_of_project`), 작업 생성/수정·연결 시 섹션이 그 프로젝트 것인지(`stage_in_project`), 하위 작업의 부모가 같은 프로젝트인지 확인 — 권한은 URL 의 project_id 로 보므로 이걸 안 보면 남의 프로젝트를 건드릴 수 있다. 새 담당자는 그 프로젝트를 볼 수 있는 사람만(400). 날짜 범위(시작 ≤ 마감, 같은 날이면 시작 시각 ≤ 마감 시각)는 부분 수정도 기존 값과 합친 최종 상태로 검사(400) |
| 삭제 권한 | **프로젝트·섹션·작업 모두 "만든 사람만"**(슈퍼관리자 예외, 생성자 정보 없는 과거 데이터는 admin 허용) — `_can_delete` 하나로 통일. **그리고 지금 그 프로젝트 권한이 있어야 한다**(멤버에서 빠진 생성자는 403, DB·휴지통 변화 없음) |
| 멤버 배정 | 여전히 관리자(`is_admin`) 전용. 비관리자가 "새 프로젝트" 모달을 열면 멤버 선택란은 안내 문구만 뜨고 시도하지 않는다(불필요한 403 방지) | | 멤버 배정 | 여전히 관리자(`is_admin`) 전용. 비관리자가 "새 프로젝트" 모달을 열면 멤버 선택란은 안내 문구만 뜨고 시도하지 않는다(불필요한 403 방지) |
| 메일 알림 | `app/mail.py` (stdlib smtplib). 업무 배정/완료 시 관리자에게 발송 | | 메일 알림 | `app/mail.py` (stdlib smtplib). 작업 배정/완료 시 관리자에게 발송 |
## 1-1. 프로젝트 → 세션 → 업무 (하위 업무 포함) 3단계 구조 ## 1-1. 프로젝트 → 섹션 → 작업 (하위 작업 포함) 3단계 구조
**"세션"은 새 개념이 아니라 기존 "단계"(칸반 컬럼)를 그대로 재사용한다** — **"섹션"은 새 개념이 아니라 기존 "단계"(칸반 컬럼)를 그대로 재사용한다** —
아사나도 보드 뷰의 컬럼과 리스트 뷰의 구분선이 같은 "섹션" 하나다. DB 아사나도 보드 뷰의 컬럼과 목록 뷰의 구분선이 같은 "섹션" 하나다. DB
컬럼/테이블 이름(`project_stages`, `stage_id`)은 그대로 두고, 사용자에게 컬럼/테이블 이름(`project_stages`, `stage_id`)은 그대로 두고, 사용자에게
보이는 문구만 "세션"으로 바꿨다. 보이는 문구만 "섹션"으로 바꿨다.
- **세션 관리** — 프로젝트 화면(`/project/p/{id}`)에서 "이 프로젝트" 스코프로 - **섹션 관리** — 프로젝트 화면(`/project/p/{id}`)에서 "이 프로젝트" 스코프로
볼 때만 보드 컬럼에 관리 UI가 붙는다(이름변경·완료토글·삭제·"+ 세션 추가"). 볼 때만 보드 컬럼에 관리 UI가 붙는다(이름변경·완료토글·삭제·"+ 섹션 추가" — 아사나처럼
마지막 섹션 바로 오른쪽, `renderBoard` 가 매번 캔버스 끝에 붙인다).
컬럼 헤더를 **드래그해서 순서를 바꿀 수 있다**(카드 드래그와 같은 네이티브 컬럼 헤더를 **드래그해서 순서를 바꿀 수 있다**(카드 드래그와 같은 네이티브
HTML5 DnD, `PUT /api/projects/{id}/stages/order` 재사용). "전체 프로젝트" HTML5 DnD, `PUT /api/projects/{id}/stages/order` 재사용). "전체 프로젝트"
스코프(여러 프로젝트를 세션 '이름'으로 합쳐 보는 예전 방식)에서는 세션을 스코프(여러 프로젝트를 섹션 '이름'으로 합쳐 보는 예전 방식)에서는 섹션을
하나로 특정할 수 없어 관리 UI가 없다. 하나로 특정할 수 없어 관리 UI가 없다.
- **하위 업무(subtask)** — 새 테이블이 아니라 `tasks.parent_task_id` 재사용 - **하위 작업(subtask)** — 새 테이블이 아니라 `tasks.parent_task_id` 재사용
(부모 삭제 시 CASCADE). 업무 편집 팝업 안에 인라인으로 표시되며(체크박스+ (부모 삭제 시 CASCADE). 작업 편집 팝업 안에 인라인으로 표시되며(체크박스+
제목+담당자+마감일, 한 줄에서 바로 저장), 보드/캘린더/리스트에는 최상위 제목+담당자+마감일, 한 줄에서 바로 저장), 보드/캘린더/목록에는 최상위
업무만 카드로 뜬다(하위 업무는 부모 카드에 "2/5" 진행 배지로만 나타난다). 작업만 카드로 뜬다(하위 작업은 부모 카드의 "N ⤷ ▾" 토글로 — 누르면 아사나처럼 카드 아래로
세션을 갖지 않는다(칸반에 안 보이므로). 하위 작업 목록(완료 체크·제목·마감·담당자)이 펼쳐진다. 펼친 상태는 페이지에 머무는 동안 유지).
- **멀티호밍(다른 프로젝트에 연결)** — `task_project_links` 테이블. 업무 하나가 섹션을 갖지 않는다(칸반에 안 보이므로).
펼친 하위 작업 한 줄을 다른 카드로 드래그하면 그 작업의 하위 작업으로 옮겨진다
(`POST /api/tasks/{id}/move-parent` `{parent_task_id}` → `db.move_subtask`, 활동 `subtask_moved`).
받는 쪽은 **같은 프로젝트의 최상위 작업만**(순환 방지), 하위 작업의 하위 작업은 함께 따라간다.
펼친 하위 작업 목록 맨 아래 **"+ 하위 작업 추가"**(아사나, `renderSubAdd`) — 누르면 그 자리에 새 줄
(✓ · "작업 이름 입력" · 점선 달력 · 점선 사람)이 열려 Enter 로 바로 만들고, 줄은 열린 채 다음 입력으로.
이름을 쓴 채 다른 곳을 누르면 Enter 와 같이 만들고 줄은 닫힘(`onOutsideDown` — 문서 pointerdown, 한글 조합 중인
마지막 글자까지 반영하려고 한 박자 뒤 입력칸 값을 읽는다). Esc 또는 빈 채로 다른 곳을 누르면 닫힘. 보드가 8초마다 다시 그려져도 입력 중인 값·포커스는
`subDrafts` 에서 되살린다.
**하위 작업도 작업과 같은 팝업에서 똑같이 편집**(아사나식) — 보드 카드의 하위 작업 줄 클릭·우클릭 "열기",
작업 팝업 하위 작업 줄의 › 버튼, 공유 링크로 연다(`openTaskById`). 제목 위에 상위 작업 경로
(`#pj-t-parent`, 누르면 상위 작업으로 — `GET /api/tasks/{id}` 가 `parent_title` 을 준다),
섹션 칸·다른 프로젝트 연결은 숨긴다. 저장해도 보드 목록(`tasks`)엔 넣지 않는다(`mergeTask`).
작업 팝업의 하위 작업 줄(`initSubtaskBlock`)도 아사나식 — ⠿ 손잡이로 끌어 순서 변경
(`PUT /api/tasks/{id}/subtasks/order` → `db.reorder_subtasks`), ✓ 완료, 제목 칸은 글자 폭만큼
(`fitTitle`)이고 줄의 빈 곳을 누르면 하위 작업 열기, 마감일은 날짜 글자만(없으면 점선 달력
아이콘, 누르면 아사나식 날짜 팝업 `openDatePopover`), 담당자는 아이콘만(누르면 아이콘+이름 메뉴).
삭제는 우클릭 메뉴(줄에 × 없음). 그 하위 작업에도 하위 작업이 있으면 제목 옆에 "N ⤷"
아이콘(`nestedSubsHtml`, `list_tasks` 의 `subtask_total`), 댓글이 있으면 "N 말풍선", 설명이 있으면
줄글 아이콘(`subMetaHtml` — `comment_count`, `description` 을 `hasDescription` 으로 판정: 태그·공백뿐이면
없음, 이미지만 있어도 있음) — 보드 카드 펼친 목록도 같다. 보드의 최상위 작업 카드도 설명이 있으면
댓글 배지 옆에 같은 줄글 아이콘(`.pj-card-desc`).
하위 작업을 펼친 카드는 윗부분(`.pj-card-head` — 배지·제목·담당자/마감일/하위 작업 토글 줄)이
`position: sticky` 라 컬럼을 스크롤해도 카드가 끝날 때까지 컬럼 맨 위에 고정된다.
- **마감일 말풍선** — 지난 마감일(빨강, `dueInfo().cls === "is-overdue"`)은 "마감일 지남", 그 밖엔 "마감일 변경"
(`dueTip`). 보드 카드·카드 하위 작업 줄·작업 팝업 하위 작업 줄 공용.
- **날짜 팝업 닫힘** — 마감일을 고르면(달력 날짜·"오늘"·직접 입력) 저장하고 바로 닫힌다. 시작일 칸이 활성일 때
고른 날짜는 시작일로 넣고 마감일을 이어서 고르도록 열어 둔다.
- **날짜 팝업 색** — 일요일·공휴일(국경일·대체공휴일, `store.KR_HOLIDAYS`) 빨강, 토요일 파랑, 공휴일 이름은 말풍선.
공휴일 날짜는 숫자 밑에 이름(좁아서 "OO 대체"→"대체휴일", `HOLIDAY_SHORT`), 그 주만 줄이 높아진다.
공휴일 표는 `main.py` Jinja 전역 `pj_kr_holidays` → 공용 사이드바 `_side.html` 이 `window.PJ_HOLIDAYS` 로 넘긴다
(새 연도는 `KR_HOLIDAYS` 에만 추가하면 캘린더·타임라인·날짜 팝업 모두 반영).
- **날짜 고르기는 전부 아사나식 날짜 팝업(`openDatePopover`)** — 브라우저 기본 달력(`input[type=date]`)을
화면에 두지 않는다. 보드 카드·작업 팝업·하위 작업 줄은 직접 팝업을 열고, 폼의 날짜 칸(새 프로젝트 마감일,
프로젝트 수정 시작일·마감일(버튼 하나), 하위 작업 추가 마감일)은 `enhanceDateInput` 이 숨긴 input 옆에
날짜 버튼을 붙인다(input 은 값 저장소 — `.value` 읽기/쓰기·change 이벤트 그대로). 새 날짜 칸도 이 함수를 쓴다.
- **멀티호밍(다른 프로젝트에 연결)** — `task_project_links` 테이블. 작업 하나가
원래 소속(기본 홈, `tasks.project_id`/`stage_id`)과 무관하게 다른 프로젝트의 원래 소속(기본 홈, `tasks.project_id`/`stage_id`)과 무관하게 다른 프로젝트의
한 세션에도 동시에 나타날 수 있다(아사나의 "Add to project"). 업무 편집 한 섹션에도 동시에 나타날 수 있다(아사나의 "Add to project"). 작업 편집
팝업의 "연결된 프로젝트" 칩에서 추가/해제한다. 새 연결을 만들 때는 원 팝업의 "연결된 프로젝트" 칩에서 추가/해제한다. 새 연결을 만들 때는 원
프로젝트·대상 프로젝트 양쪽 관리 권한이 필요하지만(무단으로 남의 업무를 프로젝트·대상 프로젝트 양쪽 관리 권한이 필요하지만(무단으로 남의 작업을
끌어와 노출시키는 것 방지), **이미 연결된 업무를 그 프로젝트 보드 안에서 끌어와 노출시키는 것 방지), **이미 연결된 작업을 그 프로젝트 보드 안에서
다른 세션으로 드래그하는 것은 대상 프로젝트 권한만 있으면 된다.** 다른 섹션으로 드래그하는 것은 대상 프로젝트 권한만 있으면 된다.**
`list_tasks(project_id=X)`(비재귀 단일 프로젝트 조회, 프로젝트 화면이 쓰는 `list_tasks(project_id=X)`(비재귀 단일 프로젝트 조회, 프로젝트 화면이 쓰는
바로 그 경로)가 자동으로 연결된 업무까지 포함해서 돌려준다 — 다른 호출 바로 그 경로)가 자동으로 연결된 작업까지 포함해서 돌려준다 — 다른 호출
경로(홈/내 업무 등 `project_id` 없이 부르는 전체보기)는 원 소속만 세어 경로(홈/내 작업 등 `project_id` 없이 부르는 전체보기)는 원 소속만 세어
중복 노출을 막는다. 중복 노출을 막는다.
- **사이드바 프로젝트 스코프** — 프로젝트 화면 툴바에 "이 프로젝트"/"전체 - **프로젝트 화면 머리** — 아사나처럼 왼쪽 위 두 줄: ① 프로젝트 색 네모 아이콘(아이콘 없으면
프로젝트" 토글이 있다. 기본은 "이 프로젝트"(아사나처럼 지금 선택한 `folder`)+제목(클릭해 이름 수정)+멤버 아바타, ② 뷰 탭(보드/목록/캘린더/타임라인/대시보드).
프로젝트의 세션만 보드/캘린더/타임라인/리스트에 나온다), "전체 프로젝트"는 위쪽 바의 "+ 작업 추가" 버튼은 없앴다(섹션의 + / "+ 작업 추가"로 만든다).
- **사이드바 프로젝트 스코프** — 프로젝트 화면 툴바 오른쪽에 "이 프로젝트"/"전체
프로젝트" 토글이 있다. "전체 프로젝트"면 제목이 "전체 프로젝트"로 바뀌고 멤버는
숨긴다(`#pj-title-wrap.is-all-scope`). 기본은 "이 프로젝트"(아사나처럼 지금 선택한
프로젝트의 섹션만 보드/캘린더/타임라인/목록에 나온다), "전체 프로젝트"는
예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여준다. 서버가 `tasks` 배열의 예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여준다. 서버가 `tasks` 배열의
각 행에 `context_project_id`(어느 프로젝트를 보다가 담겼는지)를 표시해두고, 각 행에 `context_project_id`(어느 프로젝트를 보다가 담겼는지)를 표시해두고,
클라이언트가 이 값으로 스코프를 걸러낸다(순수 프론트 필터 — 서버 재조회 없음). 클라이언트가 이 값으로 스코프를 걸러낸다(순수 프론트 필터 — 서버 재조회 없음).
- **업무 설명 이미지 삽입** — 설명란이 `contenteditable` 로 바뀌어 이미지를 - **작업 설명 이미지 삽입** — 설명란이 `contenteditable` 로 바뀌어 이미지를
붙여넣거나 파일로 올릴 수 있다. 새 첨부 endpoint 없이 기존 붙여넣거나 파일로 올릴 수 있다. 새 첨부 endpoint 없이 기존
`task_attachments` 업로드를 재사용하고, 표시는 `GET `task_attachments` 업로드를 재사용하고, 표시는 `GET
/api/attachments/{id}/inline`(다운로드용 `/download` 는 `Content-Disposition: /api/attachments/{id}/inline`(다운로드용 `/download` 는 `Content-Disposition:
attachment` 가 걸려 `<img>` 로 못 씀 — 그래서 인라인 전용 endpoint를 따로 attachment` 가 걸려 `<img>` 로 못 씀 — 그래서 인라인 전용 endpoint를 따로
뒀다)로 한다. 저장 전 서버가 `store.sanitize_description_html()` 로 허용 뒀다)로 한다. 저장 전 서버가 `store.sanitize_description_html()` 로 허용
태그만 남기고 스크립트/이벤트속성/위험 URL 스킴을 제거한다(표준 태그만 남기고 스크립트/이벤트속성/위험 URL 스킴을 제거한다(표준
`html.parser`, 외부 라이브러리 없음). 새 업무 작성 중(저장 전, task_id 없음) `html.parser`, 외부 라이브러리 없음). 새 작업 작성 중(저장 전, task_id 없음)
에는 이미지 삽입이 비활성화된다 — 첨부가 업무 id 를 필요로 하기 때문. 에는 이미지 삽입이 비활성화된다 — 첨부가 작업 id 를 필요로 하기 때문.
## 2. 데이터 모델 (`scripts/sql/project_db_init.sql` + `..._002_*` ~ `..._006_*`) ## 2. 데이터 모델 (`scripts/sql/project_db_init.sql` + `..._002_*` ~ `..._006_*`)
- `projects` — `parent_id`(self-FK, NULL=최상위 / NOT NULL=서브프로젝트, `ON DELETE CASCADE`), name, description, color, owner_email, start/due_date, status(active|archived). - `projects` — `parent_id`(self-FK, NULL=최상위 / NOT NULL=서브프로젝트, `ON DELETE CASCADE`), name, description, color, owner_email, start/due_date, status(active|archived).
- `project_members` — 프로젝트↔사용자 배정. role(manager|member), `UNIQUE(project_id, user_email)`. - `project_members` — 프로젝트↔사용자 배정. role(manager|member), `UNIQUE(project_id, user_email)`.
- `project_stages`(="세션") — 진행단계(칸반 컬럼). **프로젝트 생성 시 자동으로 - `project_stages`(="섹션") — 진행단계(칸반 컬럼). **프로젝트 생성 시 자동으로
만들지 않는다**(아사나처럼 직접 "+ 세션 추가"로 만든다 — `create_project` 만들지 않는다**(아사나처럼 직접 "+ 섹션 추가"로 만든다 — `create_project`
의 `seed_stages` 기본값은 `False`). `is_done_stage`=TRUE 단계로 옮기면 업무 의 `seed_stages` 기본값은 `False`). `is_done_stage`=TRUE 단계로 옮기면 작업
완료 처리. `created_by`(003) — 삭제를 "만든 사람만"으로 제한하기 위함. 완료 처리. `created_by`(003) — 삭제를 "만든 사람만"으로 제한하기 위함.
`color`(004, nullable) — 세션 생성/편집 팝업에서 아사나 10색 팔레트 `color`(004, nullable) — 섹션 생성/편집 팝업에서 아사나 10색 팔레트
(`store.STAGE_COLOR_PALETTE`) 중 선택, 보드 컬럼 헤더에 표시. (`store.STAGE_COLOR_PALETTE`) 중 선택, 보드 컬럼 헤더에 표시.
- `tasks` — 업무. stage_id, title, description(HTML — 이미지 삽입 지원), assignee_email/name, priority(low|normal|high), start/due_date, completed_at, `parent_task_id`(003, self-FK `ON DELETE CASCADE`, NULL=최상위 업무). - `tasks` — 작업. stage_id, title, description(HTML — 이미지 삽입 지원), assignee_email/name, priority(low|normal|high), start/due_date, completed_at, `parent_task_id`(003, self-FK `ON DELETE CASCADE`, NULL=최상위 작업).
- `task_project_links`(003) — 멀티호밍. `(task_id, project_id)` UNIQUE, `stage_id` nullable(그 프로젝트 안에서의 세션). - `task_project_links`(003) — 멀티호밍. `(task_id, project_id)` UNIQUE, `stage_id` nullable(그 프로젝트 안에서의 섹션).
- `task_comments` — 댓글. - `task_comments` — 댓글.
- `task_attachments` — 첨부(설명란 이미지도 이걸 재사용). - `task_attachments` — 첨부(설명란 이미지도 이걸 재사용).
- `project_activity` — 활동 이력(created/assigned/completed/stage_changed). 메일 트리거 근거 + 타임라인. - `project_activity` — 활동 이력(created/assigned/completed/stage_changed). 메일 트리거 근거 + 타임라인.
- `task_mentions`(006) — @태그. `(task_id, COALESCE(comment_id,0), mentioned_email)` UNIQUE, - `task_mentions`(006) — @태그. `(task_id, COALESCE(comment_id,0), mentioned_email)` UNIQUE,
`source`=description|comment, `is_read`. 수신함의 "나를 태그한 업무" 목록 근거. `source`=description|comment, `is_read`. 수신함의 "나를 태그한 작업" 목록 근거.
## 3. 화면 / 뷰 ## 3. 화면 / 뷰
- **내 업무** (`/project/`): 프로젝트 모듈의 첫 화면. 예전 홈(프로젝트 카드 그리드)은 > **확인/알림/입력 창 규칙** — 프로젝트 관리 화면의 팝업 창 제목은 전부 **"KSN 프로그램"**
**없앴다** — 좌측 "내 업무" 메뉴와 같은 화면이다(`project/mytasks.html`). > (`project.js` 가 `window.ERP_DIALOG_TITLE` 로 지정, 공용 `erp-dialog.js`). `project.js` 안의
내가 담당자인 업무를 한 표에 모아 보여준다: 완료 체크박스 · 업무 · 프로젝트 · 세션 · > `alert/confirm/prompt` 는 공용 창으로 가려져 있고 `confirm/prompt` 는 Promise 라 반드시 `await`.
> 브라우저 기본 `window.confirm` 등을 새로 쓰지 않는다.
> **말풍선(툴팁) 규칙 — 모든 화면·앞으로 추가하는 기능 공통.** 말풍선은 아사나식 공용 말풍선
> 하나(`.pj-hovertip`, `initHoverTips`)만 쓴다: 어두운 배경 + 아래 꼬리, 커서 바로 위, 화면 끝이면
> 안쪽으로 밀리고 위가 모자라면 아래로 뒤집힘. 요소에 `data-tip="문구"` 또는 `title="문구"` 만 달면
> 된다(`title` 은 마우스를 올리는 순간 `data-tip` 으로 옮겨져 브라우저 기본 말풍선이 안 뜬다).
> 별도 툴팁 구현 금지 — 부득이하면(대시보드 막대처럼 요소에 붙는 것) 같은 색·꼬리 모양으로.
>
> **댓글 말풍선(💬 N) 규칙** — 보드 카드·목록 행·캘린더 막대·내 작업 어디서든 **한 번 클릭**으로 댓글
> 대화창(`#pj-modal-comments`, `initCommentsChat`)이 열린다. `.pj-cmt-badge[data-task-id]` 만 달면
> 문서 캡처 단계 클릭 처리가 카드/행 클릭(작업 열기)보다 먼저 받아 막으므로 따로 연결할 필요 없다
> (`wireBadge` 는 안 읽음 표시만). 댓글 본문의 웹페이지 주소(`https://…`, `www.…`)는 작업 팝업 댓글·
> 대화창 모두 `linkifyToHtml` 로 새 탭 링크가 된다(나머지 글자는 이스케이프). 대화창 입력칸 붙여넣기는
> 글자가 있으면 글자 우선, 그림만 있을 때 첨부.
>
> **담당자 고르기 규칙 — 모든 화면·앞으로 추가하는 기능 공통.** 담당자를 고르는 곳은 항상 "아이콘 + 이름".
> 팝업 메뉴는 `assigneeMenuItems(emails, cur, onPick)` + `showContextMenu`(항목 `icon`/`checked` 지원), 폼의
> `<select>` 는 `enhanceAssigneeSelect(sel)` 로 감싼다(select 는 숨겨 값 저장소로 유지). 미지정 = 점선 원 사람 아이콘.
>
> **날짜 규칙.** 마감일(시작일) 고르기는 아사나식 팝업 `openDatePopover(anchor, {start, due, allowStart, onChange})`
> 하나만(브라우저 기본 date 캘린더 금지). 마감일 표기는 `dueInfo(iso, done)` — 어제(빨강)·오늘/내일(초록)·그 밖 mm/dd(요일),
> 지난 날짜 빨강, 완료 작업은 색 없음.
- **내 작업** (`/project/`): 프로젝트 모듈의 첫 화면. 예전 홈(프로젝트 카드 그리드)은
**없앴다** — 좌측 "내 작업" 메뉴와 같은 화면이다(`project/mytasks.html`).
내가 담당자인 작업을 한 표에 모아 보여준다: 완료 체크박스 · 작업 · 프로젝트 · 섹션 ·
우선순위 · 시작 · 마감. 헤더 클릭으로 정렬, 상단 탭으로 진행 중/완료/전체 필터, 우선순위 · 시작 · 마감. 헤더 클릭으로 정렬, 상단 탭으로 진행 중/완료/전체 필터,
오른쪽에 진행/완료/지연 요약. 체크박스는 그 자리에서 완료 토글, 행을 누르면 그 오른쪽에 진행/완료/지연 요약. 체크박스는 그 자리에서 완료 토글, 행을 누르면 그
프로젝트로 이동하며 업무 편집 팝업이 열리고(`?task=`), 우클릭은 열기/완료/삭제 메뉴. 프로젝트로 이동하며 작업 편집 팝업이 열리고(`?task=`), 우클릭은 열기/완료/삭제 메뉴.
완료된 업무 행은 반투명 + 취소선. 8초 주기로 목록을 다시 받는다. 완료된 작업 행은 반투명 + 취소선. 8초 주기로 목록을 다시 받는다.
표/목록 화면이라 본문 폭은 1180px 로 제한한다(보드·달력 등 프로젝트 뷰는 전체 폭). 표/목록 화면이라 본문 폭은 1180px 로 제한한다(보드·캘린더 등 프로젝트 뷰는 전체 폭).
좌측 사이드바는 프로젝트·수신함 화면과 공용(`project/_side.html`, `side_active` 로 좌측 사이드바는 프로젝트·수신함 화면과 공용(`project/_side.html`, `side_active` 로
활성 메뉴 표시) — 수신함 · 내 업무 · 활성 메뉴 표시) — 수신함 · 내 작업 ·
프로젝트 트리(+ 새 프로젝트). "전체 멤버"는 그 팝업을 배선하는 코드가 `initProject` 프로젝트 트리(+ 새 프로젝트) · "전체 멤버". 프로젝트 트리는 **수신함·내 작업·휴지통·프로젝트
안에 있어 프로젝트 화면에서만 나온다. 네 화면 모두 같다** — 관리자에게 드래그 순서 변경(⣿)·✎ 수정·× 삭제·우클릭 메뉴(공용
`initSideTree`, 모달은 `project/_side_modals.html` 을 각 화면이 include). "전체 멤버"는 **관리자(`is_admin`)에게만**
그리고 수신함·내 작업·프로젝트 화면 모두에서 나온다. 아이콘 클릭 = 그 사람의 담당 작업
팝업(`_member_tasks_modal.html`, `initMemberTasks`) — 프로젝트 화면에선 더블클릭 시 그 자리에서
편집 팝업, 다른 화면에선 그 작업의 프로젝트 화면(`?task=`)으로 이동.
- **프로젝트** (`/project/p/{id}`): 좌측 사이드바(공용 `_side.html`) + 우측 뷰 토글. - **프로젝트** (`/project/p/{id}`): 좌측 사이드바(공용 `_side.html`) + 우측 뷰 토글.
좌측 "내 업무"는 접이식 패널이 아니라 `/project/` 로 가는 링크다. 좌측 "내 작업"는 접이식 패널이 아니라 `/project/` 로 가는 링크다.
**이 프로젝트의 멤버는 화면 위 제목 오른쪽**에 겹친 아바타로 둔다(`.pj-title-members`) — **이 프로젝트의 멤버는 화면 위 제목 오른쪽**에 겹친 아바타로 둔다(`.pj-title-members`) —
마우스를 올리면 이름(`data-tip`, `initHoverTips` 가 위임 방식이라 동적 요소에도 붙는다), 마우스를 올리면 이름(`data-tip`, `initHoverTips` 가 위임 방식이라 동적 요소에도 붙는다),
클릭하면 그 사람이 이 프로젝트에서 맡은 업무 팝업, 우클릭(관리자)하면 제외, 옆 `+` 는 멤버 배정. 클릭하면 그 사람이 이 프로젝트에서 맡은 작업 팝업, 우클릭(관리자)하면 제외, 옆 `+` 는 멤버 배정.
좌측 트리의 업무 클릭도 페이지 이동 없이 바로 팝업(이미 로드된 전체 업무 데이터 사용). 좌측 트리의 작업 클릭도 페이지 이동 없이 바로 팝업(이미 로드된 전체 작업 데이터 사용).
좌측 맨 위 **수신함**(미확인 @태그 배지)과 **내 업무**(접이식, 기본 접힘 — 업무를 고르면 좌측 맨 위 **수신함**(미확인 @태그 배지)과 **내 작업**(접이식, 기본 접힘 — 작업을 고르면
팝업이 열리며 다시 접힌다)가 있다. 예전 화면 오른쪽에 항상 떠 있던 "내 업무" 패널은 없앴고 팝업이 열리며 다시 접힌다)가 있다. 예전 화면 오른쪽에 항상 떠 있던 "내 작업" 패널은 없앴고
이 메뉴가 그 역할을 대신한다(레이아웃도 3열 → 2열). 이 메뉴가 그 역할을 대신한다(레이아웃도 3열 → 2열).
- **달력** — FullCalendar. 업무를 시작~마감 기간으로 표시. 클릭 편집. - **캘린더** — FullCalendar. 작업을 시작~마감 기간으로 표시. 클릭 편집.
- **타임라인** — vis-timeline(간트형). 기간 있는 업무만. - **타임라인** — vis-timeline(간트형). 기간 있는 작업만. 카드의 하위 작업은 개수(`N ⤷`, 말풍선 "하위 작업 N개")만
- **보드** — 세션별 칸반. 세션은 아사나처럼 **가로로 계속 늘어난다** — 화면을 넘치면 — 펼치기 버튼은 없앴다(`tlToggleSubs`·하위 작업 카드 코드는 남아 있지만 여는 곳이 없다). 설명이 있으면 `.pj-tli-desc`. 카드는 선택 없이 바로 끌어 날짜 이동
(`itemsAlwaysDraggable`, 펼친 하위 작업 카드 포함) — `onMove` 는 끈 거리를 **일 단위로 반올림해 원래
날짜에 더한다**(시각 유지). 끄는 동안도 `snap` 옵션으로 가장 가까운 날 0시에 붙여 칸 단위로만 움직인다
(vis 기본 스냅은 반나절 단위라 칸 가운데에 걸렸다). 카드의
**작업 이름(`.pj-tli-name`)을 누르면 오른쪽 작업 창**(`timeline.on("click")`, 누른 뒤 5px 넘게
움직였으면 끌기로 보고 무시 — 끌고 놓으면 브라우저가 click 을 보낸다). 선택된 막대 위 vis 의
`.vis-drag-center` 층은 `pointer-events:none`(이름 클릭이 닿게). 처음 보기 범위는 **하루 칸 = 날짜
글자("30일 (수)") 폭**(그려서 재고, `maxMinorChars` 도 그 폭에 맞춤 — 안 그러면 이틀 간격 라벨로
바뀜). 사용자가 옮긴 구간은 localStorage `pj_tl_window2`. **축소 한계** — 칸 폭을 잴 때마다 `zoomMax` 를
"하루 = 날짜 글자 폭"이 되는 구간 길이로 두어 Ctrl+휠로 그보다 줄여지지 않는다(더 줄이면 vis 가 이틀 간격
라벨로 바꿔 날짜가 빠진다). 저장된 구간이 한계보다 넓으면 줄인다.
**첫 표시 주의** — vis 는 생성 옵션에 start/end 가 있으면 첫 `rangechanged` 가 끝난 뒤의 `changed` 에서야
루트를 `visibility:visible` 로 바꾼다. 우리가 `changed` 안에서 `setWindow` 하면 그 `rangechanged` 는 비동기로
늦게 오고 vis 는 첫 그리기 전이라 다시 그리지 않아 **타임라인이 통째로 안 보인다** → `rangechanged` 에서
아직 숨어 있으면 `redraw()`. (`changed` 안에서 바로 `redraw()` 는 vis 의 프레임당 1회 제한에 걸려 무시됨)
**날짜 라벨 색·휴일 이름** — vis 는 라벨을 xss 필터(태그만, class 불가)를 거쳐 innerHTML 로 넣으므로 색은
태그로 싣는다: 빨강(일요일·공휴일) `<em>`, 파랑(토요일) `<i>`, 공휴일 이름 `<br><abbr title=전체이름>줄인이름`
(캘린더 날짜 팝업과 같은 `HOLIDAY_SHORT`·"대체휴일" 규칙). 예전의 "그린 뒤 class 달기(paintTLDays)"는
vis 가 라벨 요소를 재사용하며 옮길 때 다른 날짜에 색이 남아 폐기. 날짜 줄은 늘 두 줄 높이(CSS `height` —
vis 가 측정용 라벨 `.vis-measure` 로 재서 년·월 줄을 내린다).
**화면 배율(`html.pj-ui-scale`)** — vis 는 크기를 `getBoundingClientRect`(zoom 적용)와
`offsetHeight`(미적용)로 섞어 재서 zoom 안에서는 하단 년·월 축이 잘리고 끌기가 마우스의 0.75배만
움직인다. 그래서 `#pj-timeline` 에서 zoom 을 `1/--pj-z` 로 되돌려 실제 배율 1로 그리고, 타임라인
CSS 의 크기는 전부 `calc(Npx * var(--tz))`(배율 모드 `--tz: .75`), vis 옵션 높이·간격도
`uiZoom()` 을 곱한다. 배율을 토글하면(resize) 다시 그린다. **타임라인 CSS 에 px 크기를 새로 넣을
때도 `var(--tz)` 를 곱한다.**
- **대시보드** — 합계 타일 4개 + 미완료 작업(섹션별)·작업 합계(완료 상태별) 차트. **"예정된 작업 합계
(담당자별)" 차트는 관리자(`is_admin`)에게만** 보인다(사람별 업무량이 드러나서). 화면 표시만 막는 것 —
작업 데이터 자체는 멤버가 원래 볼 수 있는 범위 그대로다.
- **보드** — 섹션별 칸반. `renderBoard` 는 캔버스를 통째로 다시 그리므로 **섹션 세로 스크롤(`.pj-col-body`,
섹션 id/이름 기준)·보드 가로 스크롤을 저장했다가 되돌린다**(작업 창 닫기·완료 체크·8초 갱신 후에도 보던 자리).
작업 창을 닫으면 펼친 카드의 하위 작업을 먼저 다 받은 뒤 한 번에 다시 그린다(짧아진 채 그리면 스크롤이 밀림). 섹션은 아사나처럼 **가로로 계속 늘어난다** — 화면을 넘치면
아래로 접히지 않고 보드가 가로로 스크롤된다(`.pj-board-canvas` = flex + `width:max-content`, 아래로 접히지 않고 보드가 가로로 스크롤된다(`.pj-board-canvas` = flex + `width:max-content`,
막대는 `attachHScrollIndicator` 가 직접 그린다. 예전 매이슨리 절대배치는 제거). 막대는 `attachHScrollIndicator` 가 직접 그린다. 예전 매이슨리 절대배치는 제거).
카드 안의 **담당자/마감일을 클릭하면 그 자리에서 바로 바꾼다**(담당자=멤버 목록 메뉴, 카드 안의 **담당자/마감일을 클릭하면 그 자리에서 바로 바꾼다**(담당자=멤버 목록 메뉴,
마감일=날짜 입력칸 + 지우기). 값이 없는 칩은 카드에 마우스를 올리면 흐리게 나타난다. 마감일=날짜 입력칸 + 지우기). 값이 없는 칩은 카드에 마우스를 올리면 흐리게 나타난다.
카드 드래그로 세션 이동(`PUT /api/tasks/{id}` `stage_id`, 카드 드래그로 섹션 이동(`PUT /api/tasks/{id}` `stage_id`,
멀티호밍된 업무는 `POST /api/tasks/{id}/links`). 같은 세션 안에서 드래그하면 멀티호밍된 작업은 `POST /api/tasks/{id}/links`). 같은 섹션 안에서 드래그하면
이동이 아니라 카드 순서만 바꾼다(`PUT /api/projects/{id}/stages/{stage_id}/tasks/order`, 이동이 아니라 카드 순서만 바꾼다(`PUT /api/projects/{id}/stages/{stage_id}/tasks/order`,
세션 재정렬과 같은 패턴 — `tasks.sort_order`를 그 세션 소속만 0부터 재배정). 섹션 재정렬과 같은 패턴 — `tasks.sort_order`를 그 섹션 소속만 0부터 재배정).
세션 컬럼 자체도 드래그로 재정렬(§1-1). 섹션 컬럼 자체도 드래그로 재정렬(§1-1).
- **리스트** — 표. - **목록** — 표.
- 4개 뷰 모두 툴바의 "이 프로젝트"/"전체 프로젝트" 스코프 토글을 따른다(§1-1). - 4개 뷰 모두 툴바의 "이 프로젝트"/"전체 프로젝트" 스코프 토글을 따른다(§1-1).
- 라이브러리는 현재 CDN 로드(스켈레톤). 추후 `app/static/vendor/` self-host 권장. - 라이브러리는 현재 CDN 로드(스켈레톤). 추후 `app/static/vendor/` self-host 권장.
@@ -126,7 +251,7 @@
- `app/mail.py` `send_email(...)` — `SMTP_HOST` 있어야 발송, 없으면 skip. STARTTLS/SSL/평문 지원. - `app/mail.py` `send_email(...)` — `SMTP_HOST` 있어야 발송, 없으면 skip. STARTTLS/SSL/평문 지원.
- env: `SMTP_HOST/PORT/USER/PASSWORD/FROM/TLS`, 수신자 `PROJECT_NOTIFY_EMAIL`(쉼표, 비우면 admin 전원). - env: `SMTP_HOST/PORT/USER/PASSWORD/FROM/TLS`, 수신자 `PROJECT_NOTIFY_EMAIL`(쉼표, 비우면 admin 전원).
- 트리거: 업무 신규 배정(생성/수정 시 담당자 변경) · 완료단계 진입. `BackgroundTasks` 비동기, 실패는 로그만. - 트리거: 작업 신규 배정(생성/수정 시 담당자 변경) · 완료단계 진입. `BackgroundTasks` 비동기, 실패는 로그만.
## 5. 배포 ## 5. 배포
@@ -140,8 +265,8 @@ docker exec -i postgres-db psql -U postgres -v app_password="$APP_PWD" \
# PROJECT_DB_URL=postgresql://project_app:<APP_PWD>@postgres-db:5432/project_db # PROJECT_DB_URL=postgresql://project_app:<APP_PWD>@postgres-db:5432/project_db
# (메일 쓰려면 SMTP_* 추가) # (메일 쓰려면 SMTP_* 추가)
# 3) 마이그레이션 002~007 적용 (첨부/알림, 세션 생성자·하위업무·멀티호밍, # 3) 마이그레이션 002~008 적용 (첨부/알림, 섹션 생성자·하위 작업·멀티호밍,
# 업무 시간, 세션 색상, 댓글 첨부, @태그) # 작업 시간, 섹션 색상, 댓글 첨부, @태그)
docker exec -i postgres-db psql -U postgres -d project_db \ docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_002_attachments_notifications.sql < scripts/sql/project_db_002_attachments_notifications.sql
docker exec -i postgres-db psql -U postgres -d project_db \ docker exec -i postgres-db psql -U postgres -d project_db \
@@ -154,7 +279,20 @@ docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_005_comment_attachments.sql < scripts/sql/project_db_005_comment_attachments.sql
docker exec -i postgres-db psql -U postgres -d project_db \ docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_006_mentions.sql < scripts/sql/project_db_006_mentions.sql
docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_007_live_version.sql docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_007_live_version.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_008_followers_reminders_search.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_009_stage_default_assignee.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_010_trash.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_011_project_icon.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_012_comment_replies_reactions.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_013_goals.sql
# 4) 재배포 (git pull 후 반드시 --build) # 4) 재배포 (git pull 후 반드시 --build)
cd /opt/www/main && docker compose up -d --build web cd /opt/www/main && docker compose up -d --build web
@@ -167,7 +305,7 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
## 5-1. 설명란 링크 · @태그(멘션) ## 5-1. 설명란 링크 · @태그(멘션)
- **설명란 링크** — 업무 편집 팝업의 설명란(contenteditable)에 웹주소를 붙여넣으면 - **설명란 링크** — 작업 편집 팝업의 설명란(contenteditable)에 웹주소를 붙여넣으면
자동으로 `<a target="_blank" rel="noopener noreferrer">` 가 된다(`linkifyToHtml`). 자동으로 `<a target="_blank" rel="noopener noreferrer">` 가 된다(`linkifyToHtml`).
contenteditable 안에서는 브라우저가 링크를 기본으로 열지 않으므로 클릭을 직접 받아 contenteditable 안에서는 브라우저가 링크를 기본으로 열지 않으므로 클릭을 직접 받아
새 탭으로 연다. 서식바의 링크 버튼으로 만든 링크도 같은 속성으로 맞춘다 새 탭으로 연다. 서식바의 링크 버튼으로 만든 링크도 같은 속성으로 맞춘다
@@ -179,66 +317,269 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
서버는 설명란은 **저장될 HTML 에서 직접** 이메일을 뽑고(`store.extract_mentions_from_html`, 서버는 설명란은 **저장될 HTML 에서 직접** 이메일을 뽑고(`store.extract_mentions_from_html`,
화면이 보낸 목록을 믿지 않는다), 댓글은 받은 목록을 정규화해 쓴다. 화면이 보낸 목록을 믿지 않는다), 댓글은 받은 목록을 정규화해 쓴다.
새로 태그된 사람에게만 알림(`type=mention`)이 생긴다 — 같은 자리에서 중복 저장 안 됨. 새로 태그된 사람에게만 알림(`type=mention`)이 생긴다 — 같은 자리에서 중복 저장 안 됨.
- **수신함** (`/project/inbox`) — 위쪽 "나를 태그한 업무"(업무 1건당 1행, 최근 태그순. - **수신함** (`/project/inbox`) — 위쪽 "나를 태그한 작업"(작업 1건당 1행, 최근 태그순.
누르면 확인 처리, "열기"는 `?task=` 로 그 업무 편집 팝업까지 연다) + 아래쪽 "알림". 누르면 확인 처리, "열기"는 `?task=` 로 그 작업 편집 팝업까지 연다) + 아래쪽 "알림".
내 업무·프로젝트 화면과 같은 2단 레이아웃(좌측 공용 사이드바 + 우측 프레임)이다. 내 작업·프로젝트 화면과 같은 2단 레이아웃(좌측 공용 사이드바 + 우측 프레임)이다.
API: `GET /api/mentions`, `GET /api/mentions/unread-count`, `POST /api/mentions/read` API: `GET /api/mentions`, `GET /api/mentions/unread-count`, `POST /api/mentions/read`
(`task_id` 주면 그 업무만, 없으면 전부). (`task_id` 주면 그 작업만, 없으면 전부).
006 마이그레이션이 아직 안 돌아간 환경에서도 화면이 죽지 않게 조회/기록은 모두 감싸져 있다. 006 마이그레이션이 아직 안 돌아간 환경에서도 화면이 죽지 않게 조회/기록은 모두 감싸져 있다.
## 5-2. 업무 공유 링크 (퍼머링크) ## 5-2. 작업 공유 링크 (퍼머링크)
- 업무 편집 팝업의 **공유** 버튼(`#pj-share-task`)이 `{origin}/project/t/{task_id}` 를 - 작업 편집 팝업의 **공유** 버튼(`#pj-share-task`)이 `{origin}/project/t/{task_id}` 를
클립보드에 복사한다. 보드/리스트/달력/타임라인 카드 우클릭과 내 업무 목록 클립보드에 복사한다. 보드/목록/캘린더/타임라인 카드 우클릭과 내 작업 목록
우클릭의 "링크 복사"도 같은 함수(`shareTaskLink`)를 쓴다. 우클릭의 "링크 복사"도 같은 함수(`shareTaskLink`)를 쓴다.
`navigator.clipboard` 는 https 에서만 동작하므로 임시 textarea 폴백을 두고, `navigator.clipboard` 는 https 에서만 동작하므로 임시 textarea 폴백을 두고,
둘 다 실패하면 주소를 `prompt` 로 보여준다. 둘 다 실패하면 주소를 `prompt` 로 보여준다.
- `GET /project/t/{task_id}` 는 권한만 확인하고 `/project/p/{project_id}?task=` 로 - `GET /project/t/{task_id}` 는 권한만 확인하고 `/project/p/{project_id}?task=` 로
넘긴다(화면은 기존 경로가 그린다 — 업무가 다른 프로젝트로 옮겨가도 링크는 산다). 넘긴다(화면은 기존 경로가 그린다 — 작업이 다른 프로젝트로 옮겨가도 링크는 산다).
- 로그인 전이면 `/login?next=/project/t/{id}` 로 보내 **로그인 후 그 업무로 복귀**. - 로그인 전이면 `/login?next=/project/t/{id}` 로 보내 **로그인 후 그 작업으로 복귀**.
- `project` 모듈 권한 없음 / 업무 없음 / 그 프로젝트 멤버 아님 → 각각 403·404·403 - `project` 모듈 권한 없음 / 작업 없음 / 그 프로젝트 멤버 아님 → 각각 403·404·403
안내 화면(`denied.html`). 즉 **주소를 알아도 멤버가 아니면 못 본다**. 안내 화면(`denied.html`). 즉 **주소를 알아도 멤버가 아니면 못 본다**.
- 하위 업무 링크는 부모 업무 팝업으로 연다(하위 업무는 목록에 따로 안 뜬다). - 하위 작업 링크도 그 하위 작업 자신의 팝업으로 연다(목록엔 없으니 `GET /api/tasks/{id}` 로 받아 연다).
- `?task=` 로 들어왔는데 그 업무가 화면 목록에 없으면(완료 세션 필터 등) - `?task=` 로 들어왔는데 그 작업이 화면 목록에 없으면(완료 섹션 필터 등)
`GET /api/tasks/{id}` 로 그 업무만 받아 팝업을 연다. `GET /api/tasks/{id}` 로 그 작업만 받아 팝업을 연다.
## 6. 댓글 · 첨부 · 알림센터 · 세션 편집 (구현됨) ## 6. 댓글 · 첨부 · 수신함 · 섹션 편집 (구현됨)
- **댓글** `task_comments` — 업무 모달 하단. 등록/삭제(본인·관리자). 새 댓글 시 관련자 인앱 알림. - **댓글** `task_comments` — 작업 모달 하단. 등록/삭제(본인·관리자). 새 댓글 시 관련자 인앱 알림.
- **업무 편집 팝업** — 버튼 줄(공유·완료·삭제·취소·저장)은 **팝업 맨 위에 고정** - **작업 편집 팝업** — 버튼 줄(공유·완료·삭제·저장 상태·패널 접기)은 **팝업 맨 위에 고정**
(`.pj-modal-actions-top`) — 카드가 flex column 이고 `.pj-modal-body` 만 스크롤하므로 sticky 없이 고정된다(sticky 는 카드 padding 안쪽에 붙어 바가 밀려 내려오고 제목을 덮었다). 설명/하위업무가 길어도 스크롤 없이 저장·취소한다. (`.pj-modal-actions-top`) — 카드가 flex column 이고 `.pj-modal-body` 만 스크롤하므로 sticky 없이 고정된다(sticky 는 카드 padding 안쪽에 붙어 바가 밀려 내려오고 제목을 덮었다). 저장 버튼은 없다 — 실시간 저장(§6-6).
그 아래 윗줄은 메타(좌) + 첨부/연결/댓글(우) 2단, 다시 그 아래 **설명란**과 댓글 입력칸은 아사나처럼 **창 맨 아래 고정**(`#pj-comment-dock`) — `.pj-modal-body` 바깥 형제라서
**하위 업무**가 각각 팝업 너비 전체를 쓰는 별도 행(`.pj-desc-block` / `.pj-subtask-full`, 끝까지 스크롤해도 마지막 내용이 입력칸 위에서 멈춘다(sticky 아님). 새 작업(id 없음)이면 숨긴다.
그리드 `1 / -1`). 하위 업무는 제목 왼쪽 체크박스로 완료를 토글하고, 완료된 줄은 그 아래 메타(담당자·섹션·우선순위·마감일 한 줄 — 마감일은 캘린더 아이콘 버튼, 좁으면 2×2 | 협업자), 다시 그 아래 **설명란**과
반투명(50%) + 취소선. 좁은 화면과 "새 업무"(compact)에서는 단일 컬럼으로 흐른다. **하위 작업**가 각각 팝업 너비 전체를 쓰는 별도 행(`.pj-desc-block` / `.pj-subtask-full`,
- **첨부** `task_attachments` — 업무 모달. 파일 업로드(최대 20MB)/다운로드/삭제. 실제 파일은 `DATA_DIR/project/<task_id>/<uuid>.<ext>`, DB엔 메타만. 첨부 디렉토리는 운영 볼륨(DATA_DIR)에 저장돼 재배포에도 보존. 설명란 이미지 삽입도 이 표를 재사용(§1-1). 그리드 `1 / -1`). 하위 작업은 제목 왼쪽 체크박스로 완료를 토글하고, 완료된 줄은
- **세션 편집** — 보드 칸반 헤더에서 이름변경/완료토글/삭제, 트레일링 "+ 세션 추가", **컬럼 드래그로 순서 변경**. `PUT .../stages/order`, `PUT .../stages/{id}`, 삭제는 만든 사람만. 반투명(50%) + 취소선. 좁은 화면과 "새 작업"(compact)에서는 단일 컬럼으로 흐른다.
- **알림센터(인앱)** `project_notifications` — 배정/완료/댓글 시 수신자별 알림 생성. 우측 상단 벨(미읽음 배지) → `/project/inbox`. 항목 클릭=읽음, "모두 읽음". 본인 행동은 알림 제외. - **첨부** `task_attachments` — 작업 모달. 파일 업로드(최대 20MB)/다운로드/삭제. 실제 파일은 `DATA_DIR/project/<task_id>/<uuid>.<ext>`, DB엔 메타만. 첨부 디렉토리는 운영 볼륨(DATA_DIR)에 저장돼 재배포에도 보존. 설명란 이미지 삽입도 이 표를 재사용(§1-1).
- 마이그레이션: `scripts/sql/project_db_002_attachments_notifications.sql` (첨부·알림 테이블 + 권한), `scripts/sql/project_db_003_sections_subtasks_links.sql` (세션 생성자·하위업무·멀티호밍). - **섹션 편집** — 보드 칸반 헤더(아사나식): 이름 바로 오른쪽에 작업 수(숫자만), 오른쪽 끝 **+**(작업 추가)·
**…**(메뉴: 작업 추가 / 이름 변경 / 섹션 편집(색상·기본 담당자) / 섹션 작업 모두 완료 / 완료 섹션 지정·해제 / 삭제,
헤더 우클릭도 같은 메뉴). 이름 클릭 = 그 자리 이름 변경. 트레일링 "+ 섹션 추가", **컬럼 드래그로 순서 변경**. `PUT .../stages/order`, `PUT .../stages/{id}`, 삭제는 만든 사람만.
- **수신함(인앱)** `project_notifications` — 배정/완료/댓글 시 수신자별 알림 생성. 우측 상단 벨(미읽음 배지) → `/project/inbox`. 항목 클릭=읽음, "모두 읽음". 본인 행동은 알림 제외.
- 마이그레이션: `scripts/sql/project_db_002_attachments_notifications.sql` (첨부·알림 테이블 + 권한), `scripts/sql/project_db_003_sections_subtasks_links.sql` (섹션 생성자·하위 작업·멀티호밍).
## 6-1. 실시간 반영 · 성능 ## 6-1. 실시간 반영 · 성능
- **live-version** — `GET /api/live-version` 이 돌려주는 값이 바뀌면 화면이 조용히 다시 받는다. - **live-version** — `GET /api/live-version` 이 돌려주는 값이 바뀌면 화면이 조용히 다시 받는다.
007 마이그레이션의 문장 단위 트리거가 projects·members·stages·tasks·comments·attachments· 007 마이그레이션의 문장 단위 트리거가 projects·members·stages·tasks·comments·attachments·
links(+ mentions INSERT) 변경 때마다 `project_live_version.version` 을 1 올린다 — 삭제·세션 links(+ mentions INSERT) 변경 때마다 `project_live_version.version` 을 1 올린다 — 삭제·섹션
이름변경·첨부 추가까지 감지되고, 서버는 PK 한 줄만 읽는다. 007 미적용이면 예전 MAX() 방식 이름변경·첨부 추가까지 감지되고, 서버는 PK 한 줄만 읽는다. 007 미적용이면 예전 MAX() 방식
(삭제 감지 못함)으로 자동 폴백하고 5분마다 다시 확인한다. (삭제 감지 못함)으로 자동 폴백하고 5분마다 다시 확인한다.
- 화면은 열자마자 기준값을 잡고, 탭이 안 보이는 동안(`document.hidden`)은 묻지 않는다. - 화면은 열자마자 기준값을 잡고, 탭이 안 보이는 동안(`document.hidden`)은 묻지 않는다.
바뀌면 `GET /api/projects/{id}/snapshot`(업무+세션+멤버 한 번에)으로 이 프로젝트 맥락의 바뀌면 `GET /api/projects/{id}/snapshot`(작업+섹션+멤버 한 번에)으로 이 프로젝트 맥락의
행을 통째로 바꿔 끼운다(삭제된 업무도 사라짐). 행을 통째로 바꿔 끼운다(삭제된 작업도 사라짐).
- 프로젝트 화면은 접근 가능한 모든 프로젝트의 업무/세션을 각각 **쿼리 한 번**으로 읽는다 - 프로젝트 화면은 접근 가능한 모든 프로젝트의 작업/섹션을 각각 **쿼리 한 번**으로 읽는다
(`list_tasks_for_projects`, `list_stages_for_projects`). 행마다 `context_project_id`· (`list_tasks_for_projects`, `list_stages_for_projects`). 행마다 `context_project_id`·
`is_linked`·`home_stage_id` 가 붙는다 — 연결 업무 행의 `stage_id` 는 연결된 쪽 세션이고, `is_linked`·`home_stage_id` 가 붙는다 — 연결 작업 행의 `stage_id` 는 연결된 쪽 섹션이고,
업무 편집 팝업의 "세션" 선택은 항상 `home_stage_id`(원래 소속)를 쓴다. 작업 편집 팝업의 "섹션" 선택은 항상 `home_stage_id`(원래 소속)를 쓴다.
- 라우터 핸들러는 전부 `def`(sync) — DB 드라이버가 동기라 `async def` 면 쿼리 동안 이벤트 - 라우터 핸들러는 전부 `def`(sync) — DB 드라이버가 동기라 `async def` 면 쿼리 동안 이벤트
루프 전체가 멈춘다. 첨부 업로드는 한도+1 바이트까지만 읽는다. 루프 전체가 멈춘다. 첨부 업로드는 한도+1 바이트까지만 읽는다.
- 첨부 `/inline` 은 png/jpeg/gif/webp/bmp 만 화면에 띄우고 나머지(html·svg 등)는 다운로드로 - 첨부 `/inline` 은 png/jpeg/gif/webp/bmp 만 화면에 띄우고 나머지(html·svg 등)는 다운로드로
내려준다(`X-Content-Type-Options: nosniff` + CSP sandbox). 업무/프로젝트/댓글 삭제 시 내려준다(`X-Content-Type-Options: nosniff` + CSP sandbox). 작업/프로젝트/댓글 삭제 시
디스크 첨부도 같이 지운다. 디스크 첨부도 같이 지운다.
- 설명란 sanitizer 는 URL 을 허용 목록(http/https/mailto/tel/상대경로, img 는 png·jpeg 등 - 설명란 sanitizer 는 URL 을 허용 목록(http/https/mailto/tel/상대경로, img 는 png·jpeg 등
data: 이미지)으로 검사한다 — 금지 목록은 `jav&#x09;ascript:` 로 우회됐다. data: 이미지)으로 검사한다 — 금지 목록은 `jav&#x09;ascript:` 로 우회됐다.
## 6-2. 검색 · 필터 · 정렬
- **전체 검색** — 좌측 사이드바 맨 위 검색창(`#pj-global-search`, 어디서든 `/` 키). 2글자 이상이면
`GET /api/search?q=` 로 내가 볼 수 있는 프로젝트의 작업(하위 작업 포함)를 제목·설명·댓글에서
찾는다. 설명은 HTML 이라 DB 에서 넉넉히 가져와 본문 텍스트로 다시 확인한다(태그 이름에만
걸린 결과 제거). 결과에 "설명/댓글" 어디서 걸렸는지와 미리보기. 누르면 `/project/t/{id}`.
008 의 pg_trgm GIN 인덱스(title·description·comment body)가 `ILIKE '%…%'` 를 받쳐준다.
- **필터 바** — 프로젝트 화면(`#pj-filterbar`): 찾기(제목·설명·담당자·섹션) · 상태 · 담당자
(나/없음/특정인) · 마감(지남/오늘/이번 주/없음) · 우선순위 · 정렬(기본/마감일/우선순위/제목/
담당자/최근 생성). 서버 재조회 없이 `visibleTasks()`(스코프 → 필터 → 정렬)에서 거르므로
보드·목록·캘린더·타임라인·대시보드 모두에 적용된다. 프로젝트별로 localStorage 에 기억.
필터나 정렬이 켜져 있으면 보드 카드 순서 드래그는 막는다(가려진 카드 때문에 순서가 어긋남).
목록은 열 제목 클릭 정렬이 우선. 내 작업 화면에도 찾기·마감·우선순위 필터(`#pj-mt-filterbar`).
공용 로직: `taskMatchesFilter` / `sortTasksBy`.
## 6-3. 협업자 · 마감 알림
- **협업자**(`task_followers`, 008) — 아사나의 협업자. 작업 팝업 메타 목록의 "협업자" 줄에서
추가(+ → 프로젝트 멤버)/빼기(×)/내 팔로우 토글. 즉시 저장(저장 버튼과 무관).
자동 팔로우: 만든 사람 · 담당자(배정 시) · 댓글 단 사람 · @태그된 사람. 008 이 기존 작업에도
같은 규칙으로 백필한다. API: `GET/POST /api/tasks/{id}/followers`(body `email`, 없으면 나),
`DELETE /api/tasks/{id}/followers/{email}` — 다른 사람은 그 프로젝트 멤버·owner·관리자만 추가 가능.
- **알림 수신자 변경** — 완료·댓글 인앱 알림은 이제 "담당자 + 협업자"에게만 간다(예전: 프로젝트
멤버 전원). 008 미적용이면 예전 방식으로 폴백.
- **마감 알림**(`reminders.py`) — 웹 프로세스 안 데몬 스레드가 5분마다 깨어, 영업일(주말·
`KR_HOLIDAYS` 제외) 설정 시각(`PROJECT_REMINDER_HOUR`, 기본 9시 KST) 이후 하루 한 번 돈다.
`due_soon`(다음 영업일까지 마감 — 금요일이면 주말·월요일분까지) · `due_today` · `overdue`
(최근 7일 이내 마감분). 수신자는 담당자, 없으면 협업자. `task_reminders` UNIQUE(작업·종류·
마감일·수신자)로 한 번만 — 재기동·중복 실행에도 안전, 마감일을 바꾸면 다시 알린다.
`PROJECT_REMINDER_EMAIL=true` 면 사람별 요약 메일 1통(SMTP 필요). `PROJECT_REMINDERS=false` 로 끔.
## 6-4. 섹션 기본 담당자 (마이그레이션 009)
- `project_stages.default_assignee_email`(TEXT, '' = 미지정). 섹션 편집 창(✎ / "+ 섹션 추가")의
"기본 담당자" 에서 지정 — 후보는 작업 담당자와 같다(프로젝트 멤버 + owner, 서버도 검증).
- **자동 배정 규칙**(`db._stage_default_assignee`) — 담당자가 **비어 있는** 작업만:
· 그 섹션에 작업 생성(`create_task`, 하위 작업 제외)
· 다른 섹션에서 그 섹션으로 이동(`update_task` 의 `stage_id` 변경 — 카드 드래그·작업 팝업 섹션 변경)
이미 담당자가 있으면 그대로. 지정된 사람이 프로젝트 멤버에서 빠졌으면 무시.
자동 배정도 일반 배정과 같이 활동이력·협업자·인앱 알림·메일이 나간다(`_newly_assigned`).
멀티호밍으로 연결된 프로젝트 쪽 섹션 이동(`/links`)은 대상 아님.
- 보드 섹션 머리 이름 옆에 기본 담당자 아바타(작게, 툴팁). 새 작업 팝업은 그 섹션 기본 담당자를 미리 채운다.
- 009 미적용이어도 앱은 동작 — 조회는 `to_jsonb(행)->>'default_assignee_email'` 로 컬럼 유무와
무관, 지정 시도만 503("마이그레이션 009 필요"). 화면은 기본 담당자가 바뀐 경우에만 필드를 보낸다.
## 6-5. 휴지통 (마이그레이션 010)
- 작업을 지우면(하위 작업 CASCADE 포함) **지우기 직전 스냅샷**을 같은 트랜잭션에서 `project_trash.payload`(JSONB)에
남긴 뒤 예전처럼 삭제한다(`db.delete_task` → `(ids, trash_id)`). 스냅샷 = `tasks` + 딸린 테이블
`task_comments · task_followers · task_mentions · task_attachments · task_project_links · project_activity ·
task_reminders`(`TRASH_CHILD_TABLES`). 알림(`project_notifications`)은 되살리면 수신함이 옛 알림으로 차서 제외.
모든 조회 쿼리에 "삭제됨" 필터를 넣는 소프트 삭제 대신 이 방식 — 기존 화면·쿼리를 안 건드린다.
- 첨부 실물은 지우지 않고 `DATA_DIR/project/_trash/<trash_id>/<task_id>/` 로 옮긴다(복구 시 되돌림).
- **보관 3개월**(`expires_at`). 휴지통 화면을 열거나 작업을 지울 때 만료분을 영구 삭제(`_purge_trash`).
- **관리자 전용**: 좌측 "휴지통" 메뉴·`/project/trash` 화면·`POST /project/api/trash/{id}/restore` 모두 `is_admin`.
복구는 원래 id 그대로(`restore_trash`): 같은 id 가 이미 있으면 거부, 프로젝트가 지워졌으면 거부, 하위 작업만
지웠는데 상위가 없으면 거부(상위 먼저 복구). 지워진 섹션은 섹션 없이, 지워진 프로젝트를 가리키는 연결/이력은 뺀다.
복구하면 휴지통 행은 지운다.
- 화면: 삭제 확인은 `confirmTaskDelete` 하나 — 하위 작업이 있으면 "하위 작업 N개까지 모두 삭제"를 분명히 묻는다.
카드의 하위 작업 줄 우클릭 = 열기 / 완료 / **하위 작업 삭제**. 삭제 후 토스트 "휴지통으로 옮겼습니다".
- 010 미적용이면 휴지통 없이 예전처럼 영구 삭제(휴지통 화면에 안내).
- 프로젝트 삭제(작업 전체 CASCADE)와 댓글 삭제는 아직 휴지통 대상이 아니다.
## 6-6. 작업 창 실시간 저장 · 제목 줄바꿈 · 프로젝트 제목 바로 수정
- **저장 버튼 없음**(아사나식). 칸마다 바로 `PUT /api/tasks/{id}` 로 **그 필드만** 보낸다(`saveField`) —
제목: blur/Enter(빈 값이면 되돌림) · 설명: 입력 멈춤 1.2초·blur(이미지 업로드 중이면 미룸) ·
담당자/섹션/우선순위/마감일: change 즉시. 요청은 `saveChain` 한 줄로 순서 보장, 보낼 값·id 는 부르는
순간 잡으므로 저장 중 다른 작업을 열어도 안전. 닫기·다른 작업 열기 직전 `flushAutoSave`. 버튼 줄에
"저장 중… / ✓ 저장됨 / 저장 실패" 표시(`#pj-autosave-state`).
- **새 작업**은 제목이 처음 생기는 순간 지금 칸 값으로 `POST` → 기존 작업 화면(댓글·첨부·하위 작업)으로
바꿔 연다. 그 사이 더 친 제목·설명은 이어서 저장. 제목 없이 닫으면 만들지 않는다.
- 섹션을 옮기면 서버가 기본 담당자를 넣거나 완료 처리할 수 있어 응답으로 담당자 칸·완료 버튼을 다시 맞춘다.
- 작업 제목칸은 `textarea`(자동 높이, `fitTitleHeight`) — 긴 제목은 다음 줄로. Enter·붙여넣은 줄바꿈은 막는다.
- 프로젝트 화면 제목 알약(`.pj-pill-name`)은 마우스 올림 → 테두리, 클릭 → contenteditable 로 이름 수정
(`PUT /api/projects/{id}` `{name}`, Enter/blur 저장·Esc 취소). `can_manage` 인 사람만.
## 6-7. 댓글 답글 · 이모티콘 반응 · 완료 이력 · @칩 (마이그레이션 012)
- `task_comments.parent_id`(답글, 한 단계 — 답글의 답글도 원 댓글에 붙음, 원 댓글 삭제 시 CASCADE) +
`task_comment_reactions`(comment_id·user_email·emoji PK, `task_id` 는 휴지통 스냅샷용 —
`TRASH_CHILD_TABLES` 에 포함). 012 트리거로 반응도 live-version 을 올린다.
- API: `GET /api/tasks/{id}/comments` → `{comments(+reactions), events, features}` —
`events` 는 `project_activity` 의 완료(`completed`) 이력 — **작업이 지금 완료 상태일 때 마지막 1건만**
(완료 취소하면 사라짐, 이력 행은 보존), 댓글 수에는 안 셈. `features` 는 012 적용 여부.
`POST /api/tasks/{id}/comments` 에 `parent_id`. `POST /api/comments/{id}/reactions` `{emoji}` = 켜기/끄기 토글.
- 화면: 작업 창 댓글은 시간순(댓글 + "OO 님이 이 작업을 완료했습니다" 줄), 답글은 원 댓글 아래 들여쓰기 +
답글 입력칸. 마우스 올림 도구 모음(👍 👀 🙌 ✅ · 반응 추가(이모티콘 창) · 답글 · 수정 · 삭제).
댓글 대화창은 말풍선 위 인용으로 답글 표시, 입력칸 위 "OO 님에게 답글" 줄.
본문의 `@아이디` 는 사용자 목록(`/api/all-users`)과 맞으면 아이콘+이름 칩(`commentBodyHtml`).
- 012 미적용이면 답글·반응 버튼이 숨겨지고, API 는 503 "마이그레이션 012 필요". 완료 이력·@칩은 012 없이도 동작.
## 6-8. 수신함 오른쪽 작업 창 · 화면 배율
- 수신함의 "확인"(예전 "이동"/"열기")은 페이지를 떠나지 않고 오른쪽 패널(`.pj-inbox-panel`)에 작업 창만 띄운다.
프로젝트 화면을 `?task={id}&embed=1` 로 iframe 에 열고, `html.pj-embed` 가 작업 창 외에는 숨긴다.
작업 창을 닫으면 iframe 이 `postMessage({type:"pj-embed-close"})` → 패널 닫힘.
embed 에서만 작업 창 맨 위에 "프로젝트로 이동"(`#pj-goto-project`) — `window.top` 을 그 프로젝트 화면(`?task=`)으로. Ctrl+클릭은 새 탭(예전처럼 이동).
- 화면 배율 토글(상단 바 `fit_screen`, `_help_btn.html`) — `html.pj-ui-scale` 이면 `.erp-app` 에 `zoom: .75`
(2880×1620·200% = CSS 폭 1440px 에서 1920 기준 화면처럼). zoom 안에서 줄어드는 `vh` 높이는 배율로 나눠
되돌린다. 팝업은 전부 `body` 에 붙어 배율 밖이라 좌표 보정 불필요(전체 검색 결과창도 body 로 옮김),
배율 안에서 마우스 거리로 크기를 바꾸는 작업 창 너비 조절만 `uiZoom()` 으로 나눈다. localStorage `pj_ui_scale`.
## 6-9. 연간 목표 (마이그레이션 013)
- 좌측 사이드바 개인 메뉴 맨 아래 **목표**(`_side.html` `#pj-side-goal`) — 누르면 바로 아래 연도 목록이 접혔다 펴진다
(`initGoalSide`, localStorage `pj_goal_open`, 목표 화면에선 항상 펼침). 연도 목록은 `router._goal_years_nav`
(`goal_years` 최근 연도 먼저 + **올해는 항상**, 013 미적용이면 올해만) — 사이드바를 그리는 모든 화면 컨텍스트에 `goal_years`.
- 연도를 누르면 `/project/goals/{연도}`(`goals.html`) — 스프레드시트 같은 한 표. 머리 줄(연간·1~12월)과 왼쪽 두 칸은 고정,
이번 달 열 강조. 월 칸 너비 85px·연간 90px(여백 포함, `box-sizing: border-box`), 머리·왼쪽 이름 가운데 정렬(왼쪽 이름은 세로도 가운데 — 관리자 도구는 칸 아래에 떠 있는 막대라 자리를 차지하지 않음). 왼쪽 이름 두 칸(구분·항목)은 머리 칸 오른쪽 끝을 끌어 너비 조절(48~320px, 더블클릭 = 72px) — 브라우저별 localStorage `pj_goal_col_w`, CSS 변수 `--goal-c1-w`·`--goal-c2-w`.
- **숫자 지표** `goal_metrics`(year·metric `sales|roas`·kind `target|actual`·month 1~12·value NUMERIC(18,2)) —
매출 목표/실적/달성, 로아스 목표/실적. 매출 연간 = 월 합계, 달성률 = 실적÷목표(월별, 연간은 실적이 있는 달의 목표 합계 대비)는
화면에서 계산(저장 안 함). 매출 단위 글자는 `goal_years.sales_unit`.
- **업무 영역** `goal_areas`(연도별, 이름·색 `store.GOAL_AREA_COLORS` 연한 16색 + 색 없음(빈 값 = 흰 배경)·순서) → `goal_rows`(영역 안 줄, 최소 1줄 — 마지막 줄은
못 지움) → `goal_cells`(row × month, **0 = 연간**, 빈 글 = 행 삭제). 영역 색이 줄 전체 배경.
- 권한: 조회는 `project` 권한자 전원, **입력·구조 변경은 관리자만**(`_require_admin`, 화면도 관리자에게만 입력칸·도구).
- 연도 추가(`POST /api/goals/years {year}`)는 가장 가까운 이전 연도(없으면 다음 연도)의 영역·줄 구조를 글 없이 복사,
목표가 하나도 없으면 `store.DEFAULT_GOAL_AREAS`(상품·마케팅·컨텐츠·유통[콜라보·인플·쿠팡·기타]). 없는 연도 화면은
관리자에게 "목표 만들기" 버튼(GET 에서 자동 생성하지 않는다). 연도 삭제는 연도를 직접 입력해야 진행(CASCADE 전부 삭제).
- API(전부 관리자): `PUT /api/goals/{y}` `{sales_unit}` · `DELETE /api/goals/{y}` · `PUT /api/goals/{y}/metrics`
`{metric,kind,month,value}`(빈값 = 지움, 응답 `label` 은 쉼표 표기) · `POST /api/goals/{y}/areas` `{name,color}` ·
`PUT|DELETE /api/goals/areas/{id}` · `POST /api/goals/areas/{id}/move` `{direction:-1|1}` · `POST /api/goals/areas/{id}/rows` ·
`PUT|DELETE /api/goals/rows/{id}` · `POST /api/goals/rows/{id}/move` · `PUT /api/goals/rows/{id}/cells/{month}` `{body}`.
013 미적용 503, 없는 대상 404, 입력 오류 400(`_goal_call`).
- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc 취소), 글 칸은 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive)에 저장,
저장되면 칸 테두리가 잠깐 초록. 영역/줄 추가·이름·순서·삭제는 저장 뒤 새로고침(스크롤 위치 sessionStorage 로 되살림),
영역 색은 팝업(body 에 붙임)에서 바로 바뀜. 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지).
- 추후: 매출 실적을 실적 모듈(`performance_db`)에서 월별로 자동으로 채우기.
## 6-10. 권한·저장 안전장치 (2026-09-30 점검 반영, 새 마이그레이션·환경변수 없음)
**권한 공통 기준 — `access.py`** (라우터·마감 알림이 같은 규칙)
- 프로젝트 관리 = 관리자 · owner · 배정 멤버, 모두 `project` 모듈 권한이 있어야 한다(`can_manage_project`).
- 작업 권한 `task_access`: **FULL** = 원 소속 프로젝트 관리 가능 / **READ** = 원 소속 권한은 없지만 이 작업(또는 상위 작업)이
연결된 프로젝트를 관리 가능(`task_link_scope`, 재귀 CTE) / 없음. 라우터 `_require_task(write=)` 가 FULL/READ 를 검사.
- READ 로 되는 것: 작업 상세(`access:"read"`)·하위 작업 목록·댓글 목록·첨부 목록/다운로드/미리보기·공유 링크(연결된 프로젝트
화면으로 이동). 안 되는 것: 제목·설명·담당자·완료·섹션(원 소속)·댓글/답글/반응·첨부 추가/삭제·협업자·삭제·하위 작업 변경.
이미 연결된 작업을 연결된 프로젝트 안에서 섹션 이동(`POST /links`)은 예전처럼 허용, 새 연결은 양쪽 권한. 상세의 `links` 는
내가 볼 수 있는 프로젝트만(다른 연결 프로젝트 이름도 숨김), `followers` 는 READ 면 null. 원 소속의 다른 작업·멤버는 계속 403.
- 목록·배지·알림: 내 작업(`_my_visible_tasks`/`_my_open_count`)·수신함 태그(`_safe_mentions`)·알림(`_visible_notifications`)을
지금 권한으로 거른다(FULL 또는 READ). 기존 기록은 지우지 않는다.
- 알림·메일·멘션 수신자: `filter_recipients` — 지금 그 작업을 볼 수 있는 등록 사용자만(담당자·협업자여도 권한을 잃었으면 제외).
@태그는 볼 수 없는 사람(비멤버·권한 회수·미등록 이메일)을 기록·알림·자동 협업자 등록 없이 건너뛰고 응답 `mention_skipped` 로
알려 준다(payload 에 이메일을 직접 넣어도 같음). 멘션이 권한을 만들지 않는다. 태그 후보 `GET /api/all-users?task_id=`.
- 새 담당자는 그 프로젝트를 볼 수 있는 사람만(`_check_assignee`, 400). 비우거나 예전 값 유지는 허용.
- 댓글 수정·삭제도 지금 원 소속 권한이 있어야 한다(작성자라도 멤버에서 빠지면 403). 첨부는 본인 댓글에만 붙일 수 있다.
**저장·동기화**
- 작업 창 세대(`taskGen`): 창을 열 때마다 +1. 상세·하위 작업·연결·첨부·댓글·담당자 후보·저장 결과는 요청 때 세대를 잡고, 돌아왔을
때 다르면 반영하지 않는다(A→B, A→B→A). 하위 작업·연결 블록도 자체 `ctxSeq` 로 늦은 응답을 버리고, 추가·연결은 누른 순간의
작업 id 로 보낸다. 설명 이미지 업로드는 시작한 작업·세대가 바뀌었으면 설명에 넣지 않는다(파일은 원래 작업 첨부로 남음).
- 자동 저장(`saveField`)은 성공/실패를 돌려준다. 실패한 칸은 `failedFields` 에 남고 "저장 실패 · 다시 시도"(눌러 재시도).
닫기·Esc·다른 작업 열기(`openTaskModal` → `settleBeforeLeave`)는 이미지 업로드·만들기·저장 큐가 끝나길 기다리고 실패한 칸을
한 번 더 보낸 뒤, 그래도 실패하면 "버리고 넘어가기 / 계속 편집"을 묻는다. 버리기를 고를 때만 초안을 버린다(`discardTaskEdits`).
저장 성공 뒤 화면 다시 그리기 오류는 저장 실패로 표시하지 않는다. 미저장(실패·대기·업로드 중)일 때만 페이지 이탈 경고.
- 읽기 전용 작업 창: 제목·설명·담당자·섹션·우선순위·마감일 잠금, 완료·삭제·댓글 입력·첨부 추가·서식 도구·하위 작업 추가·
연결 추가/해제 숨김, 안내줄 `#pj-t-readonly`. 댓글 대화창도 `GET /comments` 의 `access` 로 입력칸을 숨긴다.
- 실시간 동기화(`initLiveRefresh`): `observed`(서버에서 본 버전)와 `applied`(화면에 반영 성공한 버전)를 나눈다. 반영이
성공해야 applied 를 올리고, 실패하면 다음 주기(8→16→32→60초)에 같은 버전을 다시 받는다. 동기화 중엔 겹쳐 돌지 않고, 늦게 온
응답은 버린다(`syncSeq`). 프로젝트 화면은 `GET /api/projects/{id}/snapshot?scope=all` — 화면이 들고 있는 범위(볼 수 있는 모든
최상위 프로젝트의 작업·섹션·프로젝트 목록)를 통째로 바꿔 끼운다(다른 프로젝트의 생성·삭제·섹션 변경·권한 회수 반영, 멀티호밍은
`context_project_id` 별 한 행). 이 프로젝트 권한을 잃으면(403) 작업을 비우고 창을 닫고 안내줄 `.pj-access-lost`.
- 날짜: 업무 기준 "오늘" = 한국시간(`kstTodayIso`, UTC+9 고정) — 대시보드 지연 수·마감 색·오늘/내일·내 작업 필터가 브라우저
시간대와 무관하게 서버(`today_kst`)·마감 알림과 같다.
**댓글 파일** — 파일이 있는 댓글은 `POST /api/tasks/{id}/comments/files`(multipart: `files[]`·`body`·`parent_id`·`mentions`(JSON)·
`client_token`) 한 요청으로, 댓글+첨부를 한 트랜잭션(`add_comment_with_attachments`)에 만든다. 빈 파일·20MB 초과가 하나라도
있으면 아무것도 만들지 않고 400 `detail.failed=[{index,name,reason}]` → 화면은 그 파일만 빨갛게 표시하고 입력·파일을 유지.
DB 실패면 방금 쓴 파일도 지운다. 글 댓글(`POST /comments`)은 본문 필수 — 예전 `has_attachment` 플래그는 받지 않는다.
`client_token` 으로 같은 댓글의 재전송(응답 유실·연타·동시 요청)은 10분간 첫 결과를 돌려준다(웹 프로세스 메모리, 단일 워커 기준).
작업 창 댓글 목록도 댓글별 첨부(이미지 미리보기·파일명 다운로드, 이스케이프)를 보여 주고, 첨부 파일 목록엔 "댓글" 표시.
**마감 알림** — `add_reminder_notification`: 발송 기록(`task_reminders`)과 수신함 알림을 한 트랜잭션에. 알림 생성이 실패하면
기록도 되돌려져 다음 실행에서 다시 시도, 동시 실행도 UNIQUE 로 한 번만. 수신자는 지금 볼 수 있는 사람만. 보장 범위는 수신함
알림까지 — 메일(`PROJECT_REMINDER_EMAIL`)은 새로 만든 알림만 요약해 보내고 메일 실패는 재시도하지 않는다.
**완료 섹션에 바로 만든 작업** — `create_task` 가 완료 섹션이면 `completed_at`·완료 이력(1건)을 넣고, 라우터가 완료 섹션 이동과
같은 완료 알림(`_notify_completed`)을 보낸다. 섹션 없는 하위 작업·수동 완료/취소는 그대로.
**테스트** — `tests/test_project_module.py`(로컬 테스트용 PostgreSQL + FastAPI TestClient, `PROJECT_TEST_DB_URL` 가
localhost 일 때만), `tests/js/project_ui.test.js`(jsdom, `python tests/js/render_project.py` 후 실행, `PJ_TEST_TZ` 로 해외 시간대).
프런트 테스트 훅은 `window.__PJ_TEST__` 가 있을 때만 열린다.
**기존 데이터 점검(조회만 — 운영 교정은 따로 승인 후)**
```sql
-- 시작일 > 마감일(프로젝트·작업), 같은 날 시각 역전
SELECT id, name, start_date, due_date FROM projects WHERE start_date > due_date;
SELECT id, project_id, title, start_date, due_date, start_time, due_time FROM tasks
WHERE start_date > due_date OR (start_date = due_date AND start_time > due_time);
-- 본문도 첨부도 없는 빈 댓글(예전 파일 업로드 실패 흔적)
SELECT c.id, c.task_id, c.author_email, c.created_at FROM task_comments c
WHERE btrim(c.body) = '' AND NOT EXISTS (SELECT 1 FROM task_attachments a WHERE a.comment_id = c.id);
-- 완료 섹션에 있는데 미완료인 작업(예전 완료 섹션 직접 생성)
SELECT t.id, t.title FROM tasks t JOIN project_stages s ON s.id = t.stage_id
WHERE s.is_done_stage AND t.completed_at IS NULL;
```
교정안: 날짜 역전은 담당자와 확인해 한쪽을 고치고, 빈 댓글은 작성자 확인 후 삭제, 완료 섹션 미완료는 완료로 표시하거나 섹션을 옮긴다.
권한을 잃은 사람의 담당자·멘션·협업자 기록은 지우지 않아도 된다(화면·알림은 이미 지금 권한으로 거른다).
## 7. 추후 단계 ## 7. 추후 단계
검색/필터 · 업무 라벨(태그 분류) · 하위 업무의 하위 업무(다단계 중첩, 작업 라벨(태그 분류) · 반복 작업 · 템플릿 · 작업 의존성 · 하위 작업의 하위 작업(다단계 중첩,
아사나도 UI상 1단계만 허용해 현재 의도적으로 안 함). 아사나도 UI상 1단계만 허용해 현재 의도적으로 안 함).
+3 -1
View File
@@ -21,13 +21,14 @@
| 쿠팡 밀크런 | 쿠팡 출고 일정 관리 (`app/modules/cupang/`) — 월간 달력 / 출고 묶음(헤더+라인) / 상자 입수량 자동계산 / 로켓 매출 관리 / 엑셀 내보내기. 상품은 `itemcode_db` 읽기 전용 참조 | | 쿠팡 밀크런 | 쿠팡 출고 일정 관리 (`app/modules/cupang/`) — 월간 달력 / 출고 묶음(헤더+라인) / 상자 입수량 자동계산 / 로켓 매출 관리 / 엑셀 내보내기. 상품은 `itemcode_db` 읽기 전용 참조 |
| 휴가 (준비중) | 연차/반차/특별휴가 신청·잔여일수 관리 | | 휴가 (준비중) | 연차/반차/특별휴가 신청·잔여일수 관리 |
| 말레이시아 재고 | 말레이시아 창고 재고관리 (`app/modules/malaysia/`) — 낱개 입출고/조정, 세트 BOM, 일일 재고조사(세트 분해 자동 반영), 현재고 현황. 상품명은 `itemcode_db` 읽기 전용 참조 | | 말레이시아 재고 | 말레이시아 창고 재고관리 (`app/modules/malaysia/`) — 낱개 입출고/조정, 세트 BOM, 일일 재고조사(세트 분해 자동 반영), 현재고 현황. 상품명은 `itemcode_db` 읽기 전용 참조 |
| 실적 | 쇼핑몰 통합 매출 (`app/modules/performance/`) — 쇼핑몰별 어댑터로 수집 → `performance_db` 저장 → 일자×쇼핑몰 표·KPI·월/연 누적·그래프. 수수료율 이력, API 인증정보는 설정 화면 입력 + AES-256-GCM 암호화 저장. 1단계는 모의 데이터·구조까지(실제 API 는 쇼핑몰별로 순차 연동). `docs/PERFORMANCE_MODULE.md` |
### 권한 키 (`MODULE_KEYS`) ### 권한 키 (`MODULE_KEYS`)
| 키 | 종류 | 설명 | | 키 | 종류 | 설명 |
| --- | --- | --- | | --- | --- | --- |
| `corm` / `order` | 접근 | 외부 모듈 진입 | | `corm` / `order` | 접근 | 외부 모듈 진입 |
| `expense` / `vacation` / `cupang` / `malaysia` | 접근 | 내부 모듈 진입 | | `expense` / `vacation` / `cupang` / `malaysia` / `performance` | 접근 | 내부 모듈 진입 (`performance` 설정 화면·API 는 추가로 `admin` 필요) |
| `expense_approver` | 결재 | 개인경비 승인/반려/정산 | | `expense_approver` | 결재 | 개인경비 승인/반려/정산 |
| `vacation_approver` | 결재 | 휴가 승인/반려 (모듈 미개발) | | `vacation_approver` | 결재 | 휴가 승인/반려 (모듈 미개발) |
@@ -91,6 +92,7 @@ app/modules/<name>/
| `cupang_db` | 쿠팡 밀크런 출고/입고센터/박스규칙 (`CUPANG_DB_URL` 필수, JSON 폴백 없음) | | `cupang_db` | 쿠팡 밀크런 출고/입고센터/박스규칙 (`CUPANG_DB_URL` 필수, JSON 폴백 없음) |
| `vacation_db` | 휴가 신청/공휴일/연차잔여 (`VACATION_DB_URL` 필수, JSON 폴백 없음) | | `vacation_db` | 휴가 신청/공휴일/연차잔여 (`VACATION_DB_URL` 필수, JSON 폴백 없음) |
| `malaysia_stock_db` | 말레이시아 창고 재고/세트BOM/재고조사 (`MALAYSIA_STOCK_DB_URL` 필수, JSON 폴백 없음) | | `malaysia_stock_db` | 말레이시아 창고 재고/세트BOM/재고조사 (`MALAYSIA_STOCK_DB_URL` 필수, JSON 폴백 없음) |
| `performance_db` | 실적 — 쇼핑몰 설정/수수료 이력/인증정보(암호문)/매출 사건 (`PERFORMANCE_DB_URL` 필수, JSON 폴백 없음) |
> 신규 DB가 필요하면 **승인 요청 후** 생성하며, 이름은 `_db`로 끝낸다. 상세는 `DATABASES.md`. > 신규 DB가 필요하면 **승인 요청 후** 생성하며, 이름은 `_db`로 끝낸다. 상세는 `DATABASES.md`.
+2
View File
@@ -12,6 +12,8 @@ pdfplumber>=0.11
pillow>=10.0 pillow>=10.0
# 카페24 OAuth 토큰 암호화 저장(Fernet) — app/integrations/cafe24/crypto.py # 카페24 OAuth 토큰 암호화 저장(Fernet) — app/integrations/cafe24/crypto.py
cryptography>=42.0 cryptography>=42.0
# 네이버 커머스API 토큰 전자서명(client_secret_sign) — app/modules/performance/adapters/naver.py
bcrypt>=4.1
google-api-python-client>=2.100 google-api-python-client>=2.100
google-auth>=2.30 google-auth>=2.30
# refresh token 발급 스크립트(scripts/google_sheets_authorize.py) 전용 # refresh token 발급 스크립트(scripts/google_sheets_authorize.py) 전용
+223
View File
@@ -0,0 +1,223 @@
-- =====================================================================
-- performance_db 초기화 스크립트 (PostgreSQL) — 실적(쇼핑몰 통합 매출) 모듈
-- =====================================================================
-- 멱등(idempotent): 여러 번 실행해도 안전. 기존 데이터를 삭제하지 않는다.
--
-- ⚠️ 실행 전 사용자 승인 + 백업 확인 필수. DROP/TRUNCATE 없음.
--
-- 실행 방법 (운영 PostgreSQL 컨테이너명: postgres-db):
--
-- 1) DB / 역할 / 스키마 생성 (superuser 로 1회)
-- read -s -p "performance_app password: " APP_PWD; echo
-- docker exec -i postgres-db psql -U postgres \
-- -v app_password="$APP_PWD" \
-- < scripts/sql/performance_db_init.sql
--
-- 2) main-app .env 에 추가
-- PERFORMANCE_DB_URL=postgresql://performance_app:<APP_PWD>@postgres-db:5432/performance_db
-- APP_ENCRYPTION_KEY=$(openssl rand -hex 32) # 쇼핑몰 인증정보 암호화 마스터 키
-- APP_ENCRYPTION_KEY_VERSION=1
--
-- 3) main-app 재기동
-- cd /opt/www/main && docker compose up -d --build
--
-- 주의:
-- - 기존 DB 가 있으면 DROP 하지 않는다(CREATE DATABASE 는 미존재 시에만).
-- - 비밀번호는 절대 Git 에 커밋하지 않는다. psql -v 로만 전달.
-- - 쇼핑몰 API 인증정보는 이 DB 에 **암호문**으로만 들어간다(perf_credentials).
-- 암호화 마스터 키(APP_ENCRYPTION_KEY)는 DB 에 저장하지 않는다.
-- =====================================================================
\set ON_ERROR_STOP on
SELECT 'CREATE DATABASE performance_db ENCODING ''UTF8'' TEMPLATE template0'
WHERE NOT EXISTS (SELECT 1 FROM pg_database WHERE datname = 'performance_db')
\gexec
SELECT 'CREATE ROLE performance_app LOGIN PASSWORD ' || quote_literal(:'app_password')
WHERE NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'performance_app')
\gexec
SELECT 'ALTER ROLE performance_app WITH LOGIN PASSWORD ' || quote_literal(:'app_password')
\gexec
GRANT CONNECT ON DATABASE performance_db TO performance_app;
\connect performance_db
CREATE OR REPLACE FUNCTION perf_set_updated_at() RETURNS trigger AS $$
BEGIN
NEW.updated_at := now();
RETURN NEW;
END;
$$ LANGUAGE plpgsql;
-- ════════════════════════════════════════════════════════════
-- 1) 쇼핑몰 기본 설정 — 사용 여부 / 매출 집계 여부 / 표시 순서
-- 어댑터(코드)가 쇼핑몰의 "종류"를 정의하고, 이 표는 운영 설정만 담는다.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_marketplaces (
code TEXT PRIMARY KEY,
name TEXT NOT NULL,
enabled BOOLEAN NOT NULL DEFAULT TRUE,
include_in_sales BOOLEAN NOT NULL DEFAULT TRUE,
sort_order INTEGER NOT NULL DEFAULT 0,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
DROP TRIGGER IF EXISTS trg_perf_marketplaces_updated ON perf_marketplaces;
CREATE TRIGGER trg_perf_marketplaces_updated
BEFORE UPDATE ON perf_marketplaces
FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at();
INSERT INTO perf_marketplaces (code, name, sort_order) VALUES
('cafe24', '카페24', 10),
('naver', '네이버 스마트스토어', 20),
('coupang', '쿠팡', 30),
('ohouse', '오늘의집', 40),
('gmarket', 'G마켓', 50),
('kakao', '카카오', 60),
('gsshop', 'GS샵', 70),
('elevenst', '11번가', 80),
('lotteon', '롯데ON', 90),
('toss', '토스쇼핑', 100)
ON CONFLICT (code) DO NOTHING;
-- ════════════════════════════════════════════════════════════
-- 2) 수수료율 이력 — 적용 시작일(effective_from)부터 다음 변경 전까지 그 요율.
-- 과거 실적은 그 날짜에 유효했던 요율로 계산한다(요율을 바꿔도 과거가 안 바뀜).
-- rule_type 은 향후 상품별/카테고리별/정액 수수료 확장용(현재 'marketplace' 만).
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_commission_rates (
id BIGSERIAL PRIMARY KEY,
marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code),
rule_type TEXT NOT NULL DEFAULT 'marketplace'
CHECK (rule_type IN ('marketplace')),
rate_percent NUMERIC(7,3) NOT NULL CHECK (rate_percent >= 0 AND rate_percent <= 100),
effective_from DATE NOT NULL,
memo TEXT NOT NULL DEFAULT '',
created_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
UNIQUE (marketplace_code, rule_type, effective_from)
);
CREATE INDEX IF NOT EXISTS idx_perf_rates_code_from
ON perf_commission_rates (marketplace_code, effective_from DESC);
-- ════════════════════════════════════════════════════════════
-- 3) 쇼핑몰 API 인증정보 — 항목 하나 = 행 하나, 값은 AES-256-GCM 암호문.
-- encrypted_value 형식: "v{키버전}:{base64url(nonce + 암호문 + tag)}"
-- key_version 은 마스터 키 교체(rotation) 때 재암호화 대상을 찾는 데 쓴다.
-- access/refresh token 도 여기에 같은 방식으로 저장한다.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_credentials (
marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code),
credential_key TEXT NOT NULL,
encrypted_value TEXT NOT NULL,
key_version INTEGER NOT NULL,
updated_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (marketplace_code, credential_key)
);
DROP TRIGGER IF EXISTS trg_perf_credentials_updated ON perf_credentials;
CREATE TRIGGER trg_perf_credentials_updated
BEFORE UPDATE ON perf_credentials
FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at();
-- ════════════════════════════════════════════════════════════
-- 4) 연결 상태 — 연결 테스트/동기화 결과. last_error 는 비밀값을 가린 문구만.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_connection_status (
marketplace_code TEXT PRIMARY KEY REFERENCES perf_marketplaces(code),
status TEXT NOT NULL DEFAULT 'unknown'
CHECK (status IN ('ok', 'not_configured', 'auth_failed', 'token_expired',
'api_error', 'not_implemented', 'unknown')),
last_test_at TIMESTAMPTZ,
last_test_ok BOOLEAN,
last_sync_at TIMESTAMPTZ,
last_success_sync_at TIMESTAMPTZ,
last_error TEXT NOT NULL DEFAULT '',
last_error_at TIMESTAMPTZ,
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
DROP TRIGGER IF EXISTS trg_perf_status_updated ON perf_connection_status;
CREATE TRIGGER trg_perf_status_updated
BEFORE UPDATE ON perf_connection_status
FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at();
-- ════════════════════════════════════════════════════════════
-- 5) 매출 사건 — 결제(+), 취소(-), 반품(-). 금액은 원 단위 정수(BIGINT).
-- sales_date = 집계 기준일. 결제는 결제일, 취소·반품은 발생일
-- (지난 실적이 나중에 바뀌지 않게). order_date/payment_date 는 원래 날짜를
-- 따로 보관해 기준을 바꿀 수 있게 한다.
-- 중복 방지: UNIQUE(쇼핑몰, 사건 종류, 외부 사건 ID) — 같은 사건은 덮어쓴다.
-- raw_data 는 비밀값을 가린 원본. is_sample = 테스트(모의) 데이터.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_sales_events (
id BIGSERIAL PRIMARY KEY,
marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code),
event_type TEXT NOT NULL CHECK (event_type IN ('SALE', 'CANCEL', 'RETURN', 'ADJUST')),
external_event_id TEXT NOT NULL,
external_order_id TEXT NOT NULL,
external_line_id TEXT NOT NULL DEFAULT '',
order_date DATE,
payment_date DATE,
event_date DATE NOT NULL,
sales_date DATE NOT NULL,
product_name TEXT NOT NULL DEFAULT '',
option_name TEXT NOT NULL DEFAULT '',
quantity INTEGER NOT NULL DEFAULT 0,
amount BIGINT NOT NULL,
discount_amount BIGINT NOT NULL DEFAULT 0,
order_status TEXT NOT NULL DEFAULT '',
raw_data JSONB,
is_sample BOOLEAN NOT NULL DEFAULT FALSE,
synced_at TIMESTAMPTZ NOT NULL DEFAULT now(),
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
UNIQUE (marketplace_code, event_type, external_event_id)
);
CREATE INDEX IF NOT EXISTS idx_perf_events_date_code ON perf_sales_events (sales_date, marketplace_code);
CREATE INDEX IF NOT EXISTS idx_perf_events_order ON perf_sales_events (marketplace_code, external_order_id);
CREATE INDEX IF NOT EXISTS idx_perf_events_sample ON perf_sales_events (is_sample) WHERE is_sample;
DROP TRIGGER IF EXISTS trg_perf_events_updated ON perf_sales_events;
CREATE TRIGGER trg_perf_events_updated
BEFORE UPDATE ON perf_sales_events
FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at();
-- ════════════════════════════════════════════════════════════
-- 6) 동기화 실행 기록 — 같은 쇼핑몰은 동시에 하나만(running 부분 유니크 인덱스).
-- 웹/스케줄러 어디서 돌려도 중복 실행이 막힌다.
-- ════════════════════════════════════════════════════════════
CREATE TABLE IF NOT EXISTS perf_sync_runs (
id BIGSERIAL PRIMARY KEY,
marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code),
trigger TEXT NOT NULL DEFAULT 'manual' CHECK (trigger IN ('manual', 'schedule')),
range_from DATE,
range_to DATE,
status TEXT NOT NULL DEFAULT 'running'
CHECK (status IN ('running', 'success', 'failed')),
fetched_count INTEGER NOT NULL DEFAULT 0,
upserted_count INTEGER NOT NULL DEFAULT 0,
error TEXT NOT NULL DEFAULT '',
started_by TEXT NOT NULL DEFAULT '',
started_at TIMESTAMPTZ NOT NULL DEFAULT now(),
finished_at TIMESTAMPTZ
);
CREATE UNIQUE INDEX IF NOT EXISTS uq_perf_sync_running
ON perf_sync_runs (marketplace_code) WHERE status = 'running';
CREATE INDEX IF NOT EXISTS idx_perf_sync_runs_code ON perf_sync_runs (marketplace_code, started_at DESC);
-- ════════════════════════════════════════════════════════════
-- 권한 — 앱 계정은 DML 만
-- ════════════════════════════════════════════════════════════
GRANT USAGE ON SCHEMA public TO performance_app;
GRANT SELECT, INSERT, UPDATE, DELETE ON
perf_marketplaces, perf_commission_rates, perf_credentials,
perf_connection_status, perf_sales_events, perf_sync_runs
TO performance_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO performance_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO performance_app;
ALTER DEFAULT PRIVILEGES IN SCHEMA public
GRANT USAGE, SELECT ON SEQUENCES TO performance_app;
@@ -0,0 +1,75 @@
-- project_db 008 — 팔로워 · 마감 알림 · 검색 인덱스
--
-- 1) task_followers — 아사나의 "협업자(Collaborators)". 업무 알림(완료·댓글)은
-- 이제 프로젝트 멤버 전원이 아니라 "담당자 + 팔로워"에게만 간다.
-- 업무를 만든 사람·담당자·댓글 단 사람·@태그된 사람은 자동으로 팔로워가 된다.
-- 기존 업무는 아래 백필로 같은 규칙을 소급 적용한다.
-- 2) task_reminders — 마감 알림(D-1 / 당일 / 지연)을 이미 보냈는지 기록.
-- (업무, 종류, 마감일, 수신자) 가 같으면 다시 보내지 않는다 — 마감일을 바꾸면
-- 새 마감일 기준으로 다시 알린다. 여러 번 돌아도 중복 발송이 없다.
-- 3) pg_trgm 인덱스 — 전체 검색(제목·설명·댓글 ILIKE '%...%')이 풀스캔하지 않게.
--
-- 적용 (superuser, 1회 — 여러 번 돌려도 안전. pg_trgm 확장 생성 때문에 superuser 필요):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_008_followers_reminders_search.sql
--
-- 미적용 환경에서도 앱은 동작한다(팔로워 기능만 숨고, 알림 수신자는 예전처럼
-- 멤버 전원, 마감 알림은 skip, 검색은 인덱스 없이 동작).
\set ON_ERROR_STOP on
\connect project_db
-- ── 1) 팔로워 ─────────────────────────────────────────────
CREATE TABLE IF NOT EXISTS task_followers (
task_id BIGINT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
user_email TEXT NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (task_id, user_email)
);
CREATE INDEX IF NOT EXISTS idx_task_followers_email ON task_followers (user_email);
-- 백필(멱등): 만든 사람 · 담당자 · 댓글 작성자 · @태그된 사람
INSERT INTO task_followers (task_id, user_email)
SELECT id, lower(created_by) FROM tasks WHERE created_by <> ''
UNION
SELECT id, lower(assignee_email) FROM tasks WHERE assignee_email <> ''
UNION
SELECT task_id, lower(author_email) FROM task_comments WHERE author_email <> ''
UNION
SELECT task_id, lower(mentioned_email) FROM task_mentions WHERE mentioned_email <> ''
ON CONFLICT DO NOTHING;
-- 팔로워가 바뀌어도 열린 화면이 새로 받도록(007 카운터)
DROP TRIGGER IF EXISTS trg_task_followers_live_version ON task_followers;
CREATE TRIGGER trg_task_followers_live_version
AFTER INSERT OR UPDATE OR DELETE ON task_followers
FOR EACH STATEMENT EXECUTE FUNCTION project_bump_live_version();
-- ── 2) 마감 알림 발송 기록 ─────────────────────────────────
CREATE TABLE IF NOT EXISTS task_reminders (
id BIGSERIAL PRIMARY KEY,
task_id BIGINT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
kind TEXT NOT NULL, -- due_soon | due_today | overdue
due_date DATE NOT NULL,
recipient_email TEXT NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
UNIQUE (task_id, kind, due_date, recipient_email)
);
CREATE INDEX IF NOT EXISTS idx_task_reminders_created ON task_reminders (created_at);
-- ── 3) 검색 인덱스 ─────────────────────────────────────────
CREATE EXTENSION IF NOT EXISTS pg_trgm;
CREATE INDEX IF NOT EXISTS idx_tasks_title_trgm
ON tasks USING gin (title gin_trgm_ops);
CREATE INDEX IF NOT EXISTS idx_tasks_desc_trgm
ON tasks USING gin (description gin_trgm_ops);
CREATE INDEX IF NOT EXISTS idx_task_comments_body_trgm
ON task_comments USING gin (body gin_trgm_ops);
-- 마감 알림 조회(미완료 + 마감일)
CREATE INDEX IF NOT EXISTS idx_tasks_open_due
ON tasks (due_date) WHERE completed_at IS NULL;
GRANT SELECT, INSERT, UPDATE, DELETE ON task_followers, task_reminders TO project_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO project_app;
SELECT 'project_db 008 followers/reminders/search ready' AS status;
@@ -0,0 +1,22 @@
-- =====================================================================
-- project_db 마이그레이션 009 — 세션(project_stages) 기본 담당자
-- =====================================================================
-- 세션에 기본 담당자 1명을 지정해 두면, 그 세션에 업무를 새로 만들거나
-- 다른 세션에서 카드를 옮겨올 때 "담당자가 비어 있는 업무만" 자동으로
-- 그 사람이 배정된다(이미 담당자가 있으면 그대로). '' = 미지정.
--
-- 멱등. DROP 없음. 미적용 환경에서도 앱은 동작한다(기본 담당자 기능만 빠짐 —
-- 조회는 to_jsonb 로 컬럼 유무와 무관하게 읽고, 지정 시도만 안내 오류).
--
-- 실행:
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_009_stage_default_assignee.sql
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
ALTER TABLE project_stages
ADD COLUMN IF NOT EXISTS default_assignee_email TEXT NOT NULL DEFAULT '';
SELECT 'project_db 009 ready' AS status;
+39
View File
@@ -0,0 +1,39 @@
-- =====================================================================
-- project_db 마이그레이션 010 — 업무 휴지통(3개월 보관, 관리자 복구)
-- =====================================================================
-- 업무를 지우면 지우기 직전의 업무 묶음(업무 + 하위 업무 + 댓글·팔로워·@태그·
-- 첨부 기록·다른 프로젝트 연결·활동 이력·마감 알림 기록)을 JSON 스냅샷으로
-- 여기 남긴 뒤 예전처럼 삭제한다. 관리자가 휴지통 화면에서 복구하면 원래 id
-- 그대로 다시 넣는다. 첨부파일 실물은 DATA_DIR/project/_trash/<trash_id>/ 로
-- 옮겨 두었다가 복구 시 되돌린다. expires_at(기본 3개월) 이 지나면 스냅샷과
-- 파일을 영구 삭제한다(앱이 휴지통 화면을 열거나 삭제할 때 정리).
--
-- 미적용이어도 앱은 동작한다 — 휴지통 없이 예전처럼 바로 영구 삭제.
--
-- 적용 (1회, 여러 번 돌려도 안전):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_010_trash.sql
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
CREATE TABLE IF NOT EXISTS project_trash (
id BIGSERIAL PRIMARY KEY,
task_id BIGINT NOT NULL, -- 지운 업무(최상위) id — FK 없음(이미 삭제됨)
project_id BIGINT, -- 표시용(FK 없음 — 프로젝트가 나중에 지워져도 행 유지)
project_name TEXT NOT NULL DEFAULT '',
title TEXT NOT NULL DEFAULT '',
task_count INTEGER NOT NULL DEFAULT 1, -- 하위 업무 포함 개수
deleted_by TEXT NOT NULL DEFAULT '',
deleted_at TIMESTAMPTZ NOT NULL DEFAULT now(),
expires_at TIMESTAMPTZ NOT NULL DEFAULT (now() + interval '3 months'),
payload JSONB NOT NULL -- {"tasks": [...], "task_comments": [...], ...}
);
CREATE INDEX IF NOT EXISTS idx_project_trash_deleted ON project_trash (deleted_at DESC);
CREATE INDEX IF NOT EXISTS idx_project_trash_expires ON project_trash (expires_at);
GRANT SELECT, INSERT, UPDATE, DELETE ON project_trash TO project_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO project_app;
SELECT 'project_db 010 ready' AS status;
@@ -0,0 +1,21 @@
-- =====================================================================
-- project_db 마이그레이션 011 — 프로젝트 아이콘(아사나식 색상·아이콘)
-- =====================================================================
-- 프로젝트마다 아이콘 하나(Material Symbols 이름, store.PROJECT_ICONS 중 하나)를
-- 저장한다. NULL = 아이콘 없음 → 예전처럼 프로젝트 색 + 이름 첫 글자.
--
-- 미적용이어도 앱은 동작한다 — 아이콘 없이 만들고 고치는 건 예전처럼 되고,
-- 아이콘을 고를 때만 "마이그레이션 011 필요" 안내가 뜬다.
--
-- 적용 (1회, 여러 번 돌려도 안전):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_011_project_icon.sql
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
ALTER TABLE projects ADD COLUMN IF NOT EXISTS icon TEXT;
COMMENT ON COLUMN projects.icon IS
'프로젝트 아이콘(Material Symbols 이름, store.PROJECT_ICONS). NULL = 색 + 첫 글자';
@@ -0,0 +1,50 @@
-- =====================================================================
-- project_db 마이그레이션 012 — 댓글 답글 + 이모티콘 반응(아사나식)
-- =====================================================================
-- 멱등(idempotent). DROP/TRUNCATE 없음.
--
-- task_comments.parent_id 답글이면 원 댓글 id(한 단계만 — 답글의 답글도 원 댓글에 붙는다).
-- 원 댓글을 지우면 답글도 CASCADE 로 같이 지워진다.
-- task_comment_reactions 댓글 1개 × 사람 1명 × 이모티콘 1개 = 1행(누르면 추가, 다시 누르면 삭제).
-- task_id 는 휴지통 스냅샷(TRASH_CHILD_TABLES)이 task_id 로 묶기 때문.
--
-- 미적용이어도 앱은 동작한다 — 답글/반응 버튼만 숨겨지고, 누르면 "마이그레이션 012 필요" 안내.
--
-- 적용 (1회, 여러 번 돌려도 안전):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_012_comment_replies_reactions.sql
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
ALTER TABLE task_comments
ADD COLUMN IF NOT EXISTS parent_id BIGINT REFERENCES task_comments(id) ON DELETE CASCADE;
CREATE INDEX IF NOT EXISTS idx_task_comments_parent ON task_comments (parent_id);
COMMENT ON COLUMN task_comments.parent_id IS '답글이면 원 댓글 id (한 단계). NULL = 일반 댓글';
CREATE TABLE IF NOT EXISTS task_comment_reactions (
comment_id BIGINT NOT NULL REFERENCES task_comments(id) ON DELETE CASCADE,
task_id BIGINT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
user_email TEXT NOT NULL,
emoji TEXT NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (comment_id, user_email, emoji)
);
CREATE INDEX IF NOT EXISTS idx_task_comment_reactions_task ON task_comment_reactions (task_id);
-- 실시간 반영(007) — 반응도 다른 사람 화면에 바로 보이게 버전 카운터를 올린다.
DO $$
BEGIN
IF to_regproc('project_bump_live_version') IS NOT NULL THEN
EXECUTE 'DROP TRIGGER IF EXISTS trg_task_comment_reactions_live_version ON task_comment_reactions';
EXECUTE 'CREATE TRIGGER trg_task_comment_reactions_live_version '
'AFTER INSERT OR UPDATE OR DELETE ON task_comment_reactions '
'FOR EACH STATEMENT EXECUTE FUNCTION project_bump_live_version()';
END IF;
END $$;
GRANT SELECT, INSERT, UPDATE, DELETE ON task_comment_reactions TO project_app;
SELECT 'project_db 012 comment replies/reactions ready' AS status;
+77
View File
@@ -0,0 +1,77 @@
-- =====================================================================
-- project_db 마이그레이션 013 — 연간 목표(좌측 사이드바 "목표" → 연도)
-- =====================================================================
-- 멱등(idempotent). DROP/TRUNCATE 없음.
--
-- goal_years 목표를 둔 연도(사이드바 "목표" 아래 연도 목록). sales_unit = 매출 단위 글자(예: 백만원).
-- goal_metrics 숫자 지표 — 매출·로아스 × 목표·실적 × 1~12월. 달성률은 화면에서 계산(저장 안 함).
-- goal_areas 업무 영역(상품·마케팅·컨텐츠·유통 …) — 연도마다 따로, 색은 줄 배경.
-- goal_rows 영역 안의 줄(유통: 콜라보·인플·쿠팡·기타). 영역마다 최소 1줄(이름 없는 줄 가능).
-- goal_cells 줄 × 월 글. month 0 = 연간, 1~12 = 월.
--
-- 입력은 관리자만(라우터 _require_admin), 조회는 project 권한자 전원.
-- 미적용이어도 앱은 동작한다 — 사이드바 "목표" 아래 연도만 나오고, 화면에 "마이그레이션 013 필요" 안내.
--
-- 적용 (1회, 여러 번 돌려도 안전):
-- docker exec -i postgres-db psql -U postgres -d project_db \
-- < scripts/sql/project_db_013_goals.sql
-- =====================================================================
\set ON_ERROR_STOP on
\connect project_db
CREATE TABLE IF NOT EXISTS goal_years (
year INT PRIMARY KEY CHECK (year BETWEEN 2000 AND 2100),
sales_unit TEXT NOT NULL DEFAULT '',
created_by TEXT NOT NULL DEFAULT '',
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE TABLE IF NOT EXISTS goal_metrics (
year INT NOT NULL REFERENCES goal_years(year) ON DELETE CASCADE,
metric TEXT NOT NULL CHECK (metric IN ('sales', 'roas')),
kind TEXT NOT NULL CHECK (kind IN ('target', 'actual')),
month SMALLINT NOT NULL CHECK (month BETWEEN 1 AND 12),
value NUMERIC(18, 2) NOT NULL,
updated_by TEXT NOT NULL DEFAULT '',
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (year, metric, kind, month)
);
CREATE TABLE IF NOT EXISTS goal_areas (
id BIGSERIAL PRIMARY KEY,
year INT NOT NULL REFERENCES goal_years(year) ON DELETE CASCADE,
name TEXT NOT NULL,
color TEXT NOT NULL DEFAULT '#fbe1d5',
sort_order INT NOT NULL DEFAULT 0,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX IF NOT EXISTS idx_goal_areas_year ON goal_areas (year, sort_order, id);
CREATE TABLE IF NOT EXISTS goal_rows (
id BIGSERIAL PRIMARY KEY,
area_id BIGINT NOT NULL REFERENCES goal_areas(id) ON DELETE CASCADE,
label TEXT NOT NULL DEFAULT '',
sort_order INT NOT NULL DEFAULT 0
);
CREATE INDEX IF NOT EXISTS idx_goal_rows_area ON goal_rows (area_id, sort_order, id);
CREATE TABLE IF NOT EXISTS goal_cells (
row_id BIGINT NOT NULL REFERENCES goal_rows(id) ON DELETE CASCADE,
month SMALLINT NOT NULL CHECK (month BETWEEN 0 AND 12),
body TEXT NOT NULL DEFAULT '',
updated_by TEXT NOT NULL DEFAULT '',
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (row_id, month)
);
COMMENT ON TABLE goal_years IS '연간 목표 — 연도 목록(사이드바 목표 아래)';
COMMENT ON TABLE goal_metrics IS '연간 목표 — 매출/로아스 목표·실적 월별 숫자';
COMMENT ON TABLE goal_areas IS '연간 목표 — 업무 영역(상품·마케팅·컨텐츠·유통 등)';
COMMENT ON TABLE goal_rows IS '연간 목표 — 업무 영역 안의 줄(유통: 콜라보·인플·쿠팡·기타)';
COMMENT ON TABLE goal_cells IS '연간 목표 — 줄×월 글. month 0 = 연간';
GRANT SELECT, INSERT, UPDATE, DELETE ON goal_years, goal_metrics, goal_areas, goal_rows, goal_cells TO project_app;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO project_app;
SELECT 'project_db 013 goals ready' AS status;
-1
View File
@@ -144,7 +144,6 @@ INSERT INTO vacation_holidays (holiday_date, name, kind) VALUES
('2026-09-24', '추석 연휴', 'lunar'), ('2026-09-24', '추석 연휴', 'lunar'),
('2026-09-25', '추석', 'lunar'), ('2026-09-25', '추석', 'lunar'),
('2026-09-26', '추석 연휴', 'lunar'), ('2026-09-26', '추석 연휴', 'lunar'),
('2026-09-28', '추석 대체', 'substitute'),
('2026-10-03', '개천절', 'public'), ('2026-10-03', '개천절', 'public'),
('2026-10-05', '개천절 대체', 'substitute'), ('2026-10-05', '개천절 대체', 'substitute'),
('2026-10-09', '한글날', 'public'), ('2026-10-09', '한글날', 'public'),
+425
View File
@@ -0,0 +1,425 @@
// 프로젝트 관리 화면(project/project.html + static/project.js) UI 회귀 테스트 — jsdom.
// 서버 응답은 가짜(fetch 대체)로, 지연·실패·순서 역전을 직접 만든다. 실제 브라우저 레이아웃·입력기는 아니다.
//
// python tests/js/render_project.py # 템플릿 렌더 → tests/js/.out/project_render.html
// npm install jsdom # (최초 1회)
// TZ=America/Los_Angeles node tests/js/project_ui.test.js # 해외 시간대 브라우저 흉내
//
// 성공하면 마지막 줄 ALL PASS, 실패하면 항목명과 종료코드 1.
// Git Bash 는 윈도우 프로그램에 TZ 를 넘기지 않아 PJ_TEST_TZ 로도 받는다(날짜 객체를 만들기 전에 설정).
if (process.env.PJ_TEST_TZ) process.env.TZ = process.env.PJ_TEST_TZ;
const fs = require("fs");
const path = require("path");
const { JSDOM } = require("jsdom");
const WATCHDOG = setTimeout(function () { console.log("TIMEOUT — 어딘가에서 멈춤"); process.exit(2); }, 90000);
const ROOT = path.join(__dirname, "..", "..");
const html = fs.readFileSync(path.join(__dirname, ".out", "project_render.html"), "utf8");
const JS = fs.readFileSync(path.join(ROOT, "app", "static", "project.js"), "utf8");
const fails = [];
function check(name, cond, extra) {
if (cond) console.log("PASS " + name);
else { console.log("FAIL " + name + (extra !== undefined ? " → " + JSON.stringify(extra) : "")); fails.push(name); }
}
function deferred() {
let resolve, reject;
const p = new Promise(function (a, b) { resolve = a; reject = b; });
return { promise: p, resolve: resolve, reject: reject };
}
function makeEnv() {
const dom = new JSDOM(html, { runScripts: "dangerously", pretendToBeVisual: true, url: "http://localhost/project/p/1" });
const w = dom.window, d = w.document;
w.__PJ_TEST__ = true;
w.HTMLCanvasElement.prototype.getContext = function () { return null; };
w.URL.createObjectURL = function () { return "blob:x"; };
w.URL.revokeObjectURL = function () {};
w.Image = function () { const self = this; Object.defineProperty(self, "src", { set: function () { setTimeout(function () { if (self.onerror) self.onerror(); }, 0); } }); };
w.console.error = function () {};
let confirmAnswer = false;
w.erpConfirm = function () { env.confirms++; return Promise.resolve(confirmAnswer); };
w.erpAlert = function (m) { env.alerts.push(m); };
w.alert = function (m) { env.alerts.push(m); };
// 8초 이상 타이머(실시간 새로고침)는 붙잡아 두고 테스트가 직접 돌린다.
const realSetTimeout = w.setTimeout.bind(w);
const slow = [];
w.setTimeout = function (fn, ms) {
if (ms >= 8000) { slow.push({ fn: fn, ms: ms }); return 999000 + slow.length; }
return realSetTimeout(fn, ms);
};
const env = {
w: w, d: d, calls: [], routes: [], slow: slow, confirms: 0, alerts: [],
setConfirm: function (v) { confirmAnswer = v; },
route: function (method, re, fn) { env.routes.unshift({ method: method, re: re, fn: fn }); },
runSlow: async function () { const t = slow.shift(); if (t) { t.fn(); await settle(); } return t; },
};
w.fetch = async function (url, opts) {
const method = (opts && opts.method) || "GET";
let body = opts && opts.body;
if (typeof body === "string") { try { body = JSON.parse(body); } catch (_) {} }
env.calls.push({ method: method, url: String(url), body: body });
if (process.env.PJ_TEST_TRACE && method === "PUT") console.log(" TRACE PUT", url, new Error().stack.split("\n").slice(2, 7).join(" | "));
for (const r of env.routes) {
if (r.method === method && r.re.test(String(url))) {
const out = await r.fn(String(url), body);
if (out === "NETWORK") throw new TypeError("Failed to fetch");
const status = out.status || 200;
return { ok: status < 400, status: status, statusText: "x", json: async function () { return out.body; } };
}
}
return { ok: true, status: 200, statusText: "OK", json: async function () { return {}; } };
};
return env;
}
function settle(n) {
return new Promise(function (r) { let i = 0; (function spin() { if (i++ >= (n || 30)) return r(); setImmediate(spin); })(); });
}
function detail(id, title, extra) {
return Object.assign({ id: id, title: title, project_id: 1, stage_id: 11, description: "", priority: "normal",
assignee_email: "", subtasks: [], links: [], followers: [], access: "full", completed_at: null }, extra || {});
}
function baseRoutes(env) {
env.route("GET", /\/project\/api\/tasks\/\d+\/attachments/, function () { return { body: { attachments: [] } }; });
env.route("GET", /\/project\/api\/tasks\/\d+\/comments/, function () { return { body: { comments: [], events: [], features: {} } }; });
env.route("GET", /\/project\/api\/projects\/\d+\/members/, function () { return { body: { members: [{ user_email: "me@test.local" }] } }; });
env.route("GET", /\/project\/api\/projects$/, function () { return { body: { projects: [] } }; });
env.route("GET", /\/project\/api\/all-users/, function () { return { body: { users: [] } }; });
env.route("GET", /\/project\/api\/live-version/, function () { return { body: { ts: "v1" } }; });
env.route("GET", /\/project\/api\/tasks\/101$/, function () { return { body: { task: detail(101, "작업 A") } }; });
env.route("GET", /\/project\/api\/tasks\/102$/, function () { return { body: { task: detail(102, "작업 B") } }; });
}
async function boot(env) {
// jsdom 이 문서를 다 읽고 DOMContentLoaded 를 보낸 뒤에 넣는다 — 먼저 넣으면 초기화가 두 번 돈다.
if (env.d.readyState === "loading") {
await new Promise(function (r) { env.d.addEventListener("DOMContentLoaded", r); });
}
// jsdom 의 <select>·일부 입력은 내부 Proxy 라 value 를 재정의(enhance*)하면 쓰기가 막힌다(실제 브라우저는
// 문제없음, 기존 코드 그대로). 테스트에서는 버튼 보강을 건너뛰고 원래 입력칸으로 시험한다.
env.d.querySelectorAll("select").forEach(function (s) { s.dataset.pjEnhanced = "1"; });
env.d.querySelectorAll("input[type=date]").forEach(function (i) { i.dataset.pjDate = "1"; });
env.w.eval(JS);
env.d.dispatchEvent(new env.w.Event("DOMContentLoaded"));
await settle();
return env.w.__pjProject;
}
function taskOf(P, id) { return P.state().tasks.find(function (t) { return t.id === id && t.context_project_id === 1; }); }
function subsText(d) { // 하위 작업 제목은 입력칸 값이다
return Array.from(d.querySelectorAll("#pj-subtask-list .pj-subtask-title")).map(function (i) { return i.value; }).join("|") ||
d.getElementById("pj-subtask-list").textContent;
}
function wait(ms) { return new Promise(function (r) { setTimeout(r, ms); }); } // 창 닫기 애니메이션(0.32초) 대기
function titleVal(d) { return d.getElementById("pj-t-title").value; }
(async function () {
// ── [05] 한국시간 기준 오늘 ─────────────────────────────
{
const env = makeEnv(); baseRoutes(env); await boot(env);
const H = env.w.__pjHelpers;
const kst = function (y, m, d, hh, mm) { return Date.UTC(y, m - 1, d, hh - 9, mm); };
check("[05] KST 00:00 → 그날", H.kstTodayIso(kst(2026, 9, 30, 0, 0)) === "2026-09-30");
check("[05] KST 08:59(UTC 전날) → 그날", H.kstTodayIso(kst(2026, 9, 30, 8, 59)) === "2026-09-30");
check("[05] KST 09:00 → 그날", H.kstTodayIso(kst(2026, 9, 30, 9, 0)) === "2026-09-30");
check("[05] KST 23:59 → 그날", H.kstTodayIso(kst(2026, 9, 30, 23, 59)) === "2026-09-30");
const realNow = env.w.Date.now;
env.w.Date.now = function () { return kst(2026, 9, 30, 8, 30); };
const y = H.dueInfo("2026-09-29", false), t = H.dueInfo("2026-09-30", false);
check("[05] 해외 시간대(" + (process.env.TZ || "기본") + ")·한국 오전에도 전날 마감=지남", y.cls === "is-overdue" && y.text === "어제", y);
check("[05] 오늘 마감은 지남이 아님", t.cls === "is-soon" && t.text === "오늘", t);
env.w.Date.now = realNow;
}
// ── [09] A→B 전환 중 늦은 A 응답이 B 를 덮지 않는다 ───────────
{
const env = makeEnv(); baseRoutes(env);
const dA = deferred();
env.route("GET", /\/project\/api\/tasks\/101$/, function () { return dA.promise; });
env.route("GET", /\/project\/api\/tasks\/102$/, function () { return { body: { task: detail(102, "작업 B", { subtasks: [{ id: 902, title: "B-sub", project_id: 1 }] }) } }; });
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101));
await P.openTaskModal(taskOf(P, 102));
await settle();
dA.resolve({ body: { task: detail(101, "작업 A", { subtasks: [{ id: 901, title: "A-sub", project_id: 1 }] }) } });
await settle();
check("[09] 늦은 A 상세가 B 의 하위 작업 목록을 덮지 않음", subsText(d).includes("B-sub") && !subsText(d).includes("A-sub"), subsText(d));
env.route("POST", /\/project\/api\/projects\/1\/tasks$/, function (u, b) { return { status: 201, body: { task: detail(903, b.title, { parent_task_id: b.parent_task_id }) } }; });
d.getElementById("pj-subtask-input").value = "새 하위";
d.getElementById("pj-subtask-add").click();
await settle();
const post = env.calls.filter(function (c) { return c.method === "POST" && /projects\/1\/tasks$/.test(c.url); }).pop();
check("[09] B 화면에서 추가한 하위 작업은 B 에 붙음", post && post.body.parent_task_id === 102, post && post.body);
}
// A→B→A — 같은 작업을 다시 열어도 이전 요청은 버린다
{
const env = makeEnv(); baseRoutes(env);
const dOld = deferred(); let n = 0;
env.route("GET", /\/project\/api\/tasks\/101$/, function () {
n++;
if (n === 1) return dOld.promise;
return { body: { task: detail(101, "작업 A", { subtasks: [{ id: 911, title: "A-new", project_id: 1 }] }) } };
});
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101));
await P.openTaskModal(taskOf(P, 102));
await P.openTaskModal(taskOf(P, 101));
await settle();
dOld.resolve({ body: { task: detail(101, "작업 A", { subtasks: [{ id: 910, title: "A-old", project_id: 1 }] }) } });
await settle();
check("[09] A→B→A 에서 첫 A 의 늦은 응답은 버림", subsText(d).includes("A-new") && !subsText(d).includes("A-old"), subsText(d));
}
// 이미지 업로드 중 A→B 전환 — 업로드가 끝나 A 설명에 들어가고 저장된 뒤에 B 가 열린다
{
const env = makeEnv(); baseRoutes(env);
const up = deferred();
env.route("POST", /\/project\/api\/tasks\/101\/attachments$/, function () { return up.promise; });
env.route("PUT", /\/project\/api\/tasks\/101$/, function (u, b) { return { body: { task: Object.assign(detail(101, "작업 A"), b) } }; });
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101));
await settle();
const box = d.getElementById("pj-t-desc");
const file = new env.w.File(["x"], "a.png", { type: "image/png" });
const ev = new env.w.Event("paste", { bubbles: true, cancelable: true });
Object.defineProperty(ev, "clipboardData", { value: { items: [{ type: "image/png", getAsFile: function () { return file; } }], getData: function () { return ""; } } });
box.dispatchEvent(ev);
await settle();
const switching = P.openTaskModal(taskOf(P, 102));
await settle();
check("[09] 업로드 중에는 B 로 넘어가지 않고 기다림", d.getElementById("pj-t-id").value === "101");
up.resolve({ status: 201, body: { attachment: { id: 55 } } });
await switching; await settle();
const put = env.calls.filter(function (c) { return c.method === "PUT" && /tasks\/101$/.test(c.url) && c.body.description; }).pop();
check("[09] 업로드된 이미지는 A 설명에 넣어 A 에 저장", !!put && put.body.description.includes("/attachments/55/inline"), put && put.body);
check("[09] 그 다음 B 가 열리고 B 설명엔 이미지 없음", d.getElementById("pj-t-id").value === "102" && !box.innerHTML.includes("/attachments/55/"));
}
// ── [10] 저장 실패 후 닫기 — 유실 없이 재시도/버리기 선택 ─────────
{
const env = makeEnv(); baseRoutes(env);
let putStatus = 500; const puts = [];
env.route("PUT", /\/project\/api\/tasks\/101$/, function (u, b) {
puts.push(b);
return putStatus >= 400 ? { status: putStatus, body: { detail: "서버 오류" } } : { body: { task: Object.assign(detail(101, "작업 A"), b) } };
});
const P = await boot(env); const d = env.d; const modal = d.getElementById("pj-modal-task");
await P.openTaskModal(taskOf(P, 101)); await settle();
const ta = d.getElementById("pj-t-title");
ta.value = "작업 A2"; ta.dispatchEvent(new env.w.Event("blur")); await settle();
check("[10] 실패한 칸 기록 + '저장 실패 · 다시 시도' 표시", P.state().failed.includes("title") && d.getElementById("pj-autosave-state").textContent.includes("저장 실패"), P.state().failed);
check("[10] 저장 안 된 상태면 페이지 이탈 경고 대상", P.state().unsaved === true);
env.setConfirm(false); // 계속 편집
await P.attemptClose(); await settle();
check("[10] 닫기 때 재시도해도 실패 → 묻고, '계속 편집'이면 창·입력 유지", !modal.hidden && titleVal(d) === "작업 A2" && env.confirms === 1);
putStatus = 200;
await P.attemptClose(); await settle(); await wait(400);
check("[10] 다시 닫기 → 재시도 성공 후 닫힘", modal.hidden && puts[puts.length - 1].title === "작업 A2", { hidden: modal.hidden, last: puts[puts.length - 1] });
check("[10] 저장된 상태에서는 이탈 경고 없음", P.state().unsaved === false);
}
{
// 403·지연 + Escape + 버리기, A 실패가 B 상태를 오염시키지 않음
const env = makeEnv(); baseRoutes(env);
const dPut = deferred();
env.route("PUT", /\/project\/api\/tasks\/101$/, function () { return dPut.promise; });
const P = await boot(env); const d = env.d; const modal = d.getElementById("pj-modal-task");
await P.openTaskModal(taskOf(P, 101)); await settle();
d.getElementById("pj-t-priority").value = "high";
d.getElementById("pj-t-priority").dispatchEvent(new env.w.Event("change")); await settle();
d.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Escape", bubbles: true })); await settle();
check("[10] 저장 중 Esc → 저장이 끝날 때까지 창 유지", !modal.hidden);
env.setConfirm(true); // 버리고 넘어가기
const opening = P.openTaskModal(taskOf(P, 102)); await settle();
dPut.resolve({ status: 403, body: { detail: "권한 없음" } });
await opening; await settle();
check("[10] 403 실패 → 버리기 선택 후 B 열림", d.getElementById("pj-t-id").value === "102" && !modal.hidden);
check("[10] A 의 실패가 B 상태를 오염시키지 않음", P.state().failed.length === 0 && d.getElementById("pj-autosave-state").textContent === "", P.state().failed);
}
{
// 네트워크 단절 → 계속 편집, 복구 후 표시줄 클릭으로 재시도
const env = makeEnv(); baseRoutes(env);
let net = false; const puts = [];
env.route("PUT", /\/project\/api\/tasks\/101$/, function (u, b) { puts.push(b); return net ? { body: { task: Object.assign(detail(101, "작업 A"), b) } } : "NETWORK"; });
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101)); await settle();
d.getElementById("pj-t-due").value = "2026-10-10";
d.getElementById("pj-t-due").dispatchEvent(new env.w.Event("change")); await settle();
check("[10] 네트워크 오류 → 마감일 칸 실패로 남음", P.state().failed.includes("due"));
net = true;
const stEl = d.getElementById("pj-autosave-state");
const stBefore = stEl.dataset.state;
stEl.click(); await settle();
check("[10] '다시 시도' → 같은 값으로 재전송 성공", P.state().failed.length === 0 && puts[puts.length - 1].due_date === "2026-10-10",
{ stBefore: stBefore, failed: P.state().failed, puts: puts });
}
// ── [16] 한글 조합 Enter ─────────────────────────────────
{
const env = makeEnv(); baseRoutes(env);
const dPost = deferred();
env.route("POST", /\/project\/api\/tasks\/101\/comments$/, function () { return dPost.promise; });
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101)); await settle();
const inp = d.getElementById("pj-comment-input");
inp.value = "안녕하세요";
inp.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Enter", isComposing: true, bubbles: true, cancelable: true }));
const ev229 = new env.w.KeyboardEvent("keydown", { key: "Enter", bubbles: true, cancelable: true });
Object.defineProperty(ev229, "keyCode", { value: 229 });
inp.dispatchEvent(ev229);
await settle();
const posts = function () { return env.calls.filter(function (c) { return c.method === "POST" && /101\/comments$/.test(c.url); }); };
check("[16] 조합 중 Enter(isComposing·229)는 댓글 전송 안 함", posts().length === 0);
inp.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Enter", bubbles: true, cancelable: true }));
inp.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Enter", bubbles: true, cancelable: true }));
await settle();
check("[16] 조합이 끝난 Enter 연타 → 한 번만 전송", posts().length === 1 && posts()[0].body.client_token, posts().length);
dPost.resolve({ status: 201, body: { comment: { id: 1, body: "안녕하세요" }, mention_skipped: [] } }); await settle();
const sub = d.getElementById("pj-subtask-input");
await settle(); sub.value = "하위";
sub.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Enter", isComposing: true, bubbles: true, cancelable: true })); await settle();
check("[16] 하위 작업 칸도 조합 중 Enter 는 추가 안 함", !env.calls.some(function (c) { return c.method === "POST" && /projects\/1\/tasks$/.test(c.url); }));
const cm = d.getElementById("pj-cm-input");
env.w.__pjChat.open(101); await settle();
cm.value = "채팅";
cm.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Enter", isComposing: true, bubbles: true, cancelable: true })); await settle();
check("[16] 댓글 대화창도 조합 중 Enter 는 전송 안 함", posts().length === 1);
}
// ── [03] 파일 댓글 — 실패 파일 표시·유지, 성공 시 비움 ───────────
{
const env = makeEnv(); baseRoutes(env);
let mode = "fail";
env.route("POST", /\/project\/api\/tasks\/101\/comments\/files$/, function () {
if (mode === "fail") return { status: 400, body: { detail: { message: "보낼 수 없는 파일이 있어 댓글을 등록하지 않았습니다.", failed: [{ index: "1", name: "b.png", reason: "빈 파일" }] } } };
if (mode === "net") return "NETWORK";
return { status: 201, body: { comment: { id: 5, body: "" }, attachments: [], mention_skipped: [] } };
});
const P = await boot(env); const d = env.d;
env.w.__pjChat.open(101); await settle();
const cm = d.getElementById("pj-cm-input");
function pasteImg(name, content) {
const f = new env.w.File(content, name, { type: "image/png" });
const ev = new env.w.Event("paste", { bubbles: true, cancelable: true });
Object.defineProperty(ev, "clipboardData", { value: { items: [{ type: "image/png", getAsFile: function () { return f; } }], getData: function () { return ""; } } });
cm.dispatchEvent(ev);
}
pasteImg("a.png", ["aaa"]); pasteImg("b.png", []);
await settle();
d.getElementById("pj-cm-send").click(); await settle();
const chips = function () { return Array.from(d.querySelectorAll("#pj-cm-pending .pj-chat-pending-chip")); };
check("[03] 서버가 거절한 파일만 빨간 표시, 두 파일 모두 남음", chips().length === 2 && chips()[1].classList.contains("is-failed") && !chips()[0].classList.contains("is-failed"));
const sent = env.calls.filter(function (c) { return /comments\/files$/.test(c.url); });
check("[03] 파일은 본문과 한 요청으로(빈 댓글을 먼저 만들지 않음)", sent.length === 1 && !env.calls.some(function (c) { return c.method === "POST" && /101\/comments$/.test(c.url); }));
mode = "net";
d.getElementById("pj-cm-send").click(); await settle();
check("[03] 네트워크 오류 → 파일·입력 유지", chips().length === 2);
const tok1 = env.calls.filter(function (c) { return /comments\/files$/.test(c.url); }).pop().body.get("client_token");
mode = "ok";
d.getElementById("pj-cm-send").click(); await settle();
const tok2 = env.calls.filter(function (c) { return /comments\/files$/.test(c.url); }).pop().body.get("client_token");
check("[03] 응답을 못 받은 재전송은 같은 client_token(서버가 한 번만 만듦)", tok1 && tok1 === tok2);
check("[03] 성공하면 대기 파일 비움", chips().length === 0);
}
// ── [14] 작업 창 댓글에 파일 표시 ─────────────────────────
{
const env = makeEnv(); baseRoutes(env);
env.route("GET", /\/project\/api\/tasks\/101\/comments/, function () {
return { body: { comments: [{ id: 7, body: "", author_email: "me@test.local", created_at: "2026-09-30T10:00" },
{ id: 8, body: "답글", parent_id: 7, author_email: "me@test.local", created_at: "2026-09-30T10:01" }],
events: [], features: { replies: true } } };
});
env.route("GET", /\/project\/api\/tasks\/101\/attachments/, function () {
return { body: { attachments: [{ id: 70, comment_id: 7, filename: "<b>x</b>.pdf", content_type: "application/pdf", size_bytes: 10 },
{ id: 71, comment_id: 8, filename: "r.png", content_type: "image/png", size_bytes: 10 },
{ id: 72, comment_id: null, filename: "plain.txt", content_type: "text/plain", size_bytes: 10 }] } };
});
const P = await boot(env); const d = env.d;
await P.openTaskModal(taskOf(P, 101)); await settle();
const list = d.getElementById("pj-comment-list");
check("[14] 파일만 있는 댓글에 파일 표시", list.querySelector('a[href="/project/api/attachments/70/download"]') !== null);
check("[14] 파일명은 이스케이프(태그로 해석 안 됨)", !list.querySelector(".pj-comment-atts b") && list.textContent.includes("<b>x</b>.pdf"));
check("[14] 답글의 파일은 답글에", !!list.querySelector(".pj-comment-item.is-reply img[src='/project/api/attachments/71/inline']"));
check("[14] 댓글 아닌 첨부는 댓글에 안 섞임", !list.innerHTML.includes("attachments/72/"));
check("[14] 첨부 목록에 '댓글' 표시", d.getElementById("pj-attach-list").textContent.includes("댓글"));
}
// ── [12] 연결된 작업은 읽기 전용 ─────────────────────────
{
const env = makeEnv(); baseRoutes(env);
env.route("GET", /\/project\/api\/tasks\/301$/, function () {
return { body: { task: detail(301, "연결된 작업", { project_id: 3, project_name: "비밀", access: "read", followers: null, subtasks: [{ id: 3011, title: "읽기 하위", project_id: 3 }] }) } };
});
const P = await boot(env); const d = env.d;
const linked = P.state().tasks.find(function (t) { return t.id === 301; });
await P.openTaskModal(linked); await settle();
check("[12] 제목·담당자 편집 불가", d.getElementById("pj-t-title").readOnly && d.getElementById("pj-t-assignee").disabled);
check("[12] 읽기 전용 안내 표시", !d.getElementById("pj-t-readonly").hidden);
check("[12] 댓글 입력·완료·삭제 숨김", d.getElementById("pj-comment-dock").hidden && d.getElementById("pj-toggle-complete").hidden && d.getElementById("pj-delete-task").hidden);
check("[12] 하위 작업 추가 칸 숨김, 목록은 보임", d.querySelector(".pj-subtask-form").hidden && subsText(d).includes("읽기 하위"));
d.getElementById("pj-t-title").value = "바꿈";
d.getElementById("pj-t-title").dispatchEvent(new env.w.Event("blur")); await settle();
const puts12 = env.calls.filter(function (c) { return c.method === "PUT"; });
check("[12] 읽기 전용이면 저장 요청을 보내지 않음(뒤늦은 403 없음)", puts12.length === 0, puts12);
}
// ── [13][01] 실시간 동기화 — 실패 후 같은 버전 재시도, 전체 범위 반영, 권한 회수 ──
{
const env = makeEnv(); baseRoutes(env);
let ver = "v1", snapMode = "fail";
const dSnap = deferred();
env.route("GET", /\/project\/api\/live-version/, function () { return { body: { ts: ver } }; });
env.route("GET", /\/snapshot\?scope=all/, function () {
if (snapMode === "fail") return { status: 500, body: { detail: "잠시 오류" } };
if (snapMode === "slow") return dSnap.promise;
if (snapMode === "gone") return { status: 403, body: { detail: "권한 없음" } };
return { body: { scope: "all", project: { id: 1, name: "P1" },
projects: [{ id: 1, name: "P1", color: "#4573d2", status: "active" }],
tasks: [{ id: 101, title: "작업 A(새 제목)", project_id: 1, context_project_id: 1, stage_id: 11, stage_name: "할 일" },
{ id: 150, title: "다른 사람이 만든 작업", project_id: 1, context_project_id: 1, stage_id: 13, stage_name: "검토" }],
stages_by_project: { "1": [{ id: 11, project_id: 1, name: "할 일" }, { id: 13, project_id: 1, name: "검토" }] },
stages: [{ id: 11, project_id: 1, name: "할 일" }, { id: 13, project_id: 1, name: "검토" }],
members: [{ user_email: "me@test.local" }] } };
});
const P = await boot(env); const d = env.d;
const st = function () { return env.w.pjLiveRefreshState(); };
const poll = function () { return env.w.__pjLivePoll(); };
const nextDelay = function () { const t = env.slow.filter(function (s) { return s.fn === env.w.__pjLivePoll; }).pop(); return t && t.ms; };
check("[13] 처음 본 버전 = 반영된 버전", st().observed === "v1" && st().applied === "v1");
ver = "v2";
await poll(); await settle();
check("[13] 스냅샷 실패 → 반영 버전은 그대로(v1), 실패 1", st().observed === "v2" && st().applied === "v1" && st().failures === 1, st());
check("[13] 실패 뒤 다음 확인은 늘어난 간격(16초)", nextDelay() === 16000, nextDelay());
snapMode = "ok";
await poll(); await settle();
check("[13] 같은 버전 다음 요청 성공 → v2 반영", st().applied === "v2" && st().failures === 0, st());
const s = P.state();
check("[01] 다른 프로젝트(P2) 작업·사이드바 항목 제거(권한 회수)", !s.tasks.some(function (t) { return t.project_id === 2; }) && !s.projectsMeta.some(function (p) { return p.id === 2; }));
check("[01] 새 작업·새 섹션 반영", s.tasks.some(function (t) { return t.id === 150; }) && s.boardStages.includes("검토"));
check("[01] 제목 변경 반영", s.tasks.find(function (t) { return t.id === 101; }).title === "작업 A(새 제목)");
// 동기화 중 버전이 또 바뀌면 끝난 뒤 한 번 더
snapMode = "slow"; ver = "v3";
const firstPoll = poll();
await settle();
ver = "v4";
const snapsBefore = env.calls.filter(function (c) { return /snapshot/.test(c.url); }).length;
await poll(); // 동기화가 도는 중에 또 확인 — 겹쳐 받지 않는다
const snapsDuring = env.calls.filter(function (c) { return /snapshot/.test(c.url); }).length;
dSnap.resolve({ body: { tasks: [], projects: [{ id: 1, name: "P1", status: "active" }], stages_by_project: {}, stages: [], members: [] } });
await firstPoll; await settle();
check("[13] 동기화 중 새 버전(v4) — 겹쳐 돌지 않고 반영 버전은 v3", st().applied === "v3" && st().observed === "v4" && snapsDuring === snapsBefore, { st: st(), snapsBefore: snapsBefore, snapsDuring: snapsDuring });
snapMode = "ok";
await poll(); await settle();
check("[13] 다음 주기에 v4 반영", st().applied === "v4", st());
snapMode = "gone"; ver = "v5";
await poll(); await settle();
check("[01][02] 이 프로젝트 권한 회수 → 작업 비우고 안내", !!d.querySelector(".pj-access-lost") && P.state().tasks.length === 0);
}
clearTimeout(WATCHDOG);
console.log(fails.length ? "\nFAILED: " + fails.join(", ") : "\nALL PASS");
process.exit(fails.length ? 1 : 0);
})().catch(function (e) { console.error(e); process.exit(1); });
+71
View File
@@ -0,0 +1,71 @@
"""project/project.html 을 테스트용 HTML 로 렌더한다(erp_base.html 은 최소 스텁, 가상의 데이터).
python tests/js/render_project.py # → tests/js/.out/project_render.html
"""
from __future__ import annotations
import io
import os
import jinja2
ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
OUT_DIR = os.path.join(ROOT, "tests", "js", ".out")
BASE_STUB = ("{% block head_extra %}{% endblock %}<body>{% block topbar_actions %}{% endblock %}"
"<main class='erp-page'>{% block content %}{% endblock %}</main></body>")
ME = "me@test.local"
STAGES = {
1: [{"id": 11, "project_id": 1, "name": "할 일", "is_done_stage": False, "sort_order": 0, "color": None,
"created_by": ME, "default_assignee_email": ""},
{"id": 12, "project_id": 1, "name": "완료", "is_done_stage": True, "sort_order": 1, "color": None,
"created_by": ME, "default_assignee_email": ""}],
2: [{"id": 21, "project_id": 2, "name": "할 일", "is_done_stage": False, "sort_order": 0, "color": None,
"created_by": ME, "default_assignee_email": ""}],
}
def task(tid: int, title: str, pid: int, stage: int, *, ctx: int | None = None, linked: bool = False) -> dict:
return {"id": tid, "title": title, "project_id": pid, "context_project_id": ctx or pid, "is_linked": linked,
"stage_id": stage, "home_stage_id": stage, "stage_name": "할 일", "is_done_stage": False,
"description": "", "assignee_email": "", "assignee_name": "", "priority": "normal",
"start_date": None, "due_date": None, "completed_at": None, "created_by": ME,
"parent_task_id": None, "comment_count": 0, "subtask_count": 0, "subtask_done": 0,
"project_name": {1: "P1", 2: "P2", 3: "비밀"}[pid], "project_color": "#4573d2", "sort_order": tid}
TASKS = [task(101, "작업 A", 1, 11), task(102, "작업 B", 1, 11), task(103, "작업 C", 2, 21),
task(301, "연결된 작업", 3, 99, ctx=1, linked=True)]
PROJECTS = [{"id": 1, "name": "P1", "color": "#4573d2", "icon": "", "start_date": None, "due_date": None,
"created_by": ME, "description": "", "status": "active"},
{"id": 2, "name": "P2", "color": "#f06a6a", "icon": "", "start_date": None, "due_date": None,
"created_by": ME, "description": "", "status": "active"}]
def main() -> None:
env = jinja2.Environment(loader=jinja2.ChoiceLoader([
jinja2.DictLoader({"erp_base.html": BASE_STUB}),
jinja2.FileSystemLoader(os.path.join(ROOT, "app", "modules", "project", "templates")),
]))
env.globals["pj_kr_holidays"] = {}
html = env.get_template("project/project.html").render(
user={"email": ME, "is_super_admin": False}, is_admin=False, can_manage=True,
project=PROJECTS[0], current_project_id=1, stages=STAGES[1], tasks=TASKS,
members=[{"user_email": ME, "role": "member"}, {"user_email": "bob@test.local", "role": "member"}],
projects_meta=PROJECTS, nav_projects=PROJECTS, stages_by_project=STAGES, board_stage_names=["할 일", "완료"],
avatars={}, priority_labels={"low": "낮음", "normal": "보통", "high": "높음"},
color_palette=["#4573d2"], project_icons=["folder"], stage_color_palette=["#c7c4c4"],
today="2026-09-30", holidays={}, year=2026, month=9, prev_y=2026, prev_m=8, next_y=2026, next_m=10,
weekdays=["일", "월", "화", "수", "목", "금", "토"], weeks=[], goal_years=[2026],
my_open_total=0, mention_unread=0,
)
os.makedirs(OUT_DIR, exist_ok=True)
path = os.path.join(OUT_DIR, "project_render.html")
io.open(path, "w", encoding="utf-8", newline="\n").write(html)
print("rendered:", path)
if __name__ == "__main__":
main()
+471
View File
@@ -0,0 +1,471 @@
"""프로젝트 관리 모듈 — 권한·저장·댓글 첨부·알림 회귀 테스트 (실제 PostgreSQL + FastAPI TestClient).
운영 DB 와 분리된 **로컬 테스트용 PostgreSQL** 에서만 돈다. 가상의 사용자·프로젝트만 만든다.
# 1) 로컬 테스트 DB 에 스키마 적용(최초 1회): project_db_init.sql + project_db_0*.sql
# 2) 실행
PROJECT_TEST_DB_URL=postgresql://postgres@localhost:55432/project_db \
python tests/test_project_module.py
PROJECT_TEST_DB_URL 이 없거나 localhost/127.0.0.1 이 아니면 전부 건너뛴다(운영 DB 보호).
메일은 app.mail.send_email 을 가짜로 바꿔 기록만 한다(실제 발송 없음).
"""
from __future__ import annotations
import io
import os
import sys
import tempfile
import threading
import types
import uuid
from datetime import timedelta
from urllib.parse import urlparse
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
DSN = os.getenv("PROJECT_TEST_DB_URL", "")
_host = urlparse(DSN).hostname if DSN else None
ENABLED = bool(DSN) and _host in ("localhost", "127.0.0.1")
# ── app.main 대역(전체 앱을 띄우지 않고 프로젝트 라우터만 시험) ──────────────
class _Users:
def __init__(self) -> None:
self.d: dict[str, dict] = {}
def add(self, email: str, *, role: str = "user", project: bool = True, super_: bool = False) -> str:
email = email.lower()
self.d[email] = {"email": email, "name": email.split("@")[0], "role": role,
"modules": {"project": project}, "is_super_admin": super_}
return email
def get(self, email: str):
return self.d.get((email or "").lower())
def list_all(self):
return list(self.d.values())
USERS = _Users()
SENT_MAIL: list[dict] = []
if ENABLED:
from fastapi.responses import HTMLResponse
fake_main = types.ModuleType("app.main")
fake_main.user_store = USERS
def _current(request):
return USERS.get(request.headers.get("x-test-user", ""))
fake_main.get_current_user_record = _current
fake_main.build_erp_nav = lambda user, active="": []
fake_main.render_template = lambda request, name, ctx, status_code=200: HTMLResponse(
f"{name}|{ctx.get('reason', '')}", status_code=status_code)
sys.modules["app.main"] = fake_main
for k in list(os.environ):
if k.startswith("SMTP_") or k == "PROJECT_NOTIFY_EMAIL":
os.environ.pop(k)
import app.mail as _mail # noqa: E402
_mail.send_email = lambda **kw: SENT_MAIL.append(kw)
from fastapi import FastAPI # noqa: E402
from fastapi.testclient import TestClient # noqa: E402
from app.modules.project import reminders # noqa: E402
from app.modules.project import router as project_api_router # noqa: E402 - 패키지가 APIRouter 를 내보낸다
from app.modules.project.db import ProjectStore # noqa: E402
from app.timezone import today_kst # noqa: E402
ST = ProjectStore(DSN)
DATA_DIR = tempfile.mkdtemp(prefix="pj-test-")
APP = FastAPI()
APP.include_router(project_api_router)
APP.state.project_store = ST
APP.state.data_dir = DATA_DIR
CLIENT = TestClient(APP)
RUN = uuid.uuid4().hex[:6]
ADMIN = USERS.add(f"admin-{RUN}@test.local", role="admin")
SUPER = USERS.add("king@dbxcorp.co.kr", role="admin", super_=True)
ALICE = USERS.add(f"alice-{RUN}@test.local")
BOB = USERS.add(f"bob-{RUN}@test.local")
CAROL = USERS.add(f"carol-{RUN}@test.local")
DAVE = USERS.add(f"dave-{RUN}@test.local") # 프로젝트 권한은 있으나 어디에도 멤버 아님
EVE = USERS.add(f"eve-{RUN}@test.local", project=False) # 프로젝트 모듈 권한 없음
def req(method: str, url: str, who: str, **kw):
return CLIENT.request(method, url, headers={"x-test-user": who}, **kw)
def _project(name: str, owner: str, members: tuple[str, ...] = ()) -> dict:
p = ST.create_project(name=f"{name}-{uuid.uuid4().hex[:4]}", owner_email=owner, created_by=owner)
for m in members:
ST.add_member(project_id=p["id"], user_email=m)
return p
def _stage(pid: int, name: str = "할 일", done: bool = False, by: str = "") -> dict:
return ST.add_stage(project_id=pid, name=name, is_done_stage=done, created_by=by)
def _count(sql: str, *args) -> int:
with ST._pool.connection() as conn: # noqa: SLF001 - 테스트 전용 확인 쿼리
return int(conn.execute(sql, args).fetchone()["n"])
# ════════════════════════════════════════════════════════════
# [07] 소유자 변경은 관리자만
# ════════════════════════════════════════════════════════════
def test_owner_change_admin_only():
p = _project("P-owner", ADMIN, (BOB,))
r = req("PUT", f"/project/api/projects/{p['id']}", BOB, json={"owner_email": BOB})
assert r.status_code == 403, r.text
assert ST.get_project(project_id=p["id"])["owner_email"] == ADMIN
r = req("PUT", f"/project/api/projects/{p['id']}", BOB, json={"owner_email": CAROL, "name": "x"})
assert r.status_code == 403 and ST.get_project(project_id=p["id"])["name"] != "x"
# 같은 값을 같이 보내는 건(화면 저장) 통과
assert req("PUT", f"/project/api/projects/{p['id']}", BOB, json={"owner_email": ADMIN, "name": "ok"}).status_code == 200
# 관리자: 모듈 권한 없는 사람은 소유자 불가, 정상 사용자는 가능
assert req("PUT", f"/project/api/projects/{p['id']}", ADMIN, json={"owner_email": EVE}).status_code == 400
assert req("PUT", f"/project/api/projects/{p['id']}", ADMIN, json={"owner_email": CAROL}).status_code == 200
assert ST.get_project(project_id=p["id"])["owner_email"] == CAROL
# 소유자에서 빠지면(관리자가 다시 바꿈) 멤버가 아닌 CAROL 은 관리 권한을 잃는다
assert req("PUT", f"/project/api/projects/{p['id']}", ADMIN, json={"owner_email": ADMIN}).status_code == 200
assert req("GET", f"/project/api/projects/{p['id']}/snapshot", CAROL).status_code == 403
# 생성: 비관리자가 남을 소유자로 지정 → 거절, 본인·미지정 → 본인이 소유자
assert req("POST", "/project/api/projects", BOB, json={"name": "n1", "owner_email": CAROL}).status_code == 403
r = req("POST", "/project/api/projects", BOB, json={"name": "n2"})
assert r.status_code == 201 and r.json()["project"]["owner_email"] == BOB
# ════════════════════════════════════════════════════════════
# [06] 삭제 — 생성자 규칙 + 지금 권한
# ════════════════════════════════════════════════════════════
def test_delete_requires_current_access():
p = _project("P-del", ADMIN, (ALICE, BOB))
s = _stage(p["id"], by=ADMIN)
t = req("POST", f"/project/api/projects/{p['id']}/tasks", ALICE, json={"title": "alice task", "stage_id": s["id"]}).json()["task"]
ST.add_comment(task_id=t["id"], author_email=ALICE, author_name="a", body="hi")
trash_before = _count("SELECT COUNT(*) AS n FROM project_trash")
# 현재 멤버인 타인 → 생성자 규칙으로 거절
assert req("DELETE", f"/project/api/tasks/{t['id']}", BOB).status_code == 403
# 멤버에서 빠진 생성자 → 거절, 행·댓글·휴지통 변화 없음
ST.remove_member(project_id=p["id"], user_email=ALICE)
assert req("DELETE", f"/project/api/tasks/{t['id']}", ALICE).status_code == 403
assert ST.get_task(task_id=t["id"]) is not None
assert _count("SELECT COUNT(*) AS n FROM task_comments WHERE task_id = %s", t["id"]) == 1
assert _count("SELECT COUNT(*) AS n FROM project_trash") == trash_before
# 다시 멤버가 된 생성자 → 삭제(휴지통)
ST.add_member(project_id=p["id"], user_email=ALICE)
r = req("DELETE", f"/project/api/tasks/{t['id']}", ALICE)
assert r.status_code == 200 and ST.get_task(task_id=t["id"]) is None
# 프로젝트 삭제: 만든 사람이어도 지금 권한이 없으면 거절, 슈퍼관리자는 예외
p2 = _project("P-del2", ALICE)
ST.update_project(project_id=p2["id"], fields={"owner_email": ADMIN}) # 관리자가 소유자를 바꿈
assert req("DELETE", f"/project/api/projects/{p2['id']}", ALICE).status_code == 403
assert ST.get_project(project_id=p2["id"]) is not None
assert req("DELETE", f"/project/api/projects/{p2['id']}", SUPER).status_code == 200
# ════════════════════════════════════════════════════════════
# [02] 권한 회수 후 조회·변경·알림
# ════════════════════════════════════════════════════════════
def test_revoked_member_loses_everything():
p = _project("P-rev", ADMIN, (ALICE, BOB))
s = _stage(p["id"], by=ADMIN)
t = req("POST", f"/project/api/projects/{p['id']}/tasks", BOB,
json={"title": "shared", "stage_id": s["id"], "assignee_email": ALICE,
"description": f'<span class="pj-mention" data-email="{ALICE}">@a</span>'}).json()["task"]
c = req("POST", f"/project/api/tasks/{t['id']}/comments", ALICE, json={"body": "mine"}).json()["comment"]
assert any(x["id"] == t["id"] for x in req("GET", "/project/api/my-tasks", ALICE).json()["tasks"])
assert any(x["id"] == t["id"] for x in req("GET", "/project/api/mentions", ALICE).json()["tasks"])
assert any(n["task_id"] == t["id"] for n in req("GET", "/project/api/notifications", ALICE).json()["notifications"])
ST.remove_member(project_id=p["id"], user_email=ALICE)
assert not any(x["id"] == t["id"] for x in req("GET", "/project/api/my-tasks", ALICE).json()["tasks"])
assert not any(x["id"] == t["id"] for x in req("GET", "/project/api/mentions", ALICE).json()["tasks"])
assert not any(n.get("task_id") == t["id"] for n in req("GET", "/project/api/notifications", ALICE).json()["notifications"])
for m, u, body in (("GET", f"/project/api/tasks/{t['id']}", None),
("GET", f"/project/api/tasks/{t['id']}/comments", None),
("GET", f"/project/api/tasks/{t['id']}/attachments", None),
("PUT", f"/project/api/tasks/{t['id']}", {"title": "x"}),
("PUT", f"/project/api/comments/{c['id']}", {"body": "edited"}),
("DELETE", f"/project/api/comments/{c['id']}", None),
("POST", f"/project/api/tasks/{t['id']}/followers", {})):
r = req(m, u, ALICE, json=body) if body is not None else req(m, u, ALICE)
assert r.status_code == 403, (m, u, r.status_code)
assert ST.get_comment(comment_id=c["id"])["body"] == "mine"
assert req("GET", f"/project/t/{t['id']}", ALICE, follow_redirects=False).status_code == 403 # 옛 공유 링크
# 완료 알림은 권한 잃은 담당자에게 가지 않는다(담당자 기록은 남음)
before = _count("SELECT COUNT(*) AS n FROM project_notifications WHERE recipient_email=%s AND task_id=%s", ALICE, t["id"])
assert req("PUT", f"/project/api/tasks/{t['id']}", BOB, json={"completed": True}).status_code == 200
assert _count("SELECT COUNT(*) AS n FROM project_notifications WHERE recipient_email=%s AND task_id=%s", ALICE, t["id"]) == before
assert ST.get_task(task_id=t["id"])["assignee_email"] == ALICE
# 권한 없는 사람을 새 담당자로 지정할 수 없다
assert req("PUT", f"/project/api/tasks/{t['id']}", BOB, json={"assignee_email": DAVE}).status_code == 400
# 관리자·owner·멤버는 그대로
assert req("GET", f"/project/api/tasks/{t['id']}", ADMIN).status_code == 200
assert req("GET", f"/project/api/tasks/{t['id']}", BOB).status_code == 200
# ════════════════════════════════════════════════════════════
# [08] 비멤버 @태그
# ════════════════════════════════════════════════════════════
def test_mentions_only_for_people_who_can_see():
p = _project("P-men", ADMIN, (BOB,))
s = _stage(p["id"], by=ADMIN)
desc = "".join(f'<span class="pj-mention" data-email="{e}">@x</span>' for e in (DAVE, EVE, "ghost@nowhere.test"))
r = req("POST", f"/project/api/projects/{p['id']}/tasks", BOB, json={"title": "m", "stage_id": s["id"], "description": desc})
t = r.json()["task"]
assert set(r.json()["mention_skipped"]) == {DAVE, EVE, "ghost@nowhere.test"}
assert _count("SELECT COUNT(*) AS n FROM task_mentions WHERE task_id=%s", t["id"]) == 0
r = req("POST", f"/project/api/tasks/{t['id']}/comments", BOB, json={"body": "@dave hi", "mentions": [DAVE]})
assert r.status_code == 201 and r.json()["mention_skipped"] == [DAVE]
assert not req("GET", "/project/api/mentions", DAVE).json()["tasks"] or \
all(x["id"] != t["id"] for x in req("GET", "/project/api/mentions", DAVE).json()["tasks"])
# 멘션이 접근 권한을 만들지 않는다
assert req("GET", f"/project/api/tasks/{t['id']}", DAVE).status_code == 403
# 연결된 프로젝트 멤버는 태그 가능(읽기 권한)
p2 = _project("P-men2", ADMIN, (BOB, CAROL))
s2 = _stage(p2["id"], by=ADMIN)
assert req("POST", f"/project/api/tasks/{t['id']}/links", BOB, json={"project_id": p2["id"], "stage_id": s2["id"]}).status_code == 201
r = req("POST", f"/project/api/tasks/{t['id']}/comments", BOB, json={"body": "@carol", "mentions": [CAROL]})
assert r.json()["mention_skipped"] == []
assert any(x["id"] == t["id"] for x in req("GET", "/project/api/mentions", CAROL).json()["tasks"])
# 태그 후보 API 도 같은 기준
cands = {u["email"] for u in req("GET", f"/project/api/all-users?task_id={t['id']}", BOB).json()["users"]}
assert CAROL in cands and BOB in cands and DAVE not in cands and EVE not in cands
# ════════════════════════════════════════════════════════════
# [12] 연결된 프로젝트 — 읽기 전용
# ════════════════════════════════════════════════════════════
def test_linked_task_is_read_only():
home = _project("P-home", ADMIN, (BOB,))
other = _project("P-link", ADMIN, (BOB, CAROL))
secret = _project("P-secret", ADMIN, (BOB,))
hs, os_ = _stage(home["id"], by=ADMIN), _stage(other["id"], by=ADMIN)
os2 = _stage(other["id"], name="진행", by=ADMIN)
ss = _stage(secret["id"], by=ADMIN)
t = ST.create_task(project_id=home["id"], title="linked", stage_id=hs["id"], created_by=BOB)
sib = ST.create_task(project_id=home["id"], title="sibling", stage_id=hs["id"], created_by=BOB)
sub = ST.create_task(project_id=home["id"], title="child", parent_task_id=t["id"], created_by=BOB)
for pid, sid in ((other["id"], os_["id"]), (secret["id"], ss["id"])):
assert req("POST", f"/project/api/tasks/{t['id']}/links", BOB, json={"project_id": pid, "stage_id": sid}).status_code == 201
r = req("GET", f"/project/api/tasks/{t['id']}", CAROL)
assert r.status_code == 200 and r.json()["task"]["access"] == "read"
assert [ln["project_id"] for ln in r.json()["task"]["links"]] == [other["id"]] # 비밀 프로젝트는 숨김
assert r.json()["task"]["followers"] is None
assert req("GET", f"/project/api/tasks/{sub['id']}", CAROL).json()["task"]["access"] == "read" # 하위 작업도 읽기
assert req("GET", f"/project/api/tasks/{sib['id']}", CAROL).status_code == 403 # 원 소속의 다른 작업은 안 보임
assert req("GET", f"/project/api/projects/{home['id']}/members", CAROL).status_code == 403
assert req("GET", f"/project/api/tasks/{t['id']}/comments", CAROL).status_code == 200
for m, u, body in (("PUT", f"/project/api/tasks/{t['id']}", {"title": "hack"}),
("POST", f"/project/api/tasks/{t['id']}/comments", {"body": "hi"}),
("DELETE", f"/project/api/tasks/{t['id']}", None)):
r = req(m, u, CAROL, json=body) if body is not None else req(m, u, CAROL)
assert r.status_code == 403, (m, u, r.status_code)
assert ST.get_task(task_id=t["id"])["title"] == "linked"
# 연결된 프로젝트 안의 섹션 이동은 예전처럼 허용
assert req("POST", f"/project/api/tasks/{t['id']}/links", CAROL, json={"project_id": other["id"], "stage_id": os2["id"]}).status_code == 201
# 공유 링크 — 연결된 프로젝트 화면으로
r = req("GET", f"/project/t/{t['id']}", CAROL, follow_redirects=False)
assert r.status_code == 303 and r.headers["location"] == f"/project/p/{other['id']}?task={t['id']}"
# 전체 스냅샷에서 연결 행은 연결된 프로젝트 맥락으로 한 번씩(원 소속 행은 CAROL 에게 없음)
snap = req("GET", f"/project/api/projects/{other['id']}/snapshot?scope=all", CAROL).json()
rows = [x for x in snap["tasks"] if x["id"] == t["id"]]
assert [(x["context_project_id"], x["is_linked"]) for x in rows] == [(other["id"], True)]
# 연결 해제 후엔 볼 수 없다
assert req("DELETE", f"/project/api/tasks/{t['id']}/links/{other['id']}", BOB).status_code == 200
assert req("GET", f"/project/api/tasks/{t['id']}", CAROL).status_code == 403
# ════════════════════════════════════════════════════════════
# [03] 파일 댓글 — 원자적 등록·재전송 중복 방지
# ════════════════════════════════════════════════════════════
def test_file_comment_atomic_and_idempotent():
p = _project("P-file", ADMIN, (BOB, CAROL))
s = _stage(p["id"], by=ADMIN)
t = ST.create_task(project_id=p["id"], title="files", stage_id=s["id"], created_by=BOB)
url = f"/project/api/tasks/{t['id']}/comments/files"
n0 = _count("SELECT COUNT(*) AS n FROM task_comments WHERE task_id=%s", t["id"])
# JSON 경로: 예전 has_attachment 플래그로 빈 댓글을 만들 수 없다
assert req("POST", f"/project/api/tasks/{t['id']}/comments", BOB, json={"body": "", "has_attachment": True}).status_code == 400
# 한 파일이라도 문제면(빈 파일) 아무것도 만들지 않고 어느 파일인지 알려 준다
r = req("POST", url, BOB, files=[("files", ("ok.txt", b"hello", "text/plain")), ("files", ("empty.txt", b"", "text/plain"))])
assert r.status_code == 400 and [f["name"] for f in r.json()["detail"]["failed"]] == ["empty.txt"]
assert _count("SELECT COUNT(*) AS n FROM task_comments WHERE task_id=%s", t["id"]) == n0
assert not os.path.isdir(os.path.join(DATA_DIR, "project", str(t["id"]))) or \
not os.listdir(os.path.join(DATA_DIR, "project", str(t["id"])))
# 정상: 본문 없이 파일 두 개, 같은 토큰으로 두 번 보내도 한 번만
files = [("files", ("a.png", b"\x89PNG....", "image/png")), ("files", ("b.pdf", b"%PDF-1", "application/pdf"))]
r1 = req("POST", url, BOB, data={"client_token": "tok-1"}, files=files)
r2 = req("POST", url, BOB, data={"client_token": "tok-1"}, files=files)
assert r1.status_code == 201 and r2.status_code == 201
assert r1.json()["comment"]["id"] == r2.json()["comment"]["id"] and r2.json().get("duplicate")
cid = r1.json()["comment"]["id"]
assert _count("SELECT COUNT(*) AS n FROM task_comments WHERE task_id=%s", t["id"]) == n0 + 1
assert _count("SELECT COUNT(*) AS n FROM task_attachments WHERE comment_id=%s", cid) == 2
# DB 저장 실패 → 방금 쓴 파일도 지우고 댓글 없음
orig = ST.add_comment_with_attachments
ST.add_comment_with_attachments = lambda **kw: (_ for _ in ()).throw(RuntimeError("db down"))
try:
before_files = set(os.listdir(os.path.join(DATA_DIR, "project", str(t["id"]))))
try:
req("POST", url, BOB, files=[("files", ("c.txt", b"data", "text/plain"))])
except RuntimeError:
pass # TestClient 가 서버 예외를 그대로 올린다(운영에선 500)
assert set(os.listdir(os.path.join(DATA_DIR, "project", str(t["id"])))) == before_files
finally:
ST.add_comment_with_attachments = orig
assert _count("SELECT COUNT(*) AS n FROM task_comments WHERE task_id=%s", t["id"]) == n0 + 1
# 남의 댓글에 파일을 붙일 수 없다
r = req("POST", f"/project/api/tasks/{t['id']}/attachments", CAROL,
data={"comment_id": str(cid)}, files={"file": ("x.txt", b"x", "text/plain")})
assert r.status_code == 403
# 동시에 같은 토큰 두 개 → 댓글 하나
out = []
ths = [threading.Thread(target=lambda: out.append(req("POST", url, BOB, data={"client_token": "tok-par"},
files=[("files", ("p.txt", b"p", "text/plain"))]).json()))
for _ in range(2)]
[th.start() for th in ths]
[th.join() for th in ths]
assert len({o["comment"]["id"] for o in out}) == 1
# ════════════════════════════════════════════════════════════
# [04] 날짜 범위
# ════════════════════════════════════════════════════════════
def test_date_range_validation():
p = _project("P-date", ADMIN, (BOB,))
s = _stage(p["id"], by=ADMIN)
base = f"/project/api/projects/{p['id']}/tasks"
assert req("POST", base, BOB, json={"title": "bad", "stage_id": s["id"], "start_date": "2026-10-05", "due_date": "2026-10-01"}).status_code == 400
t = req("POST", base, BOB, json={"title": "ok", "stage_id": s["id"], "start_date": "2026-10-01", "due_date": "2026-10-05"}).json()["task"]
u = f"/project/api/tasks/{t['id']}"
assert req("PUT", u, BOB, json={"due_date": "2026-09-30"}).status_code == 400 # 한쪽만 바꿔도 최종 상태 검사
assert ST.get_task(task_id=t["id"])["due_date"] == "2026-10-05"
assert req("PUT", u, BOB, json={"start_date": None}).status_code == 200 # null 로 지우기
assert req("PUT", u, BOB, json={"due_date": "2026-09-30"}).status_code == 200 # 시작일 없으면 허용
assert req("PUT", u, BOB, json={"start_date": "2026-09-30", "start_time": "18:00", "due_time": "09:00"}).status_code == 400
assert req("PUT", u, BOB, json={"start_date": "2026-09-30", "start_time": "00:00", "due_time": "23:59"}).status_code == 200
assert req("PUT", u, BOB, json={"start_date": "2026-09-30", "start_time": "09:00", "due_time": "09:00"}).status_code == 200
# 프로젝트도 같은 규칙(부분 수정 포함)
pu = f"/project/api/projects/{p['id']}"
assert req("PUT", pu, BOB, json={"start_date": "2026-11-01", "due_date": "2026-10-01"}).status_code == 400
assert req("PUT", pu, BOB, json={"due_date": "2026-10-01"}).status_code == 200
assert req("PUT", pu, BOB, json={"start_date": "2026-11-01"}).status_code == 400
assert req("POST", "/project/api/projects", BOB, json={"name": "d", "start_date": "2026-11-02", "due_date": "2026-11-01"}).status_code == 400
# ════════════════════════════════════════════════════════════
# [11] 완료 섹션에 바로 만든 작업
# ════════════════════════════════════════════════════════════
def test_create_in_done_stage_completes():
p = _project("P-done", ADMIN, (ALICE, BOB))
todo, done = _stage(p["id"], by=ADMIN), _stage(p["id"], name="완료", done=True, by=ADMIN)
SENT_MAIL.clear()
r = req("POST", f"/project/api/projects/{p['id']}/tasks", BOB, json={"title": "done now", "stage_id": done["id"], "assignee_email": ALICE})
t = r.json()["task"]
assert t["completed_at"] and "_newly_completed" not in t
assert _count("SELECT COUNT(*) AS n FROM project_activity WHERE task_id=%s AND action='completed'", t["id"]) == 1
assert _count("SELECT COUNT(*) AS n FROM project_notifications WHERE task_id=%s AND type='completed' AND recipient_email=%s", t["id"], ALICE) == 1
# 일반 섹션 생성 → 미완료, 완료 섹션으로 이동 → 완료(이력 1건 더), 이탈 → 미완료
t2 = req("POST", f"/project/api/projects/{p['id']}/tasks", BOB, json={"title": "later", "stage_id": todo["id"]}).json()["task"]
assert not t2["completed_at"]
assert req("PUT", f"/project/api/tasks/{t2['id']}", BOB, json={"stage_id": done["id"]}).json()["task"]["completed_at"]
assert not req("PUT", f"/project/api/tasks/{t2['id']}", BOB, json={"stage_id": todo["id"]}).json()["task"]["completed_at"]
# 섹션 없는 하위 작업: 수동 완료/취소
sub = req("POST", f"/project/api/projects/{p['id']}/tasks", BOB, json={"title": "sub", "parent_task_id": t2["id"]}).json()["task"]
assert sub["stage_id"] is None and not sub["completed_at"]
assert req("PUT", f"/project/api/tasks/{sub['id']}", BOB, json={"completed": True}).json()["task"]["completed_at"]
assert not req("PUT", f"/project/api/tasks/{sub['id']}", BOB, json={"completed": False}).json()["task"]["completed_at"]
# ════════════════════════════════════════════════════════════
# [15] 마감 알림 — 원자적·재시도·중복 방지·권한
# ════════════════════════════════════════════════════════════
def test_due_reminders_atomic_and_access():
p = _project("P-rem", ADMIN, (ALICE, BOB))
s = _stage(p["id"], by=ADMIN)
today = today_kst()
t_ok = ST.create_task(project_id=p["id"], title=f"rem-ok-{RUN}", stage_id=s["id"], assignee_email=BOB, due_date=today.isoformat(), created_by=BOB)
t_gone = ST.create_task(project_id=p["id"], title=f"rem-gone-{RUN}", stage_id=s["id"], assignee_email=ALICE, due_date=today.isoformat(), created_by=BOB)
t_fail = ST.create_task(project_id=p["id"], title=f"FAILME-{RUN}", stage_id=s["id"], assignee_email=BOB, due_date=today.isoformat(), created_by=BOB)
ST.remove_member(project_id=p["id"], user_email=ALICE)
q = "SELECT COUNT(*) AS n FROM project_notifications WHERE task_id=%s AND type='due_today'"
qr = "SELECT COUNT(*) AS n FROM task_reminders WHERE task_id=%s"
with ST._pool.connection() as conn: # noqa: SLF001 - 테스트 DB 에서만: 알림 생성 실패 흉내
conn.execute(f"ALTER TABLE project_notifications ADD CONSTRAINT test_fail_{RUN} CHECK (title NOT LIKE '%%FAILME-{RUN}%%')")
try:
reminders.run_due_reminders(ST, today=today, lookup=USERS.get)
assert _count(q, t_ok["id"]) == 1 and _count(q, t_gone["id"]) == 0
assert _count(q, t_fail["id"]) == 0 and _count(qr, t_fail["id"]) == 0 # 실패 → 기록도 되돌려짐
finally:
with ST._pool.connection() as conn: # noqa: SLF001
conn.execute(f"ALTER TABLE project_notifications DROP CONSTRAINT test_fail_{RUN}")
reminders.run_due_reminders(ST, today=today, lookup=USERS.get) # 재실행: 실패분만 생성
assert _count(q, t_fail["id"]) == 1 and _count(q, t_ok["id"]) == 1
# 동시 실행에도 중복 없음
t_par = ST.create_task(project_id=p["id"], title=f"rem-par-{RUN}", stage_id=s["id"], assignee_email=BOB, due_date=today.isoformat(), created_by=BOB)
ths = [threading.Thread(target=reminders.run_due_reminders, args=(ST,), kwargs={"today": today, "lookup": USERS.get}) for _ in range(4)]
[th.start() for th in ths]
[th.join() for th in ths]
assert _count(q, t_par["id"]) == 1
assert _count(q, t_gone["id"]) == 0 and _count(qr, t_gone["id"]) == 0
# ════════════════════════════════════════════════════════════
# [01] 전체 범위 스냅샷 — 다른 프로젝트의 생성·삭제·섹션 변경·권한 회수
# ════════════════════════════════════════════════════════════
def test_snapshot_all_scope():
a = _project("P-sa", ADMIN, (BOB,))
b = _project("P-sb", ADMIN, (BOB,))
sa, sb = _stage(a["id"], by=ADMIN), _stage(b["id"], by=ADMIN)
tb = ST.create_task(project_id=b["id"], title="in b", stage_id=sb["id"], created_by=BOB)
snap = req("GET", f"/project/api/projects/{a['id']}/snapshot?scope=all", BOB).json()
assert {a["id"], b["id"]} <= {x["id"] for x in snap["projects"]}
assert any(x["id"] == tb["id"] for x in snap["tasks"]) and str(b["id"]) in snap["stages_by_project"]
sb2 = _stage(b["id"], name="new", by=ADMIN)
ST.delete_task(task_id=tb["id"], deleted_by=BOB)
snap = req("GET", f"/project/api/projects/{a['id']}/snapshot?scope=all", BOB).json()
assert not any(x["id"] == tb["id"] for x in snap["tasks"])
assert sb2["id"] in [s["id"] for s in snap["stages_by_project"][str(b["id"])]]
ST.remove_member(project_id=b["id"], user_email=BOB)
snap = req("GET", f"/project/api/projects/{a['id']}/snapshot?scope=all", BOB).json()
assert b["id"] not in {x["id"] for x in snap["projects"]} and str(b["id"]) not in snap["stages_by_project"]
ST.remove_member(project_id=a["id"], user_email=BOB)
assert req("GET", f"/project/api/projects/{a['id']}/snapshot?scope=all", BOB).status_code == 403
_ = sa
def test_store_date_range_unit():
from app.modules.project import store
store.validate_date_range(None, "2026-01-01")
store.validate_date_range("2026-01-01", None, "10:00", None)
store.validate_date_range("2026-01-01", "2026-01-01", "23:59", None)
for args in (("2026-01-02", "2026-01-01"), ("2026-01-01", "2026-01-01", "10:01", "10:00")):
try:
store.validate_date_range(*args)
except ValueError:
continue
raise AssertionError(args)
if __name__ == "__main__":
if not ENABLED:
print("SKIP: PROJECT_TEST_DB_URL(localhost) not set")
sys.exit(0)
n = 0
for name, fn in sorted(globals().items()):
if name.startswith("test_") and callable(fn):
fn()
n += 1
print("ok", name)
print(f"{n} tests passed")
ST.close()
_ = io, timedelta