first

modules/Cms/.gitignore

@@ -0,0 +1,4 @@
+.idea
+vendor
+.DS_Store
+composer.lock

modules/Cms/Cms.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace Modules\Cms;
+
+use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\Facade;
+
+class Cms extends Facade
+{
+
+    protected static string $mainTitle = '内容管理';
+
+    /**
+     * Notes   : 模块初始化要做的一些操作
+     * @Date   : 2021/3/12 11:34 上午
+     * @Author : < Jason.C >
+     */
+    public static function install()
+    {
+        Artisan::call('migrate', [
+            '--path' => 'modules/Cms/Database/Migrations',
+        ]);
+
+        self::createAdminMenu();
+    }
+
+    /**
+     * Notes   : 卸载模块的一些操作
+     * @Date   : 2021/3/12 11:35 上午
+     * @Author : < Jason.C >
+     */
+    public static function uninstall()
+    {
+        $menu = config('admin.database.menu_model');
+
+        $mains = $menu::where('title', self::$mainTitle)->get();
+
+        foreach ($mains as $main) {
+            $main->delete();
+        }
+    }
+
+    protected static function createAdminMenu()
+    {
+        $menu = config('admin.database.menu_model');
+
+        $main = $menu::create([
+            'parent_id' => 0,
+            'order'     => 15,
+            'title'     => self::$mainTitle,
+            'icon'      => 'fa-wordpress',
+        ]);
+
+        $main->children()->createMany([
+            [
+                'order' => 1,
+                'title' => '文章管理',
+                'icon'  => 'fa-bars',
+                'uri'   => 'cms/articles',
+            ],
+            [
+                'order' => 2,
+                'title' => '单页管理',
+                'icon'  => 'fa-newspaper-o',
+                'uri'   => 'cms/pages',
+            ],
+            [
+                'order' => 3,
+                'title' => '分类管理',
+                'icon'  => 'fa-indent',
+                'uri'   => 'cms/categories',
+            ],
+            [
+                'order' => 4,
+                'title' => '标签管理',
+                'icon'  => 'fa-tags',
+                'uri'   => 'cms/tags',
+            ],
+            [
+                'order' => 5,
+                'title' => '素材管理',
+                'icon'  => 'fa-adjust',
+                'uri'   => 'cms/storages',
+            ],
+        ]);
+    }
+
+}

modules/Cms/Config/config.php

@@ -0,0 +1,10 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | 模块名称
+    |--------------------------------------------------------------------------
+    */
+    'name' => 'Cms',
+];

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_article_category_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsArticleCategoryTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_article_category', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('article_id');
+            $table->unsignedBigInteger('category_id');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_article_category');
+    }
+
+}

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_articles_table.php

@@ -0,0 +1,42 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsArticlesTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_articles', function (Blueprint $table) {
+            $table->id();
+            $table->string('slug')->index()->nullable()->comment('唯一的别名');
+            $table->string('title');
+            $table->string('sub_title')->nullable()->comment('副标题');
+            $table->string('description')->nullable();
+            $table->string('cover')->nullable();
+            $table->json('pictures')->nullable();
+            $table->text('content');
+            $table->json('attachments')->nullable();
+            $table->boolean('status')->default(0);
+            $table->unsignedInteger('clicks')->default(0);
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_articles');
+    }
+
+}

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_categories_table.php

@@ -0,0 +1,41 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsCategoriesTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_categories', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('parent_id')->index()->default(0);
+            $table->string('title');
+            $table->string('slug')->nullable();
+            $table->string('description')->nullable();
+            $table->string('cover')->nullable();
+            $table->json('pictures')->nullable();
+            $table->text('content')->nullable();
+            $table->integer('order')->default(0);
+            $table->boolean('status')->default(0);
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_categories');
+    }
+
+}

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_pages_table.php

@@ -0,0 +1,42 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsPagesTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_pages', function (Blueprint $table) {
+            $table->id();
+            $table->string('slug')->index()->nullable()->comment('唯一的别名');
+            $table->string('title');
+            $table->string('sub_title')->nullable()->comment('副标题');
+            $table->string('description')->nullable();
+            $table->string('cover')->nullable();
+            $table->json('pictures')->nullable();
+            $table->text('content');
+            $table->json('attachments')->nullable();
+            $table->boolean('status')->default(0);
+            $table->unsignedInteger('clicks')->default(0);
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_pages');
+    }
+
+}

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_taggable_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsTaggableTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_taggable', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('tag_id')->index();
+            $table->morphs('taggable');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_taggable');
+    }
+
+}

modules/Cms/Database/Migrations/0000_00_00_000000_create_cms_tags_table.php.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateCmsTagsTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_tags', function (Blueprint $table) {
+            $table->id();
+            $table->string('name')->comment('定位名称');
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_tags');
+    }
+
+}

