문서 관리 개요

작성 중인 매뉴얼

이 문서는 현행 앱 화면과 기능을 기준으로 다시 작성하고 있습니다. 실제 메뉴, 화면 구성과 동작이 아래 설명과 다를 수 있습니다.

Intellidesk의 문서 관리 모듈은 SAP 프로젝트에서 발생하는 다양한 산출물을 체계적으로 작성, 관리, 배포할 수 있는 통합 환경을 제공합니다.

문서 유형

Intellidesk에서 관리할 수 있는 문서 유형은 다음과 같습니다.

문서 유형	설명	주요 용도
기능 사양서 (Functional Spec)	업무 요건을 기반으로 시스템 기능을 정의	화면 설계, ALV 그리드 명세, 데이터 연결 정의
기술 사양서 (Technical Spec)	기능 사양서를 기반으로 기술 구현 방안을 기술	아키텍처 설계, 데이터 모델, API 설계
사용자 매뉴얼 (User Manual)	최종 사용자를 위한 시스템 사용 안내서	화면별 조작 방법, 업무 절차 설명
운영 매뉴얼 (Operation Manual)	시스템 운영 및 관리를 위한 안내서	배치 작업, 모니터링, 장애 대응 절차
SAP Config	SAP 시스템 설정 내역을 문서화	커스터마이징 설정, 트랜잭션 코드 정리
기타 (Etc)	위 유형에 해당하지 않는 프로젝트 문서	회의록, 이슈 목록, 교육 자료 등

문서 유형 선택

문서 생성 시 유형을 선택하면, 해당 유형에 맞는 템플릿과 섹션 구조가 자동으로 적용됩니다. 유형별 특화 기능은 각 문서 유형의 상세 가이드를 참고하세요.

SAP 설정 문서

앱 사이드바의 설계 > SAP 설정 문서에서 SAP 커스터마이징 설정과 트랜잭션 정보를 문서화합니다. 목록, 생성, 조회와 수정 방식은 다른 문서 유형과 같으며 SAP 설정에 맞는 입력 구조를 사용합니다.

사용자 매뉴얼

문서 관리 > 사용자 매뉴얼에서 최종 사용자가 업무를 수행하는 순서와 화면별 조작 방법을 작성합니다.

운영 매뉴얼

문서 관리 > 운영 매뉴얼에서 배치 작업, 모니터링, 장애 대응처럼 운영 담당자가 반복해서 수행하는 절차를 관리합니다.

기타 문서

문서 관리 > 기타 문서는 회의록, 이슈 목록과 교육 자료처럼 정해진 유형에 속하지 않는 산출물에 사용합니다.

문서 생명주기

모든 문서는 다음과 같은 생명주기를 따릅니다.

생성(Create) → 편집(Edit) → 검토(Review) → 승인(Approve) → 게시(Publish)

1단계: 생성 (Create)

새 문서를 생성하면 초안(Draft) 상태로 시작됩니다.

• 문서 유형 선택
• 기본 정보 입력 (제목, 모듈, 관련 프로세스)
• 템플릿 자동 적용

2단계: 편집 (Edit)

WYSIWYG 에디터를 사용하여 문서 내용을 작성합니다.

• 리치 텍스트 편집
• AI 콘텐츠 생성 지원
• 다이어그램 삽입
• 자동 저장 및 버전 관리

3단계: 검토 (Review)

작성이 완료된 문서를 검토 요청합니다.

• 검토자 지정
• 코멘트 및 피드백 등록
• 수정 요청 시 편집 단계로 회귀

4단계: 승인 (Approve)

검토가 완료된 문서에 대해 승인권자가 최종 승인합니다.

• 승인 / 반려 처리
• 반려 시 사유 기록과 함께 편집 단계로 회귀

5단계: 게시 (Publish)

승인된 문서는 게시 상태로 전환되어 전체 프로젝트 팀에 공유됩니다.

• 최종 버전 확정
• PDF/DOCX/HTML 내보내기 가능
• 읽기 전용 모드 전환

주의사항

게시된 문서를 수정하려면 새로운 버전을 생성해야 합니다. 기존 게시 버전은 이력으로 보존됩니다.

공통 기능

모든 문서 유형에서 공통으로 사용할 수 있는 기능입니다.

상단 헤더의 공간이 부족하면 버전 선택기와 작업 버튼이 제목 아래로 줄바꿈됩니다. 헤더가 좁을 때 일부 작업은 ⋯ 메뉴에 모이며, 저장 같은 주요 작업은 버튼으로 유지됩니다. 이 배치는 프로세스 흐름도 등 공통 페이지 헤더를 사용하는 화면에도 적용됩니다.

상세 정보와 즐겨찾기

