Skip to content
Public template

About

No description, website, or topics provided.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

21 Commits

Folders and files

Repository files navigation

README.md

🌐 배포 μ£Όμ†Œ

Streamlit Cloud: https://linkbird.streamlit.app/

🐦 LinkBird

Streamlit 기반의 μ†Œμ…œ λ―Έλ””μ–΄ ν”Œλž«νΌ - νŠΈμœ„ν„°μ˜ 핡심 κΈ°λŠ₯을 κ΅¬ν˜„ν•œ μ›Ή μ• ν”Œλ¦¬μΌ€μ΄μ…˜

πŸ“‹ ν”„λ‘œμ νŠΈ μ†Œκ°œ

LinkBirdλŠ” Streamlit을 ν™œμš©ν•˜μ—¬ 개발된 μ†Œμ…œ λ―Έλ””μ–΄ ν”Œλž«νΌμž…λ‹ˆλ‹€. μ‚¬μš©μžλ“€μ΄ κ²Œμ‹œλ¬Όμ„ μž‘μ„±ν•˜κ³ , μ†Œν†΅ν•˜λ©°, ν•«ν”Œλ ˆμ΄μŠ€λ₯Ό κ³΅μœ ν•  수 μžˆλŠ” μ™„μ „ν•œ κΈ°λŠ₯을 μ œκ³΅ν•©λ‹ˆλ‹€. νŠΈμœ„ν„°μ˜ 핡심 κΈ°λŠ₯듀을 λͺ¨λ°©ν•˜μ—¬ μ‹€μ œ μ†Œμ…œ 미디어와 μœ μ‚¬ν•œ μ‚¬μš©μž κ²½ν—˜μ„ μ œκ³΅ν•©λ‹ˆλ‹€.

✨ μ£Όμš” κΈ°λŠ₯

πŸ” μ‚¬μš©μž 인증

  • νšŒμ›κ°€μž… & 둜그인: μ•ˆμ „ν•œ μ‚¬μš©μž 계정 관리
  • μ„Έμ…˜ 관리: 둜그인 μƒνƒœ μœ μ§€ 및 λ‘œκ·Έμ•„μ›ƒ

πŸ“ κ²Œμ‹œλ¬Ό 관리

  • κ²Œμ‹œλ¬Ό μž‘μ„±: 제λͺ©, λ‚΄μš©κ³Ό ν•¨κ»˜ ν•΄μ‹œνƒœκ·Έ μžλ™ μΆ”μΆœ
  • κ²Œμ‹œλ¬Ό μ‚­μ œ: 본인 κ²Œμ‹œλ¬Ό μ‚­μ œ κΈ°λŠ₯
  • μ‹€μ‹œκ°„ ν•΄μ‹œνƒœκ·Έ: μž…λ ₯ν•˜λŠ” λ™μ•ˆ ν•΄μ‹œνƒœκ·Έ 미리보기

πŸ’¬ μ†Œμ…œ κΈ°λŠ₯

  • μ’‹μ•„μš” μ‹œμŠ€ν…œ: κ²Œμ‹œλ¬Όκ³Ό λŒ“κΈ€μ— μ’‹μ•„μš”/μ·¨μ†Œ
  • λ¦¬νŠΈμœ—: κ²Œμ‹œλ¬Ό λ¦¬νŠΈμœ— κΈ°λŠ₯
  • λŒ“κΈ€: κ²Œμ‹œλ¬Όμ— λŒ“κΈ€ μž‘μ„±, μ‚­μ œ, μ’‹μ•„μš”
  • νŒ”λ‘œμš°: μ‚¬μš©μž νŒ”λ‘œμš°/μ–ΈνŒ”λ‘œμš°

πŸ” 검색 & 필터링

  • κ³ κΈ‰ 검색: 제λͺ©, λ‚΄μš©, μž‘μ„±μž, ν•΄μ‹œνƒœκ·Έλ³„ 검색
  • μ •λ ¬ μ˜΅μ…˜: μ΅œμ‹ μˆœ, μ’‹μ•„μš”μˆœ, λŒ“κΈ€μˆœ
  • νŒ”λ‘œμž‰ ν”Όλ“œ: νŒ”λ‘œμš°ν•œ μ‚¬μš©μžμ˜ κ²Œμ‹œλ¬Όλ§Œ 보기

πŸ”” μ•Œλ¦Ό μ‹œμŠ€ν…œ

  • μ‹€μ‹œκ°„ μ•Œλ¦Ό: νŒ”λ‘œμš°, μ’‹μ•„μš”, λŒ“κΈ€, λ¦¬νŠΈμœ— μ•Œλ¦Ό
  • μ•Œλ¦Ό μ„€μ •: λ°›κ³  싢은 μ•Œλ¦Ό μœ ν˜• μ»€μŠ€ν„°λ§ˆμ΄μ§•
  • 읽음 처리: κ°œλ³„/전체 μ•Œλ¦Ό 읽음 처리 및 μ‚­μ œ

