SCH Web Portal 개발 문서
순천향대학교 비공식 학생 포털 — 백엔드 API 명세 및 개발 협업 가이드
프로젝트 소개
SCH Web Portal은 순천향대학교 통합정보시스템의 불편한 UI를 대체하는 비공식 학생 포털입니다.
Django REST Framework 백엔드가 학교 서버와 통신하여 데이터를 중계하고, React + Vite 프론트엔드가 사용하기 편한 UI를 제공합니다.
기술 스택
| 레이어 | 기술 |
|---|---|
| 백엔드 | Django 6.0.5, DRF, MySQL (PyMySQL), cryptography, requests, gunicorn |
| 프론트엔드 | React 19, TypeScript 6, Vite 8, react-router-dom 7, lucide-react |
| AI 챗봇 | 자체 호스팅 vLLM (OpenAI 호환 API), 시맨틱 검색(BGE-M3 + Qdrant + reranker), pymupdf/pyhwp 등 첨부 문서 추출 |
구현된 기능
| 카테고리 | 기능 |
|---|---|
| 인증 | SCH 로그인 / AES-256-GCM 세션 쿠키 / 자동 갱신 |
| 학적 | 학적정보 / 학적사항관리 10개 탭 / 증명사진 프록시 |
| 성적 | 누적성적 / 학기성적 / 성적표(가정통신문) |
| 졸업진도 | 학점 매트릭스 / 비교과 역량 / 필수 교과목 이수 현황 / 강제 동기화 |
| 시간표 | 개인 시간표 / 테마 스토어 / 교수별 / 강의실별 / 검색 |
| 교과과정 | 학과별 교과과정 |
| 수강 | 수강 과목 목록 / 수강신청 확인서 / 폐강 과목 |
| 장학 | 장학금 검색 / 모집 게시판 / 증명서 |
| 기숙사 | 고지서 / 호실 / 통행증 / 배정결과 / 상벌점 / 외박신청 / 점호 마일리지 |
| 활동 | 봉사활동 / 비교과과정 / 봉사학습 |
| 등록금 | 등록금 정보 / 교육비 증명서 / 등록 고지서 |
| 강의평가 | 기간 조회 / 문항 조회 / 제출 |
| 기타 | 하이플렉스 / 콰르텟 티칭 / 국제학생증 / 교환학생 패스 / 교직 이수 |
| 공통 | 즐겨찾기 / 공지사항 / 학사일정 |
| AI 챗봇 | 순라이프 AI 공지 챗봇 / NDJSON 스트리밍 응답 / 답변 중단 / 고성능 모드 / 대화 기록(로컬·클라우드) / 답변 평가 |
빠른 시작
API 엔드포인트 요약
| 그룹 | 경로 prefix | 주요 기능 |
|---|---|---|
| 인증 | /api/auth/ | 로그인, 세션 갱신, 로그아웃 |
| 학적 | /api/academic/, /api/main/ | 학적정보, 학적사항 탭별 조회 |
| 학사일정 | /api/events/ | 월별 학사일정 (공개) |
| 공지사항 | /api/notices/ | 8개 카테고리 페이지네이션 (공개) |
| 즐겨찾기 | /api/favorites/ | 메뉴 즐겨찾기 저장 |
| 성적 | /api/grades/ | 누적성적, 학기성적, 성적표 |
| 졸업 | /api/graduation/ | 진도 상세, 강제 동기화 |
| 시간표 | /api/timetable/ | 테마 CRUD, 검색, 편람 |
| 교수별 | /api/professor/ | 교수 검색, 교수별 시간표 |
| 강의실별 | /api/classroom/ | 건물/강의실 목록, 시간표 |
| 수강 | /api/class-list/, /api/course-registration/ | 수강 과목, 확인서, 폐강 |
| 교과과정 | /api/curriculum/ | 학과별 교과과정 |
| 장학 | /api/scholarship/ | 장학금 검색, 게시판, 증명서 |
| 기숙사 | /api/dorm/ | 고지서, 호실, 통행증, 외박, 상벌점 |
| 활동 | /api/volunteer-service/, /api/extracurricular/, /api/service-learning/ | 봉사, 비교과, 봉사학습 |
| 등록금 | /api/tuition/, /api/edupay/ | 등록금, 교육비 증명서 |
| 강의평가 | /api/lect-eval/ | 기간, 문항, 제출 |
| AI 챗봇 | /api/chat/ | 메시지 전송(스트리밍), 중단, 대화 기록, 답변 평가 |
| 기타 | /api/hiflex/, /api/quartet/, /api/isic/, ... | 하이플렉스, 콰르텟, 국제학생증 |