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
인증

큐 작업

큐 작업은 사용자 요청을 막으면 안 되는 일을 처리할 때 씁니다. 버튼 요청은 빠르게 끝나고, 무거운 작업은 백그라운드 process가 수행합니다.
  • 백업, export, report 생성, import, 긴 AI 작업에 좋습니다.
  • Endpoint는 사용자의 의도를 기록하고 process를 queue에 넣습니다.
  • Process는 느린 작업을 request 경로 밖에서 수행합니다.

Endpoint에서 queue 넣기

Endpoint는 짧게 유지하세요. Job 상태를 waiting으로 바꾸고 internal process에게 나중에 실행하라고 요청합니다.
Report 생성 queue
Service에서 process 호출

Process에서 실행

Internal process가 느린 작업을 담당합니다. 진행률을 갱신하고, 파일을 업로드하고, job을 done 또는 failed로 표시할 수 있습니다.
Internal process
느린 작업

Replica 역할

Akan은 역할이 있는 child replica를 실행할 수 있습니다. `federation`은 사용자 요청을 처리하고, `batch`는 백그라운드 작업을 맡을 수 있습니다. 그래서 느린 작업이 request 서버를 소모하는 일을 줄입니다.

꿀팁

  • 항상 job 상태를 저장하세요. `waiting`, `running`, `done`, `failed`처럼요.
  • Job은 idempotent하게 만드세요. 같은 job을 다시 실행해도 데이터가 깨지면 안 됩니다.
  • 사용자에게 진행 상황을 보여줘야 한다면 progress를 저장하세요.
  • Endpoint는 빠르게 반환하고, 느린 작업은 process에서 하세요.
큐 작업
Endpoint에서 queue 넣기
Process에서 실행
Replica 역할
꿀팁
Batch child 이전
Batch child 이후