원칙 · 어조
화면의 말은 현장 작업자에게는 지시가, 심사관에게는 증거가 됩니다. 사실을 먼저, 조치를 다음에, 존댓말로, 약어 없이, 한 문장에 한 정보.
기준보다 2.3도 높습니다.
문을 닫고 10분 뒤 다시 확인하세요.
다섯 원칙
1사실 → 조치무슨 일이 있었는지(수치·시각) 먼저, 무엇을 하면 되는지 다음. 감탄·평가는 없다.
2완결 문장"DEV +2.3" 이 아니라 "기준보다 2.3도 높습니다". 숫자 옆에는 항상 문장이 있다.
3존댓말 "~하세요"명령형("확인 요망")·반말·격식체("확인하시기 바랍니다") 대신 "확인하세요". 버튼은 명사·동사 원형.
4약어는 풀어 쓴다첫 등장은 "중요관리점(CCP)". 화면 안에서 만든 약어(FRZ, DEV, ACK) 금지. ID 는 고정폭으로 구분.
5한 문장 한 정보시니어 화면은 문장 하나에 정보 하나, 줄바꿈으로 나눈다. 쉼표로 이어 붙이지 않는다.
어조 표
| 상황 | 어조 | 예 | 피할 것 |
|---|---|---|---|
| 정상 | 담담하게, 짧게 | 기준 범위 안에 있습니다 | 완벽합니다! · 이상 없음 👍 |
| 경보 | 사실 → 조치, 겁주지 않는다 | 기준보다 2.3도 높습니다. 문 닫힘과 성에를 확인하세요 | 위험!! 즉시 조치 요망 · 이상 감지 |
| 오류(사용자) | 무엇이 왜 + 고치는 법, 사과 없음 | 기준 75.0℃ 이상이어야 합니다 | 잘못된 입력입니다 · 죄송합니다 |
| 오류(시스템) | 사실 + 다음 행동 + 담당 | 서버에 연결할 수 없습니다. 공장 Wi-Fi 를 확인하세요 | 알 수 없는 오류가 발생했습니다 · Error 500 |
| 확인 질문 | 결과를 말하고 묻는다 | 제출하면 내용을 고칠 수 없습니다. 제출할까요? | 정말 제출하시겠습니까? |
| 완료 | 과거형, 다음 상태 | 리포트를 제출했습니다 · 검토 대기 | 제출 성공! · 완료되었습니다 |
| 빈 상태 | 무엇이 없는지 + 다음 행동 | 아직 작성한 일지가 없습니다 | 데이터가 없습니다 · No data |
| 권한 | 누가 할 수 있는지 | 경보 확인 권한이 없습니다 (품질관리자 이상) | 권한 오류 · 접근 거부 |
문장 규칙
- 주어는 대상(센서·리포트), 사용자를 "당신·회원님"으로 부르지 않는다. 이름은 "김현장님"(시니어 재로그인 등 꼭 필요할 때만).
- 시제: 상태는 현재("높습니다"), 완료는 과거("제출했습니다"), 결과 예고는 "~됩니다"("작성자에게 표시됩니다").
- 부정보다 긍정: "미기록 2건을 기록하면 제출할 수 있습니다" (○) / "기록하지 않으면 제출할 수 없습니다" (△).
- 수치는 문장 안에 넣는다: "3분 전부터 온도가 들어오지 않습니다". 수치 없는 경고 금지.
- 마침표: 본문 문장에는 찍고, 버튼·배지·제목·토스트·표 셀에는 찍지 않는다.
- 영어·한자·이모지 금지. 단위 기호(℃ % mm)와 고정 약어(CCP PDF QR ID)만 예외.
- 같은 뜻은 같은 말: 적합/부적합 · 정상/경보 · 제출/검토/승인/반려 — 용어 사전.
Do · Don't
Do 사실 → 조치, 수치 포함
Don't 평가 · 명령 · 수치 없음
형식이 다릅니다. 'HK-0412'처럼 하이픈을 넣으세요
Do 오류: 무엇이 왜 어떻게
죄송합니다. 올바르지 않은 값입니다.
Don't 사과 · 추상
안정마지막 갱신 담당 디자인시스템 TF · jjo831@farmzone.kr소스 senior/status.ts 문장 · 앱 화면 문구 · 브랜드 키워드UX Writing · FNA 디자인 시스템 v1.0