image
Akan.js
English
DocsConventionsReferencesCheatsheet
image
Akan.js
DocsConventionsReferencesCheatsheet
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자bassman
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
일반
• 인증
• 스키마 설계
• 엣지 컴퓨팅
• 파일 관리
• Single Sign-On
• DataList & Enum
인터페이스
• CRUD
• Endpoint
• Form
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
Next
인증

Scripts

`akan script`는 seed data, migration, 점검, 작은 유지보수 수정 같은 일회성 개발/운영 작업에 사용합니다.
  • Script는 일반 web page를 열지 않고 app server container를 시작합니다.
  • App이 이미 연결해 둔 service, signal, adaptor를 재사용할 수 있습니다.
  • 각 script는 작게 유지하고 작업이 끝나면 지우기 쉽게 만드세요.

명령어

Script는 `apps/myapp/script` 아래에 둡니다. 파일명이 command target이 됩니다.
Script 실행

Server lifecycle

Server를 시작하고 작업한 뒤 `finally`에서 반드시 종료하세요. 그래야 database connection, timer, adaptor가 올바르게 정리됩니다.
apps/myapp/script/hello.ts

Service 사용

대부분의 유지보수 작업은 service를 호출하는 방식이 좋습니다. Service는 domain rule, database access, 다른 의존성을 이미 알고 있습니다.
데이터 조회와 수정

Lookup helper

  • `server.get(ArticleService)`: class 기반 조회로 type이 잘 잡힙니다.
  • `server.getService("article")`: refName 기반 service 조회입니다.
  • `server.getSignal("article")`: signal logic을 호출하고 싶을 때 사용합니다.
  • `server.getAdaptor("storage")`: infrastructure 작업에서 adaptor를 조회할 때 사용합니다.

꿀팁

  • 데이터를 변경하기 전에 대상 environment를 출력하세요.
  • 파괴적인 script에는 confirm flag나 dry-run mode를 추가하세요.
  • Domain rule이 한곳에 남도록 직접 database를 쓰기보다 service method를 우선 사용하세요.
Scripts
명령어
Server lifecycle
Service 사용
Lookup helper
꿀팁