HOJ

Tables (5)

assignments

  • id — BIGINT — Primary key — NOT NULL — PK
  • cohort_id — BIGINT — Foreign key → cohorts.id — NOT NULL — FK → cohorts.id — 과제는 분반에 속한다. 조회는 항상 (id, cohort_id) 스코프(다른 반 과제면 404)
  • title — VARCHAR(200) — NOT NULL — 과제 제목
  • description — TEXT — 과제 내용 — 문제 링크 포함 자유 텍스트
  • due_at — DATETIME(6) — NOT NULL — 마감 시각(UTC) — 운영진이 생성 시 설정. 마감 후 제출은 지각 표시(차단 아님). 마감을 수정하면 지각 판정도 새 마감 기준으로 다시 계산된다
  • created_at — DATETIME(6) — NOT NULL — 등록 시각(UTC)

cohorts

  • id — BIGINT — Primary key — NOT NULL — PK
  • name — VARCHAR(100) — NOT NULL — 분반 이름 (예: 2026-2 C언어)
  • description — TEXT — 설명 (선택)
  • status — VARCHAR(20) — NOT NULL — ACTIVE(진행 중) | ARCHIVED(보관 — 열람만 가능, 모든 변경은 409)
  • created_at — DATETIME(6) — NOT NULL — 생성 시각(UTC)

enrollments

  • id — BIGINT — Primary key — NOT NULL — PK
  • cohort_id — BIGINT — Foreign key → cohorts.id — NOT NULL — FK → cohorts.id
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — FK → users.id
  • role — VARCHAR(20) — NOT NULL — 분반 안 역할 OPERATOR(교육운영진) | STUDENT(수강생). STUDENT→OPERATOR 승격만 있고 강등 없음
  • created_at — DATETIME(6) — NOT NULL — 소속 등록 시각(UTC)

submissions

  • id — BIGINT — Primary key — NOT NULL — PK
  • assignment_id — BIGINT — Foreign key → assignments.id — NOT NULL — FK → assignments.id
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — FK → users.id — enrollment이 아니라 사용자 직접 참조. 소속이 해제돼도 제출물은 남는다 (design.md §1)
  • code_text — TEXT — 본문·코드 — 붙여넣은 코드 텍스트. 본문은 코드/파일 중 택1(서비스 강제)
  • file_name — VARCHAR(255) — 본문·파일 — 업로드한 zip의 원본 파일명
  • stored_path — VARCHAR(500) — 본문·파일 — 저장 위치 키. P1은 서버 로컬 디스크, S3 전환 시에도 이 열에 키만
  • file_size — BIGINT — 본문·파일 — 크기(byte). 용량 관리·삭제 경고 문구용
  • link_url — VARCHAR(2048) — 링크 — GitHub·배포 URL 등(선택). 본문 또는 링크 최소 1개 NOT NULL (서비스 + CHECK 강제)
  • submitted_at — DATETIME(6) — NOT NULL — 제출 시각(UTC). due_at과 비교해 지각을 계산한다 — 저장하는 지각 플래그 없음
  • score — INT — P2 준비 점수 — P1에서는 항상 NULL (mvp-scope §5)
  • mentor_comment — TEXT — P2 준비 멘토 코멘트 — P1에서는 항상 NULL

users

  • id — BIGINT — Primary key — NOT NULL — PK
  • login_id — VARCHAR(50) — NOT NULL — 로그인 ID — 홈페이지 계정과 매칭하는 키. 아직 로그인 안 한 부원도 이 값으로 선등록됨
  • name — VARCHAR(50) — NOT NULL — 표시 이름 — 스텁 로그인에서는 login_id와 동일, 홈페이지 연동 후 실제 이름으로 갱신
  • global_role — VARCHAR(20) — NOT NULL — 전역 역할 ADMIN(임원단=해구르르) | MEMBER(일반 부원) — enum은 STRING 저장
  • created_at — DATETIME(6) — NOT NULL — 생성 시각(UTC) — KST 변환은 프론트 몫