[Streamlit] 폴더 구조 정리 (feat. LLM 법률 서비스 프로젝트 리팩토링)

 

조원과 함께 LLM과 Streamlit을 활용한 법률 서비스 프로젝트를 마무리한 후,

리팩토링 경험까지 쌓아보면 좋겠다고 생각하여 다 함께 리팩토링을 하기로 결정하였다. 

 

프론트엔드 교수님께서 어떤 언어든 체계화된 폴더 구조가 있다고 말씀하셔서

먼저 Streamlit의 폴더 구조를 찾아보았다. 

---

 

 

일단 공식 문서상에서 권장하는 구조는 따로 나와있지 않는 것 같아, 

구글과 유튜브에 `streamlit structure`나 `streamlit app structure` 등.. 이런 식으로 검색하여 찾아보았다. 

 

그중에서 아래의 블로그 글과 유튜브 영상을 찾을 수 있었다. 

How to Structure and Organise a Streamlit App

 

 

또한, chatGPT나 Perplexity 등을 통해서도 여러 폴더 구조를 추천받았고, 

여러 사이트와 정보를 조합해서 아래와 같이 폴더 구조를 정리하였다. 

 

law-chatbot/
│
├── app/                          # Streamlit 실행 및 페이지 구성
│   ├── main.py                  # Streamlit 메인
│   └── pages/                   # 서브 페이지 구성
│       ├── page1.py             
│       └── page2.py             
│
├── src/                          # 핵심 로직 및 기능 구성
│   ├── models/                  # 모델 관련 코드 (LLM 호출, 파라미터 등)
│   ├── prompts/                 # 프롬프트 템플릿, 시스템 메시지 등
│   └── components/             # 재사용 가능한 UI 요소 (사이드바, 카드 등)
│
├── assets/                       # 정적 자원 (이미지, CSS 등)
│   ├── images/                 # 로고, 아이콘 등
│   └── css/                    # 커스텀 CSS (Streamlit 테마 스타일링)
│
├── data/                         # 입력 데이터 또는 문서 저장소
│   └── 법전.pdf                
│
├── tests/                        # 유닛 테스트, 통합 테스트
│   └── test_example.py         # 예시 테스트 파일
│
├── .gitignore                    # Git 커밋 제외 파일 정의
├── requirements.txt             # 의존 패키지 목록
├── setup.py                     # 패키지 설치/배포 설정
└── README.md                    # 프로젝트 설명 문서

 

일단 위의 구조를 팀원들에게 제안하였고, 

리팩토링이 마무리된 후 최종적으로 결정한 폴더 구조를 다시 올릴 예정이다~!