Documentation

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

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

Core

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

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

Extensions

페이지·API·액션·스키마 원본을 기능별 폴더에 모읍니다. 코어 게시판·회원 모듈과 이를 확장하는 기능·스킨은 합치지 않습니다.

Registry

메뉴·스킨은 registry에서 명시적으로 조립하고, Next.js 라우트 연결은 기능별 routes.json과 extensions:sync로 관리합니다.

Working Flow

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

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

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

routes.json을 작성하고 extensions:sync로 연결한 뒤 registry·의존성·DB 적용 절차를 별도로 확인합니다.

기본 판단

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

Boundaries

src/extensions

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

src/app

Next.js 라우트. 확장 원본은 routes.json으로 연결하며 기본 모듈 라우트는 유지

src/modules

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

src/core

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

Recent changes

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

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

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

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

routes.json을 작성하고 extensions:sync로 연결한 뒤 registry·의존성·DB 적용 절차를 별도로 확인합니다.