Akan.js
한국어
English
한국어
문서 (V1)
Akan.js
현재 Akan.js v1 문서를 보고 있습니다.
최신 v2 문서 보기
문서 (V1)
MIT 라이선스 하에 배포되었습니다.
Akan.js 공식 컨설팅 서비스
Akansoft
Copyright © 2026 Akan.js 모든 권리 보유.
시스템 관리자
bassman
소개
•
시작하기
•
작동원리
•
실습하기
튜토리얼
•
상세하게 보여주기
•
상태 변경하기
•
서비스 내에서 상호작용
•
슬라이스로 표시하기
•
페이지를 통한 UX
•
스칼라 사용하기
•
인사이트 사용하기
•
데이터 연결하기
시스템 아키텍처
•
개요
•
백엔드 시스템
•
프론트엔드 시스템
•
환경변수
•
기본 스칼라 타입
•
도메인 기반 모듈
•
CSS
모듈 규칙
•
개요
•
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
소개
•
시작하기
•
작동원리
•
실습하기
튜토리얼
•
상세하게 보여주기
•
상태 변경하기
•
서비스 내에서 상호작용
•
슬라이스로 표시하기
•
페이지를 통한 UX
•
스칼라 사용하기
•
인사이트 사용하기
•
데이터 연결하기
시스템 아키텍처
•
개요
•
백엔드 시스템
•
프론트엔드 시스템
•
환경변수
•
기본 스칼라 타입
•
도메인 기반 모듈
•
CSS
모듈 규칙
•
개요
•
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
이전
개요
다음
프론트엔드 시스템
백엔드 시스템
백엔드 시스템은 Akan.js 애플리케이션의 기반입니다. Nest.js 위에 구축되어 데이터 저장, 비즈니스 로직, API 엔드포인트를 처리하기 위한 견고하고 확장 가능한 아키텍처를 제공합니다.
🏗️ 아키텍처 하이라이트
각 기능별로 1개의 Nest 모듈이 만들어지며, 모듈들이 모여 1개의 서버를 구성합니다. 여러 서버가 모여 서비스의 고가용성과 확장성을 제공하는 클러스터를 형성합니다.
백엔드 모듈 구조
Akan.js의 각 데이터 모델은 전용 모듈을 가집니다. 이러한 모듈식 접근 방식은 관심사의 깔끔한 분리를 보장하고 코드베이스를 유지보수하고 확장하기 쉽게 만듭니다.
각 모듈은 함께 작동하는 네 가지 핵심 구성 요소를 포함합니다:
1
Constant
데이터 모델 스키마, 타입, 열거형, 검증 규칙을 정의합니다. 백엔드와 프론트엔드 간에 공유되는 단일 진실의 원천입니다.
2
Document
CRUD, 쿼리, 필터, 문서 메서드를 포함한 MongoDB 작업을 처리합니다. 작업 전/후 미들웨어 훅을 포함합니다.
3
Service
비즈니스 로직을 포함하고 작업을 조율합니다. 다른 서비스와 외부 API에 접근하기 위한 의존성 주입을 지원합니다.
4
Signal
자동 타입 생성, 인증 가드, 속도 제한과 함께 GraphQL 엔드포인트(슬라이스와 엔드포인트)를 노출합니다.
서버 클러스터 구조
Akan.js 서버는 서로 다른 워크로드에 최적화된 두 가지 모드로 클러스터 구성에서 운영됩니다:
⚡
페더레이션 모드
수평 확장 기능으로 프론트엔드로부터 들어오는 요청을 처리합니다. 여러 컨테이너를 배포하여 부하를 분산할 수 있어 고가용성과 응답성을 보장합니다.
🔄
배치 모드
예약된 작업, 큐 처리, 보안 작업을 위해 클러스터에서 단일 컨테이너로 실행됩니다. 경쟁 조건 없이 일관된 실행을 보장합니다.
두 서버 모드는 공유 인프라에 연결됩니다:
🗄️ MongoDB
영구 데이터 저장을 위한 주 데이터베이스. 샤딩과 복제를 위해 1-3개의 데이터베이스 연결을 지원합니다.
⚡ Redis
세션 관리, 실시간 구독, 서버 인스턴스 간 공유 상태를 위한 인메모리 캐시.
요청 처리
백엔드를 통해 요청이 어떻게 흐르는지 이해하면 효율적인 애플리케이션을 구축하는 데 도움이 됩니다:
1
쿼리/뮤테이션 작업
: 표준 CRUD 및 커스텀 작업은 최적의 부하 분산을 위해 페더레이션 모드 서버에서 처리됩니다.
2
큐/배치 작업
: 예약된 작업, 백그라운드 처리, 큐 작업은 일관된 실행을 위해 배치 모드에서 처리됩니다.
3
실시간 구독
: GraphQL 구독은 Redis pub/sub을 사용하여 모든 페더레이션 인스턴스 간에 데이터를 실시간으로 동기화합니다.
백엔드 시스템
백엔드 모듈 구조
서버 클러스터 구조
요청 처리
