팝업 / 공지¶

앱 내 공지·점검 알림·이벤트 팝업 같은 사용자 대상 인포메이션 채널. 현재 SeMu-GPT 2026에는 이 기능이 구현되어 있지 않다. 백엔드/프론트엔드 어느 레이어에도 popup·notice·announcement·공지·점검 관련 코드가 존재하지 않는다 (2026-05-11 기준 grep 검증). 이 페이지는 인수인계 위키의 IA 일관성을 위해 placeholder로 유지하며, 추후 기능이 도입되면 8섹션을 채워 정식 카탈로그 페이지로 전환한다.

사용자 여정¶

해당 없음 — 기능 미구현. 사용자 진입점·트리거 모두 존재하지 않음.

운영 측면에서 사용자에게 점검·공지를 전달해야 할 경우, 현재는 다음 우회로를 사용한다:

외부 채널: 카카오톡 채널, 이메일, 세림세무법인 자체 공지 페이지
임시 배너: frontend 코드에 하드코딩된 공지 텍스트를 deploy로 노출 (개별 케이스, 패턴화되어 있지 않음)

백엔드 구현¶

계층	클래스 / 파일	역할
Controller	(해당 없음)	미구현 — `PopupController`, `NoticeController`, `AnnouncementController` 모두 존재하지 않음
Service	(해당 없음)	미구현
Domain (Entity)	(해당 없음)	`Popup`, `Notice`, `Announcement` 엔티티 없음. MySQL 스키마에도 관련 테이블 없음
Outbound	(해당 없음)	푸시 알림(FCM/APNs) 통합 코드 없음

검증 명령:

grep -ril "popup\|notice\|announcement\|공지\|점검\|maintenance" \
  apps/backend/src/main/kotlin/me/uiti/taxgpt/
# → 결과 없음 (생성된 OpenAPI 정적 docs HTML 외)

도메인 규칙¶

규칙	위치	값 / 설명
해당 없음	—	도메인 자체 부재

API 엔드포인트¶

Method	Path	설명
해당 없음	—	공지/팝업 관련 endpoint 미존재

스펙 상세(request/response schema)는 API 레퍼런스 / OpenAPI 페이지 참조 — 현재 OpenAPI 스펙에도 popup/notice tag가 등록되어 있지 않음.

데이터 모델¶

erDiagram
    PLACEHOLDER {
        string note "기능 미구현 — 데이터 모델 없음"
    }

(추후 도입 시 예상 스키마: notice (id, title, body, target_role, start_at, end_at, priority, dismissible) 형태가 일반적이나, 본 프로젝트에는 아직 정해진 설계가 없음.)

설정¶

항목	위치	비고
해당 없음	—	환경변수·시크릿·feature flag 모두 없음

알려진 이슈 / 개선 예정¶

기능 자체가 미구현: 사용자 공지 채널을 백엔드에서 관리할 수 없음. 점검 안내·약관 변경 알림 등을 코드 deploy 없이 전달할 수단이 부재.
점검 모드(maintenance mode) 부재: API 일괄 차단 + 안내 페이지를 띄우는 글로벌 toggle이 없음. 현재 점검은 전체 시스템 다운으로 처리.
팝업/공지 IA만 잡혀 있음: mkdocs.yml의 03-features nav에 페이지가 등록되어 있어 클라이언트가 기능 존재를 기대할 수 있으니, 도입 시점 전까지 페이지 상단의 "미구현" 문구가 명확히 보이도록 유지.
추후 도입 시 검토 항목:
- DB 테이블 vs ES 인덱스 vs 정적 JSON 중 저장 매체 선택
- 어드민 콘솔에 신규 탭 추가 (apps/frontend/src/app/admin/page.tsx의 TAB_LIST)
- 타깃팅 (전체 / 멤버십 등급별 / 특정 계정)
- 게재 기간·우선순위·dismiss 기억 정책