Docs Preview

Node Web Platform 가이드

백엔드 API와 Admin/Frontend 워크플로우를 통합한 CMS 구축 핸드북입니다. 현재는 콘텐츠 접근 제어(Visibility/Groups)와 보호된 업로드(서명 URL) 중심으로 운영 안정화를 진행하고 있습니다.

Project Snapshot

Blog Pion79

오늘의 이야기를 코딩하다.Blog Pion79

내일도 재밌는 하루가 되기를 기대하며 배우고, 만들고, 기록하다. Blog Pion79

GitHub 저장소 열기API 문서 보기

1. 시스템 개요

pnpm 모노레포 내부의 backend/admin/frontend/shared 패키지가 어떻게 상호 작용하는지 설명합니다. 아래 섹션은 shared 패키지의 FEATURE_CARDS 데이터를 기반으로 자동 구성됩니다. (권한/가시성, 서명 URL 업로드 흐름은 운영 중 핵심 축입니다.)

AI + Prisma 백엔드

Express + Prisma Graph/REST API를 AI 에이전트와 사람이 함께 유지보수합니다.

Headless Admin

React Admin 대시보드가 콘텐츠, 유저, 워크플로우를 하나의 허브로 묶습니다.

Next.js 프론트

App Router + ISR로 빠른 랜딩과 커뮤니티 영역을 동시에 제공합니다.

2. 환경 메타

Backend `/api/meta`

backend가 노출하는 환경별 상태/URL 정보를 그대로 노출합니다. 실패 시 shared 패키지의 API_ENVIRONMENTS 상수를 사용합니다.

  • 로컬http://localhost:4000

    Docker Compose API + Postgres

    진행중

  • 프리뷰https://preview.api.nodewp.dev

    GitHub Actions CD 예정

    예정

  • 프로덕션https://api.nodewp.dev

    Prisma 7 안정화 이후

    예정

3. 가이드 미리보기

최신 작업 로그를 요약한 아티클을 먼저 확인하고 싶다면 아래 목록을 참고하세요.

Blog 전체 보기 →
General2026-03-02T05:52:15.347Z · 5 min

독서 정리 | 파시즘 : 경고

제목 FASCISM : A WARING, 저자 MADELEINE ALBRIGHT, 읽고서 관심있게 본 내용을 정리해 보았습니다.

ssh2026-02-28T06:49:03.295Z · 5 min

SSH 설치 및 VSCode에서 SSH 설정하기

SSH 설치 및 설정 방법을 정리하였습니다. VSCode에서 SSH를 이용한 서버 접속 방법을 설명합니다.

4. 로드맵 추적

API 문서로 이동 →

backend `/api/meta` 응답을 우선 사용하고, 실패 시 shared 상수로 폴백합니다.

  1. 01IN-PROGRESS

    백엔드 부트스트랩

    Prisma 모델링, 인증, API 스캐폴드 기반 잡기

  2. 02PLANNED

    Admin UX

    실시간 미리보기와 워크플로우 관리 UI

  3. 03PLANNED

    Public 웹

    SEO/테마/번역 전략을 Next.js로 구현

5. 배포 타임라인

GitHub Actions + Docker Compose 조합으로 BlogPion79를 배포하려는 로드맵을 주기적으로 업데이트합니다.

실시간 데이터 연동 예시로, backend `/api/meta` 응답이 없을 때도 shared 상수와 동일한 UI를 그대로 유지합니다.

당신의 이야기를 기다리고 있습니다