新增明细协议

proto-lib/proto_user.lua

@@ -1,6 +1,16 @@
 -- 用户相关协议 2000~2099
 
-local proto_struct = [[
+local proto_struct =
+    [[
+    # 明细
+    .DataItemDetail {
+        id 0: integer                       # 记录ID
+        createTime 1: integer               # 记录时间
+        reason 2: string                    # 来源 - 配置对应
+        itemId 3: integer                   # 物品ID
+        delta 4: integer                    # 变化值(有符号)
+        remainCount 5: integer              # 变化后剩余物品数量
+    }
 ]]
 
 local proto_c2s =
@@ -126,6 +136,39 @@ local proto_c2s =
             code 0: integer
         }
     }
+
+    # 明细技术路线
+    # 1. 分页拉去数据
+    # 2. 发起流水请求 user_item_detail_gold
+    # 3. 服务器异步通知 on_user_item_detail_gold 每次最多20条
+    #     当 count = 0 时，已没有更早记录
+    #     请前端标记，不再拉取更早记录
+    # 4. 每次进入页面 user_item_detail_gold 的 lastTime可为0或空
+    #     请求最新记录
+    #     当前返回记录id跟本地数据的id有重叠时，说明已刷完最先记录
+    #
+    # 5. 同理饰品明细
+    # 6. 请做好刷新间隔冷却处理
+    # 明细 - 流水
+    # 由 on_user_item_detail_gold 异步推送，避免卡死
+    user_item_detail_gold 2012 {
+        request {
+            lastTime 0: integer             # 上次拉记录 createTime 最小值
+        }
+        response {
+            code 0: integer
+        }
+    }
+    # 明细 - 饰品
+    # 由 on_user_item_detail_wapon 异步推送，避免卡死
+    user_item_detail_wapon 2013 {
+        request {
+            lastTime 0: integer             # 上次拉记录 createTime 最小值
+        }
+        response {
+            code 0: integer
+        }
+    }
 ]]
 
 local proto_s2c =
@@ -143,6 +186,21 @@ local proto_s2c =
             code 0: integer                 # 值为497时是被顶号了，不要自动连接
         }
     }
+
+    # 明细 - 流水
+    on_user_item_detail_gold 2002 {
+        request {
+            count 0: integer                # 记录数量 当返回0时，已没有更早记录
+            list 1: *DataItemDetail         # 明细列表
+        }
+    }
+    # 明细 - 饰品
+    on_user_item_detail_wapon 2003 {
+        request {
+            count 0: integer                # 记录数量 当返回0时，已没有更早记录
+            list 1: *DataItemDetail         # 明细列表
+        }
+    }
 ]]
 
 local proto = {