Spaces:
Sleeping
Download README.md from Kentlo/cert-study-app: direct link, hf CLI and curl.
- Browser
- Download file 6.5 kB
-
https://huggingface.co/spaces/Kentlo/cert-study-app/resolve/main/README.md
- Command line
-
hf download hf://spaces/Kentlo/cert-study-app/README.md
-
curl -L -o README.md https://huggingface.co/spaces/Kentlo/cert-study-app/resolve/main/README.md
title: Cert Study Lab
emoji: ๐
colorFrom: blue
colorTo: green
sdk: docker
app_port: 8501
pinned: false
Cert Study Lab
์๊ฒฉ์ฆ ์ํ ๋ฌธ์ PDF๋ฅผ ์ ๋ก๋ํ๊ณ , ํ์ฑ๋ ๋ฌธ์ ๋ฅผ ์น์์ ํ ์ ์๋๋ก ๋ง๋๋ ๊ฐ์ธ ๊ฐ๋ฐ ํ๋ก์ ํธ์ ๋๋ค.
ํ์ฌ๋ PDF ์ฒ๋ฆฌ ํ์ดํ๋ผ์ธ, ๋ฌธ์ ์ ์ฅ, ๋ฌธ์ ํ์ด ํ๋ฉด, ์ค๋ต/๋ณต์ต ํ๋ฆ, ๊ฐ๋
์ ๋ฆฌ, ์ ์ฌ ๋ฌธ์ ๊ฒ์ ๊ตฌ์กฐ๋ฅผ ํจ๊ป ์คํํ๊ณ ์์ต๋๋ค. ์ต๊ทผ์๋ ๊ธฐ์กด ๋ฌธ์ ํ์ด ๊ธฐ๋ฅ ์์ ์ด์ด์ ๊ณต๋ถ, ์ง์ค ํ์ต, ์ํ ๋๋น, ๋ก๋๋งต, ์ด๋ก ํ์ต, ํ์ธ ํด์ฆ, ์ค์ตํ๊ธฐ, ์ง๋์จ ํ๋ฉด์ ์น์ด ํ์ต ํ๋ซํผ ํํ๋ก ํ์ฅํ๊ณ ์์ต๋๋ค. MVP์ ์์ Track์ Azure์ Linux์ด๋ฉฐ, ๊ฐ Track ์๋์ AZ-104, LFCS ๊ฐ์ ๋ชฉํ ์๊ฒฉ์ฆ์ ์ฐ๊ฒฐํฉ๋๋ค. ๊ธฐ๋ณธ ์ง์ค Track์ Linux ยท LFCS์
๋๋ค.
ํ๋ก์ ํธ ๋ชฉ์
์๊ฒฉ์ฆ ๋ฌธ์ PDF๋ ์ฌ๋์ด ์ง์ ์ ๋ฆฌํ๊ธฐ ๋ฒ๊ฑฐ๋กญ์ต๋๋ค. ์ด ํ๋ก์ ํธ๋ PDF ์์ ๋ฌธ์ ๋ฅผ ์ต๋ํ ์๋์ผ๋ก ๊ตฌ์กฐํํ๊ณ , ์ฌ์ฉ์๊ฐ ์น์์ ๋ฐ๋ก ํ๊ณ ๋ณต์ตํ ์ ์๋ ํ์ต ํ๊ฒฝ์ ๋ง๋๋ ๊ฒ์ ๋ชฉํ๋ก ํฉ๋๋ค.
์ฃผ์ ๊ธฐ๋ฅ
- ์ํ๋ณ PDF ์ ๋ก๋
- PDF ํ ์คํธ ํ์ฑ ๋ฐ ์ผ๋ถ OCR/LLM ๊ธฐ๋ฐ ๋ณด์ ํ๋ฆ
- ํ์ฑ ํ์ง ๊ฒ์ฆ ๋ฐ ํ์ง ๊ฒ์ดํธ
- ๋ฌธ์ , ์ ๋ต, ํด์ค, ํ์ด ๊ธฐ๋ก ์ ์ฅ
- Streamlit ๊ธฐ๋ฐ ๋ฌธ์ ํ์ด ํ๋ฉด
- ๊ณตํต ์ง๋ฌธ, ์๋ฌธ ์ด๋ฏธ์ง, Yes/No ์ง์ ํ ๋ฌธ์ ํ์ด UI
- ๋ฌธ์ ์ ํ ํ์คํ ๋ฐ ์ ๋ต ์ ๊ทํ ๋ก์ง
- ์ค๋ต/๋ณต์ต ํ๋ฉด
- ๊ฐ๋ ์ ๋ฆฌ ํ๋ฉด
- ๋จ์ ์์ ํ๊ณผ ๋ณ๋ ๋์๋ณด๋ ํ๋ฉด
- ์ด์ด์ ๊ณต๋ถ / ์ง์ค ํ์ต / ์ํ ๋๋น ๋ชจ๋ ๋ถ๋ฆฌ
- Azure / Linux ๋ก๋๋งต
- Azure ํ์ AZ-104, Linux ํ์ LFCS ๊ณ์
- AZ-104 ๋๋ถ๋ฅ/์ธ๋ถ๊ฐ๋ ํํฐ ๊ธฐ๋ฐ ๋ฐ๋ณต ํ์ด
- Git, Python, SQL, Docker, Kubernetes ํ์ฅ Track ๊ตฌ์กฐ
- Tool Docs Track: Ollama, LangChain, Streamlit, Hugging Face ๊ณต์ ๋ฌธ์ ํ์ต
- ์ฒดํฌ๋ฆฌ์คํธํ ๊ธฐ๋ณธ ํ์ต ํ๋ฆ
- ์ผ๋ณ ํ์ต ๊ธฐ๋ก, ์ฐ์ ํ์ต์ผ, ์ฃผ๊ฐ ํ์ต๋ ํ์
- ๋ง์ง๋ง์ผ๋ก ์ ํํ Track ์ ์ฅ ๋ฐ ์ฌ์ฌ์ฉ
- ์ด๋ก , ํด์ฆ, ์ค์ต, ๋ฌธ์ ํ์ด, ์ค๋ต ๋ณต์ต์
์ค๋ ๋์ n๋จ์๋ก ๊ธฐ๋ก - ์ธ๋ถ๊ฐ๋ ์ค๋ต ๊ธฐ๋ฐ ์ค๋ ์ถ์ฒ ๋ณต์ต
- ๊ด๋ฆฌ์ ํ๋ฉด ์์ชฝ AZ-104 ๋ถ๋ฅ ๊ฒ์
- ์ด๋ก ์นด๋์ ํ์ธ ํด์ฆ ์ํ
- Linux fake terminal ์ค์ต ์ํ
- ์ํ ๋ชจ๋์ Track ์ง๋์จ ๊ธฐ๋ณธ ํ๋ฉด
- Chroma ๊ธฐ๋ฐ ์ ์ฌ ๋ฌธ์ ๊ฒ์ ๊ตฌ์กฐ
- Airflow ๊ธฐ๋ฐ PDF ์ฒ๋ฆฌ ์์ ๊ด๋ฆฌ
- Docker Compose ๊ธฐ๋ฐ ๋ก์ปฌ ์คํ ํ๊ฒฝ
๊ธฐ์ ์คํ
| ์์ญ | ์ฌ์ฉ ๊ธฐ์ | ์ญํ |
|---|---|---|
| ์น UI | Streamlit | ๋ฌธ์ ํ์ด, PDF ์ ๋ก๋, ์ฒ๋ฆฌ ํํฉ ํ์ธ |
| ๊ด๊ณํ DB | PostgreSQL | ๋ฌธ์ , ์ ๋ต, ํ์ด ๊ธฐ๋ก, ์ฒ๋ฆฌ ์์ ์ ์ฅ |
| ๋ฒกํฐ DB | Chroma | ์ ์ฌ ๋ฌธ์ ๊ฒ์, ๋ฌธ์ ๊ฒ์์ฉ ์๋ฒ ๋ฉ ์ ์ฅ |
| ์ํฌํ๋ก | Airflow | PDF ์ฒ๋ฆฌ ํ์ดํ๋ผ์ธ ์คํ๊ณผ ์ถ์ |
| ์คํ ํ๊ฒฝ | Docker / Docker Compose | ์ฑ, DB, Airflow ์คํ ํ๊ฒฝ ํต์ผ |
| PDF ์ฒ๋ฆฌ | PyMuPDF, Parser, ์ ํ์ LLM | PDF์์ ๋ฌธ์ ํ ์คํธ์ ๊ตฌ์กฐ ์ถ์ถ |
๋ฌธ์
์ฒ์ ๋ณด๋ ์ฌ๋์ ์๋ ์์๋ก ์ฝ์ผ๋ฉด ์ ์ฒด ๊ตฌ์กฐ๋ฅผ ์ดํดํ๊ธฐ ์ฝ์ต๋๋ค.
- ํ๋ก์ ํธ ๊ฐ์
- ์ ์ฒด ์ํคํ ์ฒ
- ๋ฐ์ดํฐ ํ์ดํ๋ผ์ธ
- ๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ตฌ์กฐ
- ๋ฐฐํฌ ๊ณํ
- ์์ฌ๊ฒฐ์ ๊ธฐ๋ก
- ํธ๋ฌ๋ธ์ํ
- GitHub / Hugging Face ๋ฐฐํฌ ์๋ํ
- ๋ชจ๋ฐ์ผ ์ฑ์ฒ๋ผ ์ฌ์ฉํ๊ธฐ
- Cert Study Lab ํ์ฅ ํ๋กฌํํธ
- ๊ฐ๋ฐ์ผ์ง
- ๋ณ๊ฒฝ ์ด๋ ฅ
์คํ ๋ฐฉ๋ฒ
Docker๊ฐ ์ค์น๋์ด ์๋ค๋ฉด ์๋ ๋ช ๋ น์ผ๋ก ์คํํฉ๋๋ค.
cp .env.example .env
docker compose up --build
์คํ ํ ์ ์ ์ฃผ์:
- Streamlit ์ฑ:
http://localhost:8501 - Airflow ์น์๋ฒ:
http://localhost:8080 - PostgreSQL:
localhost:5432
๋ก์ปฌ์์ Streamlit๋ง ๋น ๋ฅด๊ฒ ํ์ธํ ๋๋ ์์ SQLite DB๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค.
DATABASE_URL=sqlite:////tmp/cert-study-local-check.db \
python -m streamlit run streamlit_app.py
๋ฐฐํฌ์ฉ ๋ฌธ์ ๋ฐ์ดํฐ
Hugging Face Space์๋ ๋ก์ปฌ DB๋ PDF ์๋ณธ์ ์ฌ๋ฆฌ์ง ์๊ณ , cert_study_app/demo_data/questions_seed.json๊ณผ static/question_assets/์ ์ฐธ์กฐ ์ด๋ฏธ์ง๋ฅผ ์ฌ์ฉํฉ๋๋ค.
ํ์ฌ ๋ฐฐํฌ์ฉ seed๋ 321๋ฌธํญ, ๊ณตํต ์ง๋ฌธ ํฌํจ 36๋ฌธํญ, ์๋ฌธ ์ด๋ฏธ์ง, Yes/No ์ง์ ํ ๋ฌธ์ UI์ ํ์ํ ๊ตฌ์กฐ๋ฅผ ํฌํจํฉ๋๋ค. seed๋ ์๋ ๋ช ๋ น์ผ๋ก ๋ค์ ๋ง๋ค ์ ์์ต๋๋ค.
python scripts/export_hf_seed.py
๋ณ๊ฒฝ ์ด๋ ฅ ํ์ธ
Git ์ปค๋ฐ์ ๋ ์ง์ ํจ๊ป ๋จ๊ธฐ ๋๋ฌธ์ ์ผ์๋ณ ๋ณ๊ฒฝ ๋ด์ฉ์ ํ์ธํ ์ ์์ต๋๋ค.
scripts/git_daily_changes.sh 2026-06-07
ํ ์คํธ
๋ฌธ์ ์ ํ์ด ๋ค์ํ๊ธฐ ๋๋ฌธ์ ์ ๋ต ์ฒ๋ฆฌ ๋ก์ง์ ๋ณ๋ ํ ์คํธ๋ก ํ์ธํฉ๋๋ค.
python -m pip install -r requirements-dev.txt
python -m pytest tests
๋ฐฐํฌ ์ ์ ํต์ฌ ํ์ง ๊ฒ์ฌ๋ฅผ ํ ๋ฒ์ ์คํํ ์๋ ์์ต๋๋ค.
python scripts/check_quality.py
ํ์ฌ ์ฐ์ ํ์ธํ๋ ๋ฒ์:
- Yes/No ์ง์ ํ ์ ๋ต ์ ๊ทํ
- ๋ณต์ ์ ํ ์ ๋ต ์ ๋ ฌ
- ์์๊ฐ ์ค์ํ ๋ต์ ๋ณด์กด
Hotspot (True/False),Hotspot (Drag and Drop)๊ฐ์ ๋ฌธ์ ์ ํ alias ํ์คํ
ํ๊ฒฝ ๋ณ์
๊ธฐ๋ณธ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ PostgreSQL์ ๋๋ค.
DATABASE_URL=postgresql+pg8000://cert_study:cert_study@postgres:5432/cert_study
๊ฐ๋ฐ ์ค ์์๋ก SQLite fallback์ ํ์ฉํด์ผ ํ ๋๋ง ์๋ ๊ฐ์ ์ฌ์ฉํฉ๋๋ค.
CERT_STUDY_DB_FALLBACK=1
ํ์ฌ ๊ฐ๋ฐ ์ํ
์ด ํ๋ก์ ํธ๋ ๊ฐ์ธ ํ์ต๊ณผ ํฌํธํด๋ฆฌ์ค ๊ธฐ๋ก์ ๊ฒธํ ๊ฐ๋ฐ ์ค ํ๋ก์ ํธ์ ๋๋ค. ํต์ฌ ๊ตฌ์กฐ๋ ์กํ ์์ง๋ง, ํ์ฑ ์ ํ๋ ๊ฐ์ , ๋ถ๋งํฌ, ์ํ๋ณ ํต๊ณ, ์์ ์ ์ธ ๋ฐฐํฌ, ํ ์คํธ ์๋ํ๋ ๊ณ์ ๊ฐ์ ํ ์์ ์ ๋๋ค.
ํฅํ ๊ฐ์ ํ ๊ธฐ๋ฅ
- ๋ถ๋งํฌ ๊ธฐ๋ฅ
- ์ํ๋ณ ์ง๋์จ๊ณผ ์ ๋ต๋ฅ ํต๊ณ
- ํ์ฑ ์คํจ ๋ฌธ์ ์ ๊ฒ์ ํ๋ฉด ๊ฐ์
- ๋ฌธ์ ์ค๋ณต ๊ฐ์ง ๋ฐ ์ฌ์ ๋ก๋ ์ฒ๋ฆฌ
- Oracle Cloud Ubuntu ์๋ฒ ๋ฐฐํฌ
- ๋ฐฐํฌ์ฉ ํ๊ฒฝ ๋ณ์์ ๋น๋ฐ๊ฐ ๊ด๋ฆฌ ์ ๋ฆฌ
- ํ ์คํธ ๋ฒ์ ํ๋์ CI/CD ์ถ๊ฐ