📝 docs: Add documentation

docs/admin/logs/gift.md

@@ -0,0 +1,129 @@
+<div v-pre>
+
+# Gift Log
+
+View traffic, duration, balance gift records including gift sources and remarks.
+
+## Table Column Description
+
+### User
+User receiving gift (clickable for details).
+
+### Subscribe
+Associated subscription ID (clickable for subscription details).
+
+### Order No.
+Associated order number (clickable for order details).
+
+### Amount
+Gift amount (shown for balance gifts).
+
+### Balance
+User balance after gift.
+
+### Type
+Gift type (displayed as Badge):
+- Traffic gift
+- Duration gift
+- Balance gift
+- Activity gift
+- Admin gift
+
+### Remark
+Gift remark description.
+
+### Time
+Gift time.
+
+## Filter Functions
+
+### Date Filter
+Select date to view gift records, defaults to today.
+
+### User ID Filter
+Input user ID to view that user's gift records.
+
+## Usage Scenarios
+
+### Scenario 1: View Today's Gifts
+
+1. Shows today's gift records by default
+2. Calculate gift quantity
+3. Analyze gift costs
+
+### Scenario 2: Track User Gifts
+
+**View User Received**:
+1. Filter by user ID
+2. View all gift records
+3. Verify gifts credited
+4. Check gift sources
+
+### Scenario 3: Verify Activity Gifts
+
+**Verify Activity Distribution**:
+1. Filter by activity time
+2. View gift records
+3. Check distribution quantity
+4. Verify remark information
+
+### Scenario 4: Admin Gift Records
+
+**View Manual Gifts**:
+1. Filter "Admin Gift" type
+2. View gift records
+3. Verify operation correctness
+4. Check remark reasons
+
+## Gift Type Description
+
+### Traffic Gift
+- Gift traffic package
+- Increase subscription traffic
+- Shown in subscription details
+
+### Duration Gift
+- Extend subscription time
+- Add valid days
+- Shown in subscription details
+
+### Balance Gift
+- Gift account balance
+- Can be used to buy plans
+- Shows amount and balance
+
+### Activity Gift
+- Marketing activity rewards
+- Batch distribution
+- With activity remarks
+
+### Admin Gift
+- Manual gift operation
+- Requires reason remark
+- For compensation or rewards
+
+## Cost Analysis
+
+### Gift Statistics
+Daily/monthly stats:
+1. Total traffic gifted
+2. Total days gifted
+3. Total balance gifted
+4. Statistics by type
+
+### Effect Evaluation
+- User retention after gifts
+- User payment after gifts
+- ROI analysis
+
+## Important Notes
+
+1. **Log Retention**: Retention per system config
+2. **Subscription Association**: Traffic and duration gifts linked to subscriptions
+3. **Balance Records**: Balance gifts record amount changes
+4. **Remark Important**: Manual gifts must have remarks
+5. **Type Recognition**: Distinguish gift sources by type
+6. **Cost Statistics**: Regularly analyze gift costs
+7. **Prevent Abuse**: Watch for abnormally large gifts
+
+</div>