주제: 가입 고객 이탈 예측

기간 : 2026. 01. 02. ~ 01. 15. (14일)

팀원(: 담당 작업)

작업 예상 일정

작업 목록

회의록

참고 자료

https://github.com/SKNETWORKS-FAMILY-AICAMP/SKN23-2nd-2Team

https://www.erdcloud.com/d/GofibWbvH9bF45oRg

https://www.figma.com/make/hXkr5jZ5bEUNxNzj75iTbh/Hospital-Management-System-Wireframe?p=f&t=YrTuC3qKvfhmWqjz-0

## Branch 구조

main
 └──develop
      ├──sunny, JYS                # 정유선 작업 브랜치
      ├──JHY, JHY-re               # 정희영 작업 브랜치
      ├──JYH                       # 정용희 작업 브랜치
      ├──YHS                       # 유헌상 작업 브랜치
      └──KDY                       # 김도영 작업 브랜치
### 폴더 및 파일 구조

your_project_name/
├── .venv/                         # 가상 환경 (git X)
├── assets                         # 이미지, 데이터 파일등을 위한 폴더
│   ├── images/                    # 이미지 폴더
│   ├── fonts/                     # font용 woff2 파일이 저장되어 있는 폴더
│		├── no_show_feature_correlations.csv
│		├── noshow_weather.csv         # weather 테이블 입력용 csv
│		├── noshow_appt.csv            # appointment 테이블 입력용 csv
│   └── medical-appointments-no-show-en.csv # 원본 데이터
│   
│── api/
│   ├── weather_api.py             # 날씨 정보 API
│   └── weather_week.py            # 날씨 정보 DB에 반영
│── artifacts/                     # 모델 및 학습 데이터 정보
│   ├── feature_columns.json       # 학습에 사용한 피처 컬럼 이름
│   ├── lg_feature_columns.json    # 로지스틱 피쳐 컬럼
│   ├── lg_model.joblib            # 로지스틱 모델 평가
│   ├── lgbm_feature_columns.json  # lightGBM 피쳐 컬럼
│   ├── lgbm_model.joblib          # lightGBM 모델 평가
│   ├── mlp_model.pt               # 김도영 딥러닝 모델 정보
│   ├── scaler.joblib              # 데이터 스케일러 정보
│   ├── rf_feature_columns.json    # 랜덤포레스트 피쳐 컬럼
│   ├── rf_metrics.json            # 랜덤포레스트 평가
│   ├── rf_model.joblib            # 랜덤포레스트 모델 정보
│   ├── rf_threshold.json          # 랜덤포레스트 판단 값
│   ├── xgb_feature_columns.json   # XGBoost 피쳐 컬럼
│   ├── xgb_metrics.json           # XGBoost 평가
│   ├── xgb_model.joblib           # XGBoost 모델 저정보
│   └── xgb_threshold.json         # XGBoost 판단 값
│── services/
│   └── customerService.py         # 스트림릿 모델 불러오기 및 확률 계산 함수
│
├── src/
│   ├── modules/                   # 모듈 파일들로 구성된 폴더
│   │   ├── connect_db_module.py    # DB 연결 모듈
│   │   ├── machine_module.py       # 머신러닝 모듈
│   │   ├── one_hot_module.py       # 컬럼 원핫인코딩용 모듈
│   │   ├── predict_noshow_logistic.py    # 로지스틱 모델 확률 예측 모듈
│   │   ├── predict_noshow_lightgbm.py    # lightGBM 모델 확률 예측 모듈
│   │   ├── DL_KDY.py               # 김도영 딥러닝 학습 파일
│   │   ├── xgboost.py              # xgboost 머신러닝
│   │   └── randomForest.py         # 랜덤포레스트 머신러닝
│   └── views/                     # 화면 페이지 정의 폴더
│       ├── CustomerList.py        # 고객 관리 페이지
│       ├── Dashboard.py           # 대시보드 페이지
│       ├── MoedelAnalytics.py     # 모델 성능 확인 페이지
│       ├── .streamlit/
│       │   └── config.toml        # streamlit 테마 설정 파일 
│       ├── modals/                
│       │   ├── editInfoModal.py   # 메세지 전송 모덜
│       │   ├── messageModal.py    # 메세지 전송 모덜
│       │   └── weatherModal.py    # 날씨 유형별 노쇼 예측 비율 모덜
│       └── tabs/
│           ├── deepTap.py         # 딥러닝 모델 성능 확인 탭
│           └── machineTap.py      # 머신러닝 모델 성능 확인 탭
├── .env                           # (git X) 환경변수 파일
├── .gitignore
├── Main.py                        # 앱의 메인 시작 파일
├── README.md
├── requirements.txt               # 프로젝트 의존성 목록
└── user_flow.drawio               # 화면흐름도 drawio 파일