tenant: admin order export csv

backend/app/http/tenant/dto/order_admin_export.go

@@ -0,0 +1,13 @@
+package dto
+
+// AdminOrderExportResponse 租户管理员订单导出响应（CSV 文本）。
+type AdminOrderExportResponse struct {
+	// Filename 建议文件名：前端可用于下载时的默认文件名。
+	Filename string `json:"filename"`
+
+	// ContentType 内容类型：当前固定为 text/csv。
+	ContentType string `json:"content_type"`
+
+	// CSV CSV 文本内容：UTF-8 编码，包含表头与数据行；前端可直接下载为文件。
+	CSV string `json:"csv"`
+}

backend/app/http/tenant/order_admin.go

@@ -63,6 +63,41 @@ func (*orderAdmin) adminOrderList(
 	return services.Order.AdminOrderPage(ctx, tenant.ID, filter)
 }
 
+// adminOrderExport
+//
+//	@Summary	订单导出（租户管理）
+//	@Tags		Tenant
+//	@Accept		json
+//	@Produce	json
+//	@Param		tenantCode	path		string					true	"Tenant Code"
+//	@Param		filter		query		dto.AdminOrderListFilter	true	"Filter"
+//	@Success	200			{object}	dto.AdminOrderExportResponse
+//
+//	@Router		/t/:tenantCode/v1/admin/orders/export [get]
+//	@Bind		tenant local key(tenant)
+//	@Bind		tenantUser local key(tenant_user)
+//	@Bind		filter query
+func (*orderAdmin) adminOrderExport(
+	ctx fiber.Ctx,
+	tenant *models.Tenant,
+	tenantUser *models.TenantUser,
+	filter *dto.AdminOrderListFilter,
+) (*dto.AdminOrderExportResponse, error) {
+	if err := requireTenantAdmin(tenantUser); err != nil {
+		return nil, err
+	}
+	if filter == nil {
+		filter = &dto.AdminOrderListFilter{}
+	}
+
+	log.WithFields(log.Fields{
+		"tenant_id": tenant.ID,
+		"user_id":   tenantUser.UserID,
+	}).Info("tenant.admin.orders.export")
+
+	return services.Order.AdminOrderExportCSV(ctx.Context(), tenant.ID, filter)
+}
+
 // adminOrderDetail
 //
 //	@Summary	订单详情（租户管理）

backend/app/http/tenant/routes.gen.go

@@ -156,6 +156,13 @@ func (r *Routes) Register(router fiber.Router) {
 		Local[*models.TenantUser]("tenant_user"),
 		PathParam[int64]("orderID"),
 	))
+	r.log.Debugf("Registering route: Get /t/:tenantCode/v1/admin/orders/export -> orderAdmin.adminOrderExport")
+	router.Get("/t/:tenantCode/v1/admin/orders/export"[len(r.Path()):], DataFunc3(
+		r.orderAdmin.adminOrderExport,
+		Local[*models.Tenant]("tenant"),
+		Local[*models.TenantUser]("tenant_user"),
+		Query[dto.AdminOrderListFilter]("filter"),
+	))
 	r.log.Debugf("Registering route: Post /t/:tenantCode/v1/admin/orders/:orderID/refund -> orderAdmin.adminRefund")
 	router.Post("/t/:tenantCode/v1/admin/orders/:orderID/refund"[len(r.Path()):], DataFunc4(
 		r.orderAdmin.adminRefund,

backend/app/services/order.go

@@ -1,7 +1,9 @@
 package services
 
 import (
+	"bytes"
 	"context"
+	"encoding/csv"
 	"encoding/json"
 	"errors"
 	"fmt"
@@ -26,6 +28,158 @@ import (
 	"go.ipao.vip/gen/types"
 )
 
+// AdminOrderExportCSV 租户管理员导出订单列表（CSV 文本）。
+func (s *order) AdminOrderExportCSV(ctx context.Context, tenantID int64, filter *dto.AdminOrderListFilter) (*dto.AdminOrderExportResponse, error) {
+	if tenantID <= 0 {
+		return nil, errorx.ErrInvalidParameter.WithMsg("tenant_id must be > 0")
+	}
+	if filter == nil {
+		filter = &dto.AdminOrderListFilter{}
+	}
+
+	// 导出属于高消耗操作：限制最大行数，避免拖垮数据库。
+	const maxRows = 5000
+
+	logrus.WithFields(logrus.Fields{
+		"tenant_id":     tenantID,
+		"max_rows":      maxRows,
+		"user_id":       lo.FromPtr(filter.UserID),
+		"username":      filter.UsernameTrimmed(),
+		"content_id":    lo.FromPtr(filter.ContentID),
+		"content_title": filter.ContentTitleTrimmed(),
+		"type":          lo.FromPtr(filter.Type),
+		"status":        lo.FromPtr(filter.Status),
+	}).Info("services.order.admin.export_csv")
+
+	tbl, query := models.OrderQuery.QueryContext(ctx)
+	conds := []gen.Condition{tbl.TenantID.Eq(tenantID)}
+	if filter.UserID != nil {
+		conds = append(conds, tbl.UserID.Eq(*filter.UserID))
+	}
+	if filter.Type != nil {
+		conds = append(conds, tbl.Type.Eq(*filter.Type))
+	}
+	if filter.Status != nil {
+		conds = append(conds, tbl.Status.Eq(*filter.Status))
+	}
+	if filter.CreatedAtFrom != nil {
+		conds = append(conds, tbl.CreatedAt.Gte(*filter.CreatedAtFrom))
+	}
+	if filter.CreatedAtTo != nil {
+		conds = append(conds, tbl.CreatedAt.Lte(*filter.CreatedAtTo))
+	}
+	if filter.PaidAtFrom != nil {
+		conds = append(conds, tbl.PaidAt.Gte(*filter.PaidAtFrom))
+	}
+	if filter.PaidAtTo != nil {
+		conds = append(conds, tbl.PaidAt.Lte(*filter.PaidAtTo))
+	}
+	if filter.AmountPaidMin != nil {
+		conds = append(conds, tbl.AmountPaid.Gte(*filter.AmountPaidMin))
+	}
+	if filter.AmountPaidMax != nil {
+		conds = append(conds, tbl.AmountPaid.Lte(*filter.AmountPaidMax))
+	}
+
+	if username := filter.UsernameTrimmed(); username != "" {
+		uTbl, _ := models.UserQuery.QueryContext(ctx)
+		query = query.LeftJoin(uTbl, uTbl.ID.EqCol(tbl.UserID))
+		conds = append(conds, uTbl.Username.Like(database.WrapLike(username)))
+	}
+
+	needItemJoin := (filter.ContentID != nil && *filter.ContentID > 0) || filter.ContentTitleTrimmed() != ""
+	if needItemJoin {
+		oiTbl, _ := models.OrderItemQuery.QueryContext(ctx)
+		query = query.LeftJoin(oiTbl, oiTbl.OrderID.EqCol(tbl.ID))
+		if filter.ContentID != nil && *filter.ContentID > 0 {
+			conds = append(conds, oiTbl.ContentID.Eq(*filter.ContentID))
+		}
+		if title := filter.ContentTitleTrimmed(); title != "" {
+			cTbl, _ := models.ContentQuery.QueryContext(ctx)
+			query = query.LeftJoin(cTbl, cTbl.ID.EqCol(oiTbl.ContentID))
+			conds = append(conds, cTbl.Title.Like(database.WrapLike(title)))
+		}
+		query = query.Group(tbl.ID)
+	}
+
+	// 排序：复用 AdminOrderPage 的白名单，避免任意字段导致注入/慢查询。
+	orderBys := make([]field.Expr, 0, 4)
+	allowedAsc := map[string]field.Expr{
+		"id":          tbl.ID.Asc(),
+		"created_at":  tbl.CreatedAt.Asc(),
+		"paid_at":     tbl.PaidAt.Asc(),
+		"amount_paid": tbl.AmountPaid.Asc(),
+	}
+	allowedDesc := map[string]field.Expr{
+		"id":          tbl.ID.Desc(),
+		"created_at":  tbl.CreatedAt.Desc(),
+		"paid_at":     tbl.PaidAt.Desc(),
+		"amount_paid": tbl.AmountPaid.Desc(),
+	}
+	for _, f := range filter.AscFields() {
+		f = strings.TrimSpace(f)
+		if f == "" {
+			continue
+		}
+		if ob, ok := allowedAsc[f]; ok {
+			orderBys = append(orderBys, ob)
+		}
+	}
+	for _, f := range filter.DescFields() {
+		f = strings.TrimSpace(f)
+		if f == "" {
+			continue
+		}
+		if ob, ok := allowedDesc[f]; ok {
+			orderBys = append(orderBys, ob)
+		}
+	}
+	if len(orderBys) == 0 {
+		orderBys = append(orderBys, tbl.ID.Desc())
+	} else {
+		orderBys = append(orderBys, tbl.ID.Desc())
+	}
+
+	items, err := query.Where(conds...).Order(orderBys...).Limit(maxRows).Find()
+	if err != nil {
+		return nil, err
+	}
+
+	buf := &bytes.Buffer{}
+	w := csv.NewWriter(buf)
+	_ = w.Write([]string{"id", "tenant_id", "user_id", "type", "status", "amount_paid", "paid_at", "created_at"})
+	for _, it := range items {
+		if it == nil {
+			continue
+		}
+		paidAt := ""
+		if !it.PaidAt.IsZero() {
+			paidAt = it.PaidAt.UTC().Format(time.RFC3339)
+		}
+		_ = w.Write([]string{
+			fmt.Sprintf("%d", it.ID),
+			fmt.Sprintf("%d", it.TenantID),
+			fmt.Sprintf("%d", it.UserID),
+			string(it.Type),
+			string(it.Status),
+			fmt.Sprintf("%d", it.AmountPaid),
+			paidAt,
+			it.CreatedAt.UTC().Format(time.RFC3339),
+		})
+	}
+	w.Flush()
+	if err := w.Error(); err != nil {
+		return nil, err
+	}
+
+	filename := fmt.Sprintf("tenant_%d_orders_%s.csv", tenantID, time.Now().UTC().Format("20060102_150405"))
+	return &dto.AdminOrderExportResponse{
+		Filename:    filename,
+		ContentType: "text/csv",
+		CSV:         buf.String(),
+	}, nil
+}
+
 // PurchaseOrderSnapshot 为“内容购买订单”的下单快照（用于历史展示与争议审计）。
 type PurchaseOrderSnapshot struct {
 	// ContentID 内容ID。

backend/app/services/order_test.go

@@ -827,6 +827,56 @@ func (s *OrderTestSuite) Test_AdminOrderDetail() {
 	})
 }
 
+func (s *OrderTestSuite) Test_AdminOrderExportCSV() {
+	Convey("Order.AdminOrderExportCSV", s.T(), func() {
+		ctx := s.T().Context()
+		now := time.Now().UTC()
+		tenantID := int64(1)
+
+		s.truncate(ctx, models.TableNameOrderItem, models.TableNameOrder, models.TableNameUser, models.TableNameContent)
+
+		Convey("参数非法应返回错误", func() {
+			_, err := Order.AdminOrderExportCSV(ctx, 0, &dto.AdminOrderListFilter{})
+			So(err, ShouldNotBeNil)
+		})
+
+		Convey("导出应返回 CSV 且包含表头", func() {
+			u := &models.User{
+				Username:  "alice",
+				Password:  "x",
+				Roles:     types.NewArray([]consts.Role{consts.RoleUser}),
+				Status:    consts.UserStatusVerified,
+				Metas:     types.JSON([]byte("{}")),
+				CreatedAt: now,
+				UpdatedAt: now,
+			}
+			So(u.Create(ctx), ShouldBeNil)
+
+			o := &models.Order{
+				TenantID:   tenantID,
+				UserID:     u.ID,
+				Type:       consts.OrderTypeContentPurchase,
+				Status:     consts.OrderStatusPaid,
+				Currency:   consts.CurrencyCNY,
+				AmountPaid: 123,
+				Snapshot:   types.JSON([]byte("{}")),
+				PaidAt:     now,
+				CreatedAt:  now,
+				UpdatedAt:  now,
+			}
+			So(o.Create(ctx), ShouldBeNil)
+
+			resp, err := Order.AdminOrderExportCSV(ctx, tenantID, &dto.AdminOrderListFilter{})
+			So(err, ShouldBeNil)
+			So(resp, ShouldNotBeNil)
+			So(resp.ContentType, ShouldEqual, "text/csv")
+			So(resp.Filename, ShouldContainSubstring, "tenant_1_orders_")
+			So(resp.CSV, ShouldContainSubstring, "id,tenant_id,user_id,type,status,amount_paid,paid_at,created_at")
+			So(resp.CSV, ShouldContainSubstring, "content_purchase")
+		})
+	})
+}
+
 func (s *OrderTestSuite) Test_AdminRefundOrder() {
 	Convey("Order.AdminRefundOrder", s.T(), func() {
 		ctx := s.T().Context()

backend/docs/docs.go

@@ -1102,6 +1102,157 @@ const docTemplate = `{
                 }
             }
         },
+        "/t/{tenantCode}/v1/admin/orders/export": {
+            "get": {
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Tenant"
+                ],
+                "summary": "订单导出（租户管理）",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "Tenant Code",
+                        "name": "tenantCode",
+                        "in": "path",
+                        "required": true
+                    },
+                    {
+                        "type": "integer",
+                        "description": "AmountPaidMax 实付金额上限（可选）：amount_paid \u003c= 该值（单位分）。",
+                        "name": "amount_paid_max",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "AmountPaidMin 实付金额下限（可选）：amount_paid \u003e= 该值（单位分）。",
+                        "name": "amount_paid_min",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Asc specifies comma-separated field names to sort ascending by.",
+                        "name": "asc",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "ContentID 内容ID（可选）：通过 order_items 关联过滤。",
+                        "name": "content_id",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "ContentTitle 内容标题关键字（可选）：通过 order_items + contents 关联，模糊匹配 contents.title（like）。",
+                        "name": "content_title",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "CreatedAtFrom 创建时间起（可选）：created_at \u003e= 该时间（用于按创建时间筛选）。",
+                        "name": "created_at_from",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "CreatedAtTo 创建时间止（可选）：created_at \u003c= 该时间（用于按创建时间筛选）。",
+                        "name": "created_at_to",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Desc specifies comma-separated field names to sort descending by.",
+                        "name": "desc",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "Limit is page size; only values in {10,20,50,100} are accepted (otherwise defaults to 10).",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "Page is 1-based page index; values \u003c= 0 are normalized to 1.",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "PaidAtFrom 支付时间起（可选）：paid_at \u003e= 该时间（用于按支付时间筛选）。",
+                        "name": "paid_at_from",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "PaidAtTo 支付时间止（可选）：paid_at \u003c= 该时间（用于按支付时间筛选）。",
+                        "name": "paid_at_to",
+                        "in": "query"
+                    },
+                    {
+                        "enum": [
+                            "created",
+                            "paid",
+                            "refunding",
+                            "refunded",
+                            "canceled",
+                            "failed"
+                        ],
+                        "type": "string",
+                        "x-enum-varnames": [
+                            "OrderStatusCreated",
+                            "OrderStatusPaid",
+                            "OrderStatusRefunding",
+                            "OrderStatusRefunded",
+                            "OrderStatusCanceled",
+                            "OrderStatusFailed"
+                        ],
+                        "description": "Status 订单状态（可选）：created/paid/refunding/refunded/canceled/failed。",
+                        "name": "status",
+                        "in": "query"
+                    },
+                    {
+                        "enum": [
+                            "content_purchase",
+                            "topup"
+                        ],
+                        "type": "string",
+                        "x-enum-varnames": [
+                            "OrderTypeContentPurchase",
+                            "OrderTypeTopup"
+                        ],
+                        "description": "Type 订单类型（可选）：content_purchase/topup 等。",
+                        "name": "type",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "UserID 下单用户ID（可选）：按买家用户ID精确过滤。",
+                        "name": "user_id",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Username 下单用户用户名关键字（可选）：模糊匹配 users.username（like）。",
+                        "name": "username",
+                        "in": "query"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.AdminOrderExportResponse"
+                        }
+                    }
+                }
+            }
+        },
         "/t/{tenantCode}/v1/admin/orders/{orderID}": {
             "get": {
                 "consumes": [
@@ -2251,6 +2402,23 @@ const docTemplate = `{
                 }
             }
         },
+        "dto.AdminOrderExportResponse": {
+            "type": "object",
+            "properties": {
+                "content_type": {
+                    "description": "ContentType 内容类型：当前固定为 text/csv。",
+                    "type": "string"
+                },
+                "csv": {
+                    "description": "CSV CSV 文本内容：UTF-8 编码，包含表头与数据行；前端可直接下载为文件。",
+                    "type": "string"
+                },
+                "filename": {
+                    "description": "Filename 建议文件名：前端可用于下载时的默认文件名。",
+                    "type": "string"
+                }
+            }
+        },
         "dto.AdminOrderRefundForm": {
             "type": "object",
             "properties": {

backend/docs/swagger.json

@@ -1096,6 +1096,157 @@
                 }
             }
         },
+        "/t/{tenantCode}/v1/admin/orders/export": {
+            "get": {
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Tenant"
+                ],
+                "summary": "订单导出（租户管理）",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "description": "Tenant Code",
+                        "name": "tenantCode",
+                        "in": "path",
+                        "required": true
+                    },
+                    {
+                        "type": "integer",
+                        "description": "AmountPaidMax 实付金额上限（可选）：amount_paid \u003c= 该值（单位分）。",
+                        "name": "amount_paid_max",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "AmountPaidMin 实付金额下限（可选）：amount_paid \u003e= 该值（单位分）。",
+                        "name": "amount_paid_min",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Asc specifies comma-separated field names to sort ascending by.",
+                        "name": "asc",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "ContentID 内容ID（可选）：通过 order_items 关联过滤。",
+                        "name": "content_id",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "ContentTitle 内容标题关键字（可选）：通过 order_items + contents 关联，模糊匹配 contents.title（like）。",
+                        "name": "content_title",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "CreatedAtFrom 创建时间起（可选）：created_at \u003e= 该时间（用于按创建时间筛选）。",
+                        "name": "created_at_from",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "CreatedAtTo 创建时间止（可选）：created_at \u003c= 该时间（用于按创建时间筛选）。",
+                        "name": "created_at_to",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Desc specifies comma-separated field names to sort descending by.",
+                        "name": "desc",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "Limit is page size; only values in {10,20,50,100} are accepted (otherwise defaults to 10).",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "Page is 1-based page index; values \u003c= 0 are normalized to 1.",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "PaidAtFrom 支付时间起（可选）：paid_at \u003e= 该时间（用于按支付时间筛选）。",
+                        "name": "paid_at_from",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "PaidAtTo 支付时间止（可选）：paid_at \u003c= 该时间（用于按支付时间筛选）。",
+                        "name": "paid_at_to",
+                        "in": "query"
+                    },
+                    {
+                        "enum": [
+                            "created",
+                            "paid",
+                            "refunding",
+                            "refunded",
+                            "canceled",
+                            "failed"
+                        ],
+                        "type": "string",
+                        "x-enum-varnames": [
+                            "OrderStatusCreated",
+                            "OrderStatusPaid",
+                            "OrderStatusRefunding",
+                            "OrderStatusRefunded",
+                            "OrderStatusCanceled",
+                            "OrderStatusFailed"
+                        ],
+                        "description": "Status 订单状态（可选）：created/paid/refunding/refunded/canceled/failed。",
+                        "name": "status",
+                        "in": "query"
+                    },
+                    {
+                        "enum": [
+                            "content_purchase",
+                            "topup"
+                        ],
+                        "type": "string",
+                        "x-enum-varnames": [
+                            "OrderTypeContentPurchase",
+                            "OrderTypeTopup"
+                        ],
+                        "description": "Type 订单类型（可选）：content_purchase/topup 等。",
+                        "name": "type",
+                        "in": "query"
+                    },
+                    {
+                        "type": "integer",
+                        "description": "UserID 下单用户ID（可选）：按买家用户ID精确过滤。",
+                        "name": "user_id",
+                        "in": "query"
+                    },
+                    {
+                        "type": "string",
+                        "description": "Username 下单用户用户名关键字（可选）：模糊匹配 users.username（like）。",
+                        "name": "username",
+                        "in": "query"
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/dto.AdminOrderExportResponse"
+                        }
+                    }
+                }
+            }
+        },
         "/t/{tenantCode}/v1/admin/orders/{orderID}": {
             "get": {
                 "consumes": [
@@ -2245,6 +2396,23 @@
                 }
             }
         },
+        "dto.AdminOrderExportResponse": {
+            "type": "object",
+            "properties": {
+                "content_type": {
+                    "description": "ContentType 内容类型：当前固定为 text/csv。",
+                    "type": "string"
+                },
+                "csv": {
+                    "description": "CSV CSV 文本内容：UTF-8 编码，包含表头与数据行；前端可直接下载为文件。",
+                    "type": "string"
+                },
+                "filename": {
+                    "description": "Filename 建议文件名：前端可用于下载时的默认文件名。",
+                    "type": "string"
+                }
+            }
+        },
         "dto.AdminOrderRefundForm": {
             "type": "object",
             "properties": {

backend/docs/swagger.yaml

@@ -187,6 +187,18 @@ definitions:
         - $ref: '#/definitions/models.Order'
         description: Order is the order with items preloaded.
     type: object
+  dto.AdminOrderExportResponse:
+    properties:
+      content_type:
+        description: ContentType 内容类型：当前固定为 text/csv。
+        type: string
+      csv:
+        description: CSV CSV 文本内容：UTF-8 编码，包含表头与数据行；前端可直接下载为文件。
+        type: string
+      filename:
+        description: Filename 建议文件名：前端可用于下载时的默认文件名。
+        type: string
+    type: object
   dto.AdminOrderRefundForm:
     properties:
       force:
@@ -1926,6 +1938,112 @@ paths:
       summary: 订单退款（租户管理）
       tags:
       - Tenant
+  /t/{tenantCode}/v1/admin/orders/export:
+    get:
+      consumes:
+      - application/json
+      parameters:
+      - description: Tenant Code
+        in: path
+        name: tenantCode
+        required: true
+        type: string
+      - description: AmountPaidMax 实付金额上限（可选）：amount_paid <= 该值（单位分）。
+        in: query
+        name: amount_paid_max
+        type: integer
+      - description: AmountPaidMin 实付金额下限（可选）：amount_paid >= 该值（单位分）。
+        in: query
+        name: amount_paid_min
+        type: integer
+      - description: Asc specifies comma-separated field names to sort ascending by.
+        in: query
+        name: asc
+        type: string
+      - description: ContentID 内容ID（可选）：通过 order_items 关联过滤。
+        in: query
+        name: content_id
+        type: integer
+      - description: ContentTitle 内容标题关键字（可选）：通过 order_items + contents 关联，模糊匹配 contents.title（like）。
+        in: query
+        name: content_title
+        type: string
+      - description: CreatedAtFrom 创建时间起（可选）：created_at >= 该时间（用于按创建时间筛选）。
+        in: query
+        name: created_at_from
+        type: string
+      - description: CreatedAtTo 创建时间止（可选）：created_at <= 该时间（用于按创建时间筛选）。
+        in: query
+        name: created_at_to
+        type: string
+      - description: Desc specifies comma-separated field names to sort descending
+          by.
+        in: query
+        name: desc
+        type: string
+      - description: Limit is page size; only values in {10,20,50,100} are accepted
+          (otherwise defaults to 10).
+        in: query
+        name: limit
+        type: integer
+      - description: Page is 1-based page index; values <= 0 are normalized to 1.
+        in: query
+        name: page
+        type: integer
+      - description: PaidAtFrom 支付时间起（可选）：paid_at >= 该时间（用于按支付时间筛选）。
+        in: query
+        name: paid_at_from
+        type: string
+      - description: PaidAtTo 支付时间止（可选）：paid_at <= 该时间（用于按支付时间筛选）。
+        in: query
+        name: paid_at_to
+        type: string
+      - description: Status 订单状态（可选）：created/paid/refunding/refunded/canceled/failed。
+        enum:
+        - created
+        - paid
+        - refunding
+        - refunded
+        - canceled
+        - failed
+        in: query
+        name: status
+        type: string
+        x-enum-varnames:
+        - OrderStatusCreated
+        - OrderStatusPaid
+        - OrderStatusRefunding
+        - OrderStatusRefunded
+        - OrderStatusCanceled
+        - OrderStatusFailed
+      - description: Type 订单类型（可选）：content_purchase/topup 等。
+        enum:
+        - content_purchase
+        - topup
+        in: query
+        name: type
+        type: string
+        x-enum-varnames:
+        - OrderTypeContentPurchase
+        - OrderTypeTopup
+      - description: UserID 下单用户ID（可选）：按买家用户ID精确过滤。
+        in: query
+        name: user_id
+        type: integer
+      - description: Username 下单用户用户名关键字（可选）：模糊匹配 users.username（like）。
+        in: query
+        name: username
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/dto.AdminOrderExportResponse'
+      summary: 订单导出（租户管理）
+      tags:
+      - Tenant
   /t/{tenantCode}/v1/admin/users:
     get:
       consumes:

backend/tests/tenant.http

@@ -146,6 +146,11 @@ GET {{ host }}/t/{{ tenantCode }}/v1/admin/orders?page=1&limit=10&username=alice
 Content-Type: application/json
 Authorization: Bearer {{ token }}
 
+### Tenant Admin - Orders export (CSV text)
+GET {{ host }}/t/{{ tenantCode }}/v1/admin/orders/export?username=alice&content_title=Go&type=content_purchase&desc=paid_at
+Content-Type: application/json
+Authorization: Bearer {{ token }}
+
 ### Tenant Admin - Order detail
 @orderID = 1
 GET {{ host }}/t/{{ tenantCode }}/v1/admin/orders/{{ orderID }}