왜 우리는 하나의 비즈니스를 구현하기 위해 쪼개진 여러 프로젝트를 만들어야 하는 걸까요?

백엔드, 프론트엔드, 안드로이드, iOS등을 나누어서 개발하는 것은 혼란스럽고 비효율적인 것 아닐까요? 한 번에 모든 것을 할 수 없을까요?.

Akan.js는 풀스택 프레임워크로, 한번의 코드 작성으로 백엔드, 프론트엔드 웹, 안드로이드, iOS에 모두 배포할 수 있는 구조를 가지고 있습니다.

타입 안전한 방식의 한 번의 코드 작성으로 백엔드, 프론트엔드 웹, 안드로이드, iOS에 모두 배포할 수 있습니다.

이를 통해, 다양한 플랫폼과의 씨름은 더 이상 필요없습니다. 서비스의 개발과 사용자의 편의를 위한 노력에 집중할 수 있습니다.

Akan.js는 기술적인 코드를 최소화하고, 비즈니스 로직을 구현하는 데 집중할 수 있도록 도와줍니다.

또한, 애플리케이션을 구축하기 위한 여러 편의기능을 내장하고 있고, 설치가능한 라이브러리들을 제공함으로써 비즈니스 개발의 모범 사례를 제공합니다.

Akan.js에서는 하나의 조직(팀)이 하나의 레포지토리(workspace) 위에서 여러 앱을 개발하는 구조로 이루어져 있습니다. 하나의 workspace는 여러 앱(app)과 공통 라이브러리(lib)를 가지고 있습니다.

앱(apps): 앱은 독립적으로 배포될 수 있는 하나의 애플리케이션입니다. 웹 앱, 모바일 앱, 서버를 모두 포함하여 모든 플랫폼에 배포될 수 있습니다.

공통 라이브러리(libs): 여러 앱들이 사용할 수 있는 공통의 기능들을 제공합니다. 예를 들면, 로그인, 결제, 알림, 채팅 등은 일반적으로 다양한 앱에서 사용되는 기능들입니다. 이러한 기능들을 공통 라이브러리로 제공하면, 개발자들은 이러한 기능들을 재사용하여 개발 시간을 줄일 수 있습니다.

처음 `akan create-workspace`를 진행하면, 기본적으로 shared, util 라이브러리가 설치되고, 이는 공통 라이브러리로서 모든 앱에서 사용할 수 있습니다.

생성한 내 애플리케이션(e.g. myapp)에서 서버 로직, 도메인 모듈, 클라이언트 로직, 컴포넌트 등의 공통 라이브러리를 사용할 수 있습니다. 예를 들면, shared 라이브러리에서는 관리자페이지와 파일 업로드 도구 등을 제공합니다.

서버, 클라이언트, 그리고 공통의 코드들을 효율적으로 배치하기 위해 apps와 libs 구조는 다음과 같은 동일한 구조를 가집니다.

서버는 도메인 기반으로 묶여 최종적으로 main.ts 파일에서 실행되는 Node.js 어플리케이션으로 구현되며, 클라이언트는 Next.js app router 방식의 파일 기반 라우팅으로 구현됩니다.

서버와 클라이언트를 구동하기 위해서 각각 server.ts와 client.ts 파일에 모듈화된 코드들을 모아 하나의 파일(barrel file)로 구현합니다.

이를 위해 서버 파일, 클라이언트 파일, 공통 파일을 구분하여 파일 규칙을 가져가며, 이를 개략적으로 표현하면 다음과 같습니다.

위 그림과 같이 파일 규칙에 맞추어 서버, 클라이언트, 공통파일을 잘 배치하여 확장가능하고 재사용가능한 구조를 구현할 수 있습니다. 지금 모든 규칙을 이해할 필요는 없습니다. 앞으로 나올 실습에 맞추어 코드를 작성하면서 하나씩 이해해보도록 합시다. 가장 중요한 것은 내가 구현하고자 하는 코드가 서버, 클라이언트, 공통파일 중 어디에 위치하는지를 파악하는 것입니다.

예를 들면, 패스워드 기반 로그인 기능을 구현한다고 가정합시다. 아이디와 패스워드를 입력받는 컴포넌트는 클라이언트 기능입니다. 이를 암호화해서 저장하는 기능은 서버 기능이며, 비밀번호가 8자가 넘는지 체크하는 것은 양쪽 모두 필요한 공통 기능입니다.

Akan.js는 엄격한 파일 규칙을 제공하여, 누가 구현하든 같은 방식으로 구현할 수 있도록 도와줍니다.

이를 통해 개발자들은 한몸처럼 협업할 수 있고, 내가 휴가를 떠난 동안 동료가 러닝커브 없이 내 작업을 대신 할 수 있습니다.

워크스페이스에서 작업하면서 가장 많이 작업하는 것은 두 가지로, 1)사용자에게 전달되는 페이지를 작성하는 것과, 2)비즈니스 개념을 구현하는 도메인 모듈을 작성하는 것입니다. 두 작업에 대한 파일 규칙에 대해 알아봅시다.

도메인 모듈은 비즈니스 상에서 차지하는 하나의 도메인에 대한 표현입니다. 예를 들면, 회원 관리, 주문 관리, 결제 관리 등이 있으며 이를 표현하기 위해서는 데이터 구조, 서비스 로직, 사용자 UI 등 시스템 전체에 걸쳐 정렬된 형태로 구현해야 합니다.

하나의 도메인은 복합적인 유기체처럼 활동합니다. constant 파일의 스키마 정의에서부터 Zone의 통합 컴포넌트까지 하나의 폴더에서 관리할 수 있으며, 이를 통해 백엔드-프론트엔드 간의 버전 격차, 비즈니스 로직 변경 시 발생하는 문제 등을 최소화할 수 있습니다.

고객에게 빠르게 제품 수준의 가치를 전달하고 싶은 개발자에게 적합합니다.

살아있는 제품은 지속적으로 관리되고 운영되어야 합니다. Akan.js는 한 명의 개발자가 여러 프로젝트를 동시에 운영하고, 여러 개발자가 하나의 프로젝트를 한 몸처럼 협업할 수 있는 환경을 제공합니다.

프레임워크는 언제나 trade-off를 가집니다. 단순하게 사용할 수 있다면 고도화가 어려울 수 있고, 다양성을 포용하면 협업이 어려울 수 있습니다. 우리는 이러한 문제에 대해 다음과 같은 부분에 집중합니다.

프로그래밍은 우리와 고객의 삶을 효율화하고 긴밀하게 연결해 비즈니스 가치를 창출하는 것입니다. 문제를 정의하고, 빠르게 Akan.js를 통해 제품 수준의 해결책을 만들어내어 손쉽게 고객에게 전달하세요!