完善C端功能、通知明细及接口文档

internal/httpapi/api.go

@@ -38,6 +38,7 @@ func (a *API) Register(mux *http.ServeMux) {
 	mux.HandleFunc("/v1/member-levels", a.memberLevels)
 	mux.HandleFunc("/v1/leaderboard", a.leaderboard)
 	mux.HandleFunc("/v1/customer-services", a.customerServices)
+	mux.HandleFunc("/v1/notices", a.notices)
 	mux.HandleFunc("/v1/task-halls", a.taskHalls)
 	mux.HandleFunc("/v1/tasks/eligibility", a.taskEligibility)
 	mux.HandleFunc("/v1/tasks/stats", a.taskStats)
@@ -47,6 +48,7 @@ func (a *API) Register(mux *http.ServeMux) {
 	mux.HandleFunc("/v1/manual-products", a.manualProducts)
 	mux.HandleFunc("/v1/manual-products/", a.manualProduct)
 	mux.HandleFunc("/v1/payment-accounts", a.paymentAccounts)
+	mux.HandleFunc("/v1/wallet/ledgers", a.walletLedgers)
 	mux.HandleFunc("/v1/recharge/channels", a.rechargeChannels)
 	mux.HandleFunc("/v1/recharge-orders", a.rechargeOrders)
 	mux.HandleFunc("/v1/recharge-orders/", a.rechargeOrder)

internal/httpapi/finance.go

@@ -41,6 +41,34 @@ func (a *API) paymentAccounts(w http.ResponseWriter, r *http.Request) {
 	writeSuccess(w, r, result)
 }
 
+func (a *API) walletLedgers(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		methodNotAllowed(w, r, http.MethodGet)
+		return
+	}
+	principal, ok := a.authenticateFinanceMember(w, r)
+	if !ok {
+		return
+	}
+	page, ok := optionalPositiveInt(w, r, "page")
+	if !ok {
+		writeFinanceError(w, r, finance.ErrPageInvalid)
+		return
+	}
+	pageSize, ok := optionalPositiveInt(w, r, "page_size")
+	if !ok {
+		writeFinanceError(w, r, finance.ErrPageSizeInvalid)
+		return
+	}
+	result, err := a.finance.WalletLedgers(r.Context(), principal.TenantID, principal.MemberID,
+		page, pageSize, r.URL.Query().Get("biz_type"), r.URL.Query().Get("direction"))
+	if err != nil {
+		writeFinanceError(w, r, err)
+		return
+	}
+	writeSuccess(w, r, result)
+}
+
 func (a *API) withdrawalQuote(w http.ResponseWriter, r *http.Request) {
 	if r.Method != http.MethodPost {
 		methodNotAllowed(w, r, http.MethodPost)
@@ -256,6 +284,8 @@ func writeFinanceError(w http.ResponseWriter, r *http.Request, err error) {
 		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_INVALID", "validation failed", map[string]any{"field": "page"})
 	case errors.Is(err, finance.ErrPageSizeInvalid):
 		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_SIZE_INVALID", "validation failed", map[string]any{"field": "page_size"})
+	case errors.Is(err, finance.ErrLedgerFilterInvalid):
+		writeError(w, r, http.StatusBadRequest, 30000, "LEDGER_FILTER_INVALID", "validation failed", nil)
 	case errors.Is(err, finance.ErrStatusInvalid):
 		writeError(w, r, http.StatusBadRequest, 30000, "WITHDRAWAL_STATUS_INVALID", "validation failed", map[string]any{"field": "status"})
 	case errors.Is(err, finance.ErrRechargeStatusInvalid):

internal/httpapi/portal.go

@@ -157,6 +157,36 @@ func (a *API) customerServices(w http.ResponseWriter, r *http.Request) {
 	writeSuccess(w, r, items)
 }
 
+func (a *API) notices(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet {
+		methodNotAllowed(w, r, http.MethodGet)
+		return
+	}
+	if !a.ensurePortal(w, r) {
+		return
+	}
+	principal, ok := a.authenticateMember(w, r)
+	if !ok {
+		return
+	}
+	page, ok := optionalPositiveInt(w, r, "page")
+	if !ok {
+		writePortalError(w, r, portal.ErrPageInvalid)
+		return
+	}
+	pageSize, ok := optionalPositiveInt(w, r, "page_size")
+	if !ok {
+		writePortalError(w, r, portal.ErrPageSizeInvalid)
+		return
+	}
+	result, err := a.portal.Notices(r.Context(), principal.TenantID, principal.MemberID, page, pageSize)
+	if err != nil {
+		writePortalError(w, r, err)
+		return
+	}
+	writeSuccess(w, r, result)
+}
+
 func (a *API) ensurePortal(w http.ResponseWriter, r *http.Request) bool {
 	if a.portal != nil {
 		return true
@@ -171,6 +201,10 @@ func writePortalError(w http.ResponseWriter, r *http.Request, err error) {
 		writeError(w, r, http.StatusBadRequest, 30000, "BANNER_POSITION_INVALID", "validation failed", map[string]any{"field": "position"})
 	case errors.Is(err, portal.ErrContentKeyInvalid):
 		writeError(w, r, http.StatusBadRequest, 30000, "CONTENT_KEY_INVALID", "validation failed", map[string]any{"field": "content_key"})
+	case errors.Is(err, portal.ErrPageInvalid):
+		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_INVALID", "validation failed", map[string]any{"field": "page"})
+	case errors.Is(err, portal.ErrPageSizeInvalid):
+		writeError(w, r, http.StatusBadRequest, 30000, "PAGE_SIZE_INVALID", "validation failed", map[string]any{"field": "page_size"})
 	case errors.Is(err, store.ErrResourceNotFound):
 		writeError(w, r, http.StatusNotFound, 30044, "RESOURCE_NOT_FOUND", "resource not found", nil)
 	default: