Files
one-pipe-system/openspec/changes/add-commission-management/proposal.md
2026-01-23 17:18:24 +08:00

2.0 KiB

Change: Add Commission Management System

Why

The platform needs a comprehensive commission management system to handle agent commission tracking, withdrawal requests, and administrative approval workflows. Currently, there is no way for agents to view their commissions, request withdrawals, or for administrators to manage these processes.

What Changes

  • Add commission withdrawal approval module for administrators to review and process agent withdrawal requests
  • Add withdrawal settings configuration to manage withdrawal rules (minimum amount, fees, daily limits)
  • Enhance customer account management with improved agent and enterprise account handling
  • Add "My Commission" module for agents to view their commission records and submit withdrawal requests
  • Add agent commission management for administrators to monitor all agent commissions
  • Add new "Commission Management" menu section under "Account Management"

Impact

Affected Specs

  • commission-management (NEW): Complete commission system including withdrawals, settings, and records

Affected Code

  • /src/api/modules/ - New commission-related API services
  • /src/types/api/ - New commission data types
  • /src/views/ - New commission management pages:
    • /finance/commission/withdrawal-approval - Withdrawal approval list
    • /finance/commission/withdrawal-settings - Withdrawal configuration
    • /finance/commission/my-commission - My commission records
    • /finance/commission/agent-commission - Agent commission management
  • /src/router/routes/asyncRoutes.ts - New commission routes
  • /src/locales/ - Commission-related translations
  • /src/config/constants/ - Commission status constants

Data Models

  • WithdrawalRequest - Withdrawal application records
  • WithdrawalSetting - Withdrawal configuration
  • CommissionRecord - Commission transaction records
  • CommissionSummary - Commission aggregated data
  • Enhanced CustomerAccount - Updated customer account structure
  • Enhanced Enterprise - Updated enterprise structure