KWON
7121f250bc
- Flask Blueprint 아키텍처로 전환 (dashboard, upload, backup, status) - app.py 681줄 95줄로 축소 (86% 감소) - HTML 템플릿 모듈화 (base.html + 기능별 templates) - CSS/JS 파일 분리 (common + 기능별 파일) - 대시보드 기능 추가 (통계, 주간 예보, 방문객 추이) - 파일 업로드 웹 인터페이스 구현 - 백업/복구 관리 UI 구현 - Docker 배포 환경 개선 - .gitignore 업데이트 (uploads, backups, cache 등)
53 lines
2.8 KiB
Markdown
53 lines
2.8 KiB
Markdown
# 퍼스트가든 방문통계 간소화
|
|
## 종관기상관측정보 자동 업데이트
|
|
- `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
|
|
``` |