문서 화면의 제목과 상태 배지 옆에는 즐겨찾기 별과 정보 아이콘이 나란히 놓입니다. 별을 누르면 이 문서가 즐겨찾기에 등록되어 대시보드에서 바로 열 수 있고, 정보 아이콘을 누르면 제목, 문서번호, 모듈, 담당자 같은 상세 정보 패널이 열립니다. 편집 모드에서는 같은 패널에서 고친 뒤 저장할 수 있습니다. 상세 정보 패널은 넓은 화면에서 여유 있는 너비로 열리며, 모바일에서는 화면 너비에 맞춰 표시됩니다.

두 버튼은 프로세스 흐름도 화면에도 같은 자리에 있습니다.

제목 아래 문서번호 옆에는 지금 보고 있는 버전을 마지막으로 고친 사람과 시점이 홍길동 · 3일 전 형태로 붙습니다. 마우스를 올리면 정확한 일시가 뜨고, 상세 정보 패널 맨 위에서도 같은 내용을 정확한 일시로 확인할 수 있습니다.

수정한 사람을 기록하기 전에 저장된 옛 문서는 이름 없이 시점만 표시됩니다.

다른 사용자에게 공유

만든 사람과 담당자 외의 사용자에게 수정 권한을 줄 수 있습니다.

1. 화면 상단 작업 메뉴에서 공유를 누릅니다.
2. 사용자를 검색해 고르고 추가를 누릅니다.
3. 목록에 추가된 사용자의 x를 누르면 공유가 해제됩니다.

공유받은 사용자는 수정만 할 수 있고 삭제는 할 수 없습니다. 공유 목록을 관리하는 것도 담당자만 가능해서, 공유받은 사용자가 다시 다른 사람에게 공유할 수는 없습니다.

공유는 조회 범위를 넓히지 않습니다. 누가 볼 수 있는지는 문서와 흐름도의 공개 범위 설정이 그대로 결정합니다. 그래서 애초에 볼 수 없는 사용자에게 공유하면 수정 권한만 생기고 화면은 열리지 않습니다.

공유 버튼은 담당자에게만 보입니다.

공유 중인 문서와 흐름도는 제목 옆에 공유 아이콘과 인원수가 붙습니다. 이 표시는 문서를 볼 수 있는 모든 사용자에게 보이고, 담당자가 누르면 공유 다이얼로그가 바로 열립니다.

리치 텍스트 에디터

Tiptap 기반의 WYSIWYG 에디터를 제공합니다.

• 서식: 제목(H1~H4), 굵게, 기울임, 밑줄, 취소선
• 목록: 순서 있는 목록, 순서 없는 목록, 체크리스트
• 표: 행/열 추가 및 삭제, 셀 병합, 셀 배경색
• 코드: 인라인 코드, 코드 블록 (구문 강조 지원)
• 미디어: 이미지 삽입, 파일 첨부

다이어그램 지원

문서 내에서 PlantUML과 Mermaid 다이어그램을 작성하고 미리보기할 수 있습니다.

• PlantUML: 시퀀스 다이어그램, 클래스 다이어그램, 유스케이스 다이어그램
• Mermaid: 플로차트, 간트 차트, ER 다이어그램

다이어그램 팁

에디터에서 /diagram 명령을 입력하면 다이어그램 블록이 삽입됩니다. PlantUML 또는 Mermaid 문법을 선택하여 작성할 수 있습니다.

목차 (Table of Contents)

문서 내 제목 태그(H1~H4)를 기반으로 목차가 자동 생성됩니다. 목차 항목을 클릭하면 해당 섹션으로 이동합니다.

버전 관리

문서의 모든 변경 이력이 자동으로 기록됩니다.

• 자동 저장 (30초 간격)
• 수동 버전 생성 (버전 메모 입력 가능)
• 버전 간 비교 (diff 보기)
• 이전 버전 복원

편집 화면의 저장 버튼 옆 ⌄ 메뉴에서 새 버전으로 저장을 클릭하면 변경 사유 입력 다이얼로그가 뜨고, 사유를 적어야 저장 버튼이 활성화됩니다. 같은 메뉴의 새 문서로 저장은 현재 내용으로 완전히 새로운 문서를 만들며, 변경 사유 입력 없이 바로 저장됩니다.

편집 화면 상단의 버전 선택기를 펼치면 각 버전의 번호와 작성 시점 아래에 저장할 때 입력한 변경 사유가 한 줄로 표시됩니다. 사유가 길면 뒷부분이 잘리며, 항목에 마우스를 올리면 전체 내용을 볼 수 있습니다.

버전을 삭제하면 남아 있는 버전 중 가장 최신 버전 화면으로 이동합니다. 마지막 한 개까지 삭제한 경우에는 볼 수 있는 버전이 없으므로 문서 목록으로 이동합니다.

AI 콘텐츠 생성

AI를 활용하여 문서 작성을 지원받을 수 있습니다.

• 프로세스 액티비티 기반 자동 콘텐츠 생성
• 문서 유형별 맞춤형 제안
• 기존 내용 기반 추가 섹션 제안
• 문맥에 맞는 다이어그램 자동 생성

