플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 다양한 제조사의 NFC 리더기 USB HID 입력을 서버에서 일관되게 파싱하여 학생 카드 ID를 정확히 추출하는 드라이버 레이어 구현 필요 - 같은 학생이 단시간 내 반복 태그할 때 중복 기록을 방지하는 디바운스 로직과 동시 요청 시 트랜잭션 격리 수준 설계 필요 - 다수 관리자 동시 접속 상황에서 NFC 이벤트를 안정적으로 브로드캐스트하고 연결 끊김 시 재연결 처리
프로젝트 성과
NFC 리더기 서버 연동 실시간 참여 기록 구조 설계
NFC 리더기 → REST API → PostgreSQL 흐름으로 태그 인식 즉시 참여 데이터를 저장하고 WebSocket으로 대시보드에 실시간 반영하는 구조를 설계합니다.
학년·반·날짜 복합 필터 이력 조회 시스템 구현
PostgreSQL 복합 인덱스를 활용하여 다중 필터 조건의 참여 이력을 빠르게 조회하는 API와 페이지네이션 UI를 구현합니다.
ExcelJS 서버 사이드 엑셀 스트리밍 다운로드 구현
서버에서 .xlsx 파일을 동적 생성하여 스트리밍 방식으로 전달하고 교육청 공문 제출에 바로 활용할 수 있는 컬럼 형식으로 출력합니다.
학생-NFC 카드 매핑 및 관리자 권한 체계 설계
Prisma ORM으로 학생-카드 매핑 구조를 설계하고 JWT 기반 관리자 인증으로 데이터 접근 권한을 세분화하는 보안 구조를 구현합니다.
핵심 기능
NFC 태그 인증 및 실시간 기록
NFC 리더기가 태그를 인식하면 서버 API를 호출하여 학생 참여 데이터를 즉시 DB에 저장하고, 대시보드에 실시간 반영합니다
진행 단계
DB 스키마 설계 및 NFC 연동 API 구현
2026.04
학생·NFC카드·참여이력 테이블 ERD 설계, NFC 리더기 수신 REST API 및 중복 방지 로직 구현
프로젝트 상세
1) 포트폴리오 소개 NFC 리더기 연동을 통한 학생 참여 자동 기록 및 관리자 대시보드를 구현하는 MVP 데모입니다. NFC 리더기 → 서버 API 호출 → DB 저장 흐름으로 실시간 참여 데이터를 수집하고, 담당 교사가 학생 정보·참여 이력·엑셀 내보내기를 원스톱으로 관리할 수 있는 관리자 시스템을 설계합니다. 2) 작업 범위 - NFC 태그 인증 및 실시간 기록: NFC 리더기가 태그를 인식하면
