image
Akan.js
English
DocsConventionsReferencesCheatsheet
image
Akan.js
DocsConventionsReferencesCheatsheet
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
관측성
• 로깅
• 의존성 주입
• 에러 처리
• 메트릭
성능
• 캐싱
• 이미지 최적화
• 지연 로딩
• 쿼리
• 큐
• 실시간
개발
• 문서화
• 스크립트
• 도커
• 쿠버네티스
Next
인증

Endpoint action

CRUD는 기본 동작을 처리합니다. Endpoint는 발행, 승인, 거절, 보관, 알림 발송처럼 분명한 업무 동작 하나를 만들 때 사용합니다.
좋은 규칙은 이것입니다. 버튼 동작 하나, store action 하나, endpoint 하나, service method 하나로 맞추세요.

흐름 이해하기

  1. 사용자가 Util component의 버튼을 클릭합니다.
  2. 버튼은 store action을 호출합니다.
  3. Store action은 생성된 fetch endpoint를 호출합니다.
  4. Endpoint는 실제 일을 service에 맡깁니다.
버튼에서 service까지

Endpoint 선언

Endpoint는 얇게 유지하세요. 필요한 값을 받고, guard를 확인하고, service method를 호출하면 됩니다.
발행 endpoint

규칙은 service에 두기

Service는 업무 규칙을 쓰는 곳입니다. 예를 들어 게시글은 제목과 내용이 있을 때만 발행할 수 있습니다.
Service method

Store에서 호출하기

Store action을 두면 UI 코드가 짧아집니다. Endpoint 성공 후 fetch 호출, 메시지 표시, modal 닫기, 데이터 갱신을 함께 처리할 수 있습니다.
Store action

Util 하나로 만들기

버튼은 `Post.Util.tsx`에 두세요. 그러면 카드, 상세 페이지, 관리자 페이지 어디서든 같은 action을 재사용할 수 있습니다.
발행 버튼

꿀팁

  • Endpoint 이름은 `publishPost`, `approveTicket`, `archiveProject`처럼 동사로 시작하세요.
  • 업무 규칙은 버튼에 두지 말고 service에 두세요.
  • 같은 action이 두 번 보이면 버튼을 복사하기 전에 Util component로 만드세요.
Endpoint action
흐름 이해하기
Endpoint 선언
규칙은 service에 두기
Store에서 호출하기
Util 하나로 만들기
꿀팁