Spaces:
Sleeping
Sleeping
File size: 3,003 Bytes
88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 9381502 88c7275 | 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 | # Cert Study Lab Architecture
์ด ํ์ผ์ ๊ฐ๋ฐ ์ค ๋น ๋ฅด๊ฒ ๋ณด๋ ์์ฝ์
๋๋ค. ์์ธํ ์ค๋ช
์ `docs/02_architecture.md`๋ฅผ ๊ธฐ์ค ๋ฌธ์๋ก ๋ด
๋๋ค.
## Current Shape
```text
Streamlit UI
-> QuizService / LearningLabService / LearningProgressService
-> ConceptNoteService / IngestionJobService / QuestionVectorStore
-> PostgreSQL app DB
-> Chroma vector index
-> data/learning_progress.json
Airflow DAGs
-> PDF ingestion DAG
-> visual analysis DAG
-> PostgreSQL app DB
Ollama
-> text/study assistant
-> visual question parsing
```
## User-Facing Pages
Keep the first screen light. The home page is a launcher, not a dashboard.
```text
Home
Continue Study
Focus Study
Exam Study
Dashboard
Roadmap
Theory Learning
Learning Quiz
Certification Questions
Wrong/Review
Concept Notes
Processing Status
Content Management
PDF Upload
Exam Overview
AI Index
```
## Study Flow
`Continue Study` remembers the selected Track and lets the learner keep going instead of stopping at a fixed daily quota.
```text
Track
-> Certification
-> Roadmap / Lesson / Quiz / Practice
-> Certification Questions
-> Wrong Review
-> Dashboard
```
The current active Tracks are:
- `Linux -> LFCS`
- `Azure -> AZ-104`
- `Tool Docs -> Docs Study`
Future Tracks such as Git, Python, SQL, Docker, and Kubernetes are represented in the service data but hidden until ready.
## Data Ownership
```text
PostgreSQL
Canonical app data: questions, answers, attempts, concept notes, ingestion jobs.
Chroma
Search index: embeddings for similar question and document retrieval.
data/learning_progress.json
Local learner state: preferred Track, study steps, activity counts.
cert_study_app/demo_data/questions_seed.json
Deployable seed for Hugging Face Space.
```
Do not commit runtime data such as local DB files, Chroma indexes, Airflow logs, uploaded PDFs, or private `.env` files.
## Question Statuses
```text
approved
Stable enough for normal quiz use.
needs_visual
Requires visual analysis or has a failed visual-analysis result.
needs_review
Needs human definition or correction.
draft
Waiting for processing.
rejected
Excluded from quiz flow.
```
The quiz repository treats only `approved` as playable.
## Metadata Split
```text
question_type
How the UI should render the answer interaction.
Examples: mcq, multi_select, yes_no, hotspot, table_choice, ordering.
category / subcategory / concept_tags
What the learner is studying.
Examples: az104_networking / vnet_subnet, az104_compute / vm.
```
Weak study should prefer `subcategory` because it is more precise than broad `category`.
## Cleanup Priorities
- Move learning progress from JSON to PostgreSQL when multi-user support starts.
- Keep Streamlit page routing names aligned with user-facing labels.
- Keep long PDF/image processing in Airflow, not inside direct Streamlit requests.
- Add more tests around Track progress, question category filters, and PWA/static file behavior.
|