fix(mining-admin): 修正Excel列索引

Excel实际格式是：
- 索引0: 序号
- 索引1: 注册ID
- 索引2: 认种量（棵）
- 索引3: 挖矿开始时间
- 索引4: 批次
- 索引5: 授权提前挖的天数
- 索引6: 备注

之前代码从索引0读取用户ID是错误的，现在修正为从索引1开始读取。

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.claude/settings.local.json

@@ -767,7 +767,37 @@
       "Bash(git -C \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\" commit -m \"$\\(cat <<''EOF''\nfix\\(mining-app\\): update splash page theme and fix token refresh\n\n- Update splash_page.dart to orange theme \\(#FF6B00\\) matching other pages\n- Change app name from \"榴莲挖矿\" to \"榴莲生态\"\n- Fix refreshTokenIfNeeded to properly throw on failure instead of\n  silently calling logout \\(which caused Riverpod ref errors\\)\n- Clear local storage directly on refresh failure without remote API call\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
       "Bash(python3 -c \" import sys content = sys.stdin.read\\(\\) old = '''''' done # 清空 processed_cdc_events 表（因为 migration 时可能已经消费了一些消息） # 这是事务性幂等消费的关键：重置 Kafka offset 后必须同时清空幂等记录 log_info \"\"Truncating processed_cdc_events tables to allow re-consumption...\"\" for db in \"\"rwa_contribution\"\" \"\"rwa_auth\"\"; do if run_psql \"\"$db\"\" \"\"TRUNCATE TABLE processed_cdc_events;\"\" 2>/dev/null; then log_success \"\"Truncated processed_cdc_events in $db\"\" else log_warn \"\"Could not truncate processed_cdc_events in $db \\(table may not exist yet\\)\"\" fi done log_step \"\"Step 9/18: Starting 2.0 services...\"\"'''''' new = '''''' done # 清空 processed_cdc_events 表（因为 migration 时可能已经消费了一些消息） # 这是事务性幂等消费的关键：重置 Kafka offset 后必须同时清空幂等记录 log_info \"\"Truncating processed_cdc_events tables to allow re-consumption...\"\" for db in \"\"rwa_contribution\"\" \"\"rwa_auth\"\"; do if run_psql \"\"$db\"\" \"\"TRUNCATE TABLE processed_cdc_events;\"\" 2>/dev/null; then log_success \"\"Truncated processed_cdc_events in $db\"\" else log_warn \"\"Could not truncate processed_cdc_events in $db \\(table may not exist yet\\)\"\" fi done log_step \"\"Step 9/18: Starting 2.0 services...\"\"'''''' print\\(content.replace\\(old, new\\)\\) \")",
       "Bash(git rm:*)",
-      "Bash(echo \"请在服务器运行以下命令检查 outbox 事件：\n\ndocker exec -it rwa-postgres psql -U rwa_user -d rwa_contribution -c \"\"\nSELECT id, event_type, aggregate_id, \n       payload->>''sourceType'' as source_type,\n       payload->>''accountSequence'' as account_seq,\n       payload->>''sourceAccountSequence'' as source_account_seq,\n       payload->>''bonusTier'' as bonus_tier\nFROM outbox_events \nWHERE payload->>''accountSequence'' = ''D25122900007''\nORDER BY id;\n\"\"\")"
+      "Bash(echo \"请在服务器运行以下命令检查 outbox 事件：\n\ndocker exec -it rwa-postgres psql -U rwa_user -d rwa_contribution -c \"\"\nSELECT id, event_type, aggregate_id, \n       payload->>''sourceType'' as source_type,\n       payload->>''accountSequence'' as account_seq,\n       payload->>''sourceAccountSequence'' as source_account_seq,\n       payload->>''bonusTier'' as bonus_tier\nFROM outbox_events \nWHERE payload->>''accountSequence'' = ''D25122900007''\nORDER BY id;\n\"\"\")",
+      "Bash(ssh -o ConnectTimeout=10 ceshi@14.215.128.96 'find /home/ceshi/rwadurian/frontend/mining-admin-web -name \"\"*.tsx\"\" -o -name \"\"*.ts\"\" | xargs grep -l \"\"用户管理\\\\|users\"\" 2>/dev/null | head -10')",
+      "Bash(dir /s /b \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\")",
+      "Bash(dir /b \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\backend\\\\services\")",
+      "Bash(ssh -J ceshi@103.39.231.231 ceshi@192.168.1.111 \"curl -s http://localhost:3021/api/v2/admin/status\")",
+      "Bash(del \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\frontend\\\\mining-app\\\\lib\\\\domain\\\\usecases\\\\trading\\\\buy_shares.dart\")",
+      "Bash(del \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\frontend\\\\mining-app\\\\lib\\\\domain\\\\usecases\\\\trading\\\\sell_shares.dart\")",
+      "Bash(ls -la \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\frontend\\\\mining-app\\\\lib\\\\presentation\\\\pages\"\" 2>/dev/null || dir /b \"c:UsersdongDesktoprwadurianfrontendmining-applibpresentationpages \")",
+      "Bash(cd:*)",
+      "Bash(ssh -o StrictHostKeyChecking=no -J ceshi@103.39.231.231 ceshi@192.168.1.111 \"curl -s http://localhost:3020/api/v1/ | head -100\")",
+      "Bash(ssh -o StrictHostKeyChecking=no -J ceshi@103.39.231.231 ceshi@192.168.1.111:*)",
+      "Bash(bc:*)",
+      "Bash(DATABASE_URL=\"postgresql://postgres:password@localhost:5432/mining_db?schema=public\" npx prisma migrate diff:*)",
+      "Bash(git status:*)",
+      "Bash(xargs cat:*)",
+      "Bash(ssh -o ProxyJump=ceshi@103.39.231.231 ceshi@192.168.1.111 \"docker ps | grep mining\")",
+      "Bash(dir /b \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\backend\\\\services\\\\trading-service\\\\src\\\\application\\\\services\")",
+      "Bash(DATABASE_URL=\"postgresql://postgres:password@localhost:5432/trading_db?schema=public\" npx prisma migrate dev:*)",
+      "Bash(dir /b \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\backend\\\\services\\\\mining-admin-service\\\\src\")",
+      "Bash(ssh -o ProxyJump=ceshi@103.39.231.231 ceshi@192.168.1.111 \"cd /home/ceshi/rwadurian/backend/service && ls -la\")",
+      "Bash(ssh -o ProxyJump=ceshi@103.39.231.231 ceshi@192.168.1.111 \"ls -la /home/ceshi/rwadurian/backend/\")",
+      "Bash(ssh -o ProxyJump=ceshi@103.39.231.231 ceshi@192.168.1.111 \"ls -la /home/ceshi/rwadurian/backend/services/\")",
+      "Bash(where:*)",
+      "Bash(npx md-to-pdf:*)",
+      "Bash(ssh -J ceshi@103.39.231.231 ceshi@192.168.1.111 \"curl -s ''http://localhost:3000/api/price/klines?period=1h&limit=5'' | head -500\")",
+      "Bash(dir /b /ad \"c:\\\\Users\\\\dong\\\\Desktop\\\\rwadurian\\\\backend\")",
+      "Bash(timeout 30 cat:*)",
+      "Bash(npm run lint)",
+      "Bash(ssh -o ProxyCommand=\"ssh -W %h:%p ceshi@103.39.231.231\" -o StrictHostKeyChecking=no ceshi@192.168.1.111 \"cat /home/ceshi/rwadurian/backend/services/mining-service/src/application/services/batch-mining.service.ts | head -250\")",
+      "Bash(ssh -o ProxyCommand=\"ssh -W %h:%p ceshi@103.39.231.231\" -o StrictHostKeyChecking=no ceshi@192.168.1.111 \"docker logs rwa-mining-admin-service --tail 50 2>&1 | grep ''第一条数据\\\\|最后一条数据''\")",
+      "Bash(npx xlsx-cli 挖矿.xlsx)"
     ],
     "deny": [],
     "ask": []

backend/api-gateway/kong.yml

@@ -309,24 +309,42 @@ services:
 
   # ---------------------------------------------------------------------------
   # Trading Service 2.0 - 交易服务
+  # 前端路径: /api/v2/trading/... -> 后端路径: /api/v2/...
   # ---------------------------------------------------------------------------
   - name: trading-service-v2
-    url: http://192.168.1.111:3022
+    url: http://192.168.1.111:3022/api/v2
     routes:
       - name: trading-v2-api
         paths:
           - /api/v2/trading
-        strip_path: false
+        strip_path: true
       - name: trading-v2-health
         paths:
           - /api/v2/trading/health
-        strip_path: false
+        strip_path: true
+
+  # ---------------------------------------------------------------------------
+  # Trading Service WebSocket - 价格实时推送
+  # WebSocket 连接: wss://api.xxx.com/ws/price -> ws://192.168.1.111:3022/price
+  # Kong 会自动处理 HTTP -> WebSocket 升级，所以 protocols 只需要 http/https
+  # ---------------------------------------------------------------------------
+  - name: trading-ws-service
+    url: http://192.168.1.111:3022
+    routes:
+      - name: trading-ws-price
+        paths:
+          - /ws/price
+        strip_path: true
+        protocols:
+          - http
+          - https
 
   # ---------------------------------------------------------------------------
   # Mining Admin Service 2.0 - 挖矿管理后台服务
+  # 前端路径: /api/v2/mining-admin/... -> 后端路径: /api/v2/...
   # ---------------------------------------------------------------------------
   - name: mining-admin-service
-    url: http://192.168.1.111:3023/api/v1
+    url: http://192.168.1.111:3023/api/v2
     routes:
       - name: mining-admin-api
         paths:
@@ -356,18 +374,19 @@ services:
 
   # ---------------------------------------------------------------------------
   # Mining Wallet Service 2.0 - 挖矿钱包服务
+  # 前端路径: /api/v2/mining-wallet/... -> 后端路径: /api/v2/...
   # ---------------------------------------------------------------------------
   - name: mining-wallet-service
-    url: http://192.168.1.111:3025
+    url: http://192.168.1.111:3025/api/v2
     routes:
       - name: mining-wallet-api
         paths:
           - /api/v2/mining-wallet
-        strip_path: false
+        strip_path: true
       - name: mining-wallet-health
         paths:
           - /api/v2/mining-wallet/health
-        strip_path: false
+        strip_path: true
 
 # =============================================================================
 # Plugins - 全局插件配置

backend/mpc-system/services/service-party-android/app/build.gradle.kts

@@ -39,8 +39,9 @@ android {
         }
 
         // NDK configuration for TSS native library
+        // Only include ARM ABIs for real devices (x86_64 is for emulators only)
         ndk {
-            abiFilters += listOf("arm64-v8a", "armeabi-v7a", "x86_64")
+            abiFilters += listOf("arm64-v8a", "armeabi-v7a")
         }
     }
 

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/data/local/Database.kt

@@ -29,6 +29,9 @@ data class ShareRecordEntity(
     @ColumnInfo(name = "party_index")
     val partyIndex: Int,
 
+    @ColumnInfo(name = "party_id")
+    val partyId: String,  // The original partyId used during keygen - required for signing
+
     @ColumnInfo(name = "address")
     val address: String,
 
@@ -90,15 +93,159 @@ interface AppSettingDao {
     suspend fun setValue(setting: AppSettingEntity)
 }
 
+/**
+ * 转账记录数据库实体
+ * Entity for storing transaction history records
+ */
+@Entity(
+    tableName = "transaction_records",
+    foreignKeys = [
+        ForeignKey(
+            entity = ShareRecordEntity::class,
+            parentColumns = ["id"],
+            childColumns = ["share_id"],
+            onDelete = ForeignKey.CASCADE  // 删除钱包时自动删除关联的转账记录
+        )
+    ],
+    indices = [
+        Index(value = ["share_id"]),
+        Index(value = ["tx_hash"], unique = true),
+        Index(value = ["from_address"]),
+        Index(value = ["to_address"]),
+        Index(value = ["created_at"])
+    ]
+)
+data class TransactionRecordEntity(
+    @PrimaryKey(autoGenerate = true)
+    val id: Long = 0,
+
+    @ColumnInfo(name = "share_id")
+    val shareId: Long,               // 关联的钱包ID
+
+    @ColumnInfo(name = "from_address")
+    val fromAddress: String,         // 发送方地址
+
+    @ColumnInfo(name = "to_address")
+    val toAddress: String,           // 接收方地址
+
+    @ColumnInfo(name = "amount")
+    val amount: String,              // 转账金额（人类可读格式）
+
+    @ColumnInfo(name = "token_type")
+    val tokenType: String,           // 代币类型：KAVA, GREEN_POINTS, ENERGY_POINTS, FUTURE_POINTS
+
+    @ColumnInfo(name = "tx_hash")
+    val txHash: String,              // 交易哈希
+
+    @ColumnInfo(name = "gas_price")
+    val gasPrice: String,            // Gas 价格（Wei）
+
+    @ColumnInfo(name = "gas_used")
+    val gasUsed: String = "",        // 实际消耗的 Gas
+
+    @ColumnInfo(name = "tx_fee")
+    val txFee: String = "",          // 交易手续费
+
+    @ColumnInfo(name = "status")
+    val status: String,              // 交易状态：PENDING, CONFIRMED, FAILED
+
+    @ColumnInfo(name = "direction")
+    val direction: String,           // 交易方向：SENT, RECEIVED
+
+    @ColumnInfo(name = "note")
+    val note: String = "",           // 备注
+
+    @ColumnInfo(name = "created_at")
+    val createdAt: Long = System.currentTimeMillis(),
+
+    @ColumnInfo(name = "confirmed_at")
+    val confirmedAt: Long? = null,   // 确认时间
+
+    @ColumnInfo(name = "block_number")
+    val blockNumber: Long? = null    // 区块高度
+)
+
+/**
+ * 转账记录 DAO
+ * Data Access Object for transaction records
+ */
+@Dao
+interface TransactionRecordDao {
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    suspend fun insertRecord(record: TransactionRecordEntity): Long
+
+    @Query("SELECT * FROM transaction_records WHERE id = :id")
+    suspend fun getRecordById(id: Long): TransactionRecordEntity?
+
+    @Query("SELECT * FROM transaction_records WHERE tx_hash = :txHash")
+    suspend fun getRecordByTxHash(txHash: String): TransactionRecordEntity?
+
+    @Query("SELECT * FROM transaction_records WHERE share_id = :shareId ORDER BY created_at DESC")
+    fun getRecordsForShare(shareId: Long): Flow<List<TransactionRecordEntity>>
+
+    @Query("SELECT * FROM transaction_records WHERE share_id = :shareId ORDER BY created_at DESC LIMIT :limit OFFSET :offset")
+    suspend fun getRecordsForSharePaged(shareId: Long, limit: Int, offset: Int): List<TransactionRecordEntity>
+
+    @Query("SELECT * FROM transaction_records WHERE share_id = :shareId AND token_type = :tokenType ORDER BY created_at DESC")
+    fun getRecordsForShareByToken(shareId: Long, tokenType: String): Flow<List<TransactionRecordEntity>>
+
+    @Query("SELECT * FROM transaction_records WHERE status = 'PENDING' ORDER BY created_at ASC")
+    suspend fun getPendingRecords(): List<TransactionRecordEntity>
+
+    @Query("UPDATE transaction_records SET status = :status, confirmed_at = :confirmedAt, block_number = :blockNumber, gas_used = :gasUsed, tx_fee = :txFee WHERE id = :id")
+    suspend fun updateStatus(id: Long, status: String, confirmedAt: Long?, blockNumber: Long?, gasUsed: String, txFee: String)
+
+    @Query("""
+        SELECT
+            COUNT(*) as total_count,
+            SUM(CASE WHEN direction = 'SENT' THEN 1 ELSE 0 END) as sent_count,
+            SUM(CASE WHEN direction = 'RECEIVED' THEN 1 ELSE 0 END) as received_count
+        FROM transaction_records
+        WHERE share_id = :shareId AND token_type = :tokenType
+    """)
+    suspend fun getTransactionStats(shareId: Long, tokenType: String): TransactionStats
+
+    @Query("SELECT COALESCE(SUM(CAST(amount AS REAL)), 0) FROM transaction_records WHERE share_id = :shareId AND token_type = :tokenType AND direction = 'SENT' AND status = 'CONFIRMED'")
+    suspend fun getTotalSentAmount(shareId: Long, tokenType: String): Double
+
+    @Query("SELECT COALESCE(SUM(CAST(amount AS REAL)), 0) FROM transaction_records WHERE share_id = :shareId AND token_type = :tokenType AND direction = 'RECEIVED' AND status = 'CONFIRMED'")
+    suspend fun getTotalReceivedAmount(shareId: Long, tokenType: String): Double
+
+    @Query("SELECT COALESCE(SUM(CAST(tx_fee AS REAL)), 0) FROM transaction_records WHERE share_id = :shareId AND direction = 'SENT' AND status = 'CONFIRMED'")
+    suspend fun getTotalTxFee(shareId: Long): Double
+
+    @Query("DELETE FROM transaction_records WHERE id = :id")
+    suspend fun deleteRecordById(id: Long)
+
+    @Query("DELETE FROM transaction_records WHERE share_id = :shareId")
+    suspend fun deleteRecordsForShare(shareId: Long)
+
+    @Query("SELECT COUNT(*) FROM transaction_records WHERE share_id = :shareId")
+    suspend fun getRecordCount(shareId: Long): Int
+}
+
+/**
+ * 转账统计数据类
+ */
+data class TransactionStats(
+    @ColumnInfo(name = "total_count")
+    val totalCount: Int,
+    @ColumnInfo(name = "sent_count")
+    val sentCount: Int,
+    @ColumnInfo(name = "received_count")
+    val receivedCount: Int
+)
+
 /**
  * Room database
  */
 @Database(
-    entities = [ShareRecordEntity::class, AppSettingEntity::class],
+    entities = [ShareRecordEntity::class, AppSettingEntity::class, TransactionRecordEntity::class],
-    version = 2,
+    version = 4,  // Version 4: added transaction_records table for transfer history
     exportSchema = false
 )
 abstract class TssDatabase : RoomDatabase() {
     abstract fun shareRecordDao(): ShareRecordDao
     abstract fun appSettingDao(): AppSettingDao
+    abstract fun transactionRecordDao(): TransactionRecordDao
 }

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/data/repository/TssRepository.kt

@@ -5,6 +5,8 @@ import com.durian.tssparty.data.local.AppSettingDao
 import com.durian.tssparty.data.local.AppSettingEntity
 import com.durian.tssparty.data.local.ShareRecordDao
 import com.durian.tssparty.data.local.ShareRecordEntity
+import com.durian.tssparty.data.local.TransactionRecordDao
+import com.durian.tssparty.data.local.TransactionRecordEntity
 import com.durian.tssparty.data.local.TssNativeBridge
 import com.durian.tssparty.data.remote.GrpcClient
 import com.durian.tssparty.data.remote.GrpcConnectionEvent
@@ -31,7 +33,8 @@ class TssRepository @Inject constructor(
     private val grpcClient: GrpcClient,
     private val tssNativeBridge: TssNativeBridge,
     private val shareRecordDao: ShareRecordDao,
-    private val appSettingDao: AppSettingDao
+    private val appSettingDao: AppSettingDao,
+    private val transactionRecordDao: TransactionRecordDao
 ) {
     private val _currentSession = MutableStateFlow<TssSession?>(null)
     val currentSession: StateFlow<TssSession?> = _currentSession.asStateFlow()
@@ -48,6 +51,12 @@ class TssRepository @Inject constructor(
     // partyId is loaded once from database in registerParty() and cached here
     // This matches Electron's getOrCreatePartyId() pattern
     private lateinit var partyId: String
+
+    // currentSigningPartyId: The partyId to use for the current signing session
+    // This may differ from partyId when signing with a restored wallet backup
+    // CRITICAL: For backup/restore to work, signing must use the original partyId from keygen
+    private var currentSigningPartyId: String? = null
+
     private var messageCollectionJob: Job? = null
     private var sessionEventJob: Job? = null
 
@@ -1051,6 +1060,7 @@ class TssRepository @Inject constructor(
             val address = AddressUtils.deriveEvmAddress(publicKeyBytes)
 
             // Save share record (use actual thresholds and party index from backend)
+            // CRITICAL: Save partyId - this is required for signing after backup/restore
             val shareEntity = ShareRecordEntity(
                 sessionId = sessionId,
                 publicKey = result.publicKey,
@@ -1058,6 +1068,7 @@ class TssRepository @Inject constructor(
                 thresholdT = actualThresholdT,
                 thresholdN = actualThresholdN,
                 partyIndex = actualPartyIndex,
+                partyId = partyId,
                 address = address
             )
             val id = shareRecordDao.insertShare(shareEntity)
@@ -1115,14 +1126,26 @@ class TssRepository @Inject constructor(
 
                 // Note: Password is verified during actual sign execution, same as Electron
 
+                // CRITICAL: Use the original partyId from the share (keygen time) for signing
+                // This is essential for backup/restore - the partyId must match what was used during keygen
+                // If shareEntity.partyId is empty (legacy data), fall back to current device's partyId
+                val signingPartyId = if (shareEntity.partyId.isNotEmpty()) {
+                    shareEntity.partyId
+                } else {
+                    android.util.Log.w("TssRepository", "Share has no partyId (legacy data), using current device partyId")
+                    partyId
+                }
+                currentSigningPartyId = signingPartyId  // Save for later use in this flow
+                android.util.Log.d("TssRepository", "Using signingPartyId=$signingPartyId (current device partyId=$partyId)")
+
                 // CRITICAL: Set pendingSessionId BEFORE joinSession to avoid race condition
                 // This ensures session_started events can be matched even if they arrive
                 // before _currentSession is set
                 pendingSessionId = sessionId
                 android.util.Log.d("TssRepository", "Set pendingSessionId=$sessionId for event matching (sign joiner)")
 
-                // Join session via gRPC (matching Electron's grpcClient.joinSession)
+                // Join session via gRPC using the original partyId from keygen (CRITICAL for backup/restore)
-                val joinResult = grpcClient.joinSession(sessionId, partyId, joinToken)
+                val joinResult = grpcClient.joinSession(sessionId, signingPartyId, joinToken)
                 if (joinResult.isFailure) {
                     android.util.Log.e("TssRepository", "gRPC sign join failed", joinResult.exceptionOrNull())
                     return@withContext Result.failure(joinResult.exceptionOrNull()!!)
@@ -1137,12 +1160,13 @@ class TssRepository @Inject constructor(
 
                 // Build participants list (matching Electron's logic)
                 // Prefer using parties from validateInviteCode (complete list)
+                // CRITICAL: Use signingPartyId (original partyId from keygen) for participant identification
                 val participants = if (parties.isNotEmpty()) {
                     parties.toMutableList()
                 } else {
                     // Fallback: use other_parties + self
                     val list = sessionData.participants.toMutableList()
-                    list.add(Participant(partyId, myPartyIndex, "我"))
+                    list.add(Participant(signingPartyId, myPartyIndex, "我"))
                     list.sortBy { it.partyIndex }
                     list
                 }
@@ -1222,10 +1246,14 @@ class TssRepository @Inject constructor(
             } else {
                 messageHash
             }
-            android.util.Log.d("TssRepository", "Starting TSS sign with cleanMessageHash=${cleanMessageHash.take(20)}...")
+            // CRITICAL: Use shareEntity.partyId (original partyId from keygen) for signing
+            // This is required for backup/restore to work - the partyId must match what was used during keygen
+            val signingPartyId = shareEntity.partyId
+            currentSigningPartyId = signingPartyId  // Save for later use in this flow
+            android.util.Log.d("TssRepository", "Starting TSS sign with cleanMessageHash=${cleanMessageHash.take(20)}..., signingPartyId=$signingPartyId")
             val startResult = tssNativeBridge.startSign(
                 sessionId = sessionId,
-                partyId = partyId,
+                partyId = signingPartyId,
                 partyIndex = partyIndex,
                 thresholdT = thresholdT,
                 thresholdN = shareEntity.thresholdN,  // Use original N from keygen
@@ -1243,8 +1271,8 @@ class TssRepository @Inject constructor(
             // Start collecting progress from native bridge
             startProgressCollection()
 
-            // Mark ready
+            // Mark ready - use signingPartyId (original partyId from keygen)
-            grpcClient.markPartyReady(sessionId, partyId)
+            grpcClient.markPartyReady(sessionId, signingPartyId)
 
             // Wait for sign result
             val signResult = tssNativeBridge.waitForSignResult()
@@ -1256,14 +1284,15 @@ class TssRepository @Inject constructor(
 
             val result = signResult.getOrThrow()
 
-            // Report completion
+            // Report completion - use signingPartyId (original partyId from keygen)
             val signatureBytes = android.util.Base64.decode(result.signature, android.util.Base64.NO_WRAP)
-            grpcClient.reportCompletion(sessionId, partyId, signature = signatureBytes)
+            grpcClient.reportCompletion(sessionId, signingPartyId, signature = signatureBytes)
 
             stopProgressCollection()
             _sessionStatus.value = SessionStatus.COMPLETED
             pendingSessionId = null  // Clear pending session ID on completion
             messageCollectionJob?.cancel()
+            currentSigningPartyId = null  // Clear after signing completes
 
             android.util.Log.d("TssRepository", "Sign as joiner completed: signature=${result.signature.take(20)}...")
 
@@ -1274,6 +1303,7 @@ class TssRepository @Inject constructor(
             stopProgressCollection()
             _sessionStatus.value = SessionStatus.FAILED
             pendingSessionId = null  // Clear pending session ID on failure
+            currentSigningPartyId = null  // Clear on failure too
             Result.failure(e)
         }
     }
@@ -1366,6 +1396,7 @@ class TssRepository @Inject constructor(
             val address = AddressUtils.deriveEvmAddress(publicKeyBytes)
 
             // Save share record
+            // CRITICAL: Save partyId - this is required for signing after backup/restore
             val shareEntity = ShareRecordEntity(
                 sessionId = apiJoinData.sessionId,
                 publicKey = result.publicKey,
@@ -1373,6 +1404,7 @@ class TssRepository @Inject constructor(
                 thresholdT = apiJoinData.thresholdT,
                 thresholdN = apiJoinData.thresholdN,
                 partyIndex = myPartyIndex,
+                partyId = partyId,
                 address = address
             )
             val id = shareRecordDao.insertShare(shareEntity)
@@ -1516,12 +1548,15 @@ class TssRepository @Inject constructor(
             _sessionStatus.value = SessionStatus.WAITING
 
             // Add self to participants
-            val allParticipants = sessionData.participants + Participant(partyId, myPartyIndex)
+            // CRITICAL: Use shareEntity.partyId (original partyId from keygen) for signing
+            val signingPartyId = shareEntity.partyId
+            currentSigningPartyId = signingPartyId  // Save for later use in this flow
+            val allParticipants = sessionData.participants + Participant(signingPartyId, myPartyIndex)
 
             // Start TSS sign
             val startResult = tssNativeBridge.startSign(
                 sessionId = apiJoinData.sessionId,
-                partyId = partyId,
+                partyId = signingPartyId,
                 partyIndex = myPartyIndex,
                 thresholdT = apiJoinData.thresholdT,
                 thresholdN = shareEntity.thresholdN,  // Use original N from keygen
@@ -1540,8 +1575,8 @@ class TssRepository @Inject constructor(
             // Start message routing
             startMessageRouting(apiJoinData.sessionId, myPartyIndex)
 
-            // Mark ready
+            // Mark ready - use signingPartyId (original partyId from keygen)
-            grpcClient.markPartyReady(apiJoinData.sessionId, partyId)
+            grpcClient.markPartyReady(apiJoinData.sessionId, signingPartyId)
 
             // Wait for sign result
             val signResult = tssNativeBridge.waitForSignResult()
@@ -1552,18 +1587,20 @@ class TssRepository @Inject constructor(
 
             val result = signResult.getOrThrow()
 
-            // Report completion
+            // Report completion - use signingPartyId (original partyId from keygen)
             val signatureBytes = Base64.decode(result.signature, Base64.NO_WRAP)
-            grpcClient.reportCompletion(apiJoinData.sessionId, partyId, signature = signatureBytes)
+            grpcClient.reportCompletion(apiJoinData.sessionId, signingPartyId, signature = signatureBytes)
 
             _sessionStatus.value = SessionStatus.COMPLETED
             messageCollectionJob?.cancel()
+            currentSigningPartyId = null  // Clear after signing completes
 
             Result.success(result)
 
         } catch (e: Exception) {
             android.util.Log.e("TssRepository", "Join sign session failed", e)
             _sessionStatus.value = SessionStatus.FAILED
+            currentSigningPartyId = null  // Clear on failure too
             Result.failure(e)
         }
     }
@@ -1785,6 +1822,7 @@ class TssRepository @Inject constructor(
             val address = AddressUtils.deriveEvmAddress(publicKeyBytes)
 
             // Save share record (use actual thresholds from backend)
+            // CRITICAL: Save partyId - this is required for signing after backup/restore
             val shareEntity = ShareRecordEntity(
                 sessionId = sessionId,
                 publicKey = result.publicKey,
@@ -1792,6 +1830,7 @@ class TssRepository @Inject constructor(
                 thresholdT = actualThresholdT,
                 thresholdN = actualThresholdN,
                 partyIndex = myPartyIndex,
+                partyId = partyId,
                 address = address
             )
             val id = shareRecordDao.insertShare(shareEntity)
@@ -1900,6 +1939,7 @@ class TssRepository @Inject constructor(
                 }
 
                 // Convert to entity and save
+                // CRITICAL: Preserve the original partyId from backup - this is required for signing
                 val shareRecord = backup.toShareRecord()
                 val entity = ShareRecordEntity(
                     sessionId = shareRecord.sessionId,
@@ -1908,6 +1948,7 @@ class TssRepository @Inject constructor(
                     thresholdT = shareRecord.thresholdT,
                     thresholdN = shareRecord.thresholdN,
                     partyIndex = shareRecord.partyIndex,
+                    partyId = shareRecord.partyId,
                     address = shareRecord.address,
                     createdAt = shareRecord.createdAt
                 )
@@ -1915,7 +1956,7 @@ class TssRepository @Inject constructor(
                 val newId = shareRecordDao.insertShare(entity)
                 val savedShare = shareRecord.copy(id = newId)
 
-                android.util.Log.d("TssRepository", "Imported share backup for address: ${backup.address}")
+                android.util.Log.d("TssRepository", "Imported share backup for address: ${backup.address}, partyId: ${backup.partyId}")
                 Result.success(savedShare)
             } catch (e: com.google.gson.JsonSyntaxException) {
                 android.util.Log.e("TssRepository", "Invalid JSON format in backup", e)
@@ -1971,10 +2012,19 @@ class TssRepository @Inject constructor(
     }
 
     /**
-     * Get Green Points (绿积分/dUSDT) token balance for an address
+     * Get ERC-20 token balance for an address
      * Uses eth_call to call balanceOf(address) on the ERC-20 contract
+     * @param address The wallet address
+     * @param rpcUrl The RPC endpoint URL
+     * @param contractAddress The ERC-20 token contract address
+     * @param decimals The token decimals (default 6 for USDT-like tokens)
      */
-    suspend fun getGreenPointsBalance(address: String, rpcUrl: String): Result<String> {
+    suspend fun getERC20Balance(
+        address: String,
+        rpcUrl: String,
+        contractAddress: String,
+        decimals: Int = 6
+    ): Result<String> {
         return withContext(Dispatchers.IO) {
             try {
                 val client = okhttp3.OkHttpClient()
@@ -1984,14 +2034,14 @@ class TssRepository @Inject constructor(
                 // Function selector: 0x70a08231
                 // Address parameter: padded to 32 bytes
                 val paddedAddress = address.removePrefix("0x").lowercase().padStart(64, '0')
-                val callData = "${GreenPointsToken.BALANCE_OF_SELECTOR}$paddedAddress"
+                val callData = "${ERC20Selectors.BALANCE_OF}$paddedAddress"
 
                 val requestBody = """
                     {
                         "jsonrpc": "2.0",
                         "method": "eth_call",
                         "params": [{
-                            "to": "${GreenPointsToken.CONTRACT_ADDRESS}",
+                            "to": "$contractAddress",
                             "data": "$callData"
                         }, "latest"],
                         "id": 1
@@ -2013,42 +2063,88 @@ class TssRepository @Inject constructor(
                 }
 
                 val hexBalance = json.get("result").asString
-                // Convert hex to decimal, then apply 6 decimals (dUSDT uses 6 decimals like USDT)
+                // Convert hex to decimal, then apply decimals
                 val rawBalance = java.math.BigInteger(hexBalance.removePrefix("0x"), 16)
+                val divisor = java.math.BigDecimal.TEN.pow(decimals)
                 val tokenBalance = java.math.BigDecimal(rawBalance).divide(
-                    java.math.BigDecimal("1000000"),  // 10^6 for 6 decimals
+                    divisor,
-                    6,
+                    decimals,
                     java.math.RoundingMode.DOWN
                 )
 
                 Result.success(tokenBalance.toPlainString())
             } catch (e: Exception) {
-                android.util.Log.e("TssRepository", "Failed to get Green Points balance: ${e.message}")
+                android.util.Log.e("TssRepository", "Failed to get ERC20 balance for $contractAddress: ${e.message}")
                 Result.failure(e)
             }
         }
     }
 
     /**
-     * Get both KAVA and Green Points balances for an address
+     * Get Green Points (绿积分/dUSDT) token balance for an address
+     * Uses eth_call to call balanceOf(address) on the ERC-20 contract
+     */
+    suspend fun getGreenPointsBalance(address: String, rpcUrl: String): Result<String> {
+        return getERC20Balance(
+            address = address,
+            rpcUrl = rpcUrl,
+            contractAddress = GreenPointsToken.CONTRACT_ADDRESS,
+            decimals = GreenPointsToken.DECIMALS
+        )
+    }
+
+    /**
+     * Get Energy Points (积分股/eUSDT) token balance for an address
+     */
+    suspend fun getEnergyPointsBalance(address: String, rpcUrl: String): Result<String> {
+        return getERC20Balance(
+            address = address,
+            rpcUrl = rpcUrl,
+            contractAddress = EnergyPointsToken.CONTRACT_ADDRESS,
+            decimals = EnergyPointsToken.DECIMALS
+        )
+    }
+
+    /**
+     * Get Future Points (积分值/fUSDT) token balance for an address
+     */
+    suspend fun getFuturePointsBalance(address: String, rpcUrl: String): Result<String> {
+        return getERC20Balance(
+            address = address,
+            rpcUrl = rpcUrl,
+            contractAddress = FuturePointsToken.CONTRACT_ADDRESS,
+            decimals = FuturePointsToken.DECIMALS
+        )
+    }
+
+    /**
+     * Get all token balances for an address (KAVA + all ERC-20 tokens)
      */
     suspend fun getWalletBalance(address: String, rpcUrl: String): Result<WalletBalance> {
         return withContext(Dispatchers.IO) {
             try {
-                // Fetch both balances in parallel
+                // Fetch all balances in parallel
                 val kavaDeferred = async { getBalance(address, rpcUrl) }
                 val greenPointsDeferred = async { getGreenPointsBalance(address, rpcUrl) }
+                val energyPointsDeferred = async { getEnergyPointsBalance(address, rpcUrl) }
+                val futurePointsDeferred = async { getFuturePointsBalance(address, rpcUrl) }
 
                 val kavaResult = kavaDeferred.await()
                 val greenPointsResult = greenPointsDeferred.await()
+                val energyPointsResult = energyPointsDeferred.await()
+                val futurePointsResult = futurePointsDeferred.await()
 
                 val kavaBalance = kavaResult.getOrDefault("0")
                 val greenPointsBalance = greenPointsResult.getOrDefault("0")
+                val energyPointsBalance = energyPointsResult.getOrDefault("0")
+                val futurePointsBalance = futurePointsResult.getOrDefault("0")
 
                 Result.success(WalletBalance(
                     address = address,
                     kavaBalance = kavaBalance,
-                    greenPointsBalance = greenPointsBalance
+                    greenPointsBalance = greenPointsBalance,
+                    energyPointsBalance = energyPointsBalance,
+                    futurePointsBalance = futurePointsBalance
                 ))
             } catch (e: Exception) {
                 Result.failure(e)
@@ -2312,8 +2408,12 @@ class TssRepository @Inject constructor(
                 val shareEntity = shareRecordDao.getShareById(shareId)
                     ?: return@withContext Result.failure(Exception("Share not found"))
 
+                // CRITICAL: Use shareEntity.partyId (original partyId from keygen) for signing
+                // This is required for backup/restore to work - the partyId must match what was used during keygen
+                val signingPartyId = shareEntity.partyId
+                currentSigningPartyId = signingPartyId  // Save for waitForSignature
                 android.util.Log.d("TssRepository", "[CO-SIGN] startSigning: participants=${session.participants.size}")
-                android.util.Log.d("TssRepository", "[CO-SIGN] startSigning: sessionId=$sessionId, partyId=$partyId, partyIndex=${shareEntity.partyIndex}")
+                android.util.Log.d("TssRepository", "[CO-SIGN] startSigning: sessionId=$sessionId, signingPartyId=$signingPartyId, partyIndex=${shareEntity.partyIndex}")
                 android.util.Log.d("TssRepository", "[CO-SIGN] startSigning: thresholdT=${session.thresholdT}, thresholdN=${shareEntity.thresholdN}")
                 android.util.Log.d("TssRepository", "[CO-SIGN] startSigning: messageHash=${session.messageHash?.take(20)}...")
                 session.participants.forEachIndexed { idx, p ->
@@ -2328,10 +2428,10 @@ class TssRepository @Inject constructor(
                 } else {
                     rawMessageHash
                 }
-                android.util.Log.d("TssRepository", "[CO-SIGN] Calling tssNativeBridge.startSign with cleanMessageHash=${cleanMessageHash.take(20)}...")
+                android.util.Log.d("TssRepository", "[CO-SIGN] Calling tssNativeBridge.startSign with cleanMessageHash=${cleanMessageHash.take(20)}..., signingPartyId=$signingPartyId")
                 val startResult = tssNativeBridge.startSign(
                     sessionId = sessionId,
-                    partyId = partyId,
+                    partyId = signingPartyId,
                     partyIndex = shareEntity.partyIndex,
                     thresholdT = session.thresholdT,
                     thresholdN = shareEntity.thresholdN,
@@ -2359,8 +2459,8 @@ class TssRepository @Inject constructor(
                     startMessageRouting(sessionId, shareEntity.partyIndex)
                 }
 
-                // Mark ready
+                // Mark ready - use signingPartyId (original partyId from keygen)
-                grpcClient.markPartyReady(sessionId, partyId)
+                grpcClient.markPartyReady(sessionId, signingPartyId)
 
                 Result.success(Unit)
             } catch (e: Exception) {
@@ -2386,16 +2486,18 @@ class TssRepository @Inject constructor(
 
                 val result = signResult.getOrThrow()
 
-                // Report completion
+                // Report completion - use currentSigningPartyId (original partyId from keygen)
                 val signatureBytes = Base64.decode(result.signature, Base64.NO_WRAP)
                 val session = _currentSession.value
+                val signingPartyId = currentSigningPartyId ?: partyId
                 if (session != null) {
-                    grpcClient.reportCompletion(session.sessionId, partyId, signature = signatureBytes)
+                    grpcClient.reportCompletion(session.sessionId, signingPartyId, signature = signatureBytes)
                 }
 
                 stopProgressCollection()
                 _sessionStatus.value = SessionStatus.COMPLETED
                 messageCollectionJob?.cancel()
+                currentSigningPartyId = null  // Clear after signing completes
 
                 Result.success(result)
             } catch (e: Exception) {
@@ -2759,6 +2861,7 @@ private fun ShareRecordEntity.toShareRecord() = ShareRecord(
     thresholdT = thresholdT,
     thresholdN = thresholdN,
     partyIndex = partyIndex,
+    partyId = partyId,
     address = address,
     createdAt = createdAt
 )

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/di/AppModule.kt

@@ -6,6 +6,7 @@ import androidx.room.migration.Migration
 import androidx.sqlite.db.SupportSQLiteDatabase
 import com.durian.tssparty.data.local.AppSettingDao
 import com.durian.tssparty.data.local.ShareRecordDao
+import com.durian.tssparty.data.local.TransactionRecordDao
 import com.durian.tssparty.data.local.TssDatabase
 import com.durian.tssparty.data.local.TssNativeBridge
 import com.durian.tssparty.data.remote.GrpcClient
@@ -34,6 +35,53 @@ object AppModule {
         }
     }
 
+    // Migration from version 2 to 3: add party_id column to share_records
+    // This is critical for backup/restore - the partyId must be preserved for signing to work
+    private val MIGRATION_2_3 = object : Migration(2, 3) {
+        override fun migrate(database: SupportSQLiteDatabase) {
+            // Add party_id column with empty default (existing records will need to be re-exported)
+            database.execSQL(
+                "ALTER TABLE `share_records` ADD COLUMN `party_id` TEXT NOT NULL DEFAULT ''"
+            )
+        }
+    }
+
+    // Migration from version 3 to 4: add transaction_records table for transfer history
+    // 添加转账记录表，用于存储交易历史和分类账
+    private val MIGRATION_3_4 = object : Migration(3, 4) {
+        override fun migrate(database: SupportSQLiteDatabase) {
+            // 创建转账记录表
+            database.execSQL("""
+                CREATE TABLE IF NOT EXISTS `transaction_records` (
+                    `id` INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,
+                    `share_id` INTEGER NOT NULL,
+                    `from_address` TEXT NOT NULL,
+                    `to_address` TEXT NOT NULL,
+                    `amount` TEXT NOT NULL,
+                    `token_type` TEXT NOT NULL,
+                    `tx_hash` TEXT NOT NULL,
+                    `gas_price` TEXT NOT NULL,
+                    `gas_used` TEXT NOT NULL DEFAULT '',
+                    `tx_fee` TEXT NOT NULL DEFAULT '',
+                    `status` TEXT NOT NULL,
+                    `direction` TEXT NOT NULL,
+                    `note` TEXT NOT NULL DEFAULT '',
+                    `created_at` INTEGER NOT NULL,
+                    `confirmed_at` INTEGER,
+                    `block_number` INTEGER,
+                    FOREIGN KEY(`share_id`) REFERENCES `share_records`(`id`) ON DELETE CASCADE
+                )
+            """.trimIndent())
+
+            // 创建索引以优化查询性能
+            database.execSQL("CREATE INDEX IF NOT EXISTS `index_transaction_records_share_id` ON `transaction_records` (`share_id`)")
+            database.execSQL("CREATE UNIQUE INDEX IF NOT EXISTS `index_transaction_records_tx_hash` ON `transaction_records` (`tx_hash`)")
+            database.execSQL("CREATE INDEX IF NOT EXISTS `index_transaction_records_from_address` ON `transaction_records` (`from_address`)")
+            database.execSQL("CREATE INDEX IF NOT EXISTS `index_transaction_records_to_address` ON `transaction_records` (`to_address`)")
+            database.execSQL("CREATE INDEX IF NOT EXISTS `index_transaction_records_created_at` ON `transaction_records` (`created_at`)")
+        }
+    }
+
     @Provides
     @Singleton
     fun provideGson(): Gson {
@@ -48,7 +96,7 @@ object AppModule {
             TssDatabase::class.java,
             "tss_party.db"
         )
-            .addMigrations(MIGRATION_1_2)
+            .addMigrations(MIGRATION_1_2, MIGRATION_2_3, MIGRATION_3_4)
             .build()
     }
 
@@ -64,6 +112,12 @@ object AppModule {
         return database.appSettingDao()
     }
 
+    @Provides
+    @Singleton
+    fun provideTransactionRecordDao(database: TssDatabase): TransactionRecordDao {
+        return database.transactionRecordDao()
+    }
+
     @Provides
     @Singleton
     fun provideGrpcClient(): GrpcClient {
@@ -82,8 +136,9 @@ object AppModule {
         grpcClient: GrpcClient,
         tssNativeBridge: TssNativeBridge,
         shareRecordDao: ShareRecordDao,
-        appSettingDao: AppSettingDao
+        appSettingDao: AppSettingDao,
+        transactionRecordDao: TransactionRecordDao
     ): TssRepository {
-        return TssRepository(grpcClient, tssNativeBridge, shareRecordDao, appSettingDao)
+        return TssRepository(grpcClient, tssNativeBridge, shareRecordDao, appSettingDao, transactionRecordDao)
     }
 }

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/domain/model/Models.kt

@@ -86,6 +86,7 @@ data class ShareRecord(
     val thresholdT: Int,
     val thresholdN: Int,
     val partyIndex: Int,
+    val partyId: String,  // The original partyId used during keygen - required for signing
     val address: String,
     val createdAt: Long = System.currentTimeMillis()
 )
@@ -129,7 +130,21 @@ enum class NetworkType {
  */
 enum class TokenType {
     KAVA,           // Native KAVA token
-    GREEN_POINTS    // 绿积分 (dUSDT) ERC-20 token
+    GREEN_POINTS,   // 绿积分 (dUSDT) ERC-20 token
+    ENERGY_POINTS,  // 积分股 (eUSDT) ERC-20 token
+    FUTURE_POINTS   // 积分值 (fUSDT) ERC-20 token
+}
+
+/**
+ * ERC-20 通用函数签名（keccak256 哈希的前4字节）
+ * Common ERC-20 function selectors
+ */
+object ERC20Selectors {
+    const val BALANCE_OF = "0x70a08231"    // balanceOf(address)
+    const val TRANSFER = "0xa9059cbb"      // transfer(address,uint256)
+    const val APPROVE = "0x095ea7b3"       // approve(address,uint256)
+    const val ALLOWANCE = "0xdd62ed3e"     // allowance(address,address)
+    const val TOTAL_SUPPLY = "0x18160ddd"  // totalSupply()
 }
 
 /**
@@ -142,22 +157,122 @@ object GreenPointsToken {
     const val SYMBOL = "dUSDT"
     const val DECIMALS = 6
 
-    // ERC-20 function signatures (first 4 bytes of keccak256 hash)
+    // ERC-20 function signatures (kept for backward compatibility)
-    const val BALANCE_OF_SELECTOR = "0x70a08231"  // balanceOf(address)
+    const val BALANCE_OF_SELECTOR = ERC20Selectors.BALANCE_OF
-    const val TRANSFER_SELECTOR = "0xa9059cbb"    // transfer(address,uint256)
+    const val TRANSFER_SELECTOR = ERC20Selectors.TRANSFER
-    const val APPROVE_SELECTOR = "0x095ea7b3"     // approve(address,uint256)
+    const val APPROVE_SELECTOR = ERC20Selectors.APPROVE
-    const val ALLOWANCE_SELECTOR = "0xdd62ed3e"   // allowance(address,address)
+    const val ALLOWANCE_SELECTOR = ERC20Selectors.ALLOWANCE
-    const val TOTAL_SUPPLY_SELECTOR = "0x18160ddd" // totalSupply()
+    const val TOTAL_SUPPLY_SELECTOR = ERC20Selectors.TOTAL_SUPPLY
 }
 
 /**
- * Wallet balance containing both native and token balances
+ * Energy Points (积分股) Token Contract Configuration
+ * eUSDT - ERC-20 token on Kava EVM
+ * 总供应量：100.02亿 (10,002,000,000)
+ */
+object EnergyPointsToken {
+    const val CONTRACT_ADDRESS = "0x7C3275D808eFbAE90C06C7E3A9AfDdcAa8563931"
+    const val NAME = "积分股"
+    const val SYMBOL = "eUSDT"
+    const val DECIMALS = 6  // 与 dUSDT 相同的精度
+}
+
+/**
+ * Future Points (积分值) Token Contract Configuration
+ * fUSDT - ERC-20 token on Kava EVM
+ * 总供应量：1万亿 (1,000,000,000,000)
+ */
+object FuturePointsToken {
+    const val CONTRACT_ADDRESS = "0x14dc4f7d3E4197438d058C3D156dd9826A161134"
+    const val NAME = "积分值"
+    const val SYMBOL = "fUSDT"
+    const val DECIMALS = 6  // 与 dUSDT 相同的精度
+}
+
+/**
+ * 代币配置工具类
+ * Token configuration utility
+ */
+object TokenConfig {
+    /**
+     * 获取代币合约地址
+     */
+    fun getContractAddress(tokenType: TokenType): String? {
+        return when (tokenType) {
+            TokenType.KAVA -> null  // 原生代币无合约地址
+            TokenType.GREEN_POINTS -> GreenPointsToken.CONTRACT_ADDRESS
+            TokenType.ENERGY_POINTS -> EnergyPointsToken.CONTRACT_ADDRESS
+            TokenType.FUTURE_POINTS -> FuturePointsToken.CONTRACT_ADDRESS
+        }
+    }
+
+    /**
+     * 获取代币精度
+     */
+    fun getDecimals(tokenType: TokenType): Int {
+        return when (tokenType) {
+            TokenType.KAVA -> 18  // KAVA 原生代币精度
+            TokenType.GREEN_POINTS -> GreenPointsToken.DECIMALS
+            TokenType.ENERGY_POINTS -> EnergyPointsToken.DECIMALS
+            TokenType.FUTURE_POINTS -> FuturePointsToken.DECIMALS
+        }
+    }
+
+    /**
+     * 获取代币名称
+     */
+    fun getName(tokenType: TokenType): String {
+        return when (tokenType) {
+            TokenType.KAVA -> "KAVA"
+            TokenType.GREEN_POINTS -> GreenPointsToken.NAME
+            TokenType.ENERGY_POINTS -> EnergyPointsToken.NAME
+            TokenType.FUTURE_POINTS -> FuturePointsToken.NAME
+        }
+    }
+
+    /**
+     * 获取代币符号
+     */
+    fun getSymbol(tokenType: TokenType): String {
+        return when (tokenType) {
+            TokenType.KAVA -> "KAVA"
+            TokenType.GREEN_POINTS -> GreenPointsToken.SYMBOL
+            TokenType.ENERGY_POINTS -> EnergyPointsToken.SYMBOL
+            TokenType.FUTURE_POINTS -> FuturePointsToken.SYMBOL
+        }
+    }
+
+    /**
+     * 判断是否为 ERC-20 代币
+     */
+    fun isERC20(tokenType: TokenType): Boolean {
+        return tokenType != TokenType.KAVA
+    }
+}
+
+/**
+ * Wallet balance containing native and all token balances
+ * 钱包余额，包含原生代币和所有 ERC-20 代币余额
  */
 data class WalletBalance(
     val address: String,
-    val kavaBalance: String = "0",       // Native KAVA balance
+    val kavaBalance: String = "0",           // Native KAVA balance
-    val greenPointsBalance: String = "0" // 绿积分 (dUSDT) balance
+    val greenPointsBalance: String = "0",    // 绿积分 (dUSDT) balance
-)
+    val energyPointsBalance: String = "0",   // 积分股 (eUSDT) balance
+    val futurePointsBalance: String = "0"    // 积分值 (fUSDT) balance
+) {
+    /**
+     * 根据代币类型获取余额
+     */
+    fun getBalance(tokenType: TokenType): String {
+        return when (tokenType) {
+            TokenType.KAVA -> kavaBalance
+            TokenType.GREEN_POINTS -> greenPointsBalance
+            TokenType.ENERGY_POINTS -> energyPointsBalance
+            TokenType.FUTURE_POINTS -> futurePointsBalance
+        }
+    }
+}
 
 /**
  * Share backup data for export/import
@@ -165,7 +280,7 @@ data class WalletBalance(
  */
 data class ShareBackup(
     @SerializedName("version")
-    val version: Int = 1,  // Backup format version for future compatibility
+    val version: Int = 2,  // Version 2: added partyId field for proper backup/restore
 
     @SerializedName("sessionId")
     val sessionId: String,
@@ -185,6 +300,9 @@ data class ShareBackup(
     @SerializedName("partyIndex")
     val partyIndex: Int,
 
+    @SerializedName("partyId")
+    val partyId: String,  // The original partyId used during keygen - CRITICAL for signing after restore
+
     @SerializedName("address")
     val address: String,
 
@@ -209,6 +327,7 @@ data class ShareBackup(
                 thresholdT = share.thresholdT,
                 thresholdN = share.thresholdN,
                 partyIndex = share.partyIndex,
+                partyId = share.partyId,
                 address = share.address,
                 createdAt = share.createdAt
             )
@@ -227,6 +346,7 @@ data class ShareBackup(
             thresholdT = thresholdT,
             thresholdN = thresholdN,
             partyIndex = partyIndex,
+            partyId = partyId,
             address = address,
             createdAt = createdAt
         )

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/presentation/screens/TransferScreen.kt

@@ -27,10 +27,13 @@ import android.graphics.Bitmap
 import androidx.compose.foundation.Image
 import androidx.compose.foundation.background
 import androidx.compose.ui.graphics.asImageBitmap
+import com.durian.tssparty.domain.model.EnergyPointsToken
+import com.durian.tssparty.domain.model.FuturePointsToken
 import com.durian.tssparty.domain.model.GreenPointsToken
 import com.durian.tssparty.domain.model.NetworkType
 import com.durian.tssparty.domain.model.SessionStatus
 import com.durian.tssparty.domain.model.ShareRecord
+import com.durian.tssparty.domain.model.TokenConfig
 import com.durian.tssparty.domain.model.TokenType
 import com.durian.tssparty.domain.model.WalletBalance
 import com.durian.tssparty.util.TransactionUtils
@@ -156,10 +159,8 @@ fun TransferScreen(
                 rpcUrl = rpcUrl,
                 onSubmit = {
                     // Get current balance for the selected token type
-                    val currentBalance = when (selectedTokenType) {
+                    val currentBalance = walletBalance?.getBalance(selectedTokenType)
-                        TokenType.KAVA -> walletBalance?.kavaBalance ?: balance
+                        ?: if (selectedTokenType == TokenType.KAVA) balance else null
-                        TokenType.GREEN_POINTS -> walletBalance?.greenPointsBalance
-                    }
                     when {
                         toAddress.isBlank() -> validationError = "请输入收款地址"
                         !toAddress.startsWith("0x") || toAddress.length != 42 -> validationError = "地址格式不正确"
@@ -257,14 +258,9 @@ private fun TransferInputScreen(
     var isCalculatingMax by remember { mutableStateOf(false) }
 
     // Get current balance for the selected token type
-    val currentBalance = when (selectedTokenType) {
+    val currentBalance = walletBalance?.getBalance(selectedTokenType)
-        TokenType.KAVA -> walletBalance?.kavaBalance ?: balance
+        ?: if (selectedTokenType == TokenType.KAVA) balance else null
-        TokenType.GREEN_POINTS -> walletBalance?.greenPointsBalance
+    val tokenSymbol = TokenConfig.getName(selectedTokenType)
-    }
-    val tokenSymbol = when (selectedTokenType) {
-        TokenType.KAVA -> "KAVA"
-        TokenType.GREEN_POINTS -> GreenPointsToken.NAME
-    }
 
     Column(
         modifier = Modifier
@@ -293,38 +289,74 @@ private fun TransferInputScreen(
                 )
                 Spacer(modifier = Modifier.height(8.dp))
 
-                // Show both balances
+                // Show all token balances in a 2x2 grid
-                Row(
+                Column {
-                    modifier = Modifier.fillMaxWidth(),
+                    Row(
-                    horizontalArrangement = Arrangement.SpaceBetween
+                        modifier = Modifier.fillMaxWidth(),
-                ) {
+                        horizontalArrangement = Arrangement.SpaceBetween
-                    // KAVA balance
+                    ) {
-                    Column {
+                        // KAVA balance
-                        Text(
+                        Column {
-                            text = "KAVA",
+                            Text(
-                            style = MaterialTheme.typography.labelSmall,
+                                text = "KAVA",
-                            color = MaterialTheme.colorScheme.onSurfaceVariant
+                                style = MaterialTheme.typography.labelSmall,
-                        )
+                                color = MaterialTheme.colorScheme.onSurfaceVariant
-                        Text(
+                            )
-                            text = walletBalance?.kavaBalance ?: balance ?: "加载中...",
+                            Text(
-                            style = MaterialTheme.typography.bodySmall,
+                                text = walletBalance?.kavaBalance ?: balance ?: "加载中...",
-                            fontWeight = FontWeight.Medium,
+                                style = MaterialTheme.typography.bodySmall,
-                            color = MaterialTheme.colorScheme.primary
+                                fontWeight = FontWeight.Medium,
-                        )
+                                color = MaterialTheme.colorScheme.primary
+                            )
+                        }
+                        // Green Points balance (绿积分)
+                        Column(horizontalAlignment = Alignment.End) {
+                            Text(
+                                text = GreenPointsToken.NAME,
+                                style = MaterialTheme.typography.labelSmall,
+                                color = MaterialTheme.colorScheme.onSurfaceVariant
+                            )
+                            Text(
+                                text = walletBalance?.greenPointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodySmall,
+                                fontWeight = FontWeight.Medium,
+                                color = Color(0xFF4CAF50)
+                            )
+                        }
                     }
-                    // Green Points balance
+                    Spacer(modifier = Modifier.height(4.dp))
-                    Column(horizontalAlignment = Alignment.End) {
+                    Row(
-                        Text(
+                        modifier = Modifier.fillMaxWidth(),
-                            text = GreenPointsToken.NAME,
+                        horizontalArrangement = Arrangement.SpaceBetween
-                            style = MaterialTheme.typography.labelSmall,
+                    ) {
-                            color = MaterialTheme.colorScheme.onSurfaceVariant
+                        // Energy Points balance (积分股)
-                        )
+                        Column {
-                        Text(
+                            Text(
-                            text = walletBalance?.greenPointsBalance ?: "加载中...",
+                                text = EnergyPointsToken.NAME,
-                            style = MaterialTheme.typography.bodySmall,
+                                style = MaterialTheme.typography.labelSmall,
-                            fontWeight = FontWeight.Medium,
+                                color = MaterialTheme.colorScheme.onSurfaceVariant
-                            color = Color(0xFF4CAF50)
+                            )
-                        )
+                            Text(
+                                text = walletBalance?.energyPointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodySmall,
+                                fontWeight = FontWeight.Medium,
+                                color = Color(0xFF2196F3)  // Blue
+                            )
+                        }
+                        // Future Points balance (积分值)
+                        Column(horizontalAlignment = Alignment.End) {
+                            Text(
+                                text = FuturePointsToken.NAME,
+                                style = MaterialTheme.typography.labelSmall,
+                                color = MaterialTheme.colorScheme.onSurfaceVariant
+                            )
+                            Text(
+                                text = walletBalance?.futurePointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodySmall,
+                                fontWeight = FontWeight.Medium,
+                                color = Color(0xFF9C27B0)  // Purple
+                            )
+                        }
                     }
                 }
             }
@@ -339,6 +371,7 @@ private fun TransferInputScreen(
             color = MaterialTheme.colorScheme.onSurfaceVariant
         )
         Spacer(modifier = Modifier.height(8.dp))
+        // First row: KAVA and Green Points
         Row(
             modifier = Modifier.fillMaxWidth(),
             horizontalArrangement = Arrangement.spacedBy(8.dp)
@@ -359,7 +392,7 @@ private fun TransferInputScreen(
                 },
                 modifier = Modifier.weight(1f)
             )
-            // Green Points option
+            // Green Points option (绿积分)
             FilterChip(
                 selected = selectedTokenType == TokenType.GREEN_POINTS,
                 onClick = { onTokenTypeChange(TokenType.GREEN_POINTS) },
@@ -380,6 +413,53 @@ private fun TransferInputScreen(
                 modifier = Modifier.weight(1f)
             )
         }
+        Spacer(modifier = Modifier.height(8.dp))
+        // Second row: Energy Points and Future Points
+        Row(
+            modifier = Modifier.fillMaxWidth(),
+            horizontalArrangement = Arrangement.spacedBy(8.dp)
+        ) {
+            // Energy Points option (积分股)
+            FilterChip(
+                selected = selectedTokenType == TokenType.ENERGY_POINTS,
+                onClick = { onTokenTypeChange(TokenType.ENERGY_POINTS) },
+                label = { Text(EnergyPointsToken.NAME) },
+                leadingIcon = {
+                    if (selectedTokenType == TokenType.ENERGY_POINTS) {
+                        Icon(
+                            Icons.Default.Check,
+                            contentDescription = null,
+                            modifier = Modifier.size(18.dp)
+                        )
+                    }
+                },
+                colors = FilterChipDefaults.filterChipColors(
+                    selectedContainerColor = Color(0xFF2196F3).copy(alpha = 0.2f),
+                    selectedLabelColor = Color(0xFF2196F3)
+                ),
+                modifier = Modifier.weight(1f)
+            )
+            // Future Points option (积分值)
+            FilterChip(
+                selected = selectedTokenType == TokenType.FUTURE_POINTS,
+                onClick = { onTokenTypeChange(TokenType.FUTURE_POINTS) },
+                label = { Text(FuturePointsToken.NAME) },
+                leadingIcon = {
+                    if (selectedTokenType == TokenType.FUTURE_POINTS) {
+                        Icon(
+                            Icons.Default.Check,
+                            contentDescription = null,
+                            modifier = Modifier.size(18.dp)
+                        )
+                    }
+                },
+                colors = FilterChipDefaults.filterChipColors(
+                    selectedContainerColor = Color(0xFF9C27B0).copy(alpha = 0.2f),
+                    selectedLabelColor = Color(0xFF9C27B0)
+                ),
+                modifier = Modifier.weight(1f)
+            )
+        }
 
         Spacer(modifier = Modifier.height(16.dp))
 
@@ -418,9 +498,14 @@ private fun TransferInputScreen(
             keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Decimal),
             leadingIcon = {
                 Icon(
-                    if (selectedTokenType == TokenType.GREEN_POINTS) Icons.Default.Stars else Icons.Default.AttachMoney,
+                    if (selectedTokenType == TokenType.KAVA) Icons.Default.AttachMoney else Icons.Default.Stars,
                     contentDescription = null,
-                    tint = if (selectedTokenType == TokenType.GREEN_POINTS) Color(0xFF4CAF50) else MaterialTheme.colorScheme.onSurfaceVariant
+                    tint = when (selectedTokenType) {
+                        TokenType.KAVA -> MaterialTheme.colorScheme.onSurfaceVariant
+                        TokenType.GREEN_POINTS -> Color(0xFF4CAF50)
+                        TokenType.ENERGY_POINTS -> Color(0xFF2196F3)
+                        TokenType.FUTURE_POINTS -> Color(0xFF9C27B0)
+                    }
                 )
             },
             trailingIcon = {
@@ -439,7 +524,7 @@ private fun TransferInputScreen(
                                         onAmountChange(currentBalance)
                                     }
                                 } else {
-                                    // For tokens, use the full balance
+                                    // For ERC-20 tokens (dUSDT, eUSDT, fUSDT), use the full balance
                                     onAmountChange(currentBalance)
                                 }
                                 isCalculatingMax = false

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/presentation/screens/WalletsScreen.kt

@@ -35,6 +35,8 @@ import androidx.compose.ui.unit.sp
 import androidx.compose.ui.window.Dialog
 import android.content.Intent
 import android.net.Uri
+import com.durian.tssparty.domain.model.EnergyPointsToken
+import com.durian.tssparty.domain.model.FuturePointsToken
 import com.durian.tssparty.domain.model.GreenPointsToken
 import com.durian.tssparty.domain.model.NetworkType
 import com.durian.tssparty.domain.model.ShareRecord
@@ -281,62 +283,123 @@ private fun WalletItemCard(
 
             Spacer(modifier = Modifier.height(12.dp))
 
-            // Balance display - now shows both KAVA and Green Points
+            // Balance display - shows all token balances in a 2x2 grid
-            Row(
+            Column {
-                modifier = Modifier.fillMaxWidth(),
+                Row(
-                horizontalArrangement = Arrangement.SpaceBetween
+                    modifier = Modifier.fillMaxWidth(),
-            ) {
+                    horizontalArrangement = Arrangement.SpaceBetween
-                // KAVA balance
+                ) {
-                Column {
+                    // KAVA balance
-                    Text(
+                    Column {
-                        text = "KAVA",
-                        style = MaterialTheme.typography.labelSmall,
-                        color = MaterialTheme.colorScheme.outline
-                    )
-                    Row(verticalAlignment = Alignment.CenterVertically) {
-                        Icon(
-                            Icons.Default.AccountBalance,
-                            contentDescription = null,
-                            modifier = Modifier.size(16.dp),
-                            tint = MaterialTheme.colorScheme.primary
-                        )
-                        Spacer(modifier = Modifier.width(4.dp))
                         Text(
-                            text = walletBalance?.kavaBalance ?: balance ?: "加载中...",
+                            text = "KAVA",
-                            style = MaterialTheme.typography.bodyMedium,
+                            style = MaterialTheme.typography.labelSmall,
-                            color = if (walletBalance != null || balance != null)
+                            color = MaterialTheme.colorScheme.outline
-                                MaterialTheme.colorScheme.primary
-                            else
-                                MaterialTheme.colorScheme.outline,
-                            fontWeight = FontWeight.Medium
                         )
+                        Row(verticalAlignment = Alignment.CenterVertically) {
+                            Icon(
+                                Icons.Default.AccountBalance,
+                                contentDescription = null,
+                                modifier = Modifier.size(16.dp),
+                                tint = MaterialTheme.colorScheme.primary
+                            )
+                            Spacer(modifier = Modifier.width(4.dp))
+                            Text(
+                                text = walletBalance?.kavaBalance ?: balance ?: "加载中...",
+                                style = MaterialTheme.typography.bodyMedium,
+                                color = if (walletBalance != null || balance != null)
+                                    MaterialTheme.colorScheme.primary
+                                else
+                                    MaterialTheme.colorScheme.outline,
+                                fontWeight = FontWeight.Medium
+                            )
+                        }
+                    }
+
+                    // Green Points (绿积分) balance
+                    Column(horizontalAlignment = Alignment.End) {
+                        Text(
+                            text = GreenPointsToken.NAME,
+                            style = MaterialTheme.typography.labelSmall,
+                            color = MaterialTheme.colorScheme.outline
+                        )
+                        Row(verticalAlignment = Alignment.CenterVertically) {
+                            Icon(
+                                Icons.Default.Stars,
+                                contentDescription = null,
+                                modifier = Modifier.size(16.dp),
+                                tint = Color(0xFF4CAF50)
+                            )
+                            Spacer(modifier = Modifier.width(4.dp))
+                            Text(
+                                text = walletBalance?.greenPointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodyMedium,
+                                color = if (walletBalance != null)
+                                    Color(0xFF4CAF50)
+                                else
+                                    MaterialTheme.colorScheme.outline,
+                                fontWeight = FontWeight.Medium
+                            )
+                        }
                     }
                 }
-
+                Spacer(modifier = Modifier.height(8.dp))
-                // Green Points (绿积分) balance
+                Row(
-                Column(horizontalAlignment = Alignment.End) {
+                    modifier = Modifier.fillMaxWidth(),
-                    Text(
+                    horizontalArrangement = Arrangement.SpaceBetween
-                        text = GreenPointsToken.NAME,
+                ) {
-                        style = MaterialTheme.typography.labelSmall,
+                    // Energy Points (积分股) balance
-                        color = MaterialTheme.colorScheme.outline
+                    Column {
-                    )
-                    Row(verticalAlignment = Alignment.CenterVertically) {
-                        Icon(
-                            Icons.Default.Stars,
-                            contentDescription = null,
-                            modifier = Modifier.size(16.dp),
-                            tint = Color(0xFF4CAF50) // Green color for Green Points
-                        )
-                        Spacer(modifier = Modifier.width(4.dp))
                         Text(
-                            text = walletBalance?.greenPointsBalance ?: "加载中...",
+                            text = EnergyPointsToken.NAME,
-                            style = MaterialTheme.typography.bodyMedium,
+                            style = MaterialTheme.typography.labelSmall,
-                            color = if (walletBalance != null)
+                            color = MaterialTheme.colorScheme.outline
-                                Color(0xFF4CAF50)
-                            else
-                                MaterialTheme.colorScheme.outline,
-                            fontWeight = FontWeight.Medium
                         )
+                        Row(verticalAlignment = Alignment.CenterVertically) {
+                            Icon(
+                                Icons.Default.Stars,
+                                contentDescription = null,
+                                modifier = Modifier.size(16.dp),
+                                tint = Color(0xFF2196F3)  // Blue
+                            )
+                            Spacer(modifier = Modifier.width(4.dp))
+                            Text(
+                                text = walletBalance?.energyPointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodyMedium,
+                                color = if (walletBalance != null)
+                                    Color(0xFF2196F3)
+                                else
+                                    MaterialTheme.colorScheme.outline,
+                                fontWeight = FontWeight.Medium
+                            )
+                        }
+                    }
+
+                    // Future Points (积分值) balance
+                    Column(horizontalAlignment = Alignment.End) {
+                        Text(
+                            text = FuturePointsToken.NAME,
+                            style = MaterialTheme.typography.labelSmall,
+                            color = MaterialTheme.colorScheme.outline
+                        )
+                        Row(verticalAlignment = Alignment.CenterVertically) {
+                            Icon(
+                                Icons.Default.Stars,
+                                contentDescription = null,
+                                modifier = Modifier.size(16.dp),
+                                tint = Color(0xFF9C27B0)  // Purple
+                            )
+                            Spacer(modifier = Modifier.width(4.dp))
+                            Text(
+                                text = walletBalance?.futurePointsBalance ?: "加载中...",
+                                style = MaterialTheme.typography.bodyMedium,
+                                color = if (walletBalance != null)
+                                    Color(0xFF9C27B0)
+                                else
+                                    MaterialTheme.colorScheme.outline,
+                                fontWeight = FontWeight.Medium
+                            )
+                        }
                     }
                 }
             }

backend/mpc-system/services/service-party-android/app/src/main/java/com/durian/tssparty/util/TransactionUtils.kt

@@ -1,6 +1,10 @@
 package com.durian.tssparty.util
 
+import com.durian.tssparty.domain.model.ERC20Selectors
+import com.durian.tssparty.domain.model.EnergyPointsToken
+import com.durian.tssparty.domain.model.FuturePointsToken
 import com.durian.tssparty.domain.model.GreenPointsToken
+import com.durian.tssparty.domain.model.TokenConfig
 import com.durian.tssparty.domain.model.TokenType
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
@@ -61,7 +65,7 @@ object TransactionUtils {
     /**
      * Prepare a transaction for signing
      * Gets nonce, gas price, estimates gas, and calculates sign hash
-     * Supports both native KAVA transfers and ERC-20 token transfers (绿积分)
+     * Supports both native KAVA transfers and ERC-20 token transfers (绿积分/积分股/积分值)
      */
     suspend fun prepareTransaction(params: TransactionParams): Result<PreparedTransaction> = withContext(Dispatchers.IO) {
         try {
@@ -77,13 +81,16 @@ object TransactionUtils {
                     // Native KAVA transfer
                     Triple(params.to, kavaToWei(params.amount), ByteArray(0))
                 }
-                TokenType.GREEN_POINTS -> {
+                TokenType.GREEN_POINTS, TokenType.ENERGY_POINTS, TokenType.FUTURE_POINTS -> {
-                    // ERC-20 token transfer (绿积分)
+                    // ERC-20 token transfer
                     // To address is the contract, value is 0
                     // Data is transfer(recipient, amount) encoded
-                    val tokenAmount = greenPointsToRaw(params.amount)
+                    val contractAddress = TokenConfig.getContractAddress(params.tokenType)
+                        ?: return@withContext Result.failure(Exception("Invalid token type"))
+                    val decimals = TokenConfig.getDecimals(params.tokenType)
+                    val tokenAmount = tokenToRaw(params.amount, decimals)
                     val transferData = encodeErc20Transfer(params.to, tokenAmount)
-                    Triple(GreenPointsToken.CONTRACT_ADDRESS, BigInteger.ZERO, transferData)
+                    Triple(contractAddress, BigInteger.ZERO, transferData)
                 }
             }
 
@@ -98,7 +105,7 @@ object TransactionUtils {
                 // Default gas limits
                 when (params.tokenType) {
                     TokenType.KAVA -> BigInteger.valueOf(21000)
-                    TokenType.GREEN_POINTS -> BigInteger.valueOf(65000)  // ERC-20 transfers need more gas
+                    else -> BigInteger.valueOf(65000)  // ERC-20 transfers need more gas
                 }
             }
 
@@ -139,7 +146,7 @@ object TransactionUtils {
      */
     private fun encodeErc20Transfer(to: String, amount: BigInteger): ByteArray {
         // Function selector: transfer(address,uint256) = 0xa9059cbb
-        val selector = GreenPointsToken.TRANSFER_SELECTOR.removePrefix("0x").hexToByteArray()
+        val selector = ERC20Selectors.TRANSFER.removePrefix("0x").hexToByteArray()
 
         // Encode recipient address (padded to 32 bytes)
         val paddedAddress = to.removePrefix("0x").lowercase().padStart(64, '0').hexToByteArray()
@@ -152,21 +159,43 @@ object TransactionUtils {
     }
 
     /**
-     * Convert Green Points amount to raw units (6 decimals)
+     * Convert token amount to raw units based on decimals
+     * @param amount Human-readable amount (e.g., "100.5")
+     * @param decimals Token decimals (e.g., 6 for USDT-like tokens, 18 for native)
      */
-    fun greenPointsToRaw(amount: String): BigInteger {
+    fun tokenToRaw(amount: String, decimals: Int): BigInteger {
         val decimal = BigDecimal(amount)
-        val rawDecimal = decimal.multiply(BigDecimal("1000000"))  // 10^6
+        val multiplier = BigDecimal.TEN.pow(decimals)
+        val rawDecimal = decimal.multiply(multiplier)
         return rawDecimal.toBigInteger()
     }
 
+    /**
+     * Convert raw units to human-readable token amount
+     * @param raw Raw amount in smallest units
+     * @param decimals Token decimals (e.g., 6 for USDT-like tokens, 18 for native)
+     */
+    fun rawToToken(raw: BigInteger, decimals: Int): String {
+        val rawDecimal = BigDecimal(raw)
+        val divisor = BigDecimal.TEN.pow(decimals)
+        val displayDecimal = rawDecimal.divide(divisor, decimals, java.math.RoundingMode.DOWN)
+        return displayDecimal.toPlainString()
+    }
+
+    /**
+     * Convert Green Points amount to raw units (6 decimals)
+     * @deprecated Use tokenToRaw(amount, 6) instead
+     */
+    fun greenPointsToRaw(amount: String): BigInteger {
+        return tokenToRaw(amount, GreenPointsToken.DECIMALS)
+    }
+
     /**
      * Convert raw units to Green Points display amount
+     * @deprecated Use rawToToken(raw, 6) instead
      */
     fun rawToGreenPoints(raw: BigInteger): String {
-        val rawDecimal = BigDecimal(raw)
+        return rawToToken(raw, GreenPointsToken.DECIMALS)
-        val displayDecimal = rawDecimal.divide(BigDecimal("1000000"), 6, java.math.RoundingMode.DOWN)
-        return displayDecimal.toPlainString()
     }
 
     /**

backend/mpc-system/services/service-party-app/electron/main.ts

@@ -821,6 +821,21 @@ async function handleCoSignStart(event: {
   // 标记签名开始
   signInProgressSessionId = event.sessionId;
 
+  // CRITICAL: Get the original partyId from keygen (stored in share) for signing
+  // This is essential for backup/restore - the partyId must match what was used during keygen
+  const share = database?.getShare(activeCoSignSession.shareId, activeCoSignSession.sharePassword);
+  if (!share) {
+    debugLog.error('main', 'Failed to get share data');
+    mainWindow?.webContents.send(`cosign:events:${event.sessionId}`, {
+      type: 'failed',
+      error: 'Failed to get share data',
+    });
+    signInProgressSessionId = null;
+    return;
+  }
+  const signingPartyId = share.party_id || grpcClient?.getPartyId() || '';
+  debugLog.info('main', `Using signingPartyId=${signingPartyId} (currentDevicePartyId=${grpcClient?.getPartyId()})`);
+
   // 打印当前 activeCoSignSession.participants 状态
   console.log('[CO-SIGN] Current activeCoSignSession.participants before update:',
     activeCoSignSession.participants.map(p => ({
@@ -832,8 +847,9 @@ async function handleCoSignStart(event: {
 
   // 从 event.selectedParties 更新参与者列表
   // 优先使用 activeCoSignSession.participants 中的 partyIndex（来自 signingParties 或 other_parties）
+  // CRITICAL: Use signingPartyId (original from keygen) for identification
   if (event.selectedParties && event.selectedParties.length > 0) {
-    const myPartyId = grpcClient?.getPartyId();
+    const myPartyId = signingPartyId;
     const updatedParticipants: Array<{ partyId: string; partyIndex: number; name: string }> = [];
 
     event.selectedParties.forEach((partyId) => {
@@ -869,21 +885,11 @@ async function handleCoSignStart(event: {
     })));
   }
 
-  // 获取 share 数据
+  // Note: share already fetched above for getting signingPartyId
-  const share = database?.getShare(activeCoSignSession.shareId, activeCoSignSession.sharePassword);
-  if (!share) {
-    debugLog.error('main', 'Failed to get share data');
-    mainWindow?.webContents.send(`cosign:events:${event.sessionId}`, {
-      type: 'failed',
-      error: 'Failed to get share data',
-    });
-    signInProgressSessionId = null;
-    return;
-  }
 
   console.log('[CO-SIGN] Calling tssHandler.participateSign with:', {
     sessionId: activeCoSignSession.sessionId,
-    partyId: grpcClient?.getPartyId(),
+    partyId: signingPartyId,  // CRITICAL: Use signingPartyId (original from keygen)
     partyIndex: activeCoSignSession.partyIndex,
     participants: activeCoSignSession.participants.map(p => ({ partyId: p.partyId.substring(0, 8), partyIndex: p.partyIndex })),
     threshold: activeCoSignSession.threshold,
@@ -892,9 +898,10 @@ async function handleCoSignStart(event: {
   debugLog.info('tss', `Starting sign for session ${event.sessionId}...`);
 
   try {
+    // CRITICAL: Use signingPartyId (original partyId from keygen) for signing
     const result = await (tssHandler as TSSHandler).participateSign(
       activeCoSignSession.sessionId,
-      grpcClient?.getPartyId() || '',
+      signingPartyId,  // CRITICAL: Use original partyId from keygen for backup/restore to work
       activeCoSignSession.partyIndex,
       activeCoSignSession.participants,
       activeCoSignSession.threshold,
@@ -1613,9 +1620,9 @@ function setupIpcHandlers() {
     initiatorName?: string;
   }) => {
     try {
-      // 获取当前 party ID
+      // 获取当前 party ID (用于检查连接状态)
-      const partyId = grpcClient?.getPartyId();
+      const currentDevicePartyId = grpcClient?.getPartyId();
-      if (!partyId) {
+      if (!currentDevicePartyId) {
         return { success: false, error: '请先连接到消息路由器' };
       }
 
@@ -1625,6 +1632,11 @@ function setupIpcHandlers() {
         return { success: false, error: 'Share 不存在或密码错误' };
       }
 
+      // CRITICAL: Use the original partyId from keygen (stored in share) for signing
+      // This is essential for backup/restore - the partyId must match what was used during keygen
+      const partyId = share.party_id || currentDevicePartyId;
+      debugLog.info('main', `Initiator using partyId=${partyId} (currentDevicePartyId=${currentDevicePartyId})`);
+
       // 从后端获取 keygen 会话的参与者信息（包含正确的 party_index）
       const keygenStatus = await accountClient?.getSessionStatus(share.session_id);
       if (!keygenStatus?.participants || keygenStatus.participants.length === 0) {
@@ -1810,8 +1822,8 @@ function setupIpcHandlers() {
     parties?: Array<{ party_id: string; party_index: number }>;
   }) => {
     try {
-      const partyId = grpcClient?.getPartyId();
+      const currentDevicePartyId = grpcClient?.getPartyId();
-      if (!partyId) {
+      if (!currentDevicePartyId) {
         return { success: false, error: '请先连接到消息路由器' };
       }
 
@@ -1821,9 +1833,12 @@ function setupIpcHandlers() {
         return { success: false, error: 'Share 不存在或密码错误' };
       }
 
-      debugLog.info('grpc', `Joining co-sign session: sessionId=${params.sessionId}, partyId=${partyId}`);
+      // CRITICAL: Use the original partyId from keygen (stored in share) for signing
+      // This is essential for backup/restore - the partyId must match what was used during keygen
+      const signingPartyId = share.party_id || currentDevicePartyId;
+      debugLog.info('grpc', `Joining co-sign session: sessionId=${params.sessionId}, signingPartyId=${signingPartyId} (currentDevicePartyId=${currentDevicePartyId})`);
 
-      const result = await grpcClient?.joinSession(params.sessionId, partyId, params.joinToken);
+      const result = await grpcClient?.joinSession(params.sessionId, signingPartyId, params.joinToken);
       if (result?.success) {
         // 设置活跃的 Co-Sign 会话
         // 优先使用 params.parties（来自 validateInviteCode，包含所有预期参与者）
@@ -1832,10 +1847,11 @@ function setupIpcHandlers() {
 
         if (params.parties && params.parties.length > 0) {
           // 使用完整的 parties 列表
+          // CRITICAL: Use signingPartyId (original from keygen) for identification
           participants = params.parties.map(p => ({
             partyId: p.party_id,
             partyIndex: p.party_index,
-            name: p.party_id === partyId ? '我' : `参与方 ${p.party_index + 1}`,
+            name: p.party_id === signingPartyId ? '我' : `参与方 ${p.party_index + 1}`,
           }));
           console.log('[CO-SIGN] Participant using params.parties (complete list):', participants.map(p => ({
             partyId: p.partyId.substring(0, 8),
@@ -1850,9 +1866,9 @@ function setupIpcHandlers() {
             name: `参与方 ${idx + 1}`,
           })) || [];
 
-          // 添加自己
+          // 添加自己 - CRITICAL: Use signingPartyId (original from keygen)
           participants.push({
-            partyId: partyId,
+            partyId: signingPartyId,
             partyIndex: result.party_index,
             name: '我',
           });
@@ -1886,11 +1902,11 @@ function setupIpcHandlers() {
           messageHash: params.messageHash,
         });
 
-        // 预订阅消息流
+        // 预订阅消息流 - CRITICAL: Use signingPartyId (original from keygen)
         if (tssHandler && 'prepareForSign' in tssHandler) {
           try {
-            debugLog.info('tss', `Preparing for sign: subscribing to messages for session ${params.sessionId}`);
+            debugLog.info('tss', `Preparing for sign: subscribing to messages for session ${params.sessionId}, signingPartyId=${signingPartyId}`);
-            (tssHandler as TSSHandler).prepareForSign(params.sessionId, partyId);
+            (tssHandler as TSSHandler).prepareForSign(params.sessionId, signingPartyId);
           } catch (prepareErr) {
             debugLog.error('tss', `Failed to prepare for sign: ${(prepareErr as Error).message}`);
             return { success: false, error: `消息订阅失败: ${(prepareErr as Error).message}` };

backend/mpc-system/services/service-party-app/src/pages/Home.tsx

@@ -11,7 +11,12 @@ import {
   getCurrentRpcUrl,
   getGasPrice,
   fetchGreenPointsBalance,
+  fetchEnergyPointsBalance,
+  fetchFuturePointsBalance,
   GREEN_POINTS_TOKEN,
+  ENERGY_POINTS_TOKEN,
+  FUTURE_POINTS_TOKEN,
+  TOKEN_CONFIG,
   type PreparedTransaction,
   type TokenType,
 } from '../utils/transaction';
@@ -32,6 +37,8 @@ interface ShareWithAddress extends ShareItem {
   evmAddress?: string;
   kavaBalance?: string;
   greenPointsBalance?: string;
+  energyPointsBalance?: string;
+  futurePointsBalance?: string;
   balanceLoading?: boolean;
 }
 
@@ -89,15 +96,30 @@ export default function Home() {
   const [isCalculatingMax, setIsCalculatingMax] = useState(false);
   const [copySuccess, setCopySuccess] = useState(false);
 
+  // 获取当前选择代币的余额
+  const getTokenBalance = (share: ShareWithAddress | null, tokenType: TokenType): string => {
+    if (!share) return '0';
+    switch (tokenType) {
+      case 'KAVA':
+        return share.kavaBalance || '0';
+      case 'GREEN_POINTS':
+        return share.greenPointsBalance || '0';
+      case 'ENERGY_POINTS':
+        return share.energyPointsBalance || '0';
+      case 'FUTURE_POINTS':
+        return share.futurePointsBalance || '0';
+    }
+  };
+
   // 计算扣除 Gas 费后的最大可转账金额
   const calculateMaxAmount = async () => {
     if (!transferShare?.evmAddress) return;
 
     setIsCalculatingMax(true);
     try {
-      if (transferTokenType === 'GREEN_POINTS') {
+      if (TOKEN_CONFIG.isERC20(transferTokenType)) {
-        // For token transfers, use the full token balance (gas is paid in KAVA)
+        // For ERC-20 token transfers, use the full token balance (gas is paid in KAVA)
-        const balance = transferShare.greenPointsBalance || '0';
+        const balance = getTokenBalance(transferShare, transferTokenType);
         setTransferAmount(balance);
         setTransferError(null);
       } else {
@@ -131,8 +153,8 @@ export default function Home() {
       }
     } catch (error) {
       console.error('Failed to calculate max amount:', error);
-      if (transferTokenType === 'GREEN_POINTS') {
+      if (TOKEN_CONFIG.isERC20(transferTokenType)) {
-        setTransferAmount(transferShare.greenPointsBalance || '0');
+        setTransferAmount(getTokenBalance(transferShare, transferTokenType));
       } else {
         // 如果获取 Gas 失败，使用默认估算 (1 gwei * 21000)
         const defaultGasFee = 0.000021; // ~21000 * 1 gwei
@@ -165,12 +187,14 @@ export default function Home() {
     const updatedShares = await Promise.all(
       sharesWithAddrs.map(async (share) => {
         if (share.evmAddress) {
-          // Fetch both balances in parallel
+          // Fetch all balances in parallel
-          const [kavaBalance, greenPointsBalance] = await Promise.all([
+          const [kavaBalance, greenPointsBalance, energyPointsBalance, futurePointsBalance] = await Promise.all([
             fetchKavaBalance(share.evmAddress),
             fetchGreenPointsBalance(share.evmAddress),
+            fetchEnergyPointsBalance(share.evmAddress),
+            fetchFuturePointsBalance(share.evmAddress),
           ]);
-          return { ...share, kavaBalance, greenPointsBalance, balanceLoading: false };
+          return { ...share, kavaBalance, greenPointsBalance, energyPointsBalance, futurePointsBalance, balanceLoading: false };
         }
         return { ...share, balanceLoading: false };
       })
@@ -315,11 +339,7 @@ export default function Home() {
       return '转账金额无效';
     }
     const amount = parseFloat(transferAmount);
-    const balance = parseFloat(
+    const balance = parseFloat(getTokenBalance(transferShare, transferTokenType));
-      transferTokenType === 'GREEN_POINTS'
-        ? (transferShare?.greenPointsBalance || '0')
-        : (transferShare?.kavaBalance || '0')
-    );
     if (amount > balance) {
       return '余额不足';
     }
@@ -486,7 +506,7 @@ export default function Home() {
                   </div>
                 )}
 
-                {/* 余额显示 - KAVA 和 绿积分 */}
+                {/* 余额显示 - 所有代币 */}
                 {share.evmAddress && (
                   <div className={styles.balanceSection}>
                     <div className={styles.balanceRow}>
@@ -509,6 +529,26 @@ export default function Home() {
                         )}
                       </span>
                     </div>
+                    <div className={styles.balanceRow}>
+                      <span className={styles.balanceLabel} style={{ color: '#2196F3' }}>{ENERGY_POINTS_TOKEN.name}</span>
+                      <span className={styles.balanceValue} style={{ color: '#2196F3' }}>
+                        {share.balanceLoading ? (
+                          <span className={styles.balanceLoading}>加载中...</span>
+                        ) : (
+                          <>{share.energyPointsBalance || '0'}</>
+                        )}
+                      </span>
+                    </div>
+                    <div className={styles.balanceRow}>
+                      <span className={styles.balanceLabel} style={{ color: '#9C27B0' }}>{FUTURE_POINTS_TOKEN.name}</span>
+                      <span className={styles.balanceValue} style={{ color: '#9C27B0' }}>
+                        {share.balanceLoading ? (
+                          <span className={styles.balanceLoading}>加载中...</span>
+                        ) : (
+                          <>{share.futurePointsBalance || '0'}</>
+                        )}
+                      </span>
+                    </div>
                   </div>
                 )}
 
@@ -578,7 +618,10 @@ export default function Home() {
               <div className={styles.transferWalletInfo}>
                 <div className={styles.transferWalletName}>{transferShare.walletName}</div>
                 <div className={styles.transferWalletBalance}>
-                  KAVA: {transferShare.kavaBalance || '0'} | {GREEN_POINTS_TOKEN.name}: {transferShare.greenPointsBalance || '0'}
+                  KAVA: {transferShare.kavaBalance || '0'} | <span style={{color: '#4CAF50'}}>{GREEN_POINTS_TOKEN.name}: {transferShare.greenPointsBalance || '0'}</span>
+                </div>
+                <div className={styles.transferWalletBalance}>
+                  <span style={{color: '#2196F3'}}>{ENERGY_POINTS_TOKEN.name}: {transferShare.energyPointsBalance || '0'}</span> | <span style={{color: '#9C27B0'}}>{FUTURE_POINTS_TOKEN.name}: {transferShare.futurePointsBalance || '0'}</span>
                 </div>
                 <div className={styles.transferNetwork}>
                   网络: Kava {getCurrentNetwork() === 'mainnet' ? '主网' : '测试网'}
@@ -605,6 +648,22 @@ export default function Home() {
                         {GREEN_POINTS_TOKEN.name}
                       </button>
                     </div>
+                    <div className={styles.tokenTypeSelector} style={{ marginTop: '8px' }}>
+                      <button
+                        className={`${styles.tokenTypeButton} ${transferTokenType === 'ENERGY_POINTS' ? styles.tokenTypeActive : ''}`}
+                        onClick={() => { setTransferTokenType('ENERGY_POINTS'); setTransferAmount(''); }}
+                        style={transferTokenType === 'ENERGY_POINTS' ? { backgroundColor: '#2196F3', borderColor: '#2196F3' } : {}}
+                      >
+                        {ENERGY_POINTS_TOKEN.name}
+                      </button>
+                      <button
+                        className={`${styles.tokenTypeButton} ${transferTokenType === 'FUTURE_POINTS' ? styles.tokenTypeActive : ''}`}
+                        onClick={() => { setTransferTokenType('FUTURE_POINTS'); setTransferAmount(''); }}
+                        style={transferTokenType === 'FUTURE_POINTS' ? { backgroundColor: '#9C27B0', borderColor: '#9C27B0' } : {}}
+                      >
+                        {FUTURE_POINTS_TOKEN.name}
+                      </button>
+                    </div>
                   </div>
 
                   {/* 收款地址 */}
@@ -622,7 +681,7 @@ export default function Home() {
                   {/* 转账金额 */}
                   <div className={styles.transferInputGroup}>
                     <label className={styles.transferLabel}>
-                      转账金额 ({transferTokenType === 'GREEN_POINTS' ? GREEN_POINTS_TOKEN.name : 'KAVA'})
+                      转账金额 ({TOKEN_CONFIG.getName(transferTokenType)})
                     </label>
                     <div className={styles.transferAmountWrapper}>
                       <input
@@ -689,8 +748,8 @@ export default function Home() {
                   <div className={styles.confirmDetails}>
                     <div className={styles.confirmRow}>
                       <span className={styles.confirmLabel}>转账类型</span>
-                      <span className={styles.confirmValue} style={transferTokenType === 'GREEN_POINTS' ? { color: '#4CAF50' } : {}}>
+                      <span className={styles.confirmValue} style={TOKEN_CONFIG.isERC20(transferTokenType) ? { color: transferTokenType === 'GREEN_POINTS' ? '#4CAF50' : transferTokenType === 'ENERGY_POINTS' ? '#2196F3' : '#9C27B0' } : {}}>
-                        {transferTokenType === 'GREEN_POINTS' ? GREEN_POINTS_TOKEN.name : 'KAVA'}
+                        {TOKEN_CONFIG.getName(transferTokenType)}
                       </span>
                     </div>
                     <div className={styles.confirmRow}>
@@ -699,8 +758,8 @@ export default function Home() {
                     </div>
                     <div className={styles.confirmRow}>
                       <span className={styles.confirmLabel}>转账金额</span>
-                      <span className={styles.confirmValue} style={transferTokenType === 'GREEN_POINTS' ? { color: '#4CAF50' } : {}}>
+                      <span className={styles.confirmValue} style={TOKEN_CONFIG.isERC20(transferTokenType) ? { color: transferTokenType === 'GREEN_POINTS' ? '#4CAF50' : transferTokenType === 'ENERGY_POINTS' ? '#2196F3' : '#9C27B0' } : {}}>
-                        {transferAmount} {transferTokenType === 'GREEN_POINTS' ? GREEN_POINTS_TOKEN.name : 'KAVA'}
+                        {transferAmount} {TOKEN_CONFIG.getName(transferTokenType)}
                       </span>
                     </div>
                     <div className={styles.confirmRow}>

backend/mpc-system/services/service-party-app/src/utils/transaction.ts

@@ -17,17 +17,97 @@ export const KAVA_RPC_URL = {
 };
 
 // Token types
-export type TokenType = 'KAVA' | 'GREEN_POINTS';
+export type TokenType = 'KAVA' | 'GREEN_POINTS' | 'ENERGY_POINTS' | 'FUTURE_POINTS';
 
-// Green Points (绿积分) Token Configuration
+// ERC-20 通用函数选择器
+export const ERC20_SELECTORS = {
+  balanceOf: '0x70a08231',    // balanceOf(address)
+  transfer: '0xa9059cbb',     // transfer(address,uint256)
+  approve: '0x095ea7b3',      // approve(address,uint256)
+  allowance: '0xdd62ed3e',    // allowance(address,address)
+  totalSupply: '0x18160ddd',  // totalSupply()
+};
+
+// Green Points (绿积分) Token Configuration - dUSDT
 export const GREEN_POINTS_TOKEN = {
   contractAddress: '0xA9F3A35dBa8699c8C681D8db03F0c1A8CEB9D7c3',
   name: '绿积分',
   symbol: 'dUSDT',
   decimals: 6,
-  // ERC-20 function selectors
+  // ERC-20 function selectors (kept for backward compatibility)
-  balanceOfSelector: '0x70a08231',
+  balanceOfSelector: ERC20_SELECTORS.balanceOf,
-  transferSelector: '0xa9059cbb',
+  transferSelector: ERC20_SELECTORS.transfer,
+};
+
+// Energy Points (积分股) Token Configuration - eUSDT
+export const ENERGY_POINTS_TOKEN = {
+  contractAddress: '0x7C3275D808eFbAE90C06C7E3A9AfDdcAa8563931',
+  name: '积分股',
+  symbol: 'eUSDT',
+  decimals: 6,
+};
+
+// Future Points (积分值) Token Configuration - fUSDT
+export const FUTURE_POINTS_TOKEN = {
+  contractAddress: '0x14dc4f7d3E4197438d058C3D156dd9826A161134',
+  name: '积分值',
+  symbol: 'fUSDT',
+  decimals: 6,
+};
+
+// Token configuration utility
+export const TOKEN_CONFIG = {
+  getContractAddress: (tokenType: TokenType): string | null => {
+    switch (tokenType) {
+      case 'KAVA':
+        return null; // Native token has no contract
+      case 'GREEN_POINTS':
+        return GREEN_POINTS_TOKEN.contractAddress;
+      case 'ENERGY_POINTS':
+        return ENERGY_POINTS_TOKEN.contractAddress;
+      case 'FUTURE_POINTS':
+        return FUTURE_POINTS_TOKEN.contractAddress;
+    }
+  },
+  getDecimals: (tokenType: TokenType): number => {
+    switch (tokenType) {
+      case 'KAVA':
+        return 18;
+      case 'GREEN_POINTS':
+        return GREEN_POINTS_TOKEN.decimals;
+      case 'ENERGY_POINTS':
+        return ENERGY_POINTS_TOKEN.decimals;
+      case 'FUTURE_POINTS':
+        return FUTURE_POINTS_TOKEN.decimals;
+    }
+  },
+  getName: (tokenType: TokenType): string => {
+    switch (tokenType) {
+      case 'KAVA':
+        return 'KAVA';
+      case 'GREEN_POINTS':
+        return GREEN_POINTS_TOKEN.name;
+      case 'ENERGY_POINTS':
+        return ENERGY_POINTS_TOKEN.name;
+      case 'FUTURE_POINTS':
+        return FUTURE_POINTS_TOKEN.name;
+    }
+  },
+  getSymbol: (tokenType: TokenType): string => {
+    switch (tokenType) {
+      case 'KAVA':
+        return 'KAVA';
+      case 'GREEN_POINTS':
+        return GREEN_POINTS_TOKEN.symbol;
+      case 'ENERGY_POINTS':
+        return ENERGY_POINTS_TOKEN.symbol;
+      case 'FUTURE_POINTS':
+        return FUTURE_POINTS_TOKEN.symbol;
+    }
+  },
+  isERC20: (tokenType: TokenType): boolean => {
+    return tokenType !== 'KAVA';
+  },
 };
 
 // 当前网络配置 (从 localStorage 读取或使用默认值)
@@ -327,44 +407,69 @@ export function weiToKava(wei: bigint): string {
 }
 
 /**
- * 将绿积分金额转换为最小单位 (6 decimals)
+ * 将代币金额转换为最小单位
+ * @param amount Human-readable amount
+ * @param decimals Token decimals (default 6 for USDT-like tokens)
  */
-export function greenPointsToRaw(amount: string): bigint {
+export function tokenToRaw(amount: string, decimals: number = 6): bigint {
   const parts = amount.split('.');
   const whole = BigInt(parts[0] || '0');
   let fraction = parts[1] || '';
 
-  // 补齐或截断到 6 位
+  // 补齐或截断到指定位数
-  if (fraction.length > 6) {
+  if (fraction.length > decimals) {
-    fraction = fraction.substring(0, 6);
+    fraction = fraction.substring(0, decimals);
   } else {
-    fraction = fraction.padEnd(6, '0');
+    fraction = fraction.padEnd(decimals, '0');
   }
 
-  return whole * BigInt(10 ** 6) + BigInt(fraction);
+  return whole * BigInt(10 ** decimals) + BigInt(fraction);
 }
 
 /**
- * 将最小单位转换为绿积分金额
+ * 将最小单位转换为代币金额
+ * @param raw Raw amount in smallest units
+ * @param decimals Token decimals (default 6 for USDT-like tokens)
  */
-export function rawToGreenPoints(raw: bigint): string {
+export function rawToToken(raw: bigint, decimals: number = 6): string {
-  const rawStr = raw.toString().padStart(7, '0');
+  const rawStr = raw.toString().padStart(decimals + 1, '0');
-  const whole = rawStr.slice(0, -6) || '0';
+  const whole = rawStr.slice(0, -decimals) || '0';
-  const fraction = rawStr.slice(-6).replace(/0+$/, '');
+  const fraction = rawStr.slice(-decimals).replace(/0+$/, '');
   return fraction ? `${whole}.${fraction}` : whole;
 }
 
 /**
- * 查询绿积分 (ERC-20) 余额
+ * 将绿积分金额转换为最小单位 (6 decimals)
+ * @deprecated Use tokenToRaw(amount, 6) instead
  */
-export async function fetchGreenPointsBalance(address: string): Promise<string> {
+export function greenPointsToRaw(amount: string): bigint {
+  return tokenToRaw(amount, GREEN_POINTS_TOKEN.decimals);
+}
+
+/**
+ * 将最小单位转换为绿积分金额
+ * @deprecated Use rawToToken(raw, 6) instead
+ */
+export function rawToGreenPoints(raw: bigint): string {
+  return rawToToken(raw, GREEN_POINTS_TOKEN.decimals);
+}
+
+/**
+ * 查询 ERC-20 代币余额
+ * @param address Wallet address
+ * @param contractAddress Token contract address
+ * @param decimals Token decimals
+ */
+export async function fetchERC20Balance(
+  address: string,
+  contractAddress: string,
+  decimals: number = 6
+): Promise<string> {
   try {
     const rpcUrl = getCurrentRpcUrl();
     // Encode balanceOf(address) call data
-    // Function selector: 0x70a08231
-    // Address parameter: padded to 32 bytes
     const paddedAddress = address.toLowerCase().replace('0x', '').padStart(64, '0');
-    const callData = GREEN_POINTS_TOKEN.balanceOfSelector + paddedAddress;
+    const callData = ERC20_SELECTORS.balanceOf + paddedAddress;
 
     const response = await fetch(rpcUrl, {
       method: 'POST',
@@ -374,7 +479,7 @@ export async function fetchGreenPointsBalance(address: string): Promise<string>
         method: 'eth_call',
         params: [
           {
-            to: GREEN_POINTS_TOKEN.contractAddress,
+            to: contractAddress,
             data: callData,
           },
           'latest',
@@ -386,21 +491,65 @@ export async function fetchGreenPointsBalance(address: string): Promise<string>
     const data = await response.json();
     if (data.result && data.result !== '0x') {
       const balanceRaw = BigInt(data.result);
-      return rawToGreenPoints(balanceRaw);
+      return rawToToken(balanceRaw, decimals);
     }
     return '0';
   } catch (error) {
-    console.error('Failed to fetch Green Points balance:', error);
+    console.error('Failed to fetch ERC20 balance:', error);
     return '0';
   }
 }
 
+/**
+ * 查询绿积分 (ERC-20) 余额
+ */
+export async function fetchGreenPointsBalance(address: string): Promise<string> {
+  return fetchERC20Balance(address, GREEN_POINTS_TOKEN.contractAddress, GREEN_POINTS_TOKEN.decimals);
+}
+
+/**
+ * 查询积分股 (eUSDT) 余额
+ */
+export async function fetchEnergyPointsBalance(address: string): Promise<string> {
+  return fetchERC20Balance(address, ENERGY_POINTS_TOKEN.contractAddress, ENERGY_POINTS_TOKEN.decimals);
+}
+
+/**
+ * 查询积分值 (fUSDT) 余额
+ */
+export async function fetchFuturePointsBalance(address: string): Promise<string> {
+  return fetchERC20Balance(address, FUTURE_POINTS_TOKEN.contractAddress, FUTURE_POINTS_TOKEN.decimals);
+}
+
+/**
+ * 查询所有代币余额
+ */
+export async function fetchAllTokenBalances(address: string): Promise<{
+  kava: string;
+  greenPoints: string;
+  energyPoints: string;
+  futurePoints: string;
+}> {
+  const [greenPoints, energyPoints, futurePoints] = await Promise.all([
+    fetchGreenPointsBalance(address),
+    fetchEnergyPointsBalance(address),
+    fetchFuturePointsBalance(address),
+  ]);
+  // Note: KAVA balance is fetched separately via eth_getBalance
+  return {
+    kava: '0', // Caller should fetch KAVA balance separately
+    greenPoints,
+    energyPoints,
+    futurePoints,
+  };
+}
+
 /**
  * Encode ERC-20 transfer function call
  */
 function encodeErc20Transfer(to: string, amount: bigint): string {
   // Function selector: transfer(address,uint256) = 0xa9059cbb
-  const selector = GREEN_POINTS_TOKEN.transferSelector;
+  const selector = ERC20_SELECTORS.transfer;
   // Encode recipient address (padded to 32 bytes)
   const paddedAddress = to.toLowerCase().replace('0x', '').padStart(64, '0');
   // Encode amount (padded to 32 bytes)
@@ -476,13 +625,15 @@ export async function estimateGas(params: { from: string; to: string; value: str
   // For token transfers, we need different params
   let txParams: { from: string; to: string; value: string; data?: string };
 
-  if (tokenType === 'GREEN_POINTS') {
+  if (TOKEN_CONFIG.isERC20(tokenType)) {
     // ERC-20 transfer: to is contract, value is 0, data is transfer call
-    const tokenAmount = greenPointsToRaw(params.value);
+    const contractAddress = TOKEN_CONFIG.getContractAddress(tokenType);
+    const decimals = TOKEN_CONFIG.getDecimals(tokenType);
+    const tokenAmount = tokenToRaw(params.value, decimals);
     const transferData = encodeErc20Transfer(params.to, tokenAmount);
     txParams = {
       from: params.from,
-      to: GREEN_POINTS_TOKEN.contractAddress,
+      to: contractAddress!,
       value: '0x0',
       data: transferData,
     };
@@ -511,7 +662,7 @@ export async function estimateGas(params: { from: string; to: string; value: str
   if (data.error) {
     // 如果估算失败，使用默认值
     console.warn('Gas 估算失败，使用默认值:', data.error);
-    return tokenType === 'GREEN_POINTS' ? BigInt(65000) : BigInt(21000);
+    return TOKEN_CONFIG.isERC20(tokenType) ? BigInt(65000) : BigInt(21000);
   }
   return BigInt(data.result);
 }
@@ -543,12 +694,14 @@ export async function prepareTransaction(params: TransactionParams): Promise<Pre
   let value: bigint;
   let data: string;
 
-  if (tokenType === 'GREEN_POINTS') {
+  if (TOKEN_CONFIG.isERC20(tokenType)) {
     // ERC-20 token transfer
     // To address is the contract, value is 0
     // Data is transfer(recipient, amount) encoded
-    const tokenAmount = greenPointsToRaw(params.value);
+    const contractAddress = TOKEN_CONFIG.getContractAddress(tokenType);
-    toAddress = GREEN_POINTS_TOKEN.contractAddress.toLowerCase();
+    const decimals = TOKEN_CONFIG.getDecimals(tokenType);
+    const tokenAmount = tokenToRaw(params.value, decimals);
+    toAddress = contractAddress!.toLowerCase();
     value = BigInt(0);
     data = encodeErc20Transfer(params.to, tokenAmount);
   } else {

backend/services/auth-service/prisma/migrations/0001_init/migration.sql

@@ -1,7 +1,6 @@
 -- ============================================================================
 -- auth-service 初始化 migration
--- 合并自: 20260111000000_init, 20260111083500_allow_nullable_phone_password,
+-- 合并自: 0001_init, 0002_add_transactional_idempotency
---         20260112110000_add_nickname_to_synced_legacy_users
 -- ============================================================================
 
 -- CreateEnum
@@ -241,3 +240,26 @@ ALTER TABLE "sms_logs" ADD CONSTRAINT "sms_logs_user_id_fkey" FOREIGN KEY ("user
 
 -- AddForeignKey
 ALTER TABLE "login_logs" ADD CONSTRAINT "login_logs_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- ============================================================================
+-- 事务性幂等消费支持 (从 0002_add_transactional_idempotency 合并)
+-- 用于 1.0 -> 2.0 CDC 同步的 100% exactly-once 语义
+-- ============================================================================
+
+-- CreateTable
+CREATE TABLE "processed_cdc_events" (
+    "id" BIGSERIAL NOT NULL,
+    "source_topic" TEXT NOT NULL,
+    "offset" BIGINT NOT NULL,
+    "table_name" TEXT NOT NULL,
+    "operation" TEXT NOT NULL,
+    "processed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "processed_cdc_events_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex (复合唯一索引保证幂等性)
+CREATE UNIQUE INDEX "processed_cdc_events_source_topic_offset_key" ON "processed_cdc_events"("source_topic", "offset");
+
+-- CreateIndex (时间索引用于清理旧数据)
+CREATE INDEX "processed_cdc_events_processed_at_idx" ON "processed_cdc_events"("processed_at");

backend/services/auth-service/prisma/migrations/0002_add_transactional_idempotency/migration.sql

@@ -1,25 +0,0 @@
--- ============================================================================
--- 添加事务性幂等消费支持
--- 用于 1.0 -> 2.0 CDC 同步的 100% exactly-once 语义
--- ============================================================================
-
--- 创建 processed_cdc_events 表（用于 CDC 事件幂等）
--- 唯一键: (source_topic, offset) - Kafka topic 名称 + 消息偏移量
--- 用于保证每个 CDC 事件只处理一次（exactly-once 语义）
-CREATE TABLE IF NOT EXISTS "processed_cdc_events" (
-    "id" BIGSERIAL NOT NULL,
-    "source_topic" VARCHAR(200) NOT NULL,  -- Kafka topic 名称（如 cdc.identity.public.user_accounts）
-    "offset" BIGINT NOT NULL,              -- Kafka 消息偏移量（在 partition 内唯一）
-    "table_name" VARCHAR(100) NOT NULL,    -- 源表名
-    "operation" VARCHAR(10) NOT NULL,      -- CDC 操作类型: c(create), u(update), d(delete), r(snapshot read)
-    "processed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-    CONSTRAINT "processed_cdc_events_pkey" PRIMARY KEY ("id")
-);
-
--- 复合唯一索引：(source_topic, offset) 保证幂等性
--- 注意：这不是数据库自增 ID，而是 Kafka 消息的唯一标识
-CREATE UNIQUE INDEX "processed_cdc_events_source_topic_offset_key" ON "processed_cdc_events"("source_topic", "offset");
-
--- 时间索引用于清理旧数据
-CREATE INDEX "processed_cdc_events_processed_at_idx" ON "processed_cdc_events"("processed_at");

backend/services/auth-service/src/api/controllers/password.controller.ts

@@ -22,7 +22,7 @@ class ChangePasswordDto {
   newPassword: string;
 }
 
-@Controller('password')
+@Controller('auth/password')
 @UseGuards(ThrottlerGuard)
 export class PasswordController {
   constructor(private readonly passwordService: PasswordService) {}

backend/services/auth-service/src/api/controllers/sms.controller.ts

@@ -21,7 +21,7 @@ class VerifySmsDto {
   type: 'REGISTER' | 'LOGIN' | 'RESET_PASSWORD' | 'CHANGE_PHONE';
 }
 
-@Controller('sms')
+@Controller('auth/sms')
 @UseGuards(ThrottlerGuard)
 export class SmsController {
   constructor(private readonly smsService: SmsService) {}

backend/services/auth-service/src/api/controllers/user.controller.ts

@@ -7,7 +7,7 @@ import { UserService, UserProfileResult } from '@/application/services';
 import { JwtAuthGuard } from '@/shared/guards/jwt-auth.guard';
 import { CurrentUser } from '@/shared/decorators/current-user.decorator';
 
-@Controller('user')
+@Controller('auth/user')
 @UseGuards(JwtAuthGuard)
 export class UserController {
   constructor(private readonly userService: UserService) {}

backend/services/auth-service/src/app.module.ts

@@ -9,7 +9,7 @@ import { InfrastructureModule } from './infrastructure/infrastructure.module';
     // 配置模块
     ConfigModule.forRoot({
       isGlobal: true,
-      envFilePath: ['.env.local', '.env'],
+      envFilePath: ['.env.local', '.env', '../.env'],
     }),
 
     // 限流模块

backend/services/blockchain-service/contracts/eUSDT/EnergyUSDT.sol

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.19;
+
+/**
+ * @title EnergyUSDT
+ * @dev Fixed supply ERC-20 token - NO MINTING CAPABILITY
+ * Total Supply: 10,002,000,000 (100.02 Billion) tokens with 6 decimals (matching USDT)
+ *
+ * IMPORTANT: This contract has NO mint function and NO way to increase supply.
+ * All tokens are minted to the deployer at construction time.
+ */
+contract EnergyUSDT {
+    string public constant name = "Energy USDT";
+    string public constant symbol = "eUSDT";
+    uint8 public constant decimals = 6;
+
+    // Fixed total supply: 100.02 billion tokens (10,002,000,000 * 10^6)
+    uint256 public constant totalSupply = 10_002_000_000 * 10**6;
+
+    mapping(address => uint256) private _balances;
+    mapping(address => mapping(address => uint256)) private _allowances;
+
+    event Transfer(address indexed from, address indexed to, uint256 value);
+    event Approval(address indexed owner, address indexed spender, uint256 value);
+
+    /**
+     * @dev Constructor - mints entire fixed supply to deployer
+     * No mint function exists - supply is permanently fixed
+     */
+    constructor() {
+        _balances[msg.sender] = totalSupply;
+        emit Transfer(address(0), msg.sender, totalSupply);
+    }
+
+    function balanceOf(address account) public view returns (uint256) {
+        return _balances[account];
+    }
+
+    function transfer(address to, uint256 amount) public returns (bool) {
+        require(to != address(0), "Transfer to zero address");
+        require(_balances[msg.sender] >= amount, "Insufficient balance");
+
+        unchecked {
+            _balances[msg.sender] -= amount;
+            _balances[to] += amount;
+        }
+
+        emit Transfer(msg.sender, to, amount);
+        return true;
+    }
+
+    function allowance(address owner, address spender) public view returns (uint256) {
+        return _allowances[owner][spender];
+    }
+
+    function approve(address spender, uint256 amount) public returns (bool) {
+        require(spender != address(0), "Approve to zero address");
+        _allowances[msg.sender][spender] = amount;
+        emit Approval(msg.sender, spender, amount);
+        return true;
+    }
+
+    function transferFrom(address from, address to, uint256 amount) public returns (bool) {
+        require(from != address(0), "Transfer from zero address");
+        require(to != address(0), "Transfer to zero address");
+        require(_balances[from] >= amount, "Insufficient balance");
+        require(_allowances[from][msg.sender] >= amount, "Insufficient allowance");
+
+        unchecked {
+            _balances[from] -= amount;
+            _balances[to] += amount;
+            _allowances[from][msg.sender] -= amount;
+        }
+
+        emit Transfer(from, to, amount);
+        return true;
+    }
+}

backend/services/blockchain-service/contracts/eUSDT/README.md

@@ -0,0 +1,81 @@
+# eUSDT (Energy USDT)
+
+## 代币信息
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | Energy USDT |
+| 符号 | eUSDT |
+| 精度 | 6 decimals |
+| 总供应量 | 10,002,000,000 (100.02亿) |
+| 标准 | ERC-20 |
+| 部署链 | KAVA Mainnet (Chain ID: 2222) |
+
+## 合约特性
+
+- **固定供应量**：100.02亿代币，部署时全部铸造给部署者
+- **不可增发**：合约中没有 mint 函数，供应量永久固定
+- **不可销毁**：合约层面无销毁功能
+- **不可升级**：合约逻辑永久固定
+- **标准ERC-20**：完全兼容所有主流钱包和DEX
+
+## 部署步骤
+
+### 1. 安装依赖
+
+```bash
+cd backend/services/blockchain-service/contracts/eUSDT
+npm install
+```
+
+### 2. 编译合约
+
+```bash
+node compile.mjs
+```
+
+编译后会在 `build/` 目录生成：
+- `EnergyUSDT.abi` - 合约ABI
+- `EnergyUSDT.bin` - 合约字节码
+
+### 3. 部署合约
+
+确保部署账户有足够的 KAVA 支付 gas 费（约 0.02 KAVA）。
+
+```bash
+node deploy.mjs
+```
+
+## 合约函数
+
+| 函数 | 说明 |
+|------|------|
+| `name()` | 返回 "Energy USDT" |
+| `symbol()` | 返回 "eUSDT" |
+| `decimals()` | 返回 6 |
+| `totalSupply()` | 返回 10,002,000,000 * 10^6 |
+| `balanceOf(address)` | 查询账户余额 |
+| `transfer(address, uint256)` | 转账 |
+| `approve(address, uint256)` | 授权额度 |
+| `transferFrom(address, address, uint256)` | 代理转账 |
+| `allowance(address, address)` | 查询授权额度 |
+
+## 事件
+
+| 事件 | 说明 |
+|------|------|
+| `Transfer(from, to, value)` | 转账事件 |
+| `Approval(owner, spender, value)` | 授权事件 |
+
+## 部署信息
+
+| 网络 | 合约地址 | 区块浏览器 |
+|------|---------|-----------|
+| KAVA Mainnet | `0x7C3275D808eFbAE90C06C7E3A9AfDdcAa8563931` | https://kavascan.com/address/0x7C3275D808eFbAE90C06C7E3A9AfDdcAa8563931 |
+
+**部署详情：**
+- 部署者/代币拥有者：`0x4F7E78d6B7C5FC502Ec7039848690f08c8970F1E`
+- 私钥：`0x886ea4cffe76c386fecf3ff321ac9ae913737c46c17bc6ce2413752144668a2a`
+- 初始持有量：10,002,000,000 eUSDT（全部代币）
+- 交易哈希：`0x5bebaa4a35378438ba5c891972024a1766935d2e01397a33502aa99e956a6b19`
+- 部署时间：2026-01-19

backend/services/blockchain-service/contracts/eUSDT/compile.mjs

@@ -0,0 +1,51 @@
+import solc from 'solc';
+import fs from 'fs';
+
+const source = fs.readFileSync('EnergyUSDT.sol', 'utf8');
+
+const input = {
+    language: 'Solidity',
+    sources: {
+        'EnergyUSDT.sol': {
+            content: source
+        }
+    },
+    settings: {
+        optimizer: {
+            enabled: true,
+            runs: 200
+        },
+        evmVersion: 'paris', // Use paris to avoid PUSH0
+        outputSelection: {
+            '*': {
+                '*': ['abi', 'evm.bytecode']
+            }
+        }
+    }
+};
+
+const output = JSON.parse(solc.compile(JSON.stringify(input)));
+
+if (output.errors) {
+    output.errors.forEach(err => {
+        console.log(err.formattedMessage);
+    });
+
+    // Check for actual errors (not just warnings)
+    const hasErrors = output.errors.some(err => err.severity === 'error');
+    if (hasErrors) {
+        process.exit(1);
+    }
+}
+
+const contract = output.contracts['EnergyUSDT.sol']['EnergyUSDT'];
+const bytecode = contract.evm.bytecode.object;
+const abi = contract.abi;
+
+fs.mkdirSync('build', { recursive: true });
+fs.writeFileSync('build/EnergyUSDT.bin', bytecode);
+fs.writeFileSync('build/EnergyUSDT.abi', JSON.stringify(abi, null, 2));
+
+console.log('Compiled successfully!');
+console.log('Bytecode length:', bytecode.length);
+console.log('ABI functions:', abi.filter(x => x.type === 'function').map(x => x.name).join(', '));

backend/services/blockchain-service/contracts/eUSDT/deploy.mjs

@@ -0,0 +1,86 @@
+import { ethers } from 'ethers';
+import fs from 'fs';
+
+// Same deployer account as dUSDT
+const PRIVATE_KEY = '0x886ea4cffe76c386fecf3ff321ac9ae913737c46c17bc6ce2413752144668a2a';
+const RPC_URL = 'https://evm.kava.io';
+
+// Contract bytecode
+const BYTECODE = '0x' + fs.readFileSync('build/EnergyUSDT.bin', 'utf8');
+const ABI = JSON.parse(fs.readFileSync('build/EnergyUSDT.abi', 'utf8'));
+
+async function deploy() {
+    // Connect to Kava mainnet
+    const provider = new ethers.JsonRpcProvider(RPC_URL);
+    const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
+
+    console.log('Deployer address:', wallet.address);
+
+    // Check balance
+    const balance = await provider.getBalance(wallet.address);
+    console.log('Balance:', ethers.formatEther(balance), 'KAVA');
+
+    if (parseFloat(ethers.formatEther(balance)) < 0.01) {
+        console.error('Insufficient KAVA balance for deployment!');
+        process.exit(1);
+    }
+
+    // Get network info
+    const network = await provider.getNetwork();
+    console.log('Chain ID:', network.chainId.toString());
+
+    // Create contract factory
+    const factory = new ethers.ContractFactory(ABI, BYTECODE, wallet);
+
+    console.log('Deploying EnergyUSDT (eUSDT) contract...');
+
+    // Deploy
+    const contract = await factory.deploy();
+    console.log('Transaction hash:', contract.deploymentTransaction().hash);
+
+    // Wait for deployment
+    console.log('Waiting for confirmation...');
+    await contract.waitForDeployment();
+
+    const contractAddress = await contract.getAddress();
+    console.log('Contract deployed at:', contractAddress);
+
+    // Verify deployment
+    console.log('\nVerifying deployment...');
+    const name = await contract.name();
+    const symbol = await contract.symbol();
+    const decimals = await contract.decimals();
+    const totalSupply = await contract.totalSupply();
+    const ownerBalance = await contract.balanceOf(wallet.address);
+
+    console.log('Token name:', name);
+    console.log('Token symbol:', symbol);
+    console.log('Decimals:', decimals.toString());
+    console.log('Total supply:', ethers.formatUnits(totalSupply, 6), 'eUSDT');
+    console.log('Owner balance:', ethers.formatUnits(ownerBalance, 6), 'eUSDT');
+
+    console.log('\n=== DEPLOYMENT COMPLETE ===');
+    console.log('Contract Address:', contractAddress);
+    console.log('Explorer:', `https://kavascan.com/address/${contractAddress}`);
+
+    // Save deployment info
+    const deploymentInfo = {
+        network: 'KAVA Mainnet',
+        chainId: 2222,
+        contractAddress,
+        deployer: wallet.address,
+        transactionHash: contract.deploymentTransaction().hash,
+        deployedAt: new Date().toISOString(),
+        token: {
+            name,
+            symbol,
+            decimals: decimals.toString(),
+            totalSupply: totalSupply.toString()
+        }
+    };
+
+    fs.writeFileSync('deployment.json', JSON.stringify(deploymentInfo, null, 2));
+    console.log('\nDeployment info saved to deployment.json');
+}
+
+deploy().catch(console.error);

backend/services/blockchain-service/contracts/eUSDT/deployment.json

@@ -0,0 +1,14 @@
+{
+  "network": "KAVA Mainnet",
+  "chainId": 2222,
+  "contractAddress": "0x7C3275D808eFbAE90C06C7E3A9AfDdcAa8563931",
+  "deployer": "0x4F7E78d6B7C5FC502Ec7039848690f08c8970F1E",
+  "transactionHash": "0x5bebaa4a35378438ba5c891972024a1766935d2e01397a33502aa99e956a6b19",
+  "deployedAt": "2026-01-19T13:25:28.071Z",
+  "token": {
+    "name": "Energy USDT",
+    "symbol": "eUSDT",
+    "decimals": "6",
+    "totalSupply": "10002000000000000"
+  }
+}

backend/services/blockchain-service/contracts/eUSDT/package-lock.json

@@ -0,0 +1,222 @@
+{
+  "name": "eusdt-contract",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "eusdt-contract",
+      "version": "1.0.0",
+      "dependencies": {
+        "ethers": "^6.9.0",
+        "solc": "^0.8.19"
+      }
+    },
+    "node_modules/@adraffy/ens-normalize": {
+      "version": "1.10.1",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz",
+      "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==",
+      "license": "MIT"
+    },
+    "node_modules/@noble/curves": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz",
+      "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==",
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.3.2"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz",
+      "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.7.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz",
+      "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==",
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.19.2"
+      }
+    },
+    "node_modules/aes-js": {
+      "version": "4.0.0-beta.5",
+      "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz",
+      "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==",
+      "license": "MIT"
+    },
+    "node_modules/command-exists": {
+      "version": "1.2.9",
+      "resolved": "https://registry.npmjs.org/command-exists/-/command-exists-1.2.9.tgz",
+      "integrity": "sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==",
+      "license": "MIT"
+    },
+    "node_modules/commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/ethers": {
+      "version": "6.16.0",
+      "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.16.0.tgz",
+      "integrity": "sha512-U1wulmetNymijEhpSEQ7Ct/P/Jw9/e7R1j5XIbPRydgV2DjLVMsULDlNksq3RQnFgKoLlZf88ijYtWEXcPa07A==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/ethers-io/"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@adraffy/ens-normalize": "1.10.1",
+        "@noble/curves": "1.2.0",
+        "@noble/hashes": "1.3.2",
+        "@types/node": "22.7.5",
+        "aes-js": "4.0.0-beta.5",
+        "tslib": "2.7.0",
+        "ws": "8.17.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.15.11",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
+      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/js-sha3": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/js-sha3/-/js-sha3-0.8.0.tgz",
+      "integrity": "sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==",
+      "license": "MIT"
+    },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/solc": {
+      "version": "0.8.19",
+      "resolved": "https://registry.npmjs.org/solc/-/solc-0.8.19.tgz",
+      "integrity": "sha512-yqurS3wzC4LdEvmMobODXqprV4MYJcVtinuxgrp61ac8K2zz40vXA0eSAskSHPgv8dQo7Nux39i3QBsHx4pqyA==",
+      "license": "MIT",
+      "dependencies": {
+        "command-exists": "^1.2.8",
+        "commander": "^8.1.0",
+        "follow-redirects": "^1.12.1",
+        "js-sha3": "0.8.0",
+        "memorystream": "^0.3.1",
+        "semver": "^5.5.0",
+        "tmp": "0.0.33"
+      },
+      "bin": {
+        "solcjs": "solc.js"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/tmp": {
+      "version": "0.0.33",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
+      "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==",
+      "license": "MIT",
+      "dependencies": {
+        "os-tmpdir": "~1.0.2"
+      },
+      "engines": {
+        "node": ">=0.6.0"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
+      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
+      "license": "0BSD"
+    },
+    "node_modules/undici-types": {
+      "version": "6.19.8",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
+      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+      "license": "MIT"
+    },
+    "node_modules/ws": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+      "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

backend/services/blockchain-service/contracts/eUSDT/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "eusdt-contract",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Energy USDT (eUSDT) ERC-20 Token Contract",
+  "scripts": {
+    "compile": "node compile.mjs",
+    "deploy": "node deploy.mjs"
+  },
+  "dependencies": {
+    "ethers": "^6.9.0",
+    "solc": "^0.8.19"
+  }
+}

backend/services/blockchain-service/contracts/fUSDT/FutureUSDT.sol

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.19;
+
+/**
+ * @title FutureUSDT
+ * @dev Fixed supply ERC-20 token - NO MINTING CAPABILITY
+ * Total Supply: 1,000,000,000,000 (1 Trillion) tokens with 6 decimals (matching USDT)
+ *
+ * IMPORTANT: This contract has NO mint function and NO way to increase supply.
+ * All tokens are minted to the deployer at construction time.
+ */
+contract FutureUSDT {
+    string public constant name = "Future USDT";
+    string public constant symbol = "fUSDT";
+    uint8 public constant decimals = 6;
+
+    // Fixed total supply: 1 trillion tokens (1,000,000,000,000 * 10^6)
+    uint256 public constant totalSupply = 1_000_000_000_000 * 10**6;
+
+    mapping(address => uint256) private _balances;
+    mapping(address => mapping(address => uint256)) private _allowances;
+
+    event Transfer(address indexed from, address indexed to, uint256 value);
+    event Approval(address indexed owner, address indexed spender, uint256 value);
+
+    /**
+     * @dev Constructor - mints entire fixed supply to deployer
+     * No mint function exists - supply is permanently fixed
+     */
+    constructor() {
+        _balances[msg.sender] = totalSupply;
+        emit Transfer(address(0), msg.sender, totalSupply);
+    }
+
+    function balanceOf(address account) public view returns (uint256) {
+        return _balances[account];
+    }
+
+    function transfer(address to, uint256 amount) public returns (bool) {
+        require(to != address(0), "Transfer to zero address");
+        require(_balances[msg.sender] >= amount, "Insufficient balance");
+
+        unchecked {
+            _balances[msg.sender] -= amount;
+            _balances[to] += amount;
+        }
+
+        emit Transfer(msg.sender, to, amount);
+        return true;
+    }
+
+    function allowance(address owner, address spender) public view returns (uint256) {
+        return _allowances[owner][spender];
+    }
+
+    function approve(address spender, uint256 amount) public returns (bool) {
+        require(spender != address(0), "Approve to zero address");
+        _allowances[msg.sender][spender] = amount;
+        emit Approval(msg.sender, spender, amount);
+        return true;
+    }
+
+    function transferFrom(address from, address to, uint256 amount) public returns (bool) {
+        require(from != address(0), "Transfer from zero address");
+        require(to != address(0), "Transfer to zero address");
+        require(_balances[from] >= amount, "Insufficient balance");
+        require(_allowances[from][msg.sender] >= amount, "Insufficient allowance");
+
+        unchecked {
+            _balances[from] -= amount;
+            _balances[to] += amount;
+            _allowances[from][msg.sender] -= amount;
+        }
+
+        emit Transfer(from, to, amount);
+        return true;
+    }
+}

backend/services/blockchain-service/contracts/fUSDT/README.md

@@ -0,0 +1,81 @@
+# fUSDT (Future USDT)
+
+## 代币信息
+
+| 属性 | 值 |
+|------|-----|
+| 名称 | Future USDT |
+| 符号 | fUSDT |
+| 精度 | 6 decimals |
+| 总供应量 | 1,000,000,000,000 (1万亿) |
+| 标准 | ERC-20 |
+| 部署链 | KAVA Mainnet (Chain ID: 2222) |
+
+## 合约特性
+
+- **固定供应量**：1万亿代币，部署时全部铸造给部署者
+- **不可增发**：合约中没有 mint 函数，供应量永久固定
+- **不可销毁**：合约层面无销毁功能
+- **不可升级**：合约逻辑永久固定
+- **标准ERC-20**：完全兼容所有主流钱包和DEX
+
+## 部署步骤
+
+### 1. 安装依赖
+
+```bash
+cd backend/services/blockchain-service/contracts/fUSDT
+npm install
+```
+
+### 2. 编译合约
+
+```bash
+node compile.mjs
+```
+
+编译后会在 `build/` 目录生成：
+- `FutureUSDT.abi` - 合约ABI
+- `FutureUSDT.bin` - 合约字节码
+
+### 3. 部署合约
+
+确保部署账户有足够的 KAVA 支付 gas 费（约 0.02 KAVA）。
+
+```bash
+node deploy.mjs
+```
+
+## 合约函数
+
+| 函数 | 说明 |
+|------|------|
+| `name()` | 返回 "Future USDT" |
+| `symbol()` | 返回 "fUSDT" |
+| `decimals()` | 返回 6 |
+| `totalSupply()` | 返回 1,000,000,000,000 * 10^6 |
+| `balanceOf(address)` | 查询账户余额 |
+| `transfer(address, uint256)` | 转账 |
+| `approve(address, uint256)` | 授权额度 |
+| `transferFrom(address, address, uint256)` | 代理转账 |
+| `allowance(address, address)` | 查询授权额度 |
+
+## 事件
+
+| 事件 | 说明 |
+|------|------|
+| `Transfer(from, to, value)` | 转账事件 |
+| `Approval(owner, spender, value)` | 授权事件 |
+
+## 部署信息
+
+| 网络 | 合约地址 | 区块浏览器 |
+|------|---------|-----------|
+| KAVA Mainnet | `0x14dc4f7d3E4197438d058C3D156dd9826A161134` | https://kavascan.com/address/0x14dc4f7d3E4197438d058C3D156dd9826A161134 |
+
+**部署详情：**
+- 部署者/代币拥有者：`0x4F7E78d6B7C5FC502Ec7039848690f08c8970F1E`
+- 私钥：`0x886ea4cffe76c386fecf3ff321ac9ae913737c46c17bc6ce2413752144668a2a`
+- 初始持有量：1,000,000,000,000 fUSDT（全部代币）
+- 交易哈希：`0x071f535971bc3a134dd26c182b6f05c53f0c3783e91fe6ef471d6c914e4cdb06`
+- 部署时间：2026-01-19

backend/services/blockchain-service/contracts/fUSDT/compile.mjs

@@ -0,0 +1,51 @@
+import solc from 'solc';
+import fs from 'fs';
+
+const source = fs.readFileSync('FutureUSDT.sol', 'utf8');
+
+const input = {
+    language: 'Solidity',
+    sources: {
+        'FutureUSDT.sol': {
+            content: source
+        }
+    },
+    settings: {
+        optimizer: {
+            enabled: true,
+            runs: 200
+        },
+        evmVersion: 'paris', // Use paris to avoid PUSH0
+        outputSelection: {
+            '*': {
+                '*': ['abi', 'evm.bytecode']
+            }
+        }
+    }
+};
+
+const output = JSON.parse(solc.compile(JSON.stringify(input)));
+
+if (output.errors) {
+    output.errors.forEach(err => {
+        console.log(err.formattedMessage);
+    });
+
+    // Check for actual errors (not just warnings)
+    const hasErrors = output.errors.some(err => err.severity === 'error');
+    if (hasErrors) {
+        process.exit(1);
+    }
+}
+
+const contract = output.contracts['FutureUSDT.sol']['FutureUSDT'];
+const bytecode = contract.evm.bytecode.object;
+const abi = contract.abi;
+
+fs.mkdirSync('build', { recursive: true });
+fs.writeFileSync('build/FutureUSDT.bin', bytecode);
+fs.writeFileSync('build/FutureUSDT.abi', JSON.stringify(abi, null, 2));
+
+console.log('Compiled successfully!');
+console.log('Bytecode length:', bytecode.length);
+console.log('ABI functions:', abi.filter(x => x.type === 'function').map(x => x.name).join(', '));

backend/services/blockchain-service/contracts/fUSDT/deploy.mjs

@@ -0,0 +1,86 @@
+import { ethers } from 'ethers';
+import fs from 'fs';
+
+// Same deployer account as dUSDT
+const PRIVATE_KEY = '0x886ea4cffe76c386fecf3ff321ac9ae913737c46c17bc6ce2413752144668a2a';
+const RPC_URL = 'https://evm.kava.io';
+
+// Contract bytecode
+const BYTECODE = '0x' + fs.readFileSync('build/FutureUSDT.bin', 'utf8');
+const ABI = JSON.parse(fs.readFileSync('build/FutureUSDT.abi', 'utf8'));
+
+async function deploy() {
+    // Connect to Kava mainnet
+    const provider = new ethers.JsonRpcProvider(RPC_URL);
+    const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
+
+    console.log('Deployer address:', wallet.address);
+
+    // Check balance
+    const balance = await provider.getBalance(wallet.address);
+    console.log('Balance:', ethers.formatEther(balance), 'KAVA');
+
+    if (parseFloat(ethers.formatEther(balance)) < 0.01) {
+        console.error('Insufficient KAVA balance for deployment!');
+        process.exit(1);
+    }
+
+    // Get network info
+    const network = await provider.getNetwork();
+    console.log('Chain ID:', network.chainId.toString());
+
+    // Create contract factory
+    const factory = new ethers.ContractFactory(ABI, BYTECODE, wallet);
+
+    console.log('Deploying FutureUSDT (fUSDT) contract...');
+
+    // Deploy
+    const contract = await factory.deploy();
+    console.log('Transaction hash:', contract.deploymentTransaction().hash);
+
+    // Wait for deployment
+    console.log('Waiting for confirmation...');
+    await contract.waitForDeployment();
+
+    const contractAddress = await contract.getAddress();
+    console.log('Contract deployed at:', contractAddress);
+
+    // Verify deployment
+    console.log('\nVerifying deployment...');
+    const name = await contract.name();
+    const symbol = await contract.symbol();
+    const decimals = await contract.decimals();
+    const totalSupply = await contract.totalSupply();
+    const ownerBalance = await contract.balanceOf(wallet.address);
+
+    console.log('Token name:', name);
+    console.log('Token symbol:', symbol);
+    console.log('Decimals:', decimals.toString());
+    console.log('Total supply:', ethers.formatUnits(totalSupply, 6), 'fUSDT');
+    console.log('Owner balance:', ethers.formatUnits(ownerBalance, 6), 'fUSDT');
+
+    console.log('\n=== DEPLOYMENT COMPLETE ===');
+    console.log('Contract Address:', contractAddress);
+    console.log('Explorer:', `https://kavascan.com/address/${contractAddress}`);
+
+    // Save deployment info
+    const deploymentInfo = {
+        network: 'KAVA Mainnet',
+        chainId: 2222,
+        contractAddress,
+        deployer: wallet.address,
+        transactionHash: contract.deploymentTransaction().hash,
+        deployedAt: new Date().toISOString(),
+        token: {
+            name,
+            symbol,
+            decimals: decimals.toString(),
+            totalSupply: totalSupply.toString()
+        }
+    };
+
+    fs.writeFileSync('deployment.json', JSON.stringify(deploymentInfo, null, 2));
+    console.log('\nDeployment info saved to deployment.json');
+}
+
+deploy().catch(console.error);

backend/services/blockchain-service/contracts/fUSDT/deployment.json

@@ -0,0 +1,14 @@
+{
+  "network": "KAVA Mainnet",
+  "chainId": 2222,
+  "contractAddress": "0x14dc4f7d3E4197438d058C3D156dd9826A161134",
+  "deployer": "0x4F7E78d6B7C5FC502Ec7039848690f08c8970F1E",
+  "transactionHash": "0x071f535971bc3a134dd26c182b6f05c53f0c3783e91fe6ef471d6c914e4cdb06",
+  "deployedAt": "2026-01-19T13:26:05.111Z",
+  "token": {
+    "name": "Future USDT",
+    "symbol": "fUSDT",
+    "decimals": "6",
+    "totalSupply": "1000000000000000000"
+  }
+}

backend/services/blockchain-service/contracts/fUSDT/package-lock.json

@@ -0,0 +1,222 @@
+{
+  "name": "fusdt-contract",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "fusdt-contract",
+      "version": "1.0.0",
+      "dependencies": {
+        "ethers": "^6.9.0",
+        "solc": "^0.8.19"
+      }
+    },
+    "node_modules/@adraffy/ens-normalize": {
+      "version": "1.10.1",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz",
+      "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==",
+      "license": "MIT"
+    },
+    "node_modules/@noble/curves": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz",
+      "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==",
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.3.2"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz",
+      "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.7.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz",
+      "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==",
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.19.2"
+      }
+    },
+    "node_modules/aes-js": {
+      "version": "4.0.0-beta.5",
+      "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz",
+      "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==",
+      "license": "MIT"
+    },
+    "node_modules/command-exists": {
+      "version": "1.2.9",
+      "resolved": "https://registry.npmjs.org/command-exists/-/command-exists-1.2.9.tgz",
+      "integrity": "sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==",
+      "license": "MIT"
+    },
+    "node_modules/commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/ethers": {
+      "version": "6.16.0",
+      "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.16.0.tgz",
+      "integrity": "sha512-U1wulmetNymijEhpSEQ7Ct/P/Jw9/e7R1j5XIbPRydgV2DjLVMsULDlNksq3RQnFgKoLlZf88ijYtWEXcPa07A==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/ethers-io/"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@adraffy/ens-normalize": "1.10.1",
+        "@noble/curves": "1.2.0",
+        "@noble/hashes": "1.3.2",
+        "@types/node": "22.7.5",
+        "aes-js": "4.0.0-beta.5",
+        "tslib": "2.7.0",
+        "ws": "8.17.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.15.11",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
+      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/js-sha3": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/js-sha3/-/js-sha3-0.8.0.tgz",
+      "integrity": "sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==",
+      "license": "MIT"
+    },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/solc": {
+      "version": "0.8.19",
+      "resolved": "https://registry.npmjs.org/solc/-/solc-0.8.19.tgz",
+      "integrity": "sha512-yqurS3wzC4LdEvmMobODXqprV4MYJcVtinuxgrp61ac8K2zz40vXA0eSAskSHPgv8dQo7Nux39i3QBsHx4pqyA==",
+      "license": "MIT",
+      "dependencies": {
+        "command-exists": "^1.2.8",
+        "commander": "^8.1.0",
+        "follow-redirects": "^1.12.1",
+        "js-sha3": "0.8.0",
+        "memorystream": "^0.3.1",
+        "semver": "^5.5.0",
+        "tmp": "0.0.33"
+      },
+      "bin": {
+        "solcjs": "solc.js"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/tmp": {
+      "version": "0.0.33",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
+      "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==",
+      "license": "MIT",
+      "dependencies": {
+        "os-tmpdir": "~1.0.2"
+      },
+      "engines": {
+        "node": ">=0.6.0"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
+      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
+      "license": "0BSD"
+    },
+    "node_modules/undici-types": {
+      "version": "6.19.8",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
+      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+      "license": "MIT"
+    },
+    "node_modules/ws": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+      "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

backend/services/blockchain-service/contracts/fUSDT/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "fusdt-contract",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Future USDT (fUSDT) ERC-20 Token Contract",
+  "scripts": {
+    "compile": "node compile.mjs",
+    "deploy": "node deploy.mjs"
+  },
+  "dependencies": {
+    "ethers": "^6.9.0",
+    "solc": "^0.8.19"
+  }
+}

backend/services/contribution-service/prisma/migrations/0001_init/migration.sql

@@ -1,7 +1,6 @@
 -- ============================================================================
 -- contribution-service 初始化 migration
--- 合并自: 20260111000000_init, 20260111100000_add_referral_user_ids,
+-- 合并自: 0001_init, 0002_add_transactional_idempotency, 20250120000001_add_region_to_system_accounts
---         20260112020000_fix_status_varchar_length, 20260112200000_add_adoption_province_city
 -- ============================================================================
 
 -- ============================================
@@ -228,8 +227,9 @@ CREATE INDEX "unallocated_contributions_status_idx" ON "unallocated_contribution
 
 CREATE TABLE "system_accounts" (
     "id" BIGSERIAL NOT NULL,
-    "account_type" VARCHAR(20) NOT NULL,
+    "account_type" TEXT NOT NULL,
-    "name" VARCHAR(100) NOT NULL,
+    "region_code" TEXT,
+    "name" TEXT NOT NULL,
     "contribution_balance" DECIMAL(30,10) NOT NULL DEFAULT 0,
     "contribution_never_expires" BOOLEAN NOT NULL DEFAULT false,
     "version" INTEGER NOT NULL DEFAULT 1,
@@ -239,18 +239,26 @@ CREATE TABLE "system_accounts" (
     CONSTRAINT "system_accounts_pkey" PRIMARY KEY ("id")
 );
 
-CREATE UNIQUE INDEX "system_accounts_account_type_key" ON "system_accounts"("account_type");
+CREATE UNIQUE INDEX "system_accounts_account_type_region_code_key" ON "system_accounts"("account_type", "region_code");
+CREATE INDEX "system_accounts_account_type_idx" ON "system_accounts"("account_type");
+CREATE INDEX "system_accounts_region_code_idx" ON "system_accounts"("region_code");
 
 CREATE TABLE "system_contribution_records" (
     "id" BIGSERIAL NOT NULL,
     "system_account_id" BIGINT NOT NULL,
     "source_adoption_id" BIGINT NOT NULL,
     "source_account_sequence" VARCHAR(20) NOT NULL,
+    -- 来源类型: FIXED_RATE(固定比例) / LEVEL_OVERFLOW(层级溢出) / LEVEL_NO_ANCESTOR(无上线) / BONUS_TIER_1/2/3(团队奖励未解锁)
+    "source_type" VARCHAR(30) NOT NULL,
+    -- 层级深度（1-15），仅对 LEVEL_OVERFLOW 和 LEVEL_NO_ANCESTOR 类型有效
+    "level_depth" INTEGER,
     "distribution_rate" DECIMAL(10,6) NOT NULL,
     "amount" DECIMAL(30,10) NOT NULL,
     "effective_date" DATE NOT NULL,
     "expire_date" DATE,
     "is_expired" BOOLEAN NOT NULL DEFAULT false,
+    -- 软删除时间戳
+    "deleted_at" TIMESTAMP(3),
     "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
 
     CONSTRAINT "system_contribution_records_pkey" PRIMARY KEY ("id")
@@ -258,6 +266,8 @@ CREATE TABLE "system_contribution_records" (
 
 CREATE INDEX "system_contribution_records_system_account_id_idx" ON "system_contribution_records"("system_account_id");
 CREATE INDEX "system_contribution_records_source_adoption_id_idx" ON "system_contribution_records"("source_adoption_id");
+CREATE INDEX "system_contribution_records_source_type_idx" ON "system_contribution_records"("source_type");
+CREATE INDEX "system_contribution_records_deleted_at_idx" ON "system_contribution_records"("deleted_at");
 
 ALTER TABLE "system_contribution_records" ADD CONSTRAINT "system_contribution_records_system_account_id_fkey" FOREIGN KEY ("system_account_id") REFERENCES "system_accounts"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
 
@@ -327,20 +337,36 @@ CREATE TABLE "cdc_sync_progress" (
 
 CREATE UNIQUE INDEX "cdc_sync_progress_source_topic_key" ON "cdc_sync_progress"("source_topic");
 
+-- 2.0 服务间 Outbox 事件幂等表
 CREATE TABLE "processed_events" (
     "id" BIGSERIAL NOT NULL,
     "event_id" VARCHAR(100) NOT NULL,
     "event_type" VARCHAR(50) NOT NULL,
-    "source_service" VARCHAR(50),
+    "source_service" VARCHAR(100) NOT NULL,
     "processed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
 
     CONSTRAINT "processed_events_pkey" PRIMARY KEY ("id")
 );
 
-CREATE UNIQUE INDEX "processed_events_event_id_key" ON "processed_events"("event_id");
+CREATE UNIQUE INDEX "processed_events_source_service_event_id_key" ON "processed_events"("source_service", "event_id");
 CREATE INDEX "processed_events_event_type_idx" ON "processed_events"("event_type");
 CREATE INDEX "processed_events_processed_at_idx" ON "processed_events"("processed_at");
 
+-- 1.0 CDC 事件幂等表
+CREATE TABLE "processed_cdc_events" (
+    "id" BIGSERIAL NOT NULL,
+    "source_topic" VARCHAR(200) NOT NULL,
+    "offset" BIGINT NOT NULL,
+    "table_name" VARCHAR(100) NOT NULL,
+    "operation" VARCHAR(10) NOT NULL,
+    "processed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "processed_cdc_events_pkey" PRIMARY KEY ("id")
+);
+
+CREATE UNIQUE INDEX "processed_cdc_events_source_topic_offset_key" ON "processed_cdc_events"("source_topic", "offset");
+CREATE INDEX "processed_cdc_events_processed_at_idx" ON "processed_cdc_events"("processed_at");
+
 -- ============================================
 -- 9. 配置表
 -- ============================================

backend/services/contribution-service/prisma/migrations/0002_add_transactional_idempotency/migration.sql

@@ -1,45 +0,0 @@
--- ============================================================================
--- 添加事务性幂等消费支持
--- 用于 1.0 -> 2.0 CDC 同步的 100% exactly-once 语义
--- ============================================================================
-
--- 1. 创建 processed_cdc_events 表（用于 CDC 事件幂等）
--- 唯一键: (source_topic, offset) - Kafka topic 名称 + 消息偏移量
--- 用于保证每个 CDC 事件只处理一次（exactly-once 语义）
-CREATE TABLE IF NOT EXISTS "processed_cdc_events" (
-    "id" BIGSERIAL NOT NULL,
-    "source_topic" VARCHAR(200) NOT NULL,  -- Kafka topic 名称（如 cdc.identity.public.user_accounts）
-    "offset" BIGINT NOT NULL,              -- Kafka 消息偏移量（在 partition 内唯一）
-    "table_name" VARCHAR(100) NOT NULL,    -- 源表名
-    "operation" VARCHAR(10) NOT NULL,      -- CDC 操作类型: c(create), u(update), d(delete), r(snapshot read)
-    "processed_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
-
-    CONSTRAINT "processed_cdc_events_pkey" PRIMARY KEY ("id")
-);
-
--- 复合唯一索引：(source_topic, offset) 保证幂等性
--- 注意：这不是数据库自增 ID，而是 Kafka 消息的唯一标识
-CREATE UNIQUE INDEX "processed_cdc_events_source_topic_offset_key" ON "processed_cdc_events"("source_topic", "offset");
-
--- 时间索引用于清理旧数据
-CREATE INDEX "processed_cdc_events_processed_at_idx" ON "processed_cdc_events"("processed_at");
-
--- 2. 修复 processed_events 表（用于 2.0 服务间 Outbox 事件幂等）
--- 唯一键: (source_service, event_id) - 服务名 + outbox 表的 ID
--- 不同服务的 outbox ID 可能相同，所以需要组合服务名作为复合唯一键
-
--- 2.1 修改 source_service 列：扩展长度 50->100，且设为 NOT NULL
--- 先为已有 NULL 值设置默认值
-UPDATE "processed_events" SET "source_service" = 'unknown' WHERE "source_service" IS NULL;
-
--- 修改列类型和约束
-ALTER TABLE "processed_events"
-    ALTER COLUMN "source_service" SET NOT NULL,
-    ALTER COLUMN "source_service" TYPE VARCHAR(100);
-
--- 2.2 删除旧的单字段唯一索引
-DROP INDEX IF EXISTS "processed_events_event_id_key";
-
--- 2.3 创建新的复合唯一索引
--- 索引名使用蛇形命名以与列名保持一致
-CREATE UNIQUE INDEX IF NOT EXISTS "processed_events_source_service_event_id_key" ON "processed_events"("source_service", "event_id");

backend/services/contribution-service/prisma/schema.prisma

@@ -299,9 +299,10 @@ model UnallocatedContribution {
 
 // 系统账户（运营/省/市/总部）
 model SystemAccount {
-  id          BigInt @id @default(autoincrement())
+  id          BigInt  @id @default(autoincrement())
-  accountType String @unique @map("account_type") @db.VarChar(20) // OPERATION / PROVINCE / CITY / HEADQUARTERS
+  accountType String  @map("account_type") // OPERATION / PROVINCE / CITY / HEADQUARTERS
-  name        String @db.VarChar(100)
+  regionCode  String? @map("region_code") // 省/市代码，如 440000, 440100
+  name        String
 
   contributionBalance      Decimal @default(0) @map("contribution_balance") @db.Decimal(30, 10)
   contributionNeverExpires Boolean @default(false) @map("contribution_never_expires")
@@ -313,6 +314,9 @@ model SystemAccount {
 
   records SystemContributionRecord[]
 
+  @@unique([accountType, regionCode])
+  @@index([accountType])
+  @@index([regionCode])
   @@map("system_accounts")
 }
 
@@ -323,6 +327,11 @@ model SystemContributionRecord {
   sourceAdoptionId      BigInt @map("source_adoption_id")
   sourceAccountSequence String @map("source_account_sequence") @db.VarChar(20)
 
+  // 来源类型：FIXED_RATE(固定比例分配) / LEVEL_OVERFLOW(层级溢出) / LEVEL_NO_ANCESTOR(无上线) / BONUS_TIER_1/2/3(团队奖励未解锁)
+  sourceType  String  @map("source_type") @db.VarChar(30)
+  // 层级深度：对于 LEVEL_OVERFLOW 和 LEVEL_NO_ANCESTOR 类型，表示第几级（1-15）
+  levelDepth  Int?    @map("level_depth")
+
   distributionRate Decimal @map("distribution_rate") @db.Decimal(10, 6)
   amount           Decimal @map("amount") @db.Decimal(30, 10)
 
@@ -330,12 +339,15 @@ model SystemContributionRecord {
   expireDate    DateTime? @map("expire_date") @db.Date
   isExpired     Boolean   @default(false) @map("is_expired")
 
-  createdAt DateTime @default(now()) @map("created_at")
+  createdAt DateTime  @default(now()) @map("created_at")
+  deletedAt DateTime? @map("deleted_at") // 软删除标记
 
   systemAccount SystemAccount @relation(fields: [systemAccountId], references: [id])
 
   @@index([systemAccountId])
   @@index([sourceAdoptionId])
+  @@index([deletedAt])
+  @@index([sourceType])
   @@map("system_contribution_records")
 }
 

backend/services/contribution-service/src/api/controllers/admin.controller.ts

@@ -10,6 +10,8 @@ import {
   AdoptionSyncedEvent,
   ContributionRecordSyncedEvent,
   NetworkProgressUpdatedEvent,
+  SystemAccountSyncedEvent,
+  UnallocatedContributionSyncedEvent,
 } from '../../domain/events';
 import { Public } from '../../shared/guards/jwt-auth.guard';
 
@@ -420,4 +422,190 @@ export class AdminController {
       };
     }
   }
+
+  @Post('system-accounts/publish-all')
+  @Public()
+  @ApiOperation({ summary: '发布所有系统账户算力事件到 outbox，用于同步到 mining-service' })
+  async publishAllSystemAccounts(): Promise<{
+    success: boolean;
+    publishedCount: number;
+    message: string;
+  }> {
+    try {
+      const systemAccounts = await this.prisma.systemAccount.findMany();
+
+      await this.unitOfWork.executeInTransaction(async () => {
+        const events = systemAccounts.map((account) => {
+          const event = new SystemAccountSyncedEvent(
+            account.accountType,
+            account.regionCode,
+            account.name,
+            account.contributionBalance.toString(),
+            account.createdAt,
+          );
+
+          return {
+            aggregateType: SystemAccountSyncedEvent.AGGREGATE_TYPE,
+            aggregateId: `${account.accountType}:${account.regionCode || 'null'}`,
+            eventType: SystemAccountSyncedEvent.EVENT_TYPE,
+            payload: event.toPayload(),
+          };
+        });
+
+        await this.outboxRepository.saveMany(events);
+      });
+
+      this.logger.log(`Published ${systemAccounts.length} system account events`);
+
+      return {
+        success: true,
+        publishedCount: systemAccounts.length,
+        message: `Published ${systemAccounts.length} system account events`,
+      };
+    } catch (error) {
+      this.logger.error('Failed to publish system accounts', error);
+      return {
+        success: false,
+        publishedCount: 0,
+        message: `Failed: ${error.message}`,
+      };
+    }
+  }
+
+  @Get('system-accounts')
+  @Public()
+  @ApiOperation({ summary: '获取所有系统账户算力' })
+  async getSystemAccounts() {
+    const systemAccounts = await this.prisma.systemAccount.findMany();
+
+    return {
+      accounts: systemAccounts.map((a) => ({
+        accountType: a.accountType,
+        name: a.name,
+        contributionBalance: a.contributionBalance.toString(),
+        createdAt: a.createdAt,
+        updatedAt: a.updatedAt,
+      })),
+      total: systemAccounts.length,
+    };
+  }
+
+  @Get('unallocated-contributions')
+  @Public()
+  @ApiOperation({ summary: '获取所有未分配算力列表，供 mining-service 定时同步' })
+  async getUnallocatedContributions(): Promise<{
+    contributions: Array<{
+      sourceAdoptionId: string;
+      sourceAccountSequence: string;
+      wouldBeAccountSequence: string | null;
+      contributionType: string;
+      amount: string;
+      reason: string | null;
+      effectiveDate: string;
+      expireDate: string;
+    }>;
+    total: number;
+  }> {
+    const unallocatedContributions = await this.prisma.unallocatedContribution.findMany({
+      where: { status: 'PENDING' },
+      select: {
+        sourceAdoptionId: true,
+        sourceAccountSequence: true,
+        wouldBeAccountSequence: true,
+        unallocType: true,
+        amount: true,
+        reason: true,
+        effectiveDate: true,
+        expireDate: true,
+      },
+    });
+
+    return {
+      contributions: unallocatedContributions.map((uc) => ({
+        sourceAdoptionId: uc.sourceAdoptionId.toString(),
+        sourceAccountSequence: uc.sourceAccountSequence,
+        wouldBeAccountSequence: uc.wouldBeAccountSequence,
+        contributionType: uc.unallocType,
+        amount: uc.amount.toString(),
+        reason: uc.reason,
+        effectiveDate: uc.effectiveDate.toISOString(),
+        expireDate: uc.expireDate.toISOString(),
+      })),
+      total: unallocatedContributions.length,
+    };
+  }
+
+  @Post('unallocated-contributions/publish-all')
+  @Public()
+  @ApiOperation({ summary: '发布所有未分配算力事件到 outbox，用于同步到 mining-service' })
+  async publishAllUnallocatedContributions(): Promise<{
+    success: boolean;
+    publishedCount: number;
+    failedCount: number;
+    message: string;
+  }> {
+    const unallocatedContributions = await this.prisma.unallocatedContribution.findMany({
+      where: { status: 'PENDING' },
+      select: {
+        id: true,
+        sourceAdoptionId: true,
+        sourceAccountSequence: true,
+        wouldBeAccountSequence: true,
+        unallocType: true,
+        amount: true,
+        reason: true,
+        effectiveDate: true,
+        expireDate: true,
+      },
+    });
+
+    let publishedCount = 0;
+    let failedCount = 0;
+
+    const batchSize = 100;
+    for (let i = 0; i < unallocatedContributions.length; i += batchSize) {
+      const batch = unallocatedContributions.slice(i, i + batchSize);
+
+      try {
+        await this.unitOfWork.executeInTransaction(async () => {
+          const events = batch.map((uc) => {
+            const event = new UnallocatedContributionSyncedEvent(
+              uc.sourceAdoptionId,
+              uc.sourceAccountSequence,
+              uc.wouldBeAccountSequence,
+              uc.unallocType,
+              uc.amount.toString(),
+              uc.reason,
+              uc.effectiveDate,
+              uc.expireDate,
+            );
+
+            return {
+              aggregateType: UnallocatedContributionSyncedEvent.AGGREGATE_TYPE,
+              aggregateId: `${uc.sourceAdoptionId}-${uc.unallocType}`,
+              eventType: UnallocatedContributionSyncedEvent.EVENT_TYPE,
+              payload: event.toPayload(),
+            };
+          });
+
+          await this.outboxRepository.saveMany(events);
+        });
+
+        publishedCount += batch.length;
+        this.logger.debug(`Published unallocated contribution batch ${Math.floor(i / batchSize) + 1}: ${batch.length} events`);
+      } catch (error) {
+        failedCount += batch.length;
+        this.logger.error(`Failed to publish unallocated contribution batch ${Math.floor(i / batchSize) + 1}`, error);
+      }
+    }
+
+    this.logger.log(`Published ${publishedCount} unallocated contribution events, ${failedCount} failed`);
+
+    return {
+      success: failedCount === 0,
+      publishedCount,
+      failedCount,
+      message: `Published ${publishedCount} events, ${failedCount} failed out of ${unallocatedContributions.length} total`,
+    };
+  }
 }

backend/services/contribution-service/src/api/controllers/contribution.controller.ts

@@ -1,8 +1,10 @@
 import { Controller, Get, Param, Query, NotFoundException } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiResponse, ApiParam } from '@nestjs/swagger';
+import { ApiTags, ApiOperation, ApiResponse, ApiParam, ApiQuery } from '@nestjs/swagger';
 import { GetContributionAccountQuery } from '../../application/queries/get-contribution-account.query';
 import { GetContributionStatsQuery } from '../../application/queries/get-contribution-stats.query';
 import { GetContributionRankingQuery } from '../../application/queries/get-contribution-ranking.query';
+import { GetPlantingLedgerQuery, PlantingLedgerDto } from '../../application/queries/get-planting-ledger.query';
+import { GetTeamTreeQuery, DirectReferralsResponseDto, MyTeamInfoDto } from '../../application/queries/get-team-tree.query';
 import {
   ContributionAccountResponse,
   ContributionRecordsResponse,
@@ -11,6 +13,7 @@ import {
 import { ContributionStatsResponse } from '../dto/response/contribution-stats.response';
 import { ContributionRankingResponse, UserRankResponse } from '../dto/response/contribution-ranking.response';
 import { GetContributionRecordsRequest } from '../dto/request/get-records.request';
+import { Public } from '../../shared/guards/jwt-auth.guard';
 
 @ApiTags('Contribution')
 @Controller('contribution')
@@ -19,9 +22,12 @@ export class ContributionController {
     private readonly getAccountQuery: GetContributionAccountQuery,
     private readonly getStatsQuery: GetContributionStatsQuery,
     private readonly getRankingQuery: GetContributionRankingQuery,
+    private readonly getPlantingLedgerQuery: GetPlantingLedgerQuery,
+    private readonly getTeamTreeQuery: GetTeamTreeQuery,
   ) {}
 
   @Get('stats')
+  @Public()
   @ApiOperation({ summary: '获取算力统计数据' })
   @ApiResponse({ status: 200, type: ContributionStatsResponse })
   async getStats(): Promise<ContributionStatsResponse> {
@@ -95,4 +101,52 @@ export class ContributionController {
     }
     return result;
   }
+
+  @Get('accounts/:accountSequence/planting-ledger')
+  @ApiOperation({ summary: '获取账户认种分类账' })
+  @ApiParam({ name: 'accountSequence', description: '账户序号' })
+  @ApiQuery({ name: 'page', required: false, type: Number, description: '页码' })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number, description: '每页数量' })
+  @ApiResponse({ status: 200, description: '认种分类账' })
+  async getPlantingLedger(
+    @Param('accountSequence') accountSequence: string,
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ): Promise<PlantingLedgerDto> {
+    return this.getPlantingLedgerQuery.execute(
+      accountSequence,
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+
+  // ========== 团队树 API ==========
+
+  @Get('accounts/:accountSequence/team')
+  @ApiOperation({ summary: '获取账户团队信息' })
+  @ApiParam({ name: 'accountSequence', description: '账户序号' })
+  @ApiResponse({ status: 200, description: '团队信息' })
+  async getMyTeamInfo(
+    @Param('accountSequence') accountSequence: string,
+  ): Promise<MyTeamInfoDto> {
+    return this.getTeamTreeQuery.getMyTeamInfo(accountSequence);
+  }
+
+  @Get('accounts/:accountSequence/team/direct-referrals')
+  @ApiOperation({ summary: '获取账户直推列表（用于伞下树懒加载）' })
+  @ApiParam({ name: 'accountSequence', description: '账户序号' })
+  @ApiQuery({ name: 'limit', required: false, type: Number, description: '每页数量' })
+  @ApiQuery({ name: 'offset', required: false, type: Number, description: '偏移量' })
+  @ApiResponse({ status: 200, description: '直推列表' })
+  async getDirectReferrals(
+    @Param('accountSequence') accountSequence: string,
+    @Query('limit') limit?: number,
+    @Query('offset') offset?: number,
+  ): Promise<DirectReferralsResponseDto> {
+    return this.getTeamTreeQuery.getDirectReferrals(
+      accountSequence,
+      limit ?? 100,
+      offset ?? 0,
+    );
+  }
 }

backend/services/contribution-service/src/api/controllers/health.controller.ts

@@ -2,6 +2,7 @@ import { Controller, Get } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiResponse } from '@nestjs/swagger';
 import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
 import { RedisService } from '../../infrastructure/redis/redis.service';
+import { CDCConsumerService } from '../../infrastructure/kafka/cdc-consumer.service';
 import { Public } from '../../shared/guards/jwt-auth.guard';
 
 interface HealthStatus {
@@ -20,6 +21,7 @@ export class HealthController {
   constructor(
     private readonly prisma: PrismaService,
     private readonly redis: RedisService,
+    private readonly cdcConsumer: CDCConsumerService,
   ) {}
 
   @Get()
@@ -68,4 +70,15 @@ export class HealthController {
   async live(): Promise<{ alive: boolean }> {
     return { alive: true };
   }
+
+  @Get('cdc-sync')
+  @ApiOperation({ summary: 'CDC 同步状态检查' })
+  @ApiResponse({ status: 200, description: 'CDC 同步状态' })
+  async cdcSyncStatus(): Promise<{
+    isRunning: boolean;
+    sequentialMode: boolean;
+    allPhasesCompleted: boolean;
+  }> {
+    return this.cdcConsumer.getSyncStatus();
+  }
 }

backend/services/contribution-service/src/app.module.ts

@@ -16,6 +16,7 @@ import { JwtAuthGuard } from './shared/guards/jwt-auth.guard';
       envFilePath: [
         `.env.${process.env.NODE_ENV || 'development'}`,
         '.env',
+        '../.env', // 父目录共享 .env
       ],
       ignoreEnvFile: false,
     }),

backend/services/contribution-service/src/application/application.module.ts

@@ -12,12 +12,15 @@ import { CDCEventDispatcher } from './event-handlers/cdc-event-dispatcher';
 import { ContributionCalculationService } from './services/contribution-calculation.service';
 import { ContributionDistributionPublisherService } from './services/contribution-distribution-publisher.service';
 import { ContributionRateService } from './services/contribution-rate.service';
+import { BonusClaimService } from './services/bonus-claim.service';
 import { SnapshotService } from './services/snapshot.service';
 
 // Queries
 import { GetContributionAccountQuery } from './queries/get-contribution-account.query';
 import { GetContributionStatsQuery } from './queries/get-contribution-stats.query';
 import { GetContributionRankingQuery } from './queries/get-contribution-ranking.query';
+import { GetPlantingLedgerQuery } from './queries/get-planting-ledger.query';
+import { GetTeamTreeQuery } from './queries/get-team-tree.query';
 
 // Schedulers
 import { ContributionScheduler } from './schedulers/contribution.scheduler';
@@ -38,12 +41,15 @@ import { ContributionScheduler } from './schedulers/contribution.scheduler';
     ContributionCalculationService,
     ContributionDistributionPublisherService,
     ContributionRateService,
+    BonusClaimService,
     SnapshotService,
 
     // Queries
     GetContributionAccountQuery,
     GetContributionStatsQuery,
     GetContributionRankingQuery,
+    GetPlantingLedgerQuery,
+    GetTeamTreeQuery,
 
     // Schedulers
     ContributionScheduler,
@@ -55,6 +61,8 @@ import { ContributionScheduler } from './schedulers/contribution.scheduler';
     GetContributionAccountQuery,
     GetContributionStatsQuery,
     GetContributionRankingQuery,
+    GetPlantingLedgerQuery,
+    GetTeamTreeQuery,
   ],
 })
 export class ApplicationModule {}

backend/services/contribution-service/src/application/event-handlers/adoption-synced.handler.ts

@@ -2,6 +2,7 @@ import { Injectable, Logger } from '@nestjs/common';
 import Decimal from 'decimal.js';
 import { CDCEvent, TransactionClient } from '../../infrastructure/kafka/cdc-consumer.service';
 import { ContributionCalculationService } from '../services/contribution-calculation.service';
+import { ContributionRateService } from '../services/contribution-rate.service';
 
 /**
  * 认种同步结果，用于事务提交后的算力计算
@@ -15,19 +16,11 @@ export interface AdoptionSyncResult {
  * 认种订单 CDC 事件处理器
  * 处理从1.0 planting-service同步过来的planting_orders数据
  *
- * 重要设计说明（符合业界最佳实践）：
+ * 设计说明：
  * ===========================================
- * - handle() 方法在事务内执行，只负责数据同步（synced_adoptions 表）
+ * - handle() 方法100%同步数据，不跳过任何更新
- * - 返回 AdoptionSyncResult，包含需要计算算力的认种ID
+ * - 算力计算只在 status 变为 MINING_ENABLED 时触发
- * - 算力计算（calculateForAdoption）必须在事务提交后单独执行
+ * - 算力计算在事务提交后执行（避免 Serializable 隔离级别的可见性问题）
- *
- * 为什么不能在事务内调用 calculateForAdoption：
- * 1. calculateForAdoption 内部使用独立的数据库连接查询数据
- * 2. 在 Serializable 隔离级别下，内部查询无法看到外部事务未提交的数据
- * 3. 这会导致 "Adoption not found" 错误，因为 synced_adoptions 还未提交
- *
- * 参考：Kafka Idempotent Consumer & Transactional Outbox Pattern
- * https://www.lydtechconsulting.com/blog/kafka-idempotent-consumer-transactional-outbox
  */
 @Injectable()
 export class AdoptionSyncedHandler {
@@ -35,6 +28,7 @@ export class AdoptionSyncedHandler {
 
   constructor(
     private readonly contributionCalculationService: ContributionCalculationService,
+    private readonly contributionRateService: ContributionRateService,
   ) {}
 
   /**
@@ -48,13 +42,28 @@ export class AdoptionSyncedHandler {
     this.logger.log(`[CDC] Adoption event received: op=${op}, seq=${event.sequenceNum}`);
     this.logger.debug(`[CDC] Adoption event payload: ${JSON.stringify(after || before)}`);
 
+    // 获取认种日期，用于查询当日贡献值
+    const data = after || before;
+    const adoptionDate = data?.created_at || data?.createdAt || data?.paid_at || data?.paidAt;
+
+    // 在事务外获取当日每棵树的贡献值
+    let contributionPerTree = new Decimal('22617'); // 默认值
+    if (adoptionDate) {
+      try {
+        contributionPerTree = await this.contributionRateService.getContributionPerTree(new Date(adoptionDate));
+        this.logger.log(`[CDC] Got contributionPerTree for ${adoptionDate}: ${contributionPerTree.toString()}`);
+      } catch (error) {
+        this.logger.warn(`[CDC] Failed to get contributionPerTree, using default 22617`, error);
+      }
+    }
+
     try {
       switch (op) {
         case 'c': // create
         case 'r': // read (snapshot)
-          return await this.handleCreate(after, event.sequenceNum, tx);
+          return await this.handleCreate(after, event.sequenceNum, tx, contributionPerTree);
         case 'u': // update
-          return await this.handleUpdate(after, before, event.sequenceNum, tx);
+          return await this.handleUpdate(after, before, event.sequenceNum, tx, contributionPerTree);
         case 'd': // delete
           await this.handleDelete(before);
           return null;
@@ -86,21 +95,21 @@ export class AdoptionSyncedHandler {
     }
   }
 
-  private async handleCreate(data: any, sequenceNum: bigint, tx: TransactionClient): Promise<AdoptionSyncResult | null> {
+  private async handleCreate(data: any, sequenceNum: bigint, tx: TransactionClient, contributionPerTree: Decimal): Promise<AdoptionSyncResult | null> {
     if (!data) {
       this.logger.warn(`[CDC] Adoption create: empty data received`);
       return null;
     }
 
-    // planting_orders表字段: order_id, account_sequence, tree_count, created_at, status, selected_province, selected_city
     const orderId = data.order_id || data.id;
     const accountSequence = data.account_sequence || data.accountSequence;
     const treeCount = data.tree_count || data.treeCount;
     const createdAt = data.created_at || data.createdAt || data.paid_at || data.paidAt;
     const selectedProvince = data.selected_province || data.selectedProvince || null;
     const selectedCity = data.selected_city || data.selectedCity || null;
+    const status = data.status ?? null;
 
-    this.logger.log(`[CDC] Adoption create: orderId=${orderId}, account=${accountSequence}, trees=${treeCount}, province=${selectedProvince}, city=${selectedCity}`);
+    this.logger.log(`[CDC] Adoption create: orderId=${orderId}, account=${accountSequence}, trees=${treeCount}, status=${status}, contributionPerTree=${contributionPerTree.toString()}`);
 
     if (!orderId || !accountSequence) {
       this.logger.warn(`[CDC] Invalid adoption data: missing order_id or account_sequence`, { data });
@@ -109,8 +118,7 @@ export class AdoptionSyncedHandler {
 
     const originalAdoptionId = BigInt(orderId);
 
-    // 在事务中保存同步的认种订单数据
+    // 100%同步数据，使用真实的每棵树贡献值
-    this.logger.log(`[CDC] Upserting synced adoption: ${orderId}`);
     await tx.syncedAdoption.upsert({
       where: { originalAdoptionId },
       create: {
@@ -118,10 +126,10 @@ export class AdoptionSyncedHandler {
         accountSequence,
         treeCount,
         adoptionDate: new Date(createdAt),
-        status: data.status ?? null,
+        status,
         selectedProvince,
         selectedCity,
-        contributionPerTree: new Decimal('1'), // 每棵树1算力
+        contributionPerTree,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
@@ -129,25 +137,26 @@ export class AdoptionSyncedHandler {
         accountSequence,
         treeCount,
         adoptionDate: new Date(createdAt),
-        status: data.status ?? undefined,
+        status,
-        selectedProvince: selectedProvince ?? undefined,
+        selectedProvince,
-        selectedCity: selectedCity ?? undefined,
+        selectedCity,
-        contributionPerTree: new Decimal('1'),
+        contributionPerTree,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
     });
 
-    this.logger.log(`[CDC] Adoption synced successfully: orderId=${orderId}, account=${accountSequence}, trees=${treeCount}`);
+    this.logger.log(`[CDC] Adoption synced: orderId=${orderId}, status=${status}`);
 
-    // 返回结果，供事务提交后计算算力
+    // 只有 MINING_ENABLED 状态才触发算力计算
+    const needsCalculation = status === 'MINING_ENABLED';
     return {
       originalAdoptionId,
-      needsCalculation: true,
+      needsCalculation,
     };
   }
 
-  private async handleUpdate(after: any, before: any, sequenceNum: bigint, tx: TransactionClient): Promise<AdoptionSyncResult | null> {
+  private async handleUpdate(after: any, before: any, sequenceNum: bigint, tx: TransactionClient, contributionPerTree: Decimal): Promise<AdoptionSyncResult | null> {
     if (!after) {
       this.logger.warn(`[CDC] Adoption update: empty after data received`);
       return null;
@@ -155,37 +164,22 @@ export class AdoptionSyncedHandler {
 
     const orderId = after.order_id || after.id;
     const originalAdoptionId = BigInt(orderId);
-
-    this.logger.log(`[CDC] Adoption update: orderId=${orderId}`);
-
-    // 检查是否已经处理过（使用事务客户端）
-    const existingAdoption = await tx.syncedAdoption.findUnique({
-      where: { originalAdoptionId },
-    });
-
-    if (existingAdoption?.contributionDistributed) {
-      // 如果树数量发生变化，需要重新计算（这种情况较少）
-      const newTreeCount = after.tree_count || after.treeCount;
-      if (existingAdoption.treeCount !== newTreeCount) {
-        this.logger.warn(
-          `[CDC] Adoption tree count changed after processing: ${originalAdoptionId}, old=${existingAdoption.treeCount}, new=${newTreeCount}. This requires special handling.`,
-        );
-        // TODO: 实现树数量变化的处理逻辑
-      } else {
-        this.logger.debug(`[CDC] Adoption ${orderId} already distributed, skipping update`);
-      }
-      return null;
-    }
-
     const accountSequence = after.account_sequence || after.accountSequence;
     const treeCount = after.tree_count || after.treeCount;
     const createdAt = after.created_at || after.createdAt || after.paid_at || after.paidAt;
     const selectedProvince = after.selected_province || after.selectedProvince || null;
     const selectedCity = after.selected_city || after.selectedCity || null;
+    const newStatus = after.status ?? null;
+    const oldStatus = before?.status ?? null;
 
-    this.logger.log(`[CDC] Adoption update data: account=${accountSequence}, trees=${treeCount}, province=${selectedProvince}, city=${selectedCity}`);
+    this.logger.log(`[CDC] Adoption update: orderId=${orderId}, status=${oldStatus} -> ${newStatus}, contributionPerTree=${contributionPerTree.toString()}`);
 
-    // 在事务中保存同步的认种订单数据
+    // 查询现有记录
+    const existingAdoption = await tx.syncedAdoption.findUnique({
+      where: { originalAdoptionId },
+    });
+
+    // 100%同步数据，使用真实的每棵树贡献值
     await tx.syncedAdoption.upsert({
       where: { originalAdoptionId },
       create: {
@@ -193,10 +187,10 @@ export class AdoptionSyncedHandler {
         accountSequence,
         treeCount,
         adoptionDate: new Date(createdAt),
-        status: after.status ?? null,
+        status: newStatus,
         selectedProvince,
         selectedCity,
-        contributionPerTree: new Decimal('1'),
+        contributionPerTree,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
@@ -204,21 +198,24 @@ export class AdoptionSyncedHandler {
         accountSequence,
         treeCount,
         adoptionDate: new Date(createdAt),
-        status: after.status ?? undefined,
+        status: newStatus,
-        selectedProvince: selectedProvince ?? undefined,
+        selectedProvince,
-        selectedCity: selectedCity ?? undefined,
+        selectedCity,
-        contributionPerTree: new Decimal('1'),
+        contributionPerTree,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
     });
 
-    this.logger.log(`[CDC] Adoption updated successfully: ${originalAdoptionId}`);
+    this.logger.log(`[CDC] Adoption synced: orderId=${orderId}, status=${newStatus}`);
+
+    // 只有当 status 变为 MINING_ENABLED 且尚未计算过算力时，才触发算力计算
+    const statusChangedToMiningEnabled = newStatus === 'MINING_ENABLED' && oldStatus !== 'MINING_ENABLED';
+    const needsCalculation = statusChangedToMiningEnabled && !existingAdoption?.contributionDistributed;
 
-    // 只有尚未分配算力的认种才需要计算
     return {
       originalAdoptionId,
-      needsCalculation: !existingAdoption?.contributionDistributed,
+      needsCalculation,
     };
   }
 

backend/services/contribution-service/src/application/event-handlers/cdc-event-dispatcher.ts

@@ -51,14 +51,17 @@ export class CDCEventDispatcher implements OnModuleInit {
       this.handleAdoptionPostCommit.bind(this),
     );
 
-    // 启动 CDC 消费者
+    // 非阻塞启动 CDC 消费者
-    try {
+    // 让 HTTP 服务器先启动，CDC 同步在后台进行
-      await this.cdcConsumer.start();
+    // 脚本通过 /health/cdc-sync API 轮询同步状态
-      this.logger.log('CDC event dispatcher started with transactional idempotency');
+    this.cdcConsumer.start()
-    } catch (error) {
+      .then(() => {
-      this.logger.error('Failed to start CDC event dispatcher', error);
+        this.logger.log('CDC event dispatcher started with transactional idempotency');
-      // 不抛出错误，允许服务在没有 Kafka 的情况下启动（用于本地开发）
+      })
-    }
+      .catch((error) => {
+        this.logger.error('Failed to start CDC event dispatcher', error);
+        // 不抛出错误，允许服务在没有 Kafka 的情况下启动（用于本地开发）
+      });
   }
 
   private async handleUserEvent(event: CDCEvent, tx: TransactionClient): Promise<void> {

backend/services/contribution-service/src/application/event-handlers/referral-synced.handler.ts

@@ -5,22 +5,7 @@ import { CDCEvent, TransactionClient } from '../../infrastructure/kafka/cdc-cons
  * 引荐关系 CDC 事件处理器
  * 处理从1.0 referral-service同步过来的referral_relationships数据
  *
- * 1.0 表结构 (referral_relationships):
+ * 设计说明：100%同步数据，不跳过任何字段更新
- * - user_id: BigInt (用户ID)
- * - account_sequence: String (账户序列号)
- * - referrer_id: BigInt (推荐人用户ID, 注意：不是 account_sequence)
- * - ancestor_path: BigInt[] (祖先路径数组，存储 user_id)
- * - depth: Int (层级深度)
- *
- * 2.0 存储策略:
- * - 保存 original_user_id (1.0 的 user_id)
- * - 保存 referrer_user_id (1.0 的 referrer_id)
- * - 尝试查找 referrer 的 account_sequence 并保存
- * - ancestor_path 转换为逗号分隔的字符串
- *
- * 注意：此 handler 现在接收外部传入的事务客户端（tx），
- * 所有数据库操作都必须使用此事务客户端执行，
- * 以确保幂等记录和业务数据在同一事务中处理。
  */
 @Injectable()
 export class ReferralSyncedHandler {
@@ -61,12 +46,11 @@ export class ReferralSyncedHandler {
       return;
     }
 
-    // 1.0 字段映射
     const accountSequence = data.account_sequence || data.accountSequence;
     const originalUserId = data.user_id || data.userId;
     const referrerUserId = data.referrer_id || data.referrerId;
     const ancestorPathArray = data.ancestor_path || data.ancestorPath;
-    const depth = data.depth || 0;
+    const depth = data.depth ?? 0;
 
     this.logger.log(`[CDC] Referral create: account=${accountSequence}, userId=${originalUserId}, referrerId=${referrerUserId}, depth=${depth}`);
 
@@ -75,11 +59,9 @@ export class ReferralSyncedHandler {
       return;
     }
 
-    // 将 BigInt[] 转换为逗号分隔的字符串
     const ancestorPath = this.convertAncestorPath(ancestorPathArray);
-    this.logger.debug(`[CDC] Referral ancestorPath converted: ${ancestorPath}`);
 
-    // 尝试查找推荐人的 account_sequence（使用事务客户端）
+    // 尝试查找推荐人的 account_sequence
     let referrerAccountSequence: string | null = null;
     if (referrerUserId) {
       const referrer = await tx.syncedReferral.findFirst({
@@ -87,14 +69,10 @@ export class ReferralSyncedHandler {
       });
       if (referrer) {
         referrerAccountSequence = referrer.accountSequence;
-        this.logger.debug(`[CDC] Found referrer account_sequence: ${referrerAccountSequence} for referrer_id: ${referrerUserId}`);
-      } else {
-        this.logger.log(`[CDC] Referrer user_id ${referrerUserId} not found yet for ${accountSequence}, will resolve later`);
       }
     }
 
-    // 使用外部事务客户端执行所有操作
+    // 100%同步数据
-    this.logger.log(`[CDC] Upserting synced referral: ${accountSequence}`);
     await tx.syncedReferral.upsert({
       where: { accountSequence },
       create: {
@@ -108,17 +86,17 @@ export class ReferralSyncedHandler {
         syncedAt: new Date(),
       },
       update: {
-        referrerAccountSequence: referrerAccountSequence ?? undefined,
+        referrerAccountSequence,
-        referrerUserId: referrerUserId ? BigInt(referrerUserId) : undefined,
+        referrerUserId: referrerUserId ? BigInt(referrerUserId) : null,
-        originalUserId: originalUserId ? BigInt(originalUserId) : undefined,
+        originalUserId: originalUserId ? BigInt(originalUserId) : null,
-        ancestorPath: ancestorPath ?? undefined,
+        ancestorPath,
-        depth: depth ?? undefined,
+        depth,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
     });
 
-    this.logger.log(`[CDC] Referral synced successfully: ${accountSequence} (user_id: ${originalUserId}) -> referrer_id: ${referrerUserId || 'none'}, depth: ${depth}`);
+    this.logger.log(`[CDC] Referral synced: ${accountSequence}, referrerId=${referrerUserId || 'none'}, depth=${depth}`);
   }
 
   private async handleUpdate(data: any, sequenceNum: bigint, tx: TransactionClient): Promise<void> {
@@ -131,7 +109,7 @@ export class ReferralSyncedHandler {
     const originalUserId = data.user_id || data.userId;
     const referrerUserId = data.referrer_id || data.referrerId;
     const ancestorPathArray = data.ancestor_path || data.ancestorPath;
-    const depth = data.depth || 0;
+    const depth = data.depth ?? 0;
 
     this.logger.log(`[CDC] Referral update: account=${accountSequence}, referrerId=${referrerUserId}, depth=${depth}`);
 
@@ -142,7 +120,7 @@ export class ReferralSyncedHandler {
 
     const ancestorPath = this.convertAncestorPath(ancestorPathArray);
 
-    // 尝试查找推荐人的 account_sequence（使用事务客户端）
+    // 尝试查找推荐人的 account_sequence
     let referrerAccountSequence: string | null = null;
     if (referrerUserId) {
       const referrer = await tx.syncedReferral.findFirst({
@@ -150,10 +128,10 @@ export class ReferralSyncedHandler {
       });
       if (referrer) {
         referrerAccountSequence = referrer.accountSequence;
-        this.logger.debug(`[CDC] Found referrer account_sequence: ${referrerAccountSequence}`);
       }
     }
 
+    // 100%同步数据
     await tx.syncedReferral.upsert({
       where: { accountSequence },
       create: {
@@ -167,17 +145,17 @@ export class ReferralSyncedHandler {
         syncedAt: new Date(),
       },
       update: {
-        referrerAccountSequence: referrerAccountSequence ?? undefined,
+        referrerAccountSequence,
-        referrerUserId: referrerUserId ? BigInt(referrerUserId) : undefined,
+        referrerUserId: referrerUserId ? BigInt(referrerUserId) : null,
-        originalUserId: originalUserId ? BigInt(originalUserId) : undefined,
+        originalUserId: originalUserId ? BigInt(originalUserId) : null,
-        ancestorPath: ancestorPath ?? undefined,
+        ancestorPath,
-        depth: depth ?? undefined,
+        depth,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
     });
 
-    this.logger.log(`[CDC] Referral updated successfully: ${accountSequence}`);
+    this.logger.log(`[CDC] Referral synced: ${accountSequence}`);
   }
 
   private async handleDelete(data: any): Promise<void> {

backend/services/contribution-service/src/application/event-handlers/user-synced.handler.ts

@@ -6,9 +6,7 @@ import { ContributionAccountAggregate } from '../../domain/aggregates/contributi
  * 用户 CDC 事件处理器
  * 处理从身份服务同步过来的用户数据
  *
- * 注意：此 handler 现在接收外部传入的事务客户端（tx），
+ * 设计说明：100%同步数据，不跳过任何字段更新
- * 所有数据库操作都必须使用此事务客户端执行，
- * 以确保幂等记录和业务数据在同一事务中处理。
  */
 @Injectable()
 export class UserSyncedHandler {
@@ -49,22 +47,19 @@ export class UserSyncedHandler {
       return;
     }
 
-    // 兼容不同的字段命名（CDC 使用 snake_case）
     const userId = data.user_id ?? data.id;
     const accountSequence = data.account_sequence ?? data.accountSequence;
     const phone = data.phone_number ?? data.phone ?? null;
-    const status = data.status ?? 'ACTIVE';
+    const status = data.status ?? null;
 
-    this.logger.log(`[CDC] User create: userId=${userId}, accountSequence=${accountSequence}, phone=${phone}, status=${status}`);
+    this.logger.log(`[CDC] User create: userId=${userId}, accountSequence=${accountSequence}, status=${status}`);
 
     if (!userId || !accountSequence) {
       this.logger.warn(`[CDC] Invalid user data: missing user_id or account_sequence`, { data });
       return;
     }
 
-    // 使用外部事务客户端执行所有操作
+    // 100%同步数据
-    // 保存同步的用户数据
-    this.logger.log(`[CDC] Upserting synced user: ${accountSequence}`);
     await tx.syncedUser.upsert({
       where: { accountSequence },
       create: {
@@ -76,8 +71,9 @@ export class UserSyncedHandler {
         syncedAt: new Date(),
       },
       update: {
-        phone: phone ?? undefined,
+        originalUserId: BigInt(userId),
-        status: status ?? undefined,
+        phone,
+        status,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
@@ -95,11 +91,9 @@ export class UserSyncedHandler {
         data: persistData,
       });
       this.logger.log(`[CDC] Created contribution account for user: ${accountSequence}`);
-    } else {
-      this.logger.debug(`[CDC] Contribution account already exists for user: ${accountSequence}`);
     }
 
-    this.logger.log(`[CDC] User synced successfully: ${accountSequence}`);
+    this.logger.log(`[CDC] User synced: ${accountSequence}`);
   }
 
   private async handleUpdate(data: any, sequenceNum: bigint, tx: TransactionClient): Promise<void> {
@@ -108,11 +102,10 @@ export class UserSyncedHandler {
       return;
     }
 
-    // 兼容不同的字段命名（CDC 使用 snake_case）
     const userId = data.user_id ?? data.id;
     const accountSequence = data.account_sequence ?? data.accountSequence;
     const phone = data.phone_number ?? data.phone ?? null;
-    const status = data.status ?? 'ACTIVE';
+    const status = data.status ?? null;
 
     this.logger.log(`[CDC] User update: userId=${userId}, accountSequence=${accountSequence}, status=${status}`);
 
@@ -121,6 +114,7 @@ export class UserSyncedHandler {
       return;
     }
 
+    // 100%同步数据
     await tx.syncedUser.upsert({
       where: { accountSequence },
       create: {
@@ -132,14 +126,15 @@ export class UserSyncedHandler {
         syncedAt: new Date(),
       },
       update: {
-        phone: phone ?? undefined,
+        originalUserId: BigInt(userId),
-        status: status ?? undefined,
+        phone,
+        status,
         sourceSequenceNum: sequenceNum,
         syncedAt: new Date(),
       },
     });
 
-    this.logger.log(`[CDC] User updated successfully: ${accountSequence}`);
+    this.logger.log(`[CDC] User synced: ${accountSequence}`);
   }
 
   private async handleDelete(data: any): Promise<void> {

backend/services/contribution-service/src/application/queries/get-contribution-account.query.ts

@@ -183,16 +183,16 @@ export class GetContributionAccountQuery {
 
   private toRecordDto(record: any): ContributionRecordDto {
     return {
-      id: record.id,
+      id: record.id?.toString() ?? '',
       sourceType: record.sourceType,
-      sourceAdoptionId: record.sourceAdoptionId,
+      sourceAdoptionId: record.sourceAdoptionId?.toString() ?? '',
       sourceAccountSequence: record.sourceAccountSequence,
       treeCount: record.treeCount,
-      baseContribution: record.baseContribution.value.toString(),
+      baseContribution: record.baseContribution?.value?.toString() ?? '0',
-      distributionRate: record.distributionRate.value.toString(),
+      distributionRate: record.distributionRate?.value?.toString() ?? '0',
       levelDepth: record.levelDepth,
       bonusTier: record.bonusTier,
-      finalContribution: record.finalContribution.value.toString(),
+      finalContribution: record.amount?.value?.toString() ?? '0',
       effectiveDate: record.effectiveDate,
       expireDate: record.expireDate,
       isExpired: record.isExpired,

backend/services/contribution-service/src/application/queries/get-contribution-stats.query.ts

@@ -1,4 +1,5 @@
 import { Injectable } from '@nestjs/common';
+import Decimal from 'decimal.js';
 import { ContributionAccountRepository } from '../../infrastructure/persistence/repositories/contribution-account.repository';
 import { ContributionRecordRepository } from '../../infrastructure/persistence/repositories/contribution-record.repository';
 import { UnallocatedContributionRepository } from '../../infrastructure/persistence/repositories/unallocated-contribution.repository';
@@ -6,6 +7,15 @@ import { SystemAccountRepository } from '../../infrastructure/persistence/reposi
 import { SyncedDataRepository } from '../../infrastructure/persistence/repositories/synced-data.repository';
 import { ContributionSourceType } from '../../domain/aggregates/contribution-account.aggregate';
 
+// 基准算力常量
+const BASE_CONTRIBUTION_PER_TREE = new Decimal('22617');
+const RATE_PERSONAL = new Decimal('0.70');
+const RATE_OPERATION = new Decimal('0.12');
+const RATE_PROVINCE = new Decimal('0.01');
+const RATE_CITY = new Decimal('0.02');
+const RATE_LEVEL_TOTAL = new Decimal('0.075');
+const RATE_BONUS_TOTAL = new Decimal('0.075');
+
 export interface ContributionStatsDto {
   // 用户统计
   totalUsers: number;
@@ -16,17 +26,57 @@ export interface ContributionStatsDto {
   totalAdoptions: number;
   processedAdoptions: number;
   unprocessedAdoptions: number;
+  totalTrees: number;
 
   // 算力统计
   totalContribution: string;
 
-  // 算力分布
+  // 算力分布（基础）
   contributionByType: {
     personal: string;
     teamLevel: string;
     teamBonus: string;
   };
 
+  // ========== 详细算力分解（按用户需求） ==========
+  // 全网算力 = 总认种树 * 22617
+  networkTotalContribution: string;
+  // 个人用户总算力 = 总认种树 * (22617 * 70%)
+  personalTotalContribution: string;
+  // 运营账户总算力 = 总认种树 * (22617 * 12%)
+  operationTotalContribution: string;
+  // 省公司总算力 = 总认种树 * (22617 * 1%)
+  provinceTotalContribution: string;
+  // 市公司总算力 = 总认种树 * (22617 * 2%)
+  cityTotalContribution: string;
+
+  // 层级算力详情 (7.5%)
+  levelContribution: {
+    total: string;
+    unlocked: string;
+    pending: string;
+    byTier: {
+      // 1档: 1-5级
+      tier1: { unlocked: string; pending: string };
+      // 2档: 6-10级
+      tier2: { unlocked: string; pending: string };
+      // 3档: 11-15级
+      tier3: { unlocked: string; pending: string };
+    };
+  };
+
+  // 团队奖励算力详情 (7.5%)
+  bonusContribution: {
+    total: string;
+    unlocked: string;
+    pending: string;
+    byTier: {
+      tier1: { unlocked: string; pending: string };
+      tier2: { unlocked: string; pending: string };
+      tier3: { unlocked: string; pending: string };
+    };
+  };
+
   // 系统账户
   systemAccounts: {
     accountType: string;
@@ -61,6 +111,10 @@ export class GetContributionStatsQuery {
       systemAccounts,
       totalUnallocated,
       unallocatedByType,
+      detailedStats,
+      unallocatedByLevelTier,
+      unallocatedByBonusTier,
+      totalTrees,
     ] = await Promise.all([
       this.syncedDataRepository.countUsers(),
       this.accountRepository.countAccounts(),
@@ -72,8 +126,33 @@ export class GetContributionStatsQuery {
       this.systemAccountRepository.findAll(),
       this.unallocatedRepository.getTotalUnallocated(),
       this.unallocatedRepository.getTotalUnallocatedByType(),
+      this.accountRepository.getDetailedContributionStats(),
+      this.unallocatedRepository.getUnallocatedByLevelTier(),
+      this.unallocatedRepository.getUnallocatedByBonusTier(),
+      this.syncedDataRepository.getTotalTrees(),
     ]);
 
+    // 计算理论算力（基于总认种树 * 基准算力）
+    const networkTotal = BASE_CONTRIBUTION_PER_TREE.mul(totalTrees);
+    const personalTotal = networkTotal.mul(RATE_PERSONAL);
+    const operationTotal = networkTotal.mul(RATE_OPERATION);
+    const provinceTotal = networkTotal.mul(RATE_PROVINCE);
+    const cityTotal = networkTotal.mul(RATE_CITY);
+    const levelTotal = networkTotal.mul(RATE_LEVEL_TOTAL);
+    const bonusTotal = networkTotal.mul(RATE_BONUS_TOTAL);
+
+    // 层级算力: 已解锁 + 未解锁
+    const levelUnlocked = new Decimal(detailedStats.levelUnlocked);
+    const levelPending = new Decimal(unallocatedByLevelTier.tier1)
+      .plus(unallocatedByLevelTier.tier2)
+      .plus(unallocatedByLevelTier.tier3);
+
+    // 团队奖励算力: 已解锁 + 未解锁
+    const bonusUnlocked = new Decimal(detailedStats.bonusUnlocked);
+    const bonusPending = new Decimal(unallocatedByBonusTier.tier1)
+      .plus(unallocatedByBonusTier.tier2)
+      .plus(unallocatedByBonusTier.tier3);
+
     return {
       totalUsers,
       totalAccounts,
@@ -81,12 +160,63 @@ export class GetContributionStatsQuery {
       totalAdoptions,
       processedAdoptions: totalAdoptions - undistributedAdoptions,
       unprocessedAdoptions: undistributedAdoptions,
+      totalTrees,
       totalContribution: totalContribution.value.toString(),
       contributionByType: {
         personal: (contributionByType.get(ContributionSourceType.PERSONAL)?.value || 0).toString(),
         teamLevel: (contributionByType.get(ContributionSourceType.TEAM_LEVEL)?.value || 0).toString(),
         teamBonus: (contributionByType.get(ContributionSourceType.TEAM_BONUS)?.value || 0).toString(),
       },
+
+      // 详细算力分解
+      networkTotalContribution: networkTotal.toString(),
+      personalTotalContribution: personalTotal.toString(),
+      operationTotalContribution: operationTotal.toString(),
+      provinceTotalContribution: provinceTotal.toString(),
+      cityTotalContribution: cityTotal.toString(),
+
+      // 层级算力详情
+      levelContribution: {
+        total: levelTotal.toString(),
+        unlocked: levelUnlocked.toString(),
+        pending: levelPending.toString(),
+        byTier: {
+          tier1: {
+            unlocked: detailedStats.levelByTier.tier1.unlocked,
+            pending: unallocatedByLevelTier.tier1,
+          },
+          tier2: {
+            unlocked: detailedStats.levelByTier.tier2.unlocked,
+            pending: unallocatedByLevelTier.tier2,
+          },
+          tier3: {
+            unlocked: detailedStats.levelByTier.tier3.unlocked,
+            pending: unallocatedByLevelTier.tier3,
+          },
+        },
+      },
+
+      // 团队奖励算力详情
+      bonusContribution: {
+        total: bonusTotal.toString(),
+        unlocked: bonusUnlocked.toString(),
+        pending: bonusPending.toString(),
+        byTier: {
+          tier1: {
+            unlocked: detailedStats.bonusByTier.tier1.unlocked,
+            pending: unallocatedByBonusTier.tier1,
+          },
+          tier2: {
+            unlocked: detailedStats.bonusByTier.tier2.unlocked,
+            pending: unallocatedByBonusTier.tier2,
+          },
+          tier3: {
+            unlocked: detailedStats.bonusByTier.tier3.unlocked,
+            pending: unallocatedByBonusTier.tier3,
+          },
+        },
+      },
+
       systemAccounts: systemAccounts.map((a) => ({
         accountType: a.accountType,
         name: a.name,
@@ -98,4 +228,5 @@ export class GetContributionStatsQuery {
       ),
     };
   }
+
 }

backend/services/contribution-service/src/application/queries/get-planting-ledger.query.ts

@@ -0,0 +1,85 @@
+import { Injectable } from '@nestjs/common';
+import { SyncedDataRepository } from '../../infrastructure/persistence/repositories/synced-data.repository';
+import { ContributionAccountRepository } from '../../infrastructure/persistence/repositories/contribution-account.repository';
+
+export interface PlantingRecordDto {
+  orderId: string;
+  orderNo: string;
+  originalAdoptionId: string;
+  treeCount: number;
+  contributionPerTree: string;
+  totalContribution: string;
+  status: string;
+  adoptionDate: string | null;
+  createdAt: string;
+}
+
+export interface PlantingSummaryDto {
+  totalOrders: number;
+  totalTreeCount: number;
+  totalAmount: string;
+  effectiveTreeCount: number;
+  /** 用户实际的有效贡献值（个人算力） */
+  effectiveContribution: string;
+  firstPlantingAt: string | null;
+  lastPlantingAt: string | null;
+}
+
+export interface PlantingLedgerDto {
+  summary: PlantingSummaryDto;
+  items: PlantingRecordDto[];
+  total: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+}
+
+@Injectable()
+export class GetPlantingLedgerQuery {
+  constructor(
+    private readonly syncedDataRepository: SyncedDataRepository,
+    private readonly contributionAccountRepository: ContributionAccountRepository,
+  ) {}
+
+  async execute(
+    accountSequence: string,
+    page: number = 1,
+    pageSize: number = 20,
+  ): Promise<PlantingLedgerDto> {
+    const [summary, ledger, contributionAccount] = await Promise.all([
+      this.syncedDataRepository.getPlantingSummary(accountSequence),
+      this.syncedDataRepository.getPlantingLedger(accountSequence, page, pageSize),
+      this.contributionAccountRepository.findByAccountSequence(accountSequence),
+    ]);
+
+    // 获取用户实际的有效贡献值（个人算力）
+    const effectiveContribution = contributionAccount?.personalContribution.toString() || '0';
+
+    return {
+      summary: {
+        totalOrders: summary.totalOrders,
+        totalTreeCount: summary.totalTreeCount,
+        totalAmount: summary.totalAmount,
+        effectiveTreeCount: summary.effectiveTreeCount,
+        effectiveContribution,
+        firstPlantingAt: summary.firstPlantingAt?.toISOString() || null,
+        lastPlantingAt: summary.lastPlantingAt?.toISOString() || null,
+      },
+      items: ledger.items.map((item) => ({
+        orderId: item.id.toString(),
+        orderNo: `ORD-${item.originalAdoptionId}`,
+        originalAdoptionId: item.originalAdoptionId.toString(),
+        treeCount: item.treeCount,
+        contributionPerTree: item.contributionPerTree.toString(),
+        totalContribution: item.contributionPerTree.mul(item.treeCount).toString(),
+        status: item.status || 'UNKNOWN',
+        adoptionDate: item.adoptionDate?.toISOString() || null,
+        createdAt: item.createdAt.toISOString(),
+      })),
+      total: ledger.total,
+      page: ledger.page,
+      pageSize: ledger.pageSize,
+      totalPages: ledger.totalPages,
+    };
+  }
+}

backend/services/contribution-service/src/application/queries/get-team-tree.query.ts

@@ -0,0 +1,121 @@
+import { Injectable, Inject } from '@nestjs/common';
+import {
+  ISyncedDataRepository,
+  SYNCED_DATA_REPOSITORY,
+} from '../../domain/repositories/synced-data.repository.interface';
+
+/**
+ * 团队成员信息
+ */
+export interface TeamMemberDto {
+  accountSequence: string;
+  personalPlantingCount: number;
+  teamPlantingCount: number;
+  directReferralCount: number;
+}
+
+/**
+ * 直推列表响应
+ */
+export interface DirectReferralsResponseDto {
+  referrals: TeamMemberDto[];
+  total: number;
+  hasMore: boolean;
+}
+
+/**
+ * 我的团队信息响应
+ */
+export interface MyTeamInfoDto {
+  accountSequence: string;
+  personalPlantingCount: number;
+  teamPlantingCount: number;
+  directReferralCount: number;
+}
+
+@Injectable()
+export class GetTeamTreeQuery {
+  constructor(
+    @Inject(SYNCED_DATA_REPOSITORY)
+    private readonly syncedDataRepository: ISyncedDataRepository,
+  ) {}
+
+  /**
+   * 获取当前用户的团队信息
+   */
+  async getMyTeamInfo(accountSequence: string): Promise<MyTeamInfoDto> {
+    // 获取个人认种棵数
+    const personalPlantingCount = await this.syncedDataRepository.getTotalTreesByAccountSequence(accountSequence);
+
+    // 获取直推数量
+    const directReferrals = await this.syncedDataRepository.findDirectReferrals(accountSequence);
+
+    // 获取团队认种棵数（伞下各级总和）
+    const teamTreesByLevel = await this.syncedDataRepository.getTeamTreesByLevel(accountSequence, 15);
+    let teamPlantingCount = 0;
+    teamTreesByLevel.forEach((count) => {
+      teamPlantingCount += count;
+    });
+
+    return {
+      accountSequence,
+      personalPlantingCount,
+      teamPlantingCount,
+      directReferralCount: directReferrals.length,
+    };
+  }
+
+  /**
+   * 获取指定用户的直推列表
+   */
+  async getDirectReferrals(
+    accountSequence: string,
+    limit: number = 100,
+    offset: number = 0,
+  ): Promise<DirectReferralsResponseDto> {
+    // 获取所有直推
+    const allDirectReferrals = await this.syncedDataRepository.findDirectReferrals(accountSequence);
+
+    // 分页
+    const total = allDirectReferrals.length;
+    const paginatedReferrals = allDirectReferrals.slice(offset, offset + limit);
+
+    // 获取每个直推成员的详细信息
+    const referrals: TeamMemberDto[] = await Promise.all(
+      paginatedReferrals.map(async (ref) => {
+        return this.getTeamMemberInfo(ref.accountSequence);
+      }),
+    );
+
+    return {
+      referrals,
+      total,
+      hasMore: offset + limit < total,
+    };
+  }
+
+  /**
+   * 获取团队成员信息
+   */
+  private async getTeamMemberInfo(accountSequence: string): Promise<TeamMemberDto> {
+    // 获取个人认种棵数
+    const personalPlantingCount = await this.syncedDataRepository.getTotalTreesByAccountSequence(accountSequence);
+
+    // 获取直推数量
+    const directReferrals = await this.syncedDataRepository.findDirectReferrals(accountSequence);
+
+    // 获取团队认种棵数
+    const teamTreesByLevel = await this.syncedDataRepository.getTeamTreesByLevel(accountSequence, 15);
+    let teamPlantingCount = 0;
+    teamTreesByLevel.forEach((count) => {
+      teamPlantingCount += count;
+    });
+
+    return {
+      accountSequence,
+      personalPlantingCount,
+      teamPlantingCount,
+      directReferralCount: directReferrals.length,
+    };
+  }
+}

backend/services/contribution-service/src/application/schedulers/contribution.scheduler.ts

@@ -3,9 +3,11 @@ import { Cron, CronExpression } from '@nestjs/schedule';
 import { ContributionCalculationService } from '../services/contribution-calculation.service';
 import { SnapshotService } from '../services/snapshot.service';
 import { ContributionRecordRepository } from '../../infrastructure/persistence/repositories/contribution-record.repository';
+import { ContributionAccountRepository } from '../../infrastructure/persistence/repositories/contribution-account.repository';
 import { OutboxRepository } from '../../infrastructure/persistence/repositories/outbox.repository';
 import { KafkaProducerService } from '../../infrastructure/kafka/kafka-producer.service';
 import { RedisService } from '../../infrastructure/redis/redis.service';
+import { ContributionAccountUpdatedEvent } from '../../domain/events';
 
 /**
  * 算力相关定时任务
@@ -19,6 +21,7 @@ export class ContributionScheduler implements OnModuleInit {
     private readonly calculationService: ContributionCalculationService,
     private readonly snapshotService: SnapshotService,
     private readonly contributionRecordRepository: ContributionRecordRepository,
+    private readonly contributionAccountRepository: ContributionAccountRepository,
     private readonly outboxRepository: OutboxRepository,
     private readonly kafkaProducer: KafkaProducerService,
     private readonly redis: RedisService,
@@ -174,4 +177,128 @@ export class ContributionScheduler implements OnModuleInit {
       await this.redis.releaseLock(`${this.LOCK_KEY}:cleanup`, lockValue);
     }
   }
+
+  /**
+   * 每10分钟增量发布最近更新的贡献值账户事件
+   * 只同步过去15分钟内有变更的账户，作为实时同步的补充
+   */
+  @Cron('*/10 * * * *')
+  async publishRecentlyUpdatedAccounts(): Promise<void> {
+    const lockValue = await this.redis.acquireLock(`${this.LOCK_KEY}:incremental-sync`, 540); // 9分钟锁
+    if (!lockValue) {
+      return;
+    }
+
+    try {
+      // 查找过去15分钟内更新的账户（比10分钟多5分钟余量，避免遗漏边界情况）
+      const fifteenMinutesAgo = new Date(Date.now() - 15 * 60 * 1000);
+
+      const accounts = await this.contributionAccountRepository.findRecentlyUpdated(fifteenMinutesAgo, 500);
+
+      if (accounts.length === 0) {
+        return;
+      }
+
+      const events = accounts.map((account) => {
+        const event = new ContributionAccountUpdatedEvent(
+          account.accountSequence,
+          account.personalContribution.value.toString(),
+          account.totalLevelPending.value.toString(),
+          account.totalBonusPending.value.toString(),
+          account.effectiveContribution.value.toString(),
+          account.effectiveContribution.value.toString(),
+          account.hasAdopted,
+          account.directReferralAdoptedCount,
+          account.unlockedLevelDepth,
+          account.unlockedBonusTiers,
+          account.createdAt,
+        );
+
+        return {
+          aggregateType: ContributionAccountUpdatedEvent.AGGREGATE_TYPE,
+          aggregateId: account.accountSequence,
+          eventType: ContributionAccountUpdatedEvent.EVENT_TYPE,
+          payload: event.toPayload(),
+        };
+      });
+
+      await this.outboxRepository.saveMany(events);
+
+      this.logger.log(`Incremental sync: published ${accounts.length} recently updated accounts`);
+    } catch (error) {
+      this.logger.error('Failed to publish recently updated accounts', error);
+    } finally {
+      await this.redis.releaseLock(`${this.LOCK_KEY}:incremental-sync`, lockValue);
+    }
+  }
+
+  /**
+   * 每天凌晨4点全量发布所有贡献值账户更新事件
+   * 作为数据一致性的最终兜底保障
+   */
+  @Cron('0 4 * * *')
+  async publishAllAccountUpdates(): Promise<void> {
+    const lockValue = await this.redis.acquireLock(`${this.LOCK_KEY}:full-sync`, 3600); // 1小时锁
+    if (!lockValue) {
+      return;
+    }
+
+    try {
+      this.logger.log('Starting daily full sync of contribution accounts...');
+
+      let page = 1;
+      const pageSize = 100;
+      let totalPublished = 0;
+
+      while (true) {
+        const { items: accounts, total } = await this.contributionAccountRepository.findMany({
+          page,
+          limit: pageSize,
+          orderBy: 'effectiveContribution',
+          order: 'desc',
+        });
+
+        if (accounts.length === 0) {
+          break;
+        }
+
+        const events = accounts.map((account) => {
+          const event = new ContributionAccountUpdatedEvent(
+            account.accountSequence,
+            account.personalContribution.value.toString(),
+            account.totalLevelPending.value.toString(),
+            account.totalBonusPending.value.toString(),
+            account.effectiveContribution.value.toString(),
+            account.effectiveContribution.value.toString(),
+            account.hasAdopted,
+            account.directReferralAdoptedCount,
+            account.unlockedLevelDepth,
+            account.unlockedBonusTiers,
+            account.createdAt,
+          );
+
+          return {
+            aggregateType: ContributionAccountUpdatedEvent.AGGREGATE_TYPE,
+            aggregateId: account.accountSequence,
+            eventType: ContributionAccountUpdatedEvent.EVENT_TYPE,
+            payload: event.toPayload(),
+          };
+        });
+
+        await this.outboxRepository.saveMany(events);
+        totalPublished += accounts.length;
+
+        if (accounts.length < pageSize || page * pageSize >= total) {
+          break;
+        }
+        page++;
+      }
+
+      this.logger.log(`Daily full sync completed: published ${totalPublished} contribution account events`);
+    } catch (error) {
+      this.logger.error('Failed to publish all account updates', error);
+    } finally {
+      await this.redis.releaseLock(`${this.LOCK_KEY}:full-sync`, lockValue);
+    }
+  }
 }

backend/services/contribution-service/src/application/services/bonus-claim.service.ts

@@ -0,0 +1,274 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { UnallocatedContributionRepository, UnallocatedContribution } from '../../infrastructure/persistence/repositories/unallocated-contribution.repository';
+import { ContributionAccountRepository } from '../../infrastructure/persistence/repositories/contribution-account.repository';
+import { ContributionRecordRepository } from '../../infrastructure/persistence/repositories/contribution-record.repository';
+import { SystemAccountRepository } from '../../infrastructure/persistence/repositories/system-account.repository';
+import { OutboxRepository } from '../../infrastructure/persistence/repositories/outbox.repository';
+import { SyncedDataRepository } from '../../infrastructure/persistence/repositories/synced-data.repository';
+import { UnitOfWork } from '../../infrastructure/persistence/unit-of-work/unit-of-work';
+import { ContributionRecordAggregate } from '../../domain/aggregates/contribution-record.aggregate';
+import { ContributionSourceType } from '../../domain/aggregates/contribution-account.aggregate';
+import { ContributionAmount } from '../../domain/value-objects/contribution-amount.vo';
+import { DistributionRate } from '../../domain/value-objects/distribution-rate.vo';
+import { ContributionRecordSyncedEvent, SystemAccountSyncedEvent } from '../../domain/events';
+
+/**
+ * 奖励补发服务
+ * 当用户解锁新的奖励档位时，补发之前所有认种对应的奖励
+ */
+@Injectable()
+export class BonusClaimService {
+  private readonly logger = new Logger(BonusClaimService.name);
+
+  constructor(
+    private readonly unallocatedContributionRepository: UnallocatedContributionRepository,
+    private readonly contributionAccountRepository: ContributionAccountRepository,
+    private readonly contributionRecordRepository: ContributionRecordRepository,
+    private readonly systemAccountRepository: SystemAccountRepository,
+    private readonly outboxRepository: OutboxRepository,
+    private readonly syncedDataRepository: SyncedDataRepository,
+    private readonly unitOfWork: UnitOfWork,
+  ) {}
+
+  /**
+   * 检查并处理奖励补发
+   * 当用户的直推认种人数变化时调用
+   * @param accountSequence 用户账号
+   * @param previousCount 之前的直推认种人数
+   * @param newCount 新的直推认种人数
+   */
+  async checkAndClaimBonus(
+    accountSequence: string,
+    previousCount: number,
+    newCount: number,
+  ): Promise<void> {
+    // 检查是否达到新的解锁条件
+    const tiersToClaimList: number[] = [];
+
+    // T2: 直推≥2人认种时解锁
+    if (previousCount < 2 && newCount >= 2) {
+      tiersToClaimList.push(2);
+    }
+
+    // T3: 直推≥4人认种时解锁
+    if (previousCount < 4 && newCount >= 4) {
+      tiersToClaimList.push(3);
+    }
+
+    if (tiersToClaimList.length === 0) {
+      return;
+    }
+
+    this.logger.log(
+      `User ${accountSequence} unlocked bonus tiers: ${tiersToClaimList.join(', ')} ` +
+        `(directReferralAdoptedCount: ${previousCount} -> ${newCount})`,
+    );
+
+    // 检查是否已在事务中（被 ContributionCalculationService 调用时）
+    // 如果已在事务中，直接执行，避免嵌套事务导致超时
+    if (this.unitOfWork.isInTransaction()) {
+      for (const tier of tiersToClaimList) {
+        await this.claimBonusTier(accountSequence, tier);
+      }
+    } else {
+      // 独立调用时，开启新事务
+      await this.unitOfWork.executeInTransaction(async () => {
+        for (const tier of tiersToClaimList) {
+          await this.claimBonusTier(accountSequence, tier);
+        }
+      });
+    }
+  }
+
+  /**
+   * 补发指定档位的奖励
+   */
+  private async claimBonusTier(accountSequence: string, bonusTier: number): Promise<void> {
+    // 1. 查询待领取的记录
+    const pendingRecords = await this.unallocatedContributionRepository.findPendingBonusByAccountSequence(
+      accountSequence,
+      bonusTier,
+    );
+
+    if (pendingRecords.length === 0) {
+      this.logger.debug(`No pending T${bonusTier} bonus records for ${accountSequence}`);
+      return;
+    }
+
+    this.logger.log(
+      `Claiming ${pendingRecords.length} T${bonusTier} bonus records for ${accountSequence}`,
+    );
+
+    // 2. 查询原始认种数据，获取 treeCount 和 baseContribution
+    const adoptionDataMap = new Map<string, { treeCount: number; baseContribution: ContributionAmount }>();
+    for (const pending of pendingRecords) {
+      const adoptionIdStr = pending.sourceAdoptionId.toString();
+      if (!adoptionDataMap.has(adoptionIdStr)) {
+        const adoption = await this.syncedDataRepository.findSyncedAdoptionByOriginalId(pending.sourceAdoptionId);
+        if (adoption) {
+          adoptionDataMap.set(adoptionIdStr, {
+            treeCount: adoption.treeCount,
+            baseContribution: new ContributionAmount(adoption.contributionPerTree),
+          });
+        } else {
+          // 如果找不到原始认种数据，使用默认值并记录警告
+          this.logger.warn(`Adoption not found for sourceAdoptionId: ${pending.sourceAdoptionId}, using default values`);
+          adoptionDataMap.set(adoptionIdStr, {
+            treeCount: 0,
+            baseContribution: new ContributionAmount(0),
+          });
+        }
+      }
+    }
+
+    // 3. 创建贡献值记录
+    const contributionRecords: ContributionRecordAggregate[] = [];
+    for (const pending of pendingRecords) {
+      const adoptionData = adoptionDataMap.get(pending.sourceAdoptionId.toString())!;
+      const record = new ContributionRecordAggregate({
+        accountSequence: accountSequence,
+        sourceType: ContributionSourceType.TEAM_BONUS,
+        sourceAdoptionId: pending.sourceAdoptionId,
+        sourceAccountSequence: pending.sourceAccountSequence,
+        treeCount: adoptionData.treeCount,
+        baseContribution: adoptionData.baseContribution,
+        distributionRate: DistributionRate.BONUS_PER,
+        bonusTier: bonusTier,
+        amount: pending.amount,
+        effectiveDate: pending.effectiveDate,
+        expireDate: pending.expireDate,
+      });
+      contributionRecords.push(record);
+    }
+
+    // 4. 保存贡献值记录
+    const savedRecords = await this.contributionRecordRepository.saveMany(contributionRecords);
+
+    // 5. 更新用户的贡献值账户
+    let totalAmount = new ContributionAmount(0);
+    for (const pending of pendingRecords) {
+      totalAmount = new ContributionAmount(totalAmount.value.plus(pending.amount.value));
+    }
+
+    await this.contributionAccountRepository.updateContribution(
+      accountSequence,
+      ContributionSourceType.TEAM_BONUS,
+      totalAmount,
+      null,
+      bonusTier,
+    );
+
+    // 6. 标记待领取记录为已分配
+    const pendingIds = pendingRecords.map((r) => r.id);
+    await this.unallocatedContributionRepository.claimBonusRecords(pendingIds, accountSequence);
+
+    // 7. 从 HEADQUARTERS 减少算力并删除明细记录
+    await this.systemAccountRepository.subtractContribution('HEADQUARTERS', null, totalAmount);
+    for (const pending of pendingRecords) {
+      await this.systemAccountRepository.deleteContributionRecordsByAdoption(
+        'HEADQUARTERS',
+        null,
+        pending.sourceAdoptionId,
+        pending.sourceAccountSequence,
+      );
+    }
+
+    // 8. 发布 HEADQUARTERS 账户更新事件
+    const headquartersAccount = await this.systemAccountRepository.findByTypeAndRegion('HEADQUARTERS', null);
+    if (headquartersAccount) {
+      const hqEvent = new SystemAccountSyncedEvent(
+        'HEADQUARTERS',
+        null,
+        headquartersAccount.name,
+        headquartersAccount.contributionBalance.value.toString(),
+        headquartersAccount.createdAt,
+      );
+      await this.outboxRepository.save({
+        aggregateType: SystemAccountSyncedEvent.AGGREGATE_TYPE,
+        aggregateId: 'HEADQUARTERS',
+        eventType: SystemAccountSyncedEvent.EVENT_TYPE,
+        payload: hqEvent.toPayload(),
+      });
+    }
+
+    // 9. 发布事件到 Kafka（通过 Outbox）
+    await this.publishBonusClaimEvents(accountSequence, savedRecords, pendingRecords);
+
+    this.logger.log(
+      `Claimed T${bonusTier} bonus for ${accountSequence}: ` +
+        `${pendingRecords.length} records, total amount: ${totalAmount.value.toString()}`,
+    );
+  }
+
+  /**
+   * 发布补发事件
+   */
+  private async publishBonusClaimEvents(
+    accountSequence: string,
+    savedRecords: ContributionRecordAggregate[],
+    pendingRecords: UnallocatedContribution[],
+  ): Promise<void> {
+    // 1. 发布贡献值记录同步事件（用于 mining-admin-service CDC）
+    for (const record of savedRecords) {
+      const event = new ContributionRecordSyncedEvent(
+        record.id!,
+        record.accountSequence,
+        record.sourceType,
+        record.sourceAdoptionId,
+        record.sourceAccountSequence,
+        record.treeCount,
+        record.baseContribution.value.toString(),
+        record.distributionRate.value.toString(),
+        record.levelDepth,
+        record.bonusTier,
+        record.amount.value.toString(),
+        record.effectiveDate,
+        record.expireDate,
+        record.isExpired,
+        record.createdAt,
+      );
+
+      await this.outboxRepository.save({
+        aggregateType: ContributionRecordSyncedEvent.AGGREGATE_TYPE,
+        aggregateId: record.id!.toString(),
+        eventType: ContributionRecordSyncedEvent.EVENT_TYPE,
+        payload: event.toPayload(),
+      });
+    }
+
+    // 2. 发布补发事件到 mining-wallet-service
+    const userContributions = savedRecords.map((record, index) => ({
+      accountSequence: record.accountSequence,
+      contributionType: 'TEAM_BONUS',
+      amount: record.amount.value.toString(),
+      bonusTier: record.bonusTier,
+      effectiveDate: record.effectiveDate.toISOString(),
+      expireDate: record.expireDate.toISOString(),
+      sourceAdoptionId: record.sourceAdoptionId.toString(),
+      sourceAccountSequence: record.sourceAccountSequence,
+      isBackfill: true, // 标记为补发
+    }));
+
+    const eventId = `bonus-claim-${accountSequence}-${Date.now()}`;
+    const payload = {
+      eventType: 'BonusClaimed',
+      eventId,
+      timestamp: new Date().toISOString(),
+      payload: {
+        accountSequence,
+        bonusTier: savedRecords[0]?.bonusTier,
+        claimedCount: savedRecords.length,
+        userContributions,
+      },
+    };
+
+    await this.outboxRepository.save({
+      eventType: 'BonusClaimed',
+      topic: 'contribution.bonus.claimed',
+      key: accountSequence,
+      payload,
+      aggregateId: accountSequence,
+      aggregateType: 'ContributionAccount',
+    });
+  }
+}

backend/services/contribution-service/src/application/services/contribution-calculation.service.ts

@@ -9,10 +9,12 @@ import { OutboxRepository } from '../../infrastructure/persistence/repositories/
 import { UnitOfWork } from '../../infrastructure/persistence/unit-of-work/unit-of-work';
 import { ContributionAccountAggregate, ContributionSourceType } from '../../domain/aggregates/contribution-account.aggregate';
 import { ContributionRecordAggregate } from '../../domain/aggregates/contribution-record.aggregate';
+import { ContributionAmount } from '../../domain/value-objects/contribution-amount.vo';
 import { SyncedReferral } from '../../domain/repositories/synced-data.repository.interface';
 import { ContributionDistributionPublisherService } from './contribution-distribution-publisher.service';
 import { ContributionRateService } from './contribution-rate.service';
-import { ContributionRecordSyncedEvent, NetworkProgressUpdatedEvent } from '../../domain/events';
+import { BonusClaimService } from './bonus-claim.service';
+import { ContributionRecordSyncedEvent, NetworkProgressUpdatedEvent, ContributionAccountUpdatedEvent, SystemAccountSyncedEvent, SystemContributionRecordCreatedEvent, UnallocatedContributionSyncedEvent } from '../../domain/events';
 
 /**
  * 算力计算应用服务
@@ -33,6 +35,7 @@ export class ContributionCalculationService {
     private readonly unitOfWork: UnitOfWork,
     private readonly distributionPublisher: ContributionDistributionPublisherService,
     private readonly contributionRateService: ContributionRateService,
+    private readonly bonusClaimService: BonusClaimService,
   ) {}
 
   /**
@@ -111,6 +114,49 @@ export class ContributionCalculationService {
         `teamBonus=${result.teamBonusRecords.length}, ` +
         `unallocated=${result.unallocatedContributions.length}`,
     );
+
+    // 更新全网认种进度（更新 NetworkAdoptionProgress 表）
+    // 判断是否为新认种用户：之前没有账户记录即为新用户
+    const isNewUser = !adopterAccount;
+    await this.contributionRateService.updateNetworkProgress(
+      adoption.treeCount,
+      adoption.adoptionDate,
+      adoption.originalAdoptionId,
+      isNewUser,
+    );
+
+    // 发布全网进度更新事件（用于 mining-service 同步全网理论算力）
+    await this.publishNetworkProgressEvent();
+  }
+
+  /**
+   * 发布全网进度更新事件
+   */
+  private async publishNetworkProgressEvent(): Promise<void> {
+    try {
+      const progress = await this.contributionRateService.getNetworkProgress();
+
+      const event = new NetworkProgressUpdatedEvent(
+        progress.totalTreeCount,
+        progress.totalAdoptionOrders,
+        progress.totalAdoptedUsers,
+        progress.currentUnit,
+        progress.currentMultiplier.toString(),
+        progress.currentContributionPerTree.toString(),
+        progress.nextUnitTreeCount,
+      );
+
+      await this.outboxRepository.save({
+        aggregateType: NetworkProgressUpdatedEvent.AGGREGATE_TYPE,
+        aggregateId: 'network',
+        eventType: NetworkProgressUpdatedEvent.EVENT_TYPE,
+        payload: event.toPayload(),
+      });
+
+      this.logger.debug(`Published NetworkProgressUpdatedEvent: trees=${progress.totalTreeCount}`);
+    } catch (error) {
+      this.logger.error('Failed to publish NetworkProgressUpdatedEvent', error);
+    }
   }
 
   /**
@@ -164,6 +210,8 @@ export class ContributionCalculationService {
   ): Promise<void> {
     // 收集所有保存后的记录（带ID）用于发布事件
     const savedRecords: ContributionRecordAggregate[] = [];
+    // 收集所有被更新的账户序列号（用于发布账户更新事件）
+    const updatedAccountSequences = new Set<string>();
 
     // 1. 保存个人算力记录
     const savedPersonalRecord = await this.contributionRecordRepository.save(result.personalRecord);
@@ -178,6 +226,7 @@ export class ContributionCalculationService {
     }
     account.addPersonalContribution(result.personalRecord.amount);
     await this.contributionAccountRepository.save(account);
+    updatedAccountSequences.add(result.personalRecord.accountSequence);
 
     // 2. 保存团队层级算力记录
     if (result.teamLevelRecords.length > 0) {
@@ -193,6 +242,7 @@ export class ContributionCalculationService {
           record.levelDepth,  // 传递层级深度
           null,
         );
+        updatedAccountSequences.add(record.accountSequence);
       }
     }
 
@@ -210,6 +260,7 @@ export class ContributionCalculationService {
           null,
           record.bonusTier,  // 传递加成档位
         );
+        updatedAccountSequences.add(record.accountSequence);
       }
     }
 
@@ -217,7 +268,7 @@ export class ContributionCalculationService {
     const effectiveDate = result.personalRecord.effectiveDate;
     const expireDate = result.personalRecord.expireDate;
 
-    // 4. 保存未分配算力
+    // 4. 保存未分配算力并发布同步事件
     if (result.unallocatedContributions.length > 0) {
       await this.unallocatedContributionRepository.saveMany(
         result.unallocatedContributions.map((u) => ({
@@ -228,28 +279,189 @@ export class ContributionCalculationService {
           expireDate,
         })),
       );
+
+      // 汇总未分配算力到 HEADQUARTERS（总部账户）
+      const totalUnallocatedAmount = result.unallocatedContributions.reduce(
+        (sum, u) => sum.add(u.amount),
+        new ContributionAmount(0),
+      );
+      await this.systemAccountRepository.addContribution(
+        'HEADQUARTERS',
+        null,
+        totalUnallocatedAmount,
+      );
+
+      // 为每笔未分配算力创建 HEADQUARTERS 明细记录
+      for (const unallocated of result.unallocatedContributions) {
+        // 确定来源类型和层级深度
+        const sourceType = unallocated.type as string; // LEVEL_OVERFLOW / LEVEL_NO_ANCESTOR / BONUS_TIER_1/2/3
+        const levelDepth = unallocated.levelDepth;
+
+        const savedRecord = await this.systemAccountRepository.saveContributionRecord({
+          accountType: 'HEADQUARTERS',
+          regionCode: null,
+          sourceAdoptionId,
+          sourceAccountSequence,
+          sourceType,
+          levelDepth,
+          distributionRate: 0, // 未分配算力没有固定比例
+          amount: unallocated.amount,
+          effectiveDate,
+          expireDate: null,
+        });
+
+        // 发布 HEADQUARTERS 算力明细事件
+        const recordEvent = new SystemContributionRecordCreatedEvent(
+          savedRecord.id,
+          'HEADQUARTERS',
+          null,
+          sourceAdoptionId,
+          sourceAccountSequence,
+          sourceType as any,
+          levelDepth,
+          0,
+          unallocated.amount.value.toString(),
+          effectiveDate,
+          null,
+          savedRecord.createdAt,
+        );
+        await this.outboxRepository.save({
+          aggregateType: SystemContributionRecordCreatedEvent.AGGREGATE_TYPE,
+          aggregateId: savedRecord.id.toString(),
+          eventType: SystemContributionRecordCreatedEvent.EVENT_TYPE,
+          payload: recordEvent.toPayload(),
+        });
+      }
+
+      // 发布 HEADQUARTERS 账户同步事件
+      const headquartersAccount = await this.systemAccountRepository.findByTypeAndRegion('HEADQUARTERS', null);
+      if (headquartersAccount) {
+        const hqEvent = new SystemAccountSyncedEvent(
+          'HEADQUARTERS',
+          null,            // 区域代码（总部没有区域）
+          headquartersAccount.name,
+          headquartersAccount.contributionBalance.value.toString(),
+          headquartersAccount.createdAt,
+        );
+        await this.outboxRepository.save({
+          aggregateType: SystemAccountSyncedEvent.AGGREGATE_TYPE,
+          aggregateId: 'HEADQUARTERS',
+          eventType: SystemAccountSyncedEvent.EVENT_TYPE,
+          payload: hqEvent.toPayload(),
+        });
+      }
+
+      // 发布未分配算力同步事件（用于 mining-service 同步待解锁算力）
+      for (const unallocated of result.unallocatedContributions) {
+        const event = new UnallocatedContributionSyncedEvent(
+          sourceAdoptionId,
+          sourceAccountSequence,
+          unallocated.wouldBeAccountSequence,
+          unallocated.type,
+          unallocated.amount.value.toString(),
+          unallocated.reason,
+          effectiveDate,
+          expireDate,
+        );
+        await this.outboxRepository.save({
+          aggregateType: UnallocatedContributionSyncedEvent.AGGREGATE_TYPE,
+          aggregateId: `${sourceAdoptionId}-${unallocated.type}`,
+          eventType: UnallocatedContributionSyncedEvent.EVENT_TYPE,
+          payload: event.toPayload(),
+        });
+      }
     }
 
-    // 5. 保存系统账户算力
+    // 5. 保存系统账户算力并发布同步事件
     if (result.systemContributions.length > 0) {
       await this.systemAccountRepository.ensureSystemAccountsExist();
 
       for (const sys of result.systemContributions) {
-        await this.systemAccountRepository.addContribution(sys.accountType, sys.amount);
+        // 动态创建/更新系统账户
-        await this.systemAccountRepository.saveContributionRecord({
+        await this.systemAccountRepository.addContribution(
-          systemAccountType: sys.accountType,
+          sys.accountType,
+          sys.regionCode,
+          sys.amount,
+        );
+
+        // 保存算力明细记录
+        const savedRecord = await this.systemAccountRepository.saveContributionRecord({
+          accountType: sys.accountType,
+          regionCode: sys.regionCode,
           sourceAdoptionId,
           sourceAccountSequence,
+          sourceType: 'FIXED_RATE',  // 固定比例分配
+          levelDepth: null,
           distributionRate: sys.rate.value.toNumber(),
           amount: sys.amount,
           effectiveDate,
-          expireDate: null, // System account contributions never expire based on the schema's contributionNeverExpires field
+          expireDate: null,
         });
+
+        // 发布系统账户同步事件（用于 mining-service 同步系统账户算力）
+        const systemAccount = await this.systemAccountRepository.findByTypeAndRegion(
+          sys.accountType,
+          sys.regionCode,
+        );
+        if (systemAccount) {
+          const event = new SystemAccountSyncedEvent(
+            sys.accountType,
+            sys.regionCode,
+            systemAccount.name,
+            systemAccount.contributionBalance.value.toString(),
+            systemAccount.createdAt,
+          );
+          await this.outboxRepository.save({
+            aggregateType: SystemAccountSyncedEvent.AGGREGATE_TYPE,
+            aggregateId: `${sys.accountType}:${sys.regionCode || 'null'}`,
+            eventType: SystemAccountSyncedEvent.EVENT_TYPE,
+            payload: event.toPayload(),
+          });
+
+          // 发布系统账户算力明细事件（用于 mining-admin-service 同步明细记录）
+          const recordEvent = new SystemContributionRecordCreatedEvent(
+            savedRecord.id,
+            sys.accountType,
+            sys.regionCode,  // 传递区域代码
+            sourceAdoptionId,
+            sourceAccountSequence,
+            'FIXED_RATE',    // 固定比例分配
+            null,            // 无层级深度
+            sys.rate.value.toNumber(),
+            sys.amount.value.toString(),
+            effectiveDate,
+            null,
+            savedRecord.createdAt,
+          );
+          await this.outboxRepository.save({
+            aggregateType: SystemContributionRecordCreatedEvent.AGGREGATE_TYPE,
+            aggregateId: savedRecord.id.toString(),
+            eventType: SystemContributionRecordCreatedEvent.EVENT_TYPE,
+            payload: recordEvent.toPayload(),
+          });
+        }
       }
     }
 
     // 6. 发布算力记录同步事件（用于 mining-admin-service）- 使用保存后带 ID 的记录
     await this.publishContributionRecordEvents(savedRecords);
+
+    // 7. 发布所有被更新账户的事件（用于 CDC 同步到 mining-admin-service）
+    await this.publishUpdatedAccountEvents(updatedAccountSequences);
+  }
+
+  /**
+   * 发布被更新账户的事件
+   */
+  private async publishUpdatedAccountEvents(accountSequences: Set<string>): Promise<void> {
+    if (accountSequences.size === 0) return;
+
+    for (const accountSequence of accountSequences) {
+      const account = await this.contributionAccountRepository.findByAccountSequence(accountSequence);
+      if (account) {
+        await this.publishContributionAccountUpdatedEvent(account);
+      }
+    }
   }
 
   /**
@@ -300,11 +512,15 @@ export class ContributionCalculationService {
     if (!account.hasAdopted) {
       account.markAsAdopted();
       await this.contributionAccountRepository.save(account);
+
+      // 发布账户更新事件到 outbox（用于 CDC 同步到 mining-admin-service）
+      await this.publishContributionAccountUpdatedEvent(account);
     }
   }
 
   /**
    * 更新上线的解锁状态（直推用户认种后）
+   * 如果解锁了新的奖励档位，会触发补发逻辑
    */
   private async updateReferrerUnlockStatus(referrerAccountSequence: string): Promise<void> {
     const account = await this.contributionAccountRepository.findByAccountSequence(referrerAccountSequence);
@@ -316,16 +532,27 @@ export class ContributionCalculationService {
     );
 
     // 更新解锁状态
-    const currentCount = account.directReferralAdoptedCount;
+    const previousCount = account.directReferralAdoptedCount;
-    if (directReferralAdoptedCount > currentCount) {
+    if (directReferralAdoptedCount > previousCount) {
       // 需要增量更新
-      for (let i = currentCount; i < directReferralAdoptedCount; i++) {
+      for (let i = previousCount; i < directReferralAdoptedCount; i++) {
         account.incrementDirectReferralAdoptedCount();
       }
       await this.contributionAccountRepository.save(account);
+
+      // 发布账户更新事件到 outbox（用于 CDC 同步到 mining-admin-service）
+      await this.publishContributionAccountUpdatedEvent(account);
+
       this.logger.debug(
         `Updated referrer ${referrerAccountSequence} unlock status: level=${account.unlockedLevelDepth}, bonus=${account.unlockedBonusTiers}`,
       );
+
+      // 检查并处理奖励补发（T2: 直推≥2人, T3: 直推≥4人）
+      await this.bonusClaimService.checkAndClaimBonus(
+        referrerAccountSequence,
+        previousCount,
+        directReferralAdoptedCount,
+      );
     }
   }
 
@@ -393,4 +620,43 @@ export class ContributionCalculationService {
       },
     };
   }
+
+  /**
+   * 发布贡献值账户更新事件（用于 CDC 同步到 mining-admin-service）
+   */
+  private async publishContributionAccountUpdatedEvent(
+    account: ContributionAccountAggregate,
+  ): Promise<void> {
+    // 总算力 = 个人算力 + 层级待解锁 + 加成待解锁
+    const totalContribution = account.personalContribution.value
+      .plus(account.totalLevelPending.value)
+      .plus(account.totalBonusPending.value);
+
+    const event = new ContributionAccountUpdatedEvent(
+      account.accountSequence,
+      account.personalContribution.value.toString(),
+      account.totalLevelPending.value.toString(),
+      account.totalBonusPending.value.toString(),
+      totalContribution.toString(),
+      account.effectiveContribution.value.toString(),
+      account.hasAdopted,
+      account.directReferralAdoptedCount,
+      account.unlockedLevelDepth,
+      account.unlockedBonusTiers,
+      account.createdAt,
+    );
+
+    await this.outboxRepository.save({
+      aggregateType: ContributionAccountUpdatedEvent.AGGREGATE_TYPE,
+      aggregateId: account.accountSequence,
+      eventType: ContributionAccountUpdatedEvent.EVENT_TYPE,
+      payload: event.toPayload(),
+    });
+
+    this.logger.debug(
+      `Published ContributionAccountUpdatedEvent for ${account.accountSequence}: ` +
+        `directReferralAdoptedCount=${account.directReferralAdoptedCount}, ` +
+        `hasAdopted=${account.hasAdopted}`,
+    );
+  }
 }

backend/services/contribution-service/src/application/services/contribution-distribution-publisher.service.ts

@@ -121,11 +121,16 @@ export class ContributionDistributionPublisherService {
     return result.systemContributions.map((sys) => ({
       accountType: sys.accountType,
       amount: sys.amount.value.toString(),
+      // 省份代码：PROVINCE 用自己的 regionCode，CITY 需要传递省份代码用于创建省份
       provinceCode:
-        sys.accountType === 'PROVINCE' || sys.accountType === 'CITY'
+        sys.accountType === 'PROVINCE'
-          ? provinceCode
+          ? sys.regionCode || provinceCode
-          : undefined,
+          : sys.accountType === 'CITY'
-      cityCode: sys.accountType === 'CITY' ? cityCode : undefined,
+            ? provinceCode  // CITY 需要省份代码来创建省份（如果省份不存在）
+            : undefined,
+      // 城市代码：只有 CITY 类型有
+      cityCode:
+        sys.accountType === 'CITY' ? sys.regionCode || cityCode : undefined,
       neverExpires: sys.accountType === 'OPERATION', // 运营账户永不过期
     }));
   }

backend/services/contribution-service/src/domain/events/contribution-account-updated.event.ts

@@ -0,0 +1,40 @@
+/**
+ * 贡献值账户更新事件
+ * 当账户的 directReferralAdoptedCount, unlockedLevelDepth, unlockedBonusTiers 等字段更新时发布
+ * 用于实时同步到 mining-admin-service
+ */
+export class ContributionAccountUpdatedEvent {
+  static readonly EVENT_TYPE = 'ContributionAccountUpdated';
+  static readonly AGGREGATE_TYPE = 'ContributionAccount';
+
+  constructor(
+    public readonly accountSequence: string,
+    public readonly personalContribution: string,
+    public readonly teamLevelContribution: string,
+    public readonly teamBonusContribution: string,
+    public readonly totalContribution: string,
+    public readonly effectiveContribution: string,
+    public readonly hasAdopted: boolean,
+    public readonly directReferralAdoptedCount: number,
+    public readonly unlockedLevelDepth: number,
+    public readonly unlockedBonusTiers: number,
+    public readonly createdAt: Date,
+  ) {}
+
+  toPayload(): Record<string, any> {
+    return {
+      eventType: ContributionAccountUpdatedEvent.EVENT_TYPE,
+      accountSequence: this.accountSequence,
+      personalContribution: this.personalContribution,
+      teamLevelContribution: this.teamLevelContribution,
+      teamBonusContribution: this.teamBonusContribution,
+      totalContribution: this.totalContribution,
+      effectiveContribution: this.effectiveContribution,
+      hasAdopted: this.hasAdopted,
+      directReferralAdoptedCount: this.directReferralAdoptedCount,
+      unlockedLevelDepth: this.unlockedLevelDepth,
+      unlockedBonusTiers: this.unlockedBonusTiers,
+      createdAt: this.createdAt.toISOString(),
+    };
+  }
+}

backend/services/contribution-service/src/domain/events/index.ts

@@ -1,7 +1,11 @@
 export * from './contribution-calculated.event';
 export * from './daily-snapshot-created.event';
 export * from './contribution-account-synced.event';
+export * from './contribution-account-updated.event';
 export * from './referral-synced.event';
 export * from './adoption-synced.event';
 export * from './contribution-record-synced.event';
 export * from './network-progress-updated.event';
+export * from './system-account-synced.event';
+export * from './system-contribution-record-created.event';
+export * from './unallocated-contribution-synced.event';

backend/services/contribution-service/src/domain/events/system-account-synced.event.ts

@@ -0,0 +1,27 @@
+/**
+ * 系统账户算力同步事件
+ * 用于将系统账户（运营、省、市、总部）的算力同步到 mining-service
+ */
+export class SystemAccountSyncedEvent {
+  static readonly EVENT_TYPE = 'SystemAccountSynced';
+  static readonly AGGREGATE_TYPE = 'SystemAccount';
+
+  constructor(
+    public readonly accountType: string, // OPERATION / PROVINCE / CITY / HEADQUARTERS
+    public readonly regionCode: string | null, // 省/市代码，如 440000, 440100
+    public readonly name: string,
+    public readonly contributionBalance: string,
+    public readonly createdAt: Date,
+  ) {}
+
+  toPayload(): Record<string, any> {
+    return {
+      eventType: SystemAccountSyncedEvent.EVENT_TYPE,
+      accountType: this.accountType,
+      regionCode: this.regionCode,
+      name: this.name,
+      contributionBalance: this.contributionBalance,
+      createdAt: this.createdAt.toISOString(),
+    };
+  }
+}

backend/services/contribution-service/src/domain/events/system-contribution-record-created.event.ts

@@ -0,0 +1,56 @@
+/**
+ * 来源类型枚举
+ * - FIXED_RATE: 固定比例分配（OPERATION 12%、PROVINCE 1%、CITY 2%）
+ * - LEVEL_OVERFLOW: 层级溢出归总部（上线未解锁该级别）
+ * - LEVEL_NO_ANCESTOR: 无上线归总部（该级无上线）
+ * - BONUS_TIER_1/2/3: 团队奖励未解锁归总部
+ */
+export type SystemContributionSourceType =
+  | 'FIXED_RATE'
+  | 'LEVEL_OVERFLOW'
+  | 'LEVEL_NO_ANCESTOR'
+  | 'BONUS_TIER_1'
+  | 'BONUS_TIER_2'
+  | 'BONUS_TIER_3';
+
+/**
+ * 系统账户算力明细创建事件
+ * 用于将系统账户的每笔算力来源明细同步到 mining-admin-service
+ */
+export class SystemContributionRecordCreatedEvent {
+  static readonly EVENT_TYPE = 'SystemContributionRecordCreated';
+  static readonly AGGREGATE_TYPE = 'SystemContributionRecord';
+
+  constructor(
+    public readonly recordId: bigint,                  // 明细记录ID
+    public readonly accountType: string,              // 系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）
+    public readonly regionCode: string | null,        // 区域代码（省/市代码，如 440000, 440100）
+    public readonly sourceAdoptionId: bigint,          // 来源认种ID
+    public readonly sourceAccountSequence: string,     // 认种人账号
+    public readonly sourceType: SystemContributionSourceType, // 来源类型
+    public readonly levelDepth: number | null,         // 层级深度（1-15），仅对 LEVEL_OVERFLOW/LEVEL_NO_ANCESTOR 有效
+    public readonly distributionRate: number,          // 分配比例
+    public readonly amount: string,                    // 算力金额
+    public readonly effectiveDate: Date,               // 生效日期
+    public readonly expireDate: Date | null,           // 过期日期
+    public readonly createdAt: Date,                   // 创建时间
+  ) {}
+
+  toPayload(): Record<string, any> {
+    return {
+      eventType: SystemContributionRecordCreatedEvent.EVENT_TYPE,
+      recordId: this.recordId.toString(),
+      accountType: this.accountType,
+      regionCode: this.regionCode,
+      sourceAdoptionId: this.sourceAdoptionId.toString(),
+      sourceAccountSequence: this.sourceAccountSequence,
+      sourceType: this.sourceType,
+      levelDepth: this.levelDepth,
+      distributionRate: this.distributionRate,
+      amount: this.amount,
+      effectiveDate: this.effectiveDate.toISOString(),
+      expireDate: this.expireDate?.toISOString() ?? null,
+      createdAt: this.createdAt.toISOString(),
+    };
+  }
+}

backend/services/contribution-service/src/domain/events/unallocated-contribution-synced.event.ts

@@ -0,0 +1,33 @@
+/**
+ * 未分配算力同步事件
+ * 用于同步待解锁算力到 mining-service
+ */
+export class UnallocatedContributionSyncedEvent {
+  static readonly EVENT_TYPE = 'UnallocatedContributionSynced';
+  static readonly AGGREGATE_TYPE = 'UnallocatedContribution';
+
+  constructor(
+    public readonly sourceAdoptionId: bigint,
+    public readonly sourceAccountSequence: string,
+    public readonly wouldBeAccountSequence: string | null,
+    public readonly contributionType: string, // LEVEL_NO_ANCESTOR, LEVEL_OVERFLOW, BONUS_TIER_1, BONUS_TIER_2, BONUS_TIER_3
+    public readonly amount: string,
+    public readonly reason: string | null,
+    public readonly effectiveDate: Date,
+    public readonly expireDate: Date,
+  ) {}
+
+  toPayload(): Record<string, any> {
+    return {
+      eventType: UnallocatedContributionSyncedEvent.EVENT_TYPE,
+      sourceAdoptionId: this.sourceAdoptionId.toString(),
+      sourceAccountSequence: this.sourceAccountSequence,
+      wouldBeAccountSequence: this.wouldBeAccountSequence,
+      contributionType: this.contributionType,
+      amount: this.amount,
+      reason: this.reason,
+      effectiveDate: this.effectiveDate.toISOString(),
+      expireDate: this.expireDate.toISOString(),
+    };
+  }
+}

backend/services/contribution-service/src/domain/services/contribution-calculator.service.ts

@@ -5,6 +5,16 @@ import { ContributionAccountAggregate, ContributionSourceType } from '../aggrega
 import { ContributionRecordAggregate } from '../aggregates/contribution-record.aggregate';
 import { SyncedAdoption, SyncedReferral } from '../repositories/synced-data.repository.interface';
 
+/**
+ * 系统账户贡献值分配
+ */
+export interface SystemContributionAllocation {
+  accountType: 'OPERATION' | 'PROVINCE' | 'CITY' | 'HEADQUARTERS';
+  regionCode: string | null;  // 省市代码，如 440000、440100
+  rate: DistributionRate;
+  amount: ContributionAmount;
+}
+
 /**
  * 算力分配结果
  */
@@ -27,12 +37,8 @@ export interface ContributionDistributionResult {
     reason: string;
   }[];
 
-  // 系统账户贡献值
+  // 系统账户贡献值（支持按省市细分）
-  systemContributions: {
+  systemContributions: SystemContributionAllocation[];
-    accountType: 'OPERATION' | 'PROVINCE' | 'CITY';
-    rate: DistributionRate;
-    amount: ContributionAmount;
-  }[];
 }
 
 /**
@@ -85,23 +91,31 @@ export class ContributionCalculatorService {
     });
 
     // 2. 系统账户贡献值 (15%)
-    result.systemContributions = [
+    // 运营账户（全国）- 12%
-      {
+    result.systemContributions.push({
-        accountType: 'OPERATION',
+      accountType: 'OPERATION',
-        rate: DistributionRate.OPERATION,
+      regionCode: null,
-        amount: totalContribution.multiply(DistributionRate.OPERATION.value),
+      rate: DistributionRate.OPERATION,
-      },
+      amount: totalContribution.multiply(DistributionRate.OPERATION.value),
-      {
+    });
-        accountType: 'PROVINCE',
+
-        rate: DistributionRate.PROVINCE,
+    // 省公司账户 - 1%（按认种选择的省份）
-        amount: totalContribution.multiply(DistributionRate.PROVINCE.value),
+    const provinceCode = adoption.selectedProvince;
-      },
+    result.systemContributions.push({
-      {
+      accountType: 'PROVINCE',
-        accountType: 'CITY',
+      regionCode: provinceCode || null,
-        rate: DistributionRate.CITY,
+      rate: DistributionRate.PROVINCE,
-        amount: totalContribution.multiply(DistributionRate.CITY.value),
+      amount: totalContribution.multiply(DistributionRate.PROVINCE.value),
-      },
+    });
-    ];
+
+    // 市公司账户 - 2%（按认种选择的城市）
+    const cityCode = adoption.selectedCity;
+    result.systemContributions.push({
+      accountType: 'CITY',
+      regionCode: cityCode || null,
+      rate: DistributionRate.CITY,
+      amount: totalContribution.multiply(DistributionRate.CITY.value),
+    });
 
     // 3. 团队贡献值 (15%)
     this.distributeTeamContribution(

backend/services/contribution-service/src/infrastructure/infrastructure.module.ts

@@ -13,11 +13,11 @@ import { KafkaModule } from './kafka/kafka.module';
 import { KafkaProducerService } from './kafka/kafka-producer.service';
 import { CDCConsumerService } from './kafka/cdc-consumer.service';
 import { RedisModule } from './redis/redis.module';
+import { SYNCED_DATA_REPOSITORY } from '../domain/repositories/synced-data.repository.interface';
 
 // Repository injection tokens
 export const CONTRIBUTION_ACCOUNT_REPOSITORY = 'CONTRIBUTION_ACCOUNT_REPOSITORY';
 export const CONTRIBUTION_RECORD_REPOSITORY = 'CONTRIBUTION_RECORD_REPOSITORY';
-export const SYNCED_DATA_REPOSITORY = 'SYNCED_DATA_REPOSITORY';
 
 @Module({
   imports: [PrismaModule, KafkaModule, RedisModule],

backend/services/contribution-service/src/infrastructure/kafka/cdc-consumer.service.ts

@@ -53,6 +53,12 @@ export type TransactionalCDCHandlerWithResult<T> = (event: CDCEvent, tx: Transac
 /** 事务提交后的回调函数 */
 export type PostCommitCallback<T> = (result: T) => Promise<void>;
 
+/** Topic 消费阶段配置 */
+export interface TopicPhase {
+  topic: string;
+  tableName: string;
+}
+
 @Injectable()
 export class CDCConsumerService implements OnModuleInit, OnModuleDestroy {
   private readonly logger = new Logger(CDCConsumerService.name);
@@ -61,6 +67,14 @@ export class CDCConsumerService implements OnModuleInit, OnModuleDestroy {
   private handlers: Map<string, CDCHandler> = new Map();
   private isRunning = false;
 
+  // 分阶段消费配置
+  private topicPhases: TopicPhase[] = [];
+  private currentPhaseIndex = 0;
+  private sequentialMode = false;
+
+  // 初始同步完成标记（只有顺序同步全部完成后才为 true）
+  private initialSyncCompleted = false;
+
   constructor(
     private readonly configService: ConfigService,
     private readonly prisma: PrismaService,
@@ -247,7 +261,14 @@ export class CDCConsumerService implements OnModuleInit, OnModuleDestroy {
   }
 
   /**
-   * 启动消费者
+   * 启动消费者（顺序模式）
+   *
+   * 按顺序消费三个 topic，确保数据依赖关系正确：
+   * 1. 用户数据 (user_accounts)
+   * 2. 推荐关系 (referral_relationships) - 依赖用户数据
+   * 3. 认种订单 (planting_orders) - 依赖用户和推荐关系
+   *
+   * 每个阶段必须完全消费完毕后才进入下一阶段
    */
   async start(): Promise<void> {
     if (this.isRunning) {
@@ -259,36 +280,213 @@ export class CDCConsumerService implements OnModuleInit, OnModuleDestroy {
       await this.consumer.connect();
       this.logger.log('CDC consumer connected');
 
-      // 订阅 Debezium CDC topics (从1.0服务全量同步)
+      // 配置顺序消费阶段（顺序很重要！）
-      const topics = [
+      this.topicPhases = [
-        // 用户账户表 (identity-service: user_accounts)
+        {
-        this.configService.get<string>('CDC_TOPIC_USERS', 'cdc.identity.public.user_accounts'),
+          topic: this.configService.get<string>('CDC_TOPIC_USERS', 'cdc.identity.public.user_accounts'),
-        // 认种订单表 (planting-service: planting_orders)
+          tableName: 'user_accounts',
-        this.configService.get<string>('CDC_TOPIC_ADOPTIONS', 'cdc.planting.public.planting_orders'),
+        },
-        // 推荐关系表 (referral-service: referral_relationships)
+        {
-        this.configService.get<string>('CDC_TOPIC_REFERRALS', 'cdc.referral.public.referral_relationships'),
+          topic: this.configService.get<string>('CDC_TOPIC_REFERRALS', 'cdc.referral.public.referral_relationships'),
+          tableName: 'referral_relationships',
+        },
+        {
+          topic: this.configService.get<string>('CDC_TOPIC_ADOPTIONS', 'cdc.planting.public.planting_orders'),
+          tableName: 'planting_orders',
+        },
       ];
 
-      await this.consumer.subscribe({
+      this.currentPhaseIndex = 0;
-        topics,
+      this.sequentialMode = true;
-        fromBeginning: true,  // 首次启动时全量同步历史数据
-      });
-      this.logger.log(`Subscribed to topics: ${topics.join(', ')}`);
-
-      await this.consumer.run({
-        eachMessage: async (payload: EachMessagePayload) => {
-          await this.handleMessage(payload);
-        },
-      });
-
       this.isRunning = true;
-      this.logger.log('CDC consumer started with transactional idempotency protection');
+
+      // 开始顺序消费（阻塞直到完成，确保数据依赖顺序正确）
+      await this.startSequentialConsumption();
+
+      this.logger.log('CDC consumer started with sequential phase consumption');
     } catch (error) {
       this.logger.error('Failed to start CDC consumer', error);
       // 不抛出错误，允许服务在没有 Kafka 的情况下启动（用于本地开发）
     }
   }
 
+  /**
+   * 顺序消费所有阶段
+   */
+  private async startSequentialConsumption(): Promise<void> {
+    for (let i = 0; i < this.topicPhases.length; i++) {
+      this.currentPhaseIndex = i;
+      const phase = this.topicPhases[i];
+
+      this.logger.log(`[CDC] Starting phase ${i + 1}/${this.topicPhases.length}: ${phase.tableName} (${phase.topic})`);
+
+      // 消费当前阶段直到追上最新
+      await this.consumePhaseToEnd(phase);
+
+      this.logger.log(`[CDC] Completed phase ${i + 1}/${this.topicPhases.length}: ${phase.tableName}`);
+    }
+
+    this.logger.log('[CDC] All phases completed. Switching to continuous mode...');
+
+    // 所有阶段完成后，切换到持续消费模式（同时监听所有 topic）
+    await this.startContinuousMode();
+  }
+
+  /**
+   * 消费单个阶段直到追上最新消息
+   */
+  private async consumePhaseToEnd(phase: TopicPhase): Promise<void> {
+    const admin = this.kafka.admin();
+    await admin.connect();
+
+    // 获取 topic 的高水位线和最早 offset
+    const topicOffsets = await admin.fetchTopicOffsets(phase.topic);
+    const highWatermarks: Map<number, string> = new Map();
+    const earliestOffsets: Map<number, string> = new Map();
+
+    for (const partitionOffset of topicOffsets) {
+      highWatermarks.set(partitionOffset.partition, partitionOffset.high);
+      earliestOffsets.set(partitionOffset.partition, partitionOffset.low);
+    }
+
+    this.logger.log(`[CDC] Phase ${phase.tableName}: High watermarks = ${JSON.stringify(Object.fromEntries(highWatermarks))}`);
+
+    // 检查是否 topic 为空
+    const allEmpty = Array.from(highWatermarks.values()).every(hw => hw === '0');
+    if (allEmpty) {
+      this.logger.log(`[CDC] Phase ${phase.tableName}: Topic is empty, skipping`);
+      await admin.disconnect();
+      return;
+    }
+
+    // 使用固定的 group id
+    const phaseGroupId = `contribution-service-cdc-phase-${phase.tableName}`;
+
+    // 重置 consumer group 的 offset 到最早位置
+    // 使用 admin.resetOffsets 而不是 setOffsets，更简洁且专门用于重置到 earliest/latest
+    // 这确保每次服务启动都会从头开始消费，不受之前 committed offset 影响
+    // 参考: https://kafka.js.org/docs/admin#a-name-reset-offsets-a-resetoffsets
+    this.logger.log(`[CDC] Phase ${phase.tableName}: Resetting consumer group ${phaseGroupId} offsets to earliest`);
+    try {
+      await admin.resetOffsets({
+        groupId: phaseGroupId,
+        topic: phase.topic,
+        earliest: true,
+      });
+      this.logger.log(`[CDC] Phase ${phase.tableName}: Consumer group offsets reset successfully`);
+    } catch (resetError: any) {
+      // 如果 consumer group 不存在，resetOffsets 会失败，这是正常的（首次运行）
+      // fromBeginning: true 会在这种情况下生效
+      this.logger.log(`[CDC] Phase ${phase.tableName}: Could not reset offsets (may be first run): ${resetError.message}`);
+    }
+
+    const phaseConsumer = this.kafka.consumer({
+      groupId: phaseGroupId,
+    });
+
+    try {
+      await phaseConsumer.connect();
+
+      // 订阅单个 topic，fromBeginning 对新 group 有效
+      await phaseConsumer.subscribe({
+        topic: phase.topic,
+        fromBeginning: true,
+      });
+
+      let processedOffsets: Map<number, bigint> = new Map();
+      let isComplete = false;
+
+      for (const partition of highWatermarks.keys()) {
+        processedOffsets.set(partition, BigInt(-1));
+      }
+
+      // 开始消费
+      await phaseConsumer.run({
+        eachMessage: async (payload: EachMessagePayload) => {
+          await this.handleMessage(payload);
+
+          // 更新已处理的 offset
+          processedOffsets.set(payload.partition, BigInt(payload.message.offset));
+
+          // 检查是否所有 partition 都已追上高水位线
+          let allCaughtUp = true;
+          for (const [partition, highWatermark] of highWatermarks) {
+            const processed = processedOffsets.get(partition) ?? BigInt(-1);
+            // 高水位线是下一个将被写入的 offset，所以已处理的 offset 需要 >= highWatermark - 1
+            if (processed < BigInt(highWatermark) - BigInt(1)) {
+              allCaughtUp = false;
+              break;
+            }
+          }
+
+          if (allCaughtUp && !isComplete) {
+            isComplete = true;
+            this.logger.log(`[CDC] Phase ${phase.tableName}: Caught up with all partitions`);
+          }
+        },
+      });
+
+      // 等待追上高水位线
+      while (!isComplete) {
+        await new Promise(resolve => setTimeout(resolve, 100));
+
+        // 每秒检查一次进度
+        const currentProgress = Array.from(processedOffsets.entries())
+          .map(([p, o]) => `P${p}:${o}/${highWatermarks.get(p)}`)
+          .join(', ');
+        this.logger.debug(`[CDC] Phase ${phase.tableName} progress: ${currentProgress}`);
+      }
+
+      // 停止消费
+      await phaseConsumer.stop();
+      await phaseConsumer.disconnect();
+      await admin.disconnect();
+
+    } catch (error) {
+      this.logger.error(`[CDC] Error in phase ${phase.tableName}`, error);
+      await phaseConsumer.disconnect();
+      await admin.disconnect();
+      throw error;
+    }
+  }
+
+  /**
+   * 切换到持续消费模式（所有 topic 同时消费）
+   */
+  private async startContinuousMode(): Promise<void> {
+    this.sequentialMode = false;
+    this.initialSyncCompleted = true;  // 标记初始同步完成
+
+    const topics = this.topicPhases.map(p => p.topic);
+
+    await this.consumer.subscribe({
+      topics,
+      fromBeginning: false, // 从上次消费的位置继续（不是从头开始）
+    });
+
+    this.logger.log(`[CDC] Continuous mode: Subscribed to topics: ${topics.join(', ')}`);
+
+    await this.consumer.run({
+      eachMessage: async (payload: EachMessagePayload) => {
+        await this.handleMessage(payload);
+      },
+    });
+
+    this.logger.log('[CDC] Continuous mode started - all topics being consumed in parallel');
+  }
+
+  /**
+   * 获取 CDC 同步状态
+   * - initialSyncCompleted = true: 初始顺序同步已完成
+   */
+  getSyncStatus(): { isRunning: boolean; sequentialMode: boolean; allPhasesCompleted: boolean } {
+    return {
+      isRunning: this.isRunning,
+      sequentialMode: this.sequentialMode,
+      allPhasesCompleted: this.initialSyncCompleted,
+    };
+  }
+
   /**
    * 停止消费者
    */

backend/services/contribution-service/src/infrastructure/persistence/repositories/contribution-account.repository.ts

@@ -223,6 +223,117 @@ export class ContributionAccountRepository implements IContributionAccountReposi
     });
   }
 
+  async findRecentlyUpdated(since: Date, limit: number = 500): Promise<ContributionAccountAggregate[]> {
+    const records = await this.client.contributionAccount.findMany({
+      where: { updatedAt: { gte: since } },
+      orderBy: { updatedAt: 'desc' },
+      take: limit,
+    });
+
+    return records.map((r) => this.toDomain(r));
+  }
+
+  /**
+   * 获取详细算力汇总（按类型分解）
+   */
+  async getDetailedContributionStats(): Promise<{
+    // 个人算力总计
+    personalTotal: string;
+    // 层级算力 - 已解锁（已分配给上线）
+    levelUnlocked: string;
+    // 层级算力 - 未解锁（待解锁的pending）
+    levelPending: string;
+    // 层级按档位分解
+    levelByTier: {
+      tier1: { unlocked: string; pending: string }; // 1-5级
+      tier2: { unlocked: string; pending: string }; // 6-10级
+      tier3: { unlocked: string; pending: string }; // 11-15级
+    };
+    // 团队奖励算力 - 已解锁
+    bonusUnlocked: string;
+    // 团队奖励算力 - 未解锁
+    bonusPending: string;
+    // 团队奖励按档位分解
+    bonusByTier: {
+      tier1: { unlocked: string; pending: string };
+      tier2: { unlocked: string; pending: string };
+      tier3: { unlocked: string; pending: string };
+    };
+  }> {
+    const result = await this.client.contributionAccount.aggregate({
+      _sum: {
+        personalContribution: true,
+        // 层级 1-5
+        level1Pending: true,
+        level2Pending: true,
+        level3Pending: true,
+        level4Pending: true,
+        level5Pending: true,
+        // 层级 6-10
+        level6Pending: true,
+        level7Pending: true,
+        level8Pending: true,
+        level9Pending: true,
+        level10Pending: true,
+        // 层级 11-15
+        level11Pending: true,
+        level12Pending: true,
+        level13Pending: true,
+        level14Pending: true,
+        level15Pending: true,
+        // 团队奖励
+        bonusTier1Pending: true,
+        bonusTier2Pending: true,
+        bonusTier3Pending: true,
+        // 汇总
+        totalLevelPending: true,
+        totalBonusPending: true,
+        totalUnlocked: true,
+      },
+    });
+
+    const sum = result._sum;
+
+    // 层级 1-5 已解锁（在pending字段中存储的是已分配给该用户的层级算力）
+    const level1to5 = new Decimal(sum.level1Pending || 0)
+      .plus(sum.level2Pending || 0)
+      .plus(sum.level3Pending || 0)
+      .plus(sum.level4Pending || 0)
+      .plus(sum.level5Pending || 0);
+
+    // 层级 6-10
+    const level6to10 = new Decimal(sum.level6Pending || 0)
+      .plus(sum.level7Pending || 0)
+      .plus(sum.level8Pending || 0)
+      .plus(sum.level9Pending || 0)
+      .plus(sum.level10Pending || 0);
+
+    // 层级 11-15
+    const level11to15 = new Decimal(sum.level11Pending || 0)
+      .plus(sum.level12Pending || 0)
+      .plus(sum.level13Pending || 0)
+      .plus(sum.level14Pending || 0)
+      .plus(sum.level15Pending || 0);
+
+    return {
+      personalTotal: (sum.personalContribution || new Decimal(0)).toString(),
+      levelUnlocked: (sum.totalLevelPending || new Decimal(0)).toString(),
+      levelPending: '0', // 未解锁的存储在 unallocated 表中
+      levelByTier: {
+        tier1: { unlocked: level1to5.toString(), pending: '0' },
+        tier2: { unlocked: level6to10.toString(), pending: '0' },
+        tier3: { unlocked: level11to15.toString(), pending: '0' },
+      },
+      bonusUnlocked: (sum.totalBonusPending || new Decimal(0)).toString(),
+      bonusPending: '0', // 未解锁的存储在 unallocated 表中
+      bonusByTier: {
+        tier1: { unlocked: (sum.bonusTier1Pending || new Decimal(0)).toString(), pending: '0' },
+        tier2: { unlocked: (sum.bonusTier2Pending || new Decimal(0)).toString(), pending: '0' },
+        tier3: { unlocked: (sum.bonusTier3Pending || new Decimal(0)).toString(), pending: '0' },
+      },
+    };
+  }
+
   private toDomain(record: any): ContributionAccountAggregate {
     return ContributionAccountAggregate.fromPersistence({
       id: record.id,

backend/services/contribution-service/src/infrastructure/persistence/repositories/synced-data.repository.ts

@@ -136,7 +136,10 @@ export class SyncedDataRepository implements ISyncedDataRepository {
 
   async findUndistributedAdoptions(limit: number = 100): Promise<SyncedAdoption[]> {
     const records = await this.client.syncedAdoption.findMany({
-      where: { contributionDistributed: false },
+      where: {
+        contributionDistributed: false,
+        status: 'MINING_ENABLED', // 只处理最终成功的认种订单
+      },
       orderBy: { adoptionDate: 'asc' },
       take: limit,
     });
@@ -171,7 +174,10 @@ export class SyncedDataRepository implements ISyncedDataRepository {
 
   async getTotalTreesByAccountSequence(accountSequence: string): Promise<number> {
     const result = await this.client.syncedAdoption.aggregate({
-      where: { accountSequence },
+      where: {
+        accountSequence,
+        status: 'MINING_ENABLED', // 只统计最终成功的认种订单
+      },
       _sum: { treeCount: true },
     });
     return result._sum.treeCount ?? 0;
@@ -285,8 +291,12 @@ export class SyncedDataRepository implements ISyncedDataRepository {
 
     const accountSequences = directReferrals.map((r) => r.accountSequence);
 
+    // 只统计有 MINING_ENABLED 状态认种记录的直推用户数
     const adoptedCount = await this.client.syncedAdoption.findMany({
-      where: { accountSequence: { in: accountSequences } },
+      where: {
+        accountSequence: { in: accountSequences },
+        status: 'MINING_ENABLED', // 只统计最终成功的认种订单
+      },
       distinct: ['accountSequence'],
     });
 
@@ -308,7 +318,10 @@ export class SyncedDataRepository implements ISyncedDataRepository {
 
       const adoptions = await this.client.syncedAdoption.groupBy({
         by: ['accountSequence'],
-        where: { accountSequence: { in: sequences } },
+        where: {
+          accountSequence: { in: sequences },
+          status: 'MINING_ENABLED', // 只统计最终成功的认种订单
+        },
         _sum: { treeCount: true },
       });
 
@@ -346,6 +359,89 @@ export class SyncedDataRepository implements ISyncedDataRepository {
     return result;
   }
 
+  // ========== 认种分类账查询 ==========
+
+  async getPlantingLedger(
+    accountSequence: string,
+    page: number = 1,
+    pageSize: number = 20,
+  ): Promise<{
+    items: SyncedAdoption[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+  }> {
+    const skip = (page - 1) * pageSize;
+    // 只返回 MINING_ENABLED 状态的认种记录
+    const whereClause = { accountSequence, status: 'MINING_ENABLED' };
+
+    const [items, total] = await Promise.all([
+      this.client.syncedAdoption.findMany({
+        where: whereClause,
+        orderBy: { adoptionDate: 'desc' },
+        skip,
+        take: pageSize,
+      }),
+      this.client.syncedAdoption.count({
+        where: whereClause,
+      }),
+    ]);
+
+    return {
+      items: items.map((r) => this.toSyncedAdoption(r)),
+      total,
+      page,
+      pageSize,
+      totalPages: Math.ceil(total / pageSize),
+    };
+  }
+
+  async getPlantingSummary(accountSequence: string): Promise<{
+    totalOrders: number;
+    totalTreeCount: number;
+    totalAmount: string;
+    effectiveTreeCount: number;
+    firstPlantingAt: Date | null;
+    lastPlantingAt: Date | null;
+  }> {
+    // 只统计 MINING_ENABLED 状态的认种记录
+    const adoptions = await this.client.syncedAdoption.findMany({
+      where: { accountSequence, status: 'MINING_ENABLED' },
+      orderBy: { adoptionDate: 'asc' },
+    });
+
+    if (adoptions.length === 0) {
+      return {
+        totalOrders: 0,
+        totalTreeCount: 0,
+        totalAmount: '0',
+        effectiveTreeCount: 0,
+        firstPlantingAt: null,
+        lastPlantingAt: null,
+      };
+    }
+
+    const totalOrders = adoptions.length;
+    const totalTreeCount = adoptions.reduce((sum, a) => sum + a.treeCount, 0);
+
+    // 计算总金额：treeCount * contributionPerTree
+    let totalAmount = new Decimal(0);
+    for (const adoption of adoptions) {
+      const amount = new Decimal(adoption.contributionPerTree).mul(adoption.treeCount);
+      totalAmount = totalAmount.add(amount);
+    }
+
+    return {
+      totalOrders,
+      totalTreeCount,
+      totalAmount: totalAmount.toString(),
+      effectiveTreeCount: totalTreeCount, // 全部都是有效的 MINING_ENABLED
+      firstPlantingAt: adoptions[0]?.adoptionDate || null,
+      lastPlantingAt: adoptions[adoptions.length - 1]?.adoptionDate || null,
+    };
+  }
+
   // ========== 统计方法（用于查询服务）==========
 
   async countUsers(): Promise<number> {
@@ -358,10 +454,23 @@ export class SyncedDataRepository implements ISyncedDataRepository {
 
   async countUndistributedAdoptions(): Promise<number> {
     return this.client.syncedAdoption.count({
-      where: { contributionDistributed: false },
+      where: {
+        contributionDistributed: false,
+        status: 'MINING_ENABLED', // 只统计最终成功的认种订单
+      },
     });
   }
 
+  async getTotalTrees(): Promise<number> {
+    const result = await this.client.syncedAdoption.aggregate({
+      where: {
+        status: 'MINING_ENABLED', // 只统计最终成功的认种订单
+      },
+      _sum: { treeCount: true },
+    });
+    return result._sum.treeCount ?? 0;
+  }
+
   // ========== 私有方法 ==========
 
   private toSyncedUser(record: any): SyncedUser {

backend/services/contribution-service/src/infrastructure/persistence/repositories/system-account.repository.ts

@@ -7,6 +7,7 @@ export type SystemAccountType = 'OPERATION' | 'PROVINCE' | 'CITY' | 'HEADQUARTER
 export interface SystemAccount {
   id: bigint;
   accountType: SystemAccountType;
+  regionCode: string | null;  // 省/市代码
   name: string;
   contributionBalance: ContributionAmount;
   contributionNeverExpires: boolean;
@@ -20,6 +21,8 @@ export interface SystemContributionRecord {
   systemAccountId: bigint;
   sourceAdoptionId: bigint;
   sourceAccountSequence: string;
+  sourceType: string;       // 来源类型：FIXED_RATE / LEVEL_OVERFLOW / LEVEL_NO_ANCESTOR / BONUS_TIER_1/2/3
+  levelDepth: number | null; // 层级深度（1-15），仅对层级相关类型有效
   distributionRate: number;
   amount: ContributionAmount;
   effectiveDate: Date;
@@ -36,9 +39,19 @@ export class SystemAccountRepository {
     return this.unitOfWork.getClient();
   }
 
-  async findByType(accountType: SystemAccountType): Promise<SystemAccount | null> {
+  /**
-    const record = await this.client.systemAccount.findUnique({
+   * 根据 accountType + regionCode 查找系统账户
-      where: { accountType },
+   * 注意：由于 regionCode 是可选字段，使用 findFirst 替代 findUnique
+   */
+  async findByTypeAndRegion(
+    accountType: SystemAccountType,
+    regionCode: string | null,
+  ): Promise<SystemAccount | null> {
+    const record = await this.client.systemAccount.findFirst({
+      where: {
+        accountType,
+        regionCode: regionCode === null ? { equals: null } : regionCode,
+      },
     });
 
     if (!record) {
@@ -48,123 +61,225 @@ export class SystemAccountRepository {
     return this.toSystemAccount(record);
   }
 
-  async findAll(): Promise<SystemAccount[]> {
+  /**
+   * 根据类型查找所有账户（如查找所有 CITY 类型账户）
+   */
+  async findByType(accountType: SystemAccountType): Promise<SystemAccount[]> {
     const records = await this.client.systemAccount.findMany({
-      orderBy: { accountType: 'asc' },
+      where: { accountType },
+      orderBy: { regionCode: 'asc' },
     });
 
     return records.map((r) => this.toSystemAccount(r));
   }
 
+  async findAll(): Promise<SystemAccount[]> {
+    const records = await this.client.systemAccount.findMany({
+      orderBy: [{ accountType: 'asc' }, { regionCode: 'asc' }],
+    });
+
+    return records.map((r) => this.toSystemAccount(r));
+  }
+
+  /**
+   * 确保基础账户存在
+   */
   async ensureSystemAccountsExist(): Promise<void> {
     const accounts: { accountType: SystemAccountType; name: string }[] = [
       { accountType: 'OPERATION', name: '运营账户' },
-      { accountType: 'PROVINCE', name: '省公司账户' },
-      { accountType: 'CITY', name: '市公司账户' },
       { accountType: 'HEADQUARTERS', name: '总部账户' },
     ];
 
     for (const account of accounts) {
-      await this.client.systemAccount.upsert({
+      // 由于 regionCode 是 nullable，使用 findFirst + create 替代 upsert
-        where: { accountType: account.accountType },
+      const existing = await this.client.systemAccount.findFirst({
-        create: {
+        where: {
           accountType: account.accountType,
-          name: account.name,
+          regionCode: { equals: null },
-          contributionBalance: 0,
+        },
+      });
+
+      if (!existing) {
+        await this.client.systemAccount.create({
+          data: {
+            accountType: account.accountType,
+            regionCode: null,
+            name: account.name,
+            contributionBalance: 0,
+            contributionNeverExpires: true,
+          },
+        });
+      }
+    }
+  }
+
+  /**
+   * 添加算力到系统账户（动态创建账户）
+   */
+  async addContribution(
+    accountType: SystemAccountType,
+    regionCode: string | null,
+    amount: ContributionAmount,
+  ): Promise<void> {
+    const name = this.getAccountName(accountType, regionCode);
+
+    // 由于 regionCode 是 nullable，使用 findFirst + create/update 替代 upsert
+    const existing = await this.client.systemAccount.findFirst({
+      where: {
+        accountType,
+        regionCode: regionCode === null ? { equals: null } : regionCode,
+      },
+    });
+
+    if (existing) {
+      await this.client.systemAccount.update({
+        where: { id: existing.id },
+        data: {
+          contributionBalance: { increment: amount.value },
+        },
+      });
+    } else {
+      await this.client.systemAccount.create({
+        data: {
+          accountType,
+          regionCode,
+          name,
+          contributionBalance: amount.value,
+          contributionNeverExpires: true,
         },
-        update: {},
       });
     }
   }
 
-  async addContribution(
+  /**
+   * 生成账户名称
+   */
+  private getAccountName(accountType: SystemAccountType, regionCode: string | null): string {
+    if (!regionCode) {
+      const names: Record<SystemAccountType, string> = {
+        OPERATION: '运营账户',
+        PROVINCE: '省公司账户',
+        CITY: '市公司账户',
+        HEADQUARTERS: '总部账户',
+      };
+      return names[accountType] || accountType;
+    }
+    return `${regionCode}账户`;
+  }
+
+  /**
+   * 减少系统账户算力
+   */
+  async subtractContribution(
     accountType: SystemAccountType,
+    regionCode: string | null,
     amount: ContributionAmount,
   ): Promise<void> {
-    await this.client.systemAccount.update({
+    const existing = await this.client.systemAccount.findFirst({
-      where: { accountType },
+      where: {
-      data: {
+        accountType,
-        contributionBalance: { increment: amount.value },
+        regionCode: regionCode === null ? { equals: null } : regionCode,
       },
     });
+
+    if (existing) {
+      await this.client.systemAccount.update({
+        where: { id: existing.id },
+        data: {
+          contributionBalance: { decrement: amount.value },
+        },
+      });
+    }
+  }
+
+  /**
+   * 软删除指定来源认种的明细记录
+   */
+  async deleteContributionRecordsByAdoption(
+    accountType: SystemAccountType,
+    regionCode: string | null,
+    sourceAdoptionId: bigint,
+    sourceAccountSequence: string,
+  ): Promise<number> {
+    const systemAccount = await this.findByTypeAndRegion(accountType, regionCode);
+    if (!systemAccount) {
+      return 0;
+    }
+
+    const result = await this.client.systemContributionRecord.updateMany({
+      where: {
+        systemAccountId: systemAccount.id,
+        sourceAdoptionId,
+        sourceAccountSequence,
+        deletedAt: null, // 只软删除未删除的记录
+      },
+      data: {
+        deletedAt: new Date(),
+      },
+    });
+
+    return result.count;
   }
 
   async saveContributionRecord(record: {
-    systemAccountType: SystemAccountType;
+    accountType: SystemAccountType;
+    regionCode: string | null;
     sourceAdoptionId: bigint;
     sourceAccountSequence: string;
+    sourceType: string;       // 来源类型
+    levelDepth?: number | null; // 层级深度
     distributionRate: number;
     amount: ContributionAmount;
     effectiveDate: Date;
     expireDate?: Date | null;
-  }): Promise<void> {
+  }): Promise<SystemContributionRecord> {
-    const systemAccount = await this.findByType(record.systemAccountType);
+    const systemAccount = await this.findByTypeAndRegion(record.accountType, record.regionCode);
     if (!systemAccount) {
-      throw new Error(`System account ${record.systemAccountType} not found`);
+      throw new Error(`System account ${record.accountType}:${record.regionCode} not found`);
     }
 
-    await this.client.systemContributionRecord.create({
+    const created = await this.client.systemContributionRecord.create({
       data: {
         systemAccountId: systemAccount.id,
         sourceAdoptionId: record.sourceAdoptionId,
         sourceAccountSequence: record.sourceAccountSequence,
+        sourceType: record.sourceType,
+        levelDepth: record.levelDepth ?? null,
         distributionRate: record.distributionRate,
         amount: record.amount.value,
         effectiveDate: record.effectiveDate,
         expireDate: record.expireDate ?? null,
       },
     });
-  }
 
-  async saveContributionRecords(records: {
+    return this.toContributionRecord(created);
-    systemAccountType: SystemAccountType;
-    sourceAdoptionId: bigint;
-    sourceAccountSequence: string;
-    distributionRate: number;
-    amount: ContributionAmount;
-    effectiveDate: Date;
-    expireDate?: Date | null;
-  }[]): Promise<void> {
-    if (records.length === 0) return;
-
-    const systemAccounts = await this.findAll();
-    const accountMap = new Map<SystemAccountType, bigint>();
-    for (const account of systemAccounts) {
-      accountMap.set(account.accountType, account.id);
-    }
-
-    await this.client.systemContributionRecord.createMany({
-      data: records.map((r) => ({
-        systemAccountId: accountMap.get(r.systemAccountType)!,
-        sourceAdoptionId: r.sourceAdoptionId,
-        sourceAccountSequence: r.sourceAccountSequence,
-        distributionRate: r.distributionRate,
-        amount: r.amount.value,
-        effectiveDate: r.effectiveDate,
-        expireDate: r.expireDate ?? null,
-      })),
-    });
   }
 
   async findContributionRecords(
-    systemAccountType: SystemAccountType,
+    accountType: SystemAccountType,
+    regionCode: string | null,
     page: number,
     pageSize: number,
   ): Promise<{ data: SystemContributionRecord[]; total: number }> {
-    const systemAccount = await this.findByType(systemAccountType);
+    const systemAccount = await this.findByTypeAndRegion(accountType, regionCode);
     if (!systemAccount) {
       return { data: [], total: 0 };
     }
 
+    const whereClause = {
+      systemAccountId: systemAccount.id,
+      deletedAt: null, // 过滤已软删除的记录
+    };
+
     const [records, total] = await Promise.all([
       this.client.systemContributionRecord.findMany({
-        where: { systemAccountId: systemAccount.id },
+        where: whereClause,
         skip: (page - 1) * pageSize,
         take: pageSize,
         orderBy: { createdAt: 'desc' },
       }),
       this.client.systemContributionRecord.count({
-        where: { systemAccountId: systemAccount.id },
+        where: whereClause,
       }),
     ]);
 
@@ -178,6 +293,7 @@ export class SystemAccountRepository {
     return {
       id: record.id,
       accountType: record.accountType as SystemAccountType,
+      regionCode: record.regionCode,
       name: record.name,
       contributionBalance: new ContributionAmount(record.contributionBalance),
       contributionNeverExpires: record.contributionNeverExpires,
@@ -193,6 +309,8 @@ export class SystemAccountRepository {
       systemAccountId: record.systemAccountId,
       sourceAdoptionId: record.sourceAdoptionId,
       sourceAccountSequence: record.sourceAccountSequence,
+      sourceType: record.sourceType,
+      levelDepth: record.levelDepth,
       distributionRate: record.distributionRate,
       amount: new ContributionAmount(record.amount),
       effectiveDate: record.effectiveDate,

backend/services/contribution-service/src/infrastructure/persistence/repositories/unallocated-contribution.repository.ts

@@ -7,14 +7,16 @@ export interface UnallocatedContribution {
   unallocType: string;
   wouldBeAccountSequence: string | null;
   levelDepth: number | null;
+  bonusTier: number | null;
   amount: ContributionAmount;
   reason: string | null;
   sourceAdoptionId: bigint;
   sourceAccountSequence: string;
   effectiveDate: Date;
   expireDate: Date;
-  allocatedToHeadquarters: boolean;
+  status: string;
   allocatedAt: Date | null;
+  allocatedToAccountSequence: string | null;
   createdAt: Date;
 }
 
@@ -130,20 +132,157 @@ export class UnallocatedContributionRepository {
     };
   }
 
+  /**
+   * 查询用户待领取的奖励档位贡献值
+   * @param accountSequence 用户账号
+   * @param bonusTier 奖励档位 (2 或 3)
+   */
+  async findPendingBonusByAccountSequence(
+    accountSequence: string,
+    bonusTier: number,
+  ): Promise<UnallocatedContribution[]> {
+    const records = await this.client.unallocatedContribution.findMany({
+      where: {
+        wouldBeAccountSequence: accountSequence,
+        unallocType: `BONUS_TIER_${bonusTier}`,
+        status: 'PENDING',
+      },
+      orderBy: { createdAt: 'asc' },
+    });
+
+    return records.map((r) => this.toDomain(r));
+  }
+
+  /**
+   * 领取奖励档位 - 将待领取记录标记为已分配给用户
+   * @param ids 记录ID列表
+   * @param accountSequence 分配给的用户账号
+   */
+  async claimBonusRecords(ids: bigint[], accountSequence: string): Promise<void> {
+    if (ids.length === 0) return;
+
+    await this.client.unallocatedContribution.updateMany({
+      where: {
+        id: { in: ids },
+        status: 'PENDING',
+      },
+      data: {
+        status: 'ALLOCATED_TO_USER',
+        allocatedAt: new Date(),
+        allocatedToAccountSequence: accountSequence,
+      },
+    });
+  }
+
+  /**
+   * 查询用户所有待领取的奖励（所有档位）
+   */
+  async findAllPendingBonusByAccountSequence(
+    accountSequence: string,
+  ): Promise<UnallocatedContribution[]> {
+    const records = await this.client.unallocatedContribution.findMany({
+      where: {
+        wouldBeAccountSequence: accountSequence,
+        unallocType: { startsWith: 'BONUS_TIER_' },
+        status: 'PENDING',
+      },
+      orderBy: { createdAt: 'asc' },
+    });
+
+    return records.map((r) => this.toDomain(r));
+  }
+
+  /**
+   * 获取分层级的未分配算力统计
+   */
+  async getUnallocatedByLevelTier(): Promise<{
+    tier1: string; // 1-5级未分配
+    tier2: string; // 6-10级未分配
+    tier3: string; // 11-15级未分配
+  }> {
+    const results = await this.client.unallocatedContribution.groupBy({
+      by: ['levelDepth'],
+      where: {
+        levelDepth: { not: null },
+        status: 'PENDING',
+      },
+      _sum: { amount: true },
+    });
+
+    let tier1 = new ContributionAmount(0);
+    let tier2 = new ContributionAmount(0);
+    let tier3 = new ContributionAmount(0);
+
+    for (const item of results) {
+      const depth = item.levelDepth!;
+      const amount = new ContributionAmount(item._sum.amount || 0);
+      if (depth >= 1 && depth <= 5) {
+        tier1 = tier1.add(amount);
+      } else if (depth >= 6 && depth <= 10) {
+        tier2 = tier2.add(amount);
+      } else if (depth >= 11 && depth <= 15) {
+        tier3 = tier3.add(amount);
+      }
+    }
+
+    return {
+      tier1: tier1.value.toString(),
+      tier2: tier2.value.toString(),
+      tier3: tier3.value.toString(),
+    };
+  }
+
+  /**
+   * 获取分档位的未分配奖励统计
+   */
+  async getUnallocatedByBonusTier(): Promise<{
+    tier1: string;
+    tier2: string;
+    tier3: string;
+  }> {
+    const results = await this.client.unallocatedContribution.groupBy({
+      by: ['unallocType'],
+      where: {
+        unallocType: { startsWith: 'BONUS_TIER_' },
+        status: 'PENDING',
+      },
+      _sum: { amount: true },
+    });
+
+    let tier1 = '0';
+    let tier2 = '0';
+    let tier3 = '0';
+
+    for (const item of results) {
+      const amount = (item._sum.amount || 0).toString();
+      if (item.unallocType === 'BONUS_TIER_1') {
+        tier1 = amount;
+      } else if (item.unallocType === 'BONUS_TIER_2') {
+        tier2 = amount;
+      } else if (item.unallocType === 'BONUS_TIER_3') {
+        tier3 = amount;
+      }
+    }
+
+    return { tier1, tier2, tier3 };
+  }
+
   private toDomain(record: any): UnallocatedContribution {
     return {
       id: record.id,
       unallocType: record.unallocType,
       wouldBeAccountSequence: record.wouldBeAccountSequence,
       levelDepth: record.levelDepth,
+      bonusTier: record.bonusTier,
       amount: new ContributionAmount(record.amount),
       reason: record.reason,
       sourceAdoptionId: record.sourceAdoptionId,
       sourceAccountSequence: record.sourceAccountSequence,
       effectiveDate: record.effectiveDate,
       expireDate: record.expireDate,
-      allocatedToHeadquarters: record.allocatedToHeadquarters,
+      status: record.status,
       allocatedAt: record.allocatedAt,
+      allocatedToAccountSequence: record.allocatedToAccountSequence,
       createdAt: record.createdAt,
     };
   }

backend/services/deploy-mining.sh

@@ -25,6 +25,7 @@
 # CDC & Sync:
 #   ./deploy-mining.sh sync-reset      # Reset CDC consumer offsets to beginning
 #   ./deploy-mining.sh sync-status     # Show CDC consumer group status
+#   ./deploy-mining.sh cdc-resnapshot  # Force Debezium to re-snapshot (use when Kafka data lost)
 #
 # Full Reset (for development/testing):
 #   ./deploy-mining.sh full-reset      # Complete reset: stop services, drop DBs, recreate, resync
@@ -103,8 +104,13 @@ declare -A SERVICE_PORTS=(
 )
 
 # CDC Consumer Groups (all groups that need to be reset during full-reset)
+# NOTE: contribution-service uses sequential phase consumption with separate consumer groups
+# for each table (user_accounts, referral_relationships, planting_orders)
 CDC_CONSUMER_GROUPS=(
     "contribution-service-cdc-group"
+    "contribution-service-cdc-phase-user_accounts"
+    "contribution-service-cdc-phase-referral_relationships"
+    "contribution-service-cdc-phase-planting_orders"
     "auth-service-cdc-group"
     "mining-admin-service-cdc-group"
 )
@@ -119,6 +125,14 @@ OUTBOX_CONNECTORS=(
     "mining-wallet-outbox-connector"
 )
 
+# Debezium CDC Postgres Connectors (for 1.0 -> 2.0 data sync)
+# These connectors capture changes from 1.0 service databases
+CDC_POSTGRES_CONNECTORS=(
+    "identity-postgres-connector"
+    "referral-postgres-connector"
+    "planting-postgres-connector"
+)
+
 # Debezium Connect URL (default port 8084 as mapped in docker-compose)
 DEBEZIUM_CONNECT_URL="${DEBEZIUM_CONNECT_URL:-http://localhost:8084}"
 
@@ -708,6 +722,148 @@ sync_reset() {
     log_info "Run: ./deploy-mining.sh up contribution-service && ./deploy-mining.sh up auth-service"
 }
 
+# Trigger Debezium CDC connectors to re-snapshot
+# This is needed when Kafka topic messages are deleted (due to retention or manual cleanup)
+# and the connector needs to re-export all data from the source database
+cdc_resnapshot() {
+    print_section "Triggering CDC Connectors Re-Snapshot"
+
+    local connect_url="$DEBEZIUM_CONNECT_URL"
+
+    # Check if Debezium Connect is available
+    if ! curl -s "$connect_url" &>/dev/null; then
+        log_error "Debezium Connect not available at $connect_url"
+        return 1
+    fi
+
+    echo -e "${YELLOW}WARNING: This will delete and recreate CDC Postgres connectors.${NC}"
+    echo -e "${YELLOW}All connectors will re-snapshot their source tables.${NC}"
+    echo ""
+    echo "Connectors to be re-created:"
+    for connector in "${CDC_POSTGRES_CONNECTORS[@]}"; do
+        echo "  - $connector"
+    done
+    echo ""
+    read -p "Continue? (y/n): " confirm
+
+    if [ "$confirm" != "y" ]; then
+        log_warn "Aborted"
+        return 1
+    fi
+
+    # Stop CDC consumer services first
+    log_step "Stopping CDC consumer services..."
+    service_stop "contribution-service"
+
+    # Wait for consumer groups to become inactive
+    log_info "Waiting 10 seconds for consumers to disconnect..."
+    sleep 10
+
+    # Delete consumer groups to ensure fresh consumption
+    log_step "Deleting consumer groups..."
+    for group in "${CDC_CONSUMER_GROUPS[@]}"; do
+        log_info "Deleting consumer group: $group"
+        if docker ps --format '{{.Names}}' 2>/dev/null | grep -q "^${KAFKA_CONTAINER}$"; then
+            docker exec "$KAFKA_CONTAINER" kafka-consumer-groups --bootstrap-server localhost:9092 \
+                --delete --group "$group" 2>/dev/null && log_success "Deleted $group" || log_warn "Could not delete $group"
+        fi
+    done
+
+    # Clear processed_cdc_events table
+    log_step "Clearing processed CDC events..."
+    if run_psql "rwa_contribution" "TRUNCATE TABLE processed_cdc_events;" 2>/dev/null; then
+        log_success "Truncated processed_cdc_events in rwa_contribution"
+    else
+        log_warn "Could not truncate processed_cdc_events (table may not exist)"
+    fi
+
+    # For each CDC Postgres connector, save config, delete, and recreate
+    log_step "Re-creating CDC Postgres connectors..."
+    local scripts_dir="$SCRIPT_DIR/scripts/debezium"
+
+    for connector in "${CDC_POSTGRES_CONNECTORS[@]}"; do
+        log_info "Processing connector: $connector"
+
+        # Get current config from running connector
+        local config
+        config=$(curl -s "$connect_url/connectors/$connector/config" 2>/dev/null)
+
+        local config_file=""
+        local use_file_config=false
+
+        # If connector doesn't exist, try to find config file
+        if [ -z "$config" ] || echo "$config" | grep -q "error_code"; then
+            log_warn "Connector $connector not found, looking for config file..."
+
+            # Map connector name to config file
+            case "$connector" in
+                "identity-postgres-connector")
+                    config_file="$scripts_dir/identity-connector.json"
+                    ;;
+                "referral-postgres-connector")
+                    config_file="$scripts_dir/referral-connector.json"
+                    ;;
+                "planting-postgres-connector")
+                    config_file="$scripts_dir/planting-connector.json"
+                    ;;
+            esac
+
+            if [ -n "$config_file" ] && [ -f "$config_file" ]; then
+                log_info "Found config file: $config_file"
+                use_file_config=true
+            else
+                log_error "No config available for $connector, skipping"
+                continue
+            fi
+        else
+            # Delete existing connector
+            log_info "Deleting connector: $connector"
+            curl -s -X DELETE "$connect_url/connectors/$connector" &>/dev/null
+            sleep 2
+        fi
+
+        # Create connector
+        log_info "Creating connector: $connector with snapshot.mode=always"
+        local result
+
+        if [ "$use_file_config" = true ]; then
+            # Use config file, replace snapshot.mode with always
+            local json_config
+            json_config=$(cat "$config_file" | envsubst | sed 's/"snapshot.mode": "initial"/"snapshot.mode": "always"/')
+            result=$(echo "$json_config" | curl -s -X POST "$connect_url/connectors" \
+                -H "Content-Type: application/json" \
+                -d @- 2>/dev/null)
+        else
+            # Use config from running connector, but change snapshot.mode to always
+            local modified_config
+            modified_config=$(echo "$config" | sed 's/"snapshot.mode":"initial"/"snapshot.mode":"always"/' | sed 's/"snapshot.mode": "initial"/"snapshot.mode": "always"/')
+            result=$(curl -s -X POST "$connect_url/connectors" \
+                -H "Content-Type: application/json" \
+                -d "{\"name\":\"$connector\",\"config\":$modified_config}" 2>/dev/null)
+        fi
+
+        if echo "$result" | grep -q '"name"'; then
+            log_success "Created connector: $connector"
+        else
+            log_error "Failed to create connector $connector: $result"
+        fi
+
+        # Wait between connectors
+        sleep 3
+    done
+
+    # Wait for snapshots to complete
+    log_step "Waiting 30 seconds for Debezium snapshots to complete..."
+    sleep 30
+
+    # Start services
+    log_step "Starting CDC consumer services..."
+    service_start "contribution-service"
+
+    log_success "CDC re-snapshot completed!"
+    log_info "Monitor sync progress with: ./deploy-mining.sh sync-status"
+}
+
 sync_status() {
     print_section "CDC Sync Status"
 
@@ -1102,9 +1258,47 @@ full_reset() {
         service_start "$service"
     done
 
-    log_step "Step 10/18: Waiting for services to be ready and sync from 1.0..."
+    log_step "Step 10/18: Waiting for contribution-service CDC sync to complete..."
-    log_info "Waiting 30 seconds for all services to start and sync data from 1.0 CDC..."
+    log_info "Waiting for contribution-service to complete CDC sync (user_accounts -> referral_relationships -> planting_orders)..."
-    sleep 30
+
+    # 等待 contribution-service 的 CDC 顺序同步完成
+    # 通过 /health/cdc-sync API 检查同步状态
+    local max_wait=600  # 最多等待 10 分钟
+    local wait_count=0
+    local sync_completed=false
+    local cdc_sync_url="http://localhost:3020/api/v2/health/cdc-sync"
+
+    while [ "$wait_count" -lt "$max_wait" ] && [ "$sync_completed" = false ]; do
+        # 调用 API 检查同步状态
+        local sync_status
+        sync_status=$(curl -s "$cdc_sync_url" 2>/dev/null || echo '{}')
+
+        if echo "$sync_status" | grep -q '"allPhasesCompleted":true'; then
+            sync_completed=true
+            log_success "CDC sync completed - all phases finished"
+        else
+            # 显示当前状态
+            local is_running
+            local sequential_mode
+            is_running=$(echo "$sync_status" | grep -o '"isRunning":[^,}]*' | cut -d':' -f2)
+            sequential_mode=$(echo "$sync_status" | grep -o '"sequentialMode":[^,}]*' | cut -d':' -f2)
+
+            if [ "$is_running" = "true" ] && [ "$sequential_mode" = "true" ]; then
+                log_info "CDC sync in progress (sequential mode)... (waited ${wait_count}s)"
+            elif [ "$is_running" = "true" ]; then
+                log_info "CDC consumer running... (waited ${wait_count}s)"
+            else
+                log_info "Waiting for CDC consumer to start... (waited ${wait_count}s)"
+            fi
+            sleep 5
+            wait_count=$((wait_count + 5))
+        fi
+    done
+
+    if [ "$sync_completed" = false ]; then
+        log_warn "CDC sync did not complete within ${max_wait}s, proceeding anyway..."
+        log_info "You may need to wait longer or check: curl $cdc_sync_url"
+    fi
 
     log_step "Step 11/18: Registering Debezium outbox connectors..."
     # Register outbox connectors AFTER services are running and have synced data
@@ -1327,6 +1521,7 @@ show_help() {
     echo -e "${BOLD}CDC / Sync Management:${NC}"
     echo "  sync-reset                Reset CDC consumer to read from beginning"
     echo "  sync-status               Show CDC consumer group status"
+    echo "  cdc-resnapshot            Force Debezium CDC connectors to re-snapshot ${YELLOW}(use when Kafka data lost)${NC}"
     echo "  outbox-register           Register all Debezium outbox connectors"
     echo "  outbox-status             Show outbox connector status"
     echo "  outbox-delete             Delete all outbox connectors"
@@ -1429,6 +1624,10 @@ main() {
         sync-status)
             sync_status
             ;;
+        cdc-resnapshot)
+            print_header
+            cdc_resnapshot
+            ;;
 
         # Outbox connector commands
         outbox-register)

backend/services/docker-compose.2.0.yml

@@ -76,6 +76,10 @@ services:
       REDIS_DB: 11
       # Kafka
       KAFKA_BROKERS: kafka:29092
+      # JWT 配置 (与 auth-service 共享密钥以验证 token)
+      JWT_SECRET: ${JWT_SECRET:-your-jwt-secret-change-in-production}
+      # 2.0 内部服务调用
+      CONTRIBUTION_SERVICE_URL: http://contribution-service:3020
     ports:
       - "3021:3021"
     healthcheck:
@@ -108,6 +112,8 @@ services:
       KAFKA_BROKERS: kafka:29092
       # 2.0 内部服务调用
       MINING_SERVICE_URL: http://mining-service:3021
+      # JWT 配置 (与 auth-service 共享密钥以验证 token)
+      JWT_SECRET: ${JWT_SECRET:-your-jwt-secret-change-in-production}
     ports:
       - "3022:3022"
     healthcheck:

backend/services/mining-admin-service/package-lock.json

@@ -8,12 +8,14 @@
       "name": "mining-admin-service",
       "version": "1.0.0",
       "dependencies": {
+        "@nestjs/axios": "^3.1.3",
         "@nestjs/common": "^10.3.0",
         "@nestjs/config": "^3.1.1",
         "@nestjs/core": "^10.3.0",
         "@nestjs/platform-express": "^10.3.0",
         "@nestjs/swagger": "^7.1.17",
         "@prisma/client": "^5.7.1",
+        "axios": "^1.13.2",
         "bcrypt": "^5.1.1",
         "class-transformer": "^0.5.1",
         "class-validator": "^0.14.0",
@@ -23,7 +25,8 @@
         "kafkajs": "^2.2.4",
         "reflect-metadata": "^0.1.14",
         "rxjs": "^7.8.1",
-        "swagger-ui-express": "^5.0.0"
+        "swagger-ui-express": "^5.0.0",
+        "xlsx": "^0.18.5"
       },
       "devDependencies": {
         "@nestjs/cli": "^10.2.1",
@@ -32,6 +35,7 @@
         "@types/bcrypt": "^6.0.0",
         "@types/express": "^4.17.21",
         "@types/jsonwebtoken": "^9.0.10",
+        "@types/multer": "^1.4.13",
         "@types/node": "^20.10.5",
         "eslint": "^8.56.0",
         "prettier": "^3.1.1",
@@ -627,6 +631,17 @@
       "integrity": "sha512-4aErSrCR/On/e5G2hDP0wjooqDdauzEbIq8hIkIe5pXV0rtWJZvdCEKL0ykZxex+IxIwBp0eGeV48hQN07dXtw==",
       "license": "MIT"
     },
+    "node_modules/@nestjs/axios": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/@nestjs/axios/-/axios-3.1.3.tgz",
+      "integrity": "sha512-RZ/63c1tMxGLqyG3iOCVt7A72oy4x1eM6QEhd4KzCYpaVWW0igq0WSREeRoEZhIxRcZfDfIIkvsOMiM7yfVGZQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@nestjs/common": "^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0",
+        "axios": "^1.3.1",
+        "rxjs": "^6.0.0 || ^7.0.0"
+      }
+    },
     "node_modules/@nestjs/cli": {
       "version": "10.4.9",
       "resolved": "https://registry.npmjs.org/@nestjs/cli/-/cli-10.4.9.tgz",
@@ -1206,6 +1221,16 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/multer": {
+      "version": "1.4.13",
+      "resolved": "https://registry.npmjs.org/@types/multer/-/multer-1.4.13.tgz",
+      "integrity": "sha512-bhhdtPw7JqCiEfC9Jimx5LqX9BDIPJEh2q/fQ4bqbBPtyEZYr3cvF22NwG0DmPZNYA0CAf2CnqDB4KIGGpJcaw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/express": "*"
+      }
+    },
     "node_modules/@types/node": {
       "version": "20.19.28",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.28.tgz",
@@ -1494,6 +1519,15 @@
         "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
       }
     },
+    "node_modules/adler-32": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/adler-32/-/adler-32-1.3.1.tgz",
+      "integrity": "sha512-ynZ4w/nUUv5rrsR8UUGoe1VC9hZj6V5hU9Qw1HlMDJGEJw5S7TfTErWTjMys6M7vr0YWcPqs3qAr4ss0nDfP+A==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/agent-base": {
       "version": "6.0.2",
       "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
@@ -1734,6 +1768,24 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "license": "MIT"
+    },
+    "node_modules/axios": {
+      "version": "1.13.2",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.13.2.tgz",
+      "integrity": "sha512-VPk9ebNqPcy5lRGuSlKx752IlDatOjT9paPlm8A7yOuW2Fbvp4X3JznJtT4f0GzGLLiWE9W8onz51SqLYwzGaA==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "follow-redirects": "^1.15.6",
+        "form-data": "^4.0.4",
+        "proxy-from-env": "^1.1.0"
+      }
+    },
     "node_modules/balanced-match": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
@@ -2028,6 +2080,19 @@
       ],
       "license": "CC-BY-4.0"
     },
+    "node_modules/cfb": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cfb/-/cfb-1.2.2.tgz",
+      "integrity": "sha512-KfdUZsSOw19/ObEWasvBP/Ac4reZvAGauZhs6S/gqNhXhI7cKwvlH7ulj+dOEYnca4bm4SGo8C1bTAQvnTjgQA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "adler-32": "~1.3.0",
+        "crc-32": "~1.2.0"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/chalk": {
       "version": "4.1.2",
       "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -2185,6 +2250,15 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/codepage": {
+      "version": "1.15.0",
+      "resolved": "https://registry.npmjs.org/codepage/-/codepage-1.15.0.tgz",
+      "integrity": "sha512-3g6NUTPd/YtuuGrhMnOMRjFc+LJw/bnMp3+0r/Wcz3IXUuCosKRJvMphm5+Q+bvTVGcJJuRvVLuYba+WojaFaA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/color-convert": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
@@ -2212,6 +2286,18 @@
         "color-support": "bin.js"
       }
     },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/commander": {
       "version": "4.1.1",
       "resolved": "https://registry.npmjs.org/commander/-/commander-4.1.1.tgz",
@@ -2355,6 +2441,18 @@
         }
       }
     },
+    "node_modules/crc-32": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/crc-32/-/crc-32-1.2.2.tgz",
+      "integrity": "sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==",
+      "license": "Apache-2.0",
+      "bin": {
+        "crc32": "bin/crc32.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
@@ -2433,6 +2531,15 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
     "node_modules/delegates": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz",
@@ -2629,6 +2736,21 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/escalade": {
       "version": "3.2.0",
       "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
@@ -3136,6 +3258,26 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/follow-redirects": {
+      "version": "1.15.11",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
+      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/foreground-child": {
       "version": "3.3.1",
       "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
@@ -3182,6 +3324,22 @@
         "webpack": "^5.11.0"
       }
     },
+    "node_modules/form-data": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz",
+      "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
     "node_modules/forwarded": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
@@ -3191,6 +3349,15 @@
         "node": ">= 0.6"
       }
     },
+    "node_modules/frac": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/frac/-/frac-1.1.2.tgz",
+      "integrity": "sha512-w/XBfkibaTl3YDqASwfDUqkna4Z2p9cFSr1aHDt0WoMTECnRfBOv2WArlZILlqgWlmdIlALXGpM2AOhEk5W3IA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/fresh": {
       "version": "0.5.2",
       "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
@@ -3493,6 +3660,21 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/has-unicode": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz",
@@ -4878,6 +5060,12 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/proxy-from-env": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
+      "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==",
+      "license": "MIT"
+    },
     "node_modules/punycode": {
       "version": "2.3.1",
       "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
@@ -5450,6 +5638,18 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/ssf": {
+      "version": "0.11.2",
+      "resolved": "https://registry.npmjs.org/ssf/-/ssf-0.11.2.tgz",
+      "integrity": "sha512-+idbmIXoYET47hH+d7dfm2epdOMUDjqcB4648sTZ+t2JwoyBFL/insLfB/racrDmsKB3diwsDA696pZMieAC5g==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "frac": "~1.1.2"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/standard-as-callback": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/standard-as-callback/-/standard-as-callback-2.1.0.tgz",
@@ -6252,6 +6452,24 @@
         "string-width": "^1.0.2 || 2 || 3 || 4"
       }
     },
+    "node_modules/wmf": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wmf/-/wmf-1.0.2.tgz",
+      "integrity": "sha512-/p9K7bEh0Dj6WbXg4JG0xvLQmIadrner1bi45VMJTfnbVHsc7yIajZyoSoK60/dtVBs12Fm6WkUI5/3WAVsNMw==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
+    "node_modules/word": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/word/-/word-0.3.0.tgz",
+      "integrity": "sha512-OELeY0Q61OXpdUfTp+oweA/vtLVg5VDOXh+3he3PNzLGG/y0oylSOC1xRVj0+l4vQ3tj/bB1HVHv1ocXkQceFA==",
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/word-wrap": {
       "version": "1.2.5",
       "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
@@ -6302,6 +6520,27 @@
       "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
       "license": "ISC"
     },
+    "node_modules/xlsx": {
+      "version": "0.18.5",
+      "resolved": "https://registry.npmjs.org/xlsx/-/xlsx-0.18.5.tgz",
+      "integrity": "sha512-dmg3LCjBPHZnQp5/F/+nnTa+miPJxUXB6vtk42YjBBKayDNagxGEeIdWApkYPOf3Z3pm3k62Knjzp7lMeTEtFQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "adler-32": "~1.3.0",
+        "cfb": "~1.2.1",
+        "codepage": "~1.15.0",
+        "crc-32": "~1.2.1",
+        "ssf": "~0.11.2",
+        "wmf": "~1.0.1",
+        "word": "~0.3.0"
+      },
+      "bin": {
+        "xlsx": "bin/xlsx.njs"
+      },
+      "engines": {
+        "node": ">=0.8"
+      }
+    },
     "node_modules/xtend": {
       "version": "4.0.2",
       "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",

backend/services/mining-admin-service/package.json

@@ -15,12 +15,14 @@
     "prisma:migrate": "prisma migrate dev"
   },
   "dependencies": {
+    "@nestjs/axios": "^3.1.3",
     "@nestjs/common": "^10.3.0",
     "@nestjs/config": "^3.1.1",
     "@nestjs/core": "^10.3.0",
     "@nestjs/platform-express": "^10.3.0",
     "@nestjs/swagger": "^7.1.17",
     "@prisma/client": "^5.7.1",
+    "axios": "^1.13.2",
     "bcrypt": "^5.1.1",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.0",
@@ -30,7 +32,8 @@
     "kafkajs": "^2.2.4",
     "reflect-metadata": "^0.1.14",
     "rxjs": "^7.8.1",
-    "swagger-ui-express": "^5.0.0"
+    "swagger-ui-express": "^5.0.0",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@nestjs/cli": "^10.2.1",
@@ -39,6 +42,7 @@
     "@types/bcrypt": "^6.0.0",
     "@types/express": "^4.17.21",
     "@types/jsonwebtoken": "^9.0.10",
+    "@types/multer": "^1.4.13",
     "@types/node": "^20.10.5",
     "eslint": "^8.56.0",
     "prettier": "^3.1.1",

backend/services/mining-admin-service/prisma/migrations/0001_init/migration.sql

@@ -1,8 +1,8 @@
 -- ============================================================================
 -- mining-admin-service 初始化 migration
--- 合并自: 20260111000000_init, 20260112110000_add_referral_adoption_nickname,
+-- 合并自: 0001_init, 0002_fix_processed_event_composite_key,
---         20260112150000_add_unlocked_bonus_tiers, 20260112200000_add_contribution_records_network_progress,
+--         20250120000001_add_region_to_synced_system_contributions,
---         20260113000000_use_prisma_relation_mode, 20260113100000_add_distribution_summary
+--         20250120000002_add_synced_system_contribution_records
 -- 注意: 使用 Prisma relationMode = "prisma"，不在数据库层创建FK约束
 -- ============================================================================
 
@@ -302,10 +302,11 @@ CREATE TABLE "synced_circulation_pools" (
     CONSTRAINT "synced_circulation_pools_pkey" PRIMARY KEY ("id")
 );
 
--- CreateTable
+-- CreateTable: 系统账户算力 (from contribution-service)
 CREATE TABLE "synced_system_contributions" (
     "id" TEXT NOT NULL,
     "accountType" TEXT NOT NULL,
+    "region_code" TEXT,
     "name" TEXT NOT NULL,
     "contributionBalance" DECIMAL(30,8) NOT NULL DEFAULT 0,
     "contributionNeverExpires" BOOLEAN NOT NULL DEFAULT false,
@@ -687,8 +688,12 @@ CREATE UNIQUE INDEX "synced_daily_mining_stats_statDate_key" ON "synced_daily_mi
 -- CreateIndex
 CREATE UNIQUE INDEX "synced_day_klines_klineDate_key" ON "synced_day_klines"("klineDate");
 
--- CreateIndex
+-- CreateIndex: synced_system_contributions
-CREATE UNIQUE INDEX "synced_system_contributions_accountType_key" ON "synced_system_contributions"("accountType");
+-- 使用 accountType + COALESCE(region_code, '__NULL__') 复合唯一键
+-- 注意：PostgreSQL 中 NULL != NULL，所以直接用 region_code 做唯一索引无法阻止重复的 (OPERATION, NULL)
+CREATE UNIQUE INDEX "synced_system_contributions_accountType_region_code_key" ON "synced_system_contributions"("accountType", COALESCE(region_code, '__NULL__'));
+CREATE INDEX "synced_system_contributions_accountType_idx" ON "synced_system_contributions"("accountType");
+CREATE INDEX "synced_system_contributions_region_code_idx" ON "synced_system_contributions"("region_code");
 
 -- CreateIndex
 CREATE UNIQUE INDEX "cdc_sync_progress_sourceTopic_key" ON "cdc_sync_progress"("sourceTopic");
@@ -696,11 +701,8 @@ CREATE UNIQUE INDEX "cdc_sync_progress_sourceTopic_key" ON "cdc_sync_progress"("
 -- CreateIndex
 CREATE INDEX "cdc_sync_progress_sourceService_idx" ON "cdc_sync_progress"("sourceService");
 
--- CreateIndex
+-- CreateIndex (使用复合唯一键替代单独的 eventId 唯一约束)
-CREATE UNIQUE INDEX "processed_events_eventId_key" ON "processed_events"("eventId");
+CREATE UNIQUE INDEX "processed_events_sourceService_eventId_key" ON "processed_events"("sourceService", "eventId");
-
--- CreateIndex
-CREATE INDEX "processed_events_sourceService_idx" ON "processed_events"("sourceService");
 
 -- CreateIndex
 CREATE INDEX "processed_events_processedAt_idx" ON "processed_events"("processedAt");
@@ -860,3 +862,40 @@ CREATE UNIQUE INDEX "synced_fee_configs_fee_type_key" ON "synced_fee_configs"("f
 
 -- AddForeignKey (保留 admin 相关的外键)
 ALTER TABLE "audit_logs" ADD CONSTRAINT "audit_logs_adminId_fkey" FOREIGN KEY ("adminId") REFERENCES "admin_users"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- ============================================================================
+-- 系统账户算力明细同步表
+-- 用于存储从 contribution-service 同步的系统账户算力来源明细
+-- ============================================================================
+
+-- CreateTable: 系统账户算力明细 (from contribution-service)
+CREATE TABLE "synced_system_contribution_records" (
+    "id" TEXT NOT NULL,
+    "original_record_id" BIGINT NOT NULL,
+    "account_type" TEXT NOT NULL,
+    "region_code" TEXT,
+    "source_adoption_id" BIGINT NOT NULL,
+    "source_account_sequence" TEXT NOT NULL,
+    -- 来源类型: FIXED_RATE(固定比例) / LEVEL_OVERFLOW(层级溢出) / LEVEL_NO_ANCESTOR(无上线) / BONUS_TIER_1/2/3(团队奖励未解锁)
+    "source_type" VARCHAR(30) NOT NULL,
+    -- 层级深度（1-15），仅对 LEVEL_OVERFLOW 和 LEVEL_NO_ANCESTOR 类型有效
+    "level_depth" INTEGER,
+    "distribution_rate" DECIMAL(10,6) NOT NULL,
+    "amount" DECIMAL(30,10) NOT NULL,
+    "effective_date" DATE NOT NULL,
+    "expire_date" DATE,
+    "is_expired" BOOLEAN NOT NULL DEFAULT false,
+    "created_at" TIMESTAMP(3) NOT NULL,
+    "syncedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "synced_system_contribution_records_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "synced_system_contribution_records_original_record_id_key" ON "synced_system_contribution_records"("original_record_id");
+CREATE INDEX "synced_system_contribution_records_account_type_region_code_idx" ON "synced_system_contribution_records"("account_type", "region_code");
+CREATE INDEX "synced_system_contribution_records_source_adoption_id_idx" ON "synced_system_contribution_records"("source_adoption_id");
+CREATE INDEX "synced_system_contribution_records_source_account_sequence_idx" ON "synced_system_contribution_records"("source_account_sequence");
+CREATE INDEX "synced_system_contribution_records_source_type_idx" ON "synced_system_contribution_records"("source_type");
+CREATE INDEX "synced_system_contribution_records_created_at_idx" ON "synced_system_contribution_records"("created_at" DESC);

backend/services/mining-admin-service/prisma/migrations/0002_fix_processed_event_composite_key/migration.sql

@@ -1,26 +0,0 @@
--- ============================================================================
--- 修复 processed_events 表的幂等键
--- 用于 2.0 服务间 Outbox 事件的 100% exactly-once 语义
--- ============================================================================
---
--- 问题: 原来使用 eventId 作为唯一键，但不同服务的 outbox ID 可能相同
--- 解决: 使用 (sourceService, eventId) 作为复合唯一键
---
--- 唯一键说明:
---   - sourceService: 发送事件的服务名（如 "auth-service", "contribution-service"）
---   - eventId: 发送方 outbox 表的自增 ID（非 UUID，而是数据库自增主键）
---   - 组合后在全局唯一，可用于精确追踪事件来源
--- ============================================================================
-
--- 先清空已有数据（因为之前的数据可能有冲突）
-TRUNCATE TABLE "processed_events";
-
--- 删除旧的唯一索引（仅 eventId）
-DROP INDEX IF EXISTS "processed_events_eventId_key";
-
--- 删除旧的 sourceService 普通索引
-DROP INDEX IF EXISTS "processed_events_sourceService_idx";
-
--- 创建新的复合唯一索引：(sourceService, eventId)
--- 这个组合保证跨服务的唯一性
-CREATE UNIQUE INDEX "processed_events_sourceService_eventId_key" ON "processed_events"("sourceService", "eventId");

backend/services/mining-admin-service/prisma/schema.prisma

@@ -422,16 +422,62 @@ model SyncedCirculationPool {
 
 model SyncedSystemContribution {
   id                      String   @id @default(uuid())
-  accountType             String   @unique  // OPERATION, PROVINCE, CITY, HEADQUARTERS
+  accountType             String   // OPERATION / PROVINCE / CITY / HEADQUARTERS
+  regionCode              String?  @map("region_code")  // 省/市代码，如 440000, 440100
   name                    String
   contributionBalance     Decimal  @db.Decimal(30, 8) @default(0)
   contributionNeverExpires Boolean @default(false)
   syncedAt                DateTime @default(now())
   updatedAt               DateTime @updatedAt
 
+  @@unique([accountType, regionCode])
+  @@index([accountType])
+  @@index([regionCode])
   @@map("synced_system_contributions")
 }
 
+// =============================================================================
+// CDC 同步表 - 系统账户算力明细 (from contribution-service)
+// =============================================================================
+
+model SyncedSystemContributionRecord {
+  id                      String   @id @default(uuid())
+  originalRecordId        BigInt   @unique @map("original_record_id")  // contribution-service 中的原始 ID
+
+  // 系统账户信息（冗余存储，便于查询）
+  accountType             String   @map("account_type")  // OPERATION / PROVINCE / CITY / HEADQUARTERS
+  regionCode              String?  @map("region_code")  // 省/市代码
+
+  // 来源信息
+  sourceAdoptionId        BigInt   @map("source_adoption_id")  // 来源认种ID
+  sourceAccountSequence   String   @map("source_account_sequence")  // 认种人账号
+
+  // 来源类型: FIXED_RATE(固定比例) / LEVEL_OVERFLOW(层级溢出) / LEVEL_NO_ANCESTOR(无上线) / BONUS_TIER_1/2/3(团队奖励未解锁)
+  sourceType              String   @map("source_type") @db.VarChar(30)
+  // 层级深度（1-15），仅对 LEVEL_OVERFLOW 和 LEVEL_NO_ANCESTOR 类型有效
+  levelDepth              Int?     @map("level_depth")
+
+  // 分配参数
+  distributionRate        Decimal  @map("distribution_rate") @db.Decimal(10, 6)  // 分配比例
+  amount                  Decimal  @map("amount") @db.Decimal(30, 10)  // 算力金额
+
+  // 有效期
+  effectiveDate           DateTime @map("effective_date") @db.Date  // 生效日期
+  expireDate              DateTime? @map("expire_date") @db.Date  // 过期日期（系统账户一般为null，永不过期）
+  isExpired               Boolean  @default(false) @map("is_expired")
+
+  createdAt               DateTime @map("created_at")  // 原始记录创建时间
+  syncedAt                DateTime @default(now())
+  updatedAt               DateTime @updatedAt
+
+  @@index([accountType, regionCode])
+  @@index([sourceAdoptionId])
+  @@index([sourceAccountSequence])
+  @@index([sourceType])
+  @@index([createdAt(sort: Desc)])
+  @@map("synced_system_contribution_records")
+}
+
 // =============================================================================
 // CDC 同步进度跟踪
 // =============================================================================

backend/services/mining-admin-service/src/api/api.module.ts

@@ -3,11 +3,14 @@ import { ApplicationModule } from '../application/application.module';
 import { AuthController } from './controllers/auth.controller';
 import { DashboardController } from './controllers/dashboard.controller';
 import { ConfigController } from './controllers/config.controller';
-import { InitializationController } from './controllers/initialization.controller';
 import { AuditController } from './controllers/audit.controller';
 import { HealthController } from './controllers/health.controller';
 import { UsersController } from './controllers/users.controller';
 import { SystemAccountsController } from './controllers/system-accounts.controller';
+import { ReportsController } from './controllers/reports.controller';
+import { ManualMiningController } from './controllers/manual-mining.controller';
+import { PendingContributionsController } from './controllers/pending-contributions.controller';
+import { BatchMiningController } from './controllers/batch-mining.controller';
 
 @Module({
   imports: [ApplicationModule],
@@ -15,11 +18,14 @@ import { SystemAccountsController } from './controllers/system-accounts.controll
     AuthController,
     DashboardController,
     ConfigController,
-    InitializationController,
     AuditController,
     HealthController,
     UsersController,
     SystemAccountsController,
+    ReportsController,
+    ManualMiningController,
+    PendingContributionsController,
+    BatchMiningController,
   ],
 })
 export class ApiModule {}

backend/services/mining-admin-service/src/api/controllers/audit.controller.ts

@@ -4,7 +4,7 @@ import { DashboardService } from '../../application/services/dashboard.service';
 
 @ApiTags('Audit')
 @ApiBearerAuth()
-@Controller('audit-logs')
+@Controller('audit')
 export class AuditController {
   constructor(private readonly dashboardService: DashboardService) {}
 
@@ -13,15 +13,42 @@ export class AuditController {
   @ApiQuery({ name: 'adminId', required: false })
   @ApiQuery({ name: 'action', required: false })
   @ApiQuery({ name: 'resource', required: false })
+  @ApiQuery({ name: 'keyword', required: false })
   @ApiQuery({ name: 'page', required: false, type: Number })
   @ApiQuery({ name: 'pageSize', required: false, type: Number })
   async getAuditLogs(
     @Query('adminId') adminId?: string,
     @Query('action') action?: string,
     @Query('resource') resource?: string,
+    @Query('keyword') keyword?: string,
     @Query('page') page?: number,
     @Query('pageSize') pageSize?: number,
   ) {
-    return this.dashboardService.getAuditLogs({ adminId, action, resource, page: page ?? 1, pageSize: pageSize ?? 50 });
+    const result = await this.dashboardService.getAuditLogs({
+      adminId,
+      action,
+      resource,
+      page: page ?? 1,
+      pageSize: pageSize ?? 20,
+    });
+
+    // 转换为前端期望的格式
+    return {
+      items: result.data.map((log: any) => ({
+        id: log.id,
+        adminId: log.adminId,
+        adminUsername: log.admin?.username || 'unknown',
+        action: log.action,
+        resource: log.resource,
+        resourceId: log.resourceId,
+        details: log.newValue ? JSON.stringify(log.newValue) : null,
+        ipAddress: log.ipAddress || '-',
+        createdAt: log.createdAt,
+      })),
+      total: result.total,
+      page: result.pagination.page,
+      pageSize: result.pagination.pageSize,
+      totalPages: result.pagination.totalPages,
+    };
   }
 }

backend/services/mining-admin-service/src/api/controllers/batch-mining.controller.ts

@@ -0,0 +1,364 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Body,
+  Req,
+  HttpException,
+  HttpStatus,
+  UseInterceptors,
+  UploadedFile,
+  Logger,
+} from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiBearerAuth,
+  ApiBody,
+  ApiConsumes,
+} from '@nestjs/swagger';
+import { FileInterceptor } from '@nestjs/platform-express';
+import * as XLSX from 'xlsx';
+import { BatchMiningService, BatchMiningItem } from '../../application/services/batch-mining.service';
+
+@ApiTags('Batch Mining')
+@ApiBearerAuth()
+@Controller('batch-mining')
+export class BatchMiningController {
+  private readonly logger = new Logger(BatchMiningController.name);
+
+  constructor(private readonly batchMiningService: BatchMiningService) {}
+
+  @Get('status')
+  @ApiOperation({ summary: '获取批量补发状态（是否已执行）' })
+  async getStatus() {
+    this.logger.log(`[GET /batch-mining/status] 请求获取批量补发状态`);
+    try {
+      const result = await this.batchMiningService.getStatus();
+      this.logger.log(`[GET /batch-mining/status] 返回: ${JSON.stringify(result)}`);
+      return result;
+    } catch (error) {
+      this.logger.error(`[GET /batch-mining/status] 错误:`, error);
+      throw error;
+    }
+  }
+
+  @Post('upload-preview')
+  @ApiOperation({ summary: '上传 Excel 文件并预览（不执行）' })
+  @ApiConsumes('multipart/form-data')
+  @ApiBody({
+    schema: {
+      type: 'object',
+      properties: {
+        file: {
+          type: 'string',
+          format: 'binary',
+          description: 'Excel 文件 (.xlsx)',
+        },
+      },
+    },
+  })
+  @UseInterceptors(FileInterceptor('file'))
+  async uploadAndPreview(@UploadedFile() file: Express.Multer.File) {
+    this.logger.log(`[POST /batch-mining/upload-preview] 开始处理上传预览请求`);
+
+    if (!file) {
+      this.logger.error(`[POST /batch-mining/upload-preview] 未收到文件`);
+      throw new HttpException('请上传文件', HttpStatus.BAD_REQUEST);
+    }
+
+    this.logger.log(`[POST /batch-mining/upload-preview] 收到文件: ${file.originalname}, 大小: ${file.size}, 类型: ${file.mimetype}`);
+
+    // 检查文件类型
+    const validTypes = [
+      'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+      'application/vnd.ms-excel',
+    ];
+    if (!validTypes.includes(file.mimetype) && !file.originalname.endsWith('.xlsx')) {
+      this.logger.error(`[POST /batch-mining/upload-preview] 文件类型不正确: ${file.mimetype}`);
+      throw new HttpException('请上传 Excel 文件 (.xlsx)', HttpStatus.BAD_REQUEST);
+    }
+
+    try {
+      // 解析 Excel
+      this.logger.log(`[POST /batch-mining/upload-preview] 开始解析 Excel...`);
+      const workbook = XLSX.read(file.buffer, { type: 'buffer' });
+      this.logger.log(`[POST /batch-mining/upload-preview] Excel Sheet 列表: ${workbook.SheetNames.join(', ')}`);
+
+      const sheetName = workbook.SheetNames[0];
+      const worksheet = workbook.Sheets[sheetName];
+
+      // 尝试读取 Sheet2（如果存在）
+      const actualSheetName = workbook.SheetNames.includes('Sheet2') ? 'Sheet2' : sheetName;
+      const actualSheet = workbook.Sheets[actualSheetName];
+      this.logger.log(`[POST /batch-mining/upload-preview] 使用 Sheet: ${actualSheetName}`);
+
+      // 转换为数组
+      const rows: any[][] = XLSX.utils.sheet_to_json(actualSheet, { header: 1 });
+      this.logger.log(`[POST /batch-mining/upload-preview] Excel 总行数: ${rows.length}`);
+
+      // 解析数据
+      const items = this.batchMiningService.parseExcelData(rows);
+      this.logger.log(`[POST /batch-mining/upload-preview] 解析后有效数据: ${items.length} 条`);
+
+      if (items.length === 0) {
+        this.logger.error(`[POST /batch-mining/upload-preview] Excel 文件中没有有效数据`);
+        throw new HttpException('Excel 文件中没有有效数据', HttpStatus.BAD_REQUEST);
+      }
+
+      // 调用预览 API
+      this.logger.log(`[POST /batch-mining/upload-preview] 调用 mining-service 预览 API...`);
+      const preview = await this.batchMiningService.preview(items);
+      this.logger.log(`[POST /batch-mining/upload-preview] 预览成功, 总金额: ${preview.grandTotalAmount}`);
+
+      return {
+        ...preview,
+        parsedItems: items,
+        originalFileName: file.originalname,
+      };
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[POST /batch-mining/upload-preview] 解析 Excel 文件失败:`, error);
+      throw new HttpException(
+        `解析 Excel 文件失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.BAD_REQUEST,
+      );
+    }
+  }
+
+  @Post('preview')
+  @ApiOperation({ summary: '预览批量补发（传入解析后的数据）' })
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['items'],
+      properties: {
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              accountSequence: { type: 'string' },
+              treeCount: { type: 'number' },
+              miningStartDate: { type: 'string' },
+              batch: { type: 'number' },
+              preMineDays: { type: 'number' },
+              remark: { type: 'string' },
+            },
+          },
+        },
+      },
+    },
+  })
+  async preview(@Body() body: { items: BatchMiningItem[] }) {
+    this.logger.log(`[POST /batch-mining/preview] 请求预览, 数据条数: ${body.items?.length || 0}`);
+
+    if (!body.items || body.items.length === 0) {
+      this.logger.error(`[POST /batch-mining/preview] 数据为空`);
+      throw new HttpException('数据不能为空', HttpStatus.BAD_REQUEST);
+    }
+
+    try {
+      const result = await this.batchMiningService.preview(body.items);
+      this.logger.log(`[POST /batch-mining/preview] 预览成功`);
+      return result;
+    } catch (error) {
+      this.logger.error(`[POST /batch-mining/preview] 错误:`, error);
+      throw error;
+    }
+  }
+
+  @Post('upload-execute')
+  @ApiOperation({ summary: '上传 Excel 文件并执行批量补发（只能执行一次）' })
+  @ApiConsumes('multipart/form-data')
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['file', 'reason'],
+      properties: {
+        file: {
+          type: 'string',
+          format: 'binary',
+          description: 'Excel 文件 (.xlsx)',
+        },
+        reason: {
+          type: 'string',
+          description: '补发原因（必填）',
+        },
+      },
+    },
+  })
+  @UseInterceptors(FileInterceptor('file'))
+  async uploadAndExecute(
+    @UploadedFile() file: Express.Multer.File,
+    @Body() body: { reason: string },
+    @Req() req: any,
+  ) {
+    this.logger.log(`[POST /batch-mining/upload-execute] 开始处理上传执行请求`);
+
+    if (!file) {
+      this.logger.error(`[POST /batch-mining/upload-execute] 未收到文件`);
+      throw new HttpException('请上传文件', HttpStatus.BAD_REQUEST);
+    }
+
+    this.logger.log(`[POST /batch-mining/upload-execute] 收到文件: ${file.originalname}, 原因: ${body.reason}`);
+
+    if (!body.reason || body.reason.trim().length === 0) {
+      this.logger.error(`[POST /batch-mining/upload-execute] 补发原因为空`);
+      throw new HttpException('补发原因不能为空', HttpStatus.BAD_REQUEST);
+    }
+
+    // 检查文件类型
+    const validTypes = [
+      'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+      'application/vnd.ms-excel',
+    ];
+    if (!validTypes.includes(file.mimetype) && !file.originalname.endsWith('.xlsx')) {
+      this.logger.error(`[POST /batch-mining/upload-execute] 文件类型不正确: ${file.mimetype}`);
+      throw new HttpException('请上传 Excel 文件 (.xlsx)', HttpStatus.BAD_REQUEST);
+    }
+
+    try {
+      // 解析 Excel
+      this.logger.log(`[POST /batch-mining/upload-execute] 开始解析 Excel...`);
+      const workbook = XLSX.read(file.buffer, { type: 'buffer' });
+      this.logger.log(`[POST /batch-mining/upload-execute] Excel Sheet 列表: ${workbook.SheetNames.join(', ')}`);
+
+      // 尝试读取 Sheet2（如果存在）
+      const actualSheetName = workbook.SheetNames.includes('Sheet2') ? 'Sheet2' : workbook.SheetNames[0];
+      const actualSheet = workbook.Sheets[actualSheetName];
+      this.logger.log(`[POST /batch-mining/upload-execute] 使用 Sheet: ${actualSheetName}`);
+
+      // 转换为数组
+      const rows: any[][] = XLSX.utils.sheet_to_json(actualSheet, { header: 1 });
+      this.logger.log(`[POST /batch-mining/upload-execute] Excel 总行数: ${rows.length}`);
+
+      // 解析数据
+      const items = this.batchMiningService.parseExcelData(rows);
+      this.logger.log(`[POST /batch-mining/upload-execute] 解析后有效数据: ${items.length} 条`);
+
+      if (items.length === 0) {
+        this.logger.error(`[POST /batch-mining/upload-execute] Excel 文件中没有有效数据`);
+        throw new HttpException('Excel 文件中没有有效数据', HttpStatus.BAD_REQUEST);
+      }
+
+      const admin = req.admin;
+      this.logger.log(`[POST /batch-mining/upload-execute] 操作管理员: ${admin?.username} (${admin?.id})`);
+
+      // 调用执行 API
+      this.logger.log(`[POST /batch-mining/upload-execute] 调用 mining-service 执行 API...`);
+      const result = await this.batchMiningService.execute(
+        {
+          items,
+          operatorId: admin.id,
+          operatorName: admin.username,
+          reason: body.reason,
+        },
+        admin.id,
+      );
+
+      this.logger.log(`[POST /batch-mining/upload-execute] 执行成功: successCount=${result.successCount}, totalAmount=${result.totalAmount}`);
+
+      return {
+        ...result,
+        originalFileName: file.originalname,
+      };
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[POST /batch-mining/upload-execute] 执行失败:`, error);
+      throw new HttpException(
+        `执行失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.BAD_REQUEST,
+      );
+    }
+  }
+
+  @Post('execute')
+  @ApiOperation({ summary: '执行批量补发（传入解析后的数据，只能执行一次）' })
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['items', 'reason'],
+      properties: {
+        items: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              accountSequence: { type: 'string' },
+              treeCount: { type: 'number' },
+              miningStartDate: { type: 'string' },
+              batch: { type: 'number' },
+              preMineDays: { type: 'number' },
+              remark: { type: 'string' },
+            },
+          },
+        },
+        reason: { type: 'string', description: '补发原因（必填）' },
+      },
+    },
+  })
+  async execute(
+    @Body() body: { items: BatchMiningItem[]; reason: string },
+    @Req() req: any,
+  ) {
+    this.logger.log(`[POST /batch-mining/execute] 请求执行批量补发`);
+    this.logger.log(`[POST /batch-mining/execute] 数据条数: ${body.items?.length || 0}, 原因: ${body.reason}`);
+
+    if (!body.items || body.items.length === 0) {
+      this.logger.error(`[POST /batch-mining/execute] 数据为空`);
+      throw new HttpException('数据不能为空', HttpStatus.BAD_REQUEST);
+    }
+
+    if (!body.reason || body.reason.trim().length === 0) {
+      this.logger.error(`[POST /batch-mining/execute] 补发原因为空`);
+      throw new HttpException('补发原因不能为空', HttpStatus.BAD_REQUEST);
+    }
+
+    const admin = req.admin;
+    this.logger.log(`[POST /batch-mining/execute] 操作管理员: ${admin?.username} (${admin?.id})`);
+
+    try {
+      const result = await this.batchMiningService.execute(
+        {
+          items: body.items,
+          operatorId: admin.id,
+          operatorName: admin.username,
+          reason: body.reason,
+        },
+        admin.id,
+      );
+      this.logger.log(`[POST /batch-mining/execute] 执行成功`);
+      return result;
+    } catch (error) {
+      this.logger.error(`[POST /batch-mining/execute] 错误:`, error);
+      throw error;
+    }
+  }
+
+  @Get('execution')
+  @ApiOperation({ summary: '获取批量补发执行记录（含明细）' })
+  async getExecution() {
+    this.logger.log(`[GET /batch-mining/execution] 请求获取执行记录`);
+
+    try {
+      const execution = await this.batchMiningService.getExecution();
+      if (!execution) {
+        this.logger.log(`[GET /batch-mining/execution] 尚未执行过批量补发`);
+        throw new HttpException('尚未执行过批量补发', HttpStatus.NOT_FOUND);
+      }
+      this.logger.log(`[GET /batch-mining/execution] 返回执行记录: id=${execution.id}`);
+      return execution;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[GET /batch-mining/execution] 错误:`, error);
+      throw error;
+    }
+  }
+}

backend/services/mining-admin-service/src/api/controllers/config.controller.ts

@@ -1,5 +1,6 @@
-import { Controller, Get, Post, Delete, Body, Param, Query, Req } from '@nestjs/common';
+import { Controller, Get, Post, Delete, Body, Param, Query, Req, Logger } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth, ApiQuery, ApiParam } from '@nestjs/swagger';
+import { ConfigService } from '@nestjs/config';
 import { ConfigManagementService } from '../../application/services/config.service';
 
 class SetConfigDto { category: string; key: string; value: string; description?: string; }
@@ -8,7 +9,12 @@ class SetConfigDto { category: string; key: string; value: string; description?:
 @ApiBearerAuth()
 @Controller('configs')
 export class ConfigController {
-  constructor(private readonly configService: ConfigManagementService) {}
+  private readonly logger = new Logger(ConfigController.name);
+
+  constructor(
+    private readonly configService: ConfigManagementService,
+    private readonly appConfigService: ConfigService,
+  ) {}
 
   @Get()
   @ApiOperation({ summary: '获取配置列表' })
@@ -17,6 +23,155 @@ export class ConfigController {
     return this.configService.getConfigs(category);
   }
 
+  @Get('transfer-enabled')
+  @ApiOperation({ summary: '获取划转开关状态' })
+  async getTransferEnabled() {
+    const config = await this.configService.getConfig('system', 'transfer_enabled');
+    return { enabled: config?.configValue === 'true' };
+  }
+
+  @Post('transfer-enabled')
+  @ApiOperation({ summary: '设置划转开关状态' })
+  async setTransferEnabled(@Body() body: { enabled: boolean }, @Req() req: any) {
+    await this.configService.setConfig(req.admin.id, 'system', 'transfer_enabled', String(body.enabled), '划转开关');
+    return { success: true };
+  }
+
+  @Get('mining/status')
+  @ApiOperation({ summary: '获取挖矿状态' })
+  async getMiningStatus() {
+    const miningServiceUrl = this.appConfigService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
+    const contributionServiceUrl = this.appConfigService.get<string>('CONTRIBUTION_SERVICE_URL', 'http://localhost:3020');
+
+    this.logger.log(`Fetching mining status from ${miningServiceUrl}/api/v2/admin/status`);
+    try {
+      // 并行获取 mining-service 状态和 contribution-service 统计数据
+      const [miningResponse, contributionResponse] = await Promise.all([
+        fetch(`${miningServiceUrl}/api/v2/admin/status`),
+        fetch(`${contributionServiceUrl}/api/v2/contribution/stats`).catch(() => null),
+      ]);
+
+      if (!miningResponse.ok) {
+        throw new Error(`Failed to fetch mining status: ${miningResponse.status}`);
+      }
+      const miningResult = await miningResponse.json();
+      this.logger.log(`Mining service response: ${JSON.stringify(miningResult)}`);
+
+      const miningData = miningResult.data || miningResult;
+
+      // 获取 contribution-service 的全网理论算力
+      let networkTotalContribution: string | null = null;
+      let userEffectiveContribution: string | null = null;
+      let systemAccountsContribution: string | null = null;
+
+      if (contributionResponse && contributionResponse.ok) {
+        const contributionResult = await contributionResponse.json();
+        const data = contributionResult.data || contributionResult;
+
+        // 全网理论算力 = 总认种树 × 每棵树算力
+        networkTotalContribution = data.networkTotalContribution || null;
+        // 用户有效算力
+        userEffectiveContribution = data.totalContribution || null;
+        // 系统账户算力
+        const systemAccounts = data.systemAccounts || [];
+        const systemTotal = systemAccounts
+          .filter((a: any) => a.accountType !== 'HEADQUARTERS')
+          .reduce((sum: number, a: any) => sum + parseFloat(a.totalContribution || '0'), 0);
+        systemAccountsContribution = systemTotal.toString();
+      }
+
+      // mining-service 中的全网理论算力
+      const miningNetworkTotal = miningData.networkTotalContribution || '0';
+      // mining-service 中的用户有效算力
+      const miningUserTotal = miningData.totalContribution || '0';
+
+      // 判断算力是否同步完成
+      // 核心条件：全网理论算力已同步（mining-service 的 networkTotalContribution 与 contribution-service 相近）
+      // 全网理论算力是挖矿分母，必须同步后才能正确计算挖矿比例
+      const networkSynced = networkTotalContribution !== null &&
+        parseFloat(networkTotalContribution) > 0 &&
+        parseFloat(miningNetworkTotal) > 0 &&
+        Math.abs(parseFloat(miningNetworkTotal) - parseFloat(networkTotalContribution)) / parseFloat(networkTotalContribution) < 0.001;
+
+      const isSynced = networkSynced;
+
+      return {
+        ...miningData,
+        contributionSyncStatus: {
+          isSynced,
+          // 全网理论算力（应作为挖矿分母）
+          networkTotalContribution: networkTotalContribution || '0',
+          miningNetworkTotal,
+          // 用户有效算力
+          userEffectiveContribution: userEffectiveContribution || '0',
+          miningUserTotal,
+          // 系统账户算力
+          systemAccountsContribution: systemAccountsContribution || '0',
+          // 兼容旧字段
+          miningTotal: miningUserTotal,
+          contributionTotal: userEffectiveContribution || '0',
+        },
+      };
+    } catch (error) {
+      this.logger.error('Failed to get mining status', error);
+      return {
+        initialized: false,
+        isActive: false,
+        error: `Unable to connect to mining service: ${error.message}`,
+        contributionSyncStatus: {
+          isSynced: false,
+          networkTotalContribution: '0',
+          miningNetworkTotal: '0',
+          userEffectiveContribution: '0',
+          miningUserTotal: '0',
+          systemAccountsContribution: '0',
+          miningTotal: '0',
+          contributionTotal: '0',
+        },
+      };
+    }
+  }
+
+  @Post('mining/activate')
+  @ApiOperation({ summary: '激活挖矿' })
+  async activateMining(@Req() req: any) {
+    const miningServiceUrl = this.appConfigService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
+    try {
+      const response = await fetch(`${miningServiceUrl}/api/v2/admin/activate`, {
+        method: 'POST',
+      });
+      if (!response.ok) {
+        throw new Error('Failed to activate mining');
+      }
+      const result = await response.json();
+      this.logger.log(`Mining activated by admin ${req.admin?.id}`);
+      return result;
+    } catch (error) {
+      this.logger.error('Failed to activate mining', error);
+      return { success: false, message: 'Failed to activate mining' };
+    }
+  }
+
+  @Post('mining/deactivate')
+  @ApiOperation({ summary: '停用挖矿' })
+  async deactivateMining(@Req() req: any) {
+    const miningServiceUrl = this.appConfigService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
+    try {
+      const response = await fetch(`${miningServiceUrl}/api/v2/admin/deactivate`, {
+        method: 'POST',
+      });
+      if (!response.ok) {
+        throw new Error('Failed to deactivate mining');
+      }
+      const result = await response.json();
+      this.logger.log(`Mining deactivated by admin ${req.admin?.id}`);
+      return result;
+    } catch (error) {
+      this.logger.error('Failed to deactivate mining', error);
+      return { success: false, message: 'Failed to deactivate mining' };
+    }
+  }
+
   @Get(':category/:key')
   @ApiOperation({ summary: '获取单个配置' })
   @ApiParam({ name: 'category' })

backend/services/mining-admin-service/src/api/controllers/dashboard.controller.ts

@@ -16,19 +16,105 @@ export class DashboardController {
   @Get()
   @ApiOperation({ summary: '获取仪表盘统计数据' })
   async getStats() {
-    return this.dashboardService.getDashboardStats();
+    const raw = await this.dashboardService.getDashboardStats();
+
+    // 计算24小时价格变化
+    let priceChange24h = 0;
+    if (raw.latestPrice) {
+      const open = parseFloat(raw.latestPrice.open) || 1;
+      const close = parseFloat(raw.latestPrice.close) || 1;
+      priceChange24h = (close - open) / open;
+    }
+
+    // 详细算力分解数据
+    const dc = raw.detailedContribution || {};
+
+    // 转换为前端期望的格式
+    // 优先使用远程服务数据，因为 CDC 同步可能不完整
+    const remoteData = raw.remoteData || {};
+
+    return {
+      // 基础统计
+      totalUsers: raw.users?.total || 0,
+      adoptedUsers: raw.users?.adopted || 0,
+      totalTrees: raw.contribution?.totalTrees || 0,
+      networkEffectiveContribution: raw.contribution?.effectiveContribution || '0',
+      networkTotalContribution: raw.contribution?.totalContribution || '0',
+      networkLevelPending: dc.levelContribution?.pending || '0',
+      networkBonusPending: dc.bonusContribution?.pending || '0',
+      // 已分配积分股：优先使用远程数据
+      totalDistributed: remoteData.totalDistributed || raw.mining?.totalMined || '0',
+      // 已销毁积分股：优先使用远程数据
+      totalBurned: remoteData.totalBurned || raw.mining?.latestDailyStat?.totalBurned || '0',
+      // 流通池：优先使用远程数据
+      circulationPool: remoteData.circulationPool || raw.trading?.circulationPool?.totalShares || '0',
+      currentPrice: raw.latestPrice?.close || '1',
+      priceChange24h,
+      totalOrders: raw.trading?.totalAccounts || 0,
+      totalTrades: raw.trading?.totalAccounts || 0,
+
+      // ========== 详细算力分解 ==========
+      detailedContribution: {
+        totalTrees: dc.totalTrees || 0,
+        // 全网算力（理论值）= 总树数 * 22617
+        networkTotalTheory: dc.networkTotalTheory || '0',
+        // 个人算力（70%）
+        personalTheory: dc.personalTheory || '0',
+        personalActual: raw.contribution?.personalContribution || '0',
+        // 运营账户（12%）
+        operationTheory: dc.operationTheory || '0',
+        operationActual: dc.operationActual || '0',
+        // 省公司（1%）
+        provinceTheory: dc.provinceTheory || '0',
+        provinceActual: dc.provinceActual || '0',
+        // 市公司（2%）
+        cityTheory: dc.cityTheory || '0',
+        cityActual: dc.cityActual || '0',
+
+        // 层级算力（7.5%）
+        level: {
+          theory: dc.levelTheory || '0',
+          unlocked: dc.levelContribution?.unlocked || '0',
+          pending: dc.levelContribution?.pending || '0',
+          // 分档详情
+          tier1: dc.levelContribution?.byTier?.tier1 || { unlocked: '0', pending: '0' },
+          tier2: dc.levelContribution?.byTier?.tier2 || { unlocked: '0', pending: '0' },
+          tier3: dc.levelContribution?.byTier?.tier3 || { unlocked: '0', pending: '0' },
+        },
+
+        // 团队奖励算力（7.5%）
+        bonus: {
+          theory: dc.bonusTheory || '0',
+          unlocked: dc.bonusContribution?.unlocked || '0',
+          pending: dc.bonusContribution?.pending || '0',
+          // 分档详情
+          tier1: dc.bonusContribution?.byTier?.tier1 || { unlocked: '0', pending: '0' },
+          tier2: dc.bonusContribution?.byTier?.tier2 || { unlocked: '0', pending: '0' },
+          tier3: dc.bonusContribution?.byTier?.tier3 || { unlocked: '0', pending: '0' },
+        },
+      },
+    };
   }
 
   @Get('stats')
   @ApiOperation({ summary: '获取仪表盘统计数据（别名）' })
   async getStatsAlias() {
-    return this.dashboardService.getDashboardStats();
+    return this.getStats();
   }
 
   @Get('realtime')
   @ApiOperation({ summary: '获取实时数据' })
   async getRealtimeStats() {
-    return this.dashboardService.getRealtimeStats();
+    const raw = await this.dashboardService.getRealtimeStats();
+
+    // 转换为前端期望的格式
+    return {
+      currentMinuteDistribution: raw.minuteDistribution || '0',
+      currentMinuteBurn: '0', // 暂无实时销毁数据
+      activeOrders: 0, // 暂无实时订单数据
+      pendingTrades: 0, // 暂无待处理交易数据
+      lastPriceUpdateAt: raw.timestamp,
+    };
   }
 
   @Get('reports')

backend/services/mining-admin-service/src/api/controllers/initialization.controller.ts

@@ -1,77 +0,0 @@
-import { Controller, Post, Body, Req } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
-import { InitializationService } from '../../application/services/initialization.service';
-
-class InitMiningConfigDto {
-  totalShares: string;
-  distributionPool: string;
-  halvingPeriodYears: number;
-  burnTarget: string;
-}
-
-@ApiTags('Initialization')
-@ApiBearerAuth()
-@Controller('initialization')
-export class InitializationController {
-  constructor(private readonly initService: InitializationService) {}
-
-  @Post('mining-config')
-  @ApiOperation({ summary: '初始化挖矿配置' })
-  async initMiningConfig(@Body() dto: InitMiningConfigDto, @Req() req: any) {
-    return this.initService.initializeMiningConfig(req.admin.id, dto);
-  }
-
-  @Post('system-accounts')
-  @ApiOperation({ summary: '初始化系统账户' })
-  async initSystemAccounts(@Req() req: any) {
-    return this.initService.initializeSystemAccounts(req.admin.id);
-  }
-
-  @Post('activate-mining')
-  @ApiOperation({ summary: '激活挖矿' })
-  async activateMining(@Req() req: any) {
-    return this.initService.activateMining(req.admin.id);
-  }
-
-  @Post('sync-users')
-  @ApiOperation({ summary: '同步所有用户数据（从auth-service初始同步）' })
-  async syncUsers(@Req() req: any) {
-    return this.initService.syncAllUsers(req.admin.id);
-  }
-
-  @Post('sync-contribution-accounts')
-  @ApiOperation({ summary: '同步所有算力账户（从contribution-service初始同步）' })
-  async syncContributionAccounts(@Req() req: any) {
-    return this.initService.syncAllContributionAccounts(req.admin.id);
-  }
-
-  @Post('sync-mining-accounts')
-  @ApiOperation({ summary: '同步所有挖矿账户（从mining-service初始同步）' })
-  async syncMiningAccounts(@Req() req: any) {
-    return this.initService.syncAllMiningAccounts(req.admin.id);
-  }
-
-  @Post('sync-trading-accounts')
-  @ApiOperation({ summary: '同步所有交易账户（从trading-service初始同步）' })
-  async syncTradingAccounts(@Req() req: any) {
-    return this.initService.syncAllTradingAccounts(req.admin.id);
-  }
-
-  @Post('sync-all')
-  @ApiOperation({ summary: '执行完整的数据同步（用户+算力+挖矿+交易）' })
-  async syncAll(@Req() req: any) {
-    const adminId = req.admin.id;
-    const results = {
-      users: await this.initService.syncAllUsers(adminId),
-      contribution: await this.initService.syncAllContributionAccounts(adminId),
-      mining: await this.initService.syncAllMiningAccounts(adminId),
-      trading: await this.initService.syncAllTradingAccounts(adminId),
-    };
-
-    return {
-      success: true,
-      message: '全部同步完成',
-      details: results,
-    };
-  }
-}

backend/services/mining-admin-service/src/api/controllers/manual-mining.controller.ts

@@ -0,0 +1,116 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Body,
+  Query,
+  Param,
+  HttpException,
+  HttpStatus,
+  Req,
+} from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiBearerAuth,
+  ApiBody,
+  ApiQuery,
+  ApiParam,
+} from '@nestjs/swagger';
+import { ManualMiningService } from '../../application/services/manual-mining.service';
+
+@ApiTags('Manual Mining')
+@ApiBearerAuth()
+@Controller('manual-mining')
+export class ManualMiningController {
+  constructor(private readonly manualMiningService: ManualMiningService) {}
+
+  @Post('calculate')
+  @ApiOperation({ summary: '计算手工补发挖矿预估金额' })
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['accountSequence', 'adoptionDate'],
+      properties: {
+        accountSequence: { type: 'string', description: '用户账户序列号' },
+        adoptionDate: {
+          type: 'string',
+          format: 'date',
+          description: '认种日期 (YYYY-MM-DD)',
+        },
+      },
+    },
+  })
+  async calculate(
+    @Body() body: { accountSequence: string; adoptionDate: string },
+  ) {
+    if (!body.accountSequence || !body.adoptionDate) {
+      throw new HttpException('账户序列号和认种日期不能为空', HttpStatus.BAD_REQUEST);
+    }
+    return this.manualMiningService.calculate(body);
+  }
+
+  @Post('execute')
+  @ApiOperation({ summary: '执行手工补发挖矿（仅超级管理员）' })
+  @ApiBody({
+    schema: {
+      type: 'object',
+      required: ['accountSequence', 'adoptionDate', 'reason'],
+      properties: {
+        accountSequence: { type: 'string', description: '用户账户序列号' },
+        adoptionDate: {
+          type: 'string',
+          format: 'date',
+          description: '认种日期 (YYYY-MM-DD)',
+        },
+        reason: { type: 'string', description: '补发原因（必填）' },
+      },
+    },
+  })
+  async execute(
+    @Body() body: { accountSequence: string; adoptionDate: string; reason: string },
+    @Req() req: any,
+  ) {
+    if (!body.accountSequence || !body.adoptionDate) {
+      throw new HttpException('账户序列号和认种日期不能为空', HttpStatus.BAD_REQUEST);
+    }
+    if (!body.reason || body.reason.trim().length === 0) {
+      throw new HttpException('补发原因不能为空', HttpStatus.BAD_REQUEST);
+    }
+
+    const admin = req.admin;
+    return this.manualMiningService.execute(
+      {
+        accountSequence: body.accountSequence,
+        adoptionDate: body.adoptionDate,
+        operatorId: admin.id,
+        operatorName: admin.username,
+        reason: body.reason,
+      },
+      admin.id,
+    );
+  }
+
+  @Get('records')
+  @ApiOperation({ summary: '获取手工补发记录列表' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  async getRecords(
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.manualMiningService.getRecords(page ?? 1, pageSize ?? 20);
+  }
+
+  @Get('records/:accountSequence')
+  @ApiOperation({ summary: '查询指定用户的手工补发记录' })
+  @ApiParam({ name: 'accountSequence', type: String })
+  async getRecordByAccount(@Param('accountSequence') accountSequence: string) {
+    const record =
+      await this.manualMiningService.getRecordByAccountSequence(accountSequence);
+    if (!record) {
+      throw new HttpException('该用户没有手工补发记录', HttpStatus.NOT_FOUND);
+    }
+    return record;
+  }
+}

backend/services/mining-admin-service/src/api/controllers/pending-contributions.controller.ts

@@ -0,0 +1,77 @@
+import { Controller, Get, Param, Query } from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiBearerAuth,
+  ApiParam,
+  ApiQuery,
+} from '@nestjs/swagger';
+import { PendingContributionsService } from '../../application/services/pending-contributions.service';
+
+@ApiTags('Pending Contributions')
+@ApiBearerAuth()
+@Controller('pending-contributions')
+export class PendingContributionsController {
+  constructor(
+    private readonly pendingContributionsService: PendingContributionsService,
+  ) {}
+
+  @Get()
+  @ApiOperation({ summary: '获取待解锁算力列表' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  @ApiQuery({
+    name: 'contributionType',
+    required: false,
+    type: String,
+    description: '算力类型筛选',
+  })
+  async getPendingContributions(
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+    @Query('contributionType') contributionType?: string,
+  ) {
+    return this.pendingContributionsService.getPendingContributions(
+      page ?? 1,
+      pageSize ?? 20,
+      contributionType,
+    );
+  }
+
+  @Get('summary')
+  @ApiOperation({ summary: '获取待解锁算力汇总统计' })
+  async getPendingContributionsSummary() {
+    return this.pendingContributionsService.getPendingContributionsSummary();
+  }
+
+  @Get('mining-records')
+  @ApiOperation({ summary: '获取所有待解锁算力的挖矿记录' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  async getAllPendingMiningRecords(
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.pendingContributionsService.getAllPendingMiningRecords(
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+
+  @Get(':id/records')
+  @ApiOperation({ summary: '获取某条待解锁算力的挖矿记录' })
+  @ApiParam({ name: 'id', type: String, description: '待解锁算力ID' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  async getPendingContributionMiningRecords(
+    @Param('id') id: string,
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.pendingContributionsService.getPendingContributionMiningRecords(
+      id,
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+}

backend/services/mining-admin-service/src/api/controllers/reports.controller.ts

@@ -0,0 +1,59 @@
+import { Controller, Get, Query } from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiBearerAuth,
+  ApiQuery,
+} from '@nestjs/swagger';
+import { DashboardService } from '../../application/services/dashboard.service';
+
+@ApiTags('Reports')
+@ApiBearerAuth()
+@Controller('reports')
+export class ReportsController {
+  constructor(private readonly dashboardService: DashboardService) {}
+
+  @Get('daily')
+  @ApiOperation({ summary: '获取每日报表' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  @ApiQuery({ name: 'days', required: false, type: Number })
+  async getDailyReports(
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+    @Query('days') days?: number,
+  ) {
+    const result = await this.dashboardService.getReports(
+      page ?? 1,
+      pageSize ?? 30,
+    );
+
+    // 转换为前端期望的格式
+    return {
+      items: result.data.map((report: any) => ({
+        id: report.id,
+        reportDate: report.reportDate,
+        totalUsers: report.users?.total || 0,
+        newUsers: report.users?.new || 0,
+        adoptedUsers: report.adoptions?.total || 0,
+        newAdoptedUsers: report.adoptions?.new || 0,
+        totalContribution: report.contribution?.total || '0',
+        newContribution: report.contribution?.growth || '0',
+        totalDistributed: report.mining?.distributed || '0',
+        dailyDistributed: report.mining?.distributed || '0',
+        totalBurned: report.mining?.burned || '0',
+        dailyBurned: report.mining?.burned || '0',
+        openPrice: report.price?.open || '1',
+        closePrice: report.price?.close || '1',
+        highPrice: report.price?.high || '1',
+        lowPrice: report.price?.low || '1',
+        totalVolume: report.trading?.volume || '0',
+        dailyVolume: report.trading?.volume || '0',
+      })),
+      total: result.total,
+      page: result.pagination.page,
+      pageSize: result.pagination.pageSize,
+      totalPages: result.pagination.totalPages,
+    };
+  }
+}

backend/services/mining-admin-service/src/api/controllers/system-accounts.controller.ts

@@ -1,5 +1,5 @@
-import { Controller, Get } from '@nestjs/common';
+import { Controller, Get, Param, Query } from '@nestjs/common';
-import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { ApiTags, ApiOperation, ApiBearerAuth, ApiParam, ApiQuery } from '@nestjs/swagger';
 import { SystemAccountsService } from '../../application/services/system-accounts.service';
 
 @ApiTags('System Accounts')
@@ -19,4 +19,89 @@ export class SystemAccountsController {
   async getSystemAccountsSummary() {
     return this.systemAccountsService.getSystemAccountsSummary();
   }
+
+  @Get(':accountType/records')
+  @ApiOperation({ summary: '获取系统账户挖矿记录' })
+  @ApiParam({ name: 'accountType', type: String, description: '系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）' })
+  @ApiQuery({ name: 'regionCode', required: false, type: String, description: '区域代码（省/市代码）' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  async getSystemAccountMiningRecords(
+    @Param('accountType') accountType: string,
+    @Query('regionCode') regionCode?: string,
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.systemAccountsService.getSystemAccountMiningRecords(
+      accountType,
+      regionCode || null,
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+
+  @Get(':accountType/transactions')
+  @ApiOperation({ summary: '获取系统账户交易记录' })
+  @ApiParam({ name: 'accountType', type: String, description: '系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）' })
+  @ApiQuery({ name: 'regionCode', required: false, type: String, description: '区域代码（省/市代码）' })
+  @ApiQuery({ name: 'page', required: false, type: Number })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number })
+  async getSystemAccountTransactions(
+    @Param('accountType') accountType: string,
+    @Query('regionCode') regionCode?: string,
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.systemAccountsService.getSystemAccountTransactions(
+      accountType,
+      regionCode || null,
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+
+  @Get(':accountType/contributions')
+  @ApiOperation({
+    summary: '获取系统账户算力来源明细',
+    description: '显示该账户的每笔算力来自哪个认种订单',
+  })
+  @ApiParam({
+    name: 'accountType',
+    type: String,
+    description: '系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）',
+  })
+  @ApiQuery({ name: 'regionCode', required: false, type: String, description: '区域代码（省/市代码）' })
+  @ApiQuery({ name: 'page', required: false, type: Number, description: '页码，默认1' })
+  @ApiQuery({ name: 'pageSize', required: false, type: Number, description: '每页数量，默认20' })
+  async getSystemAccountContributionRecords(
+    @Param('accountType') accountType: string,
+    @Query('regionCode') regionCode?: string,
+    @Query('page') page?: number,
+    @Query('pageSize') pageSize?: number,
+  ) {
+    return this.systemAccountsService.getSystemAccountContributionRecords(
+      accountType,
+      regionCode || null,
+      page ?? 1,
+      pageSize ?? 20,
+    );
+  }
+
+  @Get(':accountType/contribution-stats')
+  @ApiOperation({
+    summary: '获取系统账户算力明细统计',
+    description: '显示算力来源的汇总信息，包括记录数、来源认种订单数、来源用户数等',
+  })
+  @ApiParam({
+    name: 'accountType',
+    type: String,
+    description: '系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）',
+  })
+  @ApiQuery({ name: 'regionCode', required: false, type: String, description: '区域代码（省/市代码）' })
+  async getSystemAccountContributionStats(
+    @Param('accountType') accountType: string,
+    @Query('regionCode') regionCode?: string,
+  ) {
+    return this.systemAccountsService.getSystemAccountContributionStats(accountType, regionCode || null);
+  }
 }

backend/services/mining-admin-service/src/app.module.ts

@@ -12,7 +12,11 @@ import { AdminAuthGuard } from './shared/guards/admin-auth.guard';
   imports: [
     ConfigModule.forRoot({
       isGlobal: true,
-      envFilePath: [`.env.${process.env.NODE_ENV || 'development'}`, '.env'],
+      envFilePath: [
+        `.env.${process.env.NODE_ENV || 'development'}`,
+        '.env',
+        '../.env', // 父目录共享 .env
+      ],
     }),
     InfrastructureModule,
     ApplicationModule,

backend/services/mining-admin-service/src/application/application.module.ts

@@ -2,28 +2,37 @@ import { Module, OnModuleInit } from '@nestjs/common';
 import { InfrastructureModule } from '../infrastructure/infrastructure.module';
 import { AuthService } from './services/auth.service';
 import { ConfigManagementService } from './services/config.service';
-import { InitializationService } from './services/initialization.service';
 import { DashboardService } from './services/dashboard.service';
 import { UsersService } from './services/users.service';
 import { SystemAccountsService } from './services/system-accounts.service';
+import { DailyReportService } from './services/daily-report.service';
+import { ManualMiningService } from './services/manual-mining.service';
+import { PendingContributionsService } from './services/pending-contributions.service';
+import { BatchMiningService } from './services/batch-mining.service';
 
 @Module({
   imports: [InfrastructureModule],
   providers: [
     AuthService,
     ConfigManagementService,
-    InitializationService,
     DashboardService,
     UsersService,
     SystemAccountsService,
+    DailyReportService,
+    ManualMiningService,
+    PendingContributionsService,
+    BatchMiningService,
   ],
   exports: [
     AuthService,
     ConfigManagementService,
-    InitializationService,
     DashboardService,
     UsersService,
     SystemAccountsService,
+    DailyReportService,
+    ManualMiningService,
+    PendingContributionsService,
+    BatchMiningService,
   ],
 })
 export class ApplicationModule implements OnModuleInit {

backend/services/mining-admin-service/src/application/services/batch-mining.service.ts

@@ -0,0 +1,377 @@
+import { Injectable, Logger, HttpException, HttpStatus } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
+
+/**
+ * Excel 中的单行数据
+ */
+export interface BatchMiningItem {
+  accountSequence: string;    // 注册ID (用户账号序列号)
+  treeCount: number;          // 认种量（棵）
+  miningStartDate: string;    // 挖矿开始时间
+  batch: number;              // 批次号
+  preMineDays: number;        // 授权提前挖的天数（该批次比后续批次提前的天数）
+  totalMiningDays: number;    // 总挖矿天数（从挖矿开始日期到今天）
+  remark?: string;            // 备注
+}
+
+/**
+ * 批量补发请求
+ */
+export interface BatchMiningRequest {
+  items: BatchMiningItem[];
+  operatorId: string;
+  operatorName: string;
+  reason: string;
+}
+
+/**
+ * 批量补发挖矿服务 - 管理后台层
+ * 负责调用 mining-service 的内部 API
+ */
+@Injectable()
+export class BatchMiningService {
+  private readonly logger = new Logger(BatchMiningService.name);
+  private readonly miningServiceUrl: string;
+
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly configService: ConfigService,
+  ) {
+    this.miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+  }
+
+  /**
+   * 获取批量补发状态
+   */
+  async getStatus(): Promise<any> {
+    const url = `${this.miningServiceUrl}/api/v2/admin/batch-mining/status`;
+    this.logger.log(`[getStatus] 开始获取批量补发状态, URL: ${url}`);
+
+    try {
+      this.logger.log(`[getStatus] 发送 GET 请求...`);
+      const response = await fetch(url, {
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+      });
+
+      this.logger.log(`[getStatus] 响应状态码: ${response.status}`);
+      const result = await response.json();
+      this.logger.log(`[getStatus] 响应数据: ${JSON.stringify(result)}`);
+
+      if (!response.ok) {
+        this.logger.error(`[getStatus] 请求失败: ${result.message || '未知错误'}`);
+        throw new HttpException(
+          result.message || '获取状态失败',
+          response.status,
+        );
+      }
+
+      // mining-service 使用 TransformInterceptor 包装响应为 { success, data, timestamp }
+      const data = result.data || result;
+      this.logger.log(`[getStatus] 成功获取状态: hasExecuted=${data.hasExecuted}`);
+      return data;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[getStatus] 调用 mining-service 失败:`, error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 预览批量补发（计算但不执行）
+   */
+  async preview(items: BatchMiningItem[]): Promise<any> {
+    const url = `${this.miningServiceUrl}/api/v2/admin/batch-mining/preview`;
+    this.logger.log(`[preview] 开始预览批量补发, URL: ${url}`);
+    this.logger.log(`[preview] 数据条数: ${items.length}`);
+    this.logger.log(`[preview] 前3条数据: ${JSON.stringify(items.slice(0, 3))}`);
+
+    try {
+      this.logger.log(`[preview] 发送 POST 请求...`);
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ items }),
+      });
+
+      this.logger.log(`[preview] 响应状态码: ${response.status}`);
+      const result = await response.json();
+
+      if (!response.ok) {
+        this.logger.error(`[preview] 请求失败: ${result.message || '未知错误'}`);
+        throw new HttpException(
+          result.message || '预览失败',
+          response.status,
+        );
+      }
+
+      // mining-service 使用 TransformInterceptor 包装响应为 { success, data, timestamp }
+      const data = result.data || result;
+      this.logger.log(`[preview] 响应数据概要: totalBatches=${data.totalBatches}, totalUsers=${data.totalUsers}, grandTotalAmount=${data.grandTotalAmount}`);
+      this.logger.log(`[preview] 预览成功`);
+      return data;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[preview] 调用 mining-service 失败:`, error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 执行批量补发
+   */
+  async execute(
+    request: BatchMiningRequest,
+    adminId: string,
+  ): Promise<any> {
+    const url = `${this.miningServiceUrl}/api/v2/admin/batch-mining/execute`;
+    this.logger.log(`[execute] 开始执行批量补发, URL: ${url}`);
+    this.logger.log(`[execute] 操作人: ${request.operatorName} (${request.operatorId})`);
+    this.logger.log(`[execute] 原因: ${request.reason}`);
+    this.logger.log(`[execute] 数据条数: ${request.items.length}`);
+
+    try {
+      this.logger.log(`[execute] 发送 POST 请求...`);
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(request),
+      });
+
+      this.logger.log(`[execute] 响应状态码: ${response.status}`);
+      const result = await response.json();
+      this.logger.log(`[execute] 响应数据: ${JSON.stringify(result)}`);
+
+      if (!response.ok) {
+        this.logger.error(`[execute] 请求失败: ${result.message || '未知错误'}`);
+        throw new HttpException(
+          result.message || '执行失败',
+          response.status,
+        );
+      }
+
+      // mining-service 使用 TransformInterceptor 包装响应为 { success, data, timestamp }
+      const data = result.data || result;
+
+      // 记录审计日志
+      this.logger.log(`[execute] 记录审计日志...`);
+      await this.prisma.auditLog.create({
+        data: {
+          adminId,
+          action: 'CREATE',
+          resource: 'BATCH_MINING',
+          resourceId: data.batchId,
+          newValue: {
+            totalUsers: data.totalUsers,
+            successCount: data.successCount,
+            failedCount: data.failedCount,
+            totalAmount: data.totalAmount,
+            reason: request.reason,
+          },
+        },
+      });
+
+      this.logger.log(
+        `[execute] 批量补发执行成功: admin=${adminId}, total=${data.totalUsers}, success=${data.successCount}, amount=${data.totalAmount}`,
+      );
+
+      return data;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[execute] 调用 mining-service 失败:`, error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 获取执行记录
+   */
+  async getExecution(): Promise<any> {
+    const url = `${this.miningServiceUrl}/api/v2/admin/batch-mining/execution`;
+    this.logger.log(`[getExecution] 开始获取执行记录, URL: ${url}`);
+
+    try {
+      this.logger.log(`[getExecution] 发送 GET 请求...`);
+      const response = await fetch(url, {
+        method: 'GET',
+        headers: { 'Content-Type': 'application/json' },
+      });
+
+      this.logger.log(`[getExecution] 响应状态码: ${response.status}`);
+
+      if (response.status === 404) {
+        this.logger.log(`[getExecution] 未找到执行记录 (404)`);
+        return null;
+      }
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        this.logger.error(`[getExecution] 请求失败: ${result.message || '未知错误'}`);
+        throw new HttpException(
+          result.message || '获取记录失败',
+          response.status,
+        );
+      }
+
+      // mining-service 使用 TransformInterceptor 包装响应为 { success, data, timestamp }
+      const data = result.data || result;
+      this.logger.log(`[getExecution] 响应数据概要: id=${data.id}, totalUsers=${data.totalUsers}`);
+      this.logger.log(`[getExecution] 成功获取执行记录`);
+      return data;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error(`[getExecution] 调用 mining-service 失败:`, error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 解析 Excel 文件数据
+   * Excel 格式:
+   * 用户ID | 认种数量 | 认种时间 | 挖矿开始时间 | 批次 | 授权提前挖的天数 | 备注
+   */
+  parseExcelData(rows: any[]): BatchMiningItem[] {
+    this.logger.log(`[parseExcelData] 开始解析 Excel 数据, 总行数: ${rows.length}`);
+    const items: BatchMiningItem[] = [];
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+
+    // 打印前5行原始数据用于调试
+    this.logger.log(`[parseExcelData] 前5行原始数据:`);
+    for (let i = 0; i < Math.min(5, rows.length); i++) {
+      this.logger.log(`[parseExcelData] 行${i}: ${JSON.stringify(rows[i])}`);
+    }
+
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+
+      // 跳过空行
+      if (!row || !row[0]) {
+        this.logger.debug(`[parseExcelData] 跳过行 ${i + 1}: 空行`);
+        continue;
+      }
+
+      // 跳过标题行
+      const firstCell = String(row[0]).trim();
+      if (firstCell === '用户ID' || firstCell === '注册ID' || firstCell === '序号') {
+        this.logger.debug(`[parseExcelData] 跳过行 ${i + 1}: 标题行`);
+        continue;
+      }
+
+      // Excel 格式：序号 | 注册ID | 认种量（棵）| 挖矿开始时间 | 批次 | 授权提前挖的天数 | 备注
+      // 索引：      0      1         2              3          4           5            6
+
+      // 获取用户ID (第二列，索引1)
+      let accountSequence = String(row[1]).trim();
+      if (!accountSequence.startsWith('D')) {
+        accountSequence = 'D' + accountSequence;
+      }
+
+      // 获取认种量 (第三列，索引2)
+      const treeCount = parseInt(row[2], 10);
+      if (isNaN(treeCount) || treeCount <= 0) {
+        this.logger.debug(`[parseExcelData] 跳过行 ${i + 1}: 认种量无效 (${row[2]})`);
+        continue;
+      }
+
+      // 获取挖矿开始时间 (第四列，索引3)
+      const miningStartDateStr = String(row[3] || '').trim();
+
+      // 解析挖矿开始时间，计算总挖矿天数
+      const miningStartDate = this.parseDate(miningStartDateStr);
+      let totalMiningDays = 0;
+      if (miningStartDate) {
+        const diffTime = today.getTime() - miningStartDate.getTime();
+        totalMiningDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+      }
+
+      // 获取批次 (第五列，索引4)
+      const batch = parseInt(row[4], 10);
+      if (isNaN(batch) || batch <= 0) {
+        this.logger.warn(`[parseExcelData] 跳过行 ${i + 1}: 批次无效 (${row[4]})`);
+        continue;
+      }
+
+      // 获取授权提前挖的天数 (第六列，索引5)
+      const preMineDays = parseInt(row[5], 10);
+      if (isNaN(preMineDays) || preMineDays <= 0) {
+        this.logger.warn(`[parseExcelData] 跳过行 ${i + 1}: 授权提前挖的天数无效 (${row[5]})`);
+        continue;
+      }
+
+      // 获取备注 (第七列，索引6)
+      const remark = row[6] ? String(row[6]).trim() : undefined;
+
+      items.push({
+        accountSequence,
+        treeCount,
+        miningStartDate: miningStartDateStr,
+        batch,
+        preMineDays,
+        totalMiningDays,
+        remark,
+      });
+    }
+
+    this.logger.log(`[parseExcelData] 解析完成, 有效数据: ${items.length} 条`);
+    if (items.length > 0) {
+      this.logger.log(`[parseExcelData] 第一条数据: ${JSON.stringify(items[0])}`);
+      this.logger.log(`[parseExcelData] 最后一条数据: ${JSON.stringify(items[items.length - 1])}`);
+    }
+
+    return items;
+  }
+
+  /**
+   * 解析日期字符串
+   * 支持格式: 2025.11.8, 2025-11-08, 2025/11/8
+   */
+  private parseDate(dateStr: string): Date | null {
+    if (!dateStr) return null;
+
+    const formats = [
+      /^(\d{4})\.(\d{1,2})\.(\d{1,2})$/,  // 2025.11.8
+      /^(\d{4})-(\d{1,2})-(\d{1,2})$/,    // 2025-11-08
+      /^(\d{4})\/(\d{1,2})\/(\d{1,2})$/,  // 2025/11/8
+    ];
+
+    for (const format of formats) {
+      const match = dateStr.match(format);
+      if (match) {
+        const year = parseInt(match[1], 10);
+        const month = parseInt(match[2], 10) - 1;
+        const day = parseInt(match[3], 10);
+        const date = new Date(year, month, day);
+        date.setHours(0, 0, 0, 0);
+        return date;
+      }
+    }
+
+    return null;
+  }
+}

backend/services/mining-admin-service/src/application/services/daily-report.service.ts

@@ -0,0 +1,264 @@
+import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
+import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
+import Decimal from 'decimal.js';
+
+@Injectable()
+export class DailyReportService implements OnModuleInit {
+  private readonly logger = new Logger(DailyReportService.name);
+  private reportInterval: NodeJS.Timeout | null = null;
+
+  constructor(private readonly prisma: PrismaService) {}
+
+  async onModuleInit() {
+    // 启动时先生成一次报表
+    await this.generateTodayReport();
+
+    // 每小时检查并更新当日报表
+    this.reportInterval = setInterval(
+      () => this.generateTodayReport(),
+      60 * 60 * 1000, // 1 hour
+    );
+
+    this.logger.log('Daily report service initialized');
+  }
+
+  /**
+   * 生成或更新今日报表
+   */
+  async generateTodayReport(): Promise<void> {
+    const today = new Date();
+    today.setHours(0, 0, 0, 0);
+
+    try {
+      this.logger.log(`Generating daily report for ${today.toISOString().split('T')[0]}`);
+
+      // 收集各项统计数据
+      const [
+        userStats,
+        adoptionStats,
+        contributionStats,
+        miningStats,
+        tradingStats,
+        priceStats,
+      ] = await Promise.all([
+        this.getUserStats(today),
+        this.getAdoptionStats(today),
+        this.getContributionStats(today),
+        this.getMiningStats(),
+        this.getTradingStats(today),
+        this.getPriceStats(today),
+      ]);
+
+      // 更新或创建今日报表
+      await this.prisma.dailyReport.upsert({
+        where: { reportDate: today },
+        create: {
+          reportDate: today,
+          ...userStats,
+          ...adoptionStats,
+          ...contributionStats,
+          ...miningStats,
+          ...tradingStats,
+          ...priceStats,
+        },
+        update: {
+          ...userStats,
+          ...adoptionStats,
+          ...contributionStats,
+          ...miningStats,
+          ...tradingStats,
+          ...priceStats,
+        },
+      });
+
+      this.logger.log(`Daily report generated successfully for ${today.toISOString().split('T')[0]}`);
+    } catch (error) {
+      this.logger.error('Failed to generate daily report', error);
+    }
+  }
+
+  /**
+   * 生成历史报表（用于补数据）
+   */
+  async generateHistoricalReport(date: Date): Promise<void> {
+    const reportDate = new Date(date);
+    reportDate.setHours(0, 0, 0, 0);
+
+    const [
+      userStats,
+      adoptionStats,
+      contributionStats,
+      miningStats,
+      tradingStats,
+      priceStats,
+    ] = await Promise.all([
+      this.getUserStats(reportDate),
+      this.getAdoptionStats(reportDate),
+      this.getContributionStats(reportDate),
+      this.getMiningStats(),
+      this.getTradingStats(reportDate),
+      this.getPriceStats(reportDate),
+    ]);
+
+    await this.prisma.dailyReport.upsert({
+      where: { reportDate },
+      create: {
+        reportDate,
+        ...userStats,
+        ...adoptionStats,
+        ...contributionStats,
+        ...miningStats,
+        ...tradingStats,
+        ...priceStats,
+      },
+      update: {
+        ...userStats,
+        ...adoptionStats,
+        ...contributionStats,
+        ...miningStats,
+        ...tradingStats,
+        ...priceStats,
+      },
+    });
+  }
+
+  /**
+   * 用户统计
+   */
+  private async getUserStats(date: Date) {
+    const nextDay = new Date(date);
+    nextDay.setDate(nextDay.getDate() + 1);
+
+    const [totalUsers, newUsers] = await Promise.all([
+      this.prisma.syncedUser.count({
+        where: { createdAt: { lt: nextDay } },
+      }),
+      this.prisma.syncedUser.count({
+        where: {
+          createdAt: { gte: date, lt: nextDay },
+        },
+      }),
+    ]);
+
+    // 活跃用户暂时用总用户数（需要有活跃度跟踪才能准确计算）
+    const activeUsers = totalUsers;
+
+    return {
+      totalUsers,
+      newUsers,
+      activeUsers,
+    };
+  }
+
+  /**
+   * 认种统计
+   */
+  private async getAdoptionStats(date: Date) {
+    const nextDay = new Date(date);
+    nextDay.setDate(nextDay.getDate() + 1);
+
+    const [totalAdoptions, newAdoptions, treesResult] = await Promise.all([
+      this.prisma.syncedAdoption.count({
+        where: { adoptionDate: { lt: nextDay } },
+      }),
+      this.prisma.syncedAdoption.count({
+        where: {
+          adoptionDate: { gte: date, lt: nextDay },
+        },
+      }),
+      this.prisma.syncedAdoption.aggregate({
+        where: { adoptionDate: { lt: nextDay } },
+        _sum: { treeCount: true },
+      }),
+    ]);
+
+    return {
+      totalAdoptions,
+      newAdoptions,
+      totalTrees: treesResult._sum.treeCount || 0,
+    };
+  }
+
+  /**
+   * 算力统计
+   */
+  private async getContributionStats(date: Date) {
+    // 获取全网算力进度
+    const networkProgress = await this.prisma.syncedNetworkProgress.findFirst();
+
+    // 获取用户算力汇总
+    const userContribution = await this.prisma.syncedContributionAccount.aggregate({
+      _sum: {
+        totalContribution: true,
+        effectiveContribution: true,
+      },
+    });
+
+    const totalContribution = new Decimal(
+      userContribution._sum.totalContribution?.toString() || '0',
+    );
+
+    // 获取昨日报表计算增长
+    const yesterday = new Date(date);
+    yesterday.setDate(yesterday.getDate() - 1);
+    const yesterdayReport = await this.prisma.dailyReport.findUnique({
+      where: { reportDate: yesterday },
+    });
+
+    const contributionGrowth = yesterdayReport
+      ? totalContribution.minus(new Decimal(yesterdayReport.totalContribution.toString()))
+      : totalContribution;
+
+    return {
+      totalContribution,
+      contributionGrowth: contributionGrowth.gt(0) ? contributionGrowth : new Decimal(0),
+    };
+  }
+
+  /**
+   * 挖矿统计
+   */
+  private async getMiningStats() {
+    const dailyStat = await this.prisma.syncedDailyMiningStat.findFirst({
+      orderBy: { statDate: 'desc' },
+    });
+
+    return {
+      totalDistributed: dailyStat?.totalDistributed || new Decimal(0),
+      totalBurned: dailyStat?.totalBurned || new Decimal(0),
+    };
+  }
+
+  /**
+   * 交易统计
+   */
+  private async getTradingStats(date: Date) {
+    const kline = await this.prisma.syncedDayKLine.findUnique({
+      where: { klineDate: date },
+    });
+
+    return {
+      tradingVolume: kline?.volume || new Decimal(0),
+      tradingAmount: kline?.amount || new Decimal(0),
+      tradeCount: kline?.tradeCount || 0,
+    };
+  }
+
+  /**
+   * 价格统计
+   */
+  private async getPriceStats(date: Date) {
+    const kline = await this.prisma.syncedDayKLine.findUnique({
+      where: { klineDate: date },
+    });
+
+    const defaultPrice = new Decimal(1);
+
+    return {
+      openPrice: kline?.open || defaultPrice,
+      closePrice: kline?.close || defaultPrice,
+      highPrice: kline?.high || defaultPrice,
+      lowPrice: kline?.low || defaultPrice,
+    };
+  }
+}

backend/services/mining-admin-service/src/application/services/dashboard.service.ts

@@ -1,10 +1,30 @@
 import { Injectable, Logger } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
+import { Decimal } from 'decimal.js';
 import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
 
+// 基准算力常量
+const BASE_CONTRIBUTION_PER_TREE = new Decimal('22617');
+const RATE_PERSONAL = new Decimal('0.70');
+const RATE_OPERATION = new Decimal('0.12');
+const RATE_PROVINCE = new Decimal('0.01');
+const RATE_CITY = new Decimal('0.02');
+const RATE_LEVEL_TOTAL = new Decimal('0.075');
+const RATE_BONUS_TOTAL = new Decimal('0.075');
+
+// 远程服务数据缓存
+interface RemoteServiceData {
+  totalDistributed: string;
+  totalBurned: string;
+  circulationPool: string;
+  fetchedAt: Date;
+}
+
 @Injectable()
 export class DashboardService {
   private readonly logger = new Logger(DashboardService.name);
+  private remoteDataCache: RemoteServiceData | null = null;
+  private readonly CACHE_TTL_MS = 30000; // 30秒缓存
 
   constructor(
     private readonly prisma: PrismaService,
@@ -23,6 +43,8 @@ export class DashboardService {
       tradingStats,
       latestReport,
       latestKLine,
+      detailedContributionStats,
+      remoteData,
     ] = await Promise.all([
       this.getUserStats(),
       this.getContributionStats(),
@@ -30,13 +52,42 @@ export class DashboardService {
       this.getTradingStats(),
       this.prisma.dailyReport.findFirst({ orderBy: { reportDate: 'desc' } }),
       this.prisma.syncedDayKLine.findFirst({ orderBy: { klineDate: 'desc' } }),
+      this.getDetailedContributionStats(),
+      this.fetchRemoteServiceData(),
     ]);
 
+    // 合并远程服务数据（如果本地数据为空或为0则使用远程数据）
+    const totalMined = miningStats.totalMined !== '0'
+      ? miningStats.totalMined
+      : remoteData.totalDistributed;
+
+    const totalBurned = miningStats.latestDailyStat?.totalBurned || remoteData.totalBurned;
+
+    const circulationPoolShares = tradingStats.circulationPool?.totalShares !== '0'
+      ? tradingStats.circulationPool?.totalShares
+      : remoteData.circulationPool;
+
     return {
       users: userStats,
       contribution: contributionStats,
-      mining: miningStats,
+      mining: {
-      trading: tradingStats,
+        ...miningStats,
+        totalMined, // 使用合并后的已分配数据
+      },
+      trading: {
+        ...tradingStats,
+        circulationPool: {
+          totalShares: circulationPoolShares || '0',
+          totalCash: tradingStats.circulationPool?.totalCash || '0',
+        },
+      },
+      // 直接提供远程数据用于仪表盘显示
+      remoteData: {
+        totalDistributed: remoteData.totalDistributed,
+        totalBurned: remoteData.totalBurned,
+        circulationPool: remoteData.circulationPool,
+      },
+      detailedContribution: detailedContributionStats,
       latestReport: latestReport
         ? this.formatDailyReport(latestReport)
         : null,
@@ -110,39 +161,302 @@ export class DashboardService {
 
   /**
    * 获取算力统计
+   *
+   * 有效算力 = 个人算力(70%) + 运营账户(12%) + 省公司(1%) + 市公司(2%)
+   *          + 已解锁层级 + 未解锁层级 + 已解锁团队 + 未解锁团队
+   *        = 理论总算力（因为包含所有部分）
+   *        = 总树数 * 22617
    */
   private async getContributionStats() {
-    const accounts = await this.prisma.syncedContributionAccount.aggregate({
+    const [accounts, systemContributions, adoptionStats] = await Promise.all([
-      _sum: {
+      this.prisma.syncedContributionAccount.aggregate({
-        totalContribution: true,
+        _sum: {
-        effectiveContribution: true,
+          totalContribution: true,
-        personalContribution: true,
+          effectiveContribution: true,
-        teamLevelContribution: true,
+          personalContribution: true,
-        teamBonusContribution: true,
+          teamLevelContribution: true,
-      },
+          teamBonusContribution: true,
-      _count: true,
+        },
-    });
+        _count: true,
-
+      }),
-    const systemContributions =
+      this.prisma.syncedSystemContribution.aggregate({
-      await this.prisma.syncedSystemContribution.aggregate({
         _sum: { contributionBalance: true },
         _count: true,
-      });
+      }),
+      this.prisma.syncedAdoption.aggregate({
+        where: { status: 'MINING_ENABLED' },
+        _sum: { treeCount: true },
+        _count: true,
+      }),
+    ]);
+
+    const totalTrees = adoptionStats._sum.treeCount || 0;
+
+    // 有效算力 = 理论总算力 = 总树数 * 22617
+    // 因为按照公式，有效算力包含所有部分（个人70%+运营12%+省1%+市2%+层级7.5%+团队7.5%=100%）
+    const effectiveContribution = BASE_CONTRIBUTION_PER_TREE.mul(totalTrees);
+
+    // 个人算力（已分配到用户账户）
+    const personalContribution = new Decimal(accounts._sum.personalContribution || 0);
+
+    // 系统账户算力（运营+省+市）
+    const systemContribution = new Decimal(systemContributions._sum.contributionBalance || 0);
 
     return {
       totalAccounts: accounts._count,
       totalContribution: accounts._sum.totalContribution?.toString() || '0',
-      effectiveContribution:
+      effectiveContribution: effectiveContribution.toString(),
-        accounts._sum.effectiveContribution?.toString() || '0',
+      personalContribution: personalContribution.toString(),
-      personalContribution:
-        accounts._sum.personalContribution?.toString() || '0',
       teamLevelContribution:
         accounts._sum.teamLevelContribution?.toString() || '0',
       teamBonusContribution:
         accounts._sum.teamBonusContribution?.toString() || '0',
       systemAccounts: systemContributions._count,
-      systemContribution:
+      systemContribution: systemContribution.toString(),
-        systemContributions._sum.contributionBalance?.toString() || '0',
+      totalAdoptions: adoptionStats._count,
+      totalTrees,
+    };
+  }
+
+  /**
+   * 获取详细算力分解统计（按用户需求）
+   * 优先从 contribution-service API 获取完整数据（包含 pending），
+   * 如果 API 调用失败则回退到本地数据
+   */
+  private async getDetailedContributionStats() {
+    // 尝试从 contribution-service 获取完整数据
+    const contributionServiceData = await this.fetchContributionServiceStats();
+    if (contributionServiceData) {
+      return contributionServiceData;
+    }
+
+    // 回退：从本地同步数据计算
+    return this.getDetailedContributionStatsFromLocal();
+  }
+
+  /**
+   * 从 contribution-service API 获取详细算力统计
+   */
+  private async fetchContributionServiceStats(): Promise<any | null> {
+    const contributionServiceUrl = this.configService.get<string>(
+      'CONTRIBUTION_SERVICE_URL',
+      'http://localhost:3020',
+    );
+
+    try {
+      const response = await fetch(`${contributionServiceUrl}/api/v2/contribution/stats`);
+      if (!response.ok) {
+        this.logger.warn(`Contribution service returned ${response.status}`);
+        return null;
+      }
+
+      const result = await response.json();
+      const data = result.data || result;
+
+      // 获取系统账户实际值（本地数据）
+      const systemAccounts = await this.prisma.syncedSystemContribution.findMany();
+      let operationActual = new Decimal(0);
+      let provinceActual = new Decimal(0);
+      let cityActual = new Decimal(0);
+      for (const account of systemAccounts) {
+        const balance = new Decimal(account.contributionBalance || 0);
+        if (account.accountType === 'OPERATION') operationActual = operationActual.plus(balance);
+        else if (account.accountType === 'PROVINCE') provinceActual = provinceActual.plus(balance);
+        else if (account.accountType === 'CITY') cityActual = cityActual.plus(balance);
+      }
+
+      return {
+        totalTrees: data.totalTrees || 0,
+        // 理论值
+        networkTotalTheory: data.networkTotalContribution || '0',
+        personalTheory: data.personalTotalContribution || '0',
+        operationTheory: data.operationTotalContribution || '0',
+        provinceTheory: data.provinceTotalContribution || '0',
+        cityTheory: data.cityTotalContribution || '0',
+        levelTheory: data.levelContribution?.total || '0',
+        bonusTheory: data.bonusContribution?.total || '0',
+
+        // 实际值
+        operationActual: operationActual.toString(),
+        provinceActual: provinceActual.toString(),
+        cityActual: cityActual.toString(),
+
+        // 层级算力详情（包含正确的 pending 数据）
+        levelContribution: {
+          total: data.levelContribution?.total || '0',
+          unlocked: data.levelContribution?.unlocked || '0',
+          pending: data.levelContribution?.pending || '0',
+          byTier: {
+            tier1: {
+              unlocked: data.levelContribution?.byTier?.tier1?.unlocked || '0',
+              pending: data.levelContribution?.byTier?.tier1?.pending || '0',
+            },
+            tier2: {
+              unlocked: data.levelContribution?.byTier?.tier2?.unlocked || '0',
+              pending: data.levelContribution?.byTier?.tier2?.pending || '0',
+            },
+            tier3: {
+              unlocked: data.levelContribution?.byTier?.tier3?.unlocked || '0',
+              pending: data.levelContribution?.byTier?.tier3?.pending || '0',
+            },
+          },
+        },
+
+        // 团队奖励算力详情（包含正确的 pending 数据）
+        bonusContribution: {
+          total: data.bonusContribution?.total || '0',
+          unlocked: data.bonusContribution?.unlocked || '0',
+          pending: data.bonusContribution?.pending || '0',
+          byTier: {
+            tier1: {
+              unlocked: data.bonusContribution?.byTier?.tier1?.unlocked || '0',
+              pending: data.bonusContribution?.byTier?.tier1?.pending || '0',
+            },
+            tier2: {
+              unlocked: data.bonusContribution?.byTier?.tier2?.unlocked || '0',
+              pending: data.bonusContribution?.byTier?.tier2?.pending || '0',
+            },
+            tier3: {
+              unlocked: data.bonusContribution?.byTier?.tier3?.unlocked || '0',
+              pending: data.bonusContribution?.byTier?.tier3?.pending || '0',
+            },
+          },
+        },
+      };
+    } catch (error) {
+      this.logger.warn(`Failed to fetch contribution service stats: ${error.message}`);
+      return null;
+    }
+  }
+
+  /**
+   * 从本地同步数据计算详细算力统计（回退方案）
+   */
+  private async getDetailedContributionStatsFromLocal() {
+    // 获取总树数
+    const adoptionStats = await this.prisma.syncedAdoption.aggregate({
+      where: { status: 'MINING_ENABLED' },
+      _sum: { treeCount: true },
+    });
+    const totalTrees = adoptionStats._sum.treeCount || 0;
+
+    // 按层级统计已分配的层级算力
+    const levelRecords = await this.prisma.syncedContributionRecord.groupBy({
+      by: ['levelDepth'],
+      where: {
+        sourceType: 'TEAM_LEVEL',
+        levelDepth: { not: null },
+      },
+      _sum: { amount: true },
+    });
+
+    // 按档位统计已分配的团队奖励算力
+    const bonusRecords = await this.prisma.syncedContributionRecord.groupBy({
+      by: ['bonusTier'],
+      where: {
+        sourceType: 'TEAM_BONUS',
+        bonusTier: { not: null },
+      },
+      _sum: { amount: true },
+    });
+
+    // 获取系统账户按类型的算力
+    const systemAccounts = await this.prisma.syncedSystemContribution.findMany();
+
+    // 汇总层级1-5, 6-10, 11-15
+    let levelTier1 = new Decimal(0);
+    let levelTier2 = new Decimal(0);
+    let levelTier3 = new Decimal(0);
+    for (const record of levelRecords) {
+      const depth = record.levelDepth!;
+      const amount = new Decimal(record._sum.amount || 0);
+      if (depth >= 1 && depth <= 5) levelTier1 = levelTier1.plus(amount);
+      else if (depth >= 6 && depth <= 10) levelTier2 = levelTier2.plus(amount);
+      else if (depth >= 11 && depth <= 15) levelTier3 = levelTier3.plus(amount);
+    }
+
+    // 汇总团队奖励档位
+    let bonusTier1 = new Decimal(0);
+    let bonusTier2 = new Decimal(0);
+    let bonusTier3 = new Decimal(0);
+    for (const record of bonusRecords) {
+      const tier = record.bonusTier!;
+      const amount = new Decimal(record._sum.amount || 0);
+      if (tier === 1) bonusTier1 = amount;
+      else if (tier === 2) bonusTier2 = amount;
+      else if (tier === 3) bonusTier3 = amount;
+    }
+
+    const levelUnlocked = levelTier1.plus(levelTier2).plus(levelTier3);
+    const bonusUnlocked = bonusTier1.plus(bonusTier2).plus(bonusTier3);
+
+    // 计算理论值
+    const networkTotal = BASE_CONTRIBUTION_PER_TREE.mul(totalTrees);
+    const personalTheory = networkTotal.mul(RATE_PERSONAL);
+    const operationTheory = networkTotal.mul(RATE_OPERATION);
+    const provinceTheory = networkTotal.mul(RATE_PROVINCE);
+    const cityTheory = networkTotal.mul(RATE_CITY);
+    const levelTheory = networkTotal.mul(RATE_LEVEL_TOTAL);
+    const bonusTheory = networkTotal.mul(RATE_BONUS_TOTAL);
+
+    // 计算未解锁（理论 - 已解锁）- 仅用于总数，各档位无法获取
+    const levelPending = levelTheory.minus(levelUnlocked).greaterThan(0)
+      ? levelTheory.minus(levelUnlocked)
+      : new Decimal(0);
+    const bonusPending = bonusTheory.minus(bonusUnlocked).greaterThan(0)
+      ? bonusTheory.minus(bonusUnlocked)
+      : new Decimal(0);
+
+    // 系统账户按类型汇总
+    let operationActual = new Decimal(0);
+    let provinceActual = new Decimal(0);
+    let cityActual = new Decimal(0);
+    for (const account of systemAccounts) {
+      const balance = new Decimal(account.contributionBalance || 0);
+      if (account.accountType === 'OPERATION') operationActual = operationActual.plus(balance);
+      else if (account.accountType === 'PROVINCE') provinceActual = provinceActual.plus(balance);
+      else if (account.accountType === 'CITY') cityActual = cityActual.plus(balance);
+    }
+
+    return {
+      totalTrees,
+      // 理论值（基于总树数计算）
+      networkTotalTheory: networkTotal.toString(),
+      personalTheory: personalTheory.toString(),
+      operationTheory: operationTheory.toString(),
+      provinceTheory: provinceTheory.toString(),
+      cityTheory: cityTheory.toString(),
+      levelTheory: levelTheory.toString(),
+      bonusTheory: bonusTheory.toString(),
+
+      // 实际值（从数据库统计）
+      operationActual: operationActual.toString(),
+      provinceActual: provinceActual.toString(),
+      cityActual: cityActual.toString(),
+
+      // 层级算力详情（本地无法获取各档位 pending，显示为 N/A）
+      levelContribution: {
+        total: levelTheory.toString(),
+        unlocked: levelUnlocked.toString(),
+        pending: levelPending.toString(),
+        byTier: {
+          tier1: { unlocked: levelTier1.toString(), pending: 'N/A' },
+          tier2: { unlocked: levelTier2.toString(), pending: 'N/A' },
+          tier3: { unlocked: levelTier3.toString(), pending: 'N/A' },
+        },
+      },
+
+      // 团队奖励算力详情（本地无法获取各档位 pending，显示为 N/A）
+      bonusContribution: {
+        total: bonusTheory.toString(),
+        unlocked: bonusUnlocked.toString(),
+        pending: bonusPending.toString(),
+        byTier: {
+          tier1: { unlocked: bonusTier1.toString(), pending: 'N/A' },
+          tier2: { unlocked: bonusTier2.toString(), pending: 'N/A' },
+          tier3: { unlocked: bonusTier3.toString(), pending: 'N/A' },
+        },
+      },
     };
   }
 
@@ -295,6 +609,79 @@ export class DashboardService {
     };
   }
 
+  // ===========================================================================
+  // 远程服务数据获取（实时数据备选方案）
+  // ===========================================================================
+
+  /**
+   * 从 mining-service 和 trading-service 获取实时数据
+   * 用于补充 CDC 同步数据的不足
+   */
+  private async fetchRemoteServiceData(): Promise<RemoteServiceData> {
+    // 检查缓存
+    if (
+      this.remoteDataCache &&
+      Date.now() - this.remoteDataCache.fetchedAt.getTime() < this.CACHE_TTL_MS
+    ) {
+      return this.remoteDataCache;
+    }
+
+    const miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+    const tradingServiceUrl = this.configService.get<string>(
+      'TRADING_SERVICE_URL',
+      'http://localhost:3022',
+    );
+
+    let totalDistributed = '0';
+    let totalBurned = '0';
+    let circulationPool = '0';
+
+    try {
+      // 从 mining-service 获取已分配积分股
+      const miningResponse = await fetch(
+        `${miningServiceUrl}/api/v2/admin/status`,
+      );
+      if (miningResponse.ok) {
+        const miningResult = await miningResponse.json();
+        const miningData = miningResult.data || miningResult;
+        // 直接使用 totalDistributed（所有用户 totalMined 的总和）
+        totalDistributed = miningData.totalDistributed || '0';
+      }
+    } catch (error) {
+      this.logger.warn(`Failed to fetch mining service data: ${error.message}`);
+    }
+
+    try {
+      // 从 trading-service 获取市场概览（包含销毁和流通池数据）
+      const marketResponse = await fetch(
+        `${tradingServiceUrl}/api/v2/asset/market`,
+      );
+      if (marketResponse.ok) {
+        const marketResult = await marketResponse.json();
+        const marketData = marketResult.data || marketResult;
+        // blackHoleAmount 是已销毁总量
+        totalBurned = marketData.blackHoleAmount || '0';
+        // circulationPool 是流通池余额
+        circulationPool = marketData.circulationPool || '0';
+      }
+    } catch (error) {
+      this.logger.warn(`Failed to fetch market overview: ${error.message}`);
+    }
+
+    // 更新缓存
+    this.remoteDataCache = {
+      totalDistributed,
+      totalBurned,
+      circulationPool,
+      fetchedAt: new Date(),
+    };
+
+    return this.remoteDataCache;
+  }
+
   // ===========================================================================
   // 辅助方法
   // ===========================================================================

backend/services/mining-admin-service/src/application/services/initialization.service.ts

@@ -1,304 +0,0 @@
-import { Injectable, Logger } from '@nestjs/common';
-import { ConfigService } from '@nestjs/config';
-import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
-
-@Injectable()
-export class InitializationService {
-  private readonly logger = new Logger(InitializationService.name);
-
-  constructor(
-    private readonly prisma: PrismaService,
-    private readonly configService: ConfigService,
-  ) {}
-
-  async initializeMiningConfig(
-    adminId: string,
-    config: {
-      totalShares: string;
-      distributionPool: string;
-      halvingPeriodYears: number;
-      burnTarget: string;
-    },
-  ): Promise<{ success: boolean; message: string }> {
-    const record = await this.prisma.initializationRecord.create({
-      data: { type: 'MINING_CONFIG', status: 'PENDING', config, executedBy: adminId },
-    });
-
-    try {
-      const miningServiceUrl = this.configService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
-      const response = await fetch(`${miningServiceUrl}/api/v1/admin/initialize`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(config),
-      });
-
-      if (!response.ok) {
-        throw new Error('Failed to initialize mining config');
-      }
-
-      await this.prisma.initializationRecord.update({
-        where: { id: record.id },
-        data: { status: 'COMPLETED', executedAt: new Date() },
-      });
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'INIT', resource: 'MINING', resourceId: record.id, newValue: config },
-      });
-
-      return { success: true, message: 'Mining config initialized successfully' };
-    } catch (error: any) {
-      await this.prisma.initializationRecord.update({
-        where: { id: record.id },
-        data: { status: 'FAILED', errorMessage: error.message },
-      });
-
-      return { success: false, message: error.message };
-    }
-  }
-
-  async initializeSystemAccounts(adminId: string): Promise<{ success: boolean; message: string }> {
-    const accounts = [
-      { accountType: 'OPERATION', name: '运营账户', description: '12% 运营收入' },
-      { accountType: 'PROVINCE', name: '省公司账户', description: '1% 省公司收入' },
-      { accountType: 'CITY', name: '市公司账户', description: '2% 市公司收入' },
-    ];
-
-    for (const account of accounts) {
-      await this.prisma.systemAccount.upsert({
-        where: { accountType: account.accountType },
-        create: account,
-        update: { name: account.name, description: account.description },
-      });
-    }
-
-    await this.prisma.auditLog.create({
-      data: { adminId, action: 'INIT', resource: 'SYSTEM_ACCOUNT', newValue: accounts },
-    });
-
-    return { success: true, message: 'System accounts initialized successfully' };
-  }
-
-  async activateMining(adminId: string): Promise<{ success: boolean; message: string }> {
-    try {
-      const miningServiceUrl = this.configService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
-      const response = await fetch(`${miningServiceUrl}/api/v1/admin/activate`, { method: 'POST' });
-
-      if (!response.ok) {
-        throw new Error('Failed to activate mining');
-      }
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'INIT', resource: 'MINING', newValue: { action: 'ACTIVATE' } },
-      });
-
-      return { success: true, message: 'Mining activated successfully' };
-    } catch (error: any) {
-      return { success: false, message: error.message };
-    }
-  }
-
-  async syncAllUsers(adminId: string): Promise<{ success: boolean; message: string; syncedCount?: number }> {
-    try {
-      const authServiceUrl = this.configService.get<string>('AUTH_SERVICE_URL', 'http://localhost:3024');
-      const response = await fetch(`${authServiceUrl}/api/v2/admin/users/sync`);
-
-      if (!response.ok) {
-        throw new Error(`Failed to fetch users: ${response.statusText}`);
-      }
-
-      const responseData = await response.json();
-      const users = responseData.data?.users || responseData.users || [];
-      let syncedCount = 0;
-
-      for (const user of users) {
-        try {
-          await this.prisma.syncedUser.upsert({
-            where: { accountSequence: user.accountSequence },
-            create: {
-              originalUserId: user.id || user.accountSequence,
-              accountSequence: user.accountSequence,
-              phone: user.phone,
-              status: user.status || 'ACTIVE',
-              kycStatus: user.kycStatus || 'PENDING',
-              realName: user.realName || null,
-              isLegacyUser: user.isLegacyUser || false,
-              createdAt: new Date(user.createdAt),
-            },
-            update: {
-              phone: user.phone,
-              status: user.status || 'ACTIVE',
-              kycStatus: user.kycStatus || 'PENDING',
-              realName: user.realName || null,
-            },
-          });
-          syncedCount++;
-        } catch (err) {
-          this.logger.warn(`Failed to sync user ${user.accountSequence}: ${err}`);
-        }
-      }
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'SYNC', resource: 'USER', newValue: { syncedCount } },
-      });
-
-      return { success: true, message: `Synced ${syncedCount} users`, syncedCount };
-    } catch (error: any) {
-      return { success: false, message: error.message };
-    }
-  }
-
-  async syncAllContributionAccounts(adminId: string): Promise<{ success: boolean; message: string; syncedCount?: number }> {
-    try {
-      const contributionServiceUrl = this.configService.get<string>('CONTRIBUTION_SERVICE_URL', 'http://localhost:3020');
-      const response = await fetch(`${contributionServiceUrl}/api/v2/admin/accounts/sync`);
-
-      if (!response.ok) {
-        throw new Error(`Failed to fetch accounts: ${response.statusText}`);
-      }
-
-      const responseData = await response.json();
-      const accounts = responseData.data?.accounts || responseData.accounts || [];
-      let syncedCount = 0;
-
-      for (const account of accounts) {
-        try {
-          await this.prisma.syncedContributionAccount.upsert({
-            where: { accountSequence: account.accountSequence },
-            create: {
-              accountSequence: account.accountSequence,
-              personalContribution: account.personalContribution || 0,
-              teamLevelContribution: account.teamLevelContribution || 0,
-              teamBonusContribution: account.teamBonusContribution || 0,
-              totalContribution: account.totalContribution || 0,
-              effectiveContribution: account.effectiveContribution || 0,
-              hasAdopted: account.hasAdopted || false,
-              directReferralCount: account.directReferralAdoptedCount || 0,
-              unlockedLevelDepth: account.unlockedLevelDepth || 0,
-              unlockedBonusTiers: account.unlockedBonusTiers || 0,
-            },
-            update: {
-              personalContribution: account.personalContribution,
-              teamLevelContribution: account.teamLevelContribution,
-              teamBonusContribution: account.teamBonusContribution,
-              totalContribution: account.totalContribution,
-              effectiveContribution: account.effectiveContribution,
-              hasAdopted: account.hasAdopted,
-              directReferralCount: account.directReferralAdoptedCount,
-              unlockedLevelDepth: account.unlockedLevelDepth,
-              unlockedBonusTiers: account.unlockedBonusTiers,
-            },
-          });
-          syncedCount++;
-        } catch (err) {
-          this.logger.warn(`Failed to sync account ${account.accountSequence}: ${err}`);
-        }
-      }
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'SYNC', resource: 'CONTRIBUTION_ACCOUNT', newValue: { syncedCount } },
-      });
-
-      return { success: true, message: `Synced ${syncedCount} accounts`, syncedCount };
-    } catch (error: any) {
-      return { success: false, message: error.message };
-    }
-  }
-
-  async syncAllMiningAccounts(adminId: string): Promise<{ success: boolean; message: string; syncedCount?: number }> {
-    try {
-      const miningServiceUrl = this.configService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
-      const response = await fetch(`${miningServiceUrl}/api/v1/admin/accounts/sync`);
-
-      if (!response.ok) {
-        throw new Error(`Failed to fetch accounts: ${response.statusText}`);
-      }
-
-      const responseData = await response.json();
-      const accounts = responseData.data?.accounts || responseData.accounts || [];
-      let syncedCount = 0;
-
-      for (const account of accounts) {
-        try {
-          await this.prisma.syncedMiningAccount.upsert({
-            where: { accountSequence: account.accountSequence },
-            create: {
-              accountSequence: account.accountSequence,
-              totalMined: account.totalMined || 0,
-              availableBalance: account.availableBalance || 0,
-              frozenBalance: account.frozenBalance || 0,
-              totalContribution: account.totalContribution || 0,
-            },
-            update: {
-              totalMined: account.totalMined,
-              availableBalance: account.availableBalance,
-              frozenBalance: account.frozenBalance,
-              totalContribution: account.totalContribution,
-            },
-          });
-          syncedCount++;
-        } catch (err) {
-          this.logger.warn(`Failed to sync mining account ${account.accountSequence}: ${err}`);
-        }
-      }
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'SYNC', resource: 'MINING_ACCOUNT', newValue: { syncedCount } },
-      });
-
-      return { success: true, message: `Synced ${syncedCount} mining accounts`, syncedCount };
-    } catch (error: any) {
-      return { success: false, message: error.message };
-    }
-  }
-
-  async syncAllTradingAccounts(adminId: string): Promise<{ success: boolean; message: string; syncedCount?: number }> {
-    try {
-      const tradingServiceUrl = this.configService.get<string>('TRADING_SERVICE_URL', 'http://localhost:3022');
-      const response = await fetch(`${tradingServiceUrl}/api/v1/admin/accounts/sync`);
-
-      if (!response.ok) {
-        throw new Error(`Failed to fetch accounts: ${response.statusText}`);
-      }
-
-      const responseData = await response.json();
-      const accounts = responseData.data?.accounts || responseData.accounts || [];
-      let syncedCount = 0;
-
-      for (const account of accounts) {
-        try {
-          await this.prisma.syncedTradingAccount.upsert({
-            where: { accountSequence: account.accountSequence },
-            create: {
-              accountSequence: account.accountSequence,
-              shareBalance: account.shareBalance || 0,
-              cashBalance: account.cashBalance || 0,
-              frozenShares: account.frozenShares || 0,
-              frozenCash: account.frozenCash || 0,
-              totalBought: account.totalBought || 0,
-              totalSold: account.totalSold || 0,
-            },
-            update: {
-              shareBalance: account.shareBalance,
-              cashBalance: account.cashBalance,
-              frozenShares: account.frozenShares,
-              frozenCash: account.frozenCash,
-              totalBought: account.totalBought,
-              totalSold: account.totalSold,
-            },
-          });
-          syncedCount++;
-        } catch (err) {
-          this.logger.warn(`Failed to sync trading account ${account.accountSequence}: ${err}`);
-        }
-      }
-
-      await this.prisma.auditLog.create({
-        data: { adminId, action: 'SYNC', resource: 'TRADING_ACCOUNT', newValue: { syncedCount } },
-      });
-
-      return { success: true, message: `Synced ${syncedCount} trading accounts`, syncedCount };
-    } catch (error: any) {
-      return { success: false, message: error.message };
-    }
-  }
-}

backend/services/mining-admin-service/src/application/services/manual-mining.service.ts

@@ -0,0 +1,205 @@
+import { Injectable, Logger, HttpException, HttpStatus } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
+
+export interface ManualMiningCalculateRequest {
+  accountSequence: string;
+  adoptionDate: string;
+}
+
+export interface ManualMiningExecuteRequest {
+  accountSequence: string;
+  adoptionDate: string;
+  operatorId: string;
+  operatorName: string;
+  reason: string;
+}
+
+/**
+ * 手工补发挖矿服务 - 管理后台层
+ * 负责调用 mining-service 的内部 API
+ */
+@Injectable()
+export class ManualMiningService {
+  private readonly logger = new Logger(ManualMiningService.name);
+  private readonly miningServiceUrl: string;
+
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly configService: ConfigService,
+  ) {
+    this.miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+  }
+
+  /**
+   * 计算预估补发金额
+   */
+  async calculate(request: ManualMiningCalculateRequest): Promise<any> {
+    try {
+      const response = await fetch(
+        `${this.miningServiceUrl}/admin/manual-mining/calculate`,
+        {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(request),
+        },
+      );
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        throw new HttpException(
+          result.message || '计算失败',
+          response.status,
+        );
+      }
+
+      return result;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error('Failed to calculate manual mining', error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 执行手工补发
+   */
+  async execute(
+    request: ManualMiningExecuteRequest,
+    adminId: string,
+  ): Promise<any> {
+    try {
+      const response = await fetch(
+        `${this.miningServiceUrl}/admin/manual-mining/execute`,
+        {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(request),
+        },
+      );
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        throw new HttpException(
+          result.message || '执行失败',
+          response.status,
+        );
+      }
+
+      // 记录审计日志
+      await this.prisma.auditLog.create({
+        data: {
+          adminId,
+          action: 'CREATE',
+          resource: 'MANUAL_MINING',
+          resourceId: result.recordId,
+          newValue: {
+            accountSequence: request.accountSequence,
+            adoptionDate: request.adoptionDate,
+            amount: result.amount,
+            reason: request.reason,
+          },
+        },
+      });
+
+      this.logger.log(
+        `Manual mining executed by admin ${adminId}: account=${request.accountSequence}, amount=${result.amount}`,
+      );
+
+      return result;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error('Failed to execute manual mining', error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 获取补发记录列表
+   */
+  async getRecords(page: number = 1, pageSize: number = 20): Promise<any> {
+    try {
+      const response = await fetch(
+        `${this.miningServiceUrl}/admin/manual-mining/records?page=${page}&pageSize=${pageSize}`,
+        {
+          method: 'GET',
+          headers: { 'Content-Type': 'application/json' },
+        },
+      );
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        throw new HttpException(
+          result.message || '获取记录失败',
+          response.status,
+        );
+      }
+
+      return result;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error('Failed to get manual mining records', error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+
+  /**
+   * 根据 accountSequence 获取补发记录
+   */
+  async getRecordByAccountSequence(accountSequence: string): Promise<any> {
+    try {
+      const response = await fetch(
+        `${this.miningServiceUrl}/admin/manual-mining/records/${accountSequence}`,
+        {
+          method: 'GET',
+          headers: { 'Content-Type': 'application/json' },
+        },
+      );
+
+      if (response.status === 404) {
+        return null;
+      }
+
+      const result = await response.json();
+
+      if (!response.ok) {
+        throw new HttpException(
+          result.message || '获取记录失败',
+          response.status,
+        );
+      }
+
+      return result;
+    } catch (error) {
+      if (error instanceof HttpException) {
+        throw error;
+      }
+      this.logger.error('Failed to get manual mining record', error);
+      throw new HttpException(
+        `调用 mining-service 失败: ${error instanceof Error ? error.message : error}`,
+        HttpStatus.INTERNAL_SERVER_ERROR,
+      );
+    }
+  }
+}

backend/services/mining-admin-service/src/application/services/pending-contributions.service.ts

@@ -0,0 +1,138 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { HttpService } from '@nestjs/axios';
+import { ConfigService } from '@nestjs/config';
+import { firstValueFrom } from 'rxjs';
+
+@Injectable()
+export class PendingContributionsService {
+  private readonly logger = new Logger(PendingContributionsService.name);
+
+  constructor(
+    private readonly httpService: HttpService,
+    private readonly configService: ConfigService,
+  ) {}
+
+  private getMiningServiceUrl(): string {
+    return this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+  }
+
+  /**
+   * 获取待解锁算力列表
+   */
+  async getPendingContributions(
+    page: number = 1,
+    pageSize: number = 20,
+    contributionType?: string,
+  ) {
+    const miningServiceUrl = this.getMiningServiceUrl();
+
+    try {
+      const params: any = { page, pageSize };
+      if (contributionType) {
+        params.contributionType = contributionType;
+      }
+
+      const response = await firstValueFrom(
+        this.httpService.get(`${miningServiceUrl}/admin/pending-contributions`, {
+          params,
+        }),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch pending contributions: ${error.message}`,
+      );
+      return { contributions: [], total: 0, page, pageSize };
+    }
+  }
+
+  /**
+   * 获取待解锁算力汇总统计
+   */
+  async getPendingContributionsSummary() {
+    const miningServiceUrl = this.getMiningServiceUrl();
+
+    try {
+      const response = await firstValueFrom(
+        this.httpService.get(
+          `${miningServiceUrl}/admin/pending-contributions/summary`,
+        ),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch pending contributions summary: ${error.message}`,
+      );
+      return {
+        byType: [],
+        total: { totalAmount: '0', count: 0 },
+        totalMinedToHeadquarters: '0',
+      };
+    }
+  }
+
+  /**
+   * 获取某条待解锁算力的挖矿记录
+   */
+  async getPendingContributionMiningRecords(
+    id: string,
+    page: number = 1,
+    pageSize: number = 20,
+  ) {
+    const miningServiceUrl = this.getMiningServiceUrl();
+
+    try {
+      const response = await firstValueFrom(
+        this.httpService.get(
+          `${miningServiceUrl}/admin/pending-contributions/${id}/records`,
+          {
+            params: { page, pageSize },
+          },
+        ),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch pending contribution mining records: ${error.message}`,
+      );
+      return {
+        pendingContribution: null,
+        records: [],
+        total: 0,
+        page,
+        pageSize,
+      };
+    }
+  }
+
+  /**
+   * 获取所有待解锁算力的挖矿记录
+   */
+  async getAllPendingMiningRecords(page: number = 1, pageSize: number = 20) {
+    const miningServiceUrl = this.getMiningServiceUrl();
+
+    try {
+      const response = await firstValueFrom(
+        this.httpService.get(
+          `${miningServiceUrl}/admin/pending-contributions/mining-records`,
+          {
+            params: { page, pageSize },
+          },
+        ),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch all pending mining records: ${error.message}`,
+      );
+      return { records: [], total: 0, page, pageSize };
+    }
+  }
+}

backend/services/mining-admin-service/src/application/services/system-accounts.service.ts

@@ -1,84 +1,246 @@
-import { Injectable } from '@nestjs/common';
+import { Injectable, Logger } from '@nestjs/common';
+import { HttpService } from '@nestjs/axios';
+import { ConfigService } from '@nestjs/config';
+import { firstValueFrom } from 'rxjs';
 import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
 
+interface MiningServiceSystemAccount {
+  id: string;
+  accountType: string;   // OPERATION / PROVINCE / CITY / HEADQUARTERS
+  regionCode: string | null;  // 省/市代码，如 440000, 440100
+  name: string;
+  totalMined: string;
+  availableBalance: string;
+  totalContribution: string;
+  lastSyncedAt: string | null;
+}
+
+interface MiningServiceResponse {
+  accounts: MiningServiceSystemAccount[];
+  total: number;
+}
+
 @Injectable()
 export class SystemAccountsService {
-  constructor(private readonly prisma: PrismaService) {}
+  private readonly logger = new Logger(SystemAccountsService.name);
+
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly httpService: HttpService,
+    private readonly configService: ConfigService,
+  ) {}
+
+  /**
+   * 从 mining-service 获取系统账户挖矿数据
+   */
+  private async fetchMiningServiceSystemAccounts(): Promise<Map<string, MiningServiceSystemAccount>> {
+    const miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+
+    try {
+      const response = await firstValueFrom(
+        this.httpService.get<MiningServiceResponse>(
+          `${miningServiceUrl}/admin/system-accounts`,
+        ),
+      );
+
+      const miningDataMap = new Map<string, MiningServiceSystemAccount>();
+      for (const account of response.data.accounts) {
+        // 使用 accountType:regionCode 作为 key，与 contribution 表一致
+        const key = account.regionCode
+          ? `${account.accountType}:${account.regionCode}`
+          : account.accountType;
+        miningDataMap.set(key, account);
+      }
+
+      return miningDataMap;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch mining service system accounts: ${error.message}`,
+      );
+      return new Map();
+    }
+  }
 
   /**
    * 获取系统账户列表
+   * 以 synced_system_contributions 为主要数据源，显示所有省市账户
+   * 同时关联钱包数据和挖矿数据
    */
   async getSystemAccounts() {
-    // 先从本地 SystemAccount 表获取
+    // 从 CDC 同步的 SyncedSystemContribution 获取算力数据（主要数据源）
-    const localAccounts = await this.prisma.systemAccount.findMany({
+    const syncedContributions = await this.prisma.syncedSystemContribution.findMany({
-      orderBy: { accountType: 'asc' },
+      orderBy: [{ accountType: 'asc' }, { regionCode: 'asc' }],
     });
 
-    // 再从 CDC 同步的 SyncedSystemContribution 获取算力数据
+    // 从 CDC 同步的 SyncedWalletSystemAccount 表获取钱包数据
-    const syncedContributions =
+    const syncedWalletAccounts = await this.prisma.syncedWalletSystemAccount.findMany();
-      await this.prisma.syncedSystemContribution.findMany();
 
-    // 合并数据
+    // 从 mining-service 获取挖矿数据
-    const accountsMap = new Map<string, any>();
+    const miningDataMap = await this.fetchMiningServiceSystemAccounts();
 
-    // 添加本地账户
+    // 获取省市名称映射
-    for (const account of localAccounts) {
+    const regionNameMap = await this.buildRegionNameMap();
-      accountsMap.set(account.accountType, {
+
-        accountType: account.accountType,
+    // 构建钱包数据映射
-        name: account.name,
+    const walletMap = new Map<string, any>();
-        description: account.description,
+    for (const wallet of syncedWalletAccounts) {
-        totalContribution: account.totalContribution.toString(),
+      // 钱包账户的 code 格式为 "CITY-440100"、"PROVINCE-440000" 等
-        createdAt: account.createdAt,
+      if (wallet.code) {
-        source: 'local',
+        const regionCode = this.extractRegionCodeFromCode(wallet.code);
-      });
+        if (regionCode) {
+          const key = `${wallet.accountType}:${regionCode}`;
+          walletMap.set(key, wallet);
+        }
+      }
+      // 同时用 accountType 作为 key（用于 OPERATION、HEADQUARTERS 等）
+      walletMap.set(wallet.accountType, wallet);
     }
 
-    // 更新或添加同步的算力数据
+    // 构建返回数据 - 以算力账户为主
-    for (const contrib of syncedContributions) {
+    const accounts = syncedContributions.map((contrib) => {
-      const existing = accountsMap.get(contrib.accountType);
+      const key = contrib.regionCode
-      if (existing) {
+        ? `${contrib.accountType}:${contrib.regionCode}`
-        existing.contributionBalance = contrib.contributionBalance.toString();
+        : contrib.accountType;
-        existing.contributionNeverExpires = contrib.contributionNeverExpires;
+
-        existing.syncedAt = contrib.syncedAt;
+      const wallet = walletMap.get(key) || walletMap.get(contrib.accountType);
-        existing.source = 'synced';
+      const miningData = miningDataMap.get(key) || miningDataMap.get(contrib.accountType);
-      } else {
+
-        accountsMap.set(contrib.accountType, {
+      // 获取显示名称
-          accountType: contrib.accountType,
+      const displayName = this.getDisplayName(contrib.accountType, contrib.regionCode, regionNameMap);
-          name: contrib.name,
+
-          contributionBalance: contrib.contributionBalance.toString(),
+      return {
-          contributionNeverExpires: contrib.contributionNeverExpires,
+        id: contrib.id,
-          syncedAt: contrib.syncedAt,
+        accountType: contrib.accountType,
-          source: 'synced',
+        regionCode: contrib.regionCode,
-        });
+        name: displayName,
+        code: wallet?.code || null,
+        provinceId: wallet?.provinceId || null,
+        cityId: wallet?.cityId || null,
+        // 钱包余额（如果有钱包账户）
+        shareBalance: wallet?.shareBalance?.toString() || '0',
+        usdtBalance: wallet?.usdtBalance?.toString() || '0',
+        greenPointBalance: wallet?.greenPointBalance?.toString() || '0',
+        frozenShare: wallet?.frozenShare?.toString() || '0',
+        frozenUsdt: wallet?.frozenUsdt?.toString() || '0',
+        totalInflow: wallet?.totalInflow?.toString() || '0',
+        totalOutflow: wallet?.totalOutflow?.toString() || '0',
+        blockchainAddress: wallet?.blockchainAddress || null,
+        isActive: wallet?.isActive ?? true,
+        // 算力数据
+        contributionBalance: contrib.contributionBalance?.toString() || '0',
+        contributionNeverExpires: contrib.contributionNeverExpires || false,
+        // 挖矿数据
+        totalMined: miningData?.totalMined || '0',
+        availableBalance: miningData?.availableBalance || '0',
+        miningContribution: miningData?.totalContribution || '0',
+        miningLastSyncedAt: miningData?.lastSyncedAt || null,
+        syncedAt: contrib.syncedAt,
+        source: 'contribution',
+      };
+    });
+
+    return {
+      accounts,
+      total: accounts.length,
+    };
+  }
+
+  /**
+   * 构建区域代码到名称的映射
+   */
+  private async buildRegionNameMap(): Promise<Map<string, string>> {
+    const [provinces, cities] = await Promise.all([
+      this.prisma.syncedProvince.findMany({ select: { code: true, name: true } }),
+      this.prisma.syncedCity.findMany({ select: { code: true, name: true } }),
+    ]);
+
+    const map = new Map<string, string>();
+    for (const province of provinces) {
+      map.set(province.code, province.name);
+    }
+    for (const city of cities) {
+      map.set(city.code, city.name);
+    }
+    return map;
+  }
+
+  /**
+   * 根据账户类型和区域代码获取显示名称
+   */
+  private getDisplayName(
+    accountType: string,
+    regionCode: string | null,
+    regionNameMap: Map<string, string>,
+  ): string {
+    // 基础账户类型名称
+    const baseNames: Record<string, string> = {
+      OPERATION: '运营账户',
+      HEADQUARTERS: '总部账户',
+      PROVINCE: '省公司账户',
+      CITY: '市公司账户',
+    };
+
+    if (!regionCode) {
+      return baseNames[accountType] || accountType;
+    }
+
+    // 根据区域代码查找名称
+    const regionName = regionNameMap.get(regionCode);
+    if (regionName) {
+      if (accountType === 'PROVINCE') {
+        return `${regionName}省公司`;
+      } else if (accountType === 'CITY') {
+        return `${regionName}市公司`;
       }
     }
 
-    return {
+    // 回退：使用区域代码
-      accounts: Array.from(accountsMap.values()),
+    return `${regionCode}账户`;
-      total: accountsMap.size,
+  }
-    };
+
+  /**
+   * 从钱包账户的 code 提取区域代码
+   * 例如: "CITY-440100" -> "440100", "PROVINCE-440000" -> "440000"
+   * 对于非区域账户（如 "HEADQUARTERS"）返回 null
+   */
+  private extractRegionCodeFromCode(code: string): string | null {
+    if (!code) return null;
+    // 匹配 CITY-XXXXXX, PROVINCE-XXXXXX, PROV-XXXXXX 格式
+    const match = code.match(/^(?:CITY|PROVINCE|PROV)-(\d+)$/);
+    return match ? match[1] : null;
   }
 
   /**
    * 获取系统账户汇总
    */
   async getSystemAccountsSummary() {
-    const [localAccounts, syncedContributions, miningConfig, circulationPool] =
+    const [
-      await Promise.all([
+      syncedSystemAccounts,
-        this.prisma.systemAccount.findMany(),
+      syncedPoolAccounts,
-        this.prisma.syncedSystemContribution.findMany(),
+      syncedContributions,
-        this.prisma.syncedMiningConfig.findFirst(),
+      miningConfig,
-        this.prisma.syncedCirculationPool.findFirst(),
+      circulationPool,
-      ]);
+    ] = await Promise.all([
+      this.prisma.syncedWalletSystemAccount.findMany(),
+      this.prisma.syncedWalletPoolAccount.findMany(),
+      this.prisma.syncedSystemContribution.findMany(),
+      this.prisma.syncedMiningConfig.findFirst(),
+      this.prisma.syncedCirculationPool.findFirst(),
+    ]);
 
-    // 计算总算力
+    // 从 mining-service 获取挖矿数据汇总
-    let totalSystemContribution = 0n;
+    const miningDataMap = await this.fetchMiningServiceSystemAccounts();
-    for (const account of localAccounts) {
+
-      totalSystemContribution += BigInt(
+    // 计算总挖矿积分股
-        account.totalContribution.toString().replace('.', ''),
+    let totalMined = 0;
-      );
+    for (const miningData of miningDataMap.values()) {
+      totalMined += Number(miningData.totalMined || 0);
     }
 
+    // 计算总算力
     let totalSyncedContribution = 0n;
     for (const contrib of syncedContributions) {
       totalSyncedContribution += BigInt(
@@ -88,10 +250,22 @@ export class SystemAccountsService {
 
     return {
       systemAccounts: {
-        count: localAccounts.length,
+        count: syncedSystemAccounts.length,
-        totalContribution: (
+        totalBalance: syncedSystemAccounts.reduce(
-          Number(totalSystemContribution) / 100000000
+          (sum, acc) => sum + Number(acc.shareBalance),
+          0,
         ).toFixed(8),
+        totalMined: totalMined.toFixed(8),
+      },
+      poolAccounts: {
+        count: syncedPoolAccounts.length,
+        pools: syncedPoolAccounts.map((pool) => ({
+          poolType: pool.poolType,
+          name: pool.name,
+          balance: pool.balance.toString(),
+          targetBurn: pool.targetBurn?.toString(),
+          remainingBurn: pool.remainingBurn?.toString(),
+        })),
       },
       syncedContributions: {
         count: syncedContributions.length,
@@ -115,4 +289,243 @@ export class SystemAccountsService {
         : null,
     };
   }
+
+  /**
+   * 获取系统账户挖矿记录
+   * @param accountType 系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）
+   * @param regionCode 区域代码（省/市代码，如 440000, 440100）
+   * @param page 页码
+   * @param pageSize 每页数量
+   */
+  async getSystemAccountMiningRecords(
+    accountType: string,
+    regionCode: string | null,
+    page: number = 1,
+    pageSize: number = 20,
+  ) {
+    const miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+
+    try {
+      const params: Record<string, any> = { page, pageSize };
+      if (regionCode) {
+        params.regionCode = regionCode;
+      }
+
+      const response = await firstValueFrom(
+        this.httpService.get(
+          `${miningServiceUrl}/admin/system-accounts/${accountType}/records`,
+          { params },
+        ),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch system account mining records: ${error.message}`,
+      );
+      return { records: [], total: 0, page, pageSize, accountType, regionCode };
+    }
+  }
+
+  /**
+   * 获取系统账户交易记录
+   * @param accountType 系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）
+   * @param regionCode 区域代码（省/市代码，如 440000, 440100）
+   * @param page 页码
+   * @param pageSize 每页数量
+   */
+  async getSystemAccountTransactions(
+    accountType: string,
+    regionCode: string | null,
+    page: number = 1,
+    pageSize: number = 20,
+  ) {
+    const miningServiceUrl = this.configService.get<string>(
+      'MINING_SERVICE_URL',
+      'http://localhost:3021',
+    );
+
+    try {
+      const params: Record<string, any> = { page, pageSize };
+      if (regionCode) {
+        params.regionCode = regionCode;
+      }
+
+      const response = await firstValueFrom(
+        this.httpService.get(
+          `${miningServiceUrl}/admin/system-accounts/${accountType}/transactions`,
+          { params },
+        ),
+      );
+
+      return response.data;
+    } catch (error) {
+      this.logger.warn(
+        `Failed to fetch system account transactions: ${error.message}`,
+      );
+      return { transactions: [], total: 0, page, pageSize, accountType, regionCode };
+    }
+  }
+
+  /**
+   * 获取系统账户算力来源明细
+   * 显示该账户的每笔算力来自哪个认种订单
+   *
+   * @param accountType 系统账户类型（OPERATION/PROVINCE/CITY/HEADQUARTERS）
+   * @param regionCode 区域代码（省/市代码，如 440000, 440100）
+   * @param page 页码
+   * @param pageSize 每页数量
+   */
+  async getSystemAccountContributionRecords(
+    accountType: string,
+    regionCode: string | null,
+    page: number = 1,
+    pageSize: number = 20,
+  ) {
+    // Prisma 查询 null 值需要用 { equals: null }
+    const whereClause = regionCode
+      ? { accountType, regionCode }
+      : { accountType, regionCode: { equals: null } };
+
+    const [records, total] = await Promise.all([
+      this.prisma.syncedSystemContributionRecord.findMany({
+        where: whereClause,
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+        orderBy: { createdAt: 'desc' },
+      }),
+      this.prisma.syncedSystemContributionRecord.count({
+        where: whereClause,
+      }),
+    ]);
+
+    // 获取关联的认种订单和用户信息
+    const adoptionIds = [...new Set(records.map(r => r.sourceAdoptionId))];
+    const accountSequences = [...new Set(records.map(r => r.sourceAccountSequence))];
+
+    const [adoptions, users] = await Promise.all([
+      this.prisma.syncedAdoption.findMany({
+        where: { originalAdoptionId: { in: adoptionIds } },
+        select: {
+          originalAdoptionId: true,
+          accountSequence: true,
+          treeCount: true,
+          adoptionDate: true,
+          status: true,
+          contributionPerTree: true,
+        },
+      }),
+      this.prisma.syncedUser.findMany({
+        where: { accountSequence: { in: accountSequences } },
+        select: {
+          accountSequence: true,
+          phone: true,
+          realName: true,
+          nickname: true,
+        },
+      }),
+    ]);
+
+    // 构建映射
+    const adoptionMap = new Map(adoptions.map(a => [a.originalAdoptionId.toString(), a]));
+    const userMap = new Map(users.map(u => [u.accountSequence, u]));
+
+    return {
+      records: records.map((record) => {
+        const adoption = adoptionMap.get(record.sourceAdoptionId.toString());
+        const user = userMap.get(record.sourceAccountSequence);
+
+        return {
+          originalRecordId: record.originalRecordId.toString(),
+          accountType: record.accountType,
+          regionCode: record.regionCode,
+          sourceAdoptionId: record.sourceAdoptionId.toString(),
+          sourceAccountSequence: record.sourceAccountSequence,
+          // 来源类型
+          sourceType: record.sourceType,
+          levelDepth: record.levelDepth,
+          // 认种订单详情
+          adoptionTreeCount: adoption?.treeCount || 0,
+          adoptionDate: adoption?.adoptionDate || null,
+          adoptionStatus: adoption?.status || null,
+          contributionPerTree: adoption?.contributionPerTree?.toString() || '0',
+          // 用户信息
+          sourceUserPhone: user?.phone ? this.maskPhone(user.phone) : null,
+          sourceUserName: user?.realName || user?.nickname || null,
+          // 分配信息
+          distributionRate: record.distributionRate.toString(),
+          amount: record.amount.toString(),
+          effectiveDate: record.effectiveDate,
+          expireDate: record.expireDate,
+          isExpired: record.isExpired,
+          createdAt: record.createdAt,
+          syncedAt: record.syncedAt,
+        };
+      }),
+      total,
+      page,
+      pageSize,
+      totalPages: Math.ceil(total / pageSize),
+    };
+  }
+
+  /**
+   * 手机号脱敏
+   */
+  private maskPhone(phone: string): string {
+    if (!phone || phone.length < 7) return phone;
+    return phone.substring(0, 3) + '****' + phone.substring(phone.length - 4);
+  }
+
+  /**
+   * 获取系统账户算力明细统计
+   * 用于显示算力来源的汇总信息
+   */
+  async getSystemAccountContributionStats(accountType: string, regionCode: string | null) {
+    // 获取算力账户信息
+    // 使用 findFirst 替代 findUnique，因为 regionCode 可以为 null
+    const contribution = await this.prisma.syncedSystemContribution.findFirst({
+      where: {
+        accountType,
+        regionCode: regionCode === null ? { equals: null } : regionCode,
+      },
+    });
+
+    const whereClause = regionCode
+      ? { accountType, regionCode }
+      : { accountType, regionCode: { equals: null } };
+
+    // 获取明细记录统计
+    const recordStats = await this.prisma.syncedSystemContributionRecord.aggregate({
+      where: whereClause,
+      _count: true,
+      _sum: { amount: true },
+    });
+
+    // 获取来源认种订单数量（去重）
+    const uniqueAdoptions = await this.prisma.syncedSystemContributionRecord.groupBy({
+      by: ['sourceAdoptionId'],
+      where: whereClause,
+    });
+
+    // 获取来源用户数量（去重）
+    const uniqueUsers = await this.prisma.syncedSystemContributionRecord.groupBy({
+      by: ['sourceAccountSequence'],
+      where: whereClause,
+    });
+
+    return {
+      accountType,
+      regionCode,
+      name: contribution?.name || accountType,
+      totalContribution: contribution?.contributionBalance?.toString() || '0',
+      recordCount: recordStats._count,
+      sumFromRecords: recordStats._sum?.amount?.toString() || '0',
+      uniqueAdoptionCount: uniqueAdoptions.length,
+      uniqueUserCount: uniqueUsers.length,
+    };
+  }
 }

backend/services/mining-admin-service/src/application/services/users.service.ts

@@ -1,4 +1,5 @@
-import { Injectable, NotFoundException } from '@nestjs/common';
+import { Injectable, NotFoundException, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
 import { PrismaService } from '../../infrastructure/persistence/prisma/prisma.service';
 import { Prisma } from '@prisma/client';
 
@@ -20,7 +21,15 @@ export interface GetOrdersQuery {
 
 @Injectable()
 export class UsersService {
-  constructor(private readonly prisma: PrismaService) {}
+  private readonly logger = new Logger(UsersService.name);
+  private readonly miningServiceUrl: string;
+
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly configService: ConfigService,
+  ) {
+    this.miningServiceUrl = this.configService.get<string>('MINING_SERVICE_URL', 'http://localhost:3021');
+  }
 
   /**
    * 获取用户列表
@@ -103,32 +112,38 @@ export class UsersService {
    */
   private async getAdoptionStatsForUsers(
     accountSequences: string[],
-  ): Promise<Map<string, { personalCount: number; teamCount: number }>> {
+  ): Promise<Map<string, { personalCount: number; personalOrders: number; teamCount: number; teamOrders: number }>> {
     const result = new Map<
       string,
-      { personalCount: number; teamCount: number }
+      { personalCount: number; personalOrders: number; teamCount: number; teamOrders: number }
     >();
 
     if (accountSequences.length === 0) return result;
 
-    // 获取每个用户的个人认种数量
+    // 获取每个用户的个人认种数量和订单数（只统计 MINING_ENABLED 状态）
     const personalAdoptions = await this.prisma.syncedAdoption.groupBy({
       by: ['accountSequence'],
-      where: { accountSequence: { in: accountSequences } },
+      where: {
+        accountSequence: { in: accountSequences },
+        status: 'MINING_ENABLED',
+      },
       _sum: { treeCount: true },
+      _count: { id: true },
     });
 
     for (const stat of personalAdoptions) {
       result.set(stat.accountSequence, {
         personalCount: stat._sum.treeCount || 0,
+        personalOrders: stat._count.id || 0,
         teamCount: 0,
+        teamOrders: 0,
       });
     }
 
     // 确保所有用户都有记录
     for (const seq of accountSequences) {
       if (!result.has(seq)) {
-        result.set(seq, { personalCount: 0, teamCount: 0 });
+        result.set(seq, { personalCount: 0, personalOrders: 0, teamCount: 0, teamOrders: 0 });
       }
     }
 
@@ -153,12 +168,15 @@ export class UsersService {
         const teamAdoptionStats = await this.prisma.syncedAdoption.aggregate({
           where: {
             accountSequence: { in: teamMembers.map((m) => m.accountSequence) },
+            status: 'MINING_ENABLED',
           },
           _sum: { treeCount: true },
+          _count: { id: true },
         });
         const stats = result.get(ref.accountSequence);
         if (stats) {
           stats.teamCount = teamAdoptionStats._sum.treeCount || 0;
+          stats.teamOrders = teamAdoptionStats._count.id || 0;
         }
       }
     }
@@ -212,9 +230,9 @@ export class UsersService {
       throw new NotFoundException(`用户 ${accountSequence} 不存在`);
     }
 
-    // 获取个人认种数量（从 synced_adoptions 统计）
+    // 获取个人认种数量（从 synced_adoptions 统计，只统计 MINING_ENABLED 状态）
     const personalAdoptionStats = await this.prisma.syncedAdoption.aggregate({
-      where: { accountSequence },
+      where: { accountSequence, status: 'MINING_ENABLED' },
       _sum: { treeCount: true },
       _count: { id: true },
     });
@@ -226,7 +244,7 @@ export class UsersService {
     });
     const directReferralCount = directReferrals.length;
 
-    // 获取直推认种数量
+    // 获取直推认种数量（只统计 MINING_ENABLED 状态）
     let directReferralAdoptions = 0;
     if (directReferrals.length > 0) {
       const directAdoptionStats = await this.prisma.syncedAdoption.aggregate({
@@ -234,6 +252,7 @@ export class UsersService {
           accountSequence: {
             in: directReferrals.map((r) => r.accountSequence),
           },
+          status: 'MINING_ENABLED',
         },
         _sum: { treeCount: true },
       });
@@ -267,6 +286,7 @@ export class UsersService {
             accountSequence: {
               in: teamMembers.map((m) => m.accountSequence),
             },
+            status: 'MINING_ENABLED',
           },
           _sum: { treeCount: true },
         });
@@ -412,8 +432,7 @@ export class UsersService {
   }
 
   /**
-   * 获取用户挖矿记录（从同步表获取概要）
+   * 获取用户挖矿记录（从 mining-service 获取）
-   * 注：详细流水需要调用 mining-service
    */
   async getUserMiningRecords(
     accountSequence: string,
@@ -430,33 +449,79 @@ export class UsersService {
     }
 
     const mining = user.miningAccount;
-    if (!mining) {
+    const emptySummary = {
+      accountSequence,
+      totalMined: '0',
+      availableBalance: '0',
+      frozenBalance: '0',
+      totalContribution: '0',
+    };
+
+    // 从 mining-service 获取挖矿记录
+    try {
+      const url = `${this.miningServiceUrl}/api/v2/mining/accounts/${accountSequence}/records?page=${page}&pageSize=${pageSize}`;
+      this.logger.log(`Fetching mining records from ${url}`);
+
+      const response = await fetch(url);
+      if (!response.ok) {
+        this.logger.warn(`Failed to fetch mining records: ${response.status}`);
+        return {
+          summary: mining ? {
+            accountSequence,
+            totalMined: mining.totalMined.toString(),
+            availableBalance: mining.availableBalance.toString(),
+            frozenBalance: mining.frozenBalance.toString(),
+            totalContribution: mining.totalContribution.toString(),
+          } : emptySummary,
+          records: [],
+          pagination: { page, pageSize, total: 0, totalPages: 0 },
+        };
+      }
+
+      const result = await response.json();
+      const recordsData = result.data || result;
+
+      // 格式化记录以匹配前端期望的格式
+      const records = (recordsData.data || []).map((r: any) => ({
+        id: r.id,
+        accountSequence,
+        distributionMinute: r.miningMinute,
+        contributionRatio: r.contributionRatio,
+        shareAmount: r.minedAmount,
+        priceSnapshot: r.secondDistribution,
+        createdAt: r.createdAt,
+      }));
+
       return {
-        summary: {
+        summary: mining ? {
           accountSequence,
-          totalMined: '0',
+          totalMined: mining.totalMined.toString(),
-          availableBalance: '0',
+          availableBalance: mining.availableBalance.toString(),
-          frozenBalance: '0',
+          frozenBalance: mining.frozenBalance.toString(),
-          totalContribution: '0',
+          totalContribution: mining.totalContribution.toString(),
+        } : emptySummary,
+        records,
+        pagination: {
+          page,
+          pageSize,
+          total: recordsData.total || 0,
+          totalPages: Math.ceil((recordsData.total || 0) / pageSize),
         },
+      };
+    } catch (error) {
+      this.logger.error('Failed to fetch mining records from mining-service', error);
+      return {
+        summary: mining ? {
+          accountSequence,
+          totalMined: mining.totalMined.toString(),
+          availableBalance: mining.availableBalance.toString(),
+          frozenBalance: mining.frozenBalance.toString(),
+          totalContribution: mining.totalContribution.toString(),
+        } : emptySummary,
         records: [],
         pagination: { page, pageSize, total: 0, totalPages: 0 },
       };
     }
-
-    return {
-      summary: {
-        accountSequence,
-        totalMined: mining.totalMined.toString(),
-        availableBalance: mining.availableBalance.toString(),
-        frozenBalance: mining.frozenBalance.toString(),
-        totalContribution: mining.totalContribution.toString(),
-      },
-      // 详细流水需要从 mining-service 获取
-      records: [],
-      pagination: { page, pageSize, total: 0, totalPages: 0 },
-      note: '详细挖矿记录请查看 mining-service',
-    };
   }
 
   /**
@@ -568,14 +633,14 @@ export class UsersService {
   }
 
   /**
-   * 获取用户认种统计
+   * 获取用户认种统计（只统计 MINING_ENABLED 状态）
    */
   private async getUserAdoptionStats(
     accountSequence: string,
   ): Promise<{ personal: number; team: number }> {
-    // 个人认种
+    // 个人认种（只统计 MINING_ENABLED 状态）
     const personalStats = await this.prisma.syncedAdoption.aggregate({
-      where: { accountSequence },
+      where: { accountSequence, status: 'MINING_ENABLED' },
       _sum: { treeCount: true },
     });
 
@@ -587,7 +652,7 @@ export class UsersService {
 
     let teamCount = 0;
     if (referral?.originalUserId) {
-      // 团队认种 = 所有下级的认种总和
+      // 团队认种 = 所有下级的认种总和（只统计 MINING_ENABLED 状态）
       const teamMembers = await this.prisma.syncedReferral.findMany({
         where: {
           ancestorPath: { contains: referral.originalUserId.toString() },
@@ -599,6 +664,7 @@ export class UsersService {
         const teamStats = await this.prisma.syncedAdoption.aggregate({
           where: {
             accountSequence: { in: teamMembers.map((m) => m.accountSequence) },
+            status: 'MINING_ENABLED',
           },
           _sum: { treeCount: true },
         });
@@ -840,7 +906,7 @@ export class UsersService {
 
   /**
    * 获取用户钱包流水
-   * TODO: 从 mining-service 同步钱包流水数据
+   * 从 SyncedUserWallet 获取钱包汇总，从 SyncedMiningAccount 获取挖矿余额
    */
   async getWalletLedger(accountSequence: string, page: number, pageSize: number) {
     const user = await this.prisma.syncedUser.findUnique({
@@ -852,20 +918,44 @@ export class UsersService {
       throw new NotFoundException(`用户 ${accountSequence} 不存在`);
     }
 
+    // 获取用户的各类钱包数据
+    const wallets = await this.prisma.syncedUserWallet.findMany({
+      where: { accountSequence },
+    });
+
+    // 按钱包类型分类
+    const walletByType = new Map(wallets.map(w => [w.walletType, w]));
+    const greenPointsWallet = walletByType.get('GREEN_POINTS');
+    const contributionWallet = walletByType.get('CONTRIBUTION');
+    const tokenWallet = walletByType.get('TOKEN_STORAGE');
+
     const mining = user.miningAccount;
 
+    // 构建前端期望的钱包汇总格式
+    // usdtAvailable = GREEN_POINTS 钱包的可用余额 (绿积分)
+    // usdtFrozen = GREEN_POINTS 钱包的冻结余额
+    // pendingUsdt = 待领取收益（挖矿余额）
+    // settleableUsdt = 可结算收益
+    // settledTotalUsdt = 已结算收益
+    // expiredTotalUsdt = 过期收益
+    const summary = {
+      usdtAvailable: greenPointsWallet?.balance?.toString() || '0',
+      usdtFrozen: greenPointsWallet?.frozenBalance?.toString() || '0',
+      pendingUsdt: mining?.availableBalance?.toString() || '0',  // 挖矿可用余额作为待领取
+      settleableUsdt: '0',  // 暂无数据源
+      settledTotalUsdt: greenPointsWallet?.totalInflow?.toString() || '0',  // 总流入作为已结算
+      expiredTotalUsdt: '0',  // 暂无数据源
+    };
+
+    // TODO: 实现钱包流水分页查询
+    // 目前从 SyncedUserWallet 只能获取汇总数据，流水明细需要额外的表
     return {
-      summary: {
+      summary,
-        availableBalance: mining?.availableBalance?.toString() || '0',
-        frozenBalance: mining?.frozenBalance?.toString() || '0',
-        totalMined: mining?.totalMined?.toString() || '0',
-      },
       items: [],
       total: 0,
       page,
       pageSize,
       totalPages: 0,
-      note: '钱包流水数据需要从 mining-service 同步',
     };
   }
 
@@ -876,7 +966,7 @@ export class UsersService {
   private formatUserListItem(
     user: any,
     extra?: {
-      adoptionStats?: { personalCount: number; teamCount: number };
+      adoptionStats?: { personalCount: number; personalOrders: number; teamCount: number; teamOrders: number };
       referrerInfo?: { nickname: string | null; phone: string } | null;
     },
   ) {
@@ -892,7 +982,9 @@ export class UsersService {
       // 认种统计
       adoption: {
         personalAdoptionCount: extra?.adoptionStats?.personalCount || 0,
+        personalAdoptionOrders: extra?.adoptionStats?.personalOrders || 0,
         teamAdoptions: extra?.adoptionStats?.teamCount || 0,
+        teamAdoptionOrders: extra?.adoptionStats?.teamOrders || 0,
       },
       // 推荐人信息
       referral: user.referral

backend/services/mining-admin-service/src/infrastructure/infrastructure.module.ts

@@ -1,12 +1,20 @@
 import { Module, Global } from '@nestjs/common';
 import { ConfigModule, ConfigService } from '@nestjs/config';
+import { HttpModule } from '@nestjs/axios';
 import { PrismaModule } from './persistence/prisma/prisma.module';
 import { RedisService } from './redis/redis.service';
 import { KafkaModule } from './kafka/kafka.module';
 
 @Global()
 @Module({
-  imports: [PrismaModule, KafkaModule],
+  imports: [
+    PrismaModule,
+    KafkaModule,
+    HttpModule.register({
+      timeout: 10000,
+      maxRedirects: 5,
+    }),
+  ],
   providers: [
     {
       provide: 'REDIS_OPTIONS',
@@ -20,6 +28,6 @@ import { KafkaModule } from './kafka/kafka.module';
     },
     RedisService,
   ],
-  exports: [PrismaModule, RedisService, KafkaModule],
+  exports: [PrismaModule, RedisService, KafkaModule, HttpModule],
 })
 export class InfrastructureModule {}

backend/services/mining-admin-service/src/infrastructure/kafka/cdc-consumer.service.ts

@@ -317,9 +317,17 @@ export class CdcConsumerService implements OnModuleInit, OnModuleDestroy {
    * 将 Debezium outbox 的下划线格式转换为驼峰格式
    */
   private normalizeServiceEvent(data: any): Omit<ServiceEvent, 'sequenceNum' | 'sourceTopic'> {
-    // 如果已经是驼峰格式，直接返回
+    // 如果已经是驼峰格式（mining-wallet-service 直接发布的事件）
+    // 注意：mining-wallet-service 使用 eventId 而不是 id
     if (data.eventType && data.aggregateType) {
-      return data;
+      return {
+        id: data.id ?? data.eventId,
+        eventType: data.eventType,
+        aggregateType: data.aggregateType,
+        aggregateId: data.aggregateId,
+        payload: data.payload,
+        createdAt: data.createdAt,
+      };
     }
 
     // Debezium outbox 格式转换

backend/services/mining-admin-service/src/infrastructure/kafka/cdc-sync.service.ts

@@ -158,6 +158,16 @@ export class CdcSyncService implements OnModuleInit {
       'SystemContributionUpdated',
       this.withIdempotency(this.handleSystemContributionUpdated.bind(this)),
     );
+    // SystemAccountSynced 事件 - 同步系统账户算力（来自 contribution-service）
+    this.cdcConsumer.registerServiceHandler(
+      'SystemAccountSynced',
+      this.withIdempotency(this.handleSystemAccountSynced.bind(this)),
+    );
+    // SystemContributionRecordCreated 事件 - 同步系统账户算力明细（来自 contribution-service）
+    this.cdcConsumer.registerServiceHandler(
+      'SystemContributionRecordCreated',
+      this.withIdempotency(this.handleSystemContributionRecordCreated.bind(this)),
+    );
     // ReferralSynced 事件 - 同步推荐关系
     this.cdcConsumer.registerServiceHandler(
       'ReferralSynced',
@@ -353,6 +363,12 @@ export class CdcSyncService implements OnModuleInit {
       this.withIdempotency(this.walletHandlers.handleFeeConfigUpdated.bind(this.walletHandlers)),
     );
 
+    // CONTRIBUTION_CREDITED 事件 - 贡献值入账时更新用户钱包
+    this.cdcConsumer.registerServiceHandler(
+      'CONTRIBUTION_CREDITED',
+      this.withIdempotency(this.handleContributionCredited.bind(this)),
+    );
+
     this.logger.log('CDC sync handlers registered with idempotency protection');
   }
 
@@ -524,20 +540,165 @@ export class CdcSyncService implements OnModuleInit {
 
   private async handleSystemContributionUpdated(event: ServiceEvent, tx: TransactionClient): Promise<void> {
     const { payload } = event;
-    await tx.syncedSystemContribution.upsert({
+    const accountType = payload.accountType;
-      where: { accountType: payload.accountType },
+    const regionCode = payload.regionCode || null;
+
+    // 查找所有匹配的记录（处理可能存在的重复记录情况）
+    // 注意：由于 PostgreSQL 中 NULL != NULL，唯一约束在 regionCode 为 NULL 时不生效
+    const existingRecords = await tx.syncedSystemContribution.findMany({
+      where: {
+        accountType,
+        regionCode: regionCode === null ? { equals: null } : regionCode,
+      },
+      orderBy: { syncedAt: 'asc' },
+    });
+
+    if (existingRecords.length > 0) {
+      await tx.syncedSystemContribution.update({
+        where: { id: existingRecords[0].id },
+        data: {
+          name: payload.name,
+          contributionBalance: payload.contributionBalance,
+          contributionNeverExpires: payload.contributionNeverExpires,
+        },
+      });
+
+      // 删除重复记录
+      if (existingRecords.length > 1) {
+        const duplicateIds = existingRecords.slice(1).map(r => r.id);
+        await tx.syncedSystemContribution.deleteMany({
+          where: { id: { in: duplicateIds } },
+        });
+        this.logger.warn(
+          `Deleted ${duplicateIds.length} duplicate system contribution records for ${accountType}:${regionCode}`,
+        );
+      }
+    } else {
+      await tx.syncedSystemContribution.create({
+        data: {
+          accountType,
+          regionCode,
+          name: payload.name,
+          contributionBalance: payload.contributionBalance || 0,
+          contributionNeverExpires: payload.contributionNeverExpires || false,
+        },
+      });
+    }
+  }
+
+  /**
+   * 处理 SystemAccountSynced 事件 - 同步系统账户算力
+   * 来自 contribution-service 的系统账户（运营、省、市、总部）算力同步
+   * accountType: OPERATION / PROVINCE / CITY / HEADQUARTERS
+   * regionCode: 省/市代码，如 440000, 440100
+   *
+   * 注意：由于 PostgreSQL 中 NULL != NULL，@@unique([accountType, regionCode]) 约束
+   * 在 regionCode 为 NULL 时不会阻止重复插入。因此需要在代码层面确保唯一性。
+   */
+  private async handleSystemAccountSynced(event: ServiceEvent, tx: TransactionClient): Promise<void> {
+    const { payload } = event;
+    const accountType = payload.accountType; // OPERATION / PROVINCE / CITY / HEADQUARTERS
+    const regionCode = payload.regionCode || null;
+
+    // 查找所有匹配的记录（处理可能存在的重复记录情况）
+    const existingRecords = await tx.syncedSystemContribution.findMany({
+      where: {
+        accountType,
+        regionCode: regionCode === null ? { equals: null } : regionCode,
+      },
+      orderBy: { syncedAt: 'asc' }, // 保留最早创建的记录
+    });
+
+    if (existingRecords.length > 0) {
+      // 更新第一条记录
+      await tx.syncedSystemContribution.update({
+        where: { id: existingRecords[0].id },
+        data: {
+          name: payload.name,
+          contributionBalance: payload.contributionBalance,
+        },
+      });
+
+      // 如果存在重复记录，删除多余的（只保留第一条）
+      if (existingRecords.length > 1) {
+        const duplicateIds = existingRecords.slice(1).map(r => r.id);
+        await tx.syncedSystemContribution.deleteMany({
+          where: { id: { in: duplicateIds } },
+        });
+        this.logger.warn(
+          `Deleted ${duplicateIds.length} duplicate system contribution records for ${accountType}:${regionCode}`,
+        );
+      }
+    } else {
+      await tx.syncedSystemContribution.create({
+        data: {
+          accountType,
+          regionCode,
+          name: payload.name,
+          contributionBalance: payload.contributionBalance || 0,
+          contributionNeverExpires: true, // 系统账户算力永不过期
+        },
+      });
+    }
+  }
+
+  /**
+   * 处理 SystemContributionRecordCreated 事件 - 同步系统账户算力明细
+   * 来自 contribution-service，记录每笔算力的来源信息
+   */
+  private async handleSystemContributionRecordCreated(event: ServiceEvent, tx: TransactionClient): Promise<void> {
+    const { payload } = event;
+
+    // contribution-service 使用 systemAccountType 字段，需要兼容处理
+    const systemAccountType = payload.systemAccountType || payload.accountType;
+
+    // 解析 systemAccountType：可能是 "PROVINCE_440000" 或 "PROVINCE"
+    let accountType: string;
+    let regionCode: string | null = null;
+
+    if (systemAccountType?.includes('_')) {
+      const parts = systemAccountType.split('_');
+      accountType = parts[0];
+      regionCode = parts.slice(1).join('_');
+    } else {
+      accountType = systemAccountType;
+      regionCode = payload.regionCode || null;
+    }
+
+    await tx.syncedSystemContributionRecord.upsert({
+      where: { originalRecordId: BigInt(payload.recordId) },
       create: {
-        accountType: payload.accountType,
+        originalRecordId: BigInt(payload.recordId),
-        name: payload.name,
+        accountType,
-        contributionBalance: payload.contributionBalance || 0,
+        regionCode,
-        contributionNeverExpires: payload.contributionNeverExpires || false,
+        sourceAdoptionId: BigInt(payload.sourceAdoptionId),
+        sourceAccountSequence: payload.sourceAccountSequence,
+        sourceType: payload.sourceType || 'FIXED_RATE',  // 来源类型
+        levelDepth: payload.levelDepth ?? null,          // 层级深度
+        distributionRate: payload.distributionRate,
+        amount: payload.amount,
+        effectiveDate: new Date(payload.effectiveDate),
+        expireDate: payload.expireDate ? new Date(payload.expireDate) : null,
+        isExpired: false,
+        createdAt: new Date(payload.createdAt),
       },
       update: {
-        name: payload.name,
+        accountType,
-        contributionBalance: payload.contributionBalance,
+        regionCode,
-        contributionNeverExpires: payload.contributionNeverExpires,
+        sourceAdoptionId: BigInt(payload.sourceAdoptionId),
+        sourceAccountSequence: payload.sourceAccountSequence,
+        sourceType: payload.sourceType || 'FIXED_RATE',
+        levelDepth: payload.levelDepth ?? null,
+        distributionRate: payload.distributionRate,
+        amount: payload.amount,
+        effectiveDate: new Date(payload.effectiveDate),
+        expireDate: payload.expireDate ? new Date(payload.expireDate) : null,
       },
     });
+
+    this.logger.debug(
+      `Synced system contribution record: recordId=${payload.recordId}, account=${accountType}:${regionCode}, amount=${payload.amount}`,
+    );
   }
 
   /**
@@ -696,6 +857,9 @@ export class CdcSyncService implements OnModuleInit {
     const { payload } = event;
     // 只保留一条挖矿配置记录
     await tx.syncedMiningConfig.deleteMany({});
+    // mining-service 发布 secondDistribution，计算 minuteDistribution = secondDistribution * 60
+    const secondDistribution = parseFloat(payload.secondDistribution || '0');
+    const minuteDistribution = payload.minuteDistribution || (secondDistribution * 60).toString();
     await tx.syncedMiningConfig.create({
       data: {
         totalShares: payload.totalShares,
@@ -703,7 +867,7 @@ export class CdcSyncService implements OnModuleInit {
         remainingDistribution: payload.remainingDistribution,
         halvingPeriodYears: payload.halvingPeriodYears,
         currentEra: payload.currentEra || 1,
-        minuteDistribution: payload.minuteDistribution,
+        minuteDistribution: minuteDistribution,
         isActive: payload.isActive || false,
         activatedAt: payload.activatedAt ? new Date(payload.activatedAt) : null,
       },
@@ -813,4 +977,60 @@ export class CdcSyncService implements OnModuleInit {
     this.logger.debug('Synced circulation pool');
   }
 
+  // ===========================================================================
+  // 钱包事件处理 (mining-wallet-service)
+  // ===========================================================================
+
+  /**
+   * 处理 CONTRIBUTION_CREDITED 事件
+   * mining-wallet-service 在为用户入账贡献值时发布
+   * payload: { accountSequence, walletType, amount, balanceAfter, transactionId, ... }
+   */
+  private async handleContributionCredited(event: ServiceEvent, tx: TransactionClient): Promise<void> {
+    const { payload } = event;
+    const walletType = payload.walletType || 'CONTRIBUTION';
+
+    // 先查找是否已存在
+    const existing = await tx.syncedUserWallet.findUnique({
+      where: {
+        accountSequence_walletType: {
+          accountSequence: payload.accountSequence,
+          walletType,
+        },
+      },
+    });
+
+    if (existing) {
+      // 更新余额（使用最新的 balanceAfter）
+      await tx.syncedUserWallet.update({
+        where: { id: existing.id },
+        data: {
+          balance: payload.balanceAfter,
+          totalInflow: {
+            increment: parseFloat(payload.amount) || 0,
+          },
+        },
+      });
+    } else {
+      // 创建新钱包记录
+      // originalId 使用 accountSequence + walletType 的组合生成一个稳定的 ID
+      const originalId = `wallet-${payload.accountSequence}-${walletType}`;
+
+      await tx.syncedUserWallet.create({
+        data: {
+          originalId,
+          accountSequence: payload.accountSequence,
+          walletType,
+          balance: payload.balanceAfter || 0,
+          frozenBalance: 0,
+          totalInflow: parseFloat(payload.amount) || 0,
+          totalOutflow: 0,
+          isActive: true,
+        },
+      });
+    }
+
+    this.logger.debug(`Synced user wallet from CONTRIBUTION_CREDITED: ${payload.accountSequence}, balance: ${payload.balanceAfter}`);
+  }
+
 }

backend/services/mining-service/.env.example

@@ -21,8 +21,8 @@ KAFKA_GROUP_ID=mining-service-group
 JWT_SECRET=your-jwt-secret-key
 
 # Mining Configuration
-TOTAL_SHARES=100020000000
+TOTAL_SHARES=10002000000
-DISTRIBUTION_POOL=200000000
+DISTRIBUTION_POOL=2000000
 INITIAL_PRICE=1
 HALVING_PERIOD_YEARS=2
 BURN_TARGET=10000000000

backend/services/mining-service/Dockerfile

@@ -14,7 +14,7 @@ RUN npm ci
 RUN DATABASE_URL="postgresql://user:pass@localhost:5432/db" npx prisma generate
 
 COPY src ./src
-RUN npm run build
+RUN npm run build && ls -la dist/ && test -f dist/main.js && echo "Build successful: dist/main.js exists"
 
 # 阶段2: 生产运行
 FROM node:20-alpine AS runner
@@ -30,14 +30,16 @@ WORKDIR /app
 USER nestjs
 
 COPY --chown=nestjs:nodejs package*.json ./
-RUN npm ci --only=production && npm cache clean --force
+COPY --chown=nestjs:nodejs tsconfig*.json ./
+RUN npm ci --only=production && npm install ts-node typescript @types/node --save-dev && npm cache clean --force
 
 COPY --chown=nestjs:nodejs prisma ./prisma/
 RUN DATABASE_URL="postgresql://user:pass@localhost:5432/db" npx prisma generate
 
 COPY --chown=nestjs:nodejs --from=builder /app/dist ./dist
+RUN ls -la dist/ && test -f dist/main.js && echo "Copy successful: dist/main.js exists"
 
-RUN printf '#!/bin/sh\nset -e\necho "Running database migrations..."\nnpx prisma migrate deploy\necho "Starting application..."\nexec node dist/main.js\n' > /app/start.sh && chmod +x /app/start.sh
+RUN printf '#!/bin/sh\nset -e\necho "Running database migrations..."\nnpx prisma migrate deploy\necho "Running database seed..."\nnpx prisma db seed || echo "Seed skipped or already applied"\necho "Starting application..."\nexec node dist/main.js\n' > /app/start.sh && chmod +x /app/start.sh
 
 ENV NODE_ENV=production
 ENV TZ=Asia/Shanghai

backend/services/mining-service/package.json

@@ -16,7 +16,8 @@
     "prisma:generate": "prisma generate",
     "prisma:migrate": "prisma migrate dev",
     "prisma:migrate:prod": "prisma migrate deploy",
-    "prisma:studio": "prisma studio"
+    "prisma:studio": "prisma studio",
+    "prisma:seed": "ts-node prisma/seed.ts"
   },
   "dependencies": {
     "@nestjs/common": "^10.3.0",
@@ -37,6 +38,9 @@
     "rxjs": "^7.8.1",
     "swagger-ui-express": "^5.0.0"
   },
+  "prisma": {
+    "seed": "ts-node prisma/seed.ts"
+  },
   "devDependencies": {
     "@nestjs/cli": "^10.2.1",
     "@nestjs/schematics": "^10.0.3",

backend/services/mining-service/prisma/migrations/0001_init/migration.sql

@@ -1,6 +1,7 @@
 -- ============================================================================
 -- mining-service 初始化 migration
--- 合并自: 20260111000000_init (只有一个，无需合并)
+-- 合并自: 0001_init, 0002_minute_to_second, 0003_add_system_accounts_and_pending_mining,
+--         20250120000001_add_region_to_system_mining_accounts
 -- ============================================================================
 
 -- CreateEnum
@@ -21,7 +22,11 @@ CREATE TABLE "mining_configs" (
     "halvingPeriodYears" INTEGER NOT NULL DEFAULT 2,
     "currentEra" INTEGER NOT NULL DEFAULT 1,
     "eraStartDate" TIMESTAMP(3) NOT NULL,
-    "minuteDistribution" DECIMAL(30,18) NOT NULL,
+    "secondDistribution" DECIMAL(30,18) NOT NULL,
+    "network_total_contribution" DECIMAL(30, 8) NOT NULL DEFAULT 0,
+    "total_tree_count" INTEGER NOT NULL DEFAULT 0,
+    "contribution_per_tree" DECIMAL(20, 10) NOT NULL DEFAULT 22617,
+    "network_last_synced_at" TIMESTAMP(3),
     "isActive" BOOLEAN NOT NULL DEFAULT false,
     "activatedAt" TIMESTAMP(3),
     "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -38,7 +43,7 @@ CREATE TABLE "mining_eras" (
     "endDate" TIMESTAMP(3),
     "initialDistribution" DECIMAL(30,8) NOT NULL,
     "totalDistributed" DECIMAL(30,8) NOT NULL DEFAULT 0,
-    "minuteDistribution" DECIMAL(30,18) NOT NULL,
+    "secondDistribution" DECIMAL(30,18) NOT NULL,
     "isActive" BOOLEAN NOT NULL DEFAULT true,
     "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
 
@@ -67,7 +72,7 @@ CREATE TABLE "mining_records" (
     "miningMinute" TIMESTAMP(3) NOT NULL,
     "contributionRatio" DECIMAL(30,18) NOT NULL,
     "totalContribution" DECIMAL(30,8) NOT NULL,
-    "minuteDistribution" DECIMAL(30,18) NOT NULL,
+    "secondDistribution" DECIMAL(30,18) NOT NULL,
     "minedAmount" DECIMAL(30,18) NOT NULL,
     "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
 
@@ -94,6 +99,90 @@ CREATE TABLE "mining_transactions" (
     CONSTRAINT "mining_transactions_pkey" PRIMARY KEY ("id")
 );
 
+-- CreateTable: 系统挖矿账户
+CREATE TABLE "system_mining_accounts" (
+    "id" TEXT NOT NULL,
+    "account_type" TEXT NOT NULL,
+    "region_code" TEXT,
+    "name" TEXT NOT NULL,
+    "totalMined" DECIMAL(30, 8) NOT NULL DEFAULT 0,
+    "availableBalance" DECIMAL(30, 8) NOT NULL DEFAULT 0,
+    "totalContribution" DECIMAL(30, 8) NOT NULL DEFAULT 0,
+    "last_synced_at" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "system_mining_accounts_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable: 系统账户挖矿记录
+CREATE TABLE "system_mining_records" (
+    "id" TEXT NOT NULL,
+    "system_account_id" TEXT NOT NULL,
+    "mining_minute" TIMESTAMP(3) NOT NULL,
+    "contribution_ratio" DECIMAL(30, 18) NOT NULL,
+    "total_contribution" DECIMAL(30, 8) NOT NULL,
+    "second_distribution" DECIMAL(30, 18) NOT NULL,
+    "mined_amount" DECIMAL(30, 18) NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "system_mining_records_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable: 系统账户交易流水
+CREATE TABLE "system_mining_transactions" (
+    "id" TEXT NOT NULL,
+    "system_account_id" TEXT NOT NULL,
+    "type" TEXT NOT NULL,
+    "amount" DECIMAL(30, 8) NOT NULL,
+    "balance_before" DECIMAL(30, 8) NOT NULL,
+    "balance_after" DECIMAL(30, 8) NOT NULL,
+    "reference_id" TEXT,
+    "reference_type" TEXT,
+    "memo" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "system_mining_transactions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable: 待解锁算力挖矿
+CREATE TABLE "pending_contribution_mining" (
+    "id" BIGSERIAL NOT NULL,
+    "source_adoption_id" BIGINT NOT NULL,
+    "source_account_sequence" VARCHAR(20) NOT NULL,
+    "would_be_account_sequence" VARCHAR(20),
+    "contribution_type" VARCHAR(30) NOT NULL,
+    "amount" DECIMAL(30, 10) NOT NULL,
+    "reason" VARCHAR(200),
+    "effective_date" DATE NOT NULL,
+    "expire_date" DATE NOT NULL,
+    "is_expired" BOOLEAN NOT NULL DEFAULT false,
+    "last_synced_at" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "pending_contribution_mining_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable: 待解锁算力挖矿记录
+CREATE TABLE "pending_mining_records" (
+    "id" BIGSERIAL NOT NULL,
+    "pending_contribution_id" BIGINT NOT NULL,
+    "mining_minute" TIMESTAMP(3) NOT NULL,
+    "source_adoption_id" BIGINT NOT NULL,
+    "source_account_sequence" VARCHAR(20) NOT NULL,
+    "would_be_account_sequence" VARCHAR(20),
+    "contribution_type" VARCHAR(30) NOT NULL,
+    "contribution_amount" DECIMAL(30, 10) NOT NULL,
+    "network_total_contribution" DECIMAL(30, 10) NOT NULL,
+    "contribution_ratio" DECIMAL(30, 18) NOT NULL,
+    "second_distribution" DECIMAL(30, 18) NOT NULL,
+    "mined_amount" DECIMAL(30, 18) NOT NULL,
+    "allocated_to" VARCHAR(20) NOT NULL DEFAULT 'HEADQUARTERS',
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "pending_mining_records_pkey" PRIMARY KEY ("id")
+);
+
 -- CreateTable
 CREATE TABLE "mining_reward_allocations" (
     "id" BIGSERIAL NOT NULL,
@@ -316,6 +405,33 @@ CREATE INDEX "mining_transactions_counterparty_account_seq_idx" ON "mining_trans
 -- CreateIndex
 CREATE INDEX "mining_transactions_counterparty_user_id_idx" ON "mining_transactions"("counterparty_user_id");
 
+-- CreateIndex: system_mining_accounts
+CREATE UNIQUE INDEX "system_mining_accounts_account_type_region_code_key" ON "system_mining_accounts"("account_type", "region_code");
+CREATE INDEX "system_mining_accounts_totalContribution_idx" ON "system_mining_accounts"("totalContribution" DESC);
+CREATE INDEX "system_mining_accounts_account_type_idx" ON "system_mining_accounts"("account_type");
+CREATE INDEX "system_mining_accounts_region_code_idx" ON "system_mining_accounts"("region_code");
+
+-- CreateIndex: system_mining_records
+CREATE UNIQUE INDEX "system_mining_records_system_account_id_mining_minute_key" ON "system_mining_records"("system_account_id", "mining_minute");
+CREATE INDEX "system_mining_records_mining_minute_idx" ON "system_mining_records"("mining_minute");
+
+-- CreateIndex: system_mining_transactions
+CREATE INDEX "system_mining_transactions_system_account_id_created_at_idx" ON "system_mining_transactions"("system_account_id", "created_at" DESC);
+
+-- CreateIndex: pending_contribution_mining
+CREATE UNIQUE INDEX "pending_contribution_mining_source_adoption_id_would_be_acco_key"
+    ON "pending_contribution_mining"("source_adoption_id", "would_be_account_sequence", "contribution_type");
+CREATE INDEX "pending_contribution_mining_would_be_account_sequence_idx" ON "pending_contribution_mining"("would_be_account_sequence");
+CREATE INDEX "pending_contribution_mining_contribution_type_idx" ON "pending_contribution_mining"("contribution_type");
+CREATE INDEX "pending_contribution_mining_is_expired_idx" ON "pending_contribution_mining"("is_expired");
+
+-- CreateIndex: pending_mining_records
+CREATE UNIQUE INDEX "pending_mining_records_pending_contribution_id_mining_minute_key"
+    ON "pending_mining_records"("pending_contribution_id", "mining_minute");
+CREATE INDEX "pending_mining_records_mining_minute_idx" ON "pending_mining_records"("mining_minute");
+CREATE INDEX "pending_mining_records_source_account_sequence_idx" ON "pending_mining_records"("source_account_sequence");
+CREATE INDEX "pending_mining_records_would_be_account_sequence_idx" ON "pending_mining_records"("would_be_account_sequence");
+
 -- CreateIndex
 CREATE INDEX "mining_reward_allocations_mining_date_idx" ON "mining_reward_allocations"("mining_date");
 
@@ -415,8 +531,27 @@ ALTER TABLE "mining_records" ADD CONSTRAINT "mining_records_accountSequence_fkey
 -- AddForeignKey
 ALTER TABLE "mining_transactions" ADD CONSTRAINT "mining_transactions_accountSequence_fkey" FOREIGN KEY ("accountSequence") REFERENCES "mining_accounts"("accountSequence") ON DELETE RESTRICT ON UPDATE CASCADE;
 
+-- AddForeignKey: system_mining_records
+ALTER TABLE "system_mining_records" ADD CONSTRAINT "system_mining_records_system_account_id_fkey"
+    FOREIGN KEY ("system_account_id") REFERENCES "system_mining_accounts"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey: system_mining_transactions
+ALTER TABLE "system_mining_transactions" ADD CONSTRAINT "system_mining_transactions_system_account_id_fkey"
+    FOREIGN KEY ("system_account_id") REFERENCES "system_mining_accounts"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey: pending_mining_records
+ALTER TABLE "pending_mining_records" ADD CONSTRAINT "pending_mining_records_pending_contribution_id_fkey"
+    FOREIGN KEY ("pending_contribution_id") REFERENCES "pending_contribution_mining"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
 -- AddForeignKey
 ALTER TABLE "burn_records" ADD CONSTRAINT "burn_records_blackHoleId_fkey" FOREIGN KEY ("blackHoleId") REFERENCES "black_holes"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
 
 -- AddForeignKey
 ALTER TABLE "pool_transactions" ADD CONSTRAINT "pool_transactions_pool_account_id_fkey" FOREIGN KEY ("pool_account_id") REFERENCES "pool_accounts"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- 初始化系统账户 (无 regionCode 的汇总账户)
+INSERT INTO "system_mining_accounts" ("id", "account_type", "region_code", "name", "totalMined", "availableBalance", "totalContribution", "updated_at")
+VALUES
+    (gen_random_uuid(), 'OPERATION', NULL, '运营账户', 0, 0, 0, NOW()),
+    (gen_random_uuid(), 'HEADQUARTERS', NULL, '总部账户', 0, 0, 0, NOW())
+ON CONFLICT ("account_type", "region_code") DO NOTHING;

backend/services/mining-service/prisma/migrations/0002_add_batch_mining/migration.sql

@@ -0,0 +1,47 @@
+-- CreateTable: 批量补发执行记录（全局只允许执行一次）
+CREATE TABLE "batch_mining_executions" (
+    "id" TEXT NOT NULL,
+    "operator_id" TEXT NOT NULL,
+    "operator_name" TEXT NOT NULL,
+    "reason" TEXT NOT NULL,
+    "total_users" INTEGER NOT NULL,
+    "total_batches" INTEGER NOT NULL,
+    "success_count" INTEGER NOT NULL DEFAULT 0,
+    "failed_count" INTEGER NOT NULL DEFAULT 0,
+    "total_amount" DECIMAL(30,8) NOT NULL DEFAULT 0,
+    "executed_at" TIMESTAMP(3) NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "batch_mining_executions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable: 批量补发明细记录
+CREATE TABLE "batch_mining_records" (
+    "id" TEXT NOT NULL,
+    "execution_id" TEXT NOT NULL,
+    "account_sequence" TEXT NOT NULL,
+    "batch" INTEGER NOT NULL,
+    "tree_count" INTEGER NOT NULL,
+    "pre_mine_days" INTEGER NOT NULL,
+    "user_contribution" DECIMAL(30,10) NOT NULL,
+    "network_contribution" DECIMAL(30,10) NOT NULL,
+    "contribution_ratio" DECIMAL(30,18) NOT NULL,
+    "total_seconds" BIGINT NOT NULL,
+    "amount" DECIMAL(30,8) NOT NULL,
+    "remark" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "batch_mining_records_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "batch_mining_records_execution_id_account_sequence_key" ON "batch_mining_records"("execution_id", "account_sequence");
+
+-- CreateIndex
+CREATE INDEX "batch_mining_records_batch_idx" ON "batch_mining_records"("batch");
+
+-- CreateIndex
+CREATE INDEX "batch_mining_records_account_sequence_idx" ON "batch_mining_records"("account_sequence");
+
+-- AddForeignKey
+ALTER TABLE "batch_mining_records" ADD CONSTRAINT "batch_mining_records_execution_id_fkey" FOREIGN KEY ("execution_id") REFERENCES "batch_mining_executions"("id") ON DELETE RESTRICT ON UPDATE CASCADE;