Akan.js
English
English
한국어
Docs
Conventions
References
Cheatsheet
Akan.js
Docs
Conventions
References
Cheatsheet
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
꿀팁