modules/Cms/Database/Migrations/2021_09_29_142323_create_cms_storages_table.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class CreateCmsStoragesTable extends Migration
+{
+
+    /**
+     * Run the migrations.
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_storages', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->string('url')->nullable();
+            $table->string('cover');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_storages');
+    }
+
+}

modules/Cms/Database/Migrations/2022_10_20_095341_create_cms_logs_table.php

@@ -0,0 +1,33 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class CreateCmsLogsTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('cms_logs', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('user_id')->index();
+            $table->unsignedBigInteger('article_id')->index();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('cms_logs');
+    }
+}

modules/Cms/Http/Controllers/Admin/ArticleController.php

@@ -0,0 +1,136 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use App\Admin\Traits\WithUploads;
+use Encore\Admin\Controllers\AdminController;
+use Encore\Admin\Form;
+use Encore\Admin\Grid;
+use Illuminate\Support\Arr;
+use Modules\Cms\Models\Article;
+use Modules\Cms\Models\Category;
+use Modules\Cms\Models\Tag;
+
+class ArticleController extends AdminController
+{
+
+    use WithUploads;
+
+    protected $title = '文章管理';
+
+    public function grid(): Grid
+    {
+        $grid = new Grid(new Article());
+
+        $grid->model()->with('categories')->withCount('versions');
+
+        $grid->filter(function (Grid\Filter $filter) {
+            $filter->scope('trashed', '回收站')->onlyTrashed();
+
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->like('title', '文章标题');
+                $filter->like('slug', 'SLUG');
+            });
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->like('categories.title', '所属分类');
+                $filter->like('tags.name', '标签');
+            });
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->equal('status', '状态')->select(Article::getStatusMap());
+            });
+        });
+
+        $grid->column('id', '#ID#');
+        $grid->column('categories', '所属分类')->display(function ($categories) {
+            return Arr::pluck($categories, 'title');
+        })->label();
+        //        $grid->column('tags')->pluck('name')->label('warning');
+        $grid->column('title', '文章标题');
+        //        $grid->column('slug', 'SLUG');
+        $grid->column('status', '状态')->bool();
+        $grid->column('clicks', '浏览量');
+        $grid->column('versions_count', '历史版本')->link(function () {
+            return route('admin.cms.versions', [
+                'model' => get_class($this),
+                'key'   => $this->id,
+            ]);
+        }, '_self');
+        $grid->column('created_at', '创建时间');
+
+        return $grid;
+    }
+
+    /**
+     * Notes   : 内容表单
+     * @Date   : 2021/3/15 5:21 下午
+     * @Author : < Jason.C >
+     * @return \Encore\Admin\Form
+     */
+    public function form(): Form
+    {
+        $form = new Form(new Article());
+
+        $form->text('title', '文章标题')
+             ->rules([
+                 'required',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ])
+             ->required();
+//        $form->text('sub_title', '副标题')
+//             ->rules([
+//                 'nullable',
+//                 'max:255',
+//             ], [
+//                 'max' => '标题最大长度不能超过 :max 个字符',
+//             ]);
+//        $form->text('slug', '英文别名')
+//             ->rules([
+//                 'nullable',
+//                 'alpha_dash',
+//             ], [
+//                 'alpha_dash' => '别名中包含非法字符',
+//             ])
+//             ->help('字母、数字、下划线组成，用来展示简短的URL');
+
+        $form->multipleSelect('categories', '所属分类')
+             ->options(Category::selectOptions(function ($model) {
+                 return $model->where('status', 1);
+             }, '请选择文章分类'))
+             ->required();
+
+//        $form->multipleSelect('tags', '内容标签')
+//             ->options(function () {
+//                 return Tag::pluck('name', 'id');
+//             });
+
+        $this->cover($form);
+
+//        $this->pictures($form);
+
+        $form->textarea('description', '文章简介')
+             ->rules([
+                 'nullable',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ]);
+
+        $form->ueditor('content', '文章内容')
+             ->rules([
+                 'required',
+             ], [
+                 'required' => '文章内容不能为空',
+             ])
+             ->required();
+
+        $this->attachments($form);
+
+        $form->switch('status', '状态')
+             ->default(1);
+
+        return $form;
+    }
+
+}

modules/Cms/Http/Controllers/Admin/CategoryController.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use App\Admin\Traits\WithUploads;
+use Closure;
+use Encore\Admin\Controllers\AdminController;
+use Encore\Admin\Form;
+use Encore\Admin\Layout\Column;
+use Encore\Admin\Layout\Row;
+use Encore\Admin\Tree;
+use Encore\Admin\Widgets\Box;
+use Encore\Admin\Widgets\Form as WidgetsForm;
+use Modules\Cms\Models\Category;
+
+class CategoryController extends AdminController
+{
+
+    use WithUploads;
+
+    protected $title = '分类管理';
+
+    public function grid(): Closure
+    {
+        return function (Row $row) {
+            $row->column(6, $this->treeView());
+
+            $row->column(6, function (Column $column) {
+                $form = new WidgetsForm();
+                $this->formData($form, true);
+                $form->action(route('admin.cms.categories.store'));
+                $column->append((new Box('新增分类', $form))->style('success'));
+            });
+        };
+    }
+
+    protected function treeView(): Tree
+    {
+        return Category::tree(function (Tree $tree) {
+            $tree->disableCreate();
+            $tree->branch(function ($branch) {
+                if ($branch['status'] == 1) {
+                    $payload = "<i class='fa fa-eye text-primary'></i> ";
+                } else {
+                    $payload = "<i class='fa fa-eye text-gray'></i> ";
+                }
+
+                $payload .= " [ID:{$branch['id']}] - ";
+                $payload .= " <strong>{$branch['title']}</strong> ";
+
+                return $payload;
+            });
+        });
+    }
+
+    protected function form(): Form
+    {
+        $form = new Form(new Category);
+
+        $this->formData($form);
+
+        return $form;
+    }
+
+    private function formData($form, $hideContent = false)
+    {
+        $form->select('parent_id', '上级分类')
+             ->options(Category::selectOptions(function ($model) {
+                 return $model->where('status', 1);
+             }, '一级分类'))
+             ->required();
+        $form->text('title', '分类名称')
+             ->rules('required');
+        $form->text('slug', '英文别名')
+             ->rules([
+                 'nullable',
+                 'alpha_dash',
+             ], [
+                 'alpha_dash' => '别名中包含非法字符',
+             ])
+             ->help('字母、数字、下划线组成，用来展示简短的URL');
+        $form->textarea('description', '分类简介')
+             ->rules('nullable');
+
+        $this->cover($form);
+
+        $this->pictures($form);
+
+        $form->number('order', '排序')->default(0);
+
+        if (!$hideContent) {
+            $form->ueditor('content', '分类内容');
+        }
+
+        $form->switch('status', '状态')->default(1);
+    }
+
+}

modules/Cms/Http/Controllers/Admin/PageController.php

