仓库自包含化：Docker/CI/文档/规范入库，路由分组拆分

internal/api/console.go

@@ -13,6 +13,14 @@ type createConsoleConnectionRequest struct {
 	SSHPublicKey string `json:"sshPublicKey" binding:"required"`
 }
 
+// @Summary  创建实例控制台连接
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Param    body body createConsoleConnectionRequest true "请求体"
+// @Success  201 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId}/console-connections [post]
 func (h *ociConfigHandler) createConsoleConnection(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -31,6 +39,13 @@ func (h *ociConfigHandler) createConsoleConnection(c *gin.Context) {
 	c.JSON(http.StatusCreated, conn)
 }
 
+// @Summary  实例控制台连接列表
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    instanceId path string true "instanceId"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/instances/{instanceId}/console-connections [get]
 func (h *ociConfigHandler) listConsoleConnections(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -44,6 +59,13 @@ func (h *ociConfigHandler) listConsoleConnections(c *gin.Context) {
 	c.JSON(http.StatusOK, connections)
 }
 
+// @Summary  删除实例控制台连接
+// @Tags     计算
+// @Param    id path int true "配置 ID"
+// @Param    connectionId path string true "connectionId"
+// @Success  204 "无内容"
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/console-connections/{connectionId} [delete]
 func (h *ociConfigHandler) deleteConsoleConnection(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {