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

feat: add batch content governance actions

Browse Source
This commit is contained in:
Rogee
2026-01-16 14:19:43 +08:00
parent e5f40287c3
commit daaacc3fa4
11 changed files with 431 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
backend/app/http/super/v1/contents.go
View File

@@ -116,3 +116,19 @@ func (c *contents) Review(ctx fiber.Ctx, user *models.User, id int64, form *dto.
func (c *contents) BatchReview(ctx fiber.Ctx, user *models.User, form *dto.SuperContentBatchReviewForm) error {
return services.Super.BatchReviewContents(ctx, user.ID, form)
}
// Batch update content status
//
// @Router /super/v1/contents/status/batch [post]
// @Summary Batch update content status
// @Description Batch unpublish or block contents
// @Tags Content
// @Accept json
// @Produce json
// @Param form body dto.SuperContentBatchStatusForm true "Batch status form"
// @Success 200 {string} string "Updated"
// @Bind user local key(__ctx_user)
// @Bind form body
func (c *contents) BatchUpdateStatus(ctx fiber.Ctx, user *models.User, form *dto.SuperContentBatchStatusForm) error {
return services.Super.BatchUpdateContentStatus(ctx, user.ID, form)
}

9
backend/app/http/super/v1/dto/super.go
View File

@@ -446,6 +446,15 @@ type SuperContentBatchReviewForm struct {
Reason string `json:"reason"`
}
type SuperContentBatchStatusForm struct {
// ContentIDs 待处置内容ID列表。
ContentIDs []int64 `json:"content_ids" validate:"required,min=1,dive,gt=0"`
// Status 目标内容状态（unpublished/blocked）。
Status consts.ContentStatus `json:"status" validate:"required,oneof=unpublished blocked"`
// Reason 处置说明（可选，用于审计与通知作者）。
Reason string `json:"reason"`
}
type SuperTenantUserItem struct {
// User 用户信息。
User *SuperUserLite `json:"user"`

6
backend/app/http/super/v1/routes.gen.go
View File

@@ -145,6 +145,12 @@ func (r *Routes) Register(router fiber.Router) {
Local[*models.User]("__ctx_user"),
Body[dto.SuperContentBatchReviewForm]("form"),
))
r.log.Debugf("Registering route: Post /super/v1/contents/status/batch -> contents.BatchUpdateStatus")
router.Post("/super/v1/contents/status/batch"[len(r.Path()):], Func2(
r.contents.BatchUpdateStatus,
Local[*models.User]("__ctx_user"),
Body[dto.SuperContentBatchStatusForm]("form"),
))
// Register routes for controller: coupons
r.log.Debugf("Registering route: Get /super/v1/coupon-grants -> coupons.ListGrants")
router.Get("/super/v1/coupon-grants"[len(r.Path()):], DataFunc1(

79
backend/app/services/super.go
View File

@@ -3240,6 +3240,85 @@ func (s *super) BatchReviewContents(ctx context.Context, operatorID int64, form
return nil
}
func (s *super) BatchUpdateContentStatus(ctx context.Context, operatorID int64, form *super_dto.SuperContentBatchStatusForm) error {
if operatorID == 0 {
return errorx.ErrUnauthorized.WithMsg("缺少操作者信息")
}
if form == nil {
return errorx.ErrBadRequest.WithMsg("处置参数不能为空")
}
status := form.Status
if status != consts.ContentStatusUnpublished && status != consts.ContentStatusBlocked {
return errorx.ErrBadRequest.WithMsg("处置状态非法")
}
// 去重并过滤非法ID，避免批量处置出现空指令。
unique := make(map[int64]struct{})
contentIDs := make([]int64, 0, len(form.ContentIDs))
for _, id := range form.ContentIDs {
if id <= 0 {
continue
}
if _, ok := unique[id]; ok {
continue
}
unique[id] = struct{}{}
contentIDs = append(contentIDs, id)
}
if len(contentIDs) == 0 {
return errorx.ErrBadRequest.WithMsg("内容ID不能为空")
}
reason := strings.TrimSpace(form.Reason)
var contents []*models.Content
err := models.Q.Transaction(func(tx *models.Query) error {
tbl, q := tx.Content.QueryContext(ctx)
list, err := q.Where(tbl.ID.In(contentIDs...)).Find()
if err != nil {
return errorx.ErrDatabaseError.WithCause(err)
}
if len(list) != len(contentIDs) {
return errorx.ErrRecordNotFound.WithMsg("部分内容不存在")
}
// 内容治理批量处置，统一更新状态与更新时间。
updates := &models.Content{
Status: status,
UpdatedAt: time.Now(),
}
if _, err := q.Where(tbl.ID.In(contentIDs...)).Updates(updates); err != nil {
return errorx.ErrDatabaseError.WithCause(err)
}
contents = list
return nil
})
if err != nil {
return err
}
title := "内容治理结果"
detail := "内容已下架"
action := "content_unpublish"
if status == consts.ContentStatusBlocked {
detail = "内容已封禁"
action = "content_block"
}
if reason != "" {
detail += "，原因：" + reason
}
for _, content := range contents {
if Notification != nil {
_ = Notification.Send(ctx, content.TenantID, content.UserID, string(consts.NotificationTypeAudit), title, detail)
}
if Audit != nil {
Audit.Log(ctx, content.TenantID, operatorID, action, cast.ToString(content.ID), detail)
}
}
return nil
}
func (s *super) ContentStatistics(ctx context.Context, filter *super_dto.SuperContentStatisticsFilter) (*super_dto.SuperContentStatisticsResponse, error) {
// 统一统计时间范围与粒度，默认最近 7 天。
reportFilter := &super_dto.SuperReportOverviewFilter{}

45
backend/app/services/super_test.go
View File

@@ -600,6 +600,51 @@ func (s *SuperTestSuite) Test_ContentReview() {
})
}
func (s *SuperTestSuite) Test_BatchUpdateContentStatus() {
Convey("BatchUpdateContentStatus", s.T(), func() {
ctx := s.T().Context()
database.Truncate(ctx, s.DB, models.TableNameUser, models.TableNameTenant, models.TableNameContent)
admin := &models.User{Username: "batch_admin"}
owner := &models.User{Username: "batch_owner"}
models.UserQuery.WithContext(ctx).Create(admin, owner)
tenant := &models.Tenant{
UserID: owner.ID,
Name: "Batch Tenant",
Code: "batch",
Status: consts.TenantStatusVerified,
}
models.TenantQuery.WithContext(ctx).Create(tenant)
content1 := &models.Content{
TenantID: tenant.ID,
UserID: owner.ID,
Title: "Batch Content 1",
Status: consts.ContentStatusPublished,
}
content2 := &models.Content{
TenantID: tenant.ID,
UserID: owner.ID,
Title: "Batch Content 2",
Status: consts.ContentStatusUnpublished,
}
models.ContentQuery.WithContext(ctx).Create(content1, content2)
err := Super.BatchUpdateContentStatus(ctx, admin.ID, &super_dto.SuperContentBatchStatusForm{
ContentIDs: []int64{content1.ID, content2.ID},
Status: consts.ContentStatusBlocked,
Reason: "违规处理",
})
So(err, ShouldBeNil)
reloaded1, _ := models.ContentQuery.WithContext(ctx).Where(models.ContentQuery.ID.Eq(content1.ID)).First()
reloaded2, _ := models.ContentQuery.WithContext(ctx).Where(models.ContentQuery.ID.Eq(content2.ID)).First()
So(reloaded1.Status, ShouldEqual, consts.ContentStatusBlocked)
So(reloaded2.Status, ShouldEqual, consts.ContentStatusBlocked)
})
}
func (s *SuperTestSuite) Test_OrderGovernance() {
Convey("OrderGovernance", s.T(), func() {
ctx := s.T().Context()

67
backend/docs/docs.go
View File

@@ -543,6 +543,40 @@ const docTemplate = `{
}
}
},
"/super/v1/contents/status/batch": {
"post": {
"description": "Batch unpublish or block contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Batch update content status",
"parameters": [
{
"description": "Batch status form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentBatchStatusForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/contents/{id}/review": {
"post": {
"description": "Review content",
@@ -8013,6 +8047,39 @@ const docTemplate = `{
}
}
},
"dto.SuperContentBatchStatusForm": {
"type": "object",
"required": [
"content_ids",
"status"
],
"properties": {
"content_ids": {
"description": "ContentIDs 待处置内容ID列表。",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
}
},
"reason": {
"description": "Reason 处置说明（可选，用于审计与通知作者）。",
"type": "string"
},
"status": {
"description": "Status 目标内容状态（unpublished/blocked）。",
"enum": [
"unpublished",
"blocked"
],
"allOf": [
{
"$ref": "#/definitions/consts.ContentStatus"
}
]
}
}
},
"dto.SuperContentReportItem": {
"type": "object",
"properties": {

67
backend/docs/swagger.json
View File

@@ -537,6 +537,40 @@
}
}
},
"/super/v1/contents/status/batch": {
"post": {
"description": "Batch unpublish or block contents",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Content"
],
"summary": "Batch update content status",
"parameters": [
{
"description": "Batch status form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.SuperContentBatchStatusForm"
}
}
],
"responses": {
"200": {
"description": "Updated",
"schema": {
"type": "string"
}
}
}
}
},
"/super/v1/contents/{id}/review": {
"post": {
"description": "Review content",
@@ -8007,6 +8041,39 @@
}
}
},
"dto.SuperContentBatchStatusForm": {
"type": "object",
"required": [
"content_ids",
"status"
],
"properties": {
"content_ids": {
"description": "ContentIDs 待处置内容ID列表。",
"type": "array",
"minItems": 1,
"items": {
"type": "integer"
}
},
"reason": {
"description": "Reason 处置说明（可选，用于审计与通知作者）。",
"type": "string"
},
"status": {
"description": "Status 目标内容状态（unpublished/blocked）。",
"enum": [
"unpublished",
"blocked"
],
"allOf": [
{
"$ref": "#/definitions/consts.ContentStatus"
}
]
}
}
},
"dto.SuperContentReportItem": {
"type": "object",
"properties": {

44
backend/docs/swagger.yaml
View File

@@ -1376,6 +1376,28 @@ definitions:
- action
- content_ids
type: object
dto.SuperContentBatchStatusForm:
properties:
content_ids:
description: ContentIDs 待处置内容ID列表。
items:
type: integer
minItems: 1
type: array
reason:
description: Reason 处置说明（可选，用于审计与通知作者）。
type: string
status:
allOf:
- $ref: '#/definitions/consts.ContentStatus'
description: Status 目标内容状态（unpublished/blocked）。
enum:
- unpublished
- blocked
required:
- content_ids
- status
type: object
dto.SuperContentReportItem:
properties:
content_id:
@@ -3617,6 +3639,28 @@ paths:
summary: Content statistics
tags:
- Content
/super/v1/contents/status/batch:
post:
consumes:
- application/json
description: Batch unpublish or block contents
parameters:
- description: Batch status form
in: body
name: form
required: true
schema:
$ref: '#/definitions/dto.SuperContentBatchStatusForm'
produces:
- application/json
responses:
"200":
description: Updated
schema:
type: string
summary: Batch update content status
tags:
- Content
/super/v1/coupon-grants:
get:
consumes:

6
docs/superadmin_progress.md
View File

@@ -41,9 +41,9 @@
- 缺口：无显著功能缺口。
### 2.7 内容治理 `/superadmin/contents`
- 状态：**部分完成**
- 已有：跨租户列表、下架、审核流（含批量审核）、评论治理、内容举报处理。
- 缺口：批量处置扩展（如批量下架/封禁）。
- 状态：**已完成**
- 已有：跨租户列表、下架、审核流（含批量审核）、批量下架/封禁、评论治理、内容举报处理。
- 缺口：无显著功能缺口。
### 2.8 订单与退款 `/superadmin/orders`
- 状态：**已完成**

11
frontend/superadmin/src/service/ContentService.js
View File

@@ -131,6 +131,17 @@ export const ContentService = {
}
});
},
async batchUpdateContentStatus({ content_ids, status, reason } = {}) {
if (!Array.isArray(content_ids) || content_ids.length === 0) throw new Error('content_ids is required');
return requestJson('/super/v1/contents/status/batch', {
method: 'POST',
body: {
content_ids,
status,
reason
}
});
},
async getContentStatistics({ tenant_id, start_at, end_at, granularity } = {}) {
const iso = (d) => {
if (!d) return undefined;

84
frontend/superadmin/src/views/superadmin/Contents.vue
View File

@@ -102,6 +102,17 @@ const reviewActionOptions = [
{ label: '驳回', value: 'reject' }
];
const batchStatusDialogVisible = ref(false);
const batchStatusSubmitting = ref(false);
const batchStatusValue = ref('unpublished');
const batchStatusReason = ref('');
const batchStatusTargetIDs = ref([]);
const batchStatusOptions = [
{ label: '下架内容', value: 'unpublished' },
{ label: '封禁内容', value: 'blocked' }
];
const statusOptions = [
{ label: '全部', value: '' },
{ label: 'draft', value: 'draft' },
@@ -359,6 +370,7 @@ function getReportActionLabel(value) {
const selectedCount = computed(() => selectedContents.value.length);
const reviewTargetCount = computed(() => reviewTargetIDs.value.length);
const batchStatusTargetCount = computed(() => batchStatusTargetIDs.value.length);
const reportProcessNeedsContentAction = computed(() => reportProcessAction.value === 'approve');
async function loadContents() {
@@ -449,6 +461,52 @@ async function confirmReview() {
}
}
function openBatchStatusDialog(statusValue) {
if (!selectedContents.value.length) {
toast.add({ severity: 'warn', summary: '请先选择内容', detail: '至少选择 1 条内容进行处置', life: 3000 });
return;
}
const ids = selectedContents.value.map((row) => getContentID(row)).filter((id) => id > 0);
if (!ids.length) {
toast.add({ severity: 'warn', summary: '选择无效', detail: '未识别到可处置的内容', life: 3000 });
return;
}
batchStatusTargetIDs.value = ids;
batchStatusValue.value = statusValue || 'unpublished';
batchStatusReason.value = '';
batchStatusDialogVisible.value = true;
}
async function confirmBatchStatus() {
const ids = batchStatusTargetIDs.value.filter((id) => id > 0);
if (!ids.length) return;
const statusValue = batchStatusValue.value;
const reason = batchStatusReason.value.trim();
if (statusValue === 'blocked' && !reason) {
toast.add({ severity: 'warn', summary: '请输入原因', detail: '封禁内容时需填写原因', life: 3000 });
return;
}
batchStatusSubmitting.value = true;
try {
await ContentService.batchUpdateContentStatus({
content_ids: ids,
status: statusValue,
reason: reason || undefined
});
toast.add({ severity: 'success', summary: '处置完成', detail: `已处理 ${ids.length} 条内容`, life: 3000 });
batchStatusDialogVisible.value = false;
batchStatusTargetIDs.value = [];
selectedContents.value = [];
await loadContents();
} catch (error) {
toast.add({ severity: 'error', summary: '处置失败', detail: error?.message || '无法完成内容处置', life: 4000 });
} finally {
batchStatusSubmitting.value = false;
}
}
function onSearch() {
page.value = 1;
loadContents();
@@ -721,6 +779,8 @@ watch(
<div class="flex items-center gap-2">
<Button label="批量通过" icon="pi pi-check" severity="success" :disabled="selectedCount === 0" @click="openBatchReviewDialog('approve')" />
<Button label="批量驳回" icon="pi pi-times" severity="danger" :disabled="selectedCount === 0" @click="openBatchReviewDialog('reject')" />
<Button label="批量下架" icon="pi pi-ban" severity="warning" :disabled="selectedCount === 0" @click="openBatchStatusDialog('unpublished')" />
<Button label="批量封禁" icon="pi pi-shield" severity="danger" :disabled="selectedCount === 0" @click="openBatchStatusDialog('blocked')" />
<Button label="刷新" icon="pi pi-refresh" severity="secondary" @click="loadContents" :disabled="loading" />
</div>
</div>
@@ -1213,6 +1273,30 @@ watch(
</template>
</Dialog>
<Dialog v-model:visible="batchStatusDialogVisible" :modal="true" :style="{ width: '520px' }">
<template #header>
<div class="flex items-center gap-2">
<span class="font-medium">批量处置内容</span>
<span class="text-muted-color">共 {{ batchStatusTargetCount }} 条</span>
</div>
</template>
<div class="flex flex-col gap-4">
<div>
<label class="block font-medium mb-2">处置动作</label>
<Select v-model="batchStatusValue" :options="batchStatusOptions" optionLabel="label" optionValue="value" class="w-full" />
</div>
<div>
<label class="block font-medium mb-2">处置说明</label>
<InputText v-model="batchStatusReason" placeholder="封禁内容建议填写原因" class="w-full" />
</div>
<div class="text-sm text-muted-color">处置后会记录审计并通知作者。</div>
</div>
<template #footer>
<Button label="取消" icon="pi pi-times" text @click="batchStatusDialogVisible = false" :disabled="batchStatusSubmitting" />
<Button label="确认处置" icon="pi pi-check" severity="danger" @click="confirmBatchStatus" :loading="batchStatusSubmitting" :disabled="batchStatusSubmitting || (batchStatusValue === 'blocked' && !batchStatusReason.trim())" />
</template>
</Dialog>
<Dialog v-model:visible="reportProcessDialogVisible" :modal="true" :style="{ width: '560px' }">
<template #header>
<div class="flex items-center gap-2">