@@ -0,0 +1,124 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use App\Admin\Traits\WithUploads;
+use Encore\Admin\Controllers\AdminController;
+use Encore\Admin\Form;
+use Encore\Admin\Grid;
+use Modules\Cms\Models\Page;
+use Modules\Cms\Models\Tag;
+
+class PageController extends AdminController
+{
+
+    use WithUploads;
+
+    protected $title = '单页管理';
+
+    public function grid(): Grid
+    {
+        $grid = new Grid(new Page());
+
+        $grid->model()->withCount('versions');
+
+        $grid->filter(function (Grid\Filter $filter) {
+            $filter->scope('trashed', '回收站')->onlyTrashed();
+
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->like('title', '页面标题');
+                $filter->like('tags.name', '标签');
+            });
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->like('slug', 'SLUG');
+            });
+            $filter->column(1 / 3, function (Grid\Filter $filter) {
+                $filter->equal('status', '状态')->select(Page::getStatusMap());
+            });
+        });
+
+        $grid->column('id', '#ID#');
+        $grid->column('title', '页面标题');
+        $grid->column('tags')->pluck('name')->label('warning');
+        $grid->column('slug', '英文别名');
+        $grid->column('status', '状态')->bool();
+        $grid->column('clicks', '浏览量');
+        $grid->column('versions_count', '历史版本')->link(function () {
+            return route('admin.cms.versions', [
+                'model' => get_class($this),
+                'key'   => $this->id,
+            ]);
+        }, '_self');
+        $grid->column('created_at', '创建时间');
+
+        return $grid;
+    }
+
+    /**
+     * Notes   : 内容表单
+     * @Date   : 2021/3/15 5:21 下午
+     * @Author : < Jason.C >
+     * @return \Encore\Admin\Form
+     */
+    public function form(): Form
+    {
+        $form = new Form(new Page());
+
+        $form->text('title', '页面标题')
+             ->rules([
+                 'required',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ])
+             ->required();
+        $form->text('sub_title', '副标题')
+             ->rules([
+                 'nullable',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ]);
+        $form->text('slug', '英文别名')
+             ->rules([
+                 'nullable',
+                 'alpha_dash',
+             ], [
+                 'alpha_dash' => '别名中包含非法字符',
+             ])
+             ->help('字母、数字、下划线组成，用来展示简短的URL');
+
+        $form->multipleSelect('tags', '页面标签')
+             ->options(function () {
+                 return Tag::pluck('name', 'id');
+             });
+
+        $this->cover($form);
+
+        $this->pictures($form);
+
+        $form->textarea('description', '页面简介')
+             ->rules([
+                 'nullable',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ]);
+
+        $form->ueditor('content', '页面内容')
+             ->rules([
+                 'required',
+             ], [
+                 'required' => '页面内容不能为空',
+             ])
+             ->required();
+
+        $this->attachments($form);
+
+        $form->switch('status', '状态')
+             ->default(1);
+
+        return $form;
+    }
+
+}

modules/Cms/Http/Controllers/Admin/StorageController.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use App\Admin\Traits\WithUploads;
+use Encore\Admin\Controllers\AdminController;
+use Encore\Admin\Form;
+use Encore\Admin\Grid;
+use Modules\Cms\Models\Storage;
+
+class StorageController extends AdminController
+{
+
+    use WithUploads;
+
+    protected $title = '素材管理';
+
+    public function grid(): Grid
+    {
+        $grid = new Grid(new Storage());
+
+        $grid->column('id', '#ID#');
+        $grid->column('name', '素材标题');
+        $grid->column('地址')->display(function () {
+            return $this->cover_text;
+        });
+
+        return $grid;
+    }
+
+    public function form(): Form
+    {
+        $form = new Form(new Storage());
+
+        $form->text('name', '素材标题')
+             ->rules([
+                 'required',
+                 'max:255',
+             ], [
+                 'max' => '标题最大长度不能超过 :max 个字符',
+             ])
+             ->required();
+        $this->cover($form);
+        $form->url('url', '素材地址');
+
+        return $form;
+    }
+
+}

modules/Cms/Http/Controllers/Admin/TagController.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use Encore\Admin\Controllers\AdminController;
+use Encore\Admin\Form;
+use Encore\Admin\Grid;
+use Modules\Cms\Models\Tag;
+
+class TagController extends AdminController
+{
+
+    protected $title = '标签管理';
+
+    public function grid(): Grid
+    {
+        $grid = new Grid(new Tag());
+
+        $grid->model()
+             ->withCount(['articles', 'pages'])
+             ->orderByDesc('id');
+
+        $grid->filter(function (Grid\Filter $filter) {
+            $filter->scope('trashed', '回收站')->onlyTrashed();
+
+            $filter->column(1 / 2, function (Grid\Filter $filter) {
+                $filter->like('name', '标签名称');
+            });
+        });
+
+        $grid->column('name', '标签名称');
+        $grid->column('articles_count');
+        $grid->column('pages_count');
+        $grid->column('created_at', '创建时间');
+
+        return $grid;
+    }
+
+    public function form(): Form
+    {
+        $form = new Form(new Tag());
+
+        $form->text('name', '标签名称');
+
+        return $form;
+    }
+
+}

modules/Cms/Http/Controllers/Admin/VersionController.php

@@ -0,0 +1,68 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Admin;
+
+use Encore\Admin\Auth\Database\Administrator;
+use Encore\Admin\Grid;
+use Encore\Admin\Layout\Content;
+use Encore\Admin\Widgets\Table;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Routing\Controller;
+use Overtrue\LaravelVersionable\Version;
+
+class VersionController extends Controller
+{
+
+    public function index(Content $content, $model, $key): Content
+    {
+        return $content
+            ->header($model . ' => ' . $key)
+            ->description('数据操作日志')
+            ->body($this->grid($model, $key));
+    }
+
+    public function grid($model, $key): Grid
+    {
+        $grid = new Grid(new Version());
+
+        $grid->disableCreateButton();
+        $grid->disableActions();
+        $grid->disableTools();
+
+        $grid->model()->whereHasMorph(
+            'versionable',
+            $model,
+            function (Builder $query) use ($key) {
+                $query->where('id', $key);
+            }
+        )->orderByDesc('id');
+
+        $grid->column('操作用户')->display(function () {
+            if ($this->user_id < config('mall.administrator_max_id')) {
+                config(['versionable.user_model' => Administrator::class]);
+
+                return '[Admin] ' . ($this->user->name ?? '--SYSTEM--');
+            } else {
+                return '[USER] ' . ($this->user->username ?? '--USER--');
+            }
+        });
+        $grid->column('versionable_type', '数据变动')->expand(function () {
+            $data = [];
+            foreach ($this->contents as $key => $item) {
+                $data[] = [
+                    $key,
+                    is_array($item) ? json_encode($item, JSON_UNESCAPED_UNICODE) : $item,
+                ];
+            }
+
+            return new Table(['字段名称', '变更值'], $data);
+        });
+
+        $grid->column('操作时间')->display(function () {
+            return $this->created_at->toDateTimeString();
+        });
+
+        return $grid;
+    }
+
+}

