# 학생 내신 성적 분석 대시보드 사용설명서 ## 1. 프로그램 개요 학생 내신 성적 분석 대시보드는 여러 학년·학기의 성적 자료를 불러와 학생별로 통합하고, 평균·가중 평균·과목군별 성적·성적 변화 등을 자동으로 분석하는 웹 프로그램입니다. 별도의 프로그램 설치나 회원가입 없이 웹브라우저에서 사용할 수 있습니다. 학생 성적 자료는 서버로 전송되지 않고 현재 사용 중인 브라우저 내부에서만 처리됩니다. --- ## 2. 프로그램 실행 웹브라우저에서 다음 주소로 접속합니다. **mordenai-grade-dashboard.vercel.app** Chrome, Edge 등 최신 브라우저 사용을 권장합니다. --- ## 3. 성적 자료 준비 프로그램에서는 다음 방식으로 자료를 불러올 수 있습니다. - 엑셀 파일 `.xlsx` - 구형 엑셀 파일 `.xls` - CSV 파일 `.csv` - 여러 파일 동시 선택 - 폴더 단위 일괄 선택 - 엑셀에서 복사한 표 직접 붙여넣기 - 프로그램에서 생성한 암호화 성적 파일 한 번에 지나치게 많은 대용량 파일을 불러오는 것을 방지하기 위해 파일 수와 용량 제한이 적용되어 있습니다. --- ## 4. 성적 파일 불러오기 ### 방법 1. 파일 선택 성적 파일 불러오기 버튼을 누른 뒤 분석할 엑셀 또는 CSV 파일을 선택합니다. 여러 파일을 동시에 선택할 수 있습니다. ### 방법 2. 폴더 전체 불러오기 학년·학기별 성적 파일이 한 폴더에 정리되어 있다면 폴더 선택 기능을 이용하여 한 번에 불러올 수 있습니다. ### 방법 3. 드래그앤드롭 성적 파일을 프로그램의 업로드 영역으로 끌어다 놓아도 됩니다. ### 방법 4. 직접 붙여넣기 엑셀에서 필요한 영역을 복사한 뒤 프로그램의 붙여넣기 입력 영역에 붙여넣을 수 있습니다. --- ## 5. 지원하는 성적표 형태 프로그램은 성적표의 구조를 자동으로 판별합니다. 주요 지원 형식은 다음과 같습니다. - 일반적인 학생별 열 구조의 성적표 - NEIS 학기말 성적 종합일람표 - 학교생활기록부 교과학습발달사항 자료 - 반·번호·교과 등이 표 형태로 배치된 그리드·피벗형 자료 파일 구조를 자동으로 분석하므로 사용자가 열 위치를 일일이 지정할 필요가 없습니다. --- ## 6. 학생 자료 통합 여러 학기 또는 여러 학년의 파일을 불러오면 프로그램이 동일 학생의 성적을 자동으로 통합합니다. 통합 과정에서는 다음 사항을 처리합니다. - 동일 학생의 여러 학기 자료 병합 - 중복된 성적 자료 제거 - 최근에 입력한 자료 우선 적용 - 학번 변경 학생 보정 - 전입생 임시 학번 보정 - 동명이인 감지 - 누락 학기 확인 학생 이름과 학번 정보를 함께 활용하여 최대한 정확하게 학생 자료를 구분합니다. --- ## 7. 학생 검색 성적 자료를 불러온 후 학생 이름이나 학번을 이용해 학생을 검색할 수 있습니다. 학생을 선택하면 해당 학생의 전체 성적 분석 화면이 표시됩니다. --- ## 8. 성적 분석 결과 학생을 선택하면 다음 정보를 확인할 수 있습니다. ### 단순 평균 학생이 이수한 각 과목의 등급을 동일한 비중으로 계산한 평균입니다. ### 이수 단위 가중 평균 과목별 이수 단위를 반영하여 계산한 평균입니다. 이수 단위가 높은 과목의 성적이 더 큰 비중으로 반영됩니다. ### 총 이수 단위 학생이 이수한 전체 교과의 단위 수를 합산하여 표시합니다. ### 과목군별 평균 국어, 수학, 영어, 사회, 과학 등 과목군별로 성적을 묶어 평균을 확인할 수 있습니다. ### 학기별 성적 변화 학년 및 학기별 성적 변화를 차트로 확인할 수 있습니다. 이를 통해 성적 향상·하락 추세를 쉽게 파악할 수 있습니다. --- ## 9. 차트 활용 프로그램은 학생의 성적을 여러 형태의 차트로 제공합니다. - 과목군 비교 차트 - 학기별 성적 추이 - 학생별 강점·약점 비교 등급은 숫자가 작을수록 좋은 성적이라는 특성을 반영하여 차트가 표시됩니다. --- ## 10. 누락 자료 확인 일부 학기나 과목의 자료가 없는 경우 프로그램에서 이를 표시합니다. 학생이 전입·전출했거나 특정 학기 성적 자료가 입력되지 않은 경우도 분석 과정에서 확인할 수 있습니다. 누락 표시는 실제 학교 자료와 비교하여 최종 확인하는 것이 좋습니다. --- ## 11. 분석 결과 내보내기 분석 결과는 엑셀 파일로 저장할 수 있습니다. 내보낸 파일에는 다음 내용이 포함될 수 있습니다. - 학생별 성적 요약 - 평균 및 가중 평균 - 이수 단위 - 분석에 사용된 원전자료 내보낸 파일에는 개인정보가 포함될 수 있으므로 안전하게 관리해야 합니다. --- ## 12. 암호화 파일로 저장 개인정보 보호가 필요한 경우 분석 결과를 암호화된 파일로 저장할 수 있습니다. 암호화 저장 시 사용자가 비밀번호를 설정합니다. 암호화 방식은 AES-256-GCM 기반으로 동작하며, 암호화된 파일은 프로그램에서 다시 불러와 복호화할 수 있습니다. ### 주의 암호화 비밀번호는 서버에 저장되지 않습니다. 비밀번호를 분실하면 파일을 복구할 수 없으므로 반드시 안전하게 보관해야 합니다. --- ## 13. 암호화 파일 다시 불러오기 프로그램에서 생성한 암호화 성적 파일을 업로드하면 비밀번호 입력 창이 표시됩니다. 정확한 비밀번호를 입력하면 기존 분석 자료를 다시 불러올 수 있습니다. 잘못된 비밀번호를 입력하면 파일은 열리지 않습니다. --- ## 14. 초기화 새로운 학생 자료를 분석하거나 기존 자료를 모두 제거하려면 초기화 기능을 이용합니다. 초기화하면 다음 정보가 제거됩니다. - 불러온 성적 자료 - 학생 분석 결과 - 검색어 - 선택된 학생 - 차트 및 화면 상태 초기화된 데이터는 프로그램에서 다시 복구할 수 없습니다. --- ## 15. 개인정보 보호 안내 이 프로그램은 학생의 이름, 학번, 교과 성적 등 개인정보가 포함된 자료를 처리할 수 있습니다. 그러나 입력한 자료는 다음과 같이 처리됩니다. - 서버로 전송하지 않음 - 데이터베이스에 저장하지 않음 - 쿠키에 저장하지 않음 - 브라우저 로컬 저장소에 저장하지 않음 - 외부 분석 서비스에 전송하지 않음 - 광고 및 사용자 추적 기능 사용하지 않음 성적 자료는 현재 브라우저의 메모리에서만 처리됩니다. 페이지를 닫거나 초기화하면 프로그램은 해당 자료를 유지하지 않습니다. 단, 사용자가 내려받은 엑셀 파일은 컴퓨터에 남으므로 별도로 안전하게 관리해야 합니다. --- ## 16. 권장 사용 방법 학생 개인정보 보호를 위해 다음 사항을 권장합니다. - 학교 업무용 컴퓨터에서 사용 - 공용 PC에서 사용 후 반드시 프로그램 초기화 - 다운로드한 성적 파일을 개인 클라우드에 무분별하게 저장하지 않기 - 필요하지 않은 성적 파일은 즉시 삭제 - 민감한 분석 결과는 암호화 파일로 저장 - 암호화 파일의 비밀번호는 파일과 별도로 관리 --- ## 17. 오류가 발생하는 경우 성적 파일이 정상적으로 분석되지 않는 경우 다음 사항을 확인합니다. - 지원하는 파일 형식인지 확인 - Excel 임시 파일인 `~$` 파일이 아닌지 확인 - 파일이 손상되지 않았는지 확인 - NEIS에서 정상적으로 내려받은 파일인지 확인 - 파일 크기가 지나치게 크지 않은지 확인 특정 성적표가 계속 인식되지 않는 경우 원본 파일의 개인정보를 제거한 샘플을 이용해 프로그램 구조를 점검하는 것이 좋습니다. --- ## 18. 개인정보처리방침 프로그램 하단의 **개인정보처리방침**을 통해 자세한 개인정보 보호 내용을 확인할 수 있습니다. --- ## 19. 프로그램 특징 요약 이 프로그램의 가장 큰 특징은 다음 세 가지입니다. **첫째, 여러 형식의 성적 자료를 자동으로 인식합니다.** **둘째, 여러 학년과 학기의 성적을 학생별로 자동 통합하여 분석합니다.** **셋째, 학생 성적 자료를 외부 서버로 보내지 않고 사용자의 브라우저 안에서 처리합니다.** 이를 통해 교사가 학생 상담과 진로·진학 지도에 필요한 성적 정보를 보다 빠르고 안전하게 확인할 수 있습니다.