112 lines
3.0 KiB
Go
112 lines
3.0 KiB
Go
package v1
|
|
|
|
import (
|
|
"quyun/v2/app/http/v1/dto"
|
|
"quyun/v2/app/requests"
|
|
"quyun/v2/app/services"
|
|
|
|
"github.com/gofiber/fiber/v3"
|
|
)
|
|
|
|
// @provider
|
|
type Content struct{}
|
|
|
|
// List contents (Explore / Search)
|
|
//
|
|
// @Router /v1/contents [get]
|
|
// @Summary List contents
|
|
// @Description List contents with filtering and pagination
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param keyword query string false "Search keyword"
|
|
// @Param genre query string false "Genre"
|
|
// @Param tenantId query string false "Filter by creator"
|
|
// @Param sort query string false "Sort order" Enums(latest, hot, price_asc)
|
|
// @Param page query int false "Page number"
|
|
// @Success 200 {object} requests.Pager{items=[]dto.ContentItem}
|
|
// @Bind filter query
|
|
func (c *Content) List(
|
|
ctx fiber.Ctx,
|
|
filter *dto.ContentListFilter,
|
|
) (*requests.Pager, error) {
|
|
return services.Content.List(ctx, filter)
|
|
}
|
|
|
|
// Get content detail
|
|
//
|
|
// @Router /v1/contents/:id [get]
|
|
// @Summary Get content detail
|
|
// @Description Get content detail by ID
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param id path string true "Content ID"
|
|
// @Success 200 {object} dto.ContentDetail
|
|
// @Bind id path
|
|
func (c *Content) Get(ctx fiber.Ctx, id string) (*dto.ContentDetail, error) {
|
|
return services.Content.Get(ctx, id)
|
|
}
|
|
|
|
// Get comments for a content
|
|
//
|
|
// @Router /v1/contents/:id/comments [get]
|
|
// @Summary Get comments
|
|
// @Description Get comments for a content
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param id path string true "Content ID"
|
|
// @Param page query int false "Page number"
|
|
// @Success 200 {object} requests.Pager{items=[]dto.Comment}
|
|
// @Bind id path
|
|
// @Bind page query
|
|
func (c *Content) ListComments(ctx fiber.Ctx, id string, page int) (*requests.Pager, error) {
|
|
return services.Content.ListComments(ctx, id, page)
|
|
}
|
|
|
|
// Post a comment
|
|
//
|
|
// @Router /v1/contents/:id/comments [post]
|
|
// @Summary Post comment
|
|
// @Description Post a comment to a content
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param id path string true "Content ID"
|
|
// @Param form body dto.CommentCreateForm true "Comment form"
|
|
// @Success 200 {string} string "Comment created"
|
|
// @Bind id path
|
|
// @Bind form body
|
|
func (c *Content) CreateComment(ctx fiber.Ctx, id string, form *dto.CommentCreateForm) error {
|
|
return services.Content.CreateComment(ctx, id, form)
|
|
}
|
|
|
|
// Like a comment
|
|
//
|
|
// @Router /v1/comments/:id/like [post]
|
|
// @Summary Like comment
|
|
// @Description Like a comment
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Param id path string true "Comment ID"
|
|
// @Success 200 {string} string "Liked"
|
|
// @Bind id path
|
|
func (c *Content) LikeComment(ctx fiber.Ctx, id string) error {
|
|
return services.Content.LikeComment(ctx, id)
|
|
}
|
|
|
|
// List curated topics
|
|
//
|
|
// @Router /v1/topics [get]
|
|
// @Summary List topics
|
|
// @Description List curated topics
|
|
// @Tags Content
|
|
// @Accept json
|
|
// @Produce json
|
|
// @Success 200 {array} dto.Topic
|
|
func (c *Content) ListTopics(ctx fiber.Ctx) ([]dto.Topic, error) {
|
|
return services.Content.ListTopics(ctx)
|
|
}
|