Skip to content

core-concepts.md

Latest commit

 

History

History
95 lines (75 loc) · 3.23 KB

core-concepts.md

File metadata and controls

95 lines (75 loc) · 3.23 KB
Raw
sidebar_position 3
title 核心概念
description 理解 ReactPress 五大组件 — Admin 管理后台、NestJS API、Next.js 主题、Hook 插件系统与 Electron 桌面客户端的职责边界。
keywords
reactpress
architecture
架构
admin
api
theme
plugin
desktop
概念

核心概念

ReactPress 是发布平台，不是单纯的 Headless CMS。理解各组件职责，有助于选型与扩展。

一句话定义

Admin 管内容 · 主题管呈现 · 插件管逻辑 · API 管数据 · Toolkit 管契约

五大组件

flowchart LR
  subgraph Authoring["创作层"]
    Admin["Admin<br/>Web 管理后台"]
    Desktop["Desktop<br/>桌面客户端"]
  end
  subgraph Core["平台层"]
    API["API<br/>NestJS REST"]
    Plugins["Plugins<br/>Hook 扩展"]
  end
  subgraph Delivery["交付层"]
    Theme["Theme<br/>Next.js 访客站"]
  end
  Admin --> API
  Desktop --> API
  Plugins --> API
  API --> Theme
Loading
组件 技术 端口 职责
Admin React + Vite SPA 3001 /admin/ 写文章、管媒体、装主题/插件、站点设置（Monorepo 开发时可能为 :3000）
API NestJS 3002 持久化、鉴权、Hook、Headless REST
Theme Next.js SSR/ISR 3001 访客看到的网站（可完全替换）
Plugin Node 模块 + Hook — 服务端逻辑扩展（SEO、摘要、图片优化等）
Desktop Electron — 离线写作、SQLite 本地模式、同步到远程

与 WordPress 的对应关系

WordPress ReactPress 说明
wp-admin Admin (:3001/admin/) 内容管理界面
Theme themes/* (:3001) 访客前端，npm 可安装
Plugin plugins/* Hook 扩展，不修改主题
REST API /api/* Headless 默认开启
— Desktop 本地优先写作（WordPress 无对等物）

数据流

  1. 作者在 Admin 或 Desktop 创建文章
  2. 请求经 Toolkit SDK 到达 API
  3. Plugin 在 Hook 点改写摘要、SEO 字段等
  4. 数据写入 SQLite / MySQL
  5. Theme 通过 API 拉取内容并 SSR 渲染给访客

架构红线

  • Admin 不包含访客页面；主题不包含 Admin 路由
  • 所有前端（Admin、主题、插件 UI）仅通过 Toolkit 访问 API
  • Server 不依赖任何前端包

详见 系统架构概览。

目录与运行时

my-site/
├── .reactpress/
│   ├── config.json          # 配置源（端口、数据库、URL）
│   ├── runtime/{theme-id}/  # 已安装主题
│   ├── plugins/{plugin-id}/ # 已安装插件
│   └── reactpress.db        # SQLite（默认）
├── .env                       # CLI 自动生成，勿手改
└── uploads/                   # 媒体上传目录

两种用户路径

路径 适用 入口
终端用户 建站、写博客 npm i -g @fecommunity/reactpress → init
贡献者 改 core、写主题/插件 clone monorepo → pnpm dev

相关文档