image
Akan.js
한국어
문서컨벤션레퍼런스Cheatsheet
image
Akan.js
문서컨벤션레퍼런스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
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
이전
메트릭
다음
이미지 최적화

서버 캐싱

캐싱은 비용이 큰 작업 앞에 두는 작은 key-value 지름길입니다. 인증 코드, 카운터, 요약값, 계산된 옵션처럼 잠깐 재사용해도 되는 데이터에 사용하세요.
  • Document cache는 특정 model에 가깝습니다.
  • Service memory는 service 단위 상태나 공통 helper 값에 유용합니다.
  • Provider는 실행 모드에 따라 sqlite/libsql 또는 redis가 될 수 있습니다.

Document cache

캐시 값이 자연스럽게 특정 model에 속한다면 document layer에서 model cache를 사용하세요. namespace를 작게 유지하고 원본이 바뀌면 삭제하세요.
짧게 사는 코드 캐싱

Service memory

Service가 호출 사이에서 유지되는 작은 값이 필요하면 `memory()`를 사용합니다. 단일 값, map, local process memory로 쓸 수 있습니다.
Service 단위 cache

무엇을 쓸까?

  • Key가 model id라면 document cache를 사용하세요.
  • 값이 service workflow에 속한다면 service memory를 사용하세요.
  • Replica 사이에 공유될 필요가 없는 값에만 local memory를 사용하세요.

꿀팁

  • 처음에는 짧은 TTL을 선호하세요. 동작이 안정되면 늘려도 됩니다.
  • Cache key는 단순하게 만드세요. 보통 namespace와 id면 충분합니다.
  • 원본 데이터를 수정한 직후 cache를 삭제하거나 갱신하세요.
  • Cache를 원본으로 생각하지 마세요. 빠른 복사본일 뿐입니다.
서버 캐싱
Document cache
Service memory
무엇을 쓸까?
꿀팁