문서 디자이너 Spec

화면 경로 /mainPages/eDocDesigner · 작성일 2026-10-12

문서 디자이너 화면의 기능·데이터·권한을 정리한 원본 문서입니다. 도움말(eDocDesigner-help.html)의 상세 링크가 이 문서의 각 항목으로 연결됩니다.

A1. 업무 흐름

사용자가 컴포넌트를 배치해 문서를 만들고 저장합니다. 공개와 메뉴 경로를 지정하면 다른 사용자가 메뉴 > 자료실에서 읽을 수 있습니다.

단계	사용 지점	사용 주체	목적
① ② 작성	안내문·매뉴얼·양식이 필요할 때	로그인 사용자	문서를 만들고 보관
③ 공개	여러 사람이 읽어야 할 때	문서 작성자	자료실 메뉴에 게시

항목	내용
화면명	문서 디자이너
화면 경로	/mainPages/eDocDesigner
메뉴 키	eDocDesigner (서비스 메뉴, 홈 카드 표시)
화면 목적	컴포넌트를 배치해 문서를 만들고 저장·공개한다
화면 유형	편집기
프로그램	components/core/client/eDoc/ (eDocDesignerContainer, eDocDesignerTopMenu, eDocComponentPalette, eDocEditorCanvas, 속성 편집기)
API 모듈	pages/api/biz/eDoc/eDocDocument.js (EDOC_*)
주요 테이블	TB_COR_EDOC_DOCUMENT, TB_COR_EDOC_COMPONENT, TB_COR_CREDIT_MST, TB_COR_CREDIT_LEDGER
도움말 파일	public/help/eDocDesigner-help.html, eDocDesigner-spec.html

영역	영역명	사용자가 하는 일	화면 동작	backend 동작
①	상단 메뉴	문서·페이지 관리, 내보내기, AI 생성	좁은 화면에서는 짧은 이름으로 표시	EDOC_DOCUMENT_, EDOC_AI_
②	컴포넌트	부품을 캔버스로 끌어다 놓기	텍스트, 이미지, 테이블, 입력, 체크리스트, 버튼, 링크, 카드, 동영상, Lottie	EDOC_COMPONENT_TEMPLATES_SELECT_ALL
③	캔버스	컴포넌트 선택·이동, 페이지 이동	실제 문서 모양으로 표시	없음
④	속성	선택한 컴포넌트·페이지·문서 설정	입력 즉시 캔버스에 반영	없음

문서 열기 창에서 내 문서 목록을 조회합니다. 관리자는 전체 문서 목록도 볼 수 있습니다.

버튼	확인·검증	결과	backend 처리
실행 취소 · 다시 실행	없음	최근 50단계까지 되돌림 (Ctrl+Z / Ctrl+Y)	없음
새 문서	없음	빈 문서로 시작	없음
문서 열기	없음	목록에서 고른 문서를 불러옴	EDOC_USER_DOCUMENT_SELECT_ALL, EDOC_DOCUMENT_SELECT_ONE
문서 저장	없음	새 문서는 생성, 기존 문서는 덮어씀	EDOC_DOCUMENT_UPSERT_ONE
문서 삭제	확인 창	문서 삭제, 되돌릴 수 없음	EDOC_DOCUMENT_DELETE_ONE
페이지 추가 · 삭제	없음	현재 문서의 페이지 수 변경	없음 (저장 시 반영)
PDF 내보내기	없음	PDF 파일 내려받기	없음
MD 내보내기 · 가져오기	없음	Markdown 파일로 저장하거나 Markdown을 컴포넌트로 변환	없음
AI 생성	설명 입력, 모델 선택, 크레딧 잔액	문서 초안을 캔버스에 채움	EDOC_AI_GET_MODEL_LIST, EDOC_AI_GENERATE_DOCUMENT

역할	내 문서 작성·수정·삭제	공개	전체 문서 조회
로그인 사용자	O	O (내 문서)	X
관리자	O	O	O

작성 중저장비공개공개 + 메뉴 경로자료실 게시

처리	바뀌는 데이터	함께 일어나는 일
저장	TB_COR_EDOC_DOCUMENT	공개·메뉴 경로가 있으면 메뉴 > 자료실에 표시
AI 생성	TB_COR_CREDIT_MST, TB_COR_CREDIT_LEDGER	서비스 AI를 쓰면 성공했을 때만 1회 1크레딧(기본값) 차감, 내 AI API 키를 쓰면 차감 없음, 잔액이 부족하면 생성하지 않음
삭제	TB_COR_EDOC_DOCUMENT	자료실에서도 사라짐

버전	수정일	수정 내용
1.0	2026-10-12	최초 작성