Akan.js
Docs
Docs
Conventions
References
Cheatsheet
English
English
한국어
Akan.js
Akan.js v2 docs are now available.
View the v1 docs
Docs
Conventions
References
Cheatsheet
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스
Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자
bassman
일반
•
인증
•
스키마 설계
•
엣지 컴퓨팅
•
파일 관리
•
Single Sign-On
•
DataList & Enum
인터페이스
•
CRUD
•
Endpoint
•
Form
관측성
•
로깅
•
의존성 주입
•
에러 처리
•
메트릭
성능
•
캐싱
•
이미지 최적화
•
지연 로딩
•
쿼리
•
큐
•
실시간
개발
•
문서화
•
스크립트
•
도커
•
쿠버네티스
•
PWA
일반
•
인증
•
스키마 설계
•
엣지 컴퓨팅
•
파일 관리
•
Single Sign-On
•
DataList & Enum
인터페이스
•
CRUD
•
Endpoint
•
Form
관측성
•
로깅
•
의존성 주입
•
에러 처리
•
메트릭
성능
•
캐싱
•
이미지 최적화
•
지연 로딩
•
쿼리
•
큐
•
실시간
개발
•
문서화
•
스크립트
•
도커
•
쿠버네티스
•
PWA
Next
인증
의존성 주입
의존성 주입은 service가 필요한 것을 직접 만들지 않고 받아서 쓰는 방식입니다. 이렇게 하면 비즈니스 코드는 작아지고, 외부 시스템도 쉽게 교체할 수 있습니다.
`use`는 app 또는 library option에 등록한 값을 받습니다.
`adapt`와 `plug`는 storage, cache, message API처럼 교체 가능한 도구에 좋습니다.
`service`는 service끼리 연결합니다.
`env`는 런타임 설정을 모든 함수에 넘기지 않고 읽게 해줍니다.
use로 등록하기
`AkanOption.use()`는 글로벌 값을 준비하는 단순한 자리입니다. API client, 생성된 secret, host 값, 공통 설정을 여기에 둡니다.
Option에서 값 등록
Service에서 값 받기
adapt와 plug
도구가 동작을 가지고 있고 나중에 교체될 수 있다면 adaptor를 사용하세요. Service는 필요한 역할만 요청하면 됩니다.
Adaptor 선언
Service에 plug하기
Service 주입
한 service가 다른 service의 업무 method가 필요할 때 `service()`를 사용합니다. 직접 import해서 생성하는 것보다 흐름이 명확합니다.
Service끼리 연결
환경값 읽기
`env()`는 service가 app name, operation mode, hostname, feature flag 같은 런타임 정보를 알아야 할 때 유용합니다.
환경값 사용
꿀팁
외부 client를 method마다 만들지 마세요. `use` 또는 `adapt`로 한 번 등록하세요.
업무 협력은 `service()`, 교체 가능한 인프라는 `plug()`를 사용하세요.
가능하면 secret은 env/options에 두고 raw credential보다 준비된 client를 주입하세요.
여러 service가 공유하는 값은 보통 `AkanOption.use()`에 두는 것이 가장 깔끔합니다.
의존성 주입
use로 등록하기
adapt와 plug
Service 주입
환경값 읽기
꿀팁