리비전 비교 · 기존 기능 수정 가이드

🔐로그인하면 문서 작성, 프로젝트 게시, ZIP 기반 버전 업로드, 브랜치 생성 기능을 사용할 수 있습니다. 로그인하러 가기

기존 기능 수정 가이드

리비전 비교

⎇ main ← 이력

추가 0줄 삭제 0줄 변경 0줄 동일 57줄

r1 파일 가져오기: 62-existing-feature-modification-guide.md

2026-04-17 14:54

기능 수정 절차

영향 범위 파악: 수정하려는 기능이 호출되는 위치와 의존하는 모듈을 파악합니다.
백업: 수정 전에 현재 코드를 백업하고 버전 관리 시스템에서 브랜치를 생성합니다.
수정 및 테스트: 작은 단위로 코드를 변경하고, 각 변경 후 즉시 테스트하여 회귀 버그를 방지합니다.

리팩터링 시 주의사항

코어 함수의 이름을 변경하거나 파라미터를 수정하면 다른 플러그인과 호출 관계가 끊어질 수 있습니다. 항상 호출 그래프를 확인하고 필요한 곳을 함께 수정하세요.

수정 작업의 우선순위

기존 기능을 수정할 때 가장 먼저 할 일은 “버그 수정”, “동작 변경”, “UI 개선”을 분리하는 것입니다. 세 종류를 한 번에 섞으면 회귀 원인을 찾기 어렵습니다. 가능한 한 기능 수정과 스타일 수정은 커밋도, 배포도 분리하는 편이 안전합니다.

추천 검수 루프

수정 전 화면 캡처 → 관련 문서 확인 → 코드 수정 → 단일 기능 테스트 → 보기 화면 확인 → 모바일 확인 → 운영 반영 순서로 작업하면 실수를 줄일 수 있습니다.

문서 갱신 규칙

기존 기능을 수정했다면 코드 커밋만 남기지 말고 관련 문서의 변경점도 함께 기록해야 합니다. 특히 설정 위치가 바뀌거나 테스트 포인트가 달라졌다면, 운영자 문서와 개발자 문서를 동시에 갱신하는 것이 좋습니다.

r1 파일 가져오기: 62-existing-feature-modification-guide.md

2026-04-17 14:54

기능 수정 절차

영향 범위 파악: 수정하려는 기능이 호출되는 위치와 의존하는 모듈을 파악합니다.
백업: 수정 전에 현재 코드를 백업하고 버전 관리 시스템에서 브랜치를 생성합니다.
수정 및 테스트: 작은 단위로 코드를 변경하고, 각 변경 후 즉시 테스트하여 회귀 버그를 방지합니다.

리팩터링 시 주의사항

코어 함수의 이름을 변경하거나 파라미터를 수정하면 다른 플러그인과 호출 관계가 끊어질 수 있습니다. 항상 호출 그래프를 확인하고 필요한 곳을 함께 수정하세요.

수정 작업의 우선순위

기존 기능을 수정할 때 가장 먼저 할 일은 “버그 수정”, “동작 변경”, “UI 개선”을 분리하는 것입니다. 세 종류를 한 번에 섞으면 회귀 원인을 찾기 어렵습니다. 가능한 한 기능 수정과 스타일 수정은 커밋도, 배포도 분리하는 편이 안전합니다.

추천 검수 루프

수정 전 화면 캡처 → 관련 문서 확인 → 코드 수정 → 단일 기능 테스트 → 보기 화면 확인 → 모바일 확인 → 운영 반영 순서로 작업하면 실수를 줄일 수 있습니다.

문서 갱신 규칙

기존 기능을 수정했다면 코드 커밋만 남기지 말고 관련 문서의 변경점도 함께 기록해야 합니다. 특히 설정 위치가 바뀌거나 테스트 포인트가 달라졌다면, 운영자 문서와 개발자 문서를 동시에 갱신하는 것이 좋습니다.

라인 단위 비교