modules/Cms/Http/Controllers/Api/ArticleController.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Api;
+
+use App\Api\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Jason\Api\Api;
+use Modules\Cms\Http\Resources\ArticleCollection;
+use Modules\Cms\Http\Resources\ArticleResource;
+use Modules\Cms\Models\Article;
+
+class ArticleController extends Controller
+{
+
+    /**
+     * Notes   : 文章列表
+     *
+     * @Date   : 2021/4/16 10:45 上午
+     * @Author : < Jason.C >
+     * @param  Request  $request
+     * @return mixed
+     */
+    public function index(Request $request)
+    {
+        $categoryId = $request->category_id;
+        $title      = $request->title;
+        $subTitle   = $request->sub_title;
+        $slug       = $request->slug;
+        $tagId      = $request->tag_id;
+
+        $result = Article::query()
+            ->when($title, function ($query) use ($title) {
+                $query->where('title', 'like', "%{$title}%");
+            })
+            ->when($subTitle, function ($query) use ($subTitle) {
+                $query->where('sub_title', 'like', "%{$subTitle}%");
+            })
+            ->when($slug, function ($query) use ($slug) {
+                $query->where('slug', 'like', "%{$slug}%");
+            })
+            ->when($categoryId, function ($query) use ($categoryId) {
+                $query->whereHas('categories', function ($cate) use ($categoryId) {
+                    $cate->where('category_id', $categoryId);
+                });
+            })
+            ->when($tagId, function ($query) use ($tagId) {
+                $query->whereHas('tags', function ($tag) use ($tagId) {
+                    $tag->where('tag_id', $tagId);
+                });
+            })
+            ->where('status', 1)
+            ->with(['categories', 'tags'])
+            ->paginate(10);
+
+        return $this->success(new ArticleCollection($result));
+    }
+
+    /**
+     * Notes   : 文章详情
+     *
+     * @Date   : 2021/4/16 10:45 上午
+     * @Author : < Jason.C >
+     * @param  Article  $article
+     * @return mixed
+     */
+    public function show(Article $article)
+    {
+        $article->read(Api::userId());
+
+        return $this->success(new ArticleResource($article));
+    }
+
+    /**
+     * Notes: 收藏/取消收藏
+     *
+     * @Author: 玄尘
+     * @Date: 2022/10/11 9:59
+     */
+    public function favorite(Article $article): JsonResponse
+    {
+        $user = Api::user();
+
+        $user->toggleFavorite($article);
+
+        return $this->success([
+            'count'    => $article->favorites()->count(),
+            'favorite' => $user->hasFavorited($article),
+        ]);
+    }
+
+    /**
+     * Notes: 点赞/取消点赞
+     *
+     * @Author: 玄尘
+     * @Date: 2022/10/11 10:18
+     * @param  Article  $article
+     * @return JsonResponse
+     * @throws \Exception
+     */
+    public function subscribe(Article $article): JsonResponse
+    {
+        $user = Api::user();
+
+        $user->toggleSubscribe($article);
+
+        return $this->success([
+            'count'      => $article->subscribers()->count(),
+            'subscribed' => $user->hasSubscribed($article),
+        ]);
+    }
+
+}

modules/Cms/Http/Controllers/Api/CategoryController.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Api;
+
+use App\Api\Controllers\Controller;
+use Illuminate\Http\Request;
+use Modules\Cms\Http\Resources\CategoryCollection;
+use Modules\Cms\Http\Resources\CategoryResource;
+use Modules\Cms\Models\Category;
+
+class CategoryController extends Controller
+{
+
+    /**
+     * Notes   : 分类首页
+     * @Date   : 2021/4/19 9:29 上午
+     * @Author : < Jason.C >
+     * @param  \Illuminate\Http\Request  $request
+     * @return mixed
+     */
+    public function index(Request $request)
+    {
+        $parentId = $request->get('parent_id', 0);
+
+        if (!is_integer($parentId)) {
+            return $this->failed('The param must be integer');
+        }
+
+        $result = Category::where('parent_id', $parentId)
+                          ->where('status', 1)
+                          ->orderBy('order', 'asc')
+                          ->get();
+
+        return $this->success(new CategoryCollection($result));
+    }
+
+    /**
+     * Notes   : 分类的详情
+     * @Date   : 2021/4/19 9:29 上午
+     * @Author : < Jason.C >
+     * @param  \Modules\Cms\Models\Category  $category
+     * @return mixed
+     */
+    public function show(Category $category)
+    {
+
+        return $this->success(new CategoryResource($category));
+    }
+
+}

