DiagramPreview
2026-10-245분

Markdown 디자인 명세 템플릿: UI 상태와 인수 기준

설정 화면 명세를 다운로드하고 수정하여 개발 인계 전에 문서의 누락 사항을 확인하세요.

Markdown 디자인 명세 템플릿: UI 상태와 인수 기준
01

이미지보다 명확한 결정 사항

화면 이미지만으로는 저장을 언제 비활성화하는지, 실패 후 초안을 유지하는지 알 수 없습니다. DiagramPreview 독립 템플릿은 이를 디자이너, 개발자, 도우미에게 설명합니다. Figma 공식 템플릿이나 자동 가져오기 형식이 아니며 동일한 화면 표시도 보장하지 않습니다.

02

열기, 수정, 양식으로 생성

미리보기와 다운로드는 같은 언어의 동일한 Markdown을 사용합니다. 제목, 목적, 토큰, 상태, 기준을 수정하세요. 생성기는 양식, 직접 편집, 일치한 원문 행 또는 제안을 보여주는 로컬 점검을 제공합니다. 텍스트 일치는 구현의 정확성을 입증하지 않습니다. 미리보기 URL의 프래그먼트에는 원문이 포함되므로 공유 전에 비공개 정보를 제거하세요.

markdown복사 가능한 예제
# 작업 공간 설정 — 디자인 명세

> DiagramPreview 독립 예제입니다. 제품에 맞게 수정하세요. Figma 공식 템플릿이나 가져오기 형식이 아닙니다.

## 목적과 범위
소유자가 작업 공간 이름과 알림 설정을 변경할 수 있게 한다.
결제, 초대, 권한 관리는 제외한다. 가상 데이터를 사용하며 운영 서버에 연결하지 않는다.

## 디자인 토큰
- 주요 동작: #1D4ED8 배경과 흰색 글자.
- 본문: #0F172A, 배경 #FFFFFF. 보조 글자: #475569. 오류: #B91C1C.
- 글꼴: system-ui. 본문 16px / 24px, 제목 24px / 32px.
- 간격: 4, 8, 12, 16, 24, 32px. 카드 반경: 8px.
- 이름이 있는 토큰을 사용하고 임의의 색상이나 간격을 추가하지 않는다.

## 구성요소와 상태
### 저장 버튼
- 기본: “변경 사항 저장”, 주요 동작 배경.
- 호버: #1E40AF, 흰색 글자의 가독성 유지.
- 포커스: 2px 외곽선과 2px 간격.
- 변경이 없거나 잘못된 입력이면 비활성화하고 필드 옆에 이유를 설명한다.
- 저장 중에는 메시지를 표시하고 중복 전송을 방지한다.
- 성공: live region으로 “변경 사항 저장됨”을 알린다.
- 오류 발생 시 입력을 유지하고 재시도를 제공한다.
### 작업 공간 이름
- 필수. 앞뒤 공백 제거 후 2~60자.
- 라벨과 도움말을 항상 표시하며 자리표시자로 대체하지 않는다.
- 포커스를 잃을 때와 저장 전에 검증하고 오류를 필드에 연결한다.
- 검증 실패 시 저장하지 않는다.

## 상호작용과 데이터
1. 현재 이름과 알림 설정을 불러온다.
2. 유효한 변경이 있을 때만 저장을 활성화한다.
3. 전송 시 모의 요청을 실행하고 로딩 상태를 표시한다.
4. 성공 시 확정 값을 유지하고 완료를 알린다.
5. 실패 시 초안을 유지하고 재시도를 제공한다.
- 초기 로딩에는 설명이 있는 자리표시자를 표시한다.
- 초기 요청 실패 시 재시도를 제공하며 저장 데이터를 꾸며내지 않는다.
- 빈 이름이면 필수 입력 메시지를 표시한다.

## 반응형 배치
- 768px 미만: 한 열, 여백 16px, 저장 버튼 전체 너비.
- 768px 이상: 가운데 배치, 최대 너비 640px, 여백 24px.
- 너비 320px에서 가로 스크롤이 생기지 않는다.

## 접근성
- 각 입력에 프로그램으로 인식 가능한 라벨을 제공하며 Tab은 시각적 순서를 따른다.
- 키보드로 모든 동작을 수행하고 포커스가 보이게 한다.
- 성공과 오류는 색상뿐 아니라 텍스트로 전달한다.
- 일반 텍스트와 실제 배경의 명암비를 4.5:1 이상으로 확인한다.

## 인수 체크리스트
- [ ] 빈 이름은 오류를 표시하고 전송할 수 없게 한다.
- [ ] 2~60자 범위를 벗어나면 구체적인 오류를 표시한다.
- [ ] 저장 중 여러 번 클릭해도 요청은 한 번만 보낸다.
- [ ] 실패 시 입력을 유지하고 재시도할 수 있다.
- [ ] 포커스를 이동하지 않고 완료 알림을 제공한다.
- [ ] 키보드 조작과 너비 320px 화면을 검사한다.
- [ ] 구현한 모든 상태를 명세와 비교한다.

## 운영 적용 전 결정 사항
- TODO: API, 인가 규칙, 오류 응답을 개발 담당자와 확인한다.
- TODO: 알림 동작과 최종 문구를 제품 담당자와 확인한다.
- 데이터 계약 승인 후 모의 요청을 교체한다.
상태, 시각적 규칙, 인수 기준을 담은 설정 화면 예제.
03

미결 사항을 분리

기존 토큰과 구성요소를 재사용하고 용도도 명시하세요. API, 인가, 승인되지 않은 규칙은 미결로 남깁니다. 프로토타입 요청은 한 화면, 가상 데이터, 모의 요청으로 제한하세요. 잘못된 입력, 반복 클릭, 네트워크 실패, 성공, 포커스, 모바일 너비를 직접 시험하고 관찰 내용을 기록하세요. 생성된 보고서는 실제 검증을 대신하지 못합니다.

04

필요할 때 흐름도 추가

단순한 양식은 번호가 있는 단계만으로 충분할 수 있습니다. 분기가 있다면 별도 Mermaid 흐름도를 추가하세요. 생성기의 독립 저장 예제는 수정하여 기존 SVG/PNG 도구로 보낼 수 있지만 명세에서 자동 추론하지 않습니다. DiagramPreview의 Mermaid 지원은 Figma Specs의 기본 지원을 의미하지 않습니다. 허용되는 삽입 방식을 확인하고 추후 수정을 위해 흐름도 원문도 보관하세요.