rogee/quyun-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

tenant: admin order export csv

Browse Source
This commit is contained in:
Rogee
2025-12-19 09:11:28 +08:00
parent 549339be74
commit 86a1a0a2cc
9 changed files with 718 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
backend/app/http/tenant/dto/order_admin_export.go Normal file
View File

@@ -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"`
}

35
backend/app/http/tenant/order_admin.go
View File

@@ -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 订单详情（租户管理）

7
backend/app/http/tenant/routes.gen.go
View File

@@ -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,

154
backend/app/services/order.go
View File

@@ -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。

50
backend/app/services/order_test.go
View File

@@ -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()

168
backend/docs/docs.go
View File

@@ -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": {

168
backend/docs/swagger.json
View File

@@ -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": {

118
backend/docs/swagger.yaml
View File

@@ -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:

5
backend/tests/tenant.http
View File

@@ -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 }}