modules/Cms/Http/Controllers/Api/PageController.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Api;
+
+use App\Api\Controllers\Controller;
+use Illuminate\Http\Request;
+use Modules\Cms\Http\Resources\PageCollection;
+use Modules\Cms\Http\Resources\PageResource;
+use Modules\Cms\Models\Page;
+
+class PageController extends Controller
+{
+
+    /**
+     * Notes   : 单页列表
+     *
+     * @Date   : 2021/4/16 10:45 上午
+     * @Author : < Jason.C >
+     * @param  \Illuminate\Http\Request  $request
+     * @return mixed
+     */
+    public function index(Request $request)
+    {
+        $title    = $request->title;
+        $subTitle = $request->sub_title;
+        $slug     = $request->slug;
+        $tagId    = $request->tag_id;
+
+        $result = Page::when($title, function ($query) use ($title) {
+            $query->where('title', 'like', "%{$title}%");
+        })->when($subTitle, function ($query) use ($subTitle) {
+            $query->where('sub_title', 'like', "%{$subTitle}%");
+        })->when($slug, function ($query) use ($slug) {
+            $query->where('slug', 'like', "%{$slug}%");
+        })->when($tagId, function ($query) use ($tagId) {
+            $query->whereHas('tags', function ($tag) use ($tagId) {
+                $tag->where('tag_id', $tagId);
+            });
+        })->where('status', 1)->with(['tags'])->paginate();
+
+        $result = new PageCollection($result);
+
+        return $this->success($result);
+    }
+
+    /**
+     * Notes   : 单页详情
+     *
+     * @Date   : 2021/4/16 11:25 上午
+     * @Author : < Jason.C >
+     * @param  \Modules\Cms\Models\Page  $page
+     * @return mixed
+     */
+    public function show(Page $page)
+    {
+        $page->incrementClicks();
+
+        return $this->success(new PageResource($page));
+    }
+
+    /**
+     * Notes: 隐私条款
+     *
+     * @Author: 玄尘
+     * @Date: 2022/8/29 11:59
+     */
+    public function secret()
+    {
+        $info = Page::where('slug', 'secret')->first();
+        $info->incrementClicks();
+
+        return $this->success(new PageResource($info));
+    }
+
+    /**
+     * Notes: 服务协议
+     *
+     * @Author: 玄尘
+     * @Date: 2022/8/29 12:00
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function protocol()
+    {
+        $info = Page::where('slug', 'protocol')->first();
+        $info->incrementClicks();
+
+        return $this->success(new PageResource($info));
+    }
+
+}

modules/Cms/Http/Controllers/Api/TagController.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Modules\Cms\Http\Controllers\Api;
+
+use App\Api\Controllers\Controller;
+use Illuminate\Http\Request;
+use Modules\Cms\Http\Resources\TagCollection;
+use Modules\Cms\Http\Resources\TagResource;
+use Modules\Cms\Models\Tag;
+
+class TagController extends Controller
+{
+
+    /**
+     * Notes   : 标签列表
+     * @Date   : 2021/4/25 1:31 下午
+     * @Author : < Jason.C >
+     * @param  \Illuminate\Http\Request  $request
+     * @return mixed
+     */
+    public function index(Request $request)
+    {
+        $name = $request->name;
+
+        $tags = Tag::when($name, function ($query) use ($name) {
+            $query->where('name', 'like', "%{$name}%");
+        })->orderByDesc('id')->paginate();
+
+        return $this->success(new TagCollection($tags));
+    }
+
+    public function show(Tag $tag)
+    {
+        return $this->success(new TagResource($tag));
+    }
+
+}

modules/Cms/Http/Resources/ArticleBaseResource.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class ArticleBaseResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'article_id'  => $this->id,
+            'title'       => $this->title,
+            //                    'sub_title'   => $this->sub_title,
+            'description' => $this->description,
+            //                    'slug'        => $this->slug,
+            'categories'  => CategoryBaseResource::collection($this->categories),
+            'tags'        => TagResource::collection($this->tags),
+            'cover'       => $this->cover_url,
+            'pictures'    => $this->pictures_url,
+            'clicks'      => $this->clicks,
+            'favorites'   => $this->favorites()->count(),
+            'subscribes'  => $this->subscribers()->count(),
+            'created_at'  => (string) $this->created_at,
+        ];
+    }
+
+}

modules/Cms/Http/Resources/ArticleCollection.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class ArticleCollection extends ResourceCollection
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'data' => $this->collection->map(function ($article) {
+                return new ArticleBaseResource($article);
+            }),
+            'page' => $this->page(),
+        ];
+    }
+
+    protected function page(): array
+    {
+        return [
+            'current'    => $this->currentPage(),
+            'total_page' => $this->lastPage(),
+            'per_page'   => $this->perPage(),
+            'has_more'   => $this->hasMorePages(),
+            'total'      => $this->total(),
+        ];
+    }
+
+}

modules/Cms/Http/Resources/ArticleResource.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+use Jason\Api\Api;
+
+class ArticleResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        $user = Api::user();
+
+        return [
+            'article_id'   => $this->id,
+            'title'        => $this->title,
+            //            'sub_title'   => $this->sub_title,
+            'description'  => $this->description,
+            //            'slug'        => $this->slug,
+            'categories'   => CategoryBaseResource::collection($this->categories),
+            'tags'         => TagResource::collection($this->tags),
+            'cover'        => $this->cover_url,
+            'pictures'     => $this->pictures_url,
+            'clicks'       => $this->clicks,
+            'favorites'    => $this->favorites()->count(),
+            'subscribes'   => $this->subscribers()->count(),
+            'isFavorite'   => $user && $this->isFavoritedBy($user),
+            'isSubscribed' => $user && $this->isSubscribedBy($user),
+            'content'      => $this->content,
+            'attachments'  => $this->attachments,
+            'created_at'   => (string) $this->created_at,
+        ];
+    }
+
+}

modules/Cms/Http/Resources/CategoryBaseResource.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CategoryBaseResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'category_id' => $this->id,
+            'title'       => $this->title,
+            'slug'        => $this->slug,
+        ];
+    }
+
+}

modules/Cms/Http/Resources/CategoryCollection.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class CategoryCollection extends ResourceCollection
+{
+
+    /**
+     * Notes   :
+     * @Date   : 2021/4/25 1:32 下午
+     * @Author : < Jason.C >
+     * @param  \Illuminate\Http\Request  $request
+     * @return array
+     */
+    public function toArray($request): array
+    {
+        return $this->collection->map(function ($category) {
+            return [
+                'category_id' => $category->id,
+                'title'       => $category->title,
+                'slug'        => $category->slug,
+                'description' => $category->description,
+                'cover'       => $category->cover_url,
+                'pictures'    => $category->pictures_url,
+                'created_at'  => (string) $category->created_at,
+                'children'    => new self($category->children),
+            ];
+        })->toArray();
+    }
+
+}

modules/Cms/Http/Resources/CategoryResource.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class CategoryResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'category_id' => $this->id,
+            'parent'      => new self($this->parent),
+            'title'       => $this->title,
+            'slug'        => $this->slug,
+            'description' => $this->description,
+            'cover'       => $this->cover_url,
+            'pictures'    => $this->pictures_url,
+            'content'     => $this->content,
+            'created_at'  => (string) $this->created_at,
+        ];
+    }
+
+}

modules/Cms/Http/Resources/PageCollection.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class PageCollection extends ResourceCollection
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'data' => $this->collection->map(function ($page) {
+                return [
+                    'page_id'     => $page->id,
+                    'title'       => $page->title,
+                    'sub_title'   => $page->sub_title,
+                    'tags'        => TagResource::collection($page->tags),
+                    'description' => $page->description,
+                    'slug'        => $page->slug,
+                    'cover'       => $page->cover_url,
+                    'pictures'    => $page->pictures_url,
+                    'clicks'      => $page->clicks,
+                    'created_at'  => (string) $page->created_at,
+                ];
+            }),
+            'page' => $this->page(),
+        ];
+    }
+
+    protected function page(): array
+    {
+        return [
+            'current'    => $this->currentPage(),
+            'total_page' => $this->lastPage(),
+            'per_page'   => $this->perPage(),
+            'has_more'   => $this->hasMorePages(),
+            'total'      => $this->total(),
+        ];
+    }
+
+}

modules/Cms/Http/Resources/PageResource.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class PageResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'page_id'     => $this->id,
+            'title'       => $this->title,
+            'sub_title'   => $this->sub_title,
+            'tags'        => TagResource::collection($this->tags),
+            'description' => $this->description,
+            'slug'        => $this->slug,
+            'cover'       => $this->cover_url,
+            'pictures'    => $this->pictures_url,
+            'clicks'      => $this->clicks,
+            'content'     => $this->content,
+            'attachments' => $this->attachments_url,
+            'created_at'  => (string) $this->created_at,
+        ];
+    }
+
+}

modules/Cms/Http/Resources/TagCollection.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class TagCollection extends ResourceCollection
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'data' => $this->collection->map(function ($tag) {
+                return new TagResource($tag);
+            }),
+            'page' => $this->page(),
+        ];
+    }
+
+    protected function page(): array
+    {
+        return [
+            'current'    => $this->currentPage(),
+            'total_page' => $this->lastPage(),
+            'per_page'   => $this->perPage(),
+            'has_more'   => $this->hasMorePages(),
+            'total'      => $this->total(),
+        ];
+    }
+
+}

modules/Cms/Http/Resources/TagResource.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Modules\Cms\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class TagResource extends JsonResource
+{
+
+    public function toArray($request): array
+    {
+        return [
+            'tag_id' => $this->id,
+            'name'   => $this->name,
+        ];
+    }
+
+}

modules/Cms/Models/Article.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use App\Models\Model;
+use App\Traits\HasClicks;
+use App\Traits\HasCovers;
+use App\Traits\HasStatus;
+use App\Traits\OrderByIdDesc;
+use Encore\Admin\Traits\Resizable;
+use GeneaLabs\LaravelModelCaching\Traits\Cachable;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Storage;
+use Modules\Cms\Traits\HasTags;
+use Modules\Task\Facades\TaskFacade;
+use Modules\Task\Models\Task;
+use Overtrue\LaravelFavorite\Traits\Favoriteable;
+use Overtrue\LaravelSubscribe\Traits\Subscribable;
+use Overtrue\LaravelVersionable\Versionable;
+
+class Article extends Model
+{
+
+    use Cachable,
+        HasClicks,
+        HasCovers,
+        HasTags,
+        Subscribable,
+        Favoriteable,
+        HasStatus,
+        OrderByIdDesc,
+        Resizable,
+        Versionable,
+        SoftDeletes;
+
+    protected $table = 'cms_articles';
+
+    protected $casts = [
+        'pictures'    => 'json',
+        'attachments' => 'json',
+    ];
+
+    /**
+     * 不参与版本记录的字段
+     *
+     * @var array|string[]
+     */
+    protected array $dontVersionable = ['clicks', 'updated_at'];
+
+    /**
+     * Notes: 阅读记录
+     *
+     * @Author: 玄尘
+     * @Date: 2022/10/20 9:57
+     * @return HasMany
+     */
+    public function logs(): HasMany
+    {
+        return $this->hasMany(Log::class);
+    }
+
+    /**
+     * Notes: 阅读
+     *
+     * @Author: 玄尘
+     * @Date: 2022/10/20 9:57
+     * @param  int  $user_id
+     */
+    public function read($user_id = '')
+    {
+        $this->incrementClicks();
+        if ($user_id) {
+            $this->logs()->create([
+                'user_id' => $user_id
+            ]);
+
+            if (Task::query()->shown()->where('key', 'tour_article')->first()) {
+                # todo 阅读得水滴
+                TaskFacade::do('tour_article', $user_id);
+            }
+
+            if (Task::query()->shown()->where('key',
+                    'read_article')->first() && $this->categories()->Health()->first()) {
+                # todo 阅读100次得水滴
+                TaskFacade::do('read_article', $user_id);
+            }
+
+
+        }
+    }
+
+    /**
+     * Notes   : 文章所属分类
+     *
+     * @Date   : 2021/4/15 12:44 下午
+     * @Author : < Jason.C >
+     * @return BelongsToMany
+     */
+    public function categories(): BelongsToMany
+    {
+        return $this->belongsToMany(Category::class, 'cms_article_category')
+            ->using(ArticleCategory::class)
+            ->withTimestamps();
+    }
+
+    /**
+     * Notes   : 获取附件的下载地址
+     *
+     * @Date   : 2021/4/16 12:01 下午
+     * @Author : < Jason.C >
+     * @return Collection
+     */
+    public function getAttachmentsUrlAttribute(): Collection
+    {
+        return collect($this->attachments)->map(function ($item) {
+            return Storage::url($item);
+        });
+    }
+
+}

modules/Cms/Models/ArticleCategory.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use Illuminate\Database\Eloquent\Relations\Pivot;
+
+class ArticleCategory extends Pivot
+{
+
+    public $incrementing = true;
+
+    public $table        = 'cms_article_category';
+
+}

