image
Akan.js
한국어
문서컨벤션레퍼런스Cheatsheet
image
Akan.js
Akan.js v2 문서가 새로 나왔습니다.v1 문서 보기
문서컨벤션레퍼런스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
이전
scalar.document.ts
다음
Scalar.Unit.tsx

scalar.Template.tsx

scalar Template은 상위 domain form 안에서 scalar 값을 편집하기 위한 작은 재사용 form component입니다.
여러 상위 module이 같은 값 형태를 편집할 때 사용합니다. 예를 들어 Product, Order, Invoice가 모두 `Price.Template`을 재사용할 수 있습니다.

파일 형태

Template은 scalar 옆에 둡니다. input이 바뀔 때 value를 받고 `onChange`를 호출하므로 보통 client component입니다.

Scalar Template 예시

scalar Template은 `value`와 `onChange`를 받습니다. 데이터를 load하거나 상위 form을 submit하지 않고, scalar 값만 편집합니다.
price.Template.tsx

상위 form에서 사용

상위 module은 기존 form state를 그대로 유지합니다. embedded scalar 값을 scalar Template에 넘기고, 변경된 값은 generated setter로 저장합니다.
product.Template.tsx

Field 또는 custom UI

scalar input에 맞는 Field component가 있다면 사용합니다. scalar에 특별한 interaction이 필요하다면 일반 input, button 또는 app 전용 component를 사용해도 괜찮습니다.
예를 들어 `Address.Template`은 일반 text field를 사용하고, `Coordinate.Template`은 map picker를 사용할 수 있습니다.
scalar.Template.tsx
파일 형태
Scalar Template 예시
상위 form에서 사용
Field 또는 custom UI