Spaces:
Sleeping
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
6.5 kB
| 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์์ ๋ฌธ์ ํ ์คํธ์ ๊ตฌ์กฐ ์ถ์ถ | | |
| ## ๋ฌธ์ | |
| ์ฒ์ ๋ณด๋ ์ฌ๋์ ์๋ ์์๋ก ์ฝ์ผ๋ฉด ์ ์ฒด ๊ตฌ์กฐ๋ฅผ ์ดํดํ๊ธฐ ์ฝ์ต๋๋ค. | |
| 1. [ํ๋ก์ ํธ ๊ฐ์](docs/01_overview.md) | |
| 2. [์ ์ฒด ์ํคํ ์ฒ](docs/02_architecture.md) | |
| 3. [๋ฐ์ดํฐ ํ์ดํ๋ผ์ธ](docs/03_data_pipeline.md) | |
| 4. [๋ฐ์ดํฐ๋ฒ ์ด์ค ๊ตฌ์กฐ](docs/04_database.md) | |
| 5. [๋ฐฐํฌ ๊ณํ](docs/05_deployment.md) | |
| 6. [์์ฌ๊ฒฐ์ ๊ธฐ๋ก](docs/06_decision_log.md) | |
| 7. [ํธ๋ฌ๋ธ์ํ ](docs/07_troubleshooting.md) | |
| 8. [GitHub / Hugging Face ๋ฐฐํฌ ์๋ํ](docs/08_publish_automation.md) | |
| 9. [๋ชจ๋ฐ์ผ ์ฑ์ฒ๋ผ ์ฌ์ฉํ๊ธฐ](docs/09_mobile_pwa.md) | |
| 10. [Cert Study Lab ํ์ฅ ํ๋กฌํํธ](docs/10_cert_study_lab_prompt.md) | |
| 11. [๊ฐ๋ฐ์ผ์ง](docs/devlog/2026-06-07.md) | |
| 12. [๋ณ๊ฒฝ ์ด๋ ฅ](CHANGELOG.md) | |
| ## ์คํ ๋ฐฉ๋ฒ | |
| Docker๊ฐ ์ค์น๋์ด ์๋ค๋ฉด ์๋ ๋ช ๋ น์ผ๋ก ์คํํฉ๋๋ค. | |
| ```bash | |
| cp .env.example .env | |
| docker compose up --build | |
| ``` | |
| ์คํ ํ ์ ์ ์ฃผ์: | |
| - Streamlit ์ฑ: `http://localhost:8501` | |
| - Airflow ์น์๋ฒ: `http://localhost:8080` | |
| - PostgreSQL: `localhost:5432` | |
| ๋ก์ปฌ์์ Streamlit๋ง ๋น ๋ฅด๊ฒ ํ์ธํ ๋๋ ์์ SQLite DB๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค. | |
| ```bash | |
| 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๋ ์๋ ๋ช ๋ น์ผ๋ก ๋ค์ ๋ง๋ค ์ ์์ต๋๋ค. | |
| ```bash | |
| python scripts/export_hf_seed.py | |
| ``` | |
| ## ๋ณ๊ฒฝ ์ด๋ ฅ ํ์ธ | |
| Git ์ปค๋ฐ์ ๋ ์ง์ ํจ๊ป ๋จ๊ธฐ ๋๋ฌธ์ ์ผ์๋ณ ๋ณ๊ฒฝ ๋ด์ฉ์ ํ์ธํ ์ ์์ต๋๋ค. | |
| ```bash | |
| scripts/git_daily_changes.sh 2026-06-07 | |
| ``` | |
| ## ํ ์คํธ | |
| ๋ฌธ์ ์ ํ์ด ๋ค์ํ๊ธฐ ๋๋ฌธ์ ์ ๋ต ์ฒ๋ฆฌ ๋ก์ง์ ๋ณ๋ ํ ์คํธ๋ก ํ์ธํฉ๋๋ค. | |
| ```bash | |
| python -m pip install -r requirements-dev.txt | |
| python -m pytest tests | |
| ``` | |
| ๋ฐฐํฌ ์ ์ ํต์ฌ ํ์ง ๊ฒ์ฌ๋ฅผ ํ ๋ฒ์ ์คํํ ์๋ ์์ต๋๋ค. | |
| ```bash | |
| python scripts/check_quality.py | |
| ``` | |
| ํ์ฌ ์ฐ์ ํ์ธํ๋ ๋ฒ์: | |
| - Yes/No ์ง์ ํ ์ ๋ต ์ ๊ทํ | |
| - ๋ณต์ ์ ํ ์ ๋ต ์ ๋ ฌ | |
| - ์์๊ฐ ์ค์ํ ๋ต์ ๋ณด์กด | |
| - `Hotspot (True/False)`, `Hotspot (Drag and Drop)` ๊ฐ์ ๋ฌธ์ ์ ํ alias ํ์คํ | |
| ## ํ๊ฒฝ ๋ณ์ | |
| ๊ธฐ๋ณธ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ PostgreSQL์ ๋๋ค. | |
| ```env | |
| DATABASE_URL=postgresql+pg8000://cert_study:cert_study@postgres:5432/cert_study | |
| ``` | |
| ๊ฐ๋ฐ ์ค ์์๋ก SQLite fallback์ ํ์ฉํด์ผ ํ ๋๋ง ์๋ ๊ฐ์ ์ฌ์ฉํฉ๋๋ค. | |
| ```env | |
| CERT_STUDY_DB_FALLBACK=1 | |
| ``` | |
| ## ํ์ฌ ๊ฐ๋ฐ ์ํ | |
| ์ด ํ๋ก์ ํธ๋ ๊ฐ์ธ ํ์ต๊ณผ ํฌํธํด๋ฆฌ์ค ๊ธฐ๋ก์ ๊ฒธํ ๊ฐ๋ฐ ์ค ํ๋ก์ ํธ์ ๋๋ค. ํต์ฌ ๊ตฌ์กฐ๋ ์กํ ์์ง๋ง, ํ์ฑ ์ ํ๋ ๊ฐ์ , ๋ถ๋งํฌ, ์ํ๋ณ ํต๊ณ, ์์ ์ ์ธ ๋ฐฐํฌ, ํ ์คํธ ์๋ํ๋ ๊ณ์ ๊ฐ์ ํ ์์ ์ ๋๋ค. | |
| ## ํฅํ ๊ฐ์ ํ ๊ธฐ๋ฅ | |
| - ๋ถ๋งํฌ ๊ธฐ๋ฅ | |
| - ์ํ๋ณ ์ง๋์จ๊ณผ ์ ๋ต๋ฅ ํต๊ณ | |
| - ํ์ฑ ์คํจ ๋ฌธ์ ์ ๊ฒ์ ํ๋ฉด ๊ฐ์ | |
| - ๋ฌธ์ ์ค๋ณต ๊ฐ์ง ๋ฐ ์ฌ์ ๋ก๋ ์ฒ๋ฆฌ | |
| - Oracle Cloud Ubuntu ์๋ฒ ๋ฐฐํฌ | |
| - ๋ฐฐํฌ์ฉ ํ๊ฒฝ ๋ณ์์ ๋น๋ฐ๊ฐ ๊ด๋ฆฌ ์ ๋ฆฌ | |
| - ํ ์คํธ ๋ฒ์ ํ๋์ CI/CD ์ถ๊ฐ | |