image
Akan.js
English
DocsConventionsReferencesCheatsheet
image
Akan.js
Akan.js v2 docs are now available.View the v1 docs
DocsConventionsReferencesCheatsheet
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
구조

Model.View.tsx

View 파일은 full-model detail UI를 렌더링합니다. 보통 server에서 full view data를 받은 detail page나 Zone wrapper에서 사용합니다.
View component는 presentation component입니다. Unit, Util, Zone, local subcomponent를 조합할 수 있지만 mutation과 business decision은 View 밖에 둡니다.

View vs Unit

핵심 차이는 data 크기와 page 역할입니다. View는 full detail에, Unit은 반복되는 summary UI에 사용합니다.
Comparison설명예제
Model.Viewfull model을 렌더링합니다. 본문, history, log, nested data가 필요한 상세 page나 section에 사용합니다.
Model.Unitlight model을 렌더링합니다. list row, card, table item, compact summary에 사용합니다.
Model.View

full model을 렌더링합니다. 본문, history, log, nested data가 필요한 상세 page나 section에 사용합니다.

Model.Unit

light model을 렌더링합니다. list row, card, table item, compact summary에 사용합니다.

표준 View 형태

표준 View는 General을 export하고 className과 full model prop을 받은 뒤 dictionary label로 field name과 status를 표시합니다.
Ticket.View.tsx

Full model detail 패턴

View는 light summary shape가 아니라 constant의 full model shape를 받기 때문에 full model에 정의된 모든 field를 렌더링할 수 있습니다.
Article.View.tsx
Order.View.tsx

Page에서 View 사용하기

server page는 보통 full view data를 fetch한 뒤 view object를 Zone wrapper 또는 Load.View에 전달합니다.
detail page

Load.View와 store hydration

Load.View는 server에서 받은 full model data를 client store에 안전하게 hydrate합니다. View를 렌더링하기 전에 model, loading state, modal state, view timestamp를 설정합니다.
server에서 fetch한 view data를 client Zone, tab layout, reusable section 안에서 렌더링할 때 이 wrapper를 사용합니다.
field설명예제
<model>server view object에서 받은 hydrated full model instance를 저장합니다.
<model>Loadingfull model이 준비되었음을 표시해서 View가 loading UI 없이 렌더링될 수 있게 합니다.
<model>Modal현재 model state를 view mode로 표시합니다. 다른 model wrapper가 view/edit/new 흐름을 구분할 수 있습니다.
<model>ViewAtserver view timestamp를 저장해서 Load.View가 더 최신인 client state를 오래된 view data로 덮어쓰지 않도록 합니다.
<model>

server view object에서 받은 hydrated full model instance를 저장합니다.

<model>Loading

full model이 준비되었음을 표시해서 View가 loading UI 없이 렌더링될 수 있게 합니다.

<model>Modal

현재 model state를 view mode로 표시합니다. 다른 model wrapper가 view/edit/new 흐름을 구분할 수 있습니다.

<model>ViewAt

server view timestamp를 저장해서 Load.View가 더 최신인 client state를 오래된 view data로 덮어쓰지 않도록 합니다.

Release.Zone.tsx

실전 규칙

View component는 full model prop을 받습니다. light list 또는 card summary에는 Unit을 사용합니다.
field name, status, heading에는 dictionary label을 사용합니다.
큰 View는 하나의 거대한 General component가 아니라 named section component로 나눕니다.
mutation은 Util, Store, Signal, Service에 둡니다. View는 현재 full model을 렌더링하는 데 집중합니다.
server-fetched view data를 client store state에 hydrate해야 하면 Load.View를 사용합니다.
Model.View.tsx
View vs Unit
표준 View 형태
Full model detail 패턴
Page에서 View 사용하기
Load.View와 store hydration
실전 규칙