fix: 优化后端各模块 handler

- database_handler, knowledge_handler, model_handler
- neo4j_handler, sub_table_handler
- system_handler, upload_handler
- knowledge_service, upload_service

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

server/internal/handler/sub_table_handler.go

@@ -17,7 +17,16 @@ func NewSubTableHandler(svc *service.SubTableService) *SubTableHandler {
 	return &SubTableHandler{service: svc}
 }
 
-// Create 创建子表信息
+// @Summary 创建子表映射
+// @Description 添加数据库的子表映射关系
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param request body model.CreateSubTableRequest true "子表信息"
+// @Success 201 {object} model.SubTableInfo
+// @Failure 400 {object} map[string]string
+// @Failure 500 {object} map[string]string
+// @Router /sub-table/add [post]
 func (h *SubTableHandler) Create(c *gin.Context) {
 	var req model.CreateSubTableRequest
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -34,7 +43,15 @@ func (h *SubTableHandler) Create(c *gin.Context) {
 	c.JSON(http.StatusCreated, info)
 }
 
-// GetByID 获取详情
+// @Summary 获取子表详情
+// @Description 根据ID获取子表映射详情
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param id path string true "子表ID"
+// @Success 200 {object} model.SubTableInfo
+// @Failure 404 {object} map[string]string
+// @Router /sub-table/{id} [get]
 func (h *SubTableHandler) GetByID(c *gin.Context) {
 	id := c.Param("id")
 
@@ -47,7 +64,15 @@ func (h *SubTableHandler) GetByID(c *gin.Context) {
 	c.JSON(http.StatusOK, info)
 }
 
-// ListByDatabase 获取数据库下所有子表
+// @Summary 获取数据库下所有子表
+// @Description 获取指定数据库的所有子表映射列表
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param database_id path string true "数据库ID"
+// @Success 200 {object} map[string]interface{}
+// @Failure 500 {object} map[string]string
+// @Router /sub-table/database/{database_id} [get]
 func (h *SubTableHandler) ListByDatabase(c *gin.Context) {
 	databaseID := c.Param("database_id")
 
@@ -64,7 +89,15 @@ func (h *SubTableHandler) ListByDatabase(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"list": list})
 }
 
-// GetMappingFromFile 从文件获取映射
+// @Summary 从文件获取映射
+// @Description 从文件中读取子表映射关系
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param database_id path string true "数据库ID"
+// @Success 200 {object} map[string]interface{}
+// @Failure 500 {object} map[string]string
+// @Router /sub-table/mapping/{database_id} [get]
 func (h *SubTableHandler) GetMappingFromFile(c *gin.Context) {
 	databaseID := c.Param("database_id")
 
@@ -82,7 +115,17 @@ func (h *SubTableHandler) GetMappingFromFile(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"mapping": mapping})
 }
 
-// Update 更新
+// @Summary 更新子表映射
+// @Description 更新子表映射信息
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param id path string true "子表ID"
+// @Param request body model.UpdateSubTableRequest true "更新信息"
+// @Success 200 {object} model.SubTableInfo
+// @Failure 400 {object} map[string]string
+// @Failure 404 {object} map[string]string
+// @Router /sub-table/{id} [put]
 func (h *SubTableHandler) Update(c *gin.Context) {
 	id := c.Param("id")
 
@@ -101,7 +144,15 @@ func (h *SubTableHandler) Update(c *gin.Context) {
 	c.JSON(http.StatusOK, info)
 }
 
-// Delete 删除
+// @Summary 删除子表映射
+// @Description 删除指定的子表映射
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param id path string true "子表ID"
+// @Success 200 {object} map[string]string
+// @Failure 404 {object} map[string]string
+// @Router /sub-table/{id} [delete]
 func (h *SubTableHandler) Delete(c *gin.Context) {
 	id := c.Param("id")
 
@@ -114,7 +165,15 @@ func (h *SubTableHandler) Delete(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"message": "deleted"})
 }
 
-// GetTablesDDL 获取数据库下所有表及DDL
+// @Summary 获取表结构DDL
+// @Description 获取数据库下所有表的DDL语句
+// @Tags 子表管理
+// @Accept json
+// @Produce json
+// @Param database_id path string true "数据库ID"
+// @Success 200 {object} map[string]interface{}
+// @Failure 500 {object} map[string]string
+// @Router /sub-table/ddl/{database_id} [get]
 func (h *SubTableHandler) GetTablesDDL(c *gin.Context) {
 	databaseID := c.Param("database_id")