이전		새 버전
1	---	1	---
2	title: 기존 기능 수정 가이드	2	title: 기존 기능 수정 가이드
3	document_id: 62-existing-feature-modification-guide	3	document_id: 62-existing-feature-modification-guide
4	slug: 62-existing-feature-modification-guide	4	slug: 62-existing-feature-modification-guide
5	target_editor_version: 9.0.0	5	target_editor_version: 9.0.0
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: Medium	10	dependency: Medium
11	core_type: Maintenance	11	core_type: Maintenance
12	stability: [Version-Bound]	12	stability: [Version-Bound]
13	stable_anchor: []	13	stable_anchor: []
14	version_bound: []	14	version_bound: []
15	related_docs: []	15	related_docs: []
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: 22	22	reading_order: 22
23	summary: 기존 기능을 안전하게 수정하는 절차와 고려사항을 설명 문서	23	summary: 기존 기능을 안전하게 수정하는 절차와 고려사항을 설명 문서
24	description: 기존 기능을 안전하게 수정하는 절차와 고려사항을 설명	24	description: 기존 기능을 안전하게 수정하는 절차와 고려사항을 설명
25	tags: [modification, maintenance, guide]	25	tags: [modification, maintenance, guide]
26	version_tag: 9.0.0	26	version_tag: 9.0.0
27	maintenance_difficulty: Medium	27	maintenance_difficulty: Medium
28	test_requirement: Medium	28	test_requirement: Medium
29	ai_agent_risk: Medium	29	ai_agent_risk: Medium
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	1. 영향 범위 파악: 수정하려는 기능이 호출되는 위치와 의존하는 모듈을 파악합니다.	37	1. 영향 범위 파악: 수정하려는 기능이 호출되는 위치와 의존하는 모듈을 파악합니다.
38	2. 백업: 수정 전에 현재 코드를 백업하고 버전 관리 시스템에서 브랜치를 생성합니다.	38	2. 백업: 수정 전에 현재 코드를 백업하고 버전 관리 시스템에서 브랜치를 생성합니다.
39	3. 수정 및 테스트: 작은 단위로 코드를 변경하고, 각 변경 후 즉시 테스트하여 회귀 버그를 방지합니다.	39	3. 수정 및 테스트: 작은 단위로 코드를 변경하고, 각 변경 후 즉시 테스트하여 회귀 버그를 방지합니다.
40		40
41	### 리팩터링 시 주의사항	41	### 리팩터링 시 주의사항
42		42
43	코어 함수의 이름을 변경하거나 파라미터를 수정하면 다른 플러그인과 호출 관계가 끊어질 수 있습니다. 항상 호출 그래프를 확인하고 필요한 곳을 함께 수정하세요.	43	코어 함수의 이름을 변경하거나 파라미터를 수정하면 다른 플러그인과 호출 관계가 끊어질 수 있습니다. 항상 호출 그래프를 확인하고 필요한 곳을 함께 수정하세요.
44		44
45	## 수정 작업의 우선순위	45	## 수정 작업의 우선순위
46		46
47	기존 기능을 수정할 때 가장 먼저 할 일은 “버그 수정”, “동작 변경”, “UI 개선”을 분리하는 것입니다. 세 종류를 한 번에 섞으면 회귀 원인을 찾기 어렵습니다. 가능한 한 기능 수정과 스타일 수정은 커밋도, 배포도 분리하는 편이 안전합니다.	47	기존 기능을 수정할 때 가장 먼저 할 일은 “버그 수정”, “동작 변경”, “UI 개선”을 분리하는 것입니다. 세 종류를 한 번에 섞으면 회귀 원인을 찾기 어렵습니다. 가능한 한 기능 수정과 스타일 수정은 커밋도, 배포도 분리하는 편이 안전합니다.
48		48
49	## 추천 검수 루프	49	## 추천 검수 루프
50		50
51	수정 전 화면 캡처 → 관련 문서 확인 → 코드 수정 → 단일 기능 테스트 → 보기 화면 확인 → 모바일 확인 → 운영 반영 순서로 작업하면 실수를 줄일 수 있습니다.	51	수정 전 화면 캡처 → 관련 문서 확인 → 코드 수정 → 단일 기능 테스트 → 보기 화면 확인 → 모바일 확인 → 운영 반영 순서로 작업하면 실수를 줄일 수 있습니다.
52		52
53		53
54	## 문서 갱신 규칙	54	## 문서 갱신 규칙
55		55
56	기존 기능을 수정했다면 코드 커밋만 남기지 말고 관련 문서의 변경점도 함께 기록해야 합니다. 특히 설정 위치가 바뀌거나 테스트 포인트가 달라졌다면, 운영자 문서와 개발자 문서를 동시에 갱신하는 것이 좋습니다.	56	기존 기능을 수정했다면 코드 커밋만 남기지 말고 관련 문서의 변경점도 함께 기록해야 합니다. 특히 설정 위치가 바뀌거나 테스트 포인트가 달라졌다면, 운영자 문서와 개발자 문서를 동시에 갱신하는 것이 좋습니다.
57		57