Add agenda service and submit api

Signed-off-by: Asai Neko <sugar@sne.moe>
2026-02-06 18:32:46 +08:00
parent b2f216f1bd
commit c9e987e2ba
30 changed files with 1228 additions and 365 deletions
--- a/api/event/attendance.go
+++ b/api/event/attendance.go
@@ -15,12 +15,11 @@ import (
 //	@Description	Retrieves the list of attendees, including user info and decrypted KYC data for a specified event.
 //	@Tags			Event
 //	@Produce		json
-//	@Param			event_id		query		string															true	"Event UUID"
-//	@Param			X-Api-Version	header		string															true	"latest"
-//	@Success		200				{object}	utils.RespStatus{data=[]service_event.AttendanceListResponse}	"Successful retrieval"
-//	@Failure		400				{object}	utils.RespStatus{data=nil}										"Invalid Input"
-//	@Failure		401				{object}	utils.RespStatus{data=nil}										"Unauthorized"
-//	@Failure		500				{object}	utils.RespStatus{data=nil}										"Internal Server Error"
+//	@Param			event_id	query		string															true	"Event UUID"
+//	@Success		200			{object}	utils.RespStatus{data=[]service_event.AttendanceListResponse}	"Successful retrieval"
+//	@Failure		400			{object}	utils.RespStatus{data=nil}										"Invalid Input"
+//	@Failure		401			{object}	utils.RespStatus{data=nil}										"Unauthorized"
+//	@Failure		500			{object}	utils.RespStatus{data=nil}										"Internal Server Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/attendance [get]
 func (self *EventHandler) AttendanceList(c *gin.Context) {
--- a/api/event/checkin.go
+++ b/api/event/checkin.go
@@ -18,6 +18,7 @@ import (
 //	@Produce		json
 //	@Param			event_id		query		string													true	"Event UUID"
 //	@Param			X-Api-Version	header		string													true	"latest"
+//	@Param			Authorization	header		string													true	"Bearer token"
 //	@Success		200				{object}	utils.RespStatus{data=service_event.CheckinResponse}	"Successfully generated code"
 //	@Failure		401				{object}	utils.RespStatus{data=nil}								"Missing User ID / Unauthorized"
 //	@Failure		400				{object}	utils.RespStatus{data=nil}								"Invalid Input"
@@ -84,9 +85,11 @@ func (self *EventHandler) Checkin(c *gin.Context) {
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			payload	body		service_event.CheckinSubmitData	true	"Checkin Code Data"
-//	@Success		200		{object}	utils.RespStatus{data=nil}		"Attendance marked successfully"
-//	@Failure		400		{object}	utils.RespStatus{data=nil}		"Invalid Code or Input"
+//	@Param			X-Api-Version	header		string							true	"latest"
+//	@Param			Authorization	header		string							true	"Bearer token"
+//	@Param			payload			body		service_event.CheckinSubmitData	true	"Checkin Code Data"
+//	@Success		200				{object}	utils.RespStatus{data=nil}		"Attendance marked successfully"
+//	@Failure		400				{object}	utils.RespStatus{data=nil}		"Invalid Code or Input"
 //	@Security		ApiKeyAuth
 //	@Router			/event/checkin/submit [post]
 func (self *EventHandler) CheckinSubmit(c *gin.Context) {
--- a/api/event/info.go
+++ b/api/event/info.go
@@ -16,13 +16,12 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			event_id		query		string										true	"Event UUID"
-//	@Param			X-Api-Version	header		string										true	"latest"
-//	@Success		200				{object}	utils.RespStatus{data=data.EventIndexDoc}	"Successful retrieval"
-//	@Failure		400				{object}	utils.RespStatus{data=nil}					"Invalid Input"
-//	@Failure		401				{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
-//	@Failure		404				{object}	utils.RespStatus{data=nil}					"Event Not Found"
-//	@Failure		500				{object}	utils.RespStatus{data=nil}					"Internal Server Error"
+//	@Param			event_id	query		string										true	"Event UUID"
+//	@Success		200			{object}	utils.RespStatus{data=data.EventIndexDoc}	"Successful retrieval"
+//	@Failure		400			{object}	utils.RespStatus{data=nil}					"Invalid Input"
+//	@Failure		401			{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
+//	@Failure		404			{object}	utils.RespStatus{data=nil}					"Event Not Found"
+//	@Failure		500			{object}	utils.RespStatus{data=nil}					"Internal Server Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/info [get]
 func (self *EventHandler) Info(c *gin.Context) {
--- a/api/event/join.go
+++ b/api/event/join.go
@@ -15,13 +15,12 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			request			body		service_event.EventJoinData								true	"Event Join Details (UserId and EventId are required)"
-//	@Param			X-Api-Version	header		string													true	"latest"
-//	@Success		200				{object}	utils.RespStatus{data=service_event.EventJoinResponse}	"Successfully joined the event"
-//	@Failure		400				{object}	utils.RespStatus{data=nil}								"Invalid Input or UUID Parse Failed"
-//	@Failure		401				{object}	utils.RespStatus{data=nil}								"Missing User ID / Unauthorized"
-//	@Failure		403				{object}	utils.RespStatus{data=nil}								"Unauthorized / Missing User ID / Event Limit Exceeded"
-//	@Failure		500				{object}	utils.RespStatus{data=nil}								"Internal Server Error / Database Error"
+//	@Param			request	body		service_event.EventJoinData								true	"Event Join Details (UserId and EventId are required)"
+//	@Success		200		{object}	utils.RespStatus{data=service_event.EventJoinResponse}	"Successfully joined the event"
+//	@Failure		400		{object}	utils.RespStatus{data=nil}								"Invalid Input or UUID Parse Failed"
+//	@Failure		401		{object}	utils.RespStatus{data=nil}								"Missing User ID / Unauthorized"
+//	@Failure		403		{object}	utils.RespStatus{data=nil}								"Unauthorized / Missing User ID / Event Limit Exceeded"
+//	@Failure		500		{object}	utils.RespStatus{data=nil}								"Internal Server Error / Database Error"
 //	@Security		ApiKeyAuth
 //	@Router			/event/join [post]
 func (self *EventHandler) Join(c *gin.Context) {
--- a/api/event/joined.go
+++ b/api/event/joined.go
@@ -0,0 +1,94 @@
+package event
+
+import (
+	"nixcn-cms/internal/exception"
+	"nixcn-cms/service/service_event"
+	"nixcn-cms/utils"
+
+	"github.com/gin-gonic/gin"
+	"github.com/google/uuid"
+)
+
+// GetJoined retrieves a paginated list of events that the current user has joined.
+//
+//	@Summary		Get Joined Events
+//	@Description	Fetches a list of events where the authenticated user is a participant. Supports pagination.
+//	@Tags			Event
+//	@Accept			json
+//	@Produce		json
+//	@Param			limit	query		int											false	"Maximum number of events to return (default 20)"
+//	@Param			offset	query		int											false	"Number of events to skip"
+//	@Success		200		{object}	utils.RespStatus{data=[]data.EventIndexDoc}	"Successful retrieval of joined events"
+//	@Failure		400		{object}	utils.RespStatus{data=nil}					"Invalid Input"
+//	@Failure		401		{object}	utils.RespStatus{data=nil}					"Unauthorized"
+//	@Failure		500		{object}	utils.RespStatus{data=nil}					"Internal Server Error"
+//	@Security		ApiKeyAuth
+//	@Router			/event/joined [get]
+func (self *EventHandler) Joined(c *gin.Context) {
+	userIdOrig, ok := c.Get("user_id")
+	if !ok {
+		errorCode := new(exception.Builder).
+			SetStatus(exception.StatusUser).
+			SetService(exception.ServiceUser).
+			SetEndpoint(exception.EndpointUserServiceInfo).
+			SetType(exception.TypeCommon).
+			SetOriginal(exception.CommonErrorMissingUserId).
+			Throw(c).
+			String()
+		utils.HttpResponse(c, 403, errorCode)
+		return
+	}
+
+	userId, err := uuid.Parse(userIdOrig.(string))
+	if err != nil {
+		errorCode := new(exception.Builder).
+			SetStatus(exception.StatusServer).
+			SetService(exception.ServiceUser).
+			SetEndpoint(exception.EndpointUserServiceInfo).
+			SetType(exception.TypeCommon).
+			SetOriginal(exception.CommonErrorUuidParseFailed).
+			SetError(err).
+			Throw(c).
+			String()
+		utils.HttpResponse(c, 500, errorCode)
+		return
+	}
+
+	type JoinedQuery struct {
+		Limit  *string `form:"limit"`
+		Offset *string `form:"offset"`
+	}
+
+	var query JoinedQuery
+	if err := c.ShouldBindQuery(&query); err != nil {
+		exc := new(exception.Builder).
+			SetStatus(exception.StatusClient).
+			SetService(exception.ServiceEvent).
+			SetEndpoint(exception.EndpointEventServiceList).
+			SetType(exception.TypeCommon).
+			SetOriginal(exception.CommonErrorInvalidInput).
+			Throw(c).
+			String()
+
+		utils.HttpResponse(c, 400, exc)
+		return
+	}
+
+	payload := &service_event.JoinedEventListPayload{
+		Context: c,
+		UserId:  userId,
+		Data: &service_event.JoinedEventListData{
+			Limit:  query.Limit,
+			Offset: query.Offset,
+		},
+	}
+
+	result := self.svc.GetJoinedEvent(payload)
+
+	if result.Common.Exception.Original != exception.CommonSuccess {
+		utils.HttpResponse(c, result.Common.HttpCode, result.Common.Exception.String())
+		return
+	}
+
+	utils.HttpResponse(c, result.Common.HttpCode, result.Common.Exception.String(), result.Data)
+}
--- a/api/event/list.go
+++ b/api/event/list.go
@@ -16,13 +16,12 @@ import (
 //	@Tags			Event
 //	@Accept			json
 //	@Produce		json
-//	@Param			limit			query		int											false	"Maximum number of events to return (default 20)"
-//	@Param			offset			query		int											false	"Number of events to skip"
-//	@Param			X-Api-Version	header		string										true	"latest"
-//	@Success		200				{object}	utils.RespStatus{data=[]data.EventIndexDoc}	"Successful paginated list retrieval"
-//	@Failure		400				{object}	utils.RespStatus{data=nil}					"Invalid Input (Missing offset or malformed parameters)"
-//	@Failure		401				{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
-//	@Failure		500				{object}	utils.RespStatus{data=nil}					"Internal Server Error (Database query failed)"
+//	@Param			limit	query		int											false	"Maximum number of events to return (default 20)"
+//	@Param			offset	query		int											false	"Number of events to skip"
+//	@Success		200		{object}	utils.RespStatus{data=[]data.EventIndexDoc}	"Successful paginated list retrieval"
+//	@Failure		400		{object}	utils.RespStatus{data=nil}					"Invalid Input (Missing offset or malformed parameters)"
+//	@Failure		401		{object}	utils.RespStatus{data=nil}					"Missing User ID / Unauthorized"
+//	@Failure		500		{object}	utils.RespStatus{data=nil}					"Internal Server Error (Database query failed)"
 //	@Security		ApiKeyAuth
 //	@Router			/event/list [get]
 func (self *EventHandler) List(c *gin.Context) {