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

43 lines
2.0 KiB
Markdown

# 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