YwxApp/YwxAppThink
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: 重写初始提交(清空历史,整理后全量提交)

Browse Source
This commit is contained in:
ywxapp
2026-08-16 16:54:14 +08:00
commit 6c1a106bc1
1808 changed files with 238144 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
addon/docs/controller/backend/Version.php
+222
View File
@@ -0,0 +1,222 @@
<?php
// +----------------------------------------------------------------------
// | YwxApp [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Author: ywxapp<admin@ywxapp.cn>
// +----------------------------------------------------------------------
declare (strict_types = 1);
namespace addon\docs\controller\backend;
use addon\docs\model\DocsDoc;
use addon\docs\model\DocsProject;
use addon\docs\model\DocsVersion;
use addon\docs\service\DocSearchService;
use addon\docs\service\DocTreeService;
use ywxapp\controller\BackendBase;
/**
* 文档版本管理
*
* @author ywxapp <admin@ywxapp.cn>
*/
class Version extends BackendBase
{
/**
* 版本列表
*/
public function index()
{
$projectId = (int) $this->request->get('project_id', 0);
$projects = DocsProject::order('sort', 'asc')->order('id', 'asc')->select()->toArray();
// 未指定项目时默认展示第一个项目，避免空白页
if ($projectId <= 0 && !empty($projects)) {
$projectId = (int) $projects[0]['id'];
}
$list = [];
if ($projectId > 0) {
$list = DocsVersion::where('project_id', $projectId)
->order('sort', 'asc')->order('id', 'asc')
->select()->toArray();
foreach ($list as &$item) {
$item['doc_count'] = DocsDoc::where('version_id', $item['id'])->count();
}
unset($item);
}
$this->assign('list', $list);
$this->assign('projects', $projects);
$this->assign('projectId', $projectId);
return $this->fetch('version/index');
}
/**
* 新增页面
*/
public function add()
{
$this->assign('projects', DocsProject::order('sort', 'asc')->select()->toArray());
$this->assign('projectId', (int) $this->request->get('project_id', 0));
return $this->fetch('version/add');
}
/**
* 保存新增
*/
public function save()
{
$data = $this->collect();
if (is_string($data)) {
return $this->result->error($data);
}
$exists = DocsVersion::where('project_id', $data['project_id'])
->where('name', $data['name'])->find();
if ($exists) {
return $this->result->error('该项目下已存在同名版本');
}
$version = DocsVersion::create($data);
$this->syncDefault($version);
DocTreeService::clearCache();
return $this->result->success(null, '添加成功');
}
/**
* 编辑页面
*
* @param int $id 版本ID
*/
public function edit($id = null)
{
$version = DocsVersion::find((int) $id);
if (!$version) {
return $this->result->error('版本不存在');
}
$this->assign('item', $version);
$this->assign('projects', DocsProject::order('sort', 'asc')->select()->toArray());
return $this->fetch('version/edit');
}
/**
* 保存编辑
*
* @param int $id 版本ID
*/
public function update($id)
{
$version = DocsVersion::find((int) $id);
if (!$version) {
return $this->result->error('版本不存在');
}
$data = $this->collect();
if (is_string($data)) {
return $this->result->error($data);
}
$exists = DocsVersion::where('project_id', $data['project_id'])
->where('name', $data['name'])
->where('id', '<>', $version->id)
->find();
if ($exists) {
return $this->result->error('该项目下已存在同名版本');
}
$version->save($data);
$this->syncDefault($version);
DocTreeService::clearCache();
return $this->result->success(null, '保存成功');
}
/**
* 删除版本（连同其下文档）
*
* @param int $id 版本ID
*/
public function delete($id)
{
$id = (int) $id;
$version = DocsVersion::find($id);
if (!$version) {
return $this->result->error('版本不存在');
}
// 项目至少保留一个版本，否则文档将无处归属
$left = DocsVersion::where('project_id', $version->project_id)->count();
if ($left <= 1) {
return $this->result->error('该项目仅剩一个版本，不能删除');
}
$docIds = DocsDoc::where('version_id', $id)->column('id');
foreach ($docIds as $docId) {
DocSearchService::remove((int) $docId);
}
DocsDoc::where('version_id', $id)->delete();
$version->delete();
DocTreeService::clearCache();
return $this->result->success(null, '删除成功');
}
/**
* 收集并校验表单数据
*
* @return array|string
*/
protected function collect()
{
$projectId = (int) $this->request->post('project_id', 0);
$name = trim((string) $this->request->post('name', ''));
$title = trim((string) $this->request->post('title', ''));
if ($projectId <= 0 || !DocsProject::find($projectId)) {
return '请选择所属项目';
}
if ($name === '' || !preg_match('/^[A-Za-z0-9][A-Za-z0-9_\.\-]{0,19}$/', $name)) {
return '版本标识只能包含字母数字与点划线，长度 1-20';
}
if ($title === '') {
return '请填写版本名称';
}
return [
'project_id' => $projectId,
'name' => $name,
'title' => $title,
'intro' => trim((string) $this->request->post('intro', '')),
'is_default' => (int) $this->request->post('is_default', 0) === 1 ? 1 : 0,
'sort' => (int) $this->request->post('sort', 0),
'status' => (int) $this->request->post('status', 1) === 1 ? 1 : 0,
];
}
/**
* 保证同项目下仅有一个默认版本，并同步项目的默认版本标识
*
* @param DocsVersion $version 当前版本
* @return void
*/
protected function syncDefault(DocsVersion $version): void
{
if ((int) $version->is_default !== 1) {
return;
}
DocsVersion::where('project_id', $version->project_id)
->where('id', '<>', $version->id)
->update(['is_default' => 0]);
DocsProject::where('id', $version->project_id)
->update(['default_version' => $version->name]);
}
}