新增项目文档模块

app/adminapi/controller/project/ProjectDocumentController.php

@@ -0,0 +1,108 @@
+<?php
+// +----------------------------------------------------------------------
+// | likeadmin快速开发前后端分离管理后台（PHP版）
+// +----------------------------------------------------------------------
+// | 欢迎阅读学习系统程序代码，建议反馈是我们前进的动力
+// | 开源版本可自由商用，可去除界面版权logo
+// | gitee下载：https://gitee.com/likeshop_gitee/likeadmin
+// | github下载：https://github.com/likeshop-github/likeadmin
+// | 访问官网：https://www.likeadmin.cn
+// | likeadmin团队 版权所有 拥有最终解释权
+// +----------------------------------------------------------------------
+// | author: likeadminTeam
+// +----------------------------------------------------------------------
+
+
+namespace app\adminapi\controller\project;
+
+
+use app\adminapi\controller\BaseAdminController;
+use app\adminapi\lists\project\ProjectDocumentLists;
+use app\adminapi\logic\project\ProjectDocumentLogic;
+use app\adminapi\validate\project\ProjectDocumentValidate;
+
+
+/**
+ * 项目文档控制器
+ * Class ProjectDocumentController
+ * @package app\adminapi\controller\project
+ */
+class ProjectDocumentController extends BaseAdminController
+{
+
+
+    /**
+     * @notes 获取项目文档列表
+     * @return \think\response\Json
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function lists()
+    {
+        return $this->dataLists(new ProjectDocumentLists());
+    }
+
+
+    /**
+     * @notes 添加项目文档
+     * @return \think\response\Json
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function add()
+    {
+        $params = (new ProjectDocumentValidate())->post()->goCheck('add');
+        $result = ProjectDocumentLogic::add($params);
+        if (true === $result) {
+            return $this->success('添加成功', [], 1, 1);
+        }
+        return $this->fail(ProjectDocumentLogic::getError());
+    }
+
+
+    /**
+     * @notes 编辑项目文档
+     * @return \think\response\Json
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function edit()
+    {
+        $params = (new ProjectDocumentValidate())->post()->goCheck('edit');
+        $result = ProjectDocumentLogic::edit($params);
+        if (true === $result) {
+            return $this->success('编辑成功', [], 1, 1);
+        }
+        return $this->fail(ProjectDocumentLogic::getError());
+    }
+
+
+    /**
+     * @notes 删除项目文档
+     * @return \think\response\Json
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function delete()
+    {
+        $params = (new ProjectDocumentValidate())->post()->goCheck('delete');
+        ProjectDocumentLogic::delete($params);
+        return $this->success('删除成功', [], 1, 1);
+    }
+
+
+    /**
+     * @notes 获取项目文档详情
+     * @return \think\response\Json
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function detail()
+    {
+        $params = (new ProjectDocumentValidate())->goCheck('detail');
+        $result = ProjectDocumentLogic::detail($params);
+        return $this->data($result);
+    }
+
+
+}

app/adminapi/lists/project/ProjectDocumentLists.php

@@ -0,0 +1,87 @@
+<?php
+// +----------------------------------------------------------------------
+// | likeadmin快速开发前后端分离管理后台（PHP版）
+// +----------------------------------------------------------------------
+// | 欢迎阅读学习系统程序代码，建议反馈是我们前进的动力
+// | 开源版本可自由商用，可去除界面版权logo
+// | gitee下载：https://gitee.com/likeshop_gitee/likeadmin
+// | github下载：https://github.com/likeshop-github/likeadmin
+// | 访问官网：https://www.likeadmin.cn
+// | likeadmin团队 版权所有 拥有最终解释权
+// +----------------------------------------------------------------------
+// | author: likeadminTeam
+// +----------------------------------------------------------------------
+
+namespace app\adminapi\lists\project;
+
+
+use app\adminapi\lists\BaseAdminDataLists;
+use app\common\model\project\Project;
+use app\common\model\project\ProjectDocument;
+use app\common\lists\ListsSearchInterface;
+use app\common\model\project\ProjectDocumentSet;
+
+
+/**
+ * 项目文档列表
+ * Class ProjectDocumentLists
+ * @package app\adminapi\listsproject
+ */
+class ProjectDocumentLists extends BaseAdminDataLists implements ListsSearchInterface
+{
+
+
+    /**
+     * @notes 设置搜索条件
+     * @return \string[][]
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function setSearch(): array
+    {
+        return [
+            '%like%' => ['code', 'name'],
+        ];
+    }
+
+
+    /**
+     * @notes 获取项目文档列表
+     * @return array
+     * @throws \think\db\exception\DataNotFoundException
+     * @throws \think\db\exception\DbException
+     * @throws \think\db\exception\ModelNotFoundException
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function lists(): array
+    {
+        return ProjectDocument::where($this->searchWhere)
+            ->field(['id', 'project_id', 'classify_id', 'code', 'name', 'describe', 'version', 'annex'])
+            ->limit($this->limitOffset, $this->limitLength)
+            ->order(['id' => 'desc'])
+            ->select()->each(function($item){
+		        $project = Project::field('name,project_code')->where('id',$item['project_id'])->findOrEmpty();
+		        $doc = ProjectDocumentSet::field('large_category,middle_category')->where('id',$item['classify_id'])->findOrEmpty();
+		        $item['project_name'] = $project['name'];
+		        $item['project_code'] = $project['project_code'];
+		        $item['large_category'] = $doc['large_category'];
+		        $item['middle_category'] = $doc['middle_category'];
+				return $item;
+	        })
+            ->toArray();
+    }
+
+
+    /**
+     * @notes 获取项目文档数量
+     * @return int
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function count(): int
+    {
+        return ProjectDocument::where($this->searchWhere)->count();
+    }
+
+}

app/adminapi/logic/project/ProjectDocumentLogic.php

@@ -0,0 +1,126 @@
+<?php
+// +----------------------------------------------------------------------
+// | likeadmin快速开发前后端分离管理后台（PHP版）
+// +----------------------------------------------------------------------
+// | 欢迎阅读学习系统程序代码，建议反馈是我们前进的动力
+// | 开源版本可自由商用，可去除界面版权logo
+// | gitee下载：https://gitee.com/likeshop_gitee/likeadmin
+// | github下载：https://github.com/likeshop-github/likeadmin
+// | 访问官网：https://www.likeadmin.cn
+// | likeadmin团队 版权所有 拥有最终解释权
+// +----------------------------------------------------------------------
+// | author: likeadminTeam
+// +----------------------------------------------------------------------
+
+namespace app\adminapi\logic\project;
+
+
+use app\common\model\project\Project;
+use app\common\model\project\ProjectDocument;
+use app\common\logic\BaseLogic;
+use app\common\model\project\ProjectDocumentSet;
+use think\facade\Db;
+
+
+/**
+ * 项目文档逻辑
+ * Class ProjectDocumentLogic
+ * @package app\adminapi\logic\project
+ */
+class ProjectDocumentLogic extends BaseLogic
+{
+
+
+    /**
+     * @notes 添加项目文档
+     * @param array $params
+     * @return bool
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public static function add(array $params): bool
+    {
+        Db::startTrans();
+        try {
+            ProjectDocument::create([
+                'project_id' => $params['project_id'],
+                'classify_id' => $params['classify_id'],
+                'code' =>document_code(),
+                'name' => $params['name'],
+                'describe' => $params['describe'],
+                'version' => $params['version'],
+                'annex' => !empty($params['annex']) ? $params['annex'] : null,
+            ]);
+            Db::commit();
+            return true;
+        } catch (\Exception $e) {
+            Db::rollback();
+            self::setError($e->getMessage());
+            return false;
+        }
+    }
+
+
+    /**
+     * @notes 编辑项目文档
+     * @param array $params
+     * @return bool
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public static function edit(array $params): bool
+    {
+        Db::startTrans();
+        try {
+            ProjectDocument::where('id', $params['id'])->update([
+                'project_id' => $params['project_id'],
+                'classify_id' => $params['classify_id'],
+                'name' => $params['name'],
+                'describe' => $params['describe'],
+                'version' => $params['version'],
+                'annex' => !empty($params['annex']) ? $params['annex'] : null,
+            ]);
+
+            Db::commit();
+            return true;
+        } catch (\Exception $e) {
+            Db::rollback();
+            self::setError($e->getMessage());
+            return false;
+        }
+    }
+
+
+    /**
+     * @notes 删除项目文档
+     * @param array $params
+     * @return bool
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public static function delete(array $params): bool
+    {
+        return ProjectDocument::destroy($params['id']);
+    }
+
+
+    /**
+     * @notes 获取项目文档详情
+     * @param $params
+     * @return array
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public static function detail($params): array
+    {
+		$data = ProjectDocument::field('id,project_id,classify_id,code,name,describe,version,annex')->findOrEmpty($params['id'])->toArray();
+		$data['annex'] = json_decode($data['annex']);
+		$project = Project::field('name,project_code')->where('id',$data['project_id'])->findOrEmpty();
+		$doc = ProjectDocumentSet::field('large_category,middle_category')->where('id',$data['classify_id'])->findOrEmpty();
+		$data['project_name'] = $project['name'];
+	    $data['project_code'] = $project['project_code'];
+		$data['large_category'] = $doc['large_category'];
+	    $data['middle_category'] = $doc['middle_category'];
+        return $data;
+    }
+}

app/adminapi/validate/project/ProjectDocumentValidate.php

@@ -0,0 +1,128 @@
+<?php
+// +----------------------------------------------------------------------
+// | likeadmin快速开发前后端分离管理后台（PHP版）
+// +----------------------------------------------------------------------
+// | 欢迎阅读学习系统程序代码，建议反馈是我们前进的动力
+// | 开源版本可自由商用，可去除界面版权logo
+// | gitee下载：https://gitee.com/likeshop_gitee/likeadmin
+// | github下载：https://github.com/likeshop-github/likeadmin
+// | 访问官网：https://www.likeadmin.cn
+// | likeadmin团队 版权所有 拥有最终解释权
+// +----------------------------------------------------------------------
+// | author: likeadminTeam
+// +----------------------------------------------------------------------
+
+namespace app\adminapi\validate\project;
+
+
+use app\common\model\project\Project;
+use app\common\model\project\ProjectDocumentSet;
+use app\common\validate\BaseValidate;
+
+
+/**
+ * 项目文档验证器
+ * Class ProjectDocumentValidate
+ * @package app\adminapi\validate\project
+ */
+class ProjectDocumentValidate extends BaseValidate
+{
+
+     /**
+      * 设置校验规则
+      * @var string[]
+      */
+    protected $rule = [
+        'id' => 'require',
+        'project_id' => 'require|checkProject',
+        'classify_id' => 'require|checkClassify',
+        'name' => 'require',
+    ];
+	
+	protected $message = [
+		'id.require' => '缺少必要参数',
+		'project_id.require' => '请选择项目',
+		'classify_id.require' => '请选择文档大类',
+		'name.require' => '请填写文档名称',
+	];
+
+
+    /**
+     * 参数描述
+     * @var string[]
+     */
+    protected $field = [
+        'id' => 'id',
+        'project_id' => '项目id',
+        'classify_id' => '文档分类id',
+        'code' => '文档编号',
+        'name' => '文档名称',
+    ];
+
+
+    /**
+     * @notes 添加场景
+     * @return ProjectDocumentValidate
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function sceneAdd()
+    {
+        return $this->only(['project_id','classify_id','name','describe','version','annex']);
+    }
+
+
+    /**
+     * @notes 编辑场景
+     * @return ProjectDocumentValidate
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function sceneEdit()
+    {
+        return $this->only(['id','project_id','classify_id','name','describe','version','annex']);
+    }
+
+
+    /**
+     * @notes 删除场景
+     * @return ProjectDocumentValidate
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function sceneDelete()
+    {
+        return $this->only(['id']);
+    }
+
+
+    /**
+     * @notes 详情场景
+     * @return ProjectDocumentValidate
+     * @author likeadmin
+     * @date 2023/12/18 15:42
+     */
+    public function sceneDetail()
+    {
+        return $this->only(['id']);
+    }
+	
+	public function checkProject($value): bool|string
+	{
+		$data = Project::where('id',$value)->findOrEmpty();
+		if($data->isEmpty()){
+			return '项目不存在';
+		}
+		return true;
+	}
+	
+	public function checkClassify($value): bool|string
+	{
+		$data = ProjectDocumentSet::where('id',$value)->findOrEmpty();
+		if($data->isEmpty()){
+			return '文档分类不存在';
+		}
+		return true;
+	}
+
+}

app/common.php

@@ -333,3 +333,8 @@ function process_code($str): string
 	//质量检查单-20231215-0001
 	return $str.'-'.date('Ymd',time()).'-'.mt_rand(100000, 999999);
 }
+
+function document_code(): string
+{
+	return 'D'.date('Ymd',time()).'-'.mt_rand(100000, 999999);
+}

app/common/model/project/ProjectDocument.php

@@ -0,0 +1,34 @@
+<?php
+// +----------------------------------------------------------------------
+// | likeadmin快速开发前后端分离管理后台（PHP版）
+// +----------------------------------------------------------------------
+// | 欢迎阅读学习系统程序代码，建议反馈是我们前进的动力
+// | 开源版本可自由商用，可去除界面版权logo
+// | gitee下载：https://gitee.com/likeshop_gitee/likeadmin
+// | github下载：https://github.com/likeshop-github/likeadmin
+// | 访问官网：https://www.likeadmin.cn
+// | likeadmin团队 版权所有 拥有最终解释权
+// +----------------------------------------------------------------------
+// | author: likeadminTeam
+// +----------------------------------------------------------------------
+
+namespace app\common\model\project;
+
+
+use app\common\model\BaseModel;
+use think\model\concern\SoftDelete;
+
+
+/**
+ * 项目文档模型
+ * Class ProjectDocument
+ * @package app\common\model\project
+ */
+class ProjectDocument extends BaseModel
+{
+    use SoftDelete;
+    protected $name = 'project_document';
+    protected $deleteTime = 'delete_time';
+
+    
+}