feat(performance): 자동 업데이트 일정 설정 — 매출·광고비 따로 간격·요일·시작/끝
- 실적 설정 "자동 업데이트" 카드(관리자): 매출 실적·광고비 각각 사용·요일([매일]·[평일])· 시작/끝 시각(5분 단위)·간격(5~720분, 5분 단위, 기본 30분), PUT /api/auto-sync-schedule - 마이그레이션 011 perf_settings(key auto_sync, JSONB). 미적용·값 없음 = 기본 일정(매일 9~19시 30분) - auto_sync: 종류별 일정·Scheduler(1분마다 다시 읽어 바뀐 종류만 다시 계산, 종류마다 따로 스레드) - 매출·광고비 탭 카운트다운이 각자 일정대로 다음 회차 계산(nextScheduleSlot) - 테스트: 일정 계산·검증·Scheduler·저장 API·브라우저(설정 카드·카운트다운) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -390,6 +390,7 @@ DDL: `scripts/sql/performance_db_init.sql` (멱등). DB·역할(`performance_app
|
||||
| `perf_connection_status` | 연결 상태·마지막 테스트/동기화·최근 오류(비밀값 가린 문구) |
|
||||
| `perf_sales_events` | 매출 사건(결제 +, 취소·반품 −, BIGINT 원). `UNIQUE(marketplace_code, event_type, external_event_id)`. `is_sample`=테스트 데이터 |
|
||||
| `perf_sync_runs` | 동기화 기록. `status='running'` 부분 유니크 인덱스로 같은 쇼핑몰 동시 실행 차단 |
|
||||
| `perf_settings` | (마이그레이션 011) 설정 값 — 키 하나 = JSONB. `auto_sync` = 매출·광고비 자동 업데이트 일정(간격·요일·시작/끝) |
|
||||
|
||||
핵심 규칙:
|
||||
|
||||
|
||||
@@ -272,6 +272,18 @@ docker exec postgres-db psql -U postgres -d performance_db -c "\d perf_ad_spend"
|
||||
되돌리기(계산식 표시만 사라짐, 금액 그대로):
|
||||
`docker exec postgres-db psql -U postgres -d performance_db -c "ALTER TABLE perf_manual_sales DROP COLUMN formula; ALTER TABLE perf_ad_spend DROP COLUMN formula;"`
|
||||
|
||||
## 실적 자동 업데이트 일정 마이그레이션 (performance_db 011)
|
||||
|
||||
011은 `perf_settings` 표 하나만 만든다(기존 표·값 그대로, 다시 실행 가능). 실적 설정 "자동 업데이트" 카드에서 매출 실적·광고비 따로
|
||||
간격(기본 30분, 5분 단위)·요일·시작/끝 시각을 저장한다. 미적용이어도 예전처럼 기본 일정(매일 `PERFORMANCE_AUTO_SYNC_HOURS` 9~19시 30분마다)으로 돌고,
|
||||
카드 [저장]만 503 안내. 새 환경변수 없음.
|
||||
|
||||
```bash
|
||||
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_011_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d performance_db < scripts/sql/performance_db_011_settings.sql && docker compose up --build -d --no-deps web
|
||||
```
|
||||
|
||||
되돌리기(일정이 기본값으로): `docker exec postgres-db psql -U postgres -d performance_db -c "DROP TABLE perf_settings;"`
|
||||
|
||||
## 실적 날짜 칸 메모 마이그레이션 (performance_db 010)
|
||||
|
||||
010은 `perf_cell_memos` 표 하나만 만든다(기존 표·값 그대로, 다시 실행 가능). 매출 실적·광고비 일자별 표의 금액 입력 칸 우클릭 → 메모 삽입·수정·삭제.
|
||||
|
||||
@@ -347,13 +347,20 @@
|
||||
|
||||
- `SyncService.sync_all()` / `sync_marketplace()` — 버튼·자동 업데이트 공용. 기본 기간: 오늘 포함 최근
|
||||
`PERFORMANCE_SYNC_DAYS`(기본 7)일.
|
||||
- **자동 업데이트**(`auto_sync.py`, 2026-10-13): 웹 프로세스 시작 때 데몬 스레드(`main._lifespan`) — 매일 **09:00~19:00(KST)
|
||||
- **자동 업데이트**(`auto_sync.py`, 2026-10-13): 웹 프로세스 시작 때 데몬 스레드(`main._lifespan`) — 기본 매일 **09:00~19:00(KST)
|
||||
정각·30분마다**(하루 21회) **오늘 포함 최근 10일**을 [매출 업데이트]와 같은 방식(진행 창 작업 `jobs`, `trigger='schedule'`(DB CHECK 허용값),
|
||||
사용자 "자동 업데이트")으로 다시 가져온다. 그 시각에 다른 업데이트가 돌고 있으면 그 회차는 건너뜀, 30분을 넘긴 회차 뒤엔
|
||||
밀린 회차를 몰아서 돌리지 않고 다음 회차부터, 서버 시작 시각 회차는 돌리지 않음. 자동 업데이트 중 누가 버튼을 누르면 그 진행
|
||||
창을 같이 본다(취소는 관리자). 수동 입력 전용 쇼핑몰은 대상 아님. env `PERFORMANCE_AUTO_SYNC`(false=끄기)·
|
||||
`PERFORMANCE_AUTO_SYNC_DAYS`(10)·`PERFORMANCE_AUTO_SYNC_HOURS`(9-19). uvicorn 단일 워커 기준(여러 프로세스면 회차마다 겹쳐
|
||||
`PERFORMANCE_AUTO_SYNC_DAYS`(10)·`PERFORMANCE_AUTO_SYNC_HOURS`(9-19, 일정 저장 전 기본 시간대). uvicorn 단일 워커 기준(여러 프로세스면 회차마다 겹쳐
|
||||
돌지만 같은 쇼핑몰 동시 실행은 DB 에서 막힘).
|
||||
- **자동 업데이트 일정 설정**(2026-10-26, 마이그레이션 011 `perf_settings`): 실적 설정 "자동 업데이트" 카드(관리자)에서 **매출 실적·광고비를 따로** —
|
||||
사용 여부 · 요일(월~일 동그라미, [매일]·[평일]) · 시작/끝 시각(시·분 고르기, 5분 단위) · 간격(5~720분, 5분 단위, 기본 30분).
|
||||
회차 = 고른 요일의 시작, 시작+간격, … 끝 시각까지(끝과 딱 맞으면 끝도, 시작 = 끝이면 하루 한 번). 밤을 넘기는 시간대는 안 됨(끝 ≥ 시작).
|
||||
저장 = `PUT /api/auto-sync-schedule {sales: 일정, ads: 일정}` → `perf_settings` key `auto_sync`(JSONB). 일정 = `{enabled, interval, days(0=월…6=일), start "HH:MM", end "HH:MM"}`.
|
||||
스레드(`auto_sync.Scheduler`)는 1분마다 일정을 다시 읽어 바뀐 종류만 지금부터 다음 회차를 다시 계산(저장 직후 회차는 안 돌림), 회차가 되면 그 종류만 따로 스레드로
|
||||
(`run_once(kinds=(kind,))`). 저장 값이 없거나 011 미적용·값이 깨졌으면 그 종류는 기본 일정. 화면 카운트다운은 매출 탭 = 매출 일정, 광고비 탭 = 광고비 일정
|
||||
(`router._auto_sync_ctx(store, kind)` → `performance.js nextScheduleSlot`, 같은 규칙). env `PERFORMANCE_AUTO_SYNC=false` 면 일정과 상관없이 안 돈다(카드에 안내).
|
||||
- **대시보드 [매출 업데이트]** = 지금 보고 있는 기간(오늘까지)을 `POST /api/sync {from, to}` 로 다시 가져온다
|
||||
("이번달"이면 1일~오늘). 모듈 권한자는 92일까지, 더 긴 기간(올해 등, 최대 366일)은 관리자만.
|
||||
- **과거 매출 가져오기**(설정 화면, 관리자): 같은 API 로 임의 기간(최대 366일). 같은 사건은 덮어써서 여러 번 해도 중복 없음.
|
||||
@@ -488,7 +495,7 @@
|
||||
- **저장**(`db.replace_ad_api_range`, 한 트랜잭션): API 가 준 날은 `source='api'` 로 덮어씀(직접 입력·업로드 값이 있던 날도),
|
||||
기간 안에서 API 가 안 준 날(광고 없음)은 **예전 API 값만** 지움 — 직접 입력·업로드 값은 그대로. 화면 초록 숫자 = API 값.
|
||||
- **언제**: 광고비 탭 **[구글 광고 불러오기]**(설정된 연동만 보임, 지금 보는 기간 → 오늘까지, 모듈 권한자 92일·관리자 366일,
|
||||
`POST /api/ad-sources/{code}/sync`) + **매출 자동 업데이트 회차**(같은 최근 N일, 매출 다음에, 실패해도 매출과 무관 — `auto_sync.run_once`).
|
||||
`POST /api/ad-sources/{code}/sync`) + **광고비 자동 업데이트 일정**(같은 최근 N일, 실적 설정 "자동 업데이트"의 광고비 일정 — 매출과 따로, 실패해도 매출과 무관 — `auto_sync.run_once`).
|
||||
- API: `GET|PUT /api/ad-sources/{code}/credentials`·`POST /api/ad-sources/{code}/test`(관리자), `POST /api/ad-sources/{code}/sync`(모듈 권한).
|
||||
- 007 미적용: 설정 카드에 안내, 저장은 503(안내 문구), 광고비 탭은 그대로(불러오기 버튼만 안 보임).
|
||||
- **대시보드** `/performance/?period=day|week|month|year|custom&d=&from=&to=&m=<쇼핑몰>…`
|
||||
|
||||
Reference in New Issue
Block a user