add swagger

model/event.go

@@ -6,6 +6,7 @@ import (
 	"time"
 )
 
+// swagger:model Event
 type Event struct {
 	gorm.Model
 	ID       uuid.UUID           `gorm:"type:uuid;default:gen_random_uuid();primarykey"`
@@ -20,9 +21,27 @@ type Event struct {
 	OrgId    uuid.UUID           `json:"-"`
 }
 
+// swagger:model CreateEvent
 type CreateEvent struct {
-	Start   time.Time            `json:"start" validate:"required,gt"`
-	End     time.Time            `json:"end" validate:"required,gtfield=Start"`
-	Person  *PersonalInformation `json:"person" validate:"required,dive"`
-	MedicId uuid.UUID            `json:"medic_id" validate:"required"`
+	// The event start time
+	// example: 2023-08-02T19:21:23.617Z
+	// required: true
+	Start time.Time `json:"start" validate:"required,gt"`
+	// The event end time
+	// example: 2023-08-02T19:21:23.617Z
+	// required: true
+	End time.Time `json:"end" validate:"required,gtfield=Start"`
+	// The person information
+	// required: true
+	Person *PersonalInformation `json:"person" validate:"required,dive"`
+	// The UUID of a medic
+	// example: 6204037c-30e6-408b-8aaa-dd8219860b4b
+	// required: true
+	MedicId uuid.UUID `json:"medic_id" validate:"required"`
+}
+
+// swagger:parameters CreateEvent
+type CreateEventArg struct {
+	//in: body
+	CreateEvent *CreateEvent
 }