프로필 관리 — 백엔드 참고

적용 범위

조직·사용자·빌링 프로필의 일반/사업자 화면에 적용되는 프론트엔드 표시·편집 패턴을 설명한다. 이번 변경은 EDS v1 모바일 레이아웃 정합 작업이며 데이터베이스, API, 인증·인가 계약 변경은 없다.

현재 데이터 상태

화면 값은 각 MainOrg.vue가 제공하는 프로토타입 데이터다.
InlineProfileSectionsOrg.vue의 저장은 컴포넌트 로컬 상태만 갱신한다.
구분·등록번호처럼 editable: false인 필드는 최초 등록 이후 변경 불가한 안정 식별값으로 취급한다.
API 연동 시 화면에 표시되는 등록번호·등록코드와 내부 고유코드·관리코드를 혼용하지 않는다.

향후 API 계약

프로필 섹션 저장 API는 최소한 다음을 보장해야 한다.

변경 가능한 필드만 허용 목록으로 검증한다.
최초 등록 뒤 잠긴 필드는 클라이언트 값과 무관하게 서버에서 변경을 거부한다.
이메일·휴대전화처럼 재인증이 필요한 값은 저장 상태와 인증 상태를 분리해 반환한다.
동시 수정 충돌을 감지할 수 있도록 버전 또는 수정 시각을 제공한다.
조직·사용자·빌링 상품은 독립적으로 사용할 수 있어야 하며, 다른 프로필 상품의 존재를 저장 전제조건으로 삼지 않는다.

오류 표시 계약

필드 오류는 필드 키별 메시지로 반환하고, 권한·동시 수정·서버 오류는 섹션 수준 오류로 구분한다. 일부 필드만 저장된 것처럼 보이는 부분 성공 응답은 사용하지 않는다.