modules/Cms/Models/Category.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use App\Models\Model;
+use App\Traits\HasCovers;
+use Encore\Admin\Traits\AdminBuilder;
+use Encore\Admin\Traits\ModelTree;
+use GeneaLabs\LaravelModelCaching\Traits\Cachable;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Overtrue\LaravelVersionable\Versionable;
+
+class Category extends Model
+{
+
+    use AdminBuilder,
+        Cachable,
+        HasCovers,
+        ModelTree,
+        Versionable,
+        SoftDeletes;
+
+    protected $table = 'cms_categories';
+
+    protected $casts = [
+        'pictures' => 'json',
+    ];
+
+    /**
+     * 不参与版本记录的字段
+     *
+     * @var array|string[]
+     */
+    protected array $dontVersionable = ['updated_at'];
+
+    public function children(): HasMany
+    {
+        return $this->hasMany(self::class, 'parent_id');
+    }
+
+    /**
+     * Notes   : 分类下的文章
+     *
+     * @Date   : 2021/4/15 12:47 下午
+     * @Author : < Jason.C >
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany
+     */
+    public function articles(): BelongsToMany
+    {
+        return $this->belongsToMany(Article::class, (new ArticleCategory())->getTable())
+            ->using(ArticleCategory::class)
+            ->withTimestamps();
+    }
+
+    /**
+     * Notes: 健康文章
+     *
+     * @Author: 玄尘
+     * @Date: 2022/10/31 10:05
+     */
+    public function scopeHealth(Builder $query): Builder
+    {
+        return $query->where('slug', 'HEALTH');
+    }
+
+}

modules/Cms/Models/Log.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+
+use App\Models\Model;
+use Modules\User\Traits\BelongsToUser;
+
+class Log extends Model
+{
+    use BelongsToUser;
+
+    protected $table = 'cms_logs';
+
+}

modules/Cms/Models/Page.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use App\Models\Model;
+use App\Traits\HasClicks;
+use App\Traits\HasCovers;
+use App\Traits\HasStatus;
+use App\Traits\OrderByIdDesc;
+use GeneaLabs\LaravelModelCaching\Traits\Cachable;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Storage;
+use Modules\Cms\Traits\HasTags;
+use Overtrue\LaravelVersionable\Versionable;
+
+class Page extends Model
+{
+
+    use Cachable,
+        HasClicks,
+        HasCovers,
+        HasTags,
+        HasStatus,
+        OrderByIdDesc,
+        Versionable,
+        SoftDeletes;
+
+    protected $table = 'cms_pages';
+
+    protected $casts = [
+        'pictures'    => 'json',
+        'attachments' => 'json',
+    ];
+
+    /**
+     * 不参与版本记录的字段
+     * @var array|string[]
+     */
+    protected array $dontVersionable = ['updated_at'];
+
+    /**
+     * Notes   : 获取附件的下载地址
+     * @Date   : 2021/4/16 12:01 下午
+     * @Author : < Jason.C >
+     * @return \Illuminate\Support\Collection
+     */
+    public function getAttachmentsUrlAttribute(): Collection
+    {
+        return collect($this->attachments)->map(function ($item) {
+            return Storage::url($item);
+        });
+    }
+
+}

modules/Cms/Models/Storage.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use App\Models\Model;
+use App\Traits\HasCovers;
+
+class Storage extends Model
+{
+
+    use HasCovers;
+
+    protected $table = 'cms_storages';
+
+    public function getCoverTextAttribute()
+    {
+        if ($this->url) {
+            return $this->url . '/' . $this->cover;
+        } else {
+            return $this->cover_url;
+        }
+    }
+
+}

modules/Cms/Models/Tag.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use App\Models\Model;
+use GeneaLabs\LaravelModelCaching\Traits\Cachable;
+use Illuminate\Database\Eloquent\Relations\MorphToMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Tag extends Model
+{
+
+    use Cachable,
+        SoftDeletes;
+
+    protected $table = 'cms_tags';
+
+    /**
+     * 不参与版本记录的字段
+     * @var array|string[]
+     */
+    protected array $dontVersionable = ['updated_at'];
+
+    public function articles(): MorphToMany
+    {
+        return $this->morphedByMany(Article::class, 'taggable', 'cms_taggable');
+    }
+
+    public function pages(): MorphToMany
+    {
+        return $this->morphedByMany(Page::class, 'taggable', 'cms_taggable');
+    }
+
+}

modules/Cms/Models/Taggable.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Modules\Cms\Models;
+
+use Illuminate\Database\Eloquent\Relations\MorphPivot;
+
+class Taggable extends MorphPivot
+{
+
+    public    $incrementing = true;
+
+    protected $table        = 'cms_taggable';
+
+}

modules/Cms/Providers/CmsServiceProvider.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace Modules\Cms\Providers;
+
+use Illuminate\Support\ServiceProvider;
+
+class CmsServiceProvider extends ServiceProvider
+{
+
+    /**
+     * @var string $moduleName
+     */
+    protected string $moduleName = 'Cms';
+
+    /**
+     * @var string $moduleNameLower
+     */
+    protected string $moduleNameLower = 'cms';
+
+    /**
+     * Boot the application events.
+     * @return void
+     */
+    public function boot()
+    {
+        $this->loadMigrationsFrom(module_path($this->moduleName, 'Database/Migrations'));
+    }
+
+    /**
+     * Register the service provider.
+     * @return void
+     */
+    public function register()
+    {
+        $this->registerConfig();
+
+        $this->app->register(RouteServiceProvider::class);
+    }
+
+    /**
+     * Register config.
+     * @return void
+     */
+    protected function registerConfig()
+    {
+        $this->publishes([
+            module_path($this->moduleName, 'Config/config.php') => config_path($this->moduleNameLower . '.php'),
+        ], 'config');
+        $this->mergeConfigFrom(
+            module_path($this->moduleName, 'Config/config.php'), $this->moduleNameLower
+        );
+    }
+
+    /**
+     * Get the services provided by the provider.
+     * @return array
+     */
+    public function provides(): array
+    {
+        return [];
+    }
+
+}

