welsonjs

WelsonJS에 기여하기

English version

WelsonJS는 Windows의 내장 JavaScript 엔진을 기반으로 산업 현장에서 활용할 수 있는 JavaScript 실행 환경과 애플리케이션 프레임워크를 만드는 오픈소스 프로젝트입니다. COM, 데스크톱 애플리케이션, 파일, 프로세스, 선택적 .NET 구성 요소 등 Windows 기능을 JavaScript와 연결합니다.

많은 조직은 오랫동안 사용해 온 Windows 소프트웨어, 로컬 데이터, 데스크톱 업무 흐름과 연결 장비에 의존합니다. 이를 한 번에 교체하기 어려운 경우가 많습니다. WelsonJS는 경량 런타임과 재사용 가능한 모듈을 통해 기존 환경을 새로운 서비스와 도구에 연결하는 방법을 탐구합니다. 프로젝트의 중심은 현재 Windows이며, 다른 플랫폼에 대한 작업은 제공을 약속하는 기능이 아니라 탐구 단계입니다.

코드, 문제 보고, 재현 가능한 테스트 사례, 문서, 예제, 리뷰, 실험 등 크고 작은 기여를 환영합니다. 모든 분야의 경험이 필요한 것은 아닙니다. Windows, JavaScript 런타임, 업무·산업용 소프트웨어, 데스크톱 자동화 또는 현실적인 제약이 있는 시스템의 유지보수에 대한 관심이 도움이 됩니다.

목차

행동 강령

프로젝트 참여자는 WelsonJS 행동 강령을 따라야 합니다. 부적절한 행동은 abuse@catswords.net으로 알려 주세요.

프로젝트와 개발 환경

저장소에는 WSH 기반 런타임과 로더, lib/의 JavaScript 모듈, 예제, data/의 테스트 프로필, native/ 아래의 선택적 관리 코드가 포함되어 있습니다. 아키텍처와 기여 규칙은 AGENTS.md를 참고하고, 현재 동작은 관련 모듈과 프로젝트 파일을 확인해 주세요.

이 런타임은 범용 샌드박스가 아닙니다. 모듈은 COM, Windows API, 외부 프로그램, 원격 서비스 또는 선택적 관리 코드를 사용할 수 있습니다. 연동 기능을 제안하거나 테스트하기 전에 필요한 환경과 부작용을 확인해 주세요. Windows 기능, 설치된 소프트웨어, 인증 정보, 네트워크, 사용자 상호작용 또는 관리자 권한이 필요한 작업도 있습니다.

WelsonJS의 WSH 스크립트는 구형 JScript를 사용합니다. 루트 스크립트와 lib/의 코드는 대상 런타임과 호환되어야 합니다. 별도 런타임을 명시적으로 사용하는 파일이 아니라면 최신 JavaScript 문법이나 Node.js API를 사용할 수 있다고 가정하지 마세요.

질문하기

먼저 프로젝트 문서와 기존 이슈를 찾아보세요. 해결되지 않으면 이슈를 등록하고 관련 환경과 하려는 작업을 설명해 주세요. 질문에 영향을 주는 Windows, 런타임, 의존성 버전도 함께 적어 주세요.

버그 보고

이슈를 등록하기 전에 최신 버전에서도 재현되는지, 기존 이슈에 같은 문제가 보고되었는지 확인해 주세요. 다음 정보를 포함하면 문제를 파악하는 데 도움이 됩니다.

버그 보고 양식을 사용해 주세요. 인증 정보, 개인정보 또는 기타 민감한 내용을 포함하지 마세요.

기능 제안

제안 전에 기존 이슈와 문서를 검색해 주세요. 기능 제안에는 사용 사례, 현재 동작, 원하는 동작, 관련 대안이나 제약을 설명해 주세요. 새로운 운영체제, 장치, 프로토콜에 관한 아이디어라면 제안하는 방향과 이미 구현·검증된 기능을 구분해 주세요.

기여 방법

작은 버그 수정, 특정 Windows 버전에서의 동작 재현, 문서 개선, 예제 추가, 코드 리뷰부터 시작할 수 있습니다. 코드 변경은 다음 안내를 따라 주세요.

  1. 범위가 큰 변경은 먼저 관련 이슈를 찾아보거나 등록해 진행 중인 작업과 겹치지 않도록 합니다.
  2. 담당 모듈이나 프로젝트에 변경 범위를 한정합니다.
  3. 외부에 보이는 동작, 의존성, 권한, 부작용을 관련된 경우 문서화합니다.
  4. 변경 이유와 내용, 수행한 검증을 설명하고 필요한 경우 관련 이슈를 연결해 풀 리퀘스트를 제출합니다.

기여물을 제출하면 해당 기여물을 프로젝트의 적용 가능한 라이선스에 따라 제공할 권리가 있음을 확인하는 것입니다.

코드 및 테스트 안내

보안 문제 제보

취약점이나 민감한 보안 세부 정보를 공개 이슈에 올리지 마세요. 대신 abuse@catswords.re.kr으로 제보해 주세요.

개발자 지원 및 연락처

WelsonJS는 현재 정식 고용 형태의 참여를 제공하지 않습니다. 의미 있는 기여에 대해 버그 바운티나 다른 개발자 지원을 검토할 수 있지만, 가능 여부와 조건은 기여 내용 및 프로젝트 상황에 따라 달라집니다. 구체적인 제안은 oss@catswords.re.kr으로 문의해 주세요.

Discord, Microsoft Teams, ActivityPub에서도 프로젝트 커뮤니티를 만날 수 있습니다.