add: some user api and all api desc

2026-02-27 19:17:01 +08:00
parent a0c720eb2f
commit 5930fb0dde
156 changed files with 9457 additions and 1086 deletions
@@ -0,0 +1,54 @@
+syntax = "v1"
+import "common.api"
+
+type (
+    Review {
+        Id           string  `json:"id"`
+        OrderId      string  `json:"orderId"`
+        FromUserId   string  `json:"fromUserId"`
+        FromUserName string  `json:"fromUserName"`
+        Rating       int     `json:"rating"`
+        Content      string  `json:"content"`
+        Sealed       bool    `json:"sealed"`
+        CreatedAt    string  `json:"createdAt"`
+    }
+
+    ReviewListResp {
+        Items []Review `json:"items"`
+        Meta  PageMeta `json:"meta"`
+    }
+
+    SubmitReviewReq {
+        Rating  int    `json:"rating"`
+        Content string `json:"content,optional"`
+    }
+)
+
+@server(
+    prefix: api/v1
+    group: review
+    jwt: Auth
+)
+service juwan-api {
+    @doc "提交评价"
+    @handler SubmitReview
+    post /orders/:id/review (SubmitReviewReq) returns (EmptyResp)
+
+    @doc "获取订单评价"
+    @handler GetOrderReviews
+    get /orders/:id/reviews (EmptyResp) returns ([]Review)
+}
+
+@server(
+    prefix: api/v1
+    group: review
+)
+service juwan-api {
+    @doc "获取公开评价列表"
+    @handler ListReviews
+    get /reviews (PageReq) returns (ReviewListResp)
+
+    @doc "获取用户收到的评价"
+    @handler ListUserReviews
+    get /users/:id/reviews (PageReq) returns (ReviewListResp)
+}