Spaces:
Sleeping
Sleeping
File size: 6,504 Bytes
cd5fc3c 88c7275 cd5fc3c 9381502 cd5fc3c 88c7275 cd5fc3c 9381502 cd5fc3c 88c7275 cd5fc3c 9381502 cd5fc3c 9381502 cd5fc3c 9381502 cd5fc3c 9381502 56a2bc0 87b5875 9381502 88c7275 9381502 cd5fc3c 9381502 1f9f4e8 88c7275 9381502 87b5875 9381502 56a2bc0 87b5875 56a2bc0 87b5875 9381502 87b5875 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 | ---
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 ์ถ๊ฐ
|