| 1 |
--- |
1 |
--- |
| 2 |
title: 문서 감사 및 보완 보고서 |
2 |
title: 문서 감사 및 보완 보고서 |
| 3 |
document_id: 99-audit-and-remediation-report |
3 |
document_id: 99-audit-and-remediation-report |
| 4 |
slug: 99-audit-and-remediation-report |
4 |
slug: 99-audit-and-remediation-report |
| 5 |
target_editor_version: 9.0.0 |
5 |
target_editor_version: 10.5.1 |
| 6 |
document_type: maintenance |
6 |
document_type: maintenance |
| 7 |
doc_type: maintenance |
7 |
doc_type: maintenance |
| 8 |
target_readers: [웹마스터, 개발자, AI agent] |
8 |
target_readers: [웹마스터, 개발자, AI agent] |
| 9 |
importance: High |
9 |
importance: High |
| 10 |
dependency: Low |
10 |
dependency: Low |
| 11 |
core_type: Documentation |
11 |
core_type: Documentation |
| 12 |
stability: [Version-Bound] |
12 |
stability: [Version-Bound] |
| 13 |
stable_anchor: [] |
13 |
stable_anchor: [] |
| 14 |
version_bound: [외부 자료와 버전 변화에 따라 후속 재감사가 필요할 수 있음] |
14 |
version_bound: [외부 자료와 버전 변화에 따라 후속 재감사가 필요할 수 있음] |
| 15 |
related_docs: [73-external-reference-index.md, 74-security-guide.md, 75-upload-and-media-pipeline-guide.md, 76-api-and-endpoints-guide.md, 78-release-maintenance-checklist.md] |
15 |
related_docs: [73-external-reference-index.md, 74-security-guide.md, 75-upload-and-media-pipeline-guide.md, 76-api-and-endpoints-guide.md, 78-release-maintenance-checklist.md] |
| 16 |
related_files: [] |
16 |
related_files: [] |
| 17 |
related_functions: [] |
17 |
related_functions: [] |
| 18 |
related_classes_modules: [] |
18 |
related_classes_modules: [] |
| 19 |
related_features: [문서 감사, 참고 자료 정리, 문서 보강] |
19 |
related_features: [문서 감사, 참고 자료 정리, 문서 보강] |
| 20 |
related_ui: [] |
20 |
related_ui: [] |
| 21 |
change_risk: 감사 결과를 반영해 문서 구조와 참고 자료 표기를 바꿨으므로 기존 내부 링크나 외부 링크 목록을 참조하던 자동화가 있다면 확인이 필요합니다. |
21 |
change_risk: 감사 결과를 반영해 문서 구조와 참고 자료 표기를 바꿨으므로 기존 내부 링크나 외부 링크 목록을 참조하던 자동화가 있다면 확인이 필요합니다. |
| 22 |
reading_order: 99 |
22 |
reading_order: 99 |
| 23 |
summary: 기존 문서 세트를 전체 감사한 뒤 어떤 문제를 수정했고 무엇을 추가했는지 정리한 보고서입니다. |
23 |
summary: 기존 문서 세트를 전체 감사한 뒤 어떤 문제를 수정했고 무엇을 추가했는지 정리한 보고서입니다. |
| 24 |
description: 내부 추적용 인용 제거, 실제 URL 정리, 짧은 문서 확장, 중복 역할 정리, 보안·API·업로드 가이드 추가 등 감사 결과를 정리합니다. |
24 |
description: 내부 추적용 인용 제거, 실제 URL 정리, 짧은 문서 확장, 중복 역할 정리, 보안·API·업로드 가이드 추가 등 감사 결과를 정리합니다. |
| 25 |
tags: [T2Editor, audit, remediation, documentation] |
25 |
tags: [T2Editor, audit, remediation, documentation] |
| 26 |
version_tag: 9.0.0 |
26 |
version_tag: 10.5.1 |
| 27 |
maintenance_difficulty: Low |
27 |
maintenance_difficulty: Low |
| 28 |
test_requirement: Medium |
28 |
test_requirement: Medium |
| 29 |
ai_agent_risk: Low |
29 |
ai_agent_risk: Low |
| 30 |
source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] |
30 |
source_basis: [현재 코드 분석 기반, 공식 릴리즈 노트 기반, 공식 배포판 실물 기반] |
| 31 |
beginner_section_included: true |
31 |
beginner_section_included: true |
| 32 |
webmaster_section_included: true |
32 |
webmaster_section_included: true |
| 33 |
developer_section_included: true |
33 |
developer_section_included: true |
| 34 |
--- |
34 |
--- |
| 35 |
|
35 |
|
| 36 |
# 문서 감사 및 보완 보고서 |
36 |
# 문서 감사 및 보완 보고서 |
|
|
37 |
## 이 감사의 기준 시점과 범위 |
| 37 |
|
38 |
|
|
|
39 |
| 항목 | 내용 | |
|
|
40 |
|---|---| |
|
|
41 |
| 대상 판본 | T2Editor 9.0.0 기준 (문서 `version_tag: 9.0.0` 시점) | |
|
|
42 |
| 수행 일자 | **기록이 남아 있지 않습니다.** 아래 6개 작업의 시각은 문서 안에 없어 산출할 수 없습니다 — `[확인 필요]` | |
|
|
43 |
| 현재 판본 | **10.5.1 (2026-07-27)**. 9.x 이하는 EOL입니다 | |
|
|
44 |
| 이 보고서가 보증하지 않는 것 | ① 현재 판본의 기능·구조 ② v10 계열(10.0.0~10.5.1, 9개 판본)의 어떤 것도 ③ 에디터 소스 코드 자체 | |
|
|
45 |
| 관련 최신 감사 | [[80-internal-link-audit-report.md]] (문서 84건 대상, 2026-09-28 재실측) | |
|
|
46 |
|
|
|
47 |
> **2026-09-28 확인 결과, 이 보고서가 2026-09 기준으로 174일 이상 지났다고 단정할 수 없습니다.** 작성일 기록이 없어 일수를 산출하지 않았습니다. 위키 안에 날짜가 명시된 유사 문서(9.x 계열 ChatGPT 감사보고서 9건 중 1건)는 2026-04-23 작성으로 2026-09-28 기준 158일 경과이며, 그것도 **이 보고서가 아니라 다른 문서**의 기준입니다. |
|
|
48 |
|
|
|
49 |
|
| 38 |
## 이번 감사에서 실제로 수정한 항목 |
50 |
## 이번 감사에서 실제로 수정한 항목 |
| 39 |
|
51 |
|
| 40 |
1. 내부 추적용 인용 표기를 전면 제거했습니다. |
52 |
1. 내부 추적용 인용 표기를 전면 제거했습니다. |
| 41 |
2. 모든 참고 자료를 실제 URL 중심으로 다시 적었습니다. |
53 |
2. 모든 참고 자료를 실제 URL 중심으로 다시 적었습니다. |
| 42 |
3. 지나치게 짧거나 실무 밀도가 낮았던 가이드 문서를 보강했습니다. |
54 |
3. 지나치게 짧거나 실무 밀도가 낮았던 가이드 문서를 보강했습니다. |
| 43 |
4. 역할이 겹치던 개발자 진입 문서를 `빠른 진입`과 `본격 구조 해설`로 성격 분리했습니다. |
55 |
4. 역할이 겹치던 개발자 진입 문서를 `빠른 진입`과 `본격 구조 해설`로 성격 분리했습니다. |
| 44 |
5. 보안, 업로드/미디어 흐름, 외부 API/엔드포인트, 외부 의존 라이브러리, 배포 체크리스트 문서를 새로 추가했습니다. |
56 |
5. 보안, 업로드/미디어 흐름, 외부 API/엔드포인트, 외부 의존 라이브러리, 배포 체크리스트 문서를 새로 추가했습니다. |
| 45 |
6. 참고 자료 인덱스 문서를 새로 정리해 DSclub/SIR 자료를 사람이 이해하기 쉬운 방식으로 다시 연결했습니다. |
57 |
6. 참고 자료 인덱스 문서를 새로 정리해 DSclub/SIR 자료를 사람이 이해하기 쉬운 방식으로 다시 연결했습니다. |
| 46 |
|
58 |
|
|
|
59 |
> **2026-09-28 재감사 메모**: 위 6개 작업 자체는 지금도 유효합니다(특히 4번의 08/09 역할 분리는 확인했습니다). 다만 2번("모든 참고 자료를 실제 URL 중심으로 다시 적었습니다")은 **이후 재감사에서 부분적으로 되돌려졌습니다.** 사용자 문서 15건 중 10건이 EOL 판본(8.1.2 · 8.2.0 · 9.0.0 등)의 페이지를 설치·권한·기능의 권위 있는 출처로 제시하고 있었습니다. 2026-09-28 통합관 감사에서 15건 중 11건을 10.5.1 기준으로 교체본을 만들었고(01·02·03·04·05·06·07·08·72), 나머지는 다음 개정 대상입니다. 또한 5번에서 추가한 보안·업로드 문서에도 낡은 지시가 남아 있습니다. 6번의 참고 자료 인덱스는 그 문서 자신이 EOL 배포 페이지를 "설치 절차의 정본"으로 지목하고 있어, 인덱스 문서는 **어디를 믿을 것인가를 정하는 문서로서 오염 전파 위험이 가장 큽니다.** |
|
|
60 |
|
|
|
61 |
> **[확인 필요]** — 5번에서 추가한 5개 문서(74·75·76·77·78)의 현재 상태. 이번 감사 범위 밖이라 수치를 확정하지 않았습니다. |
|
|
62 |
|
| 47 |
## 감사 결과 확인 포인트 |
63 |
## 감사 결과 확인 포인트 |
| 48 |
|
64 |
|
| 49 |
- 참고 자료가 실제 URL 형태인지 |
65 |
- 참고 자료가 실제 URL 형태인지 |
| 50 |
- 문서 상단 메타데이터가 비어 있지 않은지 |
66 |
- 문서 상단 메타데이터가 비어 있지 않은지 |
| 51 |
- 짧은 문서가 최소한 운영 팁·개발 메모·테스트 포인트를 갖추었는지 |
67 |
- 짧은 문서가 최소한 운영 팁·개발 메모·테스트 포인트를 갖추었는지 |
| 52 |
- 외부 서비스 의존 기능에 대한 주의가 충분히 적혀 있는지 |
68 |
- 외부 서비스 의존 기능에 대한 주의가 충분히 적혀 있는지 |
| 53 |
- 설치와 운영 문서가 GNUBoard5 관점과 독립형 관점을 모두 다루는지 |
69 |
- 설치와 운영 문서가 **그누보드5 · 라이믹스 · 스탠데얼론** 세 경로를 모두 다루는지 (워드프레스는 업로드 연동 어댑터로 별도) |
| 54 |
|
70 |
|
| 55 |
## 후속 권장 작업 |
71 |
## 후속 권장 작업 |
| 56 |
|
72 |
|
| 57 |
- 실제 운영 중인 프로젝트 구조에 맞는 커스텀 플러그인 문서를 추가 |
73 |
- 실제 운영 중인 프로젝트 구조에 맞는 커스텀 플러그인 문서를 추가 |
| 58 |
- 사용 중인 GNUBoard5 스킨별 충돌 메모 축적 |
74 |
- 사용 중인 GNUBoard5 스킨별 충돌 메모 축적 |
| 59 |
- 버전 업데이트가 나올 때마다 [`06-version-compatibility-guide.md`](06-version-compatibility-guide.md)와 [`72-version-issues-guide.md`](72-version-issues-guide.md) 재감사 |
75 |
- 버전 업데이트가 나올 때마다 [[06-version-compatibility-guide.md]]와 [[72-version-issues-guide.md]]를 재감사한다. *(본문 내부 링크는 `[[슬러그]]` 문법을 씁니다. `[x.md](x.md)` 마크다운 상대경로는 위키 엔진이 링크로 인식하지 않습니다 — [[80-internal-link-audit-report.md]] 참조.)* |
| 60 |
- AI/검색/ClipURL 대체 서버를 쓰는 경우 내부 API 문서를 별도 작성 |
76 |
- AI/검색/ClipURL 대체 서버를 쓰는 경우 내부 API 문서를 별도 작성 |
| 61 |
|
77 |
|
|
|
78 |
## 2026-09-28 통합관 감사 결과 |
|
|
79 |
|
|
|
80 |
| 교체 완료(11건) | 미착수(4건) | |
|
|
81 |
|---|---| |
|
|
82 |
| 00 · 01 · 02 · 03 · 04 · 05 · 06 · 07 · 08 · 71 · 72 · 80 | 73 · 74 · 75 · 76 · 77 · 78 중 미착수 항목 | |
|
|
83 |
|
|
|
84 |
신규 문서 4건: [[N-02-admin-console-guide.md]] · [[N-03-migration-v9-to-v10.md]] · [[N-05-cms-adapter-and-data-paths.md]] · [[N-06-server-sanitize-and-content-style.md]] |
|
|
85 |
|
|
|
86 |
**아직 하지 않은 것**: 73-external-reference-index(EOL 배포 페이지를 설치 정본으로 제시) · 74/75(존재하지 않는 `nsfw_api_server.php` 지시 잔존) · 76(`related_files`의 `plugin/ai`·`plugin/ai_rearrange`가 10.2.0에 통폐합된 경로) · 70(`license.txt` 백업 지시). 이 네 건은 다음 개정 대상이며, 99의 6번 작업이 만든 인덱스 문서이므로 **76·70을 먼저 손보면 오염 전파이 가장 큰 지점이 줄어듭니다.** |
|
|
87 |
|