MatePress CMS 快速指南

本文档提供了 MatePress CMS 核心模块的数据结构与路由定义的快速参考。

概览

MatePress CMS 的后台管理基于 Laravel Resource Controller 构建。本目录下的 JSON 文件描述了各个管理模块的：

基础路由 (Base URL)

支持的 HTTP 方法 (GET, POST, PUT, DELETE)

请求参数规范 (Parameters)

核心模块

以下是系统包含的主要模块及其定义文件：

模块名称	定义文件	说明
文章管理	`posts.json`	管理文章发布、编辑、状态流转 (Draft/Published)
页面管理	`pages.json`	管理独立页面（如关于我们），支持层级结构
用户管理	`users.json`	管理管理员账户与权限
主题管理	`themes.json`	主题扫描、激活与配置 (`theme.json`)
设置管理	`settings.json`	系统级配置（AI集成, 对象存储, 站点信息）
分类管理	`categories.json`	文章分类管理
菜单管理	`menus.json`	前台导航菜单管理
媒体管理	`media.json`	图片与文件管理 (支持 Local/COS/OSS)
前端接口	`frontend.json`	公开的前端访问接口

开发规范

1. 路由与认证

路由前缀: 默认后台路由前缀为 /admin。

认证方式:

Web 访问: 使用标准的 Laravel Session/Cookie 认证 (auth 中间件)。

API 访问: 部分接口支持 Sanctum Token 认证 (需在 Request Header 中携带 Authorization: Bearer <token>)。

2. 数据交互

请求格式:

常规数据: application/x-www-form-urlencoded 或 application/json

文件上传: multipart/form-data

响应格式:

页面请求返回 HTML 视图。

AJAX/API 请求通常返回 JSON 数据 (需设置 Accept: application/json)。

JSON 定义说明

每个 .json 文件遵循以下结构：

{
    "module": "模块名称",
    "base_url": "/admin/resource",
    "endpoints": [
        {
            "name": "操作名称",
            "method": "HTTP方法",
            "uri": "具体路径",
            "parameters": [ ... ]
        }
    ]
}

这些定义可用于生成 API 文档或辅助前端/客户端开发。

最后更新: 2026-01-25 03:54:35

目录#

概览#

核心模块#

开发规范#

1. 路由与认证#

2. 数据交互#

JSON 定义说明#

目录

概览

核心模块

开发规范

1. 路由与认证

2. 数据交互

JSON 定义说明