πŸ—ΊοΈ ν•«ν”Œλ ˆμ΄μŠ€ κΈ°λŠ₯

  • 지도 기반: Folium을 ν™œμš©ν•œ μΈν„°λž™ν‹°λΈŒ 지도
  • μž₯μ†Œ 등둝: μœ„λ„/경도 기반 ν•«ν”Œλ ˆμ΄μŠ€ 등둝
  • 리뷰 μ‹œμŠ€ν…œ: 평점과 리뷰 μž‘μ„±
  • μΉ΄ν…Œκ³ λ¦¬ λΆ„λ₯˜: 카페, μŒμ‹μ , κ΄€κ΄‘μ§€ λ“± μΉ΄ν…Œκ³ λ¦¬λ³„ 관리
  • **보기 μ˜΅μ…˜ **: νŒ”λ‘œμž‰, 전체, 내등둝 λ³„λ‘œ 관리
  • **μ •λ ¬ μ˜΅μ…˜ **: μ΅œμ‹ μˆœ, μ’‹μ•„μš”μˆœ, ν‰μ μˆœ λ³„λ‘œ 관리

πŸ“Š 톡계 & ν”„λ‘œν•„

  • μ‚¬μš©μž ν”„λ‘œν•„: μž‘μ„±κΈ€, 받은 μ’‹μ•„μš”, νŒ”λ‘œμ›Œ/νŒ”λ‘œμž‰ 수
  • 인기 ν•΄μ‹œνƒœκ·Έ: μ‹€μ‹œκ°„ 인기 ν•΄μ‹œνƒœκ·Έ ν‘œμ‹œ
  • 데이터 ν˜„ν™©: 전체 μ‹œμŠ€ν…œ 데이터 확인

πŸš€ μ‹€ν–‰ 방법

1. μ €μž₯μ†Œ 클둠

git clone https://github.com/thlim008/streamlit_demo.git
cd streamlit_demo

2. ν•„μš”ν•œ νŒ¨ν‚€μ§€ μ„€μΉ˜

pip install -r requirements.txt

3. μ• ν”Œλ¦¬μΌ€μ΄μ…˜ μ‹€ν–‰

streamlit run main_app.py

4. μ›Ή λΈŒλΌμš°μ €μ—μ„œ 접속

https://limkyuhyun.streamlit.app/

πŸ’‘ μ‚¬μš© 방법

첫 μ‹œμž‘ν•˜κΈ°

  1. νšŒμ›κ°€μž…: πŸ“ νšŒμ›κ°€μž… νƒ­μ—μ„œ 계정 생성
  2. 둜그인: πŸ”‘ 둜그인 νƒ­μ—μ„œ 둜그인
  3. κ²Œμ‹œλ¬Ό μž‘μ„±: ✍️ κ²Œμ‹œλ¬Ό μž‘μ„± λ©”λ‰΄μ—μ„œ 첫 κ²Œμ‹œλ¬Ό μž‘μ„±

핡심 κΈ°λŠ₯ ν™œμš©

  • ν•΄μ‹œνƒœκ·Έ μ‚¬μš©: κ²Œμ‹œλ¬Όμ— #νƒœκ·Έλͺ… ν˜•νƒœλ‘œ ν•΄μ‹œνƒœκ·Έ μΆ”κ°€
  • νŒ”λ‘œμš°ν•˜κΈ°: 🏠 ν™ˆμ—μ„œ λ‹€λ₯Έ μ‚¬μš©μž νŒ”λ‘œμš°
  • ν•«ν”Œλ ˆμ΄μŠ€ 등둝: πŸ“ ν•«ν”Œλ ˆμ΄μŠ€ λ“±λ‘μ—μ„œ μž₯μ†Œ 정보와 μœ„λ„/경도 μž…λ ₯
  • μ•Œλ¦Ό 확인: πŸ”” μ•Œλ¦Ό λ©”λ‰΄μ—μ„œ 받은 μ•Œλ¦Ό 확인

κ³ κΈ‰ κΈ°λŠ₯

  • κ³ κΈ‰ 검색: πŸ” κ³ κΈ‰ 검색을 ν†΅ν•œ μ„Έλ°€ν•œ 필터링
  • μ•Œλ¦Ό μ„€μ •: βš™οΈ μ•Œλ¦Ό μ„€μ •μ—μ„œ μ›ν•˜λŠ” μ•Œλ¦Όλ§Œ 선택
  • 지도 탐색: πŸ—ΊοΈ ν•«ν”Œλ ˆμ΄μŠ€ λ§΅μ—μ„œ μ£Όλ³€ μž₯μ†Œ 발견

