新增：安全技术数据

2026-09-11 11:14:08 +08:00
parent 9bce0d340f
commit 5a2830d36a
24 changed files with 5065 additions and 292 deletions
@@ -0,0 +1,258 @@
+using BLL;
+using System;
+using System.Web.Http;
+
+namespace WebAPI.Controllers.HSSE
+{
+    /// <summary>
+    /// PDF 书籍模块接口（对应 PC 页面 HSSE/PDFDOC/PdfBookView.aspx 的完整功能：多级章节目录 + 富文本正文维护）。
+    /// 数据表：Sys_PdfBook / Sys_PdfChapter（目录层级 ParentChapterId+Level，正文为 UMeditor 富文本 HTML）。
+    /// 路由：api/PdfBook/{action}，响应统一包装 Model.ResponeData（code：1正常 0异常）。
+    /// 鉴权：只读接口（getBooks/getChapterTree/getChapter/searchChapter）已加入权限过滤白名单，免登录；
+    ///       维护接口（add*/edit*/delete*/save*）需登录（请求头 token=用户/人员Id 或 FormsAuth 会话）。
+    /// </summary>
+    public class PdfBookController : ApiController
+    {
+        #region 只读接口
+
+        /// <summary>获取书籍列表（含章节数，按登记时间升序）。</summary>
+        public Model.ResponeData getBooks()
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                responeData.data = APIPdfBookService.GetBooks();
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>获取某本书的多级章节目录树（嵌套 Children）。</summary>
+        /// <param name="bookId">书籍主键，必填。</param>
+        public Model.ResponeData getChapterTree(string bookId)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                responeData.data = APIPdfBookService.GetChapterTree(bookId);
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>获取章节正文详情（含富文本 HTML 与纯文本）。</summary>
+        /// <param name="chapterId">章节主键，必填。</param>
+        public Model.ResponeData getChapter(string chapterId)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                var detail = APIPdfBookService.GetChapterDetail(chapterId);
+                if (detail == null)
+                {
+                    responeData.code = 0;
+                    responeData.message = "章节不存在或已被删除";
+                }
+                else
+                {
+                    responeData.data = detail;
+                }
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>章节关键词检索（正文 HTML 先转纯文本再匹配，返回命中片段）。</summary>
+        [HttpPost]
+        public Model.ResponeData searchChapter([FromBody] SearchRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                responeData.data = APIPdfBookService.SearchChapter(request.keyword, request.bookId);
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+        #endregion
+
+        #region 维护接口（需登录）
+
+        /// <summary>新增书籍，返回新书籍 BookId。</summary>
+        [HttpPost]
+        public Model.ResponeData addBook([FromBody] AddBookRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                responeData.data = new { bookId = APIPdfBookService.AddBook(request.title, request.createUser) };
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>新增章节（parentChapterId 为空=顶级章节），返回新章节 ChapterId。</summary>
+        [HttpPost]
+        public Model.ResponeData addChapter([FromBody] AddChapterRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                responeData.data = new
+                {
+                    chapterId = APIPdfBookService.AddChapter(request.bookId, request.parentChapterId, request.chapterTitle, request.createUser)
+                };
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>编辑章节名称。</summary>
+        [HttpPost]
+        public Model.ResponeData editChapter([FromBody] EditChapterRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                APIPdfBookService.EditChapter(request.chapterId, request.chapterTitle);
+                responeData.data = true;
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>删除章节及其全部子章节，data 返回删除的章节总数。</summary>
+        [HttpPost]
+        public Model.ResponeData deleteChapter([FromBody] DeleteChapterRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                responeData.data = new { deletedCount = APIPdfBookService.DeleteChapter(request.chapterId) };
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+
+        /// <summary>保存章节正文（富文本 HTML，同页面"保存内容"）。</summary>
+        [HttpPost]
+        public Model.ResponeData saveContent([FromBody] SaveContentRequest request)
+        {
+            var responeData = new Model.ResponeData();
+            try
+            {
+                if (request == null)
+                    throw new Exception("请求参数不能为空");
+                APIPdfBookService.SaveContent(request.chapterId, request.content);
+                responeData.data = true;
+            }
+            catch (Exception ex)
+            {
+                responeData.code = 0;
+                responeData.message = ex.Message;
+            }
+            return responeData;
+        }
+        #endregion
+
+        #region 请求模型
+        /// <summary>章节关键词检索请求。</summary>
+        public class SearchRequest
+        {
+            /// <summary>检索关键词，必填。</summary>
+            public string keyword { get; set; }
+            /// <summary>书籍主键；不传/为空则全库检索。</summary>
+            public string bookId { get; set; }
+        }
+
+        /// <summary>新增书籍请求。</summary>
+        public class AddBookRequest
+        {
+            /// <summary>书名，必填。</summary>
+            public string title { get; set; }
+            /// <summary>登记人（缺省 "api"）。</summary>
+            public string createUser { get; set; }
+        }
+
+        /// <summary>新增章节请求。</summary>
+        public class AddChapterRequest
+        {
+            /// <summary>所属书籍主键，必填。</summary>
+            public string bookId { get; set; }
+            /// <summary>父章节主键；为空=顶级章节。</summary>
+            public string parentChapterId { get; set; }
+            /// <summary>章节名称，必填。</summary>
+            public string chapterTitle { get; set; }
+            /// <summary>登记人（预留）。</summary>
+            public string createUser { get; set; }
+        }
+
+        /// <summary>编辑章节请求。</summary>
+        public class EditChapterRequest
+        {
+            /// <summary>章节主键，必填。</summary>
+            public string chapterId { get; set; }
+            /// <summary>新章节名称，必填。</summary>
+            public string chapterTitle { get; set; }
+        }
+
+        /// <summary>删除章节请求。</summary>
+        public class DeleteChapterRequest
+        {
+            /// <summary>章节主键，必填（连同全部子章节一并删除）。</summary>
+            public string chapterId { get; set; }
+        }
+
+        /// <summary>保存章节正文请求。</summary>
+        public class SaveContentRequest
+        {
+            /// <summary>章节主键，必填。</summary>
+            public string chapterId { get; set; }
+            /// <summary>正文内容（UMeditor 富文本 HTML），可为空串。</summary>
+            public string content { get; set; }
+        }
+        #endregion
+    }
+}