화면 피드백 메시지 — BE 참고

범위

이 문서는 Toast, Alert, Alert Dialog, 필드 오류의 서버 계약 경계를 정의한다. 2026-07-23 Toast 정렬 변경은 EDS 표현 계층 변경이며 API payload·상태머신·권한 계약은 변경하지 않는다.

메시지 유형 계약

유형	서버 의미	FE 표현
일시적 작업 결과	요청 성공·실패, 실행 취소 가능한 결과	Toast
비차단 선행조건	현재 화면은 볼 수 있으나 설정·권한·데이터 보완 필요	closable Alert
차단 또는 고위험 확인	현재 동작을 계속할 수 없거나 명시 확인 필요	Alert Dialog
필드 오류	특정 필드의 형식·범위·중복 문제	해당 필드 인라인 오류

응답 설계

• HTTP 상태와 안정적인 오류 코드를 사실의 기준으로 사용한다.
• 사용자 문구는 FE가 도메인 맥락에 맞게 구성할 수 있도록 code, 대상 식별자, 재시도 가능 여부, 필요한 권한·설정 정보를 제공한다.
• 일시적 성공 결과를 영구 Alert로 만들기 위한 별도 서버 플래그를 추가하지 않는다.
• 비차단 선행조건과 차단 조건을 같은 오류 코드로 뭉치지 않는다.
• 민감정보·내부 예외 메시지를 Toast 본문에 직접 전달하지 않는다.

관리비 선행 설정

청구 대상·부과 기준 같은 선행 설정이 없더라도 목록 조회가 가능한 경우에는 정상 응답과 설정 상태를 함께 제공한다. 해당 작업 자체가 불가능한 시점에만 차단 오류를 반환한다. 메뉴 권한 부족과 데이터 미설정은 서로 다른 코드로 구분한다.

변경 없음

• API endpoint
• 요청·응답 schema
• 감사 actor
• 권한 판정
• 관리비 정산 상태머신

Toast의 24px 첫 행 슬롯과 72px 2행 높이는 프론트엔드 디자인 계약이며 서버가 수치나 variant를 전달하지 않는다.