feat: Enhance Swagger documentation with new admin and user endpoints

- Added definitions for admin authentication, media, posts, orders, and user management.
- Implemented new API paths for admin functionalities including authentication, media management, order processing, and user statistics.
- Updated existing endpoints to improve clarity and structure in the Swagger documentation.
- Introduced new response schemas for various operations to standardize API responses.

backend_v1/app/http/admin/medias.go

@@ -17,17 +17,27 @@ type medias struct {
 
 // List medias
 //
-//	@Router	/admin/medias [get]
-//	@Bind	pagination query
-//	@Bind	query query
+//	@Summary		媒体列表
+//	@Tags			Admin Medias
+//	@Produce		json
+//	@Param			pagination	query		requests.Pagination	false	"分页参数"
+//	@Param			query		query		ListQuery			false	"筛选条件"
+//	@Success		200			{object}	requests.Pager{items=models.Media}	"成功"
+//	@Router			/admin/medias [get]
+//	@Bind			pagination query
+//	@Bind			query query
 func (ctl *medias) List(ctx fiber.Ctx, pagination *requests.Pagination, query *ListQuery) (*requests.Pager, error) {
 	return services.Medias.List(ctx, pagination, models.MediaQuery.Name.Like(database.WrapLike(*query.Keyword)))
 }
 
 // Show media
 //
-//	@Router	/admin/medias/:id [get]
-//	@Bind	id path
+//	@Summary		媒体预览（跳转到签名 URL）
+//	@Tags			Admin Medias
+//	@Param			id	path	int64	true	"媒体 ID"
+//	@Success		302	{string}	string	"跳转"
+//	@Router			/admin/medias/:id [get]
+//	@Bind			id path
 func (ctl *medias) Show(ctx fiber.Ctx, id int64) error {
 	media, err := services.Medias.FindByID(ctx, id)
 	if err != nil {
@@ -44,8 +54,13 @@ func (ctl *medias) Show(ctx fiber.Ctx, id int64) error {
 
 // Delete
 //
-//	@Router	/admin/medias/:id [delete]
-//	@Bind	id path
+//	@Summary		删除媒体
+//	@Tags			Admin Medias
+//	@Produce		json
+//	@Param			id		path		int64	true	"媒体 ID"
+//	@Success		204		{object}	any		"成功"
+//	@Router			/admin/medias/:id [delete]
+//	@Bind			id path
 func (ctl *medias) Delete(ctx fiber.Ctx, id int64) error {
 	media, err := services.Medias.FindByID(ctx, id)
 	if err != nil {