소프트웨어 개발 수명주기 정책

최종 업데이트: 2026년 3월 25일

관리: Rockxy 오픈소스 프로젝트

소개

이 문서는 Rockxy 프로젝트의 소프트웨어 개발 방식을 정리한 문서예요. 오픈소스 macOS 개발자 도구로서 품질·보안·투명성에 높은 기준을 유지해요. 모든 코드는 공개 감사할 수 있고, 개발 프로세스 역시 그 개방성을 반영해요.

적용 범위

본 정책은 메인 애플리케이션, 헬퍼 도구, 빌드 인프라, 본 웹사이트를 포함해 Rockxy 프로젝트 내 모든 개발 작업에 적용돼요. 초기 기획부터 지속적 유지 관리까지 수명주기 전반을 다뤄요.

기본 원칙

  • 품질 — 신뢰성·성능·테스트 커버리지가 확보된 소프트웨어를 제공해요. 모든 릴리스는 사용자에게 도달하기 전에 자동·수동 QA를 거쳐요.
  • 보안 — 보안은 모든 단계에 내재돼 있어요. Rockxy는 민감한 네트워크 트래픽을 다루므로 책임을 진지하게 받아들여요. 텔레메트리·데이터 수집 없음, 정기적인 의존성 감사를 수행해요.
  • 투명성 — 소스 코드가 공개되어 있고, 이슈 트래커도 공개돼요. 아키텍처·우선순위·트레이드오프에 대한 결정은 공개적으로 문서화돼요.
  • 커뮤니티 — 커뮤니티의 기여가 Rockxy를 앞으로 나아가게 해요. 명확한 기여 가이드라인, 빠른 코드 리뷰, 접근하기 쉬운 개발 환경을 유지해요.

SDLC 단계

1. 구상과 스코핑

신규 기능이나 개선은 GitHub Issues와 커뮤니티 디스커션을 통해 제안돼요. 사용자 영향, 기술적 실현 가능성, 프로젝트 로드맵과의 정합성에 따라 제안을 평가하고 리소스를 배정해요.

2. 계획과 아키텍처

승인된 제안은 설계 단계로 넘어가서 시스템 아키텍처 정의, 의존성 식별, 리스크 평가, 수용 기준 수립을 진행해요. 중요한 변경은 저장소에 아키텍처 결정 기록(ADR)으로 남겨요.

3. 개발

모든 코드는 피처 브랜치에서 개발되고, Pull Request로 제출돼요. 모든 PR은 머지 전에 코드 리뷰를 거쳐요. Swift·SwiftUI 규약을 따르고, 의미 있는 커밋 메시지를 쓰며, 변경을 리뷰하기 쉬운 단위로 쪼개요.

4. 품질 보증과 테스트

유닛 테스트, 통합 테스트, 수동 QA 체크리스트를 유지해요. 보안에 민감한 코드(TLS 인터셉션, 인증서 관리, 프록시 설정)는 추가 검토를 받아요. 모든 릴리스 전에 지원 macOS 버전에서 테스트해요.

5. 배포와 릴리스

릴리스는 시맨틱 버저닝을 따라요. 각 릴리스에는 변경 이력 항목, 서명된 빌드, 프로젝트 공식 채널을 통한 배포가 포함돼요. 재현 가능한 빌드를 보장하기 위해 자동 빌드 파이프라인을 사용해요.

6. 유지 관리와 진화

릴리스 후에는 커뮤니티 피드백을 모니터링하고, 버그 리포트를 트리아지하며, 필요하면 패치를 릴리스해요. 의존성은 정기적으로 업데이트하고, 모든 서드파티 패키지의 업스트림 보안 권고를 추적해요.

팀과 커뮤니티의 역학

  • 코어 메인테이너 — 아키텍처 결정, 릴리스 관리, 프로젝트의 장기 방향에 책임을 져요.
  • 기여자 — 코드·문서·번역·버그 리포트를 제출하는 커뮤니티 구성원이에요. 모든 기여는 표준 PR 리뷰 프로세스를 거쳐요.
  • 사용자 — 피드백 제공, 이슈 보고, 기능 검증을 수행해요. 사용자의 의견이 로드맵을 직접 형성해요.

문서화와 지식 공유

여러 층위에서 문서를 유지해요:

  • 자명하지 않은 구현 세부에 대한 인라인 코드 주석
  • 주요 설계 결정에 대한 아키텍처 결정 기록(ADR)
  • 사용자용 문서와 설치 가이드
  • 저장소 내 기여 가이드라인과 코딩 규약
  • 기술적 심화 내용을 다루는 엔지니어링 블로그 글

컴플라이언스와 리스크 관리

안전한 소프트웨어 개발을 위한 업계 베스트 프랙티스를 따르고 있어요. 정기적인 의존성 감사, 코드 서명, 샌드박스 빌드로 공급망 리스크를 줄여요. Rockxy는 사용자 데이터를 수집하지 않으므로 규제 컴플라이언스가 단순해요. 보안 취약점은 보안 정책을 통해 보고할 수 있어요.

지속적 개선

  • 프로세스 개선을 찾기 위한 릴리스 후 회고
  • 도구·의존성·빌드 인프라의 정기 리뷰
  • 개발 프로세스에 통합된 커뮤니티 피드백
  • 블로그 글·공개 디스커션을 통한 지식 공유

본 정책의 변경

본 정책의 개정은 GitHub Rockxy 소스 저장소에서 버전 관리돼요. 상단의 "최종 업데이트" 일자는 가장 최근 개정을 반영해요. 주요 변경은 프로젝트 변경 이력에 기재돼요.

문의

본 정책이나 개발 프로세스에 대한 질문은 GitHub에서 이슈로 제기해 주세요.