Spaces:

Kentlo
/

cert-study-app

Running

홈은 대시보드가 아니라 학습 시작점을 고르는 화면입니다. 진도, 연속 학습일, 추천 복습은 별도 대시보드에서 확인합니다. 이 중 핵심은 PDF 업로드, 문제 저장, 문제 풀이, 복습 흐름이고, 최근에는 이론 학습과 확인 퀴즈를 붙여 계속 공부하기 쉬운 구조로 다듬고 있습니다.

주요 기능

PDF 업로드

시험명과 PDF를 지정해 문제 처리 작업을 시작합니다. 업로드된 PDF는 파싱 파이프라인을 거쳐 문제 데이터로 변환됩니다.

문제 구조화

PDF에서 추출한 텍스트를 문제 단위로 나누고, 문제 본문, 보기, 정답, 해설, 페이지 정보 등을 가능한 한 구조화합니다.

파싱 품질 검증

문제가 제대로 나뉘었는지, 보기나 정답이 비어 있지 않은지 같은 기본 품질을 확인합니다. 품질이 낮으면 바로 저장하지 않고 검토가 필요한 상태로 볼 수 있게 하는 방향입니다.

문제 풀이

저장된 문제를 시험별로 선택해 풀 수 있습니다. 사용자의 선택과 정답 여부는 풀이 기록으로 저장할 수 있는 구조를 가지고 있습니다.

현재 문제풀이 화면은 일반 객관식뿐 아니라 공통 지문 문제, 원문 이미지 보기, Yes/No 진술형 문제, 항목별 선택 문제를 구분해서 표시하는 방향으로 개선하고 있습니다.

이어서 공부

마지막으로 선택한 Track을 기억하고, 사용자가 다음 접속 때 이어서 공부할 수 있게 구성합니다. Track은 Linux, Azure, Tool Docs처럼 나뉘며, 각 Track 안에서 이론 카드, 확인 퀴즈, 오답 복습으로 자연스럽게 이어집니다.

대시보드

첫 화면을 무겁게 만들지 않기 위해 대시보드는 별도 화면으로 분리했습니다. 대시보드에서는 현재 선택한 Track, 기본 학습 흐름 진행률, 오늘 누적 학습 단위, 주간 누적 학습량, 오답 기반 추천 복습을 확인합니다.

오답/복습

틀린 문제를 다시 확인하고, 복습 흐름으로 이어갈 수 있도록 구성하고 있습니다.

개념 정리

문제에서 자주 등장하는 개념을 요약하고, 시험 포인트와 헷갈리기 쉬운 포인트를 정리하는 기능을 목표로 합니다.

유사 문제 검색

Chroma에 문제 임베딩을 저장해, 현재 문제와 비슷한 문제를 찾을 수 있는 구조를 사용합니다.

현재 개발 상태

이 프로젝트는 아직 운영 중인 완성 서비스가 아니라 개발 중인 개인 프로젝트입니다.

현재는 다음 부분에 집중하고 있습니다.

PDF 파싱 결과를 더 안정적으로 만들기
파싱 품질을 자동으로 검증하기
공통 지문과 원문 이미지가 문제풀이 화면에서 누락되지 않게 하기
Yes/No 진술형 문제를 객관식이 아니라 진술별 선택 UI로 제공하기
PostgreSQL과 Chroma의 역할을 명확히 나누기
Airflow로 긴 PDF 처리 작업을 관리하기
Streamlit 화면을 실제 공부하기 편한 흐름으로 다듬기
Track별 이론/퀴즈/실습 흐름을 계속 이어서 공부할 수 있게 만들기

Hugging Face Space 배포용으로는 로컬 DB나 PDF 원본 대신 questions_seed.json과 필요한 정적 이미지를 사용합니다. 현재 seed에는 321문항이 포함되어 있습니다.

앞으로 개선할 기능

북마크 기능
시험별 학습 진도율
정답률과 취약 유형 통계
파싱 실패 문제 검수 화면
중복 문제 감지
배포 환경 정리
테스트 자동화