기능정의서 편집 화면에서는 하단의 AI로 화면 작업을 사용해 현재 화면을 수정하거나 새 화면을 추가할 수 있습니다. 작업 결과는 캔버스에 바로 반영되지만, 상단의 저장을 눌러야 최종 채택으로 기록됩니다. 팝오버를 닫거나 같은 요청을 다시 생성하는 동작만으로는 결과를 폐기한 것으로 보지 않습니다.

AI 생성 팁

AI가 생성한 콘텐츠는 항상 검토 후 사용하세요. 프로젝트 맥락에 맞게 수정이 필요할 수 있습니다.

생성 결과를 쓰지 않을 때

생성된 결과를 적용하지 않고 창을 닫는 등 결과를 명시적으로 버리면 이유를 묻는 알림이 잠깐 나타납니다. 폐기 상태는 알림보다 먼저 기록됩니다. 보기 중 하나를 고르면 이유가 추가되고, 그냥 두면 이유만 답하지 않은 채로 넘어갑니다. 답하지 않아도 문제되지 않습니다.

보기	고르는 경우
내용이 요구사항과 다름	요청한 것과 다른 내용이 나왔을 때
너무 일반적임	맞는 말이지만 구체성이 없을 때
형식·구조가 안 맞음	내용은 쓸 만한데 문서 형식이 어긋날 때
우리 시스템 사정을 반영 못함	회사나 시스템의 실제 사정과 맞지 않을 때
수정해서 쓰기 어려움	초안을 손봐서 쓰는 비용이 너무 클 때
기타	위에 해당하지 않을 때

여기서 모인 답은 관리자 화면의 AI 채택률에서 집계되어 생성 품질을 개선하는 데 쓰입니다. 개별 응답이 작성자에게 공개되지는 않습니다.

승인 워크플로

문서별로 검토자와 승인자를 지정하여 체계적인 승인 절차를 운영합니다.

1. 작성자가 검토 요청
2. 검토자가 코멘트 및 승인/반려
3. 승인자가 최종 승인/반려
4. 승인 완료 시 게시 가능

내보내기

완성된 문서를 다양한 형식으로 내보낼 수 있습니다.

형식	설명
PDF	인쇄 및 배포용. 다이어그램 포함
DOCX	Microsoft Word 형식. 추가 편집 가능
HTML	웹 공유용. 스타일 포함

문서 목록 화면

검색

문서 제목, 내용, 작성자 등을 기준으로 키워드 검색이 가능합니다. 검색창에 키워드를 입력하면 실시간으로 결과가 필터링됩니다.

필터

다양한 조건으로 문서 목록을 필터링할 수 있습니다.

• 문서 유형: 기능 사양서, 기술 사양서, 사용자 매뉴얼 등
• 상태: 초안, 검토 중, 승인 완료, 게시됨
• 모듈: FI, CO, MM, SD 등 SAP 모듈별 필터
• 작성자: 특정 작성자의 문서만 조회
• 기간: 생성일 또는 수정일 기준 기간 필터

모바일에서는 검색창 옆의 더보기 버튼으로 필터 팝업을 엽니다. 필터 목록을 스크롤해 조건을 입력하고, 팝업 하단에 고정된 검색·초기화 버튼으로 적용하거나 초기화할 수 있습니다. 초기화는 적용한 조건뿐 아니라 검색창에 남은 텍스트도 지우며, 선택 항목을 전체로 바꾸고 첫 페이지로 돌아갑니다. 모바일 상단 검색창도 함께 비워집니다.

화면 폭보다 넓은 표는 표 영역 안에서 좌우로 스크롤해 오른쪽 열을 확인할 수 있습니다. 하단의 페이지 이동과 열 표시 버튼은 공간이 부족하면 줄바꿈됩니다.

정렬

목록 헤더를 클릭하여 오름차순/내림차순으로 정렬할 수 있습니다.

• 제목순
• 최근 수정일순 (기본값)
• 생성일순
• 상태순
• 문서 유형순

개인 설정 저장

필터와 정렬 설정은 사용자별로 저장됩니다. 다음 접속 시에도 마지막 설정이 유지됩니다.

좁은 화면의 편집 도구

문서 편집기 툴바는 공간이 부족하면 도구 그룹 단위로 다음 줄에 배치됩니다. 기본 설정에서는 작은 화면에서도 모든 도구를 유지하며, 화면을 넓히면 다시 한 줄로 모입니다. 화면 폭만으로 도구를 간소화하거나 숨기지 않습니다.

목록 검색

문서 목록의 검색창은 검색어가 제목이나 프로그램 ID의 어느 위치에 있든 찾습니다. 예를 들어 조회를 입력하면 조회 프로그램과 프로그램 조회를 모두 검색합니다. 별표를 붙일 필요가 없습니다. 시스템·모듈 등 다른 필터를 함께 적용하면 검색 범위를 좁힐 수 있습니다.