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.Unit.tsx
다음
service.dictionary.ts

Service module 개요

Service module은 feature, workflow, integration을 담는 folder입니다. document model에서 시작하지 않지만 server logic, typed API, client state, 때로는 UI까지 필요한 경우에 사용합니다.
Service module folder는 보통 underscore로 시작합니다. 내부 파일명에서는 underscore를 빼고 `_search`는 `search.service.ts`, `search.signal.ts`, `search.store.ts`, `Search.Zone.tsx`를 가집니다.

언제 사용하나

User, Story, Order처럼 business object가 중심이면 일반 module을 사용합니다. Search, security, local file, shared utility처럼 action이나 platform capability가 중심이면 service module을 사용합니다.
_security (libs/util/lib/_security)
암호화, JWT signing, token verification을 담당하는 server-only security workflow입니다.
_search (libs/util/lib/_search)
service method, endpoint, client store, admin Zone UI를 가진 search feature module입니다.
_localFile (libs/util/lib/_localFile)
typed endpoint를 통해 blob data를 읽는 shared file-access service입니다.

Service file map

Service module은 feature가 실제로 사용하는 파일만 필요합니다. model-backed module과 달리 constant, document, template, unit, view 파일을 기본으로 소유하지 않습니다.
search.service.ts
workflow 자체를 구현하고 runtime value나 다른 service를 주입받습니다.
search.signal.ts
workflow를 endpoint, internal task, cron, custom route signal로 노출합니다.
search.dictionary.ts
endpoint label, endpoint argument, service UI phrase의 문구를 정의합니다.
search.store.ts
service feature state, fetch call, loading flag, UI-facing action을 담당합니다.
Search.Util.tsx
재사용 가능한 service feature용 작은 client control을 묶습니다.
Search.Zone.tsx
admin page나 app page에 들어갈 service feature section을 조립합니다.

Folder shape

작게 시작하세요. server-only module은 service와 signal 파일만 있어도 됩니다. feature가 사용자나 관리자에게 보이기 시작하면 dictionary, store, Util, Zone을 추가합니다.
_search service module
Service module 개요
언제 사용하나
Service file map
Folder shape