maint-board
Tables (8)
tb_accounts
- id — BIGINT — Primary key — NOT NULL — PK
- company_id — BIGINT — 소속 고객사. 운영팀(MANAGER·ADMIN)만 NULL. 격리 판정 기준
- email — VARCHAR(255) — NOT NULL — 로그인 ID. 전역 유니크. 비활성 계정 이메일도 재사용 불가
- password_hash — VARCHAR(255) — NOT NULL — bcrypt 해시 (cost 10~12)
- name — VARCHAR(50) — NOT NULL — 담당자명. 발급 시 입력. 요청 폼 스냅샷 소스
- phone — VARCHAR(30) — NOT NULL — 연락처. 발급 시 입력. contact_phone 스냅샷 소스 · 긴급 유선 대응용
- role — ENUM('CLIENT_USER', 'CLIENT_ADMIN', 'MANAGER', 'ADMIN') — NOT NULL — 역할 4종. 값 추가는 반드시 목록 맨 뒤에
- is_active — TINYINT(1) — NOT NULL — 활성/비활성 전환. 되돌릴 수 있으며 삭제 아님
- must_change_password — TINYINT(1) — NOT NULL — 최초 로그인 시 비밀번호 변경 유도
- password_changed_at — DATETIME(3) — NOT NULL — 세션 무효화 기준. 토큰 발급 시각이 이전이면 거부
- temp_password_expires_at — DATETIME(3) — 임시 비밀번호 만료 시각. 발급·초기화 시 NOW(3)+24시간, 변경 완료 시 NULL
- last_login_at — DATETIME(3) — 최근 로그인. 감사 컬럼 갱신 대상 아님
- created_by — BIGINT — 발급한 계정 id (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 수정자 계정 id (FK 없음)
- updated_ip — VARCHAR(45) — 수정 IP
- updated_at — DATETIME(3) — NOT NULL — 수정일
tb_attachments
- id — BIGINT — Primary key — NOT NULL — PK
- company_id — BIGINT — Foreign key → tb_companies.id — NOT NULL — 소속 고객사. 다운로드 권한 직접 대조
- message_id — BIGINT — Foreign key → tb_request_messages.id — NOT NULL — 소속 메시지. 최초 요청·추가 문의·처리 회신 첨부가 모두 같은 경로
- original_filename — VARCHAR(255) — NOT NULL — 원본 파일명. 화면 표시·다운로드용
- storage_key — VARCHAR(255) — NOT NULL — 저장 파일명. URL 아님. 임의 값 재생성. 정적 서빙 금지
- mime_type — VARCHAR(100) — NOT NULL — 이중 검증된 실제 파일 형식. 클라이언트 Content-Type 미신뢰
- file_size — INT — NOT NULL — bytes. 파일 10MB / 등록 글 5개·30MB / 요청 누적 20개·100MB
- uploader_id — BIGINT — Foreign key → tb_accounts.id — NOT NULL — 업로더 계정
- created_by — BIGINT — 생성자. uploader_id 와 동일 값 (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 영구 NULL
- updated_ip — VARCHAR(45) — 영구 NULL
- updated_at — DATETIME(3) — NOT NULL — 실질 불변
tb_audit_logs
- id — BIGINT — Primary key — NOT NULL — PK
- actor_id — BIGINT — 실행자 계정. 로그인 실패·시드는 NULL. FK 없음
- actor_role — VARCHAR(20) — 실행 시점 역할 스냅샷
- action — VARCHAR(40) — NOT NULL — ACCOUNT_ISSUE / ACCOUNT_ACTIVATE / ACCOUNT_DEACTIVATE / PASSWORD_RESET / LOGIN_FAIL / ACCESS_DENIED / ATTACHMENT_DOWNLO…
- target_type — VARCHAR(20) — ACCOUNT / REQUEST / ATTACHMENT / COMPANY
- target_id — BIGINT — 대상 id. 다형 참조이므로 FK 없음
- company_id — BIGINT — 격리 조회용
- detail — JSON — 변경 전후·실패 사유 등. 조회 조건으로 쓰지 않음
- ip — VARCHAR(45) — 클라이언트 IP. 개인정보. MVP 무기한 보존·마스킹 없음(3.8). 오픈 후 재검토
- created_at — DATETIME(3) — NOT NULL — 발생 시각
tb_companies
- id — BIGINT — Primary key — NOT NULL — PK
- name — VARCHAR(100) — NOT NULL — 고객사명. 가변 — 수정 허용(v2.3). 과거 요청 표시명에 소급됨
- code — VARCHAR(20) — NOT NULL — 고객사 코드. 티켓번호 접두. 운영팀 입력, 부여 후 변경 불가. 형식 ^A-Z{2,10}$ (v2.3)
- email — VARCHAR(255) — 고객사 대표 이메일
- phone — VARCHAR(30) — 고객사 대표 전화번호
- is_active — TINYINT(1) — NOT NULL — 활성/비활성 전환. 삭제 아님. 비활성 시 하위 프로젝트·계정 함께 비활성
- created_by — BIGINT — 생성자 계정 id (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP (IPv6 대응)
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 수정자 계정 id (FK 없음)
- updated_ip — VARCHAR(45) — 수정 IP
- updated_at — DATETIME(3) — NOT NULL — 수정일
tb_company_seq
- company_id — BIGINT — Foreign key — NOT NULL — PK. 고객사당 1행. PK 행 하나만 잠그기 위한 구조
- last_seq — INT — NOT NULL — 마지막으로 발급한 연번
tb_projects
- id — BIGINT — Primary key — NOT NULL — PK
- company_id — BIGINT — Foreign key → tb_companies.id — NOT NULL — 소속 고객사
- name — VARCHAR(100) — NOT NULL — 프로젝트명. 고객사 내 유니크
- is_active — TINYINT(1) — NOT NULL — 비활성 시 신규 요청 선택지 제외, 기존 조회는 허용
- created_by — BIGINT — 생성자 계정 id (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 수정자 계정 id (FK 없음)
- updated_ip — VARCHAR(45) — 수정 IP
- updated_at — DATETIME(3) — NOT NULL — 수정일
tb_request_messages
- id — BIGINT — Primary key — NOT NULL — PK
- request_id — BIGINT — Foreign key → tb_requests.id — NOT NULL — 대상 요청
- company_id — BIGINT — Foreign key → tb_companies.id — NOT NULL — 소속 고객사. 격리 조건 자동 주입용
- author_id — BIGINT — Foreign key → tb_accounts.id — 작성자. 시스템 레코드 4종은 NULL (화면 표시용)
- message_type — ENUM('CLIENT_INITIAL', 'CLIENT_ADDITION', 'OPS_REPLY', 'STATUS_CHANGE', 'ASSIGNEE_CHANGE', 'TYPE_CHANGE', 'PROJECT_CHANGE') — NOT NULL — 메시지 유형 7종. 앞 3종만 사용자 메시지
- writer_role — ENUM('CLIENT', 'OPS', 'SYSTEM') — NOT NULL — 작성 주체 구분. 진영이며 계정 역할 아님
- content — TEXT — CLIENT_INITIAL 은 요청 본문(최소 10자). 시스템 레코드는 서버 생성 문구
- prev_status — ENUM('RECEIVED', 'ACCEPTED', 'REVIEWING', 'IN_PROGRESS', 'ON_HOLD', 'DONE') — 변경 전 상태. STATUS_CHANGE 만 값 존재 (CHECK 강제)
- status_snapshot — ENUM('RECEIVED', 'ACCEPTED', 'REVIEWING', 'IN_PROGRESS', 'ON_HOLD', 'DONE') — NOT NULL — 등록 시점 요청 상태. CLIENT_INITIAL 에서는 항상 RECEIVED
- created_by — BIGINT — 시스템 레코드의 실제 실행자. 반드시 채울 것 (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 영구 NULL — 수정 불가 테이블
- updated_ip — VARCHAR(45) — 영구 NULL
- updated_at — DATETIME(3) — NOT NULL — 실질 불변
tb_requests
- id — BIGINT — Primary key — NOT NULL — PK. 내부 조인 전용, 외부 미노출
- uuid — CHAR(36) — NOT NULL — URL 식별자. 외부에는 이 값만 노출
- company_id — BIGINT — Foreign key → tb_companies.id — NOT NULL — 소속 고객사. 격리 기준. 서버가 토큰에서 주입
- company_seq_no — INT — NOT NULL — 고객사별 연번. 티켓번호 = code + 연번. 리셋 없이 누적
- project_id — BIGINT — Foreign key → tb_projects.id — 분류값. 미지정 허용. 운영팀 보정 가능
- author_id — BIGINT — Foreign key → tb_accounts.id — NOT NULL — 작성자 계정
- contact_name — VARCHAR(50) — NOT NULL — 작성자명. 접수 시점 스냅샷. 계정에서 복사, 클라이언트 값 무시
- contact_phone — VARCHAR(30) — NOT NULL — 작성자 연락처. 접수 시점 스냅샷. 소급 갱신하지 않음
- assignee_id — BIGINT — Foreign key → tb_accounts.id — 담당 개발자. 운영팀 계정만 지정 가능(앱 검증)
- request_type — ENUM('BUG', 'FEATURE', 'INQUIRY') — 요청 유형. 운영팀 지정. NULL 은 미분류. DONE 전이 시 NULL 이면 거부
- title — VARCHAR(100) — NOT NULL — 제목. 목록 주 컬럼·검색 대상. 본문은 CLIENT_INITIAL 메시지에 있음
- urgency — ENUM('HIGH', 'NORMAL', 'LOW') — NOT NULL — 긴급도
- status — ENUM('RECEIVED', 'ACCEPTED', 'REVIEWING', 'IN_PROGRESS', 'ON_HOLD', 'DONE') — NOT NULL — 처리 상태 6단계: 요청/접수/확인중/진행중/보류/완료. DONE 은 종단 — 나가는 전이 없고 이후 쓰기 차단
- due_date — DATE — 완료예정일. 운영팀 입력. RECEIVED·DONE 에서는 입력 불가
- completed_date — DATE — 실제완료일. DONE 전이 시 필수 입력. KST 오늘 이하만 허용(v2.3). 전이 후 수정 불가
- last_writer_role — ENUM('CLIENT', 'OPS') — NOT NULL — 마지막 등록 주체. 진영이며 계정 역할 아님
- last_message_at — DATETIME(3) — NOT NULL — 마지막 등록 일시. 목록 정렬 기준
- is_pending_response — TINYINT(1) — NOT NULL — 운영팀 미확인. 처리 회신·상태 변경·DONE 전이로 해제
- is_pending_client_reply — TINYINT(1) — NOT NULL — 고객사 답변 대기. 고객사 추가 문의 등록 또는 DONE 전이로 해제. 열람으로는 해제되지 않음
- created_by — BIGINT — 생성자. author_id 와 동일 값 (FK 없음)
- created_ip — VARCHAR(45) — 생성 IP
- created_at — DATETIME(3) — NOT NULL — 등록일
- updated_by — BIGINT — 운영팀 처리 및 고객사 추가 문의 등록 경로에서 갱신 (FK 없음)
- updated_ip — VARCHAR(45) — 수정 IP
- updated_at — DATETIME(3) — NOT NULL — 수정일