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
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
이전
Single Sign-On
다음
CRUD

DataList & Enum

Enum과 DataList는 Akan에서 자주 보게 되는 작은 도구입니다. Enum은 정해진 값 목록에 쓰고, DataList는 id가 있는 목록에 씁니다.
  • Enum: 상태, 역할, 종류, 카테고리.
  • DataList: 사용자 목록, 파일 목록, 게시글 목록, 선택된 row.

Enum

값이 몇 가지 선택지 중 하나여야 한다면 Enum을 사용합니다. form, API, label을 일관되게 유지할 수 있습니다.
정해진 값
UI에서 값 사용

DataList

이미 불러온 목록을 id 기준으로 다루고 싶다면 DataList를 사용합니다. UI 상태에서 항목을 추가, 교체, 선택, 필터링하기 편합니다.
  • `set(item)`: 항목을 추가하거나 교체합니다.
  • `pick(id)`: id로 항목 하나를 가져옵니다.
  • `filter(fn)`: 더 작은 DataList를 만듭니다.
id 기준 목록

언제 쓰나

  • 값이 label 성격이라면 Enum을 사용하세요. 예: 상태, 역할, 종류, 크기, 공개 범위.
  • 데이터가 id를 가진 record들의 모음이라면 DataList를 사용하세요.
  • DataList를 DB query처럼 사용하지 마세요. 이미 앱에 불러온 데이터를 다루는 도구입니다.

꿀팁

  • dictionary와 schema가 참조할 수 있으므로 enum의 `refName`은 안정적으로 유지하세요.
  • DataList 항목은 작게 유지하세요. 목록에서 쓰는 light model과 잘 맞습니다.
  • 간단히 기억하세요. 값 선택지는 Enum, id 목록은 DataList입니다.
DataList & Enum
Enum
DataList
언제 쓰나
꿀팁