feat: add article and production modules

This commit is contained in:
2026-08-31 13:16:46 +08:00
parent ac3da246b2
commit 5c586a1a95
334 changed files with 34419 additions and 1 deletions
@@ -0,0 +1,231 @@
<?php
/**
* Article 控制器
*/
namespace plugin\article\app\adminapi\controller;
use app\adminapi\controller\Crud;
use app\adminapi\CurrentUser;
use app\adminapi\middleware\OperationMiddleware;
use app\adminapi\middleware\PermissionMiddleware;
use app\model\system\Admin;
use core\tool\Json;
use madong\swagger\annotation\response\DataResponse;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\Permission;
use OpenApi\Attributes as OA;
use plugin\article\app\model\Content;
use support\annotation\Middleware;
use support\Request;
use support\Response;
#[Middleware(OperationMiddleware::class, PermissionMiddleware::class)]
class ArticleController
{
protected CurrentUser $currentUser;
public function __construct(CurrentUser $currentUser)
{
$this->currentUser = $currentUser;
}
#[OA\Get(
path: '/article/legacy/index',
summary: '旧版内容列表示例',
tags: ['article-legacy']
)]
#[DataResponse(description: '获取成功')]
#[Permission(code: 'article:legacy:index', description: '旧版内容列表示例')]
public function index(Request $request): Response
{
return Json::success('获取成功', [
[
'title' => '欢迎使用文章管理插件',
'category' => '默认分类',
'tags' => '插件, 演示',
'status' => '已发布',
'updated_at' => '2026-07-25 17:50:00',
],
]);
}
#[OA\Get(
path: '/article/legacy/category',
summary: '旧版内容分类列表示例',
tags: ['article-legacy']
)]
#[DataResponse(description: '获取成功')]
#[Permission(code: 'article:legacy:category', description: '旧版内容分类列表示例')]
public function category(Request $request): Response
{
return Json::success('获取成功', [
[
'name' => '默认分类',
'slug' => 'default-category',
'article_count' => 1,
'sort' => 100,
'updated_at' => '2026-07-25 17:50:00',
],
]);
}
#[OA\Get(
path: '/article/legacy/tag',
summary: '旧版标签列表示例',
tags: ['article-legacy']
)]
#[DataResponse(description: '获取成功')]
#[Permission(code: 'article:legacy:tag', description: '旧版标签列表示例')]
public function tag(Request $request): Response
{
return Json::success('获取成功', [
[
'name' => '插件演示',
'slug' => 'plugin-demo',
'article_count' => 1,
'heat' => 88,
'updated_at' => '2026-07-25 17:50:00',
],
]);
}
#[OA\Get(
path: '/article/recycle',
summary: '内容回收站列表',
tags: ['article-legacy']
)]
#[DataResponse(description: '获取成功')]
#[Permission(code: 'article:recycle:index', description: '内容回收站权限')]
public function recycle(Request $request): Response
{
$keyword = trim((string) $request->input('LIKE_title', ''));
$items = Content::query()
->onlyTrashed()
->with(['category'])
->when($keyword !== '', function ($query) use ($keyword) {
$query->where('title', 'like', "%{$keyword}%");
})
->orderByDesc('deleted_at')
->get();
$operatorIds = $items->pluck('updated_by')
->filter(static fn($id) => !empty($id))
->unique()
->values()
->all();
$operators = empty($operatorIds)
? collect()
: Admin::query()->whereIn('id', $operatorIds)->get(['id', 'real_name']);
$operatorMap = $operators->pluck('real_name', 'id');
$rows = $items->map(function (Content $item) use ($operatorMap) {
$deletedAt = $item->deleted_at;
return [
'id' => $item->id,
'title' => $item->title,
'category' => $item->category?->name ?? '',
'deleted_by' => $operatorMap[$item->updated_by] ?? '',
'deleted_at' => $deletedAt ? date('Y-m-d H:i:s', (int) $deletedAt) : '',
'expire_at' => $deletedAt ? date('Y-m-d H:i:s', (int) $deletedAt + 30 * 24 * 60 * 60) : '',
];
})->values()->all();
return Json::success('获取成功', $rows);
}
#[OA\Put(
path: '/article/recycle/{id}/restore',
summary: '恢复内容',
tags: ['article-legacy']
)]
#[SimpleResponse(description: '恢复成功')]
#[Permission(code: 'article:recycle:restore', description: '恢复回收站内容')]
public function restore(Request $request): Response
{
try {
$id = $request->route?->param('id') ?: $request->input('id');
$item = Content::withTrashed()->find($id);
if (!$item) {
return Json::fail('内容不存在');
}
$item->restore();
return Json::success('恢复成功');
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Delete(
path: '/article/recycle/{id}',
summary: '彻底删除内容',
tags: ['article-legacy']
)]
#[SimpleResponse(description: '删除成功')]
#[Permission(code: 'article:recycle:delete', description: '彻底删除回收站内容')]
public function destroyRecycle(Request $request): Response
{
try {
$id = $request->route?->param('id') ?: $request->input('id');
$item = Content::withTrashed()->find($id);
if (!$item) {
return Json::fail('内容不存在');
}
$item->forceDelete();
return Json::success('删除成功');
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
#[OA\Post(
path: '/article/legacy/create',
summary: '旧版创建示例',
tags: ['article-legacy']
)]
#[SimpleResponse(description: '创建成功')]
#[Permission(code: 'article:legacy:create', description: '旧版创建示例')]
public function create(Request $request): Response
{
return Json::success('创建成功');
}
#[OA\Get(
path: '/article/legacy/info',
summary: '旧版详情示例',
tags: ['article-legacy']
)]
#[DataResponse(description: '获取成功')]
#[Permission(code: 'article:legacy:info', description: '旧版详情示例')]
public function info(Request $request): Response
{
return Json::success('获取成功', []);
}
#[OA\Post(
path: '/article/legacy/update',
summary: '旧版更新示例',
tags: ['article-legacy']
)]
#[SimpleResponse(description: '更新成功')]
#[Permission(code: 'article:legacy:update', description: '旧版更新示例')]
public function update(Request $request): Response
{
return Json::success('更新成功');
}
#[OA\Post(
path: '/article/legacy/delete',
summary: '旧版删除示例',
tags: ['article-legacy']
)]
#[SimpleResponse(description: '删除成功')]
#[Permission(code: 'article:legacy:delete', description: '旧版删除示例')]
public function delete(Request $request): Response
{
return Json::success('删除成功');
}
}
@@ -0,0 +1,127 @@
<?php
declare(strict_types=1);
namespace plugin\article\app\adminapi\controller;
use app\adminapi\controller\Crud;
use app\adminapi\middleware\OperationMiddleware;
use app\adminapi\middleware\PermissionMiddleware;
use app\schema\request\BatchDeleteRequest;
use app\schema\request\IdRequest;
use madong\swagger\annotation\response\PageResponse;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\Permission;
use OpenApi\Attributes as OA;
use plugin\article\app\service\admin\CategoryService;
use plugin\article\app\validate\CategoryValidate;
use support\annotation\Middleware;
use support\Request;
use WebmanTech\Swagger\DTO\SchemaConstants;
#[Middleware(OperationMiddleware::class, PermissionMiddleware::class)]
class CategoryController extends Crud
{
public function __construct(CategoryService $service, CategoryValidate $validate)
{
$this->service = $service;
$this->validate = $validate;
}
#[OA\Get(
path: '/article/category',
summary: '内容分类列表',
tags: ['article-category']
)]
#[Permission(code: 'article:category:list', description: '内容分类列表')]
#[PageResponse(schema: [], example: [])]
public function index(Request $request): \support\Response
{
return parent::index($request);
}
#[OA\Get(
path: '/article/category/{id}',
summary: '内容分类详情',
tags: ['article-category'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:category:read', description: '内容分类详情')]
#[SimpleResponse(schema: [], example: [])]
public function show(Request $request): \support\Response
{
return parent::show($request);
}
#[OA\Post(
path: '/article/category',
summary: '创建内容分类',
tags: ['article-category']
)]
#[Permission(code: 'article:category:create', description: '创建内容分类')]
#[SimpleResponse(schema: [], example: [])]
public function store(Request $request): \support\Response
{
return parent::store($request);
}
#[OA\Put(
path: '/article/category/{id}',
summary: '更新内容分类',
tags: ['article-category'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:category:update', description: '更新内容分类')]
#[SimpleResponse(schema: [], example: [])]
public function update(Request $request): \support\Response
{
return parent::update($request);
}
#[OA\Post(
path: '/article/category/export',
summary: '导出内容分类',
tags: ['article-category']
)]
#[Permission(code: 'article:category:list', description: '导出内容分类')]
#[SimpleResponse(schema: [], example: [])]
public function export(Request $request): \support\Response
{
return parent::export($request);
}
#[OA\Delete(
path: '/article/category/{id}',
summary: '删除内容分类',
tags: ['article-category'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:category:delete', description: '删除内容分类')]
#[SimpleResponse(schema: [], example: [])]
public function destroy(Request $request): \support\Response
{
return parent::destroy($request);
}
#[OA\Delete(
path: '/article/category',
summary: '批量删除内容分类',
tags: ['article-category'],
x: [SchemaConstants::X_SCHEMA_REQUEST => BatchDeleteRequest::class]
)]
#[Permission(code: 'article:category:delete', description: '批量删除内容分类')]
#[SimpleResponse(schema: [], example: [])]
public function batchDelete(Request $request): \support\Response
{
return parent::destroy($request);
}
}
@@ -0,0 +1,183 @@
<?php
declare(strict_types=1);
namespace plugin\article\app\adminapi\controller;
use app\adminapi\controller\Crud;
use app\adminapi\CurrentUser;
use app\adminapi\middleware\OperationMiddleware;
use app\adminapi\middleware\PermissionMiddleware;
use app\schema\request\BatchDeleteRequest;
use app\schema\request\IdRequest;
use core\tool\Json;
use madong\swagger\annotation\response\PageResponse;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\Permission;
use OpenApi\Attributes as OA;
use plugin\article\app\model\Content;
use plugin\article\app\service\admin\ContentService;
use plugin\article\app\validate\ContentValidate;
use support\annotation\Middleware;
use support\Container;
use support\Request;
use WebmanTech\Swagger\DTO\SchemaConstants;
#[Middleware(OperationMiddleware::class, PermissionMiddleware::class)]
class ContentController extends Crud
{
protected CurrentUser $currentUser;
public function __construct(ContentService $service, ContentValidate $validate)
{
$this->service = $service;
$this->validate = $validate;
$this->currentUser = Container::make(CurrentUser::class);
}
#[OA\Get(
path: '/article/index',
summary: '内容中心列表',
tags: ['article-content']
)]
#[Permission(code: 'article:list', description: '内容中心列表')]
#[PageResponse(schema: [], example: [])]
public function index(Request $request): \support\Response
{
return parent::index($request);
}
#[OA\Get(
path: '/article/index/{id}',
summary: '内容中心详情',
tags: ['article-content'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:read', description: '内容中心详情')]
#[SimpleResponse(schema: [], example: [])]
public function show(Request $request): \support\Response
{
return parent::show($request);
}
#[OA\Post(
path: '/article/index',
summary: '创建内容',
tags: ['article-content']
)]
#[Permission(code: 'article:create', description: '创建内容')]
#[SimpleResponse(schema: [], example: [])]
public function store(Request $request): \support\Response
{
return parent::store($request);
}
#[OA\Put(
path: '/article/index/{id}',
summary: '更新内容',
tags: ['article-content'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:update', description: '更新内容')]
#[SimpleResponse(schema: [], example: [])]
public function update(Request $request): \support\Response
{
return parent::update($request);
}
#[OA\Post(
path: '/article/index/export',
summary: '导出内容',
tags: ['article-content']
)]
#[Permission(code: 'article:list', description: '导出内容')]
#[SimpleResponse(schema: [], example: [])]
public function export(Request $request): \support\Response
{
return parent::export($request);
}
protected function selectInput(Request $request, ?array $config = null): array
{
$result = parent::selectInput($request, $config);
if (empty($result[4])) {
$result[4] = 'published_at desc,id desc';
}
return $result;
}
protected function insertInput(Request $request): array
{
return $this->inputFilter($request->all(), ['tag_ids']);
}
#[OA\Delete(
path: '/article/index/{id}',
summary: '删除内容',
tags: ['article-content'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:delete', description: '删除内容')]
#[SimpleResponse(schema: [], example: [])]
public function destroy(Request $request): \support\Response
{
return $this->deleteContents($request);
}
#[OA\Delete(
path: '/article/index',
summary: '批量删除内容',
tags: ['article-content'],
x: [SchemaConstants::X_SCHEMA_REQUEST => BatchDeleteRequest::class]
)]
#[Permission(code: 'article:delete', description: '批量删除内容')]
#[SimpleResponse(schema: [], example: [])]
public function batchDelete(Request $request): \support\Response
{
return $this->deleteContents($request);
}
protected function deleteContents(Request $request): \support\Response
{
try {
$ids = $this->getDeleteIds($request);
if (empty($ids)) {
throw new \Exception('删除参数不能为空');
}
$result = $this->service->transaction(function () use ($ids) {
$data = is_array($ids) ? $ids : explode(',', $ids);
$deletedIds = [];
$currentUserId = $this->currentUser->id();
foreach ($data as $id) {
$item = Content::query()->find($id);
if (!$item) {
continue;
}
if ($currentUserId && $item->isFillable('updated_by')) {
$item->setAttribute('updated_by', $currentUserId);
$item->save();
}
$item->delete();
$deletedIds[] = $item->id;
}
return $deletedIds;
});
return Json::success('ok', $result);
} catch (\Throwable $e) {
return Json::fail($e->getMessage());
}
}
}
@@ -0,0 +1,127 @@
<?php
declare(strict_types=1);
namespace plugin\article\app\adminapi\controller;
use app\adminapi\controller\Crud;
use app\adminapi\middleware\OperationMiddleware;
use app\adminapi\middleware\PermissionMiddleware;
use app\schema\request\BatchDeleteRequest;
use app\schema\request\IdRequest;
use madong\swagger\annotation\response\PageResponse;
use madong\swagger\annotation\response\SimpleResponse;
use madong\swagger\attribute\Permission;
use OpenApi\Attributes as OA;
use plugin\article\app\service\admin\TagService;
use plugin\article\app\validate\TagValidate;
use support\annotation\Middleware;
use support\Request;
use WebmanTech\Swagger\DTO\SchemaConstants;
#[Middleware(OperationMiddleware::class, PermissionMiddleware::class)]
class TagController extends Crud
{
public function __construct(TagService $service, TagValidate $validate)
{
$this->service = $service;
$this->validate = $validate;
}
#[OA\Get(
path: '/article/tag',
summary: '标签管理列表',
tags: ['article-tag']
)]
#[Permission(code: 'article:tag:list', description: '标签管理列表')]
#[PageResponse(schema: [], example: [])]
public function index(Request $request): \support\Response
{
return parent::index($request);
}
#[OA\Get(
path: '/article/tag/{id}',
summary: '标签详情',
tags: ['article-tag'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:tag:read', description: '标签详情')]
#[SimpleResponse(schema: [], example: [])]
public function show(Request $request): \support\Response
{
return parent::show($request);
}
#[OA\Post(
path: '/article/tag',
summary: '创建标签',
tags: ['article-tag']
)]
#[Permission(code: 'article:tag:create', description: '创建标签')]
#[SimpleResponse(schema: [], example: [])]
public function store(Request $request): \support\Response
{
return parent::store($request);
}
#[OA\Put(
path: '/article/tag/{id}',
summary: '更新标签',
tags: ['article-tag'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:tag:update', description: '更新标签')]
#[SimpleResponse(schema: [], example: [])]
public function update(Request $request): \support\Response
{
return parent::update($request);
}
#[OA\Post(
path: '/article/tag/export',
summary: '导出标签',
tags: ['article-tag']
)]
#[Permission(code: 'article:tag:list', description: '导出标签')]
#[SimpleResponse(schema: [], example: [])]
public function export(Request $request): \support\Response
{
return parent::export($request);
}
#[OA\Delete(
path: '/article/tag/{id}',
summary: '删除标签',
tags: ['article-tag'],
x: [
SchemaConstants::X_PROPERTY_IN => 'id',
SchemaConstants::X_SCHEMA_REQUEST => IdRequest::class,
]
)]
#[Permission(code: 'article:tag:delete', description: '删除标签')]
#[SimpleResponse(schema: [], example: [])]
public function destroy(Request $request): \support\Response
{
return parent::destroy($request);
}
#[OA\Delete(
path: '/article/tag',
summary: '批量删除标签',
tags: ['article-tag'],
x: [SchemaConstants::X_SCHEMA_REQUEST => BatchDeleteRequest::class]
)]
#[Permission(code: 'article:tag:delete', description: '批量删除标签')]
#[SimpleResponse(schema: [], example: [])]
public function batchDelete(Request $request): \support\Response
{
return parent::destroy($request);
}
}