From 3e10a3542f70f23313fc6a43c41aaca518e3d344 Mon Sep 17 00:00:00 2001
From: Arda Serdar Pektezol <1669855+pektezol@users.noreply.github.com>
Date: Thu, 13 Apr 2023 01:28:48 +0300
Subject: doc: swagger init for login and user routes (#34)

---
 backend/controllers/loginController.go | 18 ++++++++++++----
 backend/controllers/userController.go  | 39 +++++++++++++++++++++++++++++++++-
 2 files changed, 52 insertions(+), 5 deletions(-)

(limited to 'backend/controllers')

diff --git a/backend/controllers/loginController.go b/backend/controllers/loginController.go
index 50189e8..6feda8a 100644
--- a/backend/controllers/loginController.go
+++ b/backend/controllers/loginController.go
@@ -15,6 +15,14 @@ import (
 	"github.com/solovev/steam_go"
 )
 
+// Login
+//
+//	@Summary	Get (redirect) login page for Steam auth.
+//	@Accept		json
+//	@Produce	json
+//	@Success	200	{object}	models.Response{data=models.LoginResponse}
+//	@Failure	400	{object}	models.Response
+//	@Router		/login [get]
 func Login(c *gin.Context) {
 	openID := steam_go.NewOpenId(c.Request)
 	switch openID.Mode() {
@@ -31,14 +39,16 @@ func Login(c *gin.Context) {
 		// Create user if new
 		var checkSteamID int64
 		err = database.DB.QueryRow("SELECT steam_id FROM users WHERE steam_id = $1", steamID).Scan(&checkSteamID)
-		if err != nil {
-			c.JSON(http.StatusBadRequest, models.ErrorResponse(err.Error()))
-			return
-		}
+		// if err != nil {
+		// 	fmt.Println("y1")
+		// 	c.JSON(http.StatusBadRequest, models.ErrorResponse(err.Error()))
+		// 	return
+		// }
 		// User does not exist
 		if checkSteamID == 0 {
 			user, err := GetPlayerSummaries(steamID, os.Getenv("API_KEY"))
 			if err != nil {
+				fmt.Println("y2")
 				c.JSON(http.StatusBadRequest, models.ErrorResponse(err.Error()))
 				return
 			}
diff --git a/backend/controllers/userController.go b/backend/controllers/userController.go
index 95b2b52..cb6c15d 100644
--- a/backend/controllers/userController.go
+++ b/backend/controllers/userController.go
@@ -11,6 +11,15 @@ import (
 	"github.com/pektezol/leastportals/backend/models"
 )
 
+// GET Profile
+//
+//	@Summary	Get profile page of session user.
+//	@Accept		json
+//	@Produce	json
+//	@Success	200	{object}	models.Response{data=models.ProfileResponse}
+//	@Failure	400	{object}	models.Response
+//	@Failure	401	{object}	models.Response
+//	@Router		/profile [get]
 func Profile(c *gin.Context) {
 	// Check if user exists
 	user, exists := c.Get("user")
@@ -87,6 +96,16 @@ func Profile(c *gin.Context) {
 	return
 }
 
+// GET User
+//
+//	@Summary	Get profile page of another user.
+//	@Accept		json
+//	@Produce	json
+//	@Param		id	path		int	true	"User ID"
+//	@Success	200	{object}	models.Response{data=models.ProfileResponse}
+//	@Failure	400	{object}	models.Response
+//	@Failure	404	{object}	models.Response
+//	@Router		/user/{id} [get]
 func FetchUser(c *gin.Context) {
 	id := c.Param("id")
 	// Check if id is all numbers and 17 length
@@ -178,6 +197,15 @@ func FetchUser(c *gin.Context) {
 	return
 }
 
+// PUT Profile
+//
+//	@Summary	Update profile page of session user.
+//	@Accept		json
+//	@Produce	json
+//	@Success	200	{object}	models.Response{data=models.ProfileResponse}
+//	@Failure	400	{object}	models.Response
+//	@Failure	401	{object}	models.Response
+//	@Router		/profile [post]
 func UpdateUser(c *gin.Context) {
 	// Check if user exists
 	user, exists := c.Get("user")
@@ -208,9 +236,18 @@ func UpdateUser(c *gin.Context) {
 			CountryCode: profile.LocCountryCode,
 		},
 	})
-	return
 }
 
+// PUT Profile/CountryCode
+//
+//	@Summary	Update country code of session user.
+//	@Accept		json
+//	@Produce	json
+//	@Param		country_code	query		string	true	"Country Code [XX]"
+//	@Success	200				{object}	models.Response{data=models.ProfileResponse}
+//	@Failure	400				{object}	models.Response
+//	@Failure	401				{object}	models.Response
+//	@Router		/profile [put]
 func UpdateCountryCode(c *gin.Context) {
 	// Check if user exists
 	user, exists := c.Get("user")
-- 
cgit v1.2.3