tm_back/internal/user/form.go

package user

// User Registration DTOs

// CreateUserForm represents the data required to create a new user account
type CreateUserForm struct {
	FullName     string  `json:"full_name" valid:"required,length(2|100)" example:"John Smith"`                         // Full name of the user
	Username     string  `json:"username" valid:"required,alphanum,length(3|30)" example:"johnsmith"`                   // Unique username (alphanumeric only)
	Email        string  `json:"email" valid:"required,email" example:"john.smith@company.com"`                         // Valid email address
	Password     string  `json:"password" valid:"required,length(8|128)" example:"SecurePass123!"`                      // Password (minimum 8 characters)
	Role         string  `json:"role" valid:"required,in(admin|manager|operator|viewer)" example:"manager"`             // User role (admin, manager, operator, viewer)
	Department   *string `json:"department,omitempty" valid:"optional,length(2|100)" example:"Information Technology"`  // Optional department name
	Position     *string `json:"position,omitempty" valid:"optional,length(2|100)" example:"Senior Developer"`          // Optional job position
	Phone        *string `json:"phone,omitempty" valid:"optional,length(10|20)" example:"+1234567890"`                  // Optional phone number
	ProfileImage *string `json:"profile_image,omitempty" valid:"optional,url" example:"https://example.com/avatar.jpg"` // Optional profile image URL
}

// UpdateUserForm represents the data for updating an existing user account
type UpdateUserForm struct {
	FullName     *string `json:"full_name,omitempty" valid:"optional,length(2|100)" example:"John Smith"`                   // Updated full name
	Username     *string `json:"username,omitempty" valid:"optional,alphanum,length(3|30)" example:"johnsmith"`             // Updated username
	Email        *string `json:"email,omitempty" valid:"optional,email" example:"john.smith@newcompany.com"`                // Updated email address
	Role         *string `json:"role,omitempty" valid:"optional,in(admin|manager|operator|viewer)" example:"admin"`         // Updated user role
	CompanyID    *string `json:"company_id,omitempty" valid:"optional,uuid" example:"123e4567-e89b-12d3-a456-426614174000"` // Updated company ID
	Department   *string `json:"department,omitempty" valid:"optional,length(2|100)" example:"Product Management"`          // Updated department
	Position     *string `json:"position,omitempty" valid:"optional,length(2|100)" example:"Tech Lead"`                     // Updated position
	Phone        *string `json:"phone,omitempty" valid:"optional,length(10|20)" example:"+1234567890"`                      // Updated phone number
	ProfileImage *string `json:"profile_image,omitempty" valid:"optional,url" example:"https://example.com/new-avatar.jpg"` // Updated profile image URL
	Status       *string `json:"status,omitempty" valid:"optional,in(active|inactive|suspended)" example:"active"`          // Updated account status
}

// User Authentication DTOs

// LoginForm represents the credentials required for user authentication
type LoginForm struct {
	Username string `json:"username" valid:"required" example:"nakhostin"` // Username or email address
	Password string `json:"password" valid:"required" example:"Nima.1998"` // User password
}

// RefreshTokenForm represents the refresh token required to generate new access tokens
type RefreshTokenForm struct {
	RefreshToken string `json:"refresh_token" valid:"required" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."` // Valid refresh token
}

// ChangePasswordForm represents the data required to change user password
type ChangePasswordForm struct {
	OldPassword string `json:"old_password" valid:"required" example:"OldPassword123!"`           // Current password for verification
	NewPassword string `json:"new_password" valid:"required,length(8|128)" example:"NewPass456!"` // New password (minimum 8 characters)
}

// UpdateProfileForm represents the data for updating user profile information
type UpdateProfileForm struct {
	FullName     *string `json:"full_name,omitempty" valid:"optional,length(2|100)" example:"John Smith"`                // Updated full name
	Department   *string `json:"department,omitempty" valid:"optional,length(2|100)" example:"Engineering"`              // Updated department
	Position     *string `json:"position,omitempty" valid:"optional,length(2|100)" example:"Senior Engineer"`            // Updated position
	Phone        *string `json:"phone,omitempty" valid:"optional,length(10|20)" example:"+1234567890"`                   // Updated phone number
	ProfileImage *string `json:"profile_image,omitempty" valid:"optional,url" example:"https://example.com/profile.jpg"` // Updated profile image URL
}

// ResetPasswordForm represents the email address for password reset
type ResetPasswordForm struct {
	Email string `json:"email" valid:"required,email" example:"john.smith@company.com"` // Email address for password reset
}

// Admin DTOs
type ListUsersForm struct {
	Search    *string `query:"search" valid:"optional"`
	Status    *string `query:"status" valid:"optional,in(active|inactive|suspended)"`
	Role      *string `query:"role" valid:"optional,in(admin|manager|operator|viewer)"`
	CompanyID *string `query:"company_id" valid:"optional,uuid"`
	Limit     *int    `query:"limit" valid:"optional,range(1|100)"`
	Offset    *int    `query:"offset" valid:"optional,min(0)"`
	SortBy    *string `query:"sort_by" valid:"optional,in(full_name|email|username|role|created_at|last_login_at)"`
	SortOrder *string `query:"sort_order" valid:"optional,in(asc|desc)"`
}

type UpdateUserStatusForm struct {
	Status string `json:"status" valid:"required,in(active|inactive|suspended)"`
}

type UpdateUserRoleForm struct {
	Role string `json:"role" valid:"required,in(admin|manager|operator|viewer)"`
}

// Response DTOs
type UserResponse struct {
	ID           string  `json:"id"`
	FullName     string  `json:"full_name"`
	Username     string  `json:"username"`
	Email        string  `json:"email"`
	Role         string  `json:"role"`
	Status       string  `json:"status"`
	CompanyID    *string `json:"company_id,omitempty"`
	Department   *string `json:"department,omitempty"`
	Position     *string `json:"position,omitempty"`
	Phone        *string `json:"phone,omitempty"`
	ProfileImage *string `json:"profile_image,omitempty"`
	IsVerified   bool    `json:"is_verified"`
	LastLoginAt  *int64  `json:"last_login_at,omitempty"`
	CreatedAt    int64   `json:"created_at"`
	UpdatedAt    int64   `json:"updated_at"`
	CreatedBy    *string `json:"created_by,omitempty"`
	UpdatedBy    *string `json:"updated_by,omitempty"`
}

type AuthResponse struct {
	User         *UserResponse `json:"user"`
	AccessToken  string        `json:"access_token"`
	RefreshToken string        `json:"refresh_token"`
	ExpiresAt    int64         `json:"expires_at"`
}

type UserListResponse struct {
	Users      []*UserResponse `json:"users"`
	Total      int64           `json:"total"`
	Limit      int             `json:"limit"`
	Offset     int             `json:"offset"`
	TotalPages int             `json:"total_pages"`
}

// Helper function to convert User to UserResponse
func (u *User) ToResponse() *UserResponse {
	return &UserResponse{
		ID:           u.ID.Hex(),
		FullName:     u.FullName,
		Username:     u.Username,
		Email:        u.Email,
		Role:         string(u.Role),
		Status:       string(u.Status),
		Department:   u.Department,
		Position:     u.Position,
		Phone:        u.Phone,
		ProfileImage: u.ProfileImage,
		IsVerified:   u.IsVerified,
		LastLoginAt:  u.LastLoginAt,
		CreatedAt:    u.CreatedAt,
		UpdatedAt:    u.UpdatedAt,
		CreatedBy:    u.CreatedBy,
		UpdatedBy:    u.UpdatedBy,
	}
}