iStack

시작하기

처음 실행하기

마크다운으로 보기 ChatGPT 에서 열기 Claude 에서 열기

필요한 도구를 갖추고 인프라 · 개발 서버 · 테스트를 처음 실행합니다.

처음 실행하기

서버 셋(notes · tags · activity)과 gateway, web 앱으로 시작합니다. 메모를 저장할 때 notes 가 tags 에 태그를 묻고 activity 에 기록을 남기므로 서버 셋이 함께 뜨고, 앱은 gateway 하나로 서버를 부릅니다. 필요한 도구는 Node · pnpm · Docker · Java 25(activity) · uv(tags) · Go(gateway)이고, desktop 은 Rust 가 더 필요합니다. 버전은 레퍼런스 · 개발 → 명령에 있습니다.

최소 구성으로 시작하기

템플릿으로 만든 새 학습용 저장소에서 실행합니다. drop 은 지정한 예시 폴더와 연결 설정을 지우므로, 이미 그 안에 작업한 코드가 있다면 먼저 변경을 보관하거나 아래의 ‘전체 예시를 유지할 때’를 따릅니다.

node scripts/drop.mjs admin site lite mobile desktop
pnpm install
pnpm dev      # Postgres(docker) → 서버 셋 + gateway + web 앱, http://localhost:5280

처음에는 삭제 스크립트를 node 로 직접 실행하므로 다른 예시의 의존성을 설치하기 전에 줄일 수 있습니다. 서버는 빼지 않습니다. tags · activity 는 notes 가, 서버 셋은 gateway 가 부르므로 drop 이 멈춥니다.

화면에서 내일 회의 라는 메모를 만들면 회의 태그가 붙습니다. notes 가 tags 서버에 물어 받은 태그입니다. 새로 고침한 뒤에도 남는지, 삭제하면 목록에서 없어지는지 확인합니다.

pnpm dev 를 둔 채 다른 터미널에서 다음을 실행합니다.

pnpm test       # 서버 셋의 HTTP · gRPC 테스트
pnpm typecheck  # 계약 생성 + 남은 패키지의 타입 검사
pnpm lint

테스트 이름과 성공 결과가 나오고, 타입 검사 · lint 가 종료 코드 0 으로 끝나면 첫 실행이 끝난 것입니다. 테스트는 서버마다 <서버>_test DB 와 랜덤 포트를 써서 개발 화면의 메모를 지우지 않습니다. notes 의 테스트는 tags · activity 를 띄우지 않고 Fake 로 바꿉니다.

pnpm dev · pnpm test 는 먼저 pnpm infra(docker 의 Postgres)를 띄웁니다. 개발 서버는 터미널에서 Ctrl+C, Postgres 는 pnpm infra:down 으로 끕니다. DB 볼륨은 남아 있으므로 다음 실행에도 메모가 유지됩니다.

전체 예시를 유지할 때

drop 을 실행하지 않고 pnpm install 을 실행합니다. 기본 pnpm dev 는 그대로 서버 셋 + gateway + web 을 띄웁니다. 관리 화면은 pnpm --filter @app/admin dev → http://localhost:5281 에서 태그 규칙을 바꾸고 활동 기록을 봅니다.

서버 하나만 확인하려면 pnpm infra 다음 pnpm --filter @app/notes test 처럼 실행합니다. 다른 서버 · 앱도 pnpm --filter @app/<패키지> <스크립트> 로 고릅니다(예: @app/activity dev).

이미지로 실행하기

첫 테스트가 통과한 뒤 pnpm stack 으로 남은 서버 · 웹 앱의 이미지를 빌드하고 smoke 를 실행합니다. smoke 는 메모 하나로 notes → tags · activity 가 실제 이미지끼리 이어지는지 봅니다. 개발 서버와 기본 포트가 같으므로 자신이 띄운 pnpm dev 를 먼저 종료하거나, 포트 설정으로 구분합니다. 끄려면 pnpm stack:down 입니다.

포트와 환경 변수는 레퍼런스 · 개발 → 포트에 있습니다.

다음

GitHub 에서 고치기