# 퍼스트가든 방문통계 간소화
## 종관기상관측정보 자동 업데이트
- `data.go.kr` 에서 종관기상관측 자료 API를 통한 자료 요청 및 업데이트.
- DB에 저장된 데이터로부터 어제자 데이터까지 수집

## 대기환경정보 자동 업데이트
- `data.go.kr` 에서 에어코리아 API를 통한 자동 업데이트.
- DB에 저장된 가장 최근 날짜 + 1일 ~ 어제자 데이터까지 수집.

## GA4 업데이트
- 구글 애널리틱스 데이터를 업데이트함, 각 차원에 따라 업데이트
- 개발중

## POS 데이터 업데이트
- POS사와의 계약이슈로 중단

## POS 데이터를 엑셀로 다운받은 후 자동 업로드
- 파일 첨부와 해석, 업데이트 기능 생성 필요함

## 폴더 구조
```bash
project-root/
├── app/                                    # 🔹 웹 프론트엔드 및 Flask 서버
│   ├── templates/                          # HTML 템플릿 (Jinja2)
│   │   └── index.html          
│   ├── static/                             # (선택) JS, CSS 파일
│   └── app.py                              # Flask 애플리케이션 진입점

├── build/                                  # 🔹 Docker 빌드 전용 디렉토리
│   ├── Dockerfile                          # Ubuntu 22.04 기반 Dockerfile
│   ├── requirements.txt                    # Python 의존성
│   └── (선택) run.sh / build.sh 등 실행 스크립트

├── conf/                                   # 🔹 설정 및 DB 정의
│   ├── config.yaml                         # 설정 파일 (DB 접속 등)
│   ├── db.py                               # SQLAlchemy 연결 설정
│   └── db_schema.py                        # 테이블 정의 (SQLAlchemy metadata)

├── lib/                                    # 🔹 데이터 처리 및 백엔드 로직
│   ├── common.py                           # 중복 함수들을 처리
│   ├── pos_view_gui.py                     # 기존 Tkinter GUI (조회용)
│   ├── pos_update_gui.py                   # 기존 Tkinter GUI (업데이트용)
│   ├── air_quality.py                      # 대기환경 API 수집
│   ├── ga4.py                              # GA4 수집 스크립트
│   ├── weather_asos.py                     # 기상청 ASOS 수집
│   ├── weekly_visitor_forecast.py          # GA4 수집 스크립트
│   ├── weekly_visitor_forecast_prophet.py  # GA4 수집 스크립트
│   └── 
├── data/                                   # 🔹 데이터 저장 및 엑셀 업로드 디렉토리
│   └── (엑셀 파일들, 일자별 상품별 파일 등)
├── .gitignore
└── README.md
```