CCTI Manual03: 두 판 사이의 차이

Vaquita Wiki
편집 요약 없음
편집 요약 없음
 
2번째 줄: 2번째 줄:
<head>
<head>
     <meta charset="UTF-8">
     <meta charset="UTF-8">
     <title>CCTI 사용 설명서 - 소스 텍스트 편집기</title>
     <title>CCTI 사용 설명서 - 텍스트 입력기</title>
     <style>
     <style>
         body { font-family: 'Malgun Gothic', sans-serif; line-height: 1.6; color: #333; max-width: 900px; margin: 0 auto; padding: 20px; }
         body { font-family: 'Malgun Gothic', sans-serif; line-height: 1.6; color: #333; max-width: 900px; margin: 0 auto; padding: 20px; }
         h1 { color: #2c3e50; border-bottom: 2px solid #2c3e50; padding-bottom: 10px; }
         h1 { color: #2c3e50; border-bottom: 2px solid #2c3e50; padding-bottom: 10px; }
         h2 { color: #27ae60; border-left: 5px solid #27ae60; padding-left: 10px; margin-top: 30px; }
         h2 { color: #e67e22; border-left: 5px solid #e67e22; padding-left: 10px; margin-top: 30px; }
         h3 { color: #2980b9; margin-top: 20px; }
         h3 { color: #2980b9; margin-top: 20px; }
         .info-box { background-color: #f9f9f9; border: 1px solid #ddd; padding: 15px; border-radius: 8px; margin: 10px 0; }
         .info-box { background-color: #f9f9f9; border: 1px solid #ddd; padding: 15px; border-radius: 8px; margin: 10px 0; }
13번째 줄: 13번째 줄:
         th, td { border: 1px solid #ddd; padding: 12px; text-align: left; }
         th, td { border: 1px solid #ddd; padding: 12px; text-align: left; }
         th { background-color: #f2f2f2; color: #333; }
         th { background-color: #f2f2f2; color: #333; }
         .key-text { font-weight: bold; color: #c0392b; }
         .key-text { font-weight: bold; color: #d35400; }
         .code-inline { background-color: #eee; padding: 2px 5px; border-radius: 4px; font-family: monospace; }
         .code-inline { background-color: #eee; padding: 2px 5px; border-radius: 4px; font-family: monospace; }
        .warning { color: #e74c3c; font-weight: bold; }
     </style>
     </style>
</head>
</head>
<body>
<body>


     <h1>4) 소스 텍스트 편집기 (Update Source Text)</h1>
     <h1>3) 텍스트 입력기 (Insert New Text)</h1>


     <section>
     <section>
         <h2>1. 모듈 이름</h2>
         <h2>1. 모듈 이름</h2>
         <p><strong>소스 텍스트 편집기 (Update Source Text)</strong></p>
         <p><strong>텍스트 입력기 (Insert New Text)</strong></p>
         <p>기존에 등록된 텍스트 유닛의 메타데이터(카테고리, URL 등)와 한문 원문을 수정하거나, 해당 유닛 전체를 삭제할 때 사용하는 관리 모듈입니다.</p>
         <p>해석하고자 하는 새로운 한문 문헌 단위(Text Unit)를 시스템에 최초로 등록하고, 데이터베이스(DB) 내에 공간을 생성하는 모듈입니다.</p>
     </section>
     </section>


31번째 줄: 30번째 줄:
         <h2>2. 주요 기능</h2>
         <h2>2. 주요 기능</h2>
         <ul>
         <ul>
             <li><strong>정보 수정 (Update):</strong> 등록된 텍스트의 카테고리, 참고 URL, 비고 사항 및 원문 내용을 자유롭게 보완할 수 있습니다.</li>
             <li><strong>ID 중복 검증:</strong> 입력한 <span class="key-text">Text Unit ID</span>가 이미 DB에 존재하는지 실시간으로 확인하여 데이터 충돌을 방지합니다.</li>
             <li><strong>원문 무결성 유지:</strong> XML 구조를 유지하면서 원문 데이터를 업데이트하여 이후 단계(표점, 번역)의 기준 데이터를 갱신합니다.</li>
             <li><strong>XML 템플릿 자동 생성:</strong> ID가 확인되면 한문 원문과 번역문을 입력할 수 있는 표준 XML 구조(<span class="code-inline">&lt;text_unit&gt;</span>)를 자동으로 생성해 줍니다.</li>
             <li><strong>텍스트 유닛 삭제 (Delete):</strong> 더 이상 필요 없는 데이터 유닛을 데이터베이스에서 완전히 제거합니다.</li>
             <li><strong>메타데이터 관리:</strong> 카테고리, 관련 URL(정보/아이콘), 비고(Remark) 등 텍스트의 부가 정보를 함께 저장합니다.</li>
             <li><strong>권한 기반 삭제:</strong> 삭제 기능은 해당 텍스트를 최초 등록한 <span class="key-text">소유자(Owner/Curator)</span>에게만 활성화되어 데이터 임의 삭제를 방지합니다.</li>
             <li><strong>권한 자동 설정:</strong> 현재 로그인한 사용자의 계정 정보가 해당 텍스트의 관리자(Curator)로 자동 등록됩니다.</li>
         </ul>
         </ul>
     </section>
     </section>
41번째 줄: 40번째 줄:
         <h2>3. 화면 구성</h2>
         <h2>3. 화면 구성</h2>
         <div class="info-box">
         <div class="info-box">
             <p>선택한 텍스트의 현재 정보가 각 입력 필드에 자동으로 불러와지며, 하단에는 수정 삭제를 위한 제어 버튼들이 배치되어 있습니다.</p>
             <p>화면은 크게 상단의 <strong>ID 입력 및 검증 영역</strong>과 하단의 <strong>데이터 입력 영역</strong>으로 나뉩니다.</p>
         </div>
         </div>
         <div class="img-placeholder">
         <div class="img-placeholder">
             <img src="https://app.vaquitalab.com/mediawiki/images/0/08/Ccti_manual04.jpg" width="90%"/>
             <img src="https://app.vaquitalab.com/mediawiki/images/7/7c/Ccti_manual03.jpg" width="90%"/>
             <br/>(기존 데이터가 로딩된 편집 화면)
             <br/>(ID 입력 전/후 상태 변화 포함)
         </div>
         </div>
     </section>
     </section>
60번째 줄: 59번째 줄:
             <tbody>
             <tbody>
                 <tr>
                 <tr>
                     <td><strong>💾 텍스트 저장</strong></td>
                     <td><strong>확인</strong></td>
                     <td>수정된 카테고리, URL, 원문(Source Text) 내용을 데이터베이스에 반영합니다.</td>
                     <td>입력한 'Text Unit ID'의 사용 가능 여부를 체크합니다. 사용 가능한 경우 하단의 입력 폼과 [새 텍스트 저장] 버튼이 활성화됩니다.</td>
                 </tr>
                 </tr>
                 <tr>
                 <tr>
                     <td><strong>🗑️ 텍스트 유닛 삭제</strong></td>
                     <td><strong>💾 새 텍스트 저장</strong></td>
                     <td>현재 편집 중인 텍스트 유닛 전체를 DB에서 삭제합니다. <span class="warning">※ 소유자 권한이 있는 경우에만 클릭 가능합니다.</span></td>
                     <td>입력된 모든 정보(카테고리, XML 원문 등)를 DB에 최종 저장합니다. ID 검증이 완료된 상태에서만 클릭할 수 있습니다.</td>
                 </tr>
                 </tr>
                 <tr>
                 <tr>
                     <td><strong>📜 콘텐츠 목록</strong></td>
                     <td><strong>📜 콘텐츠 목록</strong></td>
                     <td>수정 작업을 중단하고 메인 대시보드(Viewer) 화면으로 이동합니다.</td>
                     <td>저장을 취소하거나 완료한 후, '한문 해석 프로세스 관리기(Viewer)' 화면으로 돌아갑니다.</td>
                 </tr>
                 </tr>
             </tbody>
             </tbody>
77번째 줄: 76번째 줄:
     <section>
     <section>
         <h2>5. 메시지 가이드</h2>
         <h2>5. 메시지 가이드</h2>
         <p>작업 결과에 따라 화면 중앙의 메시지 영역에 다음과 같은 안내가 표시됩니다.</p>
         <p>시스템 상태에 따라 상단 혹은 하단 메시지 영역에 다음과 같은 안내가 표시됩니다.</p>
         <div class="info-box">
         <div class="info-box">
             <ul>
             <ul>
                 <li><span class="key-text">"〔ID〕 데이터가 업데이트되었습니다."</span>: 수정 사항이 안전하게 DB에 저장되었을 표시됩니다.</li>
                 <li><span class="key-text">"새 텍스트 유닛의 ID를 입력하고 〔확인〕 버튼을 누르세요."</span>: 초기 진입 시 안내 메시지.</li>
                 <li><span class="key-text">"〔ID〕텍스트 유닛이 삭제되었습니다."</span>: 삭제 처리가 정상적으로 완료된 후 표시됩니다.</li>
                <li><span class="key-text">"⚠️ 이미 존재하는 ID입니다."</span>: 동일한 ID가 이미 DB에 있을 표시되며, 저장이 제한됩니다.</li>
                 <li><span class="key-text">"❌ 데이터 업데이트 오류: [에러내용]"</span>: DB 연결 오류나 데이터 형식 문제로 저장에 실패했을 때 표시됩니다.</li>
                 <li><span class="key-text">"hanmun_text 요소 안에 漢文 원문을 넣으세요..."</span>: ID 중복 검사가 통과되어 입력을 시작할 수 있는 상태입니다.</li>
                 <li><span class="warning">"삭제 권한이 없습니다."</span>: 소유자가 아닌 사용자가 삭제를 시도하거나 화면에 진입했을 때의 안내(버튼 비활성화와 연동).</li>
                 <li><span class="key-text">"새 텍스트〔ID〕 데이터가 데이터베이스에 저장되었습니다."</span>: DB 저장이 성공적으로 완료되었음을 알립니다.</li>
                 <li><span class="key-text">"❌ 데이터 저장 오류: [에러내용]"</span>: 네트워크 문제나 SQL 제약 조건 위반 등으로 저장에 실패한 경우 표시됩니다.</li>
             </ul>
             </ul>
         </div>
         </div>

2026년 2월 1일 (일) 20:28 기준 최신판

CCTI 사용 설명서 - 새 텍스트 입력기

3) 새 텍스트 입력기 (Insert New Text)

1. 모듈 이름

새 텍스트 입력기 (Insert New Text)

해석하고자 하는 새로운 한문 문헌 단위(Text Unit)를 시스템에 최초로 등록하고, 데이터베이스(DB) 내에 공간을 생성하는 모듈입니다.

2. 주요 기능

  • ID 중복 검증: 입력한 Text Unit ID가 이미 DB에 존재하는지 실시간으로 확인하여 데이터 충돌을 방지합니다.
  • XML 템플릿 자동 생성: ID가 확인되면 한문 원문과 번역문을 입력할 수 있는 표준 XML 구조(<text_unit>)를 자동으로 생성해 줍니다.
  • 메타데이터 관리: 카테고리, 관련 URL(정보/아이콘), 비고(Remark) 등 텍스트의 부가 정보를 함께 저장합니다.
  • 권한 자동 설정: 현재 로그인한 사용자의 계정 정보가 해당 텍스트의 관리자(Curator)로 자동 등록됩니다.

3. 화면 구성

화면은 크게 상단의 ID 입력 및 검증 영역과 하단의 데이터 입력 영역으로 나뉩니다.


(ID 입력 전/후 상태 변화 포함)

4. 버튼 기능

버튼명 기능 설명
확인 입력한 'Text Unit ID'의 사용 가능 여부를 체크합니다. 사용 가능한 경우 하단의 입력 폼과 [새 텍스트 저장] 버튼이 활성화됩니다.
💾 새 텍스트 저장 입력된 모든 정보(카테고리, XML 원문 등)를 DB에 최종 저장합니다. ID 검증이 완료된 상태에서만 클릭할 수 있습니다.
📜 콘텐츠 목록 저장을 취소하거나 완료한 후, '한문 해석 프로세스 관리기(Viewer)' 화면으로 돌아갑니다.

5. 메시지 가이드

시스템 상태에 따라 상단 혹은 하단 메시지 영역에 다음과 같은 안내가 표시됩니다.

  • "새 텍스트 유닛의 ID를 입력하고 〔확인〕 버튼을 누르세요.": 초기 진입 시 안내 메시지.
  • "⚠️ 이미 존재하는 ID입니다.": 동일한 ID가 이미 DB에 있을 때 표시되며, 저장이 제한됩니다.
  • "hanmun_text 요소 안에 漢文 원문을 넣으세요...": ID 중복 검사가 통과되어 입력을 시작할 수 있는 상태입니다.
  • "새 텍스트〔ID〕 데이터가 데이터베이스에 저장되었습니다.": DB 저장이 성공적으로 완료되었음을 알립니다.
  • "❌ 데이터 저장 오류: [에러내용]": 네트워크 문제나 SQL 제약 조건 위반 등으로 저장에 실패한 경우 표시됩니다.


☞ CCTI Manual