61f5b3c320
2시간 칸 × 날짜 달력(카드 머리 = Tiktok Handle, SALES·COM·Fee), 끌어 옮기기· 맞바꾸기, Jump to Date, 날짜별 합계·광고비·ROAS 를 넣는다. 호스트 비용 = 시간 × RM 25 + 판매금액 10%, 표 보기에도 표시한다. 끝 시간을 필수로 바꾸고 광고비 표는 마이그레이션 002 로 추가한다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
695 lines
44 KiB
Markdown
695 lines
44 KiB
Markdown
# Deployment
|
|
|
|
## 기본 배포 흐름
|
|
|
|
```text
|
|
[Windows 개발 PC]
|
|
│ git push (Gitea)
|
|
▼
|
|
[Gitea Repository]
|
|
│ git pull (서버에서)
|
|
▼
|
|
[Ubuntu Server]
|
|
│ .env 확인 → docker compose up --build -d
|
|
▼
|
|
[Docker]
|
|
│ main-app, postgres 컨테이너 실행
|
|
▼
|
|
[NPM (Nginx Proxy Manager)]
|
|
│ 외부 HTTPS 종단 → 내부 :80
|
|
▼
|
|
[서비스 정상 동작]
|
|
```
|
|
|
|
---
|
|
|
|
## 운영 서버 배포 경로
|
|
|
|
운영 서버는 Ubuntu Server. 동일 호스트에 여러 서비스가 있으므로 경로를 분리한다.
|
|
|
|
| 경로 | 용도 |
|
|
| --- | --- |
|
|
| **`/opt/www/main`** | **main-app (본 프로젝트) 배포 경로 — 기본** |
|
|
| `/opt/dbx-corm` | CORM (CS/발주/반품/코드관리) 서비스 경로 |
|
|
| `/opt/dbx-orderlist` | 주문관리/orderlist 서비스 경로 |
|
|
|
|
> main-app 관련 모든 명령/문서 작성 시 `/opt/www/main` 사용.
|
|
> 새로운 경로가 필요하면 **사용자 지시**를 받은 뒤 결정한다.
|
|
|
|
CORM 로그인·권한은 ERP 중앙 확인 방식으로 연결한다. CORM의 `ERP_AUTH_URL`
|
|
(기본 `http://dbx-main:8000/api/auth/check`)은 매 요청 ERP의 현재 사용자/권한을 확인한다.
|
|
ERP를 먼저 배포하고 CORM을 뒤에 배포한다. 설정·상태 확인·검증은 [CORM 중앙 인증](CORM_AUTH.md)을 따른다.
|
|
|
|
---
|
|
|
|
## 사전 준비
|
|
|
|
- 서버에 Docker, Docker Compose 설치 완료
|
|
- Gitea 접근 권한 있는 SSH/HTTPS 인증 설정 완료
|
|
- NPM에 호스트 매핑 등록: `dbx.no1king.freeddns.org → http://192.168.0.194:80`
|
|
- `.env` 값 확보 (Google OAuth, 세션 키, DB 비밀번호 등)
|
|
|
|
---
|
|
|
|
## 최초 배포
|
|
|
|
```bash
|
|
# 1) main-app 배포 경로
|
|
sudo mkdir -p /opt/www/main
|
|
sudo chown $USER:$USER /opt/www/main
|
|
cd /opt/www/main
|
|
|
|
# 2) 저장소 클론
|
|
git clone https://gitea.no1king.freeddns.org/king/dbx-main.git .
|
|
|
|
# 3) 환경 변수 파일 준비
|
|
cp .env.example .env
|
|
nano .env # 실제 값으로 수정 (절대 Git에 커밋 금지)
|
|
|
|
# 4) 빌드 및 백그라운드 실행
|
|
docker compose up --build -d
|
|
|
|
# 5) 로그 확인
|
|
docker compose logs -f
|
|
```
|
|
|
|
---
|
|
|
|
## 업데이트 배포
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
git pull
|
|
docker compose up --build -d
|
|
docker compose logs -f --tail=200
|
|
```
|
|
|
|
---
|
|
|
|
## 주간 회의록 셀 병합 마이그레이션
|
|
|
|
주간 회의록 셀 병합을 배포할 때는 `project_db`의 최근 백업 위치를 확인한 뒤 마이그레이션 019를 적용한다.
|
|
DB는 공용 `postgres-db` 컨테이너의 PostgreSQL(컨테이너 포트 5432)을 사용한다. 019는 기존 글을 바꾸지 않고
|
|
`content_row_span` 열을 추가하며, 다시 실행할 수 있다. 미적용 시 다른 셀 편집은 가능하지만 병합은 사용할 수 없다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker compose ps
|
|
docker exec postgres-db psql -U postgres -d project_db -c 'SELECT current_database();'
|
|
# project_db 최근 백업 위치를 확인한 후 적용
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_019_meeting_cell_editing.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT column_name FROM information_schema.columns WHERE table_name = 'goal_meeting_items' AND column_name = 'content_row_span';"
|
|
```
|
|
|
|
## 주간 회의록 새 주차·결과 글·주차별 목표 마이그레이션 (020)
|
|
|
|
020은 `goal_meeting_items.result_note` 열·`goal_week_targets` 표를 추가하고, `goal_meetings` 의 "월요일만" CHECK 를 없애며,
|
|
새 주차 규칙에 흡수된 월요일 회의록을 새 주차 시작일로 옮긴다(옮길 자리에 회의록이 있으면 NOTICE 만). 다시 실행할 수 있다.
|
|
코드는 020 전에도 열리지만 결과 글·주차별 목표·월요일이 아닌 주차 회의록 만들기는 020 뒤에 된다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_020_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_020_meeting_periods.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT to_regclass('goal_week_targets') AS t, (SELECT count(*) FROM information_schema.columns WHERE table_name='goal_meeting_items' AND column_name='result_note') AS note;"
|
|
```
|
|
|
|
## 주간 회의록 "회의록 보드"(Google 슬라이드) 설정
|
|
|
|
회의록 화면의 [회의록 보드] 는 주차마다 빈 Google 슬라이드를 공유 드라이브(`MEETING_BOARD_FOLDER_ID`, 기본 `0AGF3CIEboPQiUk9PVA`)에
|
|
만들어 새 창으로 연다(`app/integrations/google_slides.py`). DB 변경 없음. 인증은 쿠팡 시트와 같은 Google 설정을 쓰되 **Drive·Slides 권한**이 더 필요하다.
|
|
|
|
1. Google Cloud Console(OAuth 클라이언트가 있는 프로젝트) → API 라이브러리에서 **Google Drive API**, **Google Slides API** 사용 설정
|
|
2. 개발 PC에서 토큰 재발급(시트·Drive·Slides 권한을 한 번에 받는다) — 공유 드라이브에 쓸 수 있는 계정으로 로그인·동의
|
|
```bash
|
|
python scripts/google_sheets_authorize.py --client-id <ID> --client-secret <SECRET>
|
|
```
|
|
3. 서버 `/opt/www/main/.env` 의 `GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN` 을 새 토큰으로 바꾸고(쿠팡 시트도 같은 토큰으로 계속 동작)
|
|
`docker compose up -d` 로 다시 띄운다. 토큰은 비밀값 — Git·메신저에 남기지 않는다.
|
|
|
|
설정이 없거나 권한이 모자라면 버튼을 눌렀을 때 사유가 안내되고(503), 회의록 다른 기능은 그대로 동작한다.
|
|
|
|
## Project 업무 파일 → 구글 드라이브 설정 (2026-10-19)
|
|
|
|
업무 설명란·보드 카드·세부 업무 줄에 파일을 끌어 놓으면 구글 드라이브 `PROJECT_DRIVE_FOLDER_ID`(기본 `1Zdak2FtACRJ6peOnA9zD22hsbbsTixJG`)
|
|
아래 `프로젝트/섹션/업무/세부 업무` 폴더에 올리고 설명에 링크를 넣는다(`app/integrations/google_drive.py`). DB 변경 없음.
|
|
인증은 위 회의록 보드와 같은 Google 설정(Drive 권한)을 쓴다.
|
|
|
|
- 그 폴더에 **편집 권한**이 있는 계정이어야 한다 — OAuth 토큰이면 토큰을 발급한 계정, 서비스 계정이면 서비스 계정 이메일을 폴더에 편집자로 추가.
|
|
서비스 계정은 저장 용량이 없어 **내 드라이브 폴더에는 못 올린다**(공유 드라이브 폴더 필요) — 그 경우 화면에 사유가 뜬다.
|
|
- 링크를 본 사람이 파일을 열려면 그 폴더가 직원들에게 공유돼 있어야 한다(드라이브 폴더 공유 설정).
|
|
- 설명에서 링크를 지우면 그 파일을 드라이브 휴지통으로(30일 뒤 드라이브가 지움). 이 기능으로 올린 파일만(appProperties `dbxTaskId`).
|
|
|
|
## 주간 회의록 항목 칸 묶음 마이그레이션 (027)
|
|
|
|
027은 `goal_meeting_items.label_cont` 열만 추가한다(기본 false, 기존 값 그대로, 다시 실행 가능). 미적용이면 "주요 업무" 칸의
|
|
같은 항목 칸 줄 추가·항목 칸 나누기만 503 안내, 나머지는 그대로.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_027_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_027_meeting_label_groups.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT column_name FROM information_schema.columns WHERE table_name='goal_meeting_items' AND column_name='label_cont';"
|
|
```
|
|
|
|
## 담당자·협업자 겹침 정리 마이그레이션 (028)
|
|
|
|
028은 스키마를 바꾸지 않고, 담당자와 같은 사람인 협업자 행(`task_followers`)만 지운다(담당자는 협업자가 아니다 — 2026-10-13).
|
|
다시 실행해도 같고, 지운 행 수를 NOTICE 로 보여 준다. 앱은 새 코드부터 담당자를 협업자로 넣지 않으므로, 028 을 늦게 적용해도
|
|
새로 겹치는 행은 생기지 않는다(예전 겹친 행만 남음). 되돌리기 = 아래 백업에서 task_followers 만 복원.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_028_$(date +%Y%m%d%H%M).sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT COUNT(*) FROM task_followers f JOIN tasks t ON t.id = f.task_id WHERE COALESCE(t.assignee_email,'') <> '' AND lower(f.user_email) = lower(t.assignee_email);"
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_028_followers_exclude_assignee.sql
|
|
```
|
|
|
|
## Project 옵션(시스템 전체 설정) 마이그레이션 (029)
|
|
|
|
029는 `project_options` 테이블만 추가한다(키 하나 = 행 하나, 기존 값 변경 없음, 다시 실행 가능). 수퍼관리자·Admin 이 Project 옵션 창에서
|
|
바꾸는 "처음 여는 탭"·"보드 카드 표지"를 모든 사용자에게 적용하는 저장소다. 행이 없으면 기본값(보드·표지 켬).
|
|
미적용이면 화면은 기본값으로 열리고, 옵션 저장만 503 안내(폰트는 브라우저 저장이라 그대로 동작).
|
|
되돌리기 = `DROP TABLE project_options;`(사용자 확인 후 — 저장한 시스템 설정만 사라지고 기본값으로).
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_029_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_029_project_options.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT key, value, updated_by, updated_at FROM project_options;"
|
|
```
|
|
|
|
## 실적 수동 입력·열 순서 마이그레이션 (performance_db 002)
|
|
|
|
002는 `perf_marketplaces.manual_input` 열(기본 꺼짐) + `perf_manual_sales` 표를 추가하고, 쇼핑몰 순서(`sort_order`)를
|
|
카페24·네이버·쿠팡·토스·GS샵·11번가·오늘의집·G마켓·카카오·롯데ON 으로 바꾼다(기존 매출·인증정보 그대로, 다시 실행 가능).
|
|
미적용이면 수동 입력 토글·저장만 503 안내, 나머지 실적 화면은 그대로 동작한다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_002_$(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_002_manual_sales.sql
|
|
docker exec postgres-db psql -U postgres -d performance_db -c "SELECT code, sort_order, manual_input FROM perf_marketplaces ORDER BY sort_order;"
|
|
```
|
|
|
|
## 실적 쇼핑몰 순서·신규 수동 입력 쇼핑몰 마이그레이션 (performance_db 003)
|
|
|
|
003은 기존 `쿠팡` 이름을 `쿠팡(윙)` 으로 바꾸고, 수동 입력 전용 쇼핑몰 `쿠팡(로켓)`(`coupang_rocket`)·`애터미아자몰`(`atomy`)을
|
|
`manual_input = TRUE` 로 추가하며, 순서를 카페24·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰 로
|
|
바꾼다(기존 매출·인증정보 그대로, 다시 실행 가능). 002 뒤에 적용한다. 미적용이면 새 쇼핑몰 2곳만 화면에 안 나온다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_003_$(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_003_marketplace_order.sql
|
|
```
|
|
|
|
## 실적 네이버 이름 마이그레이션 (performance_db 004)
|
|
|
|
004는 `perf_marketplaces` 의 `naver` 이름만 `네이버 스마트스토어` → `네이버` 로 바꾼다(다시 실행 가능). 미적용이면 설정 화면에 예전 이름이 남는다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d performance_db < scripts/sql/performance_db_004_naver_name.sql
|
|
```
|
|
|
|
## 실적 광고비 마이그레이션 (performance_db 005)
|
|
|
|
005는 광고비 표 `perf_ad_spend` 하나만 만든다(기존 표·데이터 그대로, 다시 실행 가능). 미적용이면 광고비 탭에 안내가 나오고 입력·업로드가 503.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_005_$(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_005_ad_spend.sql
|
|
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 "DROP TABLE perf_ad_spend;"`
|
|
|
|
## 실적 광고비 ROAS·보고서 항목 마이그레이션 (performance_db 006)
|
|
|
|
006은 `perf_ad_spend` 에 `roas`·`metrics` 열 두 개만 더한다(기존 값 그대로, 다시 실행 가능). 005 다음에 적용한다.
|
|
미적용이면 네이버 보고서 업로드·네이버 일자별 상세만 503 안내, 나머지 광고비 화면은 그대로.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_006_$(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_006_ad_roas_metrics.sql
|
|
docker exec postgres-db psql -U postgres -d performance_db -c "\d perf_ad_spend"
|
|
```
|
|
|
|
되돌리기(보고서 ROAS·상세만 사라짐): `docker exec postgres-db psql -U postgres -d performance_db -c "ALTER TABLE perf_ad_spend DROP COLUMN metrics, DROP COLUMN roas;"`
|
|
|
|
## 실적 광고 API 연동 마이그레이션 (performance_db 007)
|
|
|
|
007은 광고 API(구글 광고) 인증정보 표 `perf_ad_credentials`·연결 상태 표 `perf_ad_source_status` 두 개만 만든다(기존 표·데이터 그대로,
|
|
다시 실행 가능). 005·006 다음에 적용한다. 미적용이면 실적 설정 → 광고 API 연동 카드에 안내가 나오고 저장이 503, 광고비 탭은 그대로.
|
|
새 환경변수 없음 — 인증정보는 설정 화면에서 입력하고 기존 `APP_ENCRYPTION_KEY` 로 암호화된다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_007_$(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_007_ad_api.sql
|
|
docker exec postgres-db psql -U postgres -d performance_db -c "\dt perf_ad_*"
|
|
```
|
|
|
|
되돌리기(광고 API 인증정보·상태만 사라짐, 가져온 광고비는 perf_ad_spend 에 남음):
|
|
`docker exec postgres-db psql -U postgres -d performance_db -c "DROP TABLE perf_ad_source_status, perf_ad_credentials;"`
|
|
|
|
## 실적 날짜 칸 계산식 마이그레이션 (performance_db 008)
|
|
|
|
008은 `perf_manual_sales.formula`·`perf_ad_spend.formula` 열 두 개만 추가한다(기존 행·값 그대로, 다시 실행 가능). 002·005 다음에 적용한다.
|
|
날짜 칸에 `1000+2000` 같은 계산식을 넣으면 금액은 계산 결과로 저장되고 식은 이 열에 남는다(다시 누르면 식, 파랑 굵은 숫자).
|
|
미적용이어도 앱은 그대로 동작한다 — 계산 결과만 저장되고 식·굵은 표시는 남지 않는다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_008_$(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_008_cell_formula.sql
|
|
docker exec postgres-db psql -U postgres -d performance_db -c "\d perf_ad_spend" -c "\d perf_manual_sales"
|
|
```
|
|
|
|
되돌리기(계산식 표시만 사라짐, 금액 그대로):
|
|
`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` 표 하나만 만든다(기존 표·값 그대로, 다시 실행 가능). 매출 실적·광고비 일자별 표의 금액 입력 칸 우클릭 → 메모 삽입·수정·삭제.
|
|
미적용이어도 화면은 그대로 — 메모 저장만 503 안내. 새 환경변수 없음.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_010_$(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_010_cell_memos.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
되돌리기(메모만 사라짐): `docker exec postgres-db psql -U postgres -d performance_db -c "DROP TABLE perf_cell_memos;"`
|
|
|
|
## 실적 직접 추가 쇼핑몰·그룹 마이그레이션 (performance_db 009)
|
|
|
|
009는 `perf_marketplaces` 에 `is_custom`·`is_group`·`parent_code` 열 세 개만 추가한다(기존 행·값 그대로, 기존 쇼핑몰은 모두 FALSE/NULL, 다시 실행 가능).
|
|
002 다음에 적용한다. 미적용이어도 앱은 그대로 동작한다 — 설정의 [쇼핑몰 추가]·[그룹 추가]만 503 안내(드래그 순서는 기존 `sort_order` 라 009 없이도 됨).
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres performance_db > ~/performance_db_before_009_$(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_009_custom_marketplaces.sql
|
|
docker exec postgres-db psql -U postgres -d performance_db -c "\d perf_marketplaces"
|
|
```
|
|
|
|
되돌리기(직접 추가한 쇼핑몰·그룹을 화면에서 먼저 삭제한 뒤):
|
|
`docker exec postgres-db psql -U postgres -d performance_db -c "ALTER TABLE perf_marketplaces DROP COLUMN parent_code, DROP COLUMN is_group, DROP COLUMN is_custom;"`
|
|
|
|
## 회의록 작업 등록 표 — 작업 칸 마이그레이션 (026)
|
|
|
|
026은 `goal_meeting_tasks.parent_task_id` 열만 추가한다(기존 값 그대로, 다시 실행 가능). 025 뒤에 적용한다. 미적용이면 작업 칸을 고를 때만 503 안내.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_026_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_026_meeting_quick_parent_task.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT column_name FROM information_schema.columns WHERE table_name='goal_meeting_tasks' AND column_name='parent_task_id';"
|
|
```
|
|
|
|
## 회의록 작업 등록 표 마이그레이션 (025)
|
|
|
|
025는 `goal_meeting_tasks` 테이블만 추가한다(기존 값 그대로, 다시 실행 가능). 작업 등록 표를 주차별로 서버에 두어 모두가 같이 본다.
|
|
미적용이면 표 자리에 "마이그레이션 025 필요" 안내만 나오고(브라우저에 남은 예전 표는 지우지 않고 기다린다), 회의록 다른 기능은 그대로.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_025_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_025_meeting_quick_tasks.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT to_regclass('goal_meeting_tasks') AS t;"
|
|
```
|
|
|
|
## 입출고 관리 DB 생성 (inout_db, 2026-10-16)
|
|
|
|
새 DB 라 기존 DB·데이터는 건드리지 않는다(초기화 SQL 은 멱등, DROP·TRUNCATE 없음).
|
|
**비밀번호를 DSN 에 그대로 넣지 않는다** — `@`·`:`·`/`·`#`·`%` 같은 문자가 있으면 주소가 깨져 앱이 DB 를 못 찾고
|
|
(`failed to resolve host '…@postgres-db'`) 화면은 30초 뒤 500(PoolTimeout)이 된다(2026-10-16 실제 발생). 아래처럼 URL 인코딩해서 넣는다.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull
|
|
docker exec postgres-db psql -U postgres -lqt | cut -d| -f1 | grep -w inout_db || echo "inout_db 없음 — 새로 만든다"
|
|
read -s -p "inout_app password: " APP_PWD; echo
|
|
docker exec -i postgres-db psql -U postgres -v app_password="$APP_PWD" < scripts/sql/inout_db_init.sql
|
|
ENC=$(APP_PWD="$APP_PWD" python3 -c "import os,urllib.parse;print(urllib.parse.quote(os.environ['APP_PWD'],safe=''))")
|
|
# .env 끝에 줄바꿈이 없으면 앞 줄에 붙으므로 printf 로 새 줄부터, 이미 있으면 그 줄을 바꾼다
|
|
grep -q "^INOUT_DB_URL=" .env && sed -i "s|^INOUT_DB_URL=.*|INOUT_DB_URL=postgresql://inout_app:${ENC}@postgres-db:5432/inout_db|" .env \
|
|
|| printf '\nINOUT_DB_URL=postgresql://inout_app:%s@postgres-db:5432/inout_db\n' "$ENC" >> .env
|
|
docker compose up --build -d --force-recreate web
|
|
docker exec dbx-main python -c "import os,psycopg; psycopg.connect(os.environ['INOUT_DB_URL']).execute('select 1 from inout_roles limit 1'); print('DB OK')"
|
|
curl -s http://127.0.0.1:8080/inout/health # {"status":"ok"} — DSN 이 있다는 뜻일 뿐, 실제 연결 확인은 위 DB OK
|
|
```
|
|
|
|
그다음 ERP 관리자 화면에서 쓸 사람에게 **입출고 관리** 권한 → 입출고 관리 → 옵션에서 공장·발주 담당·입고 담당 지정.
|
|
|
|
## 안내문 발송 DB 생성 (outreach_db, 2026-10-27)
|
|
|
|
입출고 DB 와 같은 방법(새 DB — 기존 DB·데이터는 건드리지 않음, 초기화 SQL 멱등, 비밀번호는 URL 인코딩).
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull
|
|
docker exec postgres-db psql -U postgres -lqt | cut -d| -f1 | grep -w outreach_db || echo "outreach_db 없음 — 새로 만든다"
|
|
read -s -p "outreach_app password: " APP_PWD; echo
|
|
docker exec -i postgres-db psql -U postgres -v app_password="$APP_PWD" < scripts/sql/outreach_db_init.sql
|
|
ENC=$(APP_PWD="$APP_PWD" python3 -c "import os,urllib.parse;print(urllib.parse.quote(os.environ['APP_PWD'],safe=''))")
|
|
grep -q "^OUTREACH_DB_URL=" .env && sed -i "s|^OUTREACH_DB_URL=.*|OUTREACH_DB_URL=postgresql://outreach_app:${ENC}@postgres-db:5432/outreach_db|" .env \
|
|
|| printf '\nOUTREACH_DB_URL=postgresql://outreach_app:%s@postgres-db:5432/outreach_db\n' "$ENC" >> .env
|
|
docker compose up --build -d --force-recreate web
|
|
docker exec dbx-main python -c "import os,psycopg; psycopg.connect(os.environ['OUTREACH_DB_URL']).execute('select 1 from outreach_recipients limit 1'); print('DB OK')"
|
|
```
|
|
|
|
그다음 ERP 관리자 화면에서 쓸 사람에게 **안내문 발송** 권한 → 안내문 발송 → [Gmail 연결](입출고·휴가와 같은 연결) → 설정에서 제목·본문·사진 확인.
|
|
백업: 매일 `docker exec postgres-db pg_dump -U postgres outreach_db > /var/backups/postgres/outreach_db_$(date +%F).sql`.
|
|
백업: 매일 `docker exec postgres-db pg_dump -U postgres inout_db > /var/backups/postgres/inout_db_$(date +%F).sql`.
|
|
|
|
## 라이브 커머스 DB 생성 (live_db, 2026-11-04)
|
|
|
|
입출고 DB 와 같은 방법(새 DB — 기존 DB·데이터는 건드리지 않음, 초기화 SQL 멱등, 비밀번호는 URL 인코딩). 호스트 계좌·주소 등 개인정보가 들어가므로 백업 파일 권한에 주의.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull
|
|
docker exec postgres-db psql -U postgres -lqt | cut -d'|' -f1 | grep -w live_db || echo "live_db 없음 — 새로 만든다"
|
|
read -s -p "live_app password: " APP_PWD; echo
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -v app_password="$APP_PWD" < scripts/sql/live_db_init.sql
|
|
ENC=$(APP_PWD="$APP_PWD" python3 -c "import os,urllib.parse;print(urllib.parse.quote(os.environ['APP_PWD'],safe=''))")
|
|
grep -q "^LIVE_DB_URL=" .env && sed -i "s|^LIVE_DB_URL=.*|LIVE_DB_URL=postgresql://live_app:${ENC}@postgres-db:5432/live_db|" .env \
|
|
|| printf '\nLIVE_DB_URL=postgresql://live_app:%s@postgres-db:5432/live_db\n' "$ENC" >> .env
|
|
docker compose up --build -d --no-deps web
|
|
docker exec dbx-main python -c "import os,psycopg; psycopg.connect(os.environ['LIVE_DB_URL']).execute('select 1 from live_hosts limit 1'); print('DB OK')"
|
|
```
|
|
|
|
이미 만든 live_db 에는 `scripts/sql/live_db_002_ad_spend.sql`(날짜별 광고비 표 하나 추가, 다시 실행 가능)을 백업 뒤 적용한다 — 초기화 SQL 을 다시 돌리면 `live_app` 비밀번호를 다시 넣게 되므로 쓰지 않는다.
|
|
되돌리기 = `DROP TABLE live_daily_ad_spend;`(광고비 값만 사라짐).
|
|
|
|
그다음 ERP 관리자 화면에서 쓸 사람에게 **라이브 커머스** 권한 → ERP 관리자가 라이브 커머스 → 호스트 설정에서 호스트 등록.
|
|
백업: 매일 `docker exec postgres-db pg_dump -U postgres live_db > /var/backups/postgres/live_db_$(date +%F).sql`.
|
|
|
|
## 연간 목표 주차별 매출 목표 두 칸 마이그레이션 (project_db 030)
|
|
|
|
030은 `goal_week_targets` 에 `value_dist`(유통·인플)·`value_mall`(카페24·네이버) 열만 추가한다(다시 실행 가능, 기존 값 변경 없음, 새 환경변수 없음).
|
|
`value`(주차 합계)는 그대로 쓰므로 회의록 누적 목표는 바뀌지 않는다. 미적용이면 주차 입력 창이 예전처럼 한 칸.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_030_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_030_week_target_split.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
## 프로젝트 소유자 멤버 등록 마이그레이션 (project_db 031)
|
|
|
|
031은 스키마 변경 없이 `project_members` 에 소유자 행이 없는 프로젝트만 소유자를 넣는다(다시 실행 가능, 지우거나 바꾸지 않음).
|
|
앱은 이제 만들 때·소유자 변경 때 소유자를 멤버로 넣고, 소유자는 멤버에서 뺄 수 없다. 순서 무관(미적용이어도 앱은 동작 — 예전 프로젝트 소유자만 멤버 목록에 안 보임).
|
|
되돌리기 = 적용 직전 백업에서 `project_members` 만 복원.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_031_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_031_owner_as_member.sql && docker compose build web && docker compose up -d web
|
|
```
|
|
|
|
## 보드 연결 업무 순서 마이그레이션 (project_db 032)
|
|
|
|
032는 `task_project_links` 에 `sort_order` 열 하나만 추가한다(다시 실행 가능, 기존 값 변경 없음, 새 환경변수 없음).
|
|
보드에서 연결 업무(● 다른 프로젝트 이름이 붙은 카드)를 끌어 옮긴 자리를 저장 — 미적용이면 앱은 예전 그대로(연결 카드가 끌어도 제자리로 돌아감).
|
|
되돌리기 = `ALTER TABLE task_project_links DROP COLUMN sort_order;`(앱은 열이 없으면 예전 방식).
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_032_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_032_link_sort_order.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
## 안내문 발송 DM 본문 저장 마이그레이션 (outreach_db 002)
|
|
|
|
002는 `outreach_dm_bodies` 표 하나만 추가한다(다시 실행 가능, 기존 표·값 변경 없음, 새 환경변수 없음, `outreach_app` 에 CRUD·시퀀스 권한).
|
|
DM 수동 보내기 탭에서 고친 본문을 저장·골라 쓰기·지우기. 미적용이면 앱은 그대로(저장 목록 자리에 "마이그레이션 002 필요" 안내, 저장 API 503).
|
|
되돌리기 = `DROP TABLE outreach_dm_bodies;`(저장한 본문만 사라짐).
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres outreach_db > ~/outreach_db_before_002_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d outreach_db < scripts/sql/outreach_db_002_dm_bodies.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
## 입출고 관리 박스 입수 마이그레이션 (inout_db 007)
|
|
|
|
007은 `inout_products.body_per_box`·`lid_per_box` 열 두 개만 추가한다(통·뚜껑이 한 박스에 몇 개, 뚜껑 없으면 빈칸). 다시 실행 가능, 기존 데이터 변경 없음,
|
|
새 환경변수 없음. 004 다음에 적용한다. 미적용이어도 앱은 그대로 — 옵션 → 상품 정보에 두 열이 안 보이고 새 발주서에 박스·파렛트 계산이 없을 뿐.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_007_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_007_box_qty.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
되돌리기(박스 입수만 사라짐): `docker exec postgres-db psql -U postgres -d inout_db -c "ALTER TABLE inout_products DROP COLUMN body_per_box, DROP COLUMN lid_per_box;"`
|
|
|
|
## 입출고 관리 상품 그룹·색상 마이그레이션 (inout_db 006)
|
|
|
|
006은 표 1개·열 3개만 추가한다 — `inout_product_groups`(그룹 이름·은 함유량·색상·순서)·`inout_products.group_id`·`inout_products.color`·
|
|
`inout_order_lines.color`(발주 당시 색상 사본). 다시 실행 가능, 기존 데이터 변경 없음, 새 환경변수 없음. 004 다음에 적용한다.
|
|
미적용이어도 발주·입고·메일은 그대로 — 옵션 → 상품 정보에 "006 필요" 안내만 나오고 그룹·색상 칸이 없다.
|
|
적용 뒤 옵션(톱니) → **상품 정보** → 그룹을 만들고(은 함유량·색상) 상품마다 그룹을 고른 뒤 [변경 저장].
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_006_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_006_product_groups.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
되돌리기(그룹·색상만 사라짐): 백업에서 복원.
|
|
|
|
## 입출고 관리 물류센터 이메일·입고 요청 메일 마이그레이션 (inout_db 005)
|
|
|
|
005는 표 2개만 추가한다 — `inout_settings`(모듈 설정: 물류센터 담당자 이메일·입고 요청 메일 참조, 참조 기본값 `king@dbxcorp.co.kr, bj@dbxcorp.co.kr` 한 줄 넣음)·
|
|
`inout_receipt_mails`(입고 요청 메일 보낸 기록, 입고를 지우면 함께). 다시 실행 가능, 기존 데이터 변경 없음, 새 환경변수 없음(Gmail 은 003 과 같은 연결).
|
|
미적용이어도 입고·발주는 그대로 — 입고 요청 메일 미리보기·발송은 되지만(받는 사람 직접 입력) 옵션 → 물류센터 저장과 보낸 기록만 안 됨.
|
|
적용 뒤 옵션(톱니) → **물류센터** 탭에 물류센터 담당자 이메일을 넣는다. 입고 담당도 처음 한 번 [Gmail 연결]이 필요하다.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull && docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_005_$(date +%Y%m%d%H%M).sql && docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_005_receipt_mail.sql && docker compose up --build -d --no-deps web
|
|
```
|
|
|
|
## 입출고 관리 상품 정보 마이그레이션 (inout_db 004)
|
|
|
|
004는 표 2개(`inout_products` 상품 정보 — 단가·무게(개당 g)·은 함유량(%), `inout_products_excluded` 지운 단품)와
|
|
`inout_order_lines` 의 `unit_price`·`weight_g`·`silver_pct` 열(발주할 때 값 사본)을 추가한다. 다시 실행 가능, 기존 데이터 변경 없음, 새 환경변수 없음.
|
|
적용 뒤 옵션(톱니) → 상품 정보 → [단품 불러오기] 를 한 번 누르면 그때부터 발주서 제품은 그 목록에서 고른다.
|
|
|
|
```bash
|
|
cd /opt/www/main && git pull
|
|
docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_004_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_004_products.sql
|
|
docker compose up --build -d web
|
|
```
|
|
|
|
## 입출고 관리 발주 메일·입고증 사진 마이그레이션 (inout_db 003)
|
|
|
|
003은 공장 이메일 열, Gmail 연결(토큰 암호문)·발주 메일 기록·입고증 사진 표만 추가한다(다시 실행 가능, 기존 값 변경 없음).
|
|
미적용이어도 발주·입고는 그대로(사진·메일만 안내). 발주 메일은 **구글 클라우드 준비(관리자 1회)**가 필요하다 — `docs/INOUT_MODULE.md` 6-1:
|
|
Gmail API 사용 · OAuth 동의 화면에 `…/auth/gmail.send` 범위 · 로그인용 OAuth 클라이언트에 리디렉션 URI `{PUBLIC_BASE_URL}/inout/gmail/callback`.
|
|
새 환경변수 없음(`APP_ENCRYPTION_KEY`·`GOOGLE_CLIENT_ID/SECRET`·`PUBLIC_BASE_URL` 재사용).
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_003_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_003_mail_photos.sql
|
|
grep -c "^APP_ENCRYPTION_KEY=" .env # 1 이어야 Gmail 연결 저장 가능
|
|
```
|
|
|
|
## 입출고 관리 공장 담당자 마이그레이션 (inout_db 002)
|
|
|
|
002는 `inout_factories.manager`(담당자) 열만 추가한다(다시 실행 가능). 예전 "담당자·연락처" 한 칸에 숫자 없이 이름만 있던 값은 담당자로 옮긴다.
|
|
미적용이면 공장 저장만 안내(발주·입고는 그대로).
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres inout_db > ~/inout_db_before_002_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d inout_db < scripts/sql/inout_db_002_factory_manager.sql
|
|
docker exec postgres-db psql -U postgres -d inout_db -c "SELECT name, manager, contact FROM inout_factories ORDER BY id;"
|
|
```
|
|
|
|
## 긴급 공지 마이그레이션 (024)
|
|
|
|
024는 `urgent_notices`·`urgent_notice_targets`·`urgent_notice_acks`·`urgent_notice_images` 테이블만 추가한다(기존 값 그대로, 다시 실행 가능).
|
|
새 환경변수 없음(`PROJECT_DB_URL` 연결 풀을 같이 씀). 미적용이면 `/notice/` 는 "준비 필요" 안내, 공지 API 는 503, 화면 스크립트는 조용히 멈춘다.
|
|
상세는 `docs/NOTICE_MODULE.md`.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_024_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_024_urgent_notices.sql
|
|
docker exec postgres-db psql -U postgres -d project_db -c "SELECT to_regclass('urgent_notices') AS t;"
|
|
```
|
|
|
|
## PC 알림 프로그램 마이그레이션 (023)
|
|
|
|
023은 `notifier_links`·`notifier_tokens` 테이블만 추가한다(기존 값 그대로, 다시 실행 가능). 미적용이면 `/project/notifier` 화면은
|
|
"마이그레이션 필요" 안내만, PC 알림 API 는 503.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_023_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_023_notifier.sql
|
|
```
|
|
|
|
내려받기 파일(선택): 개발 PC 에서 `desktop/notifier/build.ps1` 로 만든 `dist/DBXNotifier.exe` 를 서버로 옮긴 뒤 컨테이너 데이터 볼륨에 둔다.
|
|
없으면 화면에 "관리자에게 받으세요"만 나온다(공유 드라이브로 나눠 줘도 된다).
|
|
|
|
```bash
|
|
cd /opt/www/main && docker compose exec web mkdir -p /data/notifier && docker compose cp ~/DBXNotifier.exe web:/data/notifier/DBXNotifier.exe
|
|
```
|
|
|
|
## 주간 회의록 회의 완료 마이그레이션 (022)
|
|
|
|
022는 `goal_meetings` 에 `completed_at`·`completed_by` 열만 추가한다(기존 값 그대로, 다시 실행 가능). 미적용이면 [회의 완료] 버튼이 나오지 않고
|
|
회의록은 누구나 계속 고칠 수 있다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_022_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_022_meeting_complete.sql
|
|
```
|
|
|
|
## 주간 회의록 정량 목표·결과 글 마이그레이션 (021)
|
|
|
|
021은 `goal_meeting_items` 에 `target_text`·`result_text` 열만 추가한다(기존 값 그대로, 다시 실행 가능). 미적용이면 정량 목표·결과는 예전처럼 숫자만 받는다.
|
|
|
|
```bash
|
|
cd /opt/www/main
|
|
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_021_$(date +%Y%m%d%H%M).sql
|
|
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_021_meeting_amount_text.sql
|
|
```
|
|
|
|
---
|
|
|
|
## 컨테이너 관리
|
|
|
|
자산관리의 `asset_db` 생성은 사용자가 서버 명령으로 직접 진행한다 (2026-10-06).
|
|
이미 생성한 DB에 프로그램을 적용할 때는 초기화 SQL을 다시 실행할 필요가 없다.
|
|
`ASSET_DB_URL=postgresql://asset_app:<URL-encoded-password>@postgres-db:5432/asset_db`를 설정한다.
|
|
원본 XML까지 DB 백업에 포함되며 별도 업로드 볼륨은 필요 없다.
|
|
자산 사진·모니터 연결·수퍼 관리자 삭제 기능을 기존 설치에 추가할 때는 `asset_db` 백업 후
|
|
`scripts/sql/asset_db_002_photos_monitors.sql`을 먼저 적용하고 web을 재빌드한다.
|
|
사진도 DB 백업에 포함된다. 실행 명령은 [자산관리 설치 문서](ASSET_MODULE.md#기존-설치에-사진모니터삭제-기능-적용)를 참조한다.
|
|
DB 미설정 시에도 기존 모듈은 동작하고 자산관리에서 설정 안내/보고서 분석을 제공한다.
|
|
상태·백업 확인과 초기화 순서는 [ASSET_MODULE.md](ASSET_MODULE.md#저장소와-설치) 참조.
|
|
|
|
```bash
|
|
docker compose ps # 상태 확인
|
|
docker compose restart web # 단일 서비스 재시작
|
|
docker compose stop # 중지 (볼륨 유지)
|
|
docker compose down # 컨테이너 제거 (볼륨 유지)
|
|
# docker compose down -v # ⚠ 볼륨까지 삭제. 운영에서 금지
|
|
```
|
|
|
|
> `docker compose down -v`, `docker volume rm`, `docker system prune -a --volumes` 는 **사용자 승인 없이 실행 금지**.
|
|
|
|
---
|
|
|
|
## .env / 비밀값 관리
|
|
|
|
- `.env`, `.env.local`, `.env.production` 은 **절대 Git에 올리지 않는다**.
|
|
- 예시 파일(`.env.example`)만 커밋한다.
|
|
- 신규 변수 추가 시 `.env.example`과 본 문서를 함께 갱신한다.
|
|
- 비밀값 유출 의심 시 즉시 회전(rotate)한다 (특히 `GOOGLE_CLIENT_SECRET`, `SESSION_SECRET_KEY`, DB 비밀번호).
|
|
|
|
### 주요 환경 변수
|
|
|
|
| 변수 | 설명 |
|
|
| --- | --- |
|
|
| `GOOGLE_CLIENT_ID` | Google OAuth 클라이언트 ID |
|
|
| `GOOGLE_CLIENT_SECRET` | Google OAuth 클라이언트 보안 비밀 |
|
|
| `SESSION_SECRET_KEY` | 세션 쿠키 서명용 랜덤 문자열 |
|
|
| `SESSION_COOKIE_SECURE` | HTTPS 환경 `true` / 로컬 HTTP `false` |
|
|
| `PUBLIC_BASE_URL` | 외부 접속 주소 (예: `https://dbx.no1king.freeddns.org`) |
|
|
| `CS_ORDER_URL` | CS 발주 업무 버튼 이동 주소 |
|
|
| `CUSTOMER_ORDER_LIST_URL` | 고객 주문리스트 프로그램 버튼 이동 주소 |
|
|
| `*_DB_HOST`, `*_DB_USER`, `*_DB_PASSWORD`, `*_DB_NAME` | 각 PostgreSQL DB 접속 정보 |
|
|
| `EXPENSE_DB_URL` | 개인경비 DB DSN (예: `postgresql://expense_app:<pwd>@postgres-db:5432/expense_db`). 미설정 시 JSON 폴백 |
|
|
| `CUPANG_DB_URL` | 쿠팡 밀크런 DB DSN (예: `postgresql://cupang_app:<pwd>@postgres-db:5432/cupang_db`). **필수** — 미설정 시 모듈 비활성(설정 필요 안내) |
|
|
| `CUPANG_SHEET_ID` | 쿠팡 밀크런 [분배 확정]·출고 삭제 동기화 문서 — 구글 드라이브의 .xlsx 파일 id(기본 `1J74op7lBZOgE27p4R28I3RWsv0EtXdii`) 또는 구글 시트 id(형식 자동 판별). .xlsx 는 Drive 권한 인증(서비스 계정 또는 `GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN`) 필요 |
|
|
| `CUPANG_OUTBOUND_XLSX_ID` | 쿠팡 "밀크런 출고리스트 작성" 팝업이 쓰는 드라이브 .xlsx 파일 id(기본 `1J74op7lBZOgE27p4R28I3RWsv0EtXdii`). 엑셀 파일만(구글 시트로 대신 쓰지 않음) |
|
|
| `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` 로 지정 |
|
|
| `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) |
|
|
| `OUTREACH_DB_URL` | 안내문 발송 DB DSN (예: `postgresql://outreach_app:<pwd>@postgres-db:5432/outreach_db`, 비밀번호는 URL 인코딩). 미설정 시 모듈 비활성(설정 필요 안내). 권한키 `outreach`. 메일은 `INOUT_DB_URL` 의 Gmail 연결 재사용 |
|
|
| `LIVE_DB_URL` | 라이브 커머스 DB DSN (예: `postgresql://live_app:<pwd>@postgres-db:5432/live_db`, 비밀번호는 URL 인코딩). 미설정 시 모듈 비활성(설정 필요 안내). 권한키 `live` |
|
|
| `INOUT_DB_URL` | 입출고 관리 DB DSN (예: `postgresql://inout_app:<pwd>@postgres-db:5432/inout_db`). 미설정 시 입출고 모듈 비활성(설정 필요 안내). 권한키 `inout`. 제품은 `ITEMCODE_DB_URL`(단품) 재사용 |
|
|
|
|
---
|
|
|
|
## 로컬 Docker 테스트
|
|
|
|
```powershell
|
|
# 1) 로컬 env 파일 준비
|
|
copy .env.local.example .env.local
|
|
# .env.local 을 열어 실제 값으로 수정
|
|
|
|
# 2) 이미지 빌드 및 실행
|
|
docker compose -f docker-compose.local.yml up --build
|
|
|
|
# 3) 브라우저 확인
|
|
# http://localhost:8080
|
|
```
|
|
|
|
> 로컬 OAuth: Google Cloud Console 리디렉션 URI에 `http://localhost:8080/auth/google` 추가 필요.
|
|
|
|
---
|
|
|
|
## 복구 절차
|
|
|
|
### 컨테이너만 깨진 경우
|
|
|
|
```bash
|
|
docker compose up --build -d
|
|
docker compose logs -f
|
|
```
|
|
|
|
### DB 데이터가 깨진 경우 (사용자 승인 필수)
|
|
|
|
1. 즉시 트래픽 차단 (NPM 비활성화 또는 점검 페이지)
|
|
2. 가장 최근 백업 확인
|
|
3. **새 DB 이름으로 먼저 복구**해 검증
|
|
4. 검증 완료 후 운영 DB 교체
|
|
5. 복구 후 로그/주문 정합성 점검
|
|
|
|
> 운영 DB에 직접 `pg_restore --clean`을 실행하지 않는다. `DATABASES.md` 참고.
|
|
|
|
---
|
|
|
|
## 위험 명령 (사용자 승인 없이 실행 금지)
|
|
|
|
| 명령 | 위험 |
|
|
| --- | --- |
|
|
| `rm -rf` | 파일/디렉터리 영구 삭제 |
|
|
| `docker compose down -v` | 볼륨 포함 삭제 → DB 손실 |
|
|
| `docker volume rm`, `docker volume prune` | 볼륨 영구 삭제 |
|
|
| `docker system prune -a --volumes` | 이미지·네트워크·볼륨 일괄 삭제 |
|
|
| `DROP DATABASE`, `DROP TABLE`, `TRUNCATE` | DB 파괴 (`DATABASES.md` 참고) |
|
|
| `git reset --hard`, `git push --force`, `git clean -fd` | 작업 내역 손실 |
|
|
| 운영 `.env` 덮어쓰기 / 삭제 | 인증·세션 붕괴 |
|
|
|
|
원칙:
|
|
|
|
1. 실행 전 현재 상태 확인 명령을 먼저 보여준다.
|
|
2. 백업 위치를 명시한다.
|
|
3. 사용자 명시 승인 후에만 실행한다.
|
|
|
|
---
|
|
|
|
## 점검 체크리스트
|
|
|
|
- [ ] `docker compose ps` 모든 서비스 `running`
|
|
- [ ] `docker compose logs --tail=200` 에러 없음
|
|
- [ ] `https://dbx.no1king.freeddns.org` 200 응답
|
|
- [ ] Google 로그인 정상 동작
|
|
- [ ] PostgreSQL 컨테이너 볼륨 마운트 정상
|
|
- [ ] 최근 DB 백업 존재 여부
|
|
- [ ] `.env` 미커밋 상태 (`git status`로 확인)
|