ERD

ERD Cloud 링크

테이블 정의 공통 설명

• BIGINT는 8바이트 INT는 4바이트로 정확히 두 배 차이나는걸로 알고있습니다. BIGINT를 사용하면 테이블이 많아지고, 서비스 이용자가 늘어날수록 INT에 비해 디스크와 RAM에 차지하는 비중이 커집니다. 그래서 서비스의 규모가 커진다면 그 때 BIGINT로 마이그레이션 하는 방법이 현재로서는 더 좋은 방법이라 생각합니다.
• 카테부 내부 서비스다보니 UTC를 자동변환해주는 TIMESTAMP보다 DATETIME을 선택했습니다. 또한 2038년 문제가 있는 TIMESTAMP보다는 안정성 있게 DATETIME을 사용했습니다.
• soft delete를 위해 deleted_at이 필요한 대부분의 테이블에서 "삭제되지 않은 테이블 중 최신순"으로 보여줍니다. INDEX(deleted_at, created_at DESC)를 사용하여 인덱싱을 합니다. 대부분의 테이블에서 deleted_at이 null이기 때문에 단독으로 인덱싱 하는 것은 유의미한 성능 개선이 없기 때문에 created_at과 함께 사용합니다.

테이블 정의서

테이블명	컬럼 목록(PK/FK, 데이터 타입, 제약조건)	기능적 역할 및 인덱스	설명
사용자	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)email (VARCHAR 255, UNIQUE, NOT NULL)password (VARCHAR 100, NULL)login_type (VARCHAR(10), NOT NULL)role (VARCHAR 10, NOT NULL)nickname (VARCHAR 50, NOT NULL)profile_url (VARCHAR 512, NOT NULL) state(VARCHAR(10), NOTNULL) last_login_at(DATETIME, NOTNULL)signup_at (DATETIME, NOT NULL)withdraw_at (DATETIME, NULL)	사용자 정보 관리 Indexes- INDEX (state, role, nickname)  : 휴면/정지/정상 필터링 중 닉네임 정렬	- 사용자의 정보를 저장하는 테이블입니다.- 카테부 관련자를 식별하기 위한 용도로 이메일을 저장합니다. 그렇기 때문에 이메일이 중복되어서는 안 됩니다.- RFC 표준상 이메일 전체 길이는 최대 320자까지 가능하지만 일반적으론 255자를 넘기지 않기 때문에 길이 제한을 255로 설정하였습니다.- 현재 기능정의상에는 자체 로그인이 없지만 추후 확장 가능성을 고려하여 자체 로그인을 위해 비밀번호를 저장합니다.- 비밀번호는 구글에선 최대 100자, 윈도우에서는 최대 127자, 그 외는 일반적으로 64자를 제한하는 것을 고려하여 100자로 설정하였습니다.- 역할은 사용자가 카테부 운영진인지, 교육생인지, 외부인인지를 나타냅니다.- 닉네임은 ‘영문이름(한글이름)/과정’의 포맷으로 저장되어야 하기 때문에 길이 제한을 50으로 설정하였습니다. - 사용자의 상태를 나타내기 위해 state 필드를 사용합니다. 평소에는 정상이고, 탈퇴를 했다면 탈퇴 상태가 됩니다. 그 외에도 휴면상태가 있습니다. - 한 사용자는 뉴스·공지에 여러 댓글을 가질 수 있어서 news_comment, notice_comment 테이블과 연결됩니다.- 한 사용자는 여러 뉴스·공지에 대한 좋아요를 가질 수 있어서 news_like, notice_like와 연결됩니다.- 사용자가 읽지 않은 공지를 알려주기 위해 글을 읽었는지에 대한 테이블인 user_notice_read와 연결됩니다.- 삭제된 날짜를 기준으로 30일 뒤에 완전 삭제를 하기 위해 deleted_at 필드를 추가했습니다.- refresh token은 Redis를 사용하여 관리할 예정입니다.- Redis에서는 TTL을 설정하여 데이터의 만료일을 관리하고, 자주 갱신되는 access token을 메모리로 관리하여 효율성을 높일 계획입니다.- 토큰 블랙리스트 관리 측면에서도 Redis의 이점을 기대해 볼 수 있습니다.
OAuth	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL)provider_id (VARCHAR (255), NOT NULL)provider (VARCHAR (20), NOT NULL)	OAuth 정보 관리	- OAuth로 로그인한 사용자들의 OAuth 정보를 저장하는 테이블입니다.- 현재는 카카오 하나만 사용할 예정이지만 추후 확장성을 고려하여 user_id를 FK로 참조하는 형식으로 설계하였습니다.- 자체 회원가입 기능까지 고려하여 사용자 테이블과 분리하였습니다. - 하나의 OAuth가 있는데 다른 OAuth를 추가하고 싶다면 따로 사용자 설정탭에서 OAuth를 추가하도록 합니다. 만약 이미 가입이 되어 있는 이메일로 새 OAuth 회원가입을 하려고 한다면 이미 존재하는 이메일이니 로그인해서 추가해달라는 안내를 하는 방법으로 merge collision을 방지하고자 합니다. - 로그인 이후 카카오 관련 정보를 별도로 요청하지 않고, 회원가입 때 받은 정보를 서비스 DB에 저장하기 때문에 access_token을 저장하지 않습니다.
공지	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT) user_id(FK, INT UNSIGNED, NOTNULL, AUTO_INCREMENT)title (VARCHAR 26, NOT NULL)content (TEXT, NOT NULL) tag(VARCHAR(10), NOTNULL)total_view_count (INT UNSIGNED, NOT NULL)like_count (INT UNSIGNED, NOT NULL)comment_count(INT UNSIGNED, NOT NULL)original_url (VARCHAR 512, NOT NULL)summary (VARCHAR 255, NULL)created_at (DATETIME, NOT NULL)updated_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	공지 관리 Indexes- INDEX (deleted_at, created_at DESC)  : 삭제되지 않은 최신순 조회	- 카테부 운영진이 작성한 공지 정보를 저장합니다.- 제목은 최대 26자까지만 받습니다.- content의 경우는 노션공지, 디스코드 공지를 통합하여 보여주는데 노션 공지에서 긴 공지의 UTF-8 인코딩 기준 바이트수가 10.7KB 나왔습니다. 테이블의 다른 컬럼에서 VARCHAR를 사용하여 테이블의 최대공간을 넘게 되는 문제를 방지하기 위해 TEXT를 사용하는게 좋다고 판단하였습니다. - 삭제된 날짜를 기준으로 30일 뒤에 완전 삭제를 위해 deleted_at을 사용합니다.- 조회수·좋아요 수는 짧은 시간에 많은 SELECT가 예상되므로 Redis로 오프로드할 계획입니다.- 원본 URL 길이를 감안하여 512자로 설정했습니다.- 공지 요약은 MVP 단계에서는 없으므로 NULL 허용으로 두었습니다.
공지 댓글	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL)notice_id (FK, INT UNSIGNED, NOT NULL)content (VARCHAR 500, NOT NULL)created_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	공지에 대한 댓글 관리 INDEXES - INDEX(deleted_at, created_at DESC) : 삭제되지 않은 최신순 조회	- 사용자가 공지에 남기는 댓글을 저장합니다.- 댓글 작성자는 반드시 존재해야 하므로 user_id FK를 가집니다.- 댓글이 달릴 공지가 반드시 존재해야 하므로 notice_id FK를 가집니다.- 댓글 내용은 최대 500자로 제한합니다.- 삭제 후 30일 뒤 완전 삭제를 위해 deleted_at을 사용합니다.
공지 읽음 여부	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, notice_id))notice_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, notice_id))	사용자 읽음 체크	- 사용자가 공지를 읽었는지 여부를 저장합니다.- 복합키 대신 개별 PK + UNIQUE(user_id, notice_id)로 유일성을 보장합니다.- 추후 성능 이슈 시 Redis 캐싱을 고려합니다.- 탈퇴 전에는 삭제되지 않으므로 soft delete를 사용하지 않습니다.
공지 좋아요	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, notice_id))notice_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, notice_id)) is_activated(BOOLEAN NOTNULL DEFAULT TRUE)	공지글 좋아요 처리	- 사용자와 공지의 좋아요 관계를 관리합니다.- UNIQUE(user_id, notice_id)로 한 번만 좋아요 가능하도록 제한합니다.- 좋아요/취소를 is_activated로 관리합니다. true라면 좋아요를 누른 상태이고, false라면 좋아요를 하지 않은 상태입니다.
공지 파일	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)notice_id (FK, INT UNSIGNED, NOT NULL)file_url (VARCHAR 512, NOT NULL)type (VARCHAR 10, NOT NULL)name (VARCHAR 255, NOT NULL)file_seq_no (TINYINT UNSIGNED, NOT NULL)	공지 관련 파일 정보	- 공지에 첨부된 이미지·파일 정보를 저장합니다.- 실제 파일은 S3에 저장하고 URL만 보관합니다.- 확장자 길이를 고려해 type은 10자로 제한했습니다.- 파일 이름은 OS 한계(255자)에 맞춰 설정했습니다.- 파일 순서를 file_seq_no로 관리합니다(최대 20).
뉴스	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)title (VARCHAR 26, NOT NULL)content (VARCHAR(1024), NOT NULL)total_view_count (INT UNSIGNED, NOT NULL)today_view_count (INT UNSIGNED, NOT NULL)like_count (INT UNSIGNED, NOT NULL)comment_count(INT UNSIGNED, NOT NULL)image_url (VARCHAR 512, NULL)created_at (DATETIME, NOT NULL)updated_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	뉴스 관리 INDEXES - INDEX(deleted_at, created_at DESC) : 삭제되지 않은 최신순 조회	- 카테부 소식을 전달하는 글을 저장합니다.- 제목 길이는 최대 26자입니다.- 내용은 최대 1024자(VARCHAR)입니다. AI 개발자분들과 상의한 결과 가장 최적의 응답 토큰 수가 1024였습니다. - 오늘 조회수(today_view_count)는 00:00–23:59 기준 상단 노출에 사용합니다.- 조회수·좋아요 수는 Redis 캐싱 예정입니다.- 이미지가 1장만 필요하므로 image_url로 관리합니다.- 삭제 후 30일 뒤 완전 삭제를 위해 deleted_at을 사용합니다.
뉴스 댓글	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL)news_id (FK, INT UNSIGNED, NOT NULL)content (VARCHAR 500, NOT NULL)created_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	뉴스에 대한 댓글 관리 INDEXES - INDEX(deleted_at, created_at DESC) : 삭제되지 않은 최신순 조회	- 사용자가 뉴스에 남기는 댓글을 저장합니다.- 작성자는 user_id, 대상 뉴스는 news_id를 FK로 참조합니다.- 댓글 내용은 최대 500자로 제한합니다.- 삭제 후 30일 뒤 완전 삭제를 위해 deleted_at을 사용합니다.
뉴스 좋아요	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, news_id))news_id (FK, INT UNSIGNED, NOT NULL,  UNIQUE (user_id, news_id)) is_activated(BOOLEAN NOTNULL DEFAULT TRUE)	뉴스 좋아요 처리	- 사용자와 뉴스의 좋아요 관계를 관리합니다.- UNIQUE(user_id, news_id)로 유일성을 보장합니다.- 좋아요/취소를 is_activated로 관리합니다. true라면 좋아요를 누른 상태이고, false라면 좋아요를 하지 않은 상태입니다.
위키	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)title (VARCHAR 26, NOT NULL, UNIQUE)content (MEDIUMTEXT, NOT NULL)editor_name (VARCHAR 50, NOT NULL)created_at (DATETIME, NOT NULL)updated_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	위키 문서 관리 INDEXES -INDEX(title)	- 카테부 이용자가 편집·관리하는 문서를 저장합니다.- 제목은 최대 26자이며 중복 생성 방지를 위해 UNIQUE를 설정했습니다.- content의 경우에는 마크다운 형식을 지원하기 때문에 특수문자도 들어가고, 이미지도 이미지 태그를 지원하기 때문에 많은 데이터가 들어갈 것으로 예상하고 있습니다. 또한 위키는 모든 교육생이 수정, 내용추가, 편집 등을 할 수 있어서 하나의 위키 문서 내용이 길어질 것이라고 생각합니다. 그래서 의도적으로 TEXT보다 큰 MEDIUMTEXT를 사용하였습니다.- 최근 편집자의 이름을 editor_name에 저장합니다.- 삭제 후 30일 뒤 완전 삭제를 위해 deleted_at을 사용합니다. - 위키 문서의 제목은 중복될 수 없기 때문에 인덱싱을 사용합니다.
퀴즈	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)wiki_id (FK, INT UNSIGNED, NOT NULL)content (VARCHAR 255, NOT NULL)answer (VARCHAR(50), NOT NULL)created_at (DATETIME, NOT NULL)	퀴즈 정보 관리 INDEXES - INDEX(created_at) LIMIT 1	- AI가 생성한 퀴즈 문제·정답 정보를 저장합니다.- 퀴즈 내용은 255자 이하로 제한합니다.- 생성 시각을 저장하여 ‘오늘의 퀴즈’를 선택합니다. - 퀴즈는 항상 새로운 퀴즈, 가장 최근에 생성된 퀴즈만 보여줍니다.
정답	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)quiz_id (FK, INT UNSIGNED, NOT NULL)content (VARCHAR 50, NOT NULL)	퀴즈 정답 정보 관리	- 유사한 답변도 정답 처리를 위해 여러 개의 정답을 저장합니다.- 가장 긴 단어 길이를 고려하여 50자로 설정했습니다.
제출	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)user_id (FK, INT UNSIGNED, NOT NULL, UNIQUE(user_id, quiz_id))quiz_id (FK, INT UNSIGNED, NOT NULL, UNIQUE(user_id, quiz_id))is_correct (BOOLEAN, NOT NULL)is_first_winner (BOOLEAN, NOT NULL)	사용자 퀴즈 제출 관리	- 사용자와 퀴즈의 제출 정보를 담습니다.- 한 사용자는 퀴즈당 한 번만 제출할 수 있으므로 UNIQUE(user_id, quiz_id)를 추가로 걸어야 합니다.- 사용자가 제출한 답이 오답이면 is_correct에 FALSE를, 정답이면 TRUE를 저장한다.- 사용자가 오늘의 퀴즈 최초 정답자라면 is_first_winner에 TRUE를 저장하고, 아니라면 FALSE를 저장합니다.
운영진 알림	id (PK, INT UNSIGNED, NOT NULL, AUTO_INCREMENT)receiver_id (FK, INT UNSIGNED, NOT NULL)sender_id (FK, INT UNSIGNED, NOT NULL)content (VARCHAR 500, NOT NULL)is_read(BOOLEAN, NOTNULL)created_at (DATETIME, NOT NULL)deleted_at (DATETIME, NULL)	알림 정보 관리	- 운영진이 교육생에게 보내는 알림를 저장합니다.- 알림 내용은 최대 500자로 제한합니다.- 삭제 후 30일 뒤 완전 삭제를 위해 deleted_at을 사용합니다.