modules/Cms/Providers/RouteServiceProvider.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace Modules\Cms\Providers;
+
+use Illuminate\Foundation\Support\Providers\RouteServiceProvider as ServiceProvider;
+use Illuminate\Support\Facades\Route;
+
+class RouteServiceProvider extends ServiceProvider
+{
+
+    /**
+     * @var string $moduleName
+     */
+    protected string $moduleName = 'Cms';
+
+    /**
+     * The module namespace to assume when generating URLs to actions.
+     * @var string
+     */
+    protected string $moduleNamespace = 'Modules\Cms\Http\Controllers';
+
+    /**
+     * Called before routes are registered.
+     * Register any model bindings or pattern based filters.
+     * @return void
+     */
+    public function boot()
+    {
+        parent::boot();
+    }
+
+    /**
+     * Define the routes for the application.
+     * @return void
+     */
+    public function map()
+    {
+        $this->mapAdminRoutes();
+        $this->mapApiRoutes();
+    }
+
+    protected function mapApiRoutes()
+    {
+        Route::as(config('api.route.as'))
+             ->domain(config('api.route.domain'))
+             ->middleware(config('api.route.middleware'))
+             ->namespace($this->moduleNamespace)
+             ->prefix(config('api.route.prefix'))
+             ->group(module_path($this->moduleName, 'Routes/api.php'));
+    }
+
+    protected function mapAdminRoutes()
+    {
+        Route::as(config('admin.route.as'))
+             ->domain(config('admin.route.domain'))
+             ->middleware(config('admin.route.middleware'))
+             ->namespace($this->moduleNamespace)
+             ->prefix(config('admin.route.prefix'))
+             ->group(module_path($this->moduleName, 'Routes/admin.php'));
+    }
+
+}

modules/Cms/README.md

@@ -0,0 +1,49 @@
+# CMS
+
+## 安装
+
+```shell
+composer require overtrue/laravel-versionable
+```
+
+## 接口文档
+
+### 1. 文章
+
+#### 1. 文章列表
+
+> GET: /api/cms/articles
+
+#### 2. 文章详情
+
+> GET: /api/cms/articles/{article_id}
+
+### 2. 单页
+
+#### 1. 单页列表
+
+> GET: /api/cms/pages
+
+#### 2. 单页详情
+
+> GET: /api/cms/pages/{page_id}
+
+### 3. 分类
+
+#### 1. 分类列表
+
+> GET: /api/cms/categories
+
+#### 2. 分类详情
+
+> GET: /api/cms/categories/{category_id}
+
+### 4. 标签
+
+#### 1. 标签列表
+
+> GET: /api/cms/tags
+
+#### 2. 标签详情
+
+> GET: /api/cms/tags/{tag_id}

modules/Cms/Routes/admin.php

@@ -0,0 +1,17 @@
+<?php
+
+use Illuminate\Routing\Router;
+use Illuminate\Support\Facades\Route;
+
+Route::group([
+    'prefix'    => 'cms',
+    'namespace' => 'Admin',
+    'as'        => 'cms.',
+], function (Router $router) {
+    $router->resource('articles', 'ArticleController');
+    $router->resource('pages', 'PageController');
+    $router->resource('categories', 'CategoryController');
+    $router->resource('tags', 'TagController');
+    $router->resource('storages', 'StorageController');
+    $router->get('versions/{model}/{key}', 'VersionController@index')->name('versions');
+});

modules/Cms/Routes/api.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Routing\Router;
+use Illuminate\Support\Facades\Route;
+
+Route::group([
+    'prefix'     => 'cms',
+    'namespace'  => 'Api',
+    'middleware' => config('api.route.middleware_guess'),
+], function (Router $router) {
+    $router->get('articles', 'ArticleController@index');
+    $router->get('articles/{article}', 'ArticleController@show');
+
+    $router->get('pages', 'PageController@index');
+    $router->get('pages/secret', 'PageController@secret');
+    $router->get('pages/protocol', 'PageController@protocol');
+    $router->get('pages/{page}', 'PageController@show');
+
+    $router->get('categories', 'CategoryController@index');
+    $router->get('categories/{category}', 'CategoryController@show');
+
+    $router->get('tags', 'TagController@index');
+    $router->get('tags/{tag}', 'TagController@show');
+});
+
+Route::group([
+    'prefix'     => 'cms',
+    'namespace'  => 'Api',
+    'middleware' => config('api.route.middleware_auth'),
+], function (Router $router) {
+    $router->get('articles/favorite/{article}', 'ArticleController@favorite');//收藏、取消收藏
+    $router->get('articles/subscribe/{article}', 'ArticleController@subscribe');//点赞、取消点赞
+
+});

modules/Cms/Traits/HasTags.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Modules\Cms\Traits;
+
+use Illuminate\Database\Eloquent\Relations\MorphToMany;
+use Modules\Cms\Models\Tag;
+use Modules\Cms\Models\Taggable;
+
+trait HasTags
+{
+
+    /**
+     * Notes   : 拥有内容标签
+     * @Date   : 2021/4/25 12:58 下午
+     * @Author : < Jason.C >
+     * @return \Illuminate\Database\Eloquent\Relations\MorphToMany
+     */
+    public function tags(): MorphToMany
+    {
+        return $this->morphToMany(Tag::class, 'taggable', 'cms_taggable')
+                    ->using(Taggable::class)
+                    ->withTimestamps();
+    }
+
+}

modules/Cms/composer.json

@@ -0,0 +1,34 @@
+{
+    "name": "uztech/cms-module",
+    "description": "内容模块",
+    "type": "laravel-module",
+    "authors": [
+        {
+            "name": "Jason.Chen",
+            "email": "chenjxlg@163.com"
+        }
+    ],
+    "require": {
+        "php": "^7.3|^8.0",
+        "encore/laravel-admin": "^1.8",
+        "genealabs/laravel-model-caching": "^0.11.3",
+        "jasonc/api": "^5.0.0",
+        "joshbrw/laravel-module-installer": "^2.0",
+        "laravel/framework": "^8.5",
+        "nwidart/laravel-modules": "^8.2",
+        "overtrue/laravel-versionable": "^2.6"
+    },
+    "extra": {
+        "module-dir": "modules",
+        "laravel": {
+            "providers": [],
+            "aliases": {
+            }
+        }
+    },
+    "autoload": {
+        "psr-4": {
+            "Modules\\Cms\\": ""
+        }
+    }
+}

modules/Cms/module.json

@@ -0,0 +1,15 @@
+{
+    "name": "Cms",
+    "alias": "cms",
+    "description": "内容管理模块",
+    "keywords": [],
+    "priority": 0,
+    "providers": [
+        "Modules\\Cms\\Providers\\CmsServiceProvider"
+    ],
+    "aliases": {},
+    "files": [],
+    "requires": [],
+    "version": "1.0.0",
+    "author": "Jason.Chen"
+}