의견 받는 공식 채널 만들기 — Footer + MY 탭 + 어드민 3 레이어 통합 — POP-SPOT v2.11

// v2.11 — FeedbackService. 의견 종류 화이트리스트를 이 클래스 하나만 소유
private static final Set<String> ALLOWED_KINDS = Set.of(
//      ^^^^^^^^^^^^                              ^^^^^^   Java 9+ 불변 Set 팩토리
//      상수 — static final — 클래스 로딩 한 번만 초기화 · JVM 내 불변
    "bug", "improvement", "suggestion", "other"
//  이 네 개만 허용됨. 종류 추가 시 여기만 고치면 프론트·컨트롤러 모두 반영
);

public Feedback create(Long userId, String guestEmail,
//                     ^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^
//                     null 가능    게스트용 이메일 (이 둘 중 하나는 필수 - DB CHECK 제약)
                       String kind, String body) {
    if (!ALLOWED_KINDS.contains(kind))
//                     ^^^^^^^^       포함 안 되면 거부. 클라이언트가 임의 종류 보내도 메타 의미 없음
        throw new BadRequestException("알 수 없는 의견 종류");
    return repository.save(
        Feedback.of(userId, guestEmail, kind, body));
//      ^^^^^^^^^^^                                   정적 팩토리 메서드. status='received' 자동 할당
}

// v2.11 — SecurityConfig. 스프링 시큐리티 보안 규칙 설정
http.authorizeHttpRequests(a -> a
//                         ^^^^^   람다 구성자 패턴
    .requestMatchers("/api/feedback/me").authenticated()
//   ^^^^^^^^^^^^^^^                     ^^^^^^^^^^^^^^^
//   |                                   "이 경로는 JWT 토큰 검증 통과 필요"
//   +-- 주의: 가장 구체적인 규칙을 먼저 놓는다. 아래의 /** 보다 우선 적용
    .requestMatchers("/api/feedback/**").permitAll()
//                                       ^^^^^^^^^^^   "로그인 안 해도 접근 OK" — 게스트 의견 제출 수용
//   /api/feedback/me 는 위에서 먼저 잡혀 — permitAll 로 떨어지지 않음
    ...
);

-- v2.11 — Flyway 마이그레이션 V7__feedback.sql. feedback 테이블 신규 생성
CREATE TABLE feedback (
  id            BIGSERIAL PRIMARY KEY,
  --            ^^^^^^^^^^^^^^^^^^^^^   PostgreSQL: BIGSERIAL = bigint + 자동증가 시퀀스 (PK)
  user_id       BIGINT NULL,           -- v2.0 의 게스트 흐름 수용 되도록 NULL 허용
  guest_email   VARCHAR(255) NULL,     -- 게스트가 선택적으로 입력 (답변 받아볼 수신 수단)
  kind          VARCHAR(32) NOT NULL,  -- ALLOWED_KINDS 의 문자열 (bug/improvement/...)
  body          TEXT NOT NULL,         -- 의견 본문. 길이 제한 없음 (TEXT)
  status        VARCHAR(32) NOT NULL,  -- 상태 머신: received → reviewing → answered → closed
  answer        TEXT NULL,             -- 관리자 답변. 아직 답하기 전은 NULL
  created_at    TIMESTAMP NOT NULL DEFAULT NOW(),
  --                                   ^^^^^^^^^   PostgreSQL 함수: 현재 서버 시각. UTC 기준 저장
  CONSTRAINT chk_user_or_email
  --         ^^^^^^^^^^^^^^^^^^^^   제약 조건 이름. ALTER TABLE 으로 제거·추가 용이하도록 명명
    CHECK (user_id IS NOT NULL OR guest_email IS NOT NULL)
  --       ^^^^^^^^^^^^^^^^^^^   ^^^^^^^^^^^^^^^^^^^^^^^^^^^   둘 중 하나는 있어야 함
  --                                                            INSERT 시 둘 다 NULL 이면 PostgreSQL 이 거절
);