datastore

package
v0.0.0-...-53e80a7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 25, 2024 License: AGPL-3.0 Imports: 9 Imported by: 0

Documentation

Index

Constants

View Source
const (
	UserStatusActive           = 1
	UserStatusArchived         = 2
	UserRoleExecutive          = 1
	UserRoleManagement         = 2
	UserRoleFrontlineStaff     = 3
	UserRoleStaff              = 3
	UserRoleAssociate          = 4
	UserRoleCustomer           = 5
	UserRoleAssociateJobSeeker = 6
)

Variables

This section is empty.

Functions

This section is empty.

Types

type User

type User struct {
	ID                      primitive.ObjectID `bson:"_id" json:"id"`
	Email                   string             `bson:"email" json:"email"`
	FirstName               string             `bson:"first_name" json:"first_name"`
	LastName                string             `bson:"last_name" json:"last_name"`
	Name                    string             `bson:"name" json:"name"`
	LexicalName             string             `bson:"lexical_name" json:"lexical_name"`
	OrganizationName        string             `bson:"organization_name" json:"organization_name"`
	OrganizationType        int8               `bson:"organization_type" json:"organization_type"`
	TenantID                primitive.ObjectID `bson:"tenant_id" json:"tenant_id,omitempty"`
	TenantName              string             `bson:"tenant_name" json:"tenant_name"`
	PasswordHashAlgorithm   string             `bson:"password_hash_algorithm" json:"password_hash_algorithm,omitempty"`
	PasswordHash            string             `bson:"password_hash" json:"password_hash,omitempty"`
	Role                    int8               `bson:"role" json:"role"`
	ReferenceID             primitive.ObjectID `bson:"reference_id" json:"reference_id,omitempty"` // Reference the record this user belongs to by the role they are assigned, the choices are either: Customer, Associate, or Staff.
	HasStaffRole            bool               `bson:"has_staff_role" json:"has_staff_role"`
	WasEmailVerified        bool               `bson:"was_email_verified" json:"was_email_verified"`
	EmailVerificationCode   string             `bson:"email_verification_code,omitempty" json:"email_verification_code,omitempty"`
	EmailVerificationExpiry time.Time          `bson:"email_verification_expiry,omitempty" json:"email_verification_expiry,omitempty"`
	Phone                   string             `bson:"phone" json:"phone,omitempty"`
	Country                 string             `bson:"country" json:"country,omitempty"`
	Region                  string             `bson:"region" json:"region,omitempty"`
	City                    string             `bson:"city" json:"city,omitempty"`
	AgreeTOS                bool               `bson:"agree_tos" json:"agree_tos,omitempty"`
	AgreePromotionsEmail    bool               `bson:"agree_promotions_email" json:"agree_promotions_email,omitempty"`
	CreatedAt               time.Time          `bson:"created_at" json:"created_at"`
	CreatedByUserID         primitive.ObjectID `bson:"created_by_user_id" json:"created_by_user_id,omitempty"`
	CreatedByUserName       string             `bson:"created_by_user_name" json:"created_by_user_name"`
	CreatedFromIPAddress    string             `bson:"created_from_ip_address" json:"created_from_ip_address"`
	ModifiedAt              time.Time          `bson:"modified_at" json:"modified_at"`
	ModifiedByUserID        primitive.ObjectID `bson:"modified_by_user_id" json:"modified_by_user_id,omitempty"`
	ModifiedByUserName      string             `bson:"modified_by_user_name" json:"modified_by_user_name"`
	ModifiedFromIPAddress   string             `bson:"modified_from_ip_address" json:"modified_from_ip_address"`
	Status                  int8               `bson:"status" json:"status"`
	Comments                []*UserComment     `bson:"comments" json:"comments"`
	Salt                    string             `bson:"salt" json:"salt,omitempty"`
	JoinedTime              time.Time          `bson:"joined_time" json:"joined_time,omitempty"`
	PrAccessCode            string             `bson:"pr_access_code" json:"pr_access_code,omitempty"`
	PrExpiryTime            time.Time          `bson:"pr_expiry_time" json:"pr_expiry_time,omitempty"`
	PublicID                uint64             `bson:"public_id" json:"public_id,omitempty"`
	Timezone                string             `bson:"timezone" json:"timezone,omitempty"`

	// OTPEnabled controls whether we force 2FA or not during login.
	OTPEnabled bool `bson:"otp_enabled" json:"otp_enabled"`

	// OTPVerified indicates user has successfully validated their opt token afer enabling 2FA thus turning it on.
	OTPVerified bool `bson:"otp_verified" json:"otp_verified"`

	// OTPValidated automatically gets set as `false` on successful login and then sets `true` once successfully validated by 2FA.
	OTPValidated bool `bson:"otp_validated" json:"otp_validated"`

	// OTPSecret the unique one-time password secret to be shared between our
	// backend and 2FA authenticator sort of apps that support `TOPT`.
	OTPSecret string `bson:"otp_secret" json:"-"`

	// OTPAuthURL is the URL used to share.
	OTPAuthURL string `bson:"otp_auth_url" json:"-"`

	// OTPBackupCodeHash is the one-time use backup code which resets the 2FA settings and allow the user to setup 2FA from scratch for the user.
	OTPBackupCodeHash string `bson:"otp_backup_code_hash" json:"-"`

	// OTPBackupCodeHashAlgorithm tracks the hashing algorithm used.
	OTPBackupCodeHashAlgorithm string `bson:"otp_backup_code_hash_algorithm" json:"-"`
}

type UserAsSelectOption

type UserAsSelectOption struct {
	Value primitive.ObjectID `bson:"_id" json:"value"` // Extract from the database `_id` field and output through API as `value`.
	Label string             `bson:"name" json:"label"`
}

type UserComment

type UserComment struct {
	ID               primitive.ObjectID `bson:"_id" json:"id"`
	TenantID         primitive.ObjectID `bson:"tenant_id" json:"tenant_id"`
	CreatedAt        time.Time          `bson:"created_at,omitempty" json:"created_at,omitempty"`
	CreatedByUserID  primitive.ObjectID `bson:"created_by_user_id" json:"created_by_user_id"`
	CreatedByName    string             `bson:"created_by_name" json:"created_by_name"`
	ModifiedAt       time.Time          `bson:"modified_at,omitempty" json:"modified_at,omitempty"`
	ModifiedByUserID primitive.ObjectID `bson:"modified_by_user_id" json:"modified_by_user_id"`
	ModifiedByName   string             `bson:"modified_by_name" json:"modified_by_name"`
	Content          string             `bson:"content" json:"content"`
}

type UserListFilter

type UserListFilter struct {
	// Pagination related.
	Cursor    primitive.ObjectID
	PageSize  int64
	SortField string
	SortOrder int8 // 1=ascending | -1=descending

	// Filter related.
	TenantID        primitive.ObjectID
	Role            int8
	Status          int8
	ExcludeArchived bool
	SearchText      string
	FirstName       string
	LastName        string
	Email           string
	Phone           string
	CreatedAtGTE    time.Time
}

type UserListResult

type UserListResult struct {
	Results     []*User            `json:"results"`
	NextCursor  primitive.ObjectID `json:"next_cursor"`
	HasNextPage bool               `json:"has_next_page"`
}

type UserStorer

type UserStorer interface {
	Create(ctx context.Context, m *User) error
	GetByID(ctx context.Context, id primitive.ObjectID) (*User, error)
	GetByPublicID(ctx context.Context, oldID uint64) (*User, error)
	GetByEmail(ctx context.Context, email string) (*User, error)
	GetByVerificationCode(ctx context.Context, verificationCode string) (*User, error)
	GetLatestByTenantID(ctx context.Context, tenantID primitive.ObjectID) (*User, error)
	CheckIfExistsByEmail(ctx context.Context, email string) (bool, error)
	UpdateByID(ctx context.Context, m *User) error
	UpsertByID(ctx context.Context, m *User) error
	UpsertByEmail(ctx context.Context, m *User) error
	ListByFilter(ctx context.Context, f *UserListFilter) (*UserListResult, error)
	ListAsSelectOptionByFilter(ctx context.Context, f *UserListFilter) ([]*UserAsSelectOption, error)
	ListAllExecutives(ctx context.Context) (*UserListResult, error)
	ListAllStaffForTenantID(ctx context.Context, tenantID primitive.ObjectID) (*UserListResult, error)
	CountByFilter(ctx context.Context, f *UserListFilter) (int64, error)
	DeleteByID(ctx context.Context, id primitive.ObjectID) error
}

UserStorer Interface for user.

func NewDatastore

func NewDatastore(appCfg *c.Conf, loggerp *slog.Logger, client *mongo.Client) UserStorer

type UserStorerImpl

type UserStorerImpl struct {
	Logger     *slog.Logger
	DbClient   *mongo.Client
	Collection *mongo.Collection
}

func (UserStorerImpl) CheckIfExistsByEmail

func (impl UserStorerImpl) CheckIfExistsByEmail(ctx context.Context, email string) (bool, error)

func (UserStorerImpl) CountByFilter

func (impl UserStorerImpl) CountByFilter(ctx context.Context, f *UserListFilter) (int64, error)

func (UserStorerImpl) Create

func (impl UserStorerImpl) Create(ctx context.Context, u *User) error

func (UserStorerImpl) DeleteByID

func (impl UserStorerImpl) DeleteByID(ctx context.Context, id primitive.ObjectID) error

func (UserStorerImpl) GetByEmail

func (impl UserStorerImpl) GetByEmail(ctx context.Context, email string) (*User, error)

func (UserStorerImpl) GetByID

func (impl UserStorerImpl) GetByID(ctx context.Context, id primitive.ObjectID) (*User, error)

func (UserStorerImpl) GetByPublicID

func (impl UserStorerImpl) GetByPublicID(ctx context.Context, oldID uint64) (*User, error)

func (UserStorerImpl) GetByVerificationCode

func (impl UserStorerImpl) GetByVerificationCode(ctx context.Context, verificationCode string) (*User, error)

func (UserStorerImpl) GetLatestByTenantID

func (impl UserStorerImpl) GetLatestByTenantID(ctx context.Context, tenantID primitive.ObjectID) (*User, error)

func (UserStorerImpl) ListAllExecutives

func (impl UserStorerImpl) ListAllExecutives(ctx context.Context) (*UserListResult, error)

func (UserStorerImpl) ListAllStaffForTenantID

func (impl UserStorerImpl) ListAllStaffForTenantID(ctx context.Context, tenantID primitive.ObjectID) (*UserListResult, error)

func (UserStorerImpl) ListAsSelectOptionByFilter

func (impl UserStorerImpl) ListAsSelectOptionByFilter(ctx context.Context, f *UserListFilter) ([]*UserAsSelectOption, error)

func (UserStorerImpl) ListByFilter

func (impl UserStorerImpl) ListByFilter(ctx context.Context, f *UserListFilter) (*UserListResult, error)

func (UserStorerImpl) UpdateByID

func (impl UserStorerImpl) UpdateByID(ctx context.Context, m *User) error

func (UserStorerImpl) UpsertByEmail

func (impl UserStorerImpl) UpsertByEmail(ctx context.Context, user *User) error

func (UserStorerImpl) UpsertByID

func (impl UserStorerImpl) UpsertByID(ctx context.Context, user *User) error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL