Files
static/conf/config.sample.yaml
KWON 98d633ead8 fix: Dockerfile chmod 에러 수정 및 환경변수 지원 추가
- Dockerfile: chmod 명령어에 RUN 추가
- .env.example: 모든 설정 항목 및 자세한 주석 추가
- config.yaml: 각 설정 항목에 대한 상세 주석 추가
- config.sample.yaml: 샘플 파일 주석 개선
- conf/db.py: 환경변수 우선 적용 기능 추가
- lib/common.py: load_config에 환경변수 오버라이드 지원
- 환경변수로 모든 설정값 제어 가능 (DB, API, POS 등)
2025-12-26 17:42:20 +09:00

91 lines
4.1 KiB
YAML

# ===================================================================
# First Garden 정적 데이터 관리 시스템 설정 파일 (샘플)
# ===================================================================
# 이 파일을 config.yaml로 복사한 후 실제 값으로 수정하세요.
# 민감한 정보(비밀번호, API 키)는 .env 파일 사용을 권장합니다.
# ===================================================================
# ===== 데이터베이스 접속 정보 =====
# MariaDB/MySQL 데이터베이스 연결 설정
# 환경변수로 덮어쓰기 가능: DB_HOST, DB_USER, DB_PASSWORD, DB_NAME
database:
host: localhost # DB 호스트명 (Docker: mariadb, 로컬: localhost)
user: your_db_user # DB 사용자명
password: your_db_password # DB 비밀번호
name: your_db_name # 사용할 데이터베이스 이름
# ===== 테이블 설정 =====
# 모든 테이블명 앞에 붙는 접두사
table_prefix: fg_manager_static_
# 사용되는 테이블 목록 (참고용)
tables:
air: 대기정보 테이블 # 미세먼지 등 대기질 데이터
weather: 종관기상관측 테이블 # 기온, 강수량 등 날씨 데이터
ga4: GA4 테이블 # Google Analytics 방문자 데이터
pos: POS 데이터 테이블 # 매출 및 상품 데이터
pos_deactivate: 비활성 데이터 목록 # 입장 처리에서 제외할 데이터
holiday: 휴일 정보 테이블 # 공휴일 및 휴무일 정보
# ===== 공공데이터포털 API 설정 =====
# Data.go.kr 에서 발급받은 API 키
# 환경변수: DATA_API_SERVICE_KEY
DATA_API:
serviceKey: "YOUR_API_KEY_HERE" # 공공데이터포털 API 인증키
startDt: "20170101" # 데이터 수집 시작 날짜 (YYYYMMDD)
endDt: "20250701" # 데이터 수집 종료 날짜 (YYYYMMDD)
# 대기질 측정소 설정
air:
station_name: # 측정소명 리스트
- "운정" # 예: 운정, 일산, 고양 등
# 날씨 관측소 설정
weather:
stnIds: # 기상청 관측소 ID
- 99 # 예: 99 (파주), 108 (서울) 등
# ===== Google Analytics 4 설정 =====
# GA4 API를 통한 방문자 데이터 수집
# 환경변수: GA4_API_TOKEN, GA4_PROPERTY_ID
ga4:
token: YOUR_GA4_TOKEN # GA4 API 토큰
property_id: 12345678 # GA4 속성 ID (숫자)
service_account_file: "./conf/service-account-credentials.json" # 서비스 계정 JSON
startDt: "20230101" # 데이터 수집 시작 날짜
endDt: "20250701" # 데이터 수집 종료 날짜
max_rows_per_request: 10000 # API 요청당 최대 행 수
# ===== POS 시스템 설정 =====
POS:
# 방문객으로 분류할 매출 카테고리
# 환경변수: VISITOR_CATEGORIES (쉼표 구분)
VISITOR_CA:
- 입장료 # 일반 입장료
- 티켓 # 각종 티켓
- 기업제휴 # 기업 제휴 티켓
# ===== 방문객 예측 모델 가중치 =====
# 날씨 요소가 방문객 수에 미치는 영향도
FORECAST_WEIGHT:
visitor_forecast_multiplier: 0.5 # 최종 예측값 조정 (0.0 ~ 1.0)
minTa: 1.0 # 최저기온 영향도
maxTa: 1.0 # 최고기온 영향도
sumRn: 10.0 # 강수량 영향도 (높을수록 큰 영향)
avgRhm: 1.0 # 습도 영향도
pm25: 1.0 # 미세먼지 영향도
is_holiday: 20 # 휴일 가중치 (휴일 시 방문객 증가)
# ===== 시스템 설정 =====
max_workers: 4 # 병렬 처리 워커 수 (CPU 코어 수 권장)
debug: false # 디버그 모드 (개발: true, 운영: false)
force_update: false # 기존 데이터 덮어쓰기 여부
# ===== UPSolution POS 연동 =====
# UPSolution API 접속 정보
# 환경변수: UPSOLUTION_ID, UPSOLUTION_CODE, UPSOLUTION_PW
upsolution:
id: "your_upsolution_id" # UPSolution 계정 ID
code: "your_store_code" # 점포 코드
pw: "your_password" # 계정 비밀번호