hyungi/tk-factory-services
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: 보안 취약점 제거 + 데드코드 정리 + 프론트엔드 중복 통합

Browse Source 
- 인증 없는 임시 엔드포인트 삭제 (index.js, healthRoutes.js, publicPaths)
- skipAuth 우회 라우트 삭제 (workAnalysis.js)
- 하드코딩 유저 백도어 삭제 (routes/auth.js)
- 안전체크 CRUD에 admin 권한 추가 (tbmRoutes.js)
- deprecated shim 3개 삭제 + 8개 소비 파일 import 정리 (auth.js 직접 참조)
- 미사용 pageAccessController, db.js, common/security.js 삭제
- escapeHtml() 5곳 로컬 중복 제거 → api-base.js 전역 사용
- userPageAccess_v2_v2 캐시 키 버그 수정 (app-init.js)
- system3 .bak 파일 삭제, PROGRESS.md 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Hyungi Ahn
2026-02-25 08:19:01 +09:00
parent 7637be33f3
commit 93edf9529a
28 changed files with 136 additions and 2192 deletions
Download Patch File Download Diff File Expand all files Collapse all files

344
PROGRESS.md
View File

@@ -1,6 +1,6 @@
# TK 공장관리 3-System 분리 및 통합 - 진행 상황
> 최종 업데이트: 2026-02-09
> 최종 업데이트: 2026-02-25
---
@@ -8,190 +8,136 @@
TK-FB-Project(공장관리+신고)와 M-Project(부적합관리)를 **3개 독립 시스템**으로 분리하고 **SSO + 데이터 연동**으로 통합.
| 시스템 | 설명 | 기반 코드 |
| 시스템 | 설명 | 서브도메인 |
|--------|------|-----------|
| System 1 - 공장관리 | TK-FB에서 신고 기능 제거 | TK-FB-Project |
| System 2 - 신고 | TK-FB에서 추출한 독립 서비스 | TK-FB-Project (workIssue 코드) |
| System 3 - 부적합관리 (TKQC) | M-Project 기반 | M-Project |
| System 1 - 공장관리 | TBM, 출근, 작업보고, 설비, 모바일 대시보드 | `tkfb.technicalkorea.net` |
| System 2 - 안전신고 | 5단계 신고 위자드, 작업장 연동 | `tkreport.technicalkorea.net` |
| System 3 - 부적합관리 (TKQC) | NCR, 일일공수, 보고서 | `tkqc.technicalkorea.net` |
| tkuser - 통합 관리 | 사용자/권한/마스터데이터 관리 | `tkuser.technicalkorea.net` |
**배포 대상**: Synology DS923+ NAS (192.168.0.3)
**배포 환경**: Synology DS923+ NAS (LAN: 192.168.0.3, Tailscale: 100.71.132.52)
---
## 현재 NAS 운영 상태
## 현재 NAS 운영 상태 (통합 배포 완료)
### TK-FB (공장관리+신고 - 기존 시스템, 운영 중)
| 컨테이너 | 상태 | 포트 |
|-----------|------|------|
| tkfb_web | Up | - |
| tkfb_api | Up (healthy) | - |
| tkfb_fastapi | Up | - |
| tkfb_db (MariaDB) | Up (healthy) | - |
| tkfb_redis | Up | - |
| tkfb_phpmyadmin | Up | - |
| tkfb_cloudflared | Up | - |
- 도메인: `tkfb.technicalkorea.net` (Cloudflare Tunnel)
- 위치: `/volume1/Technicalkorea Document/tkfb-package/`
**배포일**: 2026-02-11 | **위치**: `/volume1/docker_1/tk-factory-services`
### TKQC (부적합관리 - 신규 배포 완료)
| 컨테이너 | 상태 | 포트 |
|-----------|------|------|
| tkqc-db (PostgreSQL 15) | Up (healthy) | 16432 |
| tkqc-backend (FastAPI) | Up | 16000 |
| tkqc-nginx | Up | 16080 |
- 도메인: `tkqc.technicalkorea.net` (Cloudflare Tunnel)
- 위치: `/volume1/docker/tkqc/tkqc-package/`
- cloudflared가 tkfb_network + tkqc-network 양쪽 연결됨
| 컨테이너 | 이미지 | 역할 |
|-----------|--------|------|
| tk-gateway | nginx:alpine | 서브도메인 라우팅 + 포털/로그인 |
| tk-sso-auth | node:18-alpine | SSO 인증 (JWT + 쿠키) |
| tk-tkuser-api | node:18-alpine | 마스터데이터 API |
| tk-tkuser-web | nginx:alpine | tkuser 웹 |
| tk-system1-api | node:18-alpine | 공장관리 API |
| tk-system1-web | nginx:alpine | 공장관리 웹 |
| tk-system1-fastapi | python:3.9-slim | FastAPI 캐싱 브릿지 |
| tk-system2-api | node:18-alpine | 안전신고 API |
| tk-system2-web | nginx:alpine | 안전신고 웹 |
| tk-system3-api | python:3.9-slim | 부적합관리 API (FastAPI) |
| tk-system3-web | nginx:alpine | 부적합관리 웹 |
| tk-mariadb | mariadb:10.9 | MariaDB (System 1, 2, tkuser 공유) |
| tk-postgres | postgres:15-alpine | PostgreSQL (System 3 전용) |
| tk-redis | redis:6-alpine | 캐시 |
| tk-phpmyadmin | phpmyadmin | DB 관리 (LAN only, 30880) |
| tk-cloudflared | cloudflare/cloudflared | Cloudflare Tunnel |
---
## 단계별 진행 상황
### Phase 0: M-Project(TKQC) NAS 배포 ✅ 완료
### Phase 0: TKQC NAS 배포 ✅ 완료
- [x] M-Project 배포 패키지 생성 (deploy/package.sh)
- [x] NAS로 패키지 전송 및 설치
- [x] Docker 컨테이너 빌드 및 실행 (tkqc-db, tkqc-backend, tkqc-nginx)
- [x] PostgreSQL 마이그레이션 실행 (001~020 SQL)
- [x] nginx.conf 수정 (Docker 내부 IP 허용, uploads 프록시)
- [x] Cloudflare Tunnel에 `tkqc.technicalkorea.net` 추가
- [x] cloudflared를 tkqc-network에 연결
- [x] 컨테이너 이름 m-project → tkqc로 리네임
- [x] 헬스체크 확인 (API: healthy, Web: 200)
- [ ] **Cloudflare 대시보드에서 서비스 URL 변경 필요**
- 변경: `http://m-project-nginx:80` → `http://tkqc-nginx:80`
- (사용자가 직접 Cloudflare 대시보드에서 수정)
- [x] M-Project 배포 패키지 → NAS 설치 → Docker 기동
- [x] PostgreSQL 마이그레이션 (001~020)
- [x] Cloudflare Tunnel `tkqc.technicalkorea.net` 설정
- [x] 컨테이너 리네임 (m-project → tkqc)
### Phase 1: 준비 - 로컬 코드 구조 생성 ✅ 완료
### Phase 1~4: 코드 분리 + SSO + Gateway ✅ 완료
- [x] `tk-factory-services/` 디렉토리 구조 생성
- [x] 통합 `docker-compose.yml` 작성 (13개 서비스, 포트 30000~30880)
- [x] `.env.example` 작성
- [x] 3개 시스템 코드 분리 (TK-FB → System 1+2, M-Project → System 3)
- [x] SSO Auth 서비스 (bcrypt + pbkdf2 이중 해시, JWT 7일/30일)
- [x] 프론트엔드 SSO 쿠키 통합 (52+ 파일, `domain=.technicalkorea.net`)
- [x] Gateway 서브도메인 라우팅 (path-based에서 전환)
- [x] tkuser 통합 관리 서비스 (사용자, 권한, 프로젝트, 작업장, 설비, 부서, 작업자)
### Phase 2: SSO 인증 서비스 - 로컬 코드 작성 ✅ 완료
### Phase 5: 마이그레이션 스크립트 ✅ 완료
- [x] `sso-auth-service/` 코드 작성
- `index.js` - Express 서버
- `routes/authRoutes.js` - 인증 라우트
- `controllers/authController.js` - 로그인/검증/리프레시/유저 CRUD
- `models/userModel.js` - MariaDB 유저 모델
- `Dockerfile`, `package.json`
- [x] bcrypt + pbkdf2_sha256 이중 비밀번호 해시 지원
- [x] JWT 기반 인증 (SSO_JWT_SECRET 공유)
- [ ] **실제 테스트 미완료** (NAS 배포 전)
- [ ] **sso_users 테이블 생성 및 기존 유저 마이그레이션 미완료**
- [x] `scripts/migrate-users.sql`, `backup.sh`, `deploy.sh`, `health-check.sh`
### Phase 3: 시스템별 코드 분리 - 로컬 코드 작성 ✅ 완료
### Phase 6: NAS 통합 배포 ✅ 완료 (2026-02-11)
#### System 1 - 공장관리
- [x] TK-FB-Project에서 복사 (api, web, fastapi-bridge)
- [x] `config/routes.js`에서 workIssue 라우트 제거
- [x] auth 미들웨어 SSO JWT 시크릿 연동 (백엔드: JWT_SECRET=SSO_JWT_SECRET 이미 설정)
- [x] 프론트엔드 토큰 키 통일 (`token`/`user` → `sso_token`/`sso_user`, 52개 파일 변경)
- [x] SSO 쿠키 기반 인증 통합 (api-base.js, app-init.js, auth-check.js, auth.js)
- `window.getSSOToken()`, `window.getSSOUser()`, `window.getLoginUrl()` 글로벌 함수
- 쿠키 `sso_token` 우선 → localStorage `sso_token` 폴백
- [x] nginx.conf 생성 (API, uploads, FastAPI 프록시)
- [x] 신고 관련 프론트엔드 페이지 → System 2로 서브도메인 리다이렉트
- `issue-report.html`, `issue-detail.html`, `report-status.html` → 동적 서브도메인 리다이렉트
- `sidebar-nav.html` 크로스시스템 링크 → `data-system` 속성 + JS 동적 해석
- [x] 로그인 플로우: 인증 없으면 중앙 로그인 (`tkfb.technicalkorea.net/login`)으로 리다이렉트
- [ ] **실제 테스트 미완료**
- [x] 전체 백업 (MariaDB, PostgreSQL, uploads)
- [x] tk-factory-services NAS 전송 + .env 설정
- [x] 기존 TK-FB/TKQC 중지 → 통합 docker-compose up (16 컨테이너)
- [x] SSO 유저 마이그레이션
- [x] Cloudflare Tunnel 서브도메인 4개 설정
#### System 2 - 신고
- [x] TK-FB에서 workIssue 관련 코드 추출
- `workIssueModel.js`, `workIssueController.js`, `workIssueRoutes.js`
- `mProjectService.js` (baseUrl → system3-api:8000으로 변경)
- `imageUploadService.js`, `dateUtils.js`, `logger.js`, `errors.js`
- [x] 독립 Express 서버 구성 (index.js, package.json, Dockerfile)
- [x] 프론트엔드 페이지 복사 (issue-report, issue-detail, report-status)
- [x] auth 미들웨어 SSO JWT 시크릿 연동 (백엔드: JWT_SECRET=SSO_JWT_SECRET 이미 설정)
- [x] 프론트엔드 인프라 구축: `api-base.js`, `app-init.js` 신규 생성
- [x] SSO 쿠키 기반 인증 통합 (쿠키 우선, localStorage 폴백, 중앙 로그인 리다이렉트)
- [x] 인라인 JS 토큰 읽기 → `window.getSSOToken()` 폴백 패턴 적용 (28곳)
- [ ] **M-Project(TKQC) 연동 실제 테스트 미완료**
- [ ] **실제 테스트 미완료**
### Phase 7: 테스트 및 Go-Live ✅ 완료 (2026-02-12)
#### System 3 - 부적합관리 (TKQC)
- [x] M-Project에서 복사 (api, web)
- [x] `auth_service.py` → bcrypt + pbkdf2 이중 지원 코드 추가
- [x] `requirements.txt`에 bcrypt 추가
- [x] SSO JWT 연동: `verify_token()` 전체 payload 반환, DB에 없는 SSO 유저 임시 객체 생성
- [x] SSO 쿠키 기반 인증 통합 (api.js, auth-manager.js, app.js, common-header.js)
- `_cookieGet('sso_token')` 우선 → localStorage 폴백
- 인증 실패 시 중앙 로그인 리다이렉트
- [x] 인라인 JS `localStorage.getItem('access_token')` → `TokenManager.getToken()` 일괄 치환 (9개 HTML, 81곳)
- [ ] **SSO JWT 시크릿 연동 실제 테스트 미완료**
### Phase 4: Gateway + 서브도메인 라우팅 ✅ 코드 완료
> **아키텍처 변경**: Path-based(`/factory/`, `/report/`, `/nc/`) → **서브도메인 기반** 라우팅으로 전환.
>
> **이유**: 프론트엔드 JS가 root-relative URL (`/api/...`, `/pages/...`)을 사용하므로 경로 기반 라우팅이 근본적으로 불가능.
>
> **해결**: 각 시스템에 독립 서브도메인을 부여하고, SSO 쿠키(`domain=.technicalkorea.net`)로 인증 공유.
- [x] `gateway/nginx.conf` - **서브도메인 기반 라우팅**
- `tkfb.technicalkorea.net` → Gateway (포털/로그인) + System 1 프록시
- `tkreport.technicalkorea.net` → System 2 (Cloudflare Tunnel 직접)
- `tkqc.technicalkorea.net` → System 3 (Cloudflare Tunnel 직접)
- [x] `gateway/html/portal.html` - 서브도메인 기반 시스템 카드 링크
- [x] `gateway/html/login.html` - SSO 쿠키 설정 (`domain=.technicalkorea.net`, 7일 만료)
- 로그인 성공 → 쿠키 + localStorage 이중 저장, `?redirect=` 파라미터 지원
- [x] `gateway/html/shared/nav-header.js` - SSOAuth 글로벌 객체 (쿠키 우선)
- [x] `gateway/Dockerfile`
- [x] `system1-factory/web/nginx.conf` 신규 생성 (API/uploads/FastAPI 프록시)
- [x] `docker-compose.yml`에 cloudflared 서비스 추가
- [ ] **Cloudflare Tunnel 서브도메인 설정** (사용자 대시보드 작업)
- [ ] **실제 배포 및 테스트 미완료**
### Phase 5: 마이그레이션 스크립트 - 로컬 코드 작성 ✅ 완료
- [x] `scripts/migrate-users.sql` - SSO 통합 유저 테이블 생성 + 데이터 이전
- [x] `scripts/backup.sh` - 전체 백업 스크립트
- [x] `scripts/deploy.sh` - 배포 스크립트
- [x] `scripts/health-check.sh` - 헬스체크 스크립트
- [ ] **실제 실행 미완료**
### Phase 6: NAS 통합 배포 ❌ 미착수
- [ ] 전체 백업 (MariaDB, PostgreSQL, uploads, git)
- [ ] tk-factory-services를 NAS로 전송
- [ ] .env 파일 생성 (NAS 기존 DB 패스워드 등 수집)
- [ ] 기존 TK-FB 중지 + TKQC 중지
- [ ] 통합 docker-compose.yml로 전체 서비스 기동
- [ ] SSO 유저 마이그레이션 실행
- [ ] 전체 서비스 헬스체크
- [ ] Cloudflare Tunnel 서브도메인 설정 업데이트:
- `tkfb.technicalkorea.net` → `http://tk-gateway:80`
- `tkreport.technicalkorea.net` → `http://tk-system2-web:80`
- `tkqc.technicalkorea.net` → `http://tk-system3-web:80`
### Phase 7: 테스트 및 Go-Live ❌ 미착수
- [ ] SSO 로그인 → 3개 시스템 간 이동 테스트 (재로그인 없이)
- [ ] 신고 생성 → 부적합 자동 생성 연동 테스트
- [ ] 사진 업로드 테스트
- [ ] 알림 기능 테스트
- [ ] 기존 데이터 정합성 확인
- [ ] 프로덕션 Go-Live
- [x] SSO 로그인 → 3개 시스템 간 이동 (재로그인 없음)
- [x] 신고 생성 → 부적합 자동 전달 (tkreport → tkqc)
- [x] 사진 업로드, 알림, 데이터 정합성 확인
- [x] 프로덕션 Go-Live
---
## 완료율 요약
## 배포 이후 개발 (Phase 8+)
| 단계 | 상태 | 완료도 |
|------|------|--------|
| Phase 0: TKQC NAS 배포 | ✅ 거의 완료 | 95% (CF 대시보드 URL 변경만 남음) |
| Phase 1: 디렉토리 구조 | ✅ 완료 | 100% |
| Phase 2: SSO 코드 작성 | ✅ 코드 완료 | 70% (코드만 완료, 테스트/배포 미완) |
| Phase 3: 시스템 분리 + SSO 쿠키 통합 | ✅ 코드 완료 | 80% (코드+프론트엔드 SSO 완료, 실제 테스트 미완) |
| Phase 4: Gateway + 서브도메인 라우팅 | ✅ 코드 완료 | 80% (코드 완료, CF Tunnel 설정/테스트 미완) |
| Phase 5: 스크립트 | ✅ 코드 완료 | 50% (코드만 완료, 실행 미완) |
| Phase 6: NAS 통합 배포 | ❌ 미착수 | 0% |
| Phase 7: 테스트/Go-Live | ❌ 미착수 | 0% |
### 2026-02-13: System 2/3 업데이트 + 문서 재구성 ✅
**전체 진행률: 약 55%** (코드 작성 + SSO 프론트엔드 통합 완료, NAS 배포/테스트 남음)
- [x] System 2, 3 웹/API 업데이트 및 재빌드
- [x] 문서 4개 MD → `docs/` 폴더 7개 파일로 재구성
### 2026-02-14: 모바일 UX + PWA ✅
- [x] 모바일 대시보드 v1 (카테고리 탭 → 작업장 리스트 → 요약 숫자)
- [x] PWA 구현 (manifest, service worker)
- [x] 모바일 CSS 전면 최적화 (터치 타겟, 레이아웃)
### 2026-02-24~25: TBM 시스템 전면 개편 ✅
- [x] 4단계 워크플로우: draft → detail_edit → completed → work_report
- [x] 모바일 전용 TBM 페이지 (`tbm-mobile.html`) + 3단계 생성 위자드
- [x] 작업자 작업 분할 (`work_hours` + `split_seq`)
- [x] 작업자 이동 보내기/빼오기 (`tbm_transfers` 테이블)
- [x] 중복 배정 방지 (당일 배정 현황 조회)
- [x] 모바일 작업보고서 페이지 (`report-create-mobile.html`)
- [x] DB 마이그레이션 4개 (`attendance_type`, `work_hours`, `tbm_transfers`, `split_seq`)
### 2026-02-25: 권한 시스템 통합 ✅
- [x] tkuser `user_page_permissions` → system1 페이지 접근 연동
- [x] 라우트 우선순위 수정 (`pageAccessRoutes` > `userRoutes`)
- [x] 3단계 폴백: 개인 권한 → 부서 기본 → `TKUSER_DEFAULT_ACCESS`
- [x] 40+ 페이지 키 매핑 (`PAGEKEY_TO_TKUSER`)
### 2026-02-25: 모바일 대시보드 v2 — 작업장 카드 확장 뷰 ✅
- [x] 카드 탭 → 아코디언 확장 (TBM 작업, 방문, 신고, 이동설비 상세)
- [x] 캐시 데이터 활용 (추가 API 호출 없음)
- [x] NAS 배포 완료
---
## 포트 매핑
| 포트 | 서비스 |
|------|--------|
| 30000 | Gateway (nginx) |
| 30005 | System 1 API (Express) |
| 30008 | System 1 FastAPI Bridge |
| 30050 | SSO Auth (Express) |
| 30080 | System 1 Web (nginx) |
| 30105 | System 2 API (Express) |
| 30180 | System 2 Web (nginx) |
| 30200 | System 3 API (FastAPI) |
| 30280 | System 3 Web (nginx) |
| 30300 | tkuser API (Express) |
| 30380 | tkuser Web (nginx) |
| 30306 | MariaDB |
| 30432 | PostgreSQL |
| 30880 | phpMyAdmin |
---
@@ -199,76 +145,14 @@ TK-FB-Project(공장관리+신고)와 M-Project(부적합관리)를 **3개 독
### 로컬 (Mac)
- 통합 프로젝트: `/Users/hyungiahn/Documents/code/tk-factory-services/`
- TK-FB 원본: `/Users/hyungiahn/Documents/code/TK-FB-Project/`
- M-Project 원본: `/Users/hyungiahn/Documents/code/M-Project/`
- M-Project 배포 도구: `/Users/hyungiahn/Documents/code/M-Project/deploy/`
- 가이드 문서: `~/Library/CloudStorage/SynologyDrive-Technicalkorea/tkfb-package/docs/`
- Git: `https://git.hyungi.net/hyungi/tk-factory-services.git`
### NAS (192.168.0.3)
- TK-FB 운영: `/volume1/Technicalkorea Document/tkfb-package/`
- TKQC 운영: `/volume1/docker/tkqc/tkqc-package/`
- SSH: `hyungi` / `fukdon-riwbaq-fiQfy2`
### NAS (Synology DS923+)
- 통합 배포: `/volume1/docker_1/tk-factory-services`
- SSH: `hyungi@100.71.132.52` (Tailscale)
- Docker: `echo 'fukdon-riwbaq-fiQfy2' | sudo -S /usr/local/bin/docker`
---
## 포트 계획 (통합 배포 시)
| 현재 포트 | 통합 후 포트 | 서비스 |
|-----------|-------------|--------|
| - | 30000 | Gateway Nginx (통합 포털) |
| tkfb API | 30005 | System 1 API |
| tkfb FastAPI | 30008 | System 1 FastAPI Bridge |
| - | 30050 | SSO Auth |
| tkfb Web | 30080 | System 1 Web |
| - | 30105 | System 2 API |
| - | 30180 | System 2 Web |
| 16000 → 30200 | 30200 | System 3 API |
| 16080 → 30280 | 30280 | System 3 Web |
| tkfb MariaDB | 30306 | MariaDB (공유) |
| 16432 → 30432 | 30432 | PostgreSQL |
| tkfb phpMyAdmin | 30880 | phpMyAdmin |
---
## 다음에 할 일 (우선순위)
1. **NAS 접속 확인** (현재 LAN/Tailscale 모두 타임아웃)
2. **.env 파일 생성** - NAS에서 기존 DB 패스워드 등 수집
3. **Phase 6: NAS 통합 배포**
- 전체 백업 → 프로젝트 전송 → docker-compose up
4. **Cloudflare Tunnel 서브도메인 설정** (사용자 대시보드 작업)
- `tkfb.technicalkorea.net` → `http://tk-gateway:80`
- `tkreport.technicalkorea.net` → `http://tk-system2-web:80`
- `tkqc.technicalkorea.net` → `http://tk-system3-web:80`
5. **Phase 7**: 전체 SSO 로그인/시스템 간 이동 테스트
---
## 아키텍처 변경 이력
### 2026-02-09: Path-based → 서브도메인 기반 라우팅
**문제**: Gateway에서 `/factory/`, `/report/`, `/nc/` 경로 기반 라우팅 시, 프론트엔드 JS가 root-relative URL (`fetch('/api/...')`, `<a href="/pages/...">`)을 사용하여 경로 프리픽스 없이 요청 → 라우팅 불가.
**해결**: 서브도메인 기반 라우팅 + 쿠키 기반 SSO
| 서브도메인 | Cloudflare Tunnel 대상 | 시스템 |
|-----------|----------------------|--------|
| `tkfb.technicalkorea.net` | `http://tk-gateway:80` | 포털 + System 1 (프록시) |
| `tkreport.technicalkorea.net` | `http://tk-system2-web:80` | System 2 |
| `tkqc.technicalkorea.net` | `http://tk-system3-web:80` | System 3 |
**SSO 쿠키 전략**: `sso_token`, `sso_user` 쿠키를 `domain=.technicalkorea.net`으로 설정하여 서브도메인 간 공유. localStorage는 폴백용으로 유지 (개발 환경 및 하위호환).
---
## 해결했던 이슈 (참고)
| 이슈 | 해결 방법 |
|------|-----------|
| nginx uploads 볼륨 read-only 에러 | nginx에서 uploads 볼륨 제거, backend 프록시로 변경 |
| `users.department` 컬럼 누락 | 마이그레이션 수동 실행 (ALTER TABLE) |
| nginx 403 Forbidden (Docker IP 차단) | `allow 172.16.0.0/12`, `allow 10.0.0.0/8` 추가 |
| SCP subsystem 실패 | `scp -O` (레거시 프로토콜) 사용 |
| sudo 패스워드 파이프 실패 (for 루프) | SQL 파일 합쳐서 한번에 실행 |
| 네트워크 충돌 (리네임 시) | cloudflared 연결 해제 후 네트워크 삭제 |
| 새 볼륨 비어있음 (리네임 후) | 마이그레이션 재실행 |
### 레거시 (참고, 중지됨)
- TK-FB 원본: `/volume1/Technicalkorea Document/tkfb-package/`
- TKQC 원본: `/volume1/docker/tkqc/tkqc-package/`