83b90ef05c
Some checks failed
SonarQube Analysis / SonarQube Scan (push) Has been cancelled
- 파이프 수량 계산 로직 수정 (단관 개수가 아닌 실제 길이 기반 계산) - UI 전면 개편 (DevonThink 스타일의 간결하고 세련된 디자인) - 자재별 그룹핑 로직 개선: * 플랜지: 동일 사양별 그룹핑, WN 스케줄 표시, ORIFICE 풀네임 표시 * 피팅: 상세 타입 표시 (니플 길이, 엘보 각도/연결, 티 타입, 리듀서 타입 등) * 밸브: 동일 사양별 그룹핑, 타입/연결방식/압력 표시 * 볼트: 크기/재질/길이별 그룹핑 (8SET → 개별 집계) * 가스켓: 동일 사양별 그룹핑, 재질/상세내역/두께 분리 표시 * UNKNOWN: 원본 설명 전체 표시, 동일 항목 그룹핑 - 전체 카테고리 버튼 제거 (표시 복잡도 감소) - 카테고리별 동적 컬럼 헤더 및 레이아웃 적용
4.2 KiB
4.2 KiB
TK-MP-Project Docker 가이드
🚀 빠른 시작
1. 개발 환경 실행
./docker-run.sh dev up
2. 프로덕션 환경 실행
./docker-run.sh prod up
3. 시놀로지 NAS 환경 실행
./docker-run.sh synology up
📋 사용 가능한 명령어
| 명령어 | 설명 |
|---|---|
up |
컨테이너 시작 (기본값) |
down |
컨테이너 중지 |
build |
이미지 빌드 |
rebuild |
이미지 재빌드 (캐시 무시) |
logs |
로그 실시간 확인 |
ps 또는 status |
서비스 상태 확인 |
restart |
컨테이너 재시작 |
🌍 환경별 설정
개발 환경 (dev)
- 포트: 모든 서비스 외부 노출
- Frontend: http://localhost:13000
- Backend API: http://localhost:18000
- PostgreSQL: localhost:5432
- Redis: localhost:6379
- pgAdmin: http://localhost:5050
- 특징:
- 코드 실시간 반영 (Hot Reload)
- 디버그 모드 활성화
- 모든 로그 레벨 출력
프로덕션 환경 (prod)
- 포트: Nginx를 통한 리버스 프록시
- Web: http://localhost (Nginx)
- HTTPS: https://localhost (SSL 설정 필요)
- 특징:
- 내부 서비스 포트 비노출
- 최적화된 빌드
- 로그 레벨 INFO
- pgAdmin 비활성화
시놀로지 NAS 환경 (synology)
- 포트: 포트 충돌 방지를 위한 커스텀 포트
- Frontend: http://localhost:10173
- Backend API: http://localhost:10080
- PostgreSQL: localhost:15432
- Redis: localhost:16379
- pgAdmin: http://localhost:15050
- 특징:
- 명명된 볼륨 사용
- 시놀로지 Container Manager 호환
🔧 환경 설정 파일
각 환경별 설정은 다음 파일에서 관리됩니다:
env.development- 개발 환경 설정env.production- 프로덕션 환경 설정env.synology- 시놀로지 환경 설정
주요 환경 변수
# 배포 환경
DEPLOY_ENV=development|production|synology
# 포트 설정
FRONTEND_EXTERNAL_PORT=13000
BACKEND_EXTERNAL_PORT=18000
POSTGRES_EXTERNAL_PORT=5432
# 데이터베이스 설정
POSTGRES_DB=tk_mp_bom
POSTGRES_USER=tkmp_user
POSTGRES_PASSWORD=tkmp_password_2025
# 디버그 설정
DEBUG=true|false
LOG_LEVEL=DEBUG|INFO|WARNING|ERROR
🛠️ 사용 예시
개발 시작
# 개발 환경 시작
./docker-run.sh dev up
# 로그 확인
./docker-run.sh dev logs
# 상태 확인
./docker-run.sh dev ps
프로덕션 배포
# 이미지 빌드
./docker-run.sh prod build
# 프로덕션 시작
./docker-run.sh prod up
# 상태 확인
./docker-run.sh prod ps
시놀로지 NAS 배포
# 시놀로지 환경 시작
./docker-run.sh synology up
# 로그 확인
./docker-run.sh synology logs
컨테이너 관리
# 컨테이너 중지
./docker-run.sh dev down
# 컨테이너 재시작
./docker-run.sh dev restart
# 이미지 재빌드 (캐시 무시)
./docker-run.sh dev rebuild
🔍 트러블슈팅
포트 충돌 해결
환경 설정 파일에서 *_EXTERNAL_PORT 변수를 수정하세요.
볼륨 권한 문제
# 볼륨 삭제 후 재생성
docker volume prune
./docker-run.sh dev up
이미지 빌드 문제
# 캐시 없이 재빌드
./docker-run.sh dev rebuild
📁 파일 구조
TK-MP-Project/
├── docker-compose.yml # 통합 Docker Compose 파일
├── docker-run.sh # 실행 스크립트
├── env.development # 개발 환경 설정
├── env.production # 프로덕션 환경 설정
├── env.synology # 시놀로지 환경 설정
├── docker-backup/ # 기존 파일 백업
│ ├── docker-compose.yml
│ ├── docker-compose.prod.yml
│ ├── docker-compose.synology.yml
│ └── docker-compose.override.yml
└── DOCKER-GUIDE.md # 이 가이드 파일
🎯 마이그레이션 가이드
기존 Docker Compose 파일을 사용하던 경우:
-
기존 컨테이너 중지
docker-compose down -
새로운 방식으로 시작
./docker-run.sh dev up -
기존 파일은
docker-backup/폴더에 보관됨