feat: ✨ 营销管理-返佣比率

tk · nsnail · commit e5a0f925a065 · 2025-06-30T16:38:23.000+08:00
diff --git a/src/backend/NetAdmin/NetAdmin.Domain/DbMaps/Sys/Sys_UserInvite.cs b/src/backend/NetAdmin/NetAdmin.Domain/DbMaps/Sys/Sys_UserInvite.cs
@@ -14,6 +14,14 @@ public record Sys_UserInvite : VersionEntity, IFieldOwner
     [Navigate(nameof(OwnerId))]
     public IEnumerable<Sys_UserInvite> Children { get; init; }
 
+    /// <summary>
+    ///     返佣比率
+    /// </summary>
+    [Column]
+    [CsvIgnore]
+    [JsonIgnore]
+    public virtual int CommissionRatio { get; init; }
+
     /// <summary>
     ///     归属
     /// </summary>
diff --git a/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/CreateUserInviteReq.cs b/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/CreateUserInviteReq.cs
@@ -3,4 +3,9 @@ namespace NetAdmin.Domain.Dto.Sys.UserInvite;
 /// <summary>
 ///     请求：创建用户邀请
 /// </summary>
-public record CreateUserInviteReq : Sys_UserInvite;
+public record CreateUserInviteReq : Sys_UserInvite
+{
+    /// <inheritdoc cref="Sys_UserInvite.CommissionRatio" />
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public override int CommissionRatio { get; init; }
+}
diff --git a/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/QueryUserInviteRsp.cs b/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/QueryUserInviteRsp.cs
@@ -10,6 +10,10 @@ public record QueryUserInviteRsp : Sys_UserInvite
     /// <inheritdoc cref="Sys_UserInvite.Children" />
     public new virtual IEnumerable<QueryUserInviteRsp> Children { get; init; }
 
+    /// <inheritdoc cref="Sys_UserInvite.CommissionRatio" />
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public override int CommissionRatio { get; init; }
+
     /// <inheritdoc cref="IFieldCreatedTime.CreatedTime" />
     [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
     public override DateTime CreatedTime { get; init; }
diff --git a/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/SetCommissionRatioReq.cs b/src/backend/NetAdmin/NetAdmin.Domain/Dto/Sys/UserInvite/SetCommissionRatioReq.cs
@@ -0,0 +1,15 @@
+namespace NetAdmin.Domain.Dto.Sys.UserInvite;
+
+/// <summary>
+///     请求：设置返佣比率
+/// </summary>
+public record SetCommissionRatioReq : CreateUserInviteReq
+{
+    /// <inheritdoc cref="EntityBase{T}.Id" />
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public override long Id { get; init; }
+
+    /// <inheritdoc cref="IFieldVersion.Version" />
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public override long Version { get; init; }
+}
diff --git a/src/backend/NetAdmin/NetAdmin.SysComponent.Application/Modules/Sys/IUserInviteModule.cs b/src/backend/NetAdmin/NetAdmin.SysComponent.Application/Modules/Sys/IUserInviteModule.cs
@@ -9,4 +9,10 @@ public interface IUserInviteModule : ICrudModule<CreateUserInviteReq, QueryUserI
   , EditUserInviteReq                                                                    // 编辑类型
   , QueryUserInviteReq, QueryUserInviteRsp                                               // 查询类型
   , DelReq                                                                               // 删除类型
->;
+>
+{
+    /// <summary>
+    ///     设置返佣比率
+    /// </summary>
+    Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req);
+}
diff --git a/src/backend/NetAdmin/NetAdmin.SysComponent.Application/Services/Sys/UserInviteService.cs b/src/backend/NetAdmin/NetAdmin.SysComponent.Application/Services/Sys/UserInviteService.cs
@@ -108,6 +108,13 @@ public async Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUser
         return ret.Adapt<IEnumerable<QueryUserInviteRsp>>();
     }
 
+    /// <inheritdoc />
+    public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)
+    {
+        req.ThrowIfInvalid();
+        return UpdateAsync(req with { CommissionRatio = req.CommissionRatio }, [nameof(req.CommissionRatio)], null, a => a.Id == req.Id, null, true);
+    }
+
     private ISelect<Sys_UserInvite> QueryInternal(QueryReq<QueryUserInviteReq> req)
     {
         var ret = Rpo.Select.WhereDynamicFilter(req.DynamicFilter).WhereDynamic(req.Filter);
diff --git a/src/backend/NetAdmin/NetAdmin.SysComponent.Cache/Sys/UserInviteCache.cs b/src/backend/NetAdmin/NetAdmin.SysComponent.Cache/Sys/UserInviteCache.cs
@@ -65,4 +65,10 @@ public Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUserInvite
     {
         return Service.QueryAsync(req);
     }
+
+    /// <inheritdoc />
+    public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)
+    {
+        return Service.SetCommissionRatioAsync(req);
+    }
 }
diff --git a/src/backend/NetAdmin/NetAdmin.SysComponent.Host/Controllers/Sys/UserInviteController.cs b/src/backend/NetAdmin/NetAdmin.SysComponent.Host/Controllers/Sys/UserInviteController.cs
@@ -93,4 +93,12 @@ public Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUserInvite
     {
         return Cache.QueryAsync(req);
     }
+
+    /// <summary>
+    ///     设置返佣比率
+    /// </summary>
+    public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)
+    {
+        return Cache.SetCommissionRatioAsync(req);
+    }
 }
diff --git a/src/frontend/admin/src/api/sys/userinvite.js b/src/frontend/admin/src/api/sys/userinvite.js
@@ -103,4 +103,15 @@ export default {
             return await http.post(this.url, data, config)
         },
     },
+
+    /**
+     * 设置返佣比率
+     */
+    setCommissionRatio: {
+        url: `${config.API_URL}/api/sys/user.invite/set.commission.ratio`,
+        name: `设置返佣比率`,
+        post: async function (data = {}, config = {}) {
+            return await http.post(this.url, data, config)
+        },
+    },
 }
diff --git a/src/frontend/admin/src/views/sys/invite/index.vue b/src/frontend/admin/src/views/sys/invite/index.vue
@@ -44,14 +44,16 @@
                         </el-icon>
                     </el-button>
                     <template #dropdown>
-                        <el-dropdown-menu> </el-dropdown-menu>
+                        <el-dropdown-menu>
+                            <el-dropdown-item @click="setCommissionRatio">设置返佣比率</el-dropdown-item>
+                        </el-dropdown-menu>
                     </template>
                 </el-dropdown>
             </div>
         </el-header>
         <el-main class="nopadding">
             <scTable
-                :context-menus="['id', 'user.userName', 'createdTime']"
+                :context-menus="['id', 'user.userName', 'createdTime', 'commissionRatio']"
                 :context-opers="[]"
                 :default-sort="{ prop: 'sort', order: 'descending' }"
                 :params="query"
@@ -73,7 +75,13 @@
                 <el-table-column type="selection" width="50" />
                 <el-table-column :label="$t('用户编号')" prop="id" sortable="custom" />
                 <naColAvatar :label="$t('用户名')" prop="user.userName" />
-                <el-table-column :label="$t('注册时间')" prop="createdTime" sortable="custom" />
+                <el-table-column
+                    :formatter="(row) => `${(row.commissionRatio / 100).toFixed(2)}%`"
+                    :label="$t('返佣比率')"
+                    align="right"
+                    prop="commissionRatio"
+                    sortable="custom" />
+                <el-table-column :label="$t('注册时间')" align="right" prop="createdTime" sortable="custom" />
             </scTable>
         </el-main>
     </el-container>
@@ -117,6 +125,29 @@ export default {
     },
     inject: ['reload'],
     methods: {
+        async setCommissionRatio() {
+            let loading
+            try {
+                const prompt = await this.$prompt(this.$t('1 代表 0.01%'), this.$t('设置返佣比率'), {
+                    inputPattern: /^[0-9]\d*$/,
+                    inputErrorMessage: this.$t('返佣比率不正确'),
+                })
+                loading = this.$loading()
+                const res = await Promise.all(
+                    this.selection.map((x) => this.$API.sys_userinvite.setCommissionRatio.post(Object.assign(x, { commissionRatio: prompt.value }))),
+                )
+                this.$message.success(
+                    this.$t(`操作成功 {count}/{total} 项`, {
+                        count: this.selection.length,
+                        total: res.map((x) => x.data ?? 0).reduce((a, b) => a + b, 0),
+                    }),
+                )
+                this.$refs.table.refresh()
+            } catch {
+                //
+            }
+            loading?.close()
+        },
         async getStatistics() {
             this.statistics.total = this.$refs.table?.tableData?.length
         },

Original file line number	Diff line number	Diff line change
`@@ -108,6 +108,13 @@ public async Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUser`
`108`	`108`	`return ret.Adapt<IEnumerable<QueryUserInviteRsp>>();`
`109`	`109`	`}`
`110`	`110`
	`111`	`+ /// <inheritdoc />`
	`112`	`+ public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)`
	`113`	`+ {`
	`114`	`+ req.ThrowIfInvalid();`
	`115`	`+ return UpdateAsync(req with { CommissionRatio = req.CommissionRatio }, [nameof(req.CommissionRatio)], null, a => a.Id == req.Id, null, true);`
	`116`	`+ }`
	`117`	`+`
`111`	`118`	`private ISelect<Sys_UserInvite> QueryInternal(QueryReq<QueryUserInviteReq> req)`
`112`	`119`	`{`
`113`	`120`	`var ret = Rpo.Select.WhereDynamicFilter(req.DynamicFilter).WhereDynamic(req.Filter);`
Original file line number	Diff line number	Diff line change
`@@ -65,4 +65,10 @@ public Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUserInvite`
`65`	`65`	`{`
`66`	`66`	`return Service.QueryAsync(req);`
`67`	`67`	`}`
	`68`	`+`
	`69`	`+ /// <inheritdoc />`
	`70`	`+ public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)`
	`71`	`+ {`
	`72`	`+ return Service.SetCommissionRatioAsync(req);`
	`73`	`+ }`
`68`	`74`	`}`
Original file line number	Diff line number	Diff line change
`@@ -93,4 +93,12 @@ public Task<IEnumerable<QueryUserInviteRsp>> QueryAsync(QueryReq<QueryUserInvite`
`93`	`93`	`{`
`94`	`94`	`return Cache.QueryAsync(req);`
`95`	`95`	`}`
	`96`	`+`
	`97`	`+ /// <summary>`
	`98`	`+ /// 设置返佣比率`
	`99`	`+ /// </summary>`
	`100`	`+ public Task<int> SetCommissionRatioAsync(SetCommissionRatioReq req)`
	`101`	`+ {`
	`102`	`+ return Cache.SetCommissionRatioAsync(req);`
	`103`	`+ }`
`96`	`104`	`}`