From f3fca7f07b87d514a5a3acbae1e265152a0751f1 Mon Sep 17 00:00:00 2001
From: NanamiAdmin <yzt114@yeah.net>
Date: Tue, 10 Mar 2026 14:34:16 +0800
Subject: [PATCH] feat(user): add createdAt field to user model

- Add createdAt field to User struct and database schema
- Update all user queries to include createdAt field
- Document new field in API documentation
- Fix server online status flag timing
---
 database.db | Bin 24576 -> 24576 bytes
 database.go |  28 +++++++++++++++-------------
 docs/api.md |  13 +++++++++++--
 main.go     |   2 +-
 4 files changed, 27 insertions(+), 16 deletions(-)

diff --git a/database.db b/database.db
index 5e4106ecb3e50a5f8856e3f734e230065543d22a..d82e70bd42286b3169dfe6508e6423a8dc103d72 100644
GIT binary patch
delta 324
zcmZoTz}Rqrae_1>%S0JxaTW%>vJPJU9}KKKa~b#!@*m~P=b6iAvawN}XY*wq6(+7G
zMn-mVd3na>z{!mK2l#ZjI5|0!i&7IyQd1mDCNJa{7t}}ra!N9DQ#I7{^2^mVH76hB
zcV=VcpTfXDWwW3{7k_;gBRhk1Bd@%1NosM4p^<TF3Xn)MPc%0&H&3!KF*Qs|O-`{e
zF*mU=H!v_WFfuVQO-xBOH!?N0FiW$rOffT0G%z(wGcYhtOEO9^GAb@DNG&QYPAxJr
zFf!9MFxE9RP%tpFGBmU@G2migU|{6`$^b+#uvtpsBLBn*f}&i^(wtBy@Pd_nV&MM-
lbmA@ki2-~fJdDipoFG$u^3yZ(KnfTHAd(Xl*g(c2xB#?5Qx*UK

delta 764
zcmaixzl#$=6vt<?NiK=WjuDm=F(jgpLbA-v{tm(wSNW?ka+MM%GqXodvkA$bDRZ$G
zl<NdbD;pv06%iB*n}hrT*V$aBg@={1xidjHktv1;@B2RA?|b`mWq+=`Dl4_uSGP(v
zV7&ZQfTtjpUjXeV{H(ppFSOlR@$%#R>}~!=A~(IOY?P{1<%Kx-s?85R!mUgKZUgup
zZp*GaaMDuKpfW9#LNRXdjl>WKoN>%-Cb)-%O)TPA6md*^Bz(ez@a+yZ9pT!7xsLpK
zK)Eo9FC3GYoKxQGhAkxx^l70QiBV)SLOWK+vW3k8!WgzJOgW~^v;*Y29NE<4KJ!rE
zF~o?l12-_ej&Nkrp_r1<-argvYdHWw0-gYP0#9ef+A+MAS1ZaN<LZX0XJcRiewS@W
z03N|(+4c$EDky4Ii6`9a?{q`8m{99VFdVSk;V7aZ6Qi`8tYudn1^5Oev_k+b?NDy%
zgEo1dz67%M>v}0$X>Z2FSl$k4Phg)I*zpW(U>6}2^`DAxJRUbVjVSAfL3d~LXqjNC
zi2b$y(i>5~_lzLoG?3Xq<RSK(mff__P2@EZ;wi~3S0{QYqqjC=H6|t|u7TuR1Bd;7
z^bgp%<|2&MB=`&?;|EXTh`NlJ(eIy;*2x~MqWy<-5oVnx2Y<-REL6CF-{fV!z{Zti
aw!XaJYM<$RGFw*8U8kh6+_FdySn@aa%-t9O

diff --git a/database.go b/database.go
index b7863cc..31f9b20 100644
--- a/database.go
+++ b/database.go
@@ -14,10 +14,11 @@ import (
 var db *sql.DB
 
 type User struct {
-	UserID   int
-	Username string
-	Passwd   string
-	Type     string
+	UserID    int
+	Username  string
+	Passwd    string
+	Type      string
+	CreatedAt string
 }
 
 func InitDatabase(dbPath string) error {
@@ -85,7 +86,7 @@ func AddUser(username, passwd, userType string) (int, error) { // New user regis
 	return int(lastID), nil
 }
 
-func RemoveUser (userID int) error {
+func RemoveUser(userID int) error {
 	if !isValidInput(strconv.Itoa(userID)) {
 		return errors.New("invalid input: contains illegal characters")
 	}
@@ -113,8 +114,8 @@ func GetUserByUsername(username string) (*User, error) {
 	}
 
 	var user User
-	err := db.QueryRow("SELECT userID, username, passwd, type FROM userLogin WHERE username = ?", username).
-		Scan(&user.UserID, &user.Username, &user.Passwd, &user.Type)
+	err := db.QueryRow("SELECT userID, username, passwd, type, createdAt FROM userLogin WHERE username = ?", username).
+		Scan(&user.UserID, &user.Username, &user.Passwd, &user.Type, &user.CreatedAt)
 	if err != nil {
 		if errors.Is(err, sql.ErrNoRows) {
 			return nil, errors.New("user not found")
@@ -127,8 +128,8 @@ func GetUserByUsername(username string) (*User, error) {
 
 func GetUserByID(userID int) (*User, error) {
 	var user User
-	err := db.QueryRow("SELECT userID, username, passwd, type FROM userLogin WHERE userID = ?", userID).
-		Scan(&user.UserID, &user.Username, &user.Passwd, &user.Type)
+	err := db.QueryRow("SELECT userID, username, passwd, type, createdAt FROM userLogin WHERE userID = ?", userID).
+		Scan(&user.UserID, &user.Username, &user.Passwd, &user.Type, &user.CreatedAt)
 	if err != nil {
 		if errors.Is(err, sql.ErrNoRows) {
 			return nil, errors.New("user not found")
@@ -280,7 +281,8 @@ func InitUserDatabase(dbPath string) error {
 			userID INTEGER PRIMARY KEY AUTOINCREMENT,
 			username TEXT UNIQUE NOT NULL,
 			passwd TEXT NOT NULL,
-			type TEXT NOT NULL DEFAULT 'visitor'
+			type TEXT NOT NULL DEFAULT 'visitor',
+			createdAt TEXT NOT NULL DEFAULT (datetime('now'))
 		);
 		`
 	_, err = db.Exec(createTableSQL)
@@ -292,7 +294,7 @@ func InitUserDatabase(dbPath string) error {
 }
 
 func DBQueryUsers() ([]User, error) { // List all users
-	rows, err := db.Query("SELECT userID, username, type FROM userLogin")
+	rows, err := db.Query("SELECT userID, username, type, createdAt FROM userLogin")
 	if err != nil {
 		return nil, fmt.Errorf("failed to query users: %w", err)
 	}
@@ -300,7 +302,7 @@ func DBQueryUsers() ([]User, error) { // List all users
 	var users []User
 	for rows.Next() {
 		var user User
-		if err := rows.Scan(&user.UserID, &user.Username, &user.Type); err != nil {
+		if err := rows.Scan(&user.UserID, &user.Username, &user.Type, &user.CreatedAt); err != nil {
 			return nil, fmt.Errorf("failed to scan user: %w", err)
 		}
 		users = append(users, user)
@@ -315,7 +317,7 @@ func DBQueryUsers() ([]User, error) { // List all users
 
 func DBQuerySpecificUser(userID int) (User, error) { // Query user by ID
 	var user User
-	err := db.QueryRow("SELECT userID, username, type FROM userLogin WHERE userID = ?", userID).Scan(&user.UserID, &user.Username, &user.Type)
+	err := db.QueryRow("SELECT userID, username, type, createdAt FROM userLogin WHERE userID = ?", userID).Scan(&user.UserID, &user.Username, &user.Type, &user.CreatedAt)
 	if err != nil {
 		return user, fmt.Errorf("failed to query user: %w", err)
 	}
diff --git a/docs/api.md b/docs/api.md
index 2fd537b..132c605 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -299,17 +299,26 @@ X-Timestamp: 1704067200000
     {
       "userID": 1,
       "username": "admin",
-      "type": "superuser"
+      "type": "superuser",
+      "createdAt": "2024-01-01 12:00:00"
     },
     {
       "userID": 2,
       "username": "new_user",
-      "type": "admin"
+      "type": "admin",
+      "createdAt": "2024-01-02 14:30:00"
     }
   ]
 }
 ```
 
+| Field | Type | Description |
+|-------|------|-------------|
+| userID | int | User ID |
+| username | string | Username |
+| type | string | User type: superuser, admin, visitor |
+| createdAt | string | User creation time (YYYY-MM-DD HH:MM:SS format) |
+
 ---
 
 ## List Active Sessions
diff --git a/main.go b/main.go
index 0740e44..8a9052a 100644
--- a/main.go
+++ b/main.go
@@ -89,10 +89,10 @@ func main() {
 
 	go func() {
 		postLog.Info(fmt.Sprintf("Server starting on %s", addr))
+		isOnline = true
 		if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
 			postLog.Fatal(fmt.Sprintf("Failed to start server: %v", err))
 		}
-		isOnline = true
 	}()
 
 	go func() {