Documentation

Plextype를 고치지 않고, 내 프로젝트를 완성하는 방법.

이 문서는 기능 소개가 아니라 작업 기준입니다. 코어를 직접 바꾸기 전에 어디에 확장해야 하는지, 어떤 파일 경계를 지켜야 업데이트와 배포를 오래 끌고 갈 수 있는지를 정리합니다.

Core

코어는 업데이트 가능한 상태로 둡니다.

회원, 게시판, 관리자, 인증 같은 기본 영역은 Plextype가 계속 가져갈 수 있어야 합니다. 프로젝트별 요구는 먼저 확장 지점으로 해결합니다.

Extensions

전용 페이지, 스킨, 레이아웃, 관리자 메뉴, Prisma 조각은 프로젝트 단위로 옮길 수 있게 한 폴더 안에 모읍니다.

Registry

모듈이 제공하는 화면과 관리자 진입점은 각 모듈의 registry에 선언하고, 루트 registry는 가져와서 합치는 역할만 맡깁니다.

Working Flow

기존 코어 기능과 공통 컴포넌트를 먼저 찾습니다.

프로젝트 전용인지 코어로 남겨야 하는지 구분합니다.

화면과 action/query, schema 조각을 같은 extension 경계 안에 둡니다.

배포판에 빠져야 하는 기능은 extensions와 app/(extensions)에 유지합니다.

기본 판단

“이 기능이 다른 Plextype 사용자에게도 필요한가?” 이 질문에 아니라고 답하면 대부분 extensions에 두는 편이 맞습니다.

Boundaries

src/extensions

프로젝트별 기능, 스킨, 레이아웃, 관리자 확장

src/app/(extensions)

배포판과 분리되는 프로젝트 전용 라우트

src/modules

Plextype 기본 모듈. 직접 수정 전 확장 가능성을 먼저 확인

src/core

공통 컴포넌트와 프레임워크 코어. 변경 범위를 가장 보수적으로 판단

Recent changes

작업은 작게 시작하고, 경계는 분명하게 둡니다.

기존 코어 기능과 공통 컴포넌트를 먼저 찾습니다.

프로젝트 전용인지 코어로 남겨야 하는지 구분합니다.

화면과 action/query, schema 조각을 같은 extension 경계 안에 둡니다.

배포판에 빠져야 하는 기능은 extensions와 app/(extensions)에 유지합니다.