docs: add development principles
Kim committed
Nov 4, 2025 at 09:57 UTC
5f3747943c698992fa88551c7e9502a8ea9fde02
1 file changed
+42
docs/development.md
new
+42
@@ -0,0 +1,42 @@
1
+# 개발 원칙 및 운영 가이드
2
+
3
+이 문서는 Portal 프로젝트의 핵심 방향과 범위를 명확히 정의하여 불필요한 기능 추가나 방향 이탈을 방지하고, 일관된 사용자 경험을 유지하기 위한 목적을 갖습니다.
4
+
5
+---
6
+
7
+## 1. 사용성 불변 원칙
8
+Portal 개발자는 자신이 구현한 기능이 기존 사용성에 변화를 주지 않도록 해야 합니다. 여기서 사용성의 변화란 다음을 모두 포함합니다.
9
+
10
+- Portal 사용 과정의 변경
11
+- Portal 배포 방식의 변경
12
+- SDK 개발 환경의 변경
13
+- 코드베이스의 복잡성 증가
14
+- 그 외
15
+
16
+---
17
+
18
+## 2. 변경 시 사전 합의 절차
19
+기능 개발이 사용성에 변화를 줄 경우, 변경 전 구성원에게 문서를 통해 변경 사유를 충분히 설명하고 사전 동의를 구해야 합니다.
20
+
21
+- 기능 변경에 한해, 제안자를 제외한 1명 이상의 리뷰어 동의가 있을 때만 머지할 수 있습니다.
22
+
23
+---
24
+
25
+## 3. 테스트 및 품질 보증
26
+Portal 개발자는 완성되지 않은 실험적 기능을 마스터 브랜치에 직접 반영해서는 안 됩니다. 모든 신규 기능은 개인 브랜치에서 충분한 테스트와 검증을 마친 후에만 머지할 수 있습니다.
27
+
28
+---
29
+
30
+## 4. 프로젝트의 철학과 범위
31
+Portal은 개인이 로컬에서 실행하는 서비스를 세상에 공개하기 위한 중계 계층이며, End-to-End Encryption 을 제공합니다. 그 외의 목표는 현재 단계에서 다루지 않습니다.
32
+
33
+- 기능 추가를 제안할 경우 위와 마찬가지로 구성원에게 충분한 설명과 합의가 필요합니다.
34
+- 합의된 기능은 추후 로드맵에 반영하여 관리합니다.
35
+
36
+---
37
+
38
+## 5. 의견 충돌 시 원칙
39
+상기 내용과 관련해 개발자 간 의견 차이가 발생할 경우,
40
+건전한 토론을 통해 합의점을 도출합니다.
41
+
42
+---
\ No newline at end of file