본문으로 건너뛰기

실무 가이드

처음 확인할 위치​

신규 개발자는 HandStack 저장소를 다음 순서로 확인하는 것이 좋습니다.

  1. README.md에서 플랫폼의 목표와 전체 구조를 확인합니다.
  2. 1.WebHost/ack에서 실제 실행 호스트의 진입점을 확인합니다.
  3. 2.Modules에서 기본 모듈의 역할을 확인합니다.
  4. 3.Infrastructure에서 공통 기능과 확장 지점을 확인합니다.
  5. 4.Tool에서 운영과 배포에 쓰는 CLI 도구를 확인합니다.
  6. 루트의 env, install, build, publish 스크립트로 표준 작업 흐름을 확인합니다.

작업 기준​

HandStack 프로젝트에서 코드 변경은 다음 기준으로 관리합니다.

  • 호스트 변경: ack 실행, 포트, 모듈 로딩, 전역 설정과 관련된 변경입니다.
  • 모듈 변경: 특정 기능 모듈의 module.json, API, 계약, 정적 자산과 관련된 변경입니다.
  • 인프라 변경: 여러 모듈이 공유하는 타입, 확장 메서드, 데이터 처리 기능과 관련된 변경입니다.
  • 도구 변경: 빌드, 번들링, 배포 패키지, 업데이트, 포트 확인 같은 CLI 작업과 관련된 변경입니다.

업무 기능을 만들 때는 먼저 업무 모듈 안에서 해결하고, 여러 모듈이 반복해서 쓰는 기능일 때만 공통 영역으로 올립니다.

브랜치와 배포 추적​

배포된 산출물은 어떤 커밋에서 만들어졌는지 추적 가능해야 합니다. 최소한 다음 정보를 빌드 로그나 배포 기록에 남깁니다.

  • 저장소 URL 또는 저장소 이름
  • 브랜치와 커밋 ID
  • 빌드한 스크립트와 매개변수
  • 배포 환경
  • 배포한 사람 또는 자동화 Job

체크리스트​

  • 기능 코드와 서버 수동 수정이 분리되어 있지 않은가?
  • HandStack 코어 변경과 업무 모듈 변경의 책임이 명확한가?
  • 배포 산출물이 표준 스크립트로 재현 가능한가?
  • 신규 개발자가 저장소만 보고 실행 구조를 따라갈 수 있는가?
  • 업무 모듈의 계약, 화면, 서버 기능이 같은 코드베이스 기준으로 관리되는가?