📝 docs: Add documentation

This commit is contained in:
web@ppanel
2025-12-11 03:29:07 +00:00
parent 50e695a1bb
commit 99e7f6062d
135 changed files with 79115 additions and 8 deletions
+380
View File
@@ -0,0 +1,380 @@
# Announcement Management
The Announcement Management module publishes and manages system announcements to communicate important information to users.
## Overview
### Announcement List
View and manage all announcements:
- **Title**: Announcement topic
- **Type**: System/Maintenance/Activity/Update
- **Status**: Draft/Published/Offline
- **Publish Time**: Publication datetime
- **Display Position**: Homepage/User Center/Admin
- **Priority**: High/Medium/Low
- **Views**: View count
### Create Announcement
Publish new announcement:
#### Basic Info
- **Title**: Concise title
- **Type**: Select type
- **Content**: Detailed content (rich text)
- **Summary**: Brief summary (list display)
#### Display Settings
- **Display Position**: Choose locations
- Homepage Banner
- Announcement Bar
- User Center
- Admin Panel
- Popup Alert
- **Display Style**: Configure style
- Banner style
- List style
- Popup style
- Floating alert
#### Publish Settings
- **Publish Time**:
- Publish now
- Scheduled publish
- Specific datetime
- **Offline Time**:
- Permanent display
- Specific offline time
- Manual offline
- **Priority**: Set display priority
#### Target Users
- **All Users**: Show to everyone
- **New Users**: New registrations only
- **Existing Users**: Existing users only
- **Specific Groups**: Designated groups
- **VIP Users**: VIP users only
### Edit Announcement
Modify published announcement:
- Update content
- Adjust display settings
- Modify publish time
- Change target users
::: tip Tip
Modifying published announcements affects live display. Use caution.
:::
### Delete Announcement
Remove announcement:
- **Offline**: Stop display but keep data
- **Delete**: Permanently remove
- Reading records retained for stats
## Announcement Types
### System Announcement
Important system notifications:
**Use Cases**:
- System upgrade notice
- Terms of service changes
- Policy adjustments
- Major feature launches
**Examples**:
- System maintenance at XX time
- Service agreement update
- New feature announcement
### Maintenance Announcement
System maintenance notices:
**Use Cases**:
- Scheduled maintenance
- Incident explanation
- Service recovery notice
**Examples**:
- Regular maintenance notice
- Emergency incident alert
- Service restored notification
### Activity Announcement
Marketing activity notices:
**Use Cases**:
- Promotion preview
- Discount information
- Activity rules
**Examples**:
- Double 11 sale preview
- Limited-time offer
- New user exclusive
### Update Announcement
Product update notes:
**Use Cases**:
- Feature updates
- Product optimization
- Bug fix notes
**Examples**:
- v2.0 update notes
- New XX feature
- Performance optimization
## Announcement Display
### Banner
Homepage carousel banner:
- Large image, strong visual impact
- Multi-image carousel
- Click to detail page
- Suitable for major campaigns
### List
Announcement list display:
- Title list format
- Category filtering
- Click for details
- Suitable for regular announcements
### Popup
Popup alert:
- Display on login
- Mandatory reading
- Close after confirmation
- Suitable for important notices
### Floating Bar
Floating alert bar:
- Float at page top
- Manually closable
- Non-intrusive
- Suitable for tips
## Announcement Push
### On-site Push
Push within system:
- **Homepage Display**: Prominent position
- **Message Center**: Push to message center
- **Popup Alert**: Login popup
- **Email Push**: Send email
### Targeted Push
Push to specific users:
- Push by user group
- Push by user tags
- Push by user behavior
- Personalized content
### Push Timing
Choose optimal timing:
- **Immediate**: Urgent announcements
- **Scheduled**: Optimal time
- **Event Triggered**: Specific events
- **Periodic**: Regular push
## Statistics
### Reading Stats
Track reading:
- **Views**: View count
- **Read Rate**: Reading user ratio
- **Readers**: User list
- **Time Distribution**: Reading time
### Click Stats
Track clicks:
- **Clicks**: Click count
- **Click Rate**: Click/impression ratio
- **Link Tracking**: External link clicks
- **Conversion**: Announcement conversions
### Effect Analysis
Analyze effectiveness:
- **Reach Rate**: Push reach rate
- **Engagement**: User engagement
- **Conversion**: Conversion effects
- **User Feedback**: Feedback opinions
## Templates
### Common Templates
Preset templates:
- **Maintenance Template**: Standard format
- **Campaign Template**: Activity format
- **Update Template**: Update notes format
- **Urgent Template**: Emergency format
### Custom Templates
Create custom templates:
- Design announcement style
- Define content structure
- Save as template
- Reuse templates
## Approval
### Approval Flow
Announcement approval:
1. **Create Draft**: Edit content
2. **Submit**: Submit for review
3. **Review**: Reviewer checks
4. **Publish**: Publish after approval
5. **Monitor**: Track after publish
### Approval Permissions
Set permissions:
- **Create**: Who can create
- **Review**: Who can review
- **Publish**: Who can publish
- **Delete**: Who can delete
## Best Practices
### Content Writing
- Clear, concise title highlighting key points
- Accurate, complete content avoiding ambiguity
- Plain language, user-friendly
- Bold important information
- Provide contact information
### Publish Timing
- Choose active user periods
- Avoid holidays for important notices
- Urgent announcements publish immediately
- Regular announcements schedule ahead
### Frequency Control
- Avoid over-notification
- Control announcement quantity
- Prioritize important announcements
- Clean up expired announcements
### Effect Tracking
- Monitor reading data
- Collect user feedback
- Analyze effectiveness
- Continuous optimization
## Scenario Examples
### Maintenance Notice
**Title**: System Maintenance Notice
**Content**:
- Time: 2024-01-01 02:00-06:00
- Content: System upgrade and optimization
- Impact: All services temporarily unavailable
- Compensation: 1 day membership extension
### Campaign Preview
**Title**: Double 11 Festival
**Content**:
- Time: Nov 11 00:00-23:59
- Content: 50% off sitewide
- Coupons: $20 off $100
- How to Join: Click for details
### Feature Launch
**Title**: New Feature Launch
**Content**:
- Feature: Traffic statistics
- Description: Real-time traffic tracking
- How to Use: User Center - Traffic Stats
- Feedback: Welcome suggestions
## Troubleshooting
### Announcement Not Showing
Check:
1. Is announcement published
2. Is publish time correct
3. Is target user setting correct
4. Is display position correct
### Display Anomaly
Possible causes:
1. Content format issues
2. Image link broken
3. Style conflicts
4. Browser compatibility
### Push Failed
Check:
1. Is push config correct
2. Is user contact valid
3. Is push service working
4. Reached push limits
## Next Steps
- [Marketing Management](/admin/commerce/marketing) - Plan campaigns
- [User Management](/admin/users-support/users) - Manage target users
- [System Config](/admin/system/config) - Configure announcement system
+176
View File
@@ -0,0 +1,176 @@
<div v-pre>
# Coupon Management
Manage coupons in the system, including creating, editing, and enabling/disabling functions. Coupons provide purchase discounts for users.
## Table Column Description
### Enable
Switch button to control whether the coupon is available. When off, users cannot use this coupon.
### Name
Coupon name for management identification.
### Code
Coupon redemption code that users enter during purchase to apply the coupon.
### Type
Coupon discount type:
- **Percentage** - Discount by percentage (e.g., 10%)
- **Amount** - Fixed amount discount (e.g., $50)
### Discount
Discount value:
- Percentage type shows percentage (e.g., 10%)
- Amount type shows currency amount (e.g., $50)
### Count
Displays three lines of information:
- **Count** - Total available usage count (0 = unlimited)
- **Remaining** - Remaining usage count
- **Usage Times** - Times already used
### Validity Period
Coupon's valid time range:
- Shows start time and end time
- If only start time, shows single time
- No restriction shows "--"
## Table Operations
### Edit
Opens side drawer form to modify coupon information.
### Delete
Deletes coupon (requires confirmation), used coupons can also be deleted.
### Batch Delete
Deletes multiple selected coupons.
## Coupon Form
### Name (Required)
Management name for the coupon, not displayed to users.
### Custom Coupon Code (Optional)
Custom redemption code, leave blank for system auto-generation.
### Coupon Type (Required)
Radio button to select type:
- **Percentage Discount** - Discount by order amount percentage
- **Amount Discount** - Fixed amount reduction
### Discount Value (Required)
Input based on type:
- **Percentage**: Enter number 1-100 with % suffix
- **Amount**: Enter currency amount
### Specified Subscription (Optional)
Multi-select dropdown to choose applicable product plans:
- Leave blank for all products
- Select specific products for those only
### Start Time (Optional)
Coupon activation time:
- Use date picker
- Cannot select past dates (before yesterday)
- Leave blank for immediate effect
### Expire Time (Optional)
Coupon expiration time:
- Use date picker
- Leave blank for never expires
### Max Usage Count (Optional)
Total times the coupon can be used:
- 0 or blank for unlimited
- Automatically expires when count reached
### Max Usage Count per User (Optional)
Times a single user can use this coupon:
- 0 or blank for unlimited
- Prevents repeated use by single user
## Filter Functions
### Subscribe Filter
Select product plan to view exclusive coupons for that product.
### Keyword Search
Search coupons by name or code.
## Usage Scenarios
### Scenario 1: Create New User Registration Coupon
**Form Configuration**:
- Name: New User Discount
- Code: NEWUSER2024 (custom)
- Type: Percentage Discount
- Discount: 20%
- Specified Subscription: Leave blank (all products)
- Start Time: 2024-01-01
- Expire Time: 2024-12-31
- Max Usage Count: 0 (unlimited)
- Max Usage Count per User: 1
**Effect**: Each new user can use once, valid all year, 20% off all products.
### Scenario 2: Create Limited-Time Promotion Coupon
**Form Configuration**:
- Name: Double 11 Promotion
- Code: Leave blank (auto-generate)
- Type: Amount Discount
- Discount: $50
- Specified Subscription: Select "Annual Plan"
- Start Time: 2024-11-11 00:00
- Expire Time: 2024-11-11 23:59
- Max Usage Count: 100
- Max Usage Count per User: 1
**Effect**: First 100 users on Double 11 get $50 off annual plan, one per user.
### Scenario 3: Create Exclusive VIP Coupon
**Form Configuration**:
- Name: VIP Exclusive
- Code: VIP888 (custom)
- Type: Percentage Discount
- Discount: 30%
- Specified Subscription: Select "Premium Plan"
- Start Time: Leave blank
- Expire Time: Leave blank
- Max Usage Count: 0 (unlimited)
- Max Usage Count per User: 0 (unlimited)
**Effect**: VIP users can use unlimited times, 30% off premium plan.
### Scenario 4: Create One-Time Coupon Code
**Form Configuration**:
- Name: Thank You Gift
- Code: THANKS100 (custom)
- Type: Amount Discount
- Discount: $100
- Specified Subscription: Leave blank (all products)
- Start Time: Leave blank
- Expire Time: Leave blank
- Max Usage Count: 1
- Max Usage Count per User: 1
**Effect**: Single-use thank you coupon, first come first served.
## Important Notes
1. **Enable Control**: New coupons default to disabled, must manually enable for users
2. **Code Uniqueness**: Custom codes must be unique, duplicates will fail
3. **Auto-Generation**: Leave code blank for system to auto-generate random code
4. **Product Restriction**: Specified subscriptions apply only to selected products
5. **Time Range**: Start time cannot be in past, expire time can be blank
6. **Usage Count**: 0 or blank means unlimited
7. **User Limit**: Per-user limit prevents abuse
8. **Delete Impact**: Deleting coupons doesn't affect already-used orders
</div>
+354
View File
@@ -0,0 +1,354 @@
# Coupon Management
The Coupon Management module creates and manages various coupons, which is an important tool for promotional activities.
## Overview
### Coupon List
View and manage all coupons:
- **Coupon Name**: Display name
- **Coupon Type**: Spend threshold/Discount/Voucher
- **Discount Amount**: Reduction or discount percentage
- **Usage Conditions**: Minimum spend required
- **Distribution**: Total and remaining quantity
- **Validity**: Valid time range
- **Applicable Scope**: Applicable products or users
- **Status**: Active/Ended/Paused
### Create Coupon
Create new coupon:
#### Basic Info
- **Coupon Name**: Identifiable name
- **Description**: Detailed discount description
- **Coupon Code**: Redemption code (auto-generate)
- **Coupon Type**: Select discount type
#### Discount Settings
**Spend Threshold Coupon**
- Spend X get Y off
- Multi-tier thresholds
**Discount Coupon**
- Discount percentage (e.g., 20% off)
- Maximum discount cap
**Voucher**
- Direct fixed amount deduction
- Or redeem specific product
#### Usage Conditions
- **Minimum Spend**: Order threshold
- **Applicable Products**: Specified products
- **Applicable Users**: New/Existing/All
- **Usage Limit**: Times per person
- **Stacking Rules**: Combine with other offers
#### Distribution Settings
- **Distribution Method**:
- Public claim: Everyone can claim
- Targeted: Specific users
- Redemption code: Enter code to claim
- Auto-distribution: Auto-grant on conditions
- **Distribution Quantity**: Total limit
- **Claim Limit**: Per-person claim limit
#### Validity Settings
- **Fixed Time**: Specific start/end dates
- **Days After Claim**: Valid N days after claim
- **Permanent**: No expiration
### Edit Coupon
Modify coupon config:
- Adjust discount amount and conditions
- Increase distribution quantity
- Extend validity period
- Modify applicable scope
::: tip Tip
Config changes don't affect coupons already claimed by users.
:::
### Delete Coupon
Delete coupon:
- **Soft Delete**: Deactivate but keep data
- **Hard Delete**: Permanently delete
- Used coupon records are retained
## Coupon Types
### Spend Threshold
Discount after meeting amount:
**Use Cases**:
- Promote large orders
- Increase AOV
- Clearance sales
**Examples**:
- $10 off $100
- $30 off $200
- $100 off $500
### Discount
Percentage discount:
**Use Cases**:
- Holiday promotions
- Member exclusive
- New product launch
**Examples**:
- 10% off
- 20% off (max $50)
- 30% off (new users only)
### Voucher
Direct amount deduction:
**Use Cases**:
- User compensation
- Promotion rewards
- Points redemption
**Examples**:
- $10 no-threshold voucher
- $50 trial voucher
- $100 cash voucher
### Product Voucher
Redeem specific product:
**Use Cases**:
- Gift distribution
- Event rewards
- Points store
**Examples**:
- 1-month package voucher
- 100GB traffic voucher
## Coupon Distribution
### Batch Distribution
Distribute coupons to multiple users:
1. Select coupon to distribute
2. Select target user group
3. Set distribution quantity
4. Confirm distribution
**Target Recipients**:
- All users
- Specific user groups
- Newly registered
- High-value users
- At-risk churners
### Redemption Code
Generate coupon codes:
- **Batch Generate**: Generate multiple codes
- **Custom Prefix**: Set code prefix
- **Export Codes**: Export Excel file
- **Code Management**: View usage status
### Auto-Distribution
Configure auto-distribution rules:
**Trigger Conditions**:
- On user registration
- After first purchase
- Before subscription expiry
- On spending milestone
- On birthday
**Distribution Content**:
- Specific coupon
- Random coupon
- Tiered coupons
## Coupon Usage
### Usage Flow
User coupon usage process:
1. **Claim Coupon**: User claims or receives coupon
2. **View Coupons**: Check available coupons in account
3. **Order Usage**: Select coupon when placing order
4. **System Validation**: Verify usage conditions
5. **Calculate Discount**: Auto-calculate discount
6. **Complete Payment**: Pay discounted price
### Usage Restrictions
Control coupon usage:
- **Single Use**: Limit coupons per order
- **Time Restriction**: Specific time periods
- **Product Restriction**: Specific products
- **User Restriction**: Specific user groups
- **Device Restriction**: Limit devices
### Usage Rules
Coupon usage rule settings:
- **Priority**: Order of multiple coupons
- **Stacking**: Combine with other offers
- **Partial Refund**: Coupon handling on refund
- **Expiry Reminder**: Notify before expiration
## Coupon Statistics
### Distribution Stats
Track coupon distribution:
- **Total Distributed**: Distributed quantity
- **Claim Rate**: Claim rate and users
- **Stock Remaining**: Available quantity
- **Distribution Trend**: Daily distribution changes
### Usage Stats
Analyze coupon usage:
- **Usage Rate**: Used/Distributed ratio
- **Discount Amount**: Total discount given
- **Orders with Coupons**: Order count
- **Users with Coupons**: User count
### Effect Analysis
Evaluate coupon effectiveness:
- **Conversion Rate**: Purchase conversion after claim
- **AOV**: Average order value with coupons
- **ROI Analysis**: Return on investment
- **User Distribution**: User profile
## Coupon Promotion
### Promotion Channels
Promote coupons through channels:
- **On-site**: Homepage banner, popups
- **Email**: Send coupon emails
- **SMS**: SMS notifications
- **Social Media**: Share to social platforms
- **Referral Links**: Generate exclusive links
### Promotion Activities
Plan coupon campaigns:
- **Limited Flash**: Limited-time coupon grab
- **Share to Claim**: Get coupons after sharing
- **Check-in**: Daily check-in rewards
- **Referral Bonus**: Refer friends get coupons
- **Purchase Rebate**: Get coupons after purchase
## Coupon Templates
### Common Templates
Preset common coupon templates:
- New user exclusive
- Member birthday coupon
- Holiday promotion
- Spend threshold coupon
- Repurchase coupon
### Custom Templates
Create custom templates:
- Save common configs
- Quick create similar coupons
- Copy and edit templates
## Risk Control
### Anti-fraud
Prevent malicious coupon abuse:
- **Claim Limits**: IP, device restrictions
- **Identity Verification**: Require verification
- **Usage Monitoring**: Monitor abnormal usage
- **Blacklist**: Block fraudulent users
### Risk Alerts
Coupon risk warnings:
- Abnormal claiming alerts
- Low stock reminders
- Budget overrun warnings
- Fraud behavior alerts
## Best Practices
- Set reasonable thresholds to avoid losses
- Control total distribution and budget
- Regularly analyze coupon effectiveness
- Target different user groups
- Coordinate with marketing campaigns
- Clean up expired and invalid coupons
## Troubleshooting
### Cannot Use Coupon
Check:
1. Are usage conditions met
2. Is coupon expired
3. Is product in applicable scope
4. Is minimum spend reached
### Incorrect Discount
Possible reasons:
1. Coupon config error
2. Multiple coupon stacking issues
3. Threshold tier settings
### Distribution Failed
Check:
1. Is stock sufficient
2. Does user meet claim conditions
3. Is system configured correctly
## Next Steps
- [Marketing Management](/admin/commerce/marketing) - Create campaigns
- [Order Management](/admin/commerce/orders) - View coupon usage
- [User Management](/admin/users-support/users) - Distribute coupons
+354
View File
@@ -0,0 +1,354 @@
# Marketing Management
The Marketing Management module plans and executes various marketing campaigns to boost user growth and revenue.
## Overview
### Campaign List
View and manage all campaigns:
- **Campaign Name**: Marketing campaign title
- **Campaign Type**: Promotion/Acquisition/Retention/Conversion
- **Status**: Not started/Active/Ended
- **Duration**: Start and end time
- **Participants**: Number of participating users
- **Conversion**: Conversion rate and revenue
- **Budget**: Budget and actual spending
### Create Campaign
Plan new marketing campaign:
#### Campaign Info
- **Campaign Name**: Theme name
- **Campaign Type**: Select type
- **Description**: Detailed explanation
- **Tags**: For categorization
#### Campaign Duration
- **Start Time**: Campaign start datetime
- **End Time**: Campaign end datetime
- **Pre-launch**: Campaign teaser period
- **Cool-down**: Post-campaign handling period
#### Campaign Rules
- **Participation**: User eligibility
- **Rewards**: Reward content and rules
- **Restrictions**: Participation limits
- **Calculation**: Points, ranking calculations
#### Marketing Materials
- **Campaign Images**: Posters, banners
- **Campaign Copy**: Promotional content
- **Social Assets**: Social media shares
- **Landing Page**: Campaign page link
## Campaign Types
### Acquisition
Attract new user registration:
**Campaign Forms**:
- New user registration rewards
- First purchase discount
- Referral rewards
- New user exclusive packages
**KPIs**:
- New user registrations
- New user conversion rate
- Customer acquisition cost (CAC)
- New user quality
### Promotion
Stimulate purchases:
**Campaign Forms**:
- Limited-time discount
- Spend threshold discount
- Buy one get one
- Bundle offers
**KPIs**:
- Sales growth
- Order quantity
- AOV change
- ROI
### Retention
Improve user retention:
**Campaign Forms**:
- Daily check-in rewards
- Consecutive login bonuses
- Member day specials
- Renewal discounts
**KPIs**:
- User activity
- Retention rate improvement
- Churn rate reduction
- Lifetime value
### Conversion
Promote user payment:
**Campaign Forms**:
- Trial to paid discount
- Upgrade package discount
- First order discount
- Flash sale
**KPIs**:
- Payment conversion rate
- Upgrade conversion rate
- Average payment amount
- Paying user growth
## Promotion Channels
### On-site Promotion
Promote within system:
- **Homepage Banner**: Carousel display
- **Popup**: Login popup reminders
- **Push Notifications**: In-app messages
- **Campaign Zone**: Campaign hub page
### Email Promotion
Email marketing:
- **Marketing Emails**: Send campaign emails
- **Email Templates**: Beautiful templates
- **Segmented Sending**: Target user groups
- **Effectiveness Tracking**: Open, click rates
### SMS Promotion
SMS marketing:
- **SMS Notifications**: Send campaign SMS
- **SMS Templates**: Preset content
- **Scheduled Sending**: Set send time
- **Effect Statistics**: Delivery rate
### Social Media
Social platform promotion:
- **Social Sharing**: User shares
- **Community Operations**: WeChat, QQ groups
- **KOL Collaboration**: Influencer partnerships
- **Content Marketing**: Publish content
## User Segmentation
### User Profiling
Segment by characteristics:
- **Basic Attributes**: Age, region, gender
- **Behavioral**: Activity, usage frequency
- **Consumption**: Spending, purchase frequency
- **Lifecycle**: New, active, dormant, churned
### Precision Marketing
Target different segments:
- **New Users**: Welcome, onboarding
- **Active Users**: Payment conversion, upgrades
- **High-Value Users**: VIP privileges, exclusives
- **Dormant Users**: Reactivation, return rewards
- **Churn Risk**: Retention offers, exclusive service
## Campaign Execution
### Campaign Launch
Officially start:
1. **Final Confirmation**: Check configuration
2. **Resource Preparation**: Prepare coupons, prizes
3. **Channel Notification**: Start promotion
4. **Real-time Monitoring**: Monitor data
### Campaign Monitoring
Real-time progress tracking:
- **Participation Data**: Live participant count
- **Conversion Data**: Conversion rate, orders
- **Budget Consumption**: Spending tracking
- **Anomaly Alerts**: Warning notifications
### Campaign Adjustment
Optimize based on data:
- **Rule Adjustment**: Optimize rules
- **Budget Adjustment**: Increase/decrease budget
- **Channel Optimization**: Adjust channels
- **Material Updates**: Refresh assets
### Campaign End
Wrap-up work:
- **Stop Promotion**: Close channels
- **Data Settlement**: Statistics
- **Reward Distribution**: Distribute prizes
- **Effect Evaluation**: Assess results
## Data Analysis
### Participation Data
Analyze participation:
- **Participants**: Total user count
- **Participation Rate**: Target user ratio
- **Channel Mix**: Channel distribution
- **Time Distribution**: Participation timing
### Conversion Data
Analyze conversion:
- **Conversion Rate**: Participation to purchase
- **Orders**: Orders generated
- **Sales**: Revenue generated
- **AOV**: Average order value
### ROI Analysis
Calculate return on investment:
- **Total Input**: Total campaign cost
- **Total Output**: Total revenue
- **ROI**: Return on investment
- **Break-even**: Time to break-even
### User Analysis
Analyze participants:
- **User Mix**: New vs existing ratio
- **User Quality**: Retention, repurchase
- **User Value**: Lifetime value
- **User Feedback**: Satisfaction
## A/B Testing
### Test Design
Design A/B test:
- **Test Goal**: Clear objective
- **Test Variable**: Determine variable
- **Control Group**: Set control
- **Experiment Group**: Set experiment
### Test Execution
Execute A/B test:
- **Random Assignment**: Random user allocation
- **Simultaneous Start**: Start together
- **Data Collection**: Collect test data
- **Result Analysis**: Analyze results
### Apply Results
Apply findings:
- **Select Approach**: Choose best option
- **Full Rollout**: Promote to all users
- **Continuous Optimization**: Keep iterating
## Marketing Automation
### Automated Workflows
Set automated flows:
**Triggers**:
- User registration
- First login
- Subscription expiry
- Long inactive
- Purchase complete
**Auto Actions**:
- Send welcome email
- Push coupons
- Send reminders
- Recommend products
### Lifecycle Marketing
Lifecycle-based automation:
- **Acquisition**: Registration guide, first purchase
- **Growth**: Usage guide, upgrade recommendation
- **Maturity**: VIP service, renewal discount
- **Decline**: Reactivation, retention offers
- **Churn**: Return rewards, reactivation
## Best Practices
- Define clear goals and KPIs
- Understand target user needs
- Design attractive rules
- Choose right channels
- Monitor and adjust quickly
- Analyze data thoroughly
- Establish marketing SOPs
## Campaign Examples
### Double 11 Sale
**Goal**: Boost sales
**Content**:
- 50% off sitewide
- Spend threshold coupons
- Flash sales
- Share lottery
**Results**:
- 300% sales increase
- 200% new user growth
- ROI of 3.5
### Referral Campaign
**Goal**: User acquisition
**Content**:
- Invite friends get coupons
- First purchase rewards both
- Referral leaderboard
**Results**:
- 5000+ new users
- 40% lower CAC
- Viral coefficient 1.8
## Next Steps
- [Coupon Management](/admin/commerce/coupons) - Configure coupons
- [Announcement Management](/admin/commerce/announcements) - Publish announcements
- [User Management](/admin/users-support/users) - Analyze user data
+148
View File
@@ -0,0 +1,148 @@
<div v-pre>
# Order Management
View all user orders in the system with support for order status modification and detailed information viewing. This is primarily a read-only order query page, mainly used for order information viewing and exception handling.
## Page Functions
The Order Management page is a simple order query and status management tool, providing the following features:
1. **Order List Viewing** - Display all orders in a table
2. **Status Modification** - Modify orders with specific statuses
3. **Amount Details** - View price breakdown via hover card
4. **Filter & Search** - Quickly locate target orders
## Table Column Description
### Order Number
System-generated unique order identifier for order tracking and querying.
### Type
Business type of the order:
- **New Purchase** - User's first purchase of a plan
- **Renewal** - Extends time for existing subscription
- **Reset Traffic** - Separately purchase traffic reset
- **Recharge** - Recharge account balance
### Subscribe
Displays associated product information:
- New Purchase/Renewal/Reset Traffic orders: Shows `Product Name × Quantity`
- Recharge orders: Shows "Recharge"
### Amount
Total order amount, click to view detailed price breakdown.
### User
Order user information, click to view user details.
### Update Time
Last order status change time.
### Status
Current order status, some statuses support modification:
- **Pending** (Orange) - Modifiable
- **Paid** (Green) - Read-only
- **Cancelled** (Gray) - Modifiable
- **Closed** (Red) - Modifiable
- **Completed** (Green) - Read-only
## Core Functions
### 1. Order Status Modification
**Modifiable Status**: Pending, Cancelled, Closed
Steps:
1. Find the order to modify
2. Click the dropdown selector in status column
3. Select new status
4. System auto-saves and refreshes
**Non-modifiable Status**: Paid, Completed
These two statuses display as read-only badges and cannot be modified.
**Common Operations**:
- Pending → Paid: Manually mark payment complete
- Pending → Cancelled: Cancel timeout orders
- Pending → Closed: Close abnormal orders
- Cancelled → Pending: Restore misoperated orders
### 2. View Amount Details
Hover mouse over amount to display complete price breakdown:
**Price Composition**:
- Subscribe Price - Product original price
- Discount - Bulk purchase discount
- Coupon Discount - Coupon used
- Fee Amount - Payment platform fee
- Total - Actual payment amount
**Other Information**:
- Trade No - Third-party payment transaction number
- Payment Method - Payment platform used
### 3. Filter and Search
**Status Filter**: Select order status to view corresponding orders
**Product Filter**: Select product plan to view related orders
**User Filter**: Input user ID to view all orders for that user
**Keyword Search**: Input order number for exact search
Multiple filter conditions can be used simultaneously.
## Usage Scenarios
### Scenario 1: Manually Mark Payment Complete
User payment successful but order status not auto-updated:
1. Search for order using order number
2. Click amount to view trade number
3. Confirm payment received on third-party platform
4. Click status dropdown and select "Paid"
5. System auto-processes and allocates benefits
### Scenario 2: Cancel Timeout Orders
Regularly clean up timeout unpaid orders:
1. Filter "Pending" status
2. Check update time to determine timeout
3. Click status and select "Cancelled"
4. Order marked as cancelled
### Scenario 3: User Order Query
User inquires about order issue:
1. Input user ID in user filter
2. View all orders for that user
3. Find corresponding order and check status
4. Click amount to view detailed information
5. Handle issue based on situation
### Scenario 4: Product Sales Query
View sales for a specific product:
1. Select plan in product filter
2. View all orders for that product
3. Check order counts by different statuses
4. Analyze sales trends
## Important Notes
1. **Partial Status Modification** - Only Pending, Cancelled, Closed can be modified
2. **Paid Cannot Change** - Paid and Completed orders cannot be modified
3. **Modify Carefully** - Status changes trigger benefit updates
4. **Verify Payment** - Confirm actual payment before marking as Paid
5. **Price Details** - Verify price calculation via amount hover card
6. **User Issues** - Use user filter to quickly query user orders
</div>
+291
View File
@@ -0,0 +1,291 @@
# Order Management
The Order Management module processes user purchase orders, which is the core of system revenue and business processes.
## Overview
### Order List
View and manage all orders:
- **Order Number**: Unique order identifier
- **User Info**: Buyer name and email
- **Product Info**: Purchased product name and specs
- **Amount**: Paid amount and original price
- **Payment Method**: Alipay/WeChat/Crypto, etc.
- **Status**: Pending/Paid/Completed/Canceled/Refunded
- **Created**: Order creation time
- **Paid**: Payment completion time
### Order Filtering
Quickly find specific orders:
- **By Status**: Pending/Paid/Completed, etc.
- **By Date Range**: Today/This week/This month/Custom
- **By Payment**: Filter by payment channel
- **By User**: View specific user's orders
- **By Product**: View specific product sales
- **By Amount**: Filter by order amount range
### Create Order
Manually create order for user:
#### Select User
- Search existing user
- Or create new user
- Fill in user basic info
#### Select Product
- Choose package from product list
- Set purchase quantity
- View price details
#### Discount Settings
- Apply coupons
- Manual discount
- Balance deduction
- Points deduction
#### Order Notes
- Add order notes
- Mark special orders
- Record communications
### Order Details
View complete order information:
#### Basic Info
- Order number and creation time
- User info and contact
- Product details and specs
- Order amount breakdown
#### Payment Info
- Payment method and transaction number
- Payment time and status
- Third-party platform order number
- Payment proof (if any)
#### Order Status
- Current order status
- Status change history
- Operation log records
#### After-sales Info
- Refund request records
- Customer service communications
- Issue resolution progress
## Order Operations
### Order Review
Review pending orders:
- **Auto Review**: Online payment auto-complete
- **Manual Review**: Bank transfer needs confirmation
- **Approve**: Activate service and notify user
- **Reject**: Reject order with reason
### Order Processing
Process paid orders:
- **Auto Activation**: Auto-activate after payment
- **Manual Activation**: Admin manually activates
- **Delayed Activation**: Set future activation time
- **Batch Processing**: Process multiple orders
### Order Cancellation
Cancel unpaid or abnormal orders:
- **User Cancel**: User actively cancels
- **Timeout Cancel**: Not paid within time limit
- **Admin Cancel**: Admin manually cancels
- **System Cancel**: Auto-cancel on anomaly detection
### Order Refund
Process refund requests:
#### Refund Review
- Review refund reason
- Evaluate refund validity
- Decide whether to approve
#### Refund Processing
- **Full Refund**: Return full order amount
- **Partial Refund**: Return partial amount
- **Refund to Balance**: Refund to user account
- **Original Return**: Refund to original payment method
#### Post-refund
- Revoke activated services
- Update user account status
- Record refund reason and result
## Payment Management
### Payment Methods
Support multiple payment channels:
- **Alipay**: QR code/Face-to-face payment
- **WeChat Pay**: QR code/H5 payment
- **Cryptocurrency**: USDT/BTC, etc.
- **Bank Transfer**: Offline transfer
- **Balance Payment**: Use account balance
### Payment Config
Configure payment channel parameters:
- **Merchant Info**: Merchant ID/Key
- **Payment Callback**: Async notification URL
- **Payment Limits**: Min/Max payment amount
- **Transaction Fees**: Fee rate and bearer
### Payment Callback
Handle payment platform callbacks:
- **Verify Signature**: Verify callback data authenticity
- **Update Status**: Update order payment status
- **Activate Service**: Auto-activate purchased service
- **Send Notification**: Notify user of successful payment
## Order Statistics
### Sales Statistics
Analyze order sales data:
- **Order Count**: Total orders and growth trend
- **Order Amount**: Total sales and average order value
- **Conversion Rate**: Order conversion analysis
- **Repurchase Rate**: User repurchase situation
### Payment Statistics
Analyze payment method usage:
- **Payment Method Share**: Alipay/WeChat share
- **Payment Success Rate**: Success rate per channel
- **Payment Duration**: Time from order to payment
### Product Statistics
Analyze product sales:
- **Best Sellers**: Top-selling products
- **Revenue Contribution**: Revenue share per product
- **Stock Alert**: Low-stock products
## Order Export
Export order data for analysis:
### Export Options
- **Export Format**: Excel/CSV/PDF
- **Export Range**: All/Filtered results
- **Export Fields**: Custom export fields
- **Data Masking**: Mask sensitive information
### Export Purposes
- **Financial Reconciliation**: Verify revenue data
- **Data Analysis**: Conduct business analysis
- **Report Generation**: Generate sales reports
- **Backup Archive**: Data backup and archive
## Abnormal Order Handling
### Anomaly Types
- **Duplicate Payment**: Same order paid multiple times
- **Payment Not Received**: Paid but system didn't receive
- **Amount Mismatch**: Payment amount differs from order
- **Malicious Orders**: Fraud or fake orders
### Handling Process
1. **Identify Anomaly**: System auto-marks or manual detection
2. **Investigate**: Check payment records and logs
3. **Contact User**: Communicate to confirm situation
4. **Resolution**: Refund/Resend/Manual handling
5. **Record**: Document process and result
## Order Security
### Risk Control
- **Identity Verification**: Require user verification
- **Payment Limits**: Set per-transaction limits
- **Anomaly Detection**: Detect abnormal payment behavior
- **Blacklist**: Block malicious users
### Anti-fraud
- **Rate Limiting**: Limit order frequency
- **IP Detection**: Detect abnormal IP behavior
- **Device Fingerprint**: Identify duplicate devices
- **Manual Review**: Review suspicious orders
## Best Practices
- Process pending orders promptly
- Ensure payment callback stability
- Regularly reconcile financial data
- Respond quickly to refund requests
- Maintain complete operation logs
- Analyze order data to optimize operations
## Troubleshooting
### Payment Successful But Not Received
Steps:
1. Check payment platform order status
2. Review payment callback logs
3. Manually trigger callback processing
4. Contact payment platform support
### Cannot Cancel Order
Possible reasons:
1. Order already paid
2. Service already activated
3. Insufficient system permissions
### Refund Failed
Check:
1. Is refund API configured correctly
2. Is account balance sufficient
3. Is refund info complete
4. Has refund deadline passed
## Next Steps
- [Coupon Management](/admin/commerce/coupons) - Create promotions
- [User Management](/admin/users-support/users) - Manage user accounts
- [Financial Statistics](/admin/logs/balance) - View transaction details
+203
View File
@@ -0,0 +1,203 @@
<div v-pre>
# Product Management
Manage subscription plan products in the system, including pricing, traffic quotas, and node permissions. Products are the basic units that users purchase.
## Table Column Description
### Show
Switch button to control whether the product displays on the frontend. When off, users cannot see this product.
### Sell
Switch button to control whether the product is available for purchase. Can display without selling (announcement mode).
### Name
Product plan name.
### Unit Price
Displays price and billing cycle, format like `$10/Month`.
### Replacement
Promotional price or one-time purchase price.
### Traffic
Traffic quota per cycle, 0 displays as "Unlimited".
### Device Limit
Simultaneous device connection limit, 0 displays as "Unlimited".
### Inventory
Remaining quantity available for sale, 0 displays as "Unlimited".
### Quota
Total sales limit, 0 displays as "Unlimited".
### Language
Language restriction for the product, used for multilingual sites.
### Sold
Quantity sold statistics.
## Table Operations
### Edit
Opens side drawer form to modify product information.
### Delete
Deletes product (requires confirmation), products with existing subscriptions may not be deletable.
### Copy
Quickly duplicates product to create new plan, automatically set to not showing and not selling.
### Batch Delete
Deletes multiple selected products.
### Drag & Drop Sort
Drag product rows to adjust display order, affects frontend display order.
## Product Form
Form contains three tabs:
### Basic Tab
**Name and Language**:
- **Name** (Required) - Product plan name
- **Language** (Optional) - Language restriction, e.g. `zh-CN` or `en`
**Traffic and Limits**:
- **Traffic** - Traffic quota per cycle (GB), 0 = unlimited
- **Speed Limit** - Bandwidth limit (Mbps), 0 = no limit
- **Device Limit** - Simultaneous online devices, 0 = unlimited
**Inventory and Quota**:
- **Inventory** - Remaining quantity for sale, 0 = unlimited
- **Quota** - Total sales limit, 0 = unlimited
**Product Description** (JSON Editor):
```json
{
"description": "Product description text",
"features": [
{
"type": "default",
"icon": "uil:shield-check",
"label": "Feature description"
}
]
}
```
### Pricing Tab
**Basic Pricing**:
- **Unit Price** (Required) - Base price
- **Billing Cycle** (Required) - Options:
- NoLimit (No time limit)
- Year
- Month
- Day
- Hour
- Minute
- **Replacement** - Promotional price
- **Reset Cycle** - Traffic reset method:
- No reset
- Reset on 1st of month
- Monthly reset
- Annual reset
**Bulk Discounts**:
Dynamic array supporting multiple discount tiers:
- **Quantity** - Number of billing cycles
- **Discount** - Discount percentage (1-100%)
- **Price** - Discounted price
Auto-calculation: Modify any two values, the third auto-calculates.
**Deduction Settings**:
- **Deduction Ratio** - Node traffic multiplier (0-100%), leave blank for auto
- **Renewal Reset** - Switch, whether to reset traffic on renewal
- **Purchase with Discount** - Switch, whether to allow coupon usage
### Servers Tab
**Node Tag Selection**:
Accordion-style list showing all tags and their nodes:
- Check tags to automatically include all nodes under that tag
- Shows node count
- Expand to view node details (name, address, protocol)
**Individual Node Selection**:
Select nodes without tags:
- Check nodes individually
- Shows node name, address:port, protocol
## Usage Scenarios
### Scenario 1: Create Basic Monthly Plan
**Basic Tab**:
- Name: Standard Monthly
- Traffic: 100 GB
- Speed Limit: 0 (no limit)
- Device Limit: 3
- Inventory: 0 (unlimited)
**Pricing Tab**:
- Unit Price: 30
- Billing Cycle: Month
- Reset Cycle: Monthly reset
- Bulk Discounts:
- 3 months, 10% discount, $81
- 6 months, 15% discount, $153
- 12 months, 20% discount, $288
**Servers Tab**:
- Check "Basic Nodes" tag
### Scenario 2: Create Traffic Package
**Basic Tab**:
- Name: 500GB Traffic Pack
- Traffic: 500 GB
- Device Limit: 0 (unlimited)
**Pricing Tab**:
- Unit Price: 50
- Billing Cycle: NoLimit
- Reset Cycle: No reset
- Renewal Reset: Off
**Servers Tab**:
- Check all high-speed node tags
### Scenario 3: Create Premium Annual Plan
**Basic Tab**:
- Name: Premium Annual
- Traffic: 0 (unlimited)
- Speed Limit: 200 Mbps
- Device Limit: 10
**Pricing Tab**:
- Unit Price: 300
- Billing Cycle: Year
- Reset Cycle: Monthly reset
- Renewal Reset: On
**Servers Tab**:
- Check all node tags
## Important Notes
1. **Display Control**: New products default to not showing and not selling, must manually enable
2. **Node Configuration**: Must configure nodes, otherwise users cannot use
3. **Bulk Discounts**: After modifying unit price or cycle, discount prices auto-recalculate
4. **Inventory Quota**: 0 means unlimited, non-zero limits sales quantity
5. **Language Restriction**: Leave blank for all languages
6. **Drag Sort**: Sorting saves immediately and affects frontend display
7. **Copy Function**: Copied products don't auto-publish
8. **Sold Products**: Modifying sold product configurations affects existing subscriptions
</div>