아주대 심리학과 학생회 · 과방 대여 장부
과방 물품의 남은 수량 확인, 대여·반납 기록(사진 포함), 연체 알림 메일을 제공하는 웹앱입니다.
- 스택: Next.js 16 (App Router) · React 19 · Tailwind 4 · Firebase (Auth / Firestore / Storage) · Nodemailer(Gmail) · Vercel(Cron)
- 학생: Google 로그인 → 대여(사진 + 개인정보 동의) → 반납(사진)
- 관리자: PIN 로그인 → 물품·공지·파비콘 관리, 현황, 창고, 전체 기록(사진)
로컬 실행
npm install
cp .env.example .env.local # 값 채우기
npm run dev # http://localhost:3000
| 명령 | 설명 |
|---|
npm run build | 프로덕션 빌드 |
npm run lint | ESLint |
npm run typecheck | 라우트 타입 생성 + TypeScript 검사 |
npm test | 시간/기한 계산 단위 테스트 (Node 22.6+) |
node scripts/test-late-return-email.mjs | 지각 반납 메일 테스트 발송 |
환경변수
전체 목록과 설명은 .env.example에 있습니다. 배포 시 반드시 설정할 것:
| 변수 | 없으면 |
|---|
ADMIN_PIN | 관리자 로그인 불가 (기본값 없음) |
CRON_SECRET | 연체 알림 크론이 실행되지 않음 |
FIREBASE_* | 앱 전체 동작 안 함 |
GMAIL_USER, GMAIL_APP_PASSWORD, ADMIN_EMAIL | 메일 발송 안 함 |
ADMIN_EMAIL은 최초 기본값입니다. 관리 탭 → "알림 받을 메일"에서 한 번 저장하면 그 뒤로는 Firestore(settings/adminEmails)의 목록이 쓰이며, 재배포 없이 바로 반영됩니다.
권장: ADMIN_SESSION_SECRET, RETENTION_DAYS=180, NEXT_PUBLIC_CONTACT_*, (학교 계정 전용으로 전환 시) ALLOWED_EMAIL_DOMAIN + NEXT_PUBLIC_ALLOWED_EMAIL_DOMAIN
Firebase 보안 규칙
모든 데이터 접근은 서버 API(Admin SDK)를 거치므로 브라우저 직접 접근은 막아 둡니다.
구조
app/
page.tsx 재고 (홈)
rent/ return/ 대여 · 반납
admin/ status/ storage/ records/ 관리자 화면
api/
rentals/ POST 대여(로그인) · GET 전체(관리자)
rentals/[id]/return 반납 (본인 또는 관리자)
me/ 내 대여 목록 + 지난 입력값
items/ storage/ notice/ favicon/ 관리자 CRUD
admin-emails/ 알림 받을 관리자 메일 목록 (관리자)
storage/[id]/move 창고 → 재고 이동 (트랜잭션)
photos/[filename] 사진 프록시 (관리자)
admin/login PIN 로그인 (서명 쿠키, 15분 5회 제한)
cron/overdue 매일 09:00 KST 연체 알림 + 보관기간 지난 기록 삭제
lib/
store.ts Firestore 접근 (대여·반납·창고 이동은 트랜잭션)
time.ts KST 기준 기한 계산·표시 (서버/브라우저 동일 결과)
admin.ts 관리자 세션 서명·검증, 로그인 시도 제한
email.ts 메일 템플릿 (사용자 입력은 모두 이스케이프)
photos.ts 업로드 검증(파일 헤더) · 비공개 저장 · 프록시 읽기
image-compress.ts 업로드 전 브라우저에서 1600px JPEG로 축소
validate.ts 서버 입력 검증
규칙 메모
- 반납 기한: 대여일(KST) + N일의 23:59:59까지. 그 다음날 0시부터 "기한 초과".
- 연체 메일: 기한 초과 1일차, 3일차, 이후 7일마다 (하루 한 번만).
- 소모품: 반납 대상이 아니며 대여 수량만큼 재고에서 빠집니다. 채워 넣을 때는 보유 수량을 늘리세요.
