Akan.js
English
English
한국어
Docs
Conventions
References
Cheatsheet
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
워크스페이스 규칙
•
구조
•
포맷 & 린트
앱 & 라이브러리 규칙
•
애셋 (public/ private/)
•
컴포넌트 (ui/)
•
서버 유틸리티 (srvkit/)
•
웹 유틸리티 (webkit/)
•
공통 유틸리티 (common/)
•
akan.config.ts
도메인 규칙
•
개요
•
model.constant.ts
•
model.dictionary.ts
•
model.document.ts
•
model.service.ts
•
model.signal.ts
•
model.store.ts
•
Model.Template.tsx
•
Model.Unit.tsx
•
Model.Util.tsx
•
Model.View.tsx
•
Model.Zone.tsx
스칼라 규칙
•
개요
•
scalar.constant.ts
•
scalar.dictionary.ts
•
scalar.document.ts
•
Scalar.Template.tsx
•
Scalar.Unit.tsx
서비스 규칙
•
개요
•
service.dictionary.ts
•
service.service.ts
•
service.signal.ts
•
service.store.ts
•
Service.Util.tsx
•
Service.Zone.tsx
워크스페이스 규칙
•
구조
•
포맷 & 린트
앱 & 라이브러리 규칙
•
애셋 (public/ private/)
•
컴포넌트 (ui/)
•
서버 유틸리티 (srvkit/)
•
웹 유틸리티 (webkit/)
•
공통 유틸리티 (common/)
•
akan.config.ts
도메인 규칙
•
개요
•
model.constant.ts
•
model.dictionary.ts
•
model.document.ts
•
model.service.ts
•
model.signal.ts
•
model.store.ts
•
Model.Template.tsx
•
Model.Unit.tsx
•
Model.Util.tsx
•
Model.View.tsx
•
Model.Zone.tsx
스칼라 규칙
•
개요
•
scalar.constant.ts
•
scalar.dictionary.ts
•
scalar.document.ts
•
Scalar.Template.tsx
•
Scalar.Unit.tsx
서비스 규칙
•
개요
•
service.dictionary.ts
•
service.service.ts
•
service.signal.ts
•
service.store.ts
•
Service.Util.tsx
•
Service.Zone.tsx
Next
구조
scalar.constant.ts
scalar constant는 작고 재사용 가능한 값의 형태를 정의합니다. service, signal, store 파일을 읽지 않아도 이해할 수 있을 만큼 단순해야 합니다.
대부분의 scalar constant에는 `via()`, `field()`, optional default, 때로는 작은 enum 정도만 필요합니다.
기본 형태
`via((field) => ({ ... }))`를 사용하고 각 값을 `field(Type)`으로 설명합니다. class 이름은 이 값을 사용하는 상위 model이 아니라 비즈니스 값 자체를 설명해야 합니다.
price.constant.ts
Default와 optional
값이 안정적인 초기 상태를 가져야 하면 default를 추가합니다. 상위 model이 해당 field 없이도 존재할 수 있다면 `.optional()`을 사용합니다.
`currency`는 `KRW`처럼 일반적인 비즈니스 값으로 default를 둘 수 있습니다.
모든 price에 note가 필요한 것은 아니므로 `memo`는 optional일 수 있습니다.
price.constant.ts
Array field
scalar가 자연스럽게 반복 값을 포함한다면 array field를 사용합니다. 예시는 작게 유지합니다. contact info 값은 여러 email을 가질 수 있습니다.
contactInfo.constant.ts
Enum field
field가 고정된 값 중 하나만 허용해야 한다면 `enumOf()`를 사용합니다. enum name string은 dictionary 파일에서도 사용하므로 짧고 안정적으로 유지합니다.
price.constant.ts
작은 helper
동작이 값 자체에 속한다면 constant에 작은 순수 helper를 둘 수 있습니다. server request, database call, external service와는 독립적으로 유지합니다.
price.constant.ts
scalar.constant.ts
기본 형태
Default와 optional
Array field
Enum field
작은 helper