πŸ›  기술 μŠ€νƒ

ν”„λ‘ νŠΈμ—”λ“œ

  • Streamlit: μ›Ή μ• ν”Œλ¦¬μΌ€μ΄μ…˜ ν”„λ ˆμž„μ›Œν¬
  • Folium: μΈν„°λž™ν‹°λΈŒ 지도 (Leaflet 기반)
  • streamlit-folium: Streamlitκ³Ό Folium 연동

λ°±μ—”λ“œ & 데이터

  • Python: μ£Ό 개발 μ–Έμ–΄
  • Pandas: 데이터 처리 및 뢄석
  • CSV: 데이터 μ €μž₯ (파일 기반)

μ£Όμš” 라이브러리

streamlit              # μ›Ή μ•± ν”„λ ˆμž„μ›Œν¬
pandas                # 데이터 처리
folium                # 지도 κΈ°λŠ₯
streamlit-folium      # 지도 연동
datetime              # μ‹œκ°„ 처리
re                    # μ •κ·œν‘œν˜„μ‹ (ν•΄μ‹œνƒœκ·Έ μΆ”μΆœ)

μ‹œμŠ€ν…œ μ•„ν‚€ν…μ²˜

  • MVC νŒ¨ν„΄: auth.py (View/Controller), user_manager.py (Model)
  • CSV 기반 μ €μž₯: 별도 DB 없이 CSV 파일둜 데이터 관리
  • μ„Έμ…˜ 관리: Streamlit μ„Έμ…˜ μƒνƒœλ₯Ό ν™œμš©ν•œ 둜그인 μœ μ§€

πŸ“ ν”„λ‘œμ νŠΈ ꡬ쑰

streamlit_demo/
β”œβ”€β”€ main_app.py              # 메인 μ• ν”Œλ¦¬μΌ€μ΄μ…˜ (λΌμš°νŒ…)
β”œβ”€β”€ auth.py                  # 인증 및 κ²Œμ‹œλ¬Ό κ΄€λ ¨ UI
β”œβ”€β”€ user_manager.py          # 데이터 관리 및 λΉ„μ¦ˆλ‹ˆμŠ€ 둜직
β”œβ”€β”€ hotplace_auth.py         # ν•«ν”Œλ ˆμ΄μŠ€ κ΄€λ ¨ UI
β”œβ”€β”€ requirements.txt         # ν•„μš”ν•œ νŒ¨ν‚€μ§€ λͺ©λ‘
└── data/                    # CSV 데이터 μ €μž₯ 폴더
    β”œβ”€β”€ users.csv           # μ‚¬μš©μž 정보
    β”œβ”€β”€ posts.csv           # κ²Œμ‹œλ¬Ό
    β”œβ”€β”€ likes.csv           # μ’‹μ•„μš”
    β”œβ”€β”€ comments.csv        # λŒ“κΈ€
    β”œβ”€β”€ follows.csv         # νŒ”λ‘œμš° 관계
    β”œβ”€β”€ retweets.csv        # λ¦¬νŠΈμœ—
    β”œβ”€β”€ hashtags.csv        # ν•΄μ‹œνƒœκ·Έ
    β”œβ”€β”€ notifications.csv    # μ•Œλ¦Ό
    β”œβ”€β”€ hotplaces.csv       # ν•«ν”Œλ ˆμ΄μŠ€
    └── ...                 # 기타 데이터 νŒŒμΌλ“€

πŸ”§ 개발 참고사항

데이터 ꡬ쑰

  • CSV 기반: λͺ¨λ“  λ°μ΄ν„°λŠ” CSV 파일둜 μ €μž₯
  • μžλ™ ID 생성: user_001, post_001 ν˜•νƒœμ˜ μžλ™ ID
  • νƒ€μž„μŠ€νƒ¬ν”„: λͺ¨λ“  ν™œλ™μ— μ‹œκ°„ 기둝

λ³΄μ•ˆ 고렀사항

  • μž…λ ₯ 검증: HTML μ΄μŠ€μΌ€μ΄ν”„ 처리
  • κΆŒν•œ 확인: 본인 κ²Œμ‹œλ¬Ό/λŒ“κΈ€λ§Œ μ‚­μ œ κ°€λŠ₯
  • μ„Έμ…˜ 관리: μ•ˆμ „ν•œ 둜그인 μƒνƒœ μœ μ§€

πŸ’¬ λ¬Έμ˜μ‚¬ν•­μ΄λ‚˜ 버그 λ¦¬ν¬νŠΈκ°€ μžˆμœΌμ‹œλ©΄ Issues 탭을 μ΄μš©ν•΄μ£Όμ„Έμš”!

About

No description, website, or topics provided.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages