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

Testing

Akan app에서는 signal 테스트부터 시작하세요. Signal test는 UI 세부사항보다 먼저 generated fetch API를 통해 실제 business flow를 확인합니다.
  • Signup, permission, validation, state transition을 API layer에서 테스트합니다.
  • 반복되는 준비 작업은 작은 helper 함수로 분리합니다.
  • 긴 scenario는 명확한 여러 step으로 나눕니다.

Spec helper

Spec helper는 test user, agent, sample data를 만듭니다. 그러면 test file은 setup script가 아니라 user story처럼 읽힙니다.
article.signal.spec.ts

Test file

Test file은 helper를 import하고 agent를 준비한 뒤 fetch를 통해 signal을 호출하고 결과를 확인합니다.
article.signal.test.ts

무엇을 테스트할까

  • Happy path: create, update, publish, archive.
  • Permission: guest는 publish 불가, owner는 edit 가능, admin은 remove 가능.
  • Validation: title 누락, 잘못된 date, accountId 중복.
  • State transition: draft에서 published, pending에서 approved.
  • External dependency: file upload, payment callback, message publish.

명령어

Workspace root에서 app test를 실행합니다. 점검 중 snapshot이나 generated output 쓰기를 막고 싶으면 `--write false`를 붙입니다.
테스트 실행

꿀팁

  • 가능하면 signal로 데이터를 만들어 app과 같은 rule을 타게 하세요.
  • Setup은 helper로 빼되 assertion은 test file에 남겨두세요.
  • `it` block 하나에는 중요한 behavior 하나만 테스트하세요.
Testing
Spec helper
Test file
무엇을 테스트할까
명령어
꿀팁