특성화고 학생 성장관리 플랫폼

학생이 5개 영역(성실·학업/영어·자격증·직업공통/행사·예체능/인성)별 인증 진행 상황과 학년별 등급 기준 충족 여부를 한눈에 확인합니다.

• PostgreSQL에 영역별 배점 규칙 테이블을 정규화하여 학년별 초기화/누적 조건을 데이터로 관리
• React Query로 인증 현황 데이터를 캐싱하고 Recharts 레이더 차트로 5영역 균형을 시각화
• 학년 전환 시점에 초기화 대상 영역만 선택적으로 리셋하는 배치 로직 구현

5영역 배점 규칙을 룰 엔진 형태로 분리 설계하여 배점 기준 변경 시 코드 수정 없이 데이터만 갱신되는 구조를 구현합니다.

학생이 관심기업을 선택하면 해당 기업의 가중치 기준으로 종합 점수와 커트라인 대비 부족분을 즉시 재계산해 보여주고, 부족 영역을 채우는 최단경로를 추천합니다.

• 기업별 가중치를 JSON 설정으로 관리하고 가중합 계산 함수를 순수 함수로 분리해 테스트 용이성 확보
• 4개 분야별 진단 결과를 탭 UI로 분리하고 Zustand로 선택 기업 상태를 전역 관리
• 부족 영역 탐색에 가중치 기반 최단경로 알고리즘을 적용해 우선순위 리스트 생성

기업 선택 시 클라이언트 재계산 없이 서버 API 응답만으로 커트라인·부족분·추천 경로를 동시에 갱신하는 구조를 구현합니다.

교사가 성적·출결 엑셀 파일을 업로드하면 형식을 자동 파싱해 인증 점수 테이블에 반영하고, 연 2회 갱신 주기에 맞춘 이력을 관리합니다.

• SheetJS 기반 xlsx 파서로 업로드 파일의 컬럼 구조를 검증하고 오류 행을 별도 리포트로 분리
• 업로드 이력을 버전 테이블로 관리해 연 2회 갱신 시점별 스냅샷 비교 기능 구현
• 파싱 실패 행에 대한 재업로드 워크플로우를 큐 기반으로 설계

엑셀 원자료 검증부터 점수 반영까지 검증·매핑·반영 3단계 파이프라인으로 분리해 부분 실패 시 되돌리기가 가능한 구조를 구현합니다.

학생이 가정통신문을 확인하고 교외 체험활동·상담을 신청하며, 참여 시 관련 인증 점수가 자동 반영되는 흐름을 제공합니다.

• 표준 알림 발송 API 연동 인터페이스를 추상화하여 채널별 발송 로직을 분리 설계
• 체험활동 신청 승인 시 인증 점수 테이블에 트랜잭션으로 반영하는 구조 구현
• 상담 신청 상태를 대기/진행/완료 단계로 관리하는 상태 머신 설계

체험활동 참여와 인증 점수 반영을 하나의 트랜잭션으로 묶어 부분 반영 오류를 방지하는 구조를 구현합니다.