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

internal/api/subscription.go

@@ -6,6 +6,12 @@ import (
 	"github.com/gin-gonic/gin"
 )
 
+// @Summary  订阅列表
+// @Tags     租户配置
+// @Param    id path int true "配置 ID"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/subscriptions [get]
 func (h *ociConfigHandler) subscriptions(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -19,6 +25,13 @@ func (h *ociConfigHandler) subscriptions(c *gin.Context) {
 	c.JSON(http.StatusOK, subs)
 }
 
+// @Summary  订阅详情
+// @Tags     租户配置
+// @Param    id path int true "配置 ID"
+// @Param    subscriptionId path string true "subscriptionId"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/subscriptions/{subscriptionId} [get]
 func (h *ociConfigHandler) subscriptionDetail(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {
@@ -32,6 +45,12 @@ func (h *ociConfigHandler) subscriptionDetail(c *gin.Context) {
 	c.JSON(http.StatusOK, detail)
 }
 
+// @Summary  限额服务列表
+// @Tags     租户配置
+// @Param    id path int true "配置 ID"
+// @Success  200 {object} map[string]any
+// @Security BearerAuth
+// @Router   /api/v1/oci-configs/{id}/limits/services [get]
 func (h *ociConfigHandler) limitServices(c *gin.Context) {
 	id, ok := pathID(c)
 	if !ok {