teamroles

package module
v0.0.23 Latest Latest
Warning

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

 Go to latest Published: Oct 14, 2025 License: MIT Imports: 8 Imported by: 11

README

team-roles Package

The 'team-roles' package empowers administrators to create specialized teams with diverse users and roles tailored for distinct domains.

Features

  • Creates access control settings for members, specifying the level of access they have to specific resources or functionalities within the system.
  • Updates the existing control settings with new configuration of permissions.

Installation

go get github.com/spurtcms/team-roles

Usage Example

import (
		"github.com/spurtcms/auth"
		role "github.com/spurtcms/team-roles"
	)

	func main(){
		
		NewAuth := auth.AuthSetup(newauth.Config{
			SecretKey: os.Getenv("JWT_SECRET"),
			DB:        DB,
		})
		
		token, _ := Auth.CreateToken()

		Auth.VerifyToken(token, SecretKey)

		permission, _ := Auth.IsGranted("Roles & Permission", auth.CRUD)
		
		NewRoleWP := role.RoleSetup(role.Config{
			DB:               DB,
			AuthEnable:       true,
			PermissionEnable: false,
			Authenticate:     NewAuth,
		})
		
		if permission{
		
			//list role
			roles, rolecount, err := NewRole.RoleList(role.Rolelist{Limit: 10, Offset: 0})
			if err!=nil{
				//handle error
				fmt.Println(err)
			}
			fmt.Println(roles,rolecount)
			
			//create role
			rolecreate, err := PermissionFlg.CreateRole(RoleCreation{Name: "Manager", Description: "", CreatedBy: 1})
			if err != nil {
				//handle error
				fmt.Println(err)
			}
			fmt.Println(rolecreate)
			
			//update role
			roleupdate, err := PermissionFlg.UpdateRole(RoleCreation{Name: "Manager", Description: "deportment of marketting", CreatedBy: 1},3)
			if err != nil {
				//handle error
				fmt.Println(err)
			}
			fmt.Println(roleupdate)
			
			//delete role 1st param multiple delete , 2nd param single delete
			flg, err := PermissionFlg.DeleteRole([]int{}, 1)
			if err != nil {
				panic(err)
			}
			fmt.Println(flg)
		
		}

	}	

	```




	# Getting help
	If you encounter a problem with the package,please refer [Please refer [(https://www.spurtcms.com/documentation/cms-admin)] or you can create a new Issue in this repo[https://github.com/spurtcms/team-roles/issues].

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	ErrorAuthentication           = errors.New("auth enabled not initialised")
	ErrorAuthorization            = errors.New("permissions enabled not initialised")
	Error500Status                = errors.New("internal server error")
	Error403                      = errors.New("unauthorized")
	Error404                      = errors.New("not found")
	ErrorModuleNotFound           = errors.New("modulename not found")
	ErrorModulePermissionNotFound = errors.New("module permission not found")
	ErrorRoleNameEmpty            = errors.New("role name is empty")
	ErrorInvalidroleid            = errors.New("invalid roleid cannot delete")
	TenantId                      = os.Getenv("Tenant_ID")
)

Functions

func AuthandPermission 

func AuthandPermission(permission *PermissionConfig) error

func Difference 

func Difference(a, b []int) (diff []int)

Set Difference: A - B

Types

type Action 

type Action string
const (
	Create Action = "Create"

	Read Action = "View"

	Update Action = "Update"

	Delete Action = "Delete"

	CRUD Action = "CRUD"
)

type Config 

type Config struct {
	AuthEnable       bool
	PermissionEnable bool
	Authenticate     *auth.Auth
	DataBaseType     Type
	DB               *gorm.DB
}

In Default superadmin or roleid 1 have all permissions

type CreatePermissions 

type CreatePermissions struct {
	RoleId     int
	ModuleName string
	Permission Action
	CreatedBy  int
	TenantId   string
}

type Filter 

type Filter struct {
	Keyword  string
	Category string
	Status   string
	FromDate string
	ToDate   string
}

type LoginCheck 

type LoginCheck struct {
	Username string
	Password string
}
type MenuMod struct {
	Id         int
	ModuleName string
	IconPath   string
	Routes     []URL // this is for single menu multiple permissions arr
	HrefRoute  URL
	Route      string      //this is for a tag href route
	SubModule  []SubModule // this is for submodules
	// FullAccessPermission bool
	EmptyCheck bool //this is flg for mainmenu hide if submodule is empty
	TenantId   string
}

type ModelStruct 

type ModelStruct struct {
	UserId     int
	DataAccess int
}

Just Group the all model using this struct 

var AS ModelStruct

func (ModelStruct) CheckModuleExists 

func (as ModelStruct) CheckModuleExists(modulename string, DB *gorm.DB, tenantid string) (tblmod Tblmodule, err error)

func (ModelStruct) CheckModulePemissionExists 

func (as ModelStruct) CheckModulePemissionExists(moduleid int, permissions Action, DB *gorm.DB, tenantid string) (tblmod TblModulePermission, err error)

func (ModelStruct) CheckPermissionIdExist 

func (as ModelStruct) CheckPermissionIdExist(roleid int, permissionid []int, DB *gorm.DB, tenantid string) (roleperm []TblRolePermission, err error)

func (ModelStruct) CheckPermissionIdNotExist 

func (as ModelStruct) CheckPermissionIdNotExist(roleid int, permissionid []int, DB *gorm.DB, tenantid string) (roleperm []TblRolePermission, err error)

func (ModelStruct) CheckRoleExists 

func (as ModelStruct) CheckRoleExists(role *TblRole, id int, name string, DB *gorm.DB, tenantid string) error

Check role

func (ModelStruct) Checkrolespermission added in v0.0.19 

func (as ModelStruct) Checkrolespermission(user *tbluser, id int, ids []int, DB *gorm.DB, tenantid string) error

func (ModelStruct) CreateModulePermission 

func (as ModelStruct) CreateModulePermission(modpermission *TblModulePermission, DB *gorm.DB) (modper *TblModulePermission, err error)

create json module permission

func (ModelStruct) CreateRolePermission 

func (as ModelStruct) CreateRolePermission(roleper *[]TblRolePermission, DB *gorm.DB) error

bulk creation

func (ModelStruct) DeleteModulePermissioninEntries 

func (as ModelStruct) DeleteModulePermissioninEntries(id int, DB *gorm.DB, tenantid string) (tblmodper TblModulePermission, err error)

func (ModelStruct) DeleteRolePermissionById 

func (as ModelStruct) DeleteRolePermissionById(roleid int, DB *gorm.DB, tenantid string) (roleper []TblRolePermission, err error)

func (ModelStruct) Deleterolepermission 

func (as ModelStruct) Deleterolepermission(id int, DB *gorm.DB, tenantid string) (TblRolePermission TblRolePermission, err error)

Delete Role Permission by id

func (ModelStruct) GetAllModules 

func (as ModelStruct) GetAllModules(limit, offset, id int, filter Filter, DB *gorm.DB, tenantid string) (mod []Tblmodule, count int64)

This is for assign permission

func (ModelStruct) GetAllParentModule 

func (as ModelStruct) GetAllParentModule(DB *gorm.DB, tenantid string) (modules []TblModule, err error)

func (ModelStruct) GetAllParentModules1 

func (as ModelStruct) GetAllParentModules1(DB *gorm.DB, tenantid string) (mod []Tblmodule, err error)

func (ModelStruct) GetAllRoles 

func (as ModelStruct) GetAllRoles(limit, offset int, filter Filter, getalldata bool, DB *gorm.DB, tenantid string, active bool) (role []Tblrole, rolecount int64, err error)

Get all roles list with limit and offset

func (ModelStruct) GetAllSubModule 

func (as ModelStruct) GetAllSubModule(moduleid int, DB *gorm.DB, tenantid string) (modules []TblModule, err error)

func (ModelStruct) GetAllSubModules 

func (as ModelStruct) GetAllSubModules(ids []int, DB *gorm.DB, tenantid string) (mod []Tblmodule, err error)

func (ModelStruct) GetModulePermissionByChannelId added in v0.0.23 

func (as ModelStruct) GetModulePermissionByChannelId(id int, DB *gorm.DB, tenantid string) (tblmodper TblModulePermission, err error)

Get Id by RouteName

func (ModelStruct) GetModulePermissions 

func (as ModelStruct) GetModulePermissions(modid int, ids []int, DB *gorm.DB, tenantid string) (permission []TblModulePermission, err error)

func (ModelStruct) GetPermissionId 

func (as ModelStruct) GetPermissionId(roleid int, DB *gorm.DB, tenantid string) (perm []TblRolePermission, err error)

Get PermissionId By RoleId

func (ModelStruct) GetRoleById 

func (as ModelStruct) GetRoleById(id int, DB *gorm.DB, tenantid string) (role Tblrole, err error)

Get role by id

func (ModelStruct) GetRoleByName added in v0.0.6 

func (as ModelStruct) GetRoleByName(role *[]TblRole, DB *gorm.DB, tenantid string) error

func (ModelStruct) GetRoleBySlug added in v0.0.11 

func (as ModelStruct) GetRoleBySlug(slug string, DB *gorm.DB, tenantid string) (role TblRole, err error)

get role by slugname

func (ModelStruct) GetRolesData 

func (as ModelStruct) GetRolesData(roles *[]Tblrole, DB *gorm.DB, tenantid string) error

func (ModelStruct) MultiSelectDeleteRolePermissionById 

func (as ModelStruct) MultiSelectDeleteRolePermissionById(roleper *[]TblRolePermission, roleids []int, roleid int, DB *gorm.DB, tenantid string) error

delete multiple permission

func (ModelStruct) MultiSelectRoleDelete 

func (as ModelStruct) MultiSelectRoleDelete(role *TblRole, ids []int, id int, DB *gorm.DB, tenantid string) error

delete multiple roles

func (ModelStruct) MultiSelectRoleIsActive 

func (as ModelStruct) MultiSelectRoleIsActive(role *TblRole, id []int, val int, DB *gorm.DB, tenantid string) error

update selected role status

func (ModelStruct) RoleCreate 

func (as ModelStruct) RoleCreate(role *Tblrole, DB *gorm.DB) error

Roels Insert

func (ModelStruct) RoleDelete 

func (as ModelStruct) RoleDelete(id int, DB *gorm.DB, tenantid string) error

Delete the role data

func (ModelStruct) RoleId added in v0.0.13 

func (as ModelStruct) RoleId(id int, DB *gorm.DB) (user int, err error)

func (ModelStruct) RoleIsActive 

func (as ModelStruct) RoleIsActive(role *TblRole, id, val int, DB *gorm.DB, tenantid string) error

update role status

func (ModelStruct) RoleUpdate 

func (as ModelStruct) RoleUpdate(role *Tblrole, DB *gorm.DB, tenantid string) error

type MultiPermissin 

type MultiPermissin struct {
	RoleId    int
	Ids       []int
	CreatedBy int
	// Permissions []Permission
	TenantId string
}

type Permission 

type Permission struct {
	ModuleName string
	Action     []string //create,View,update,delete

}

type PermissionConfig 

type PermissionConfig struct {
	AuthEnable       bool
	PermissionEnable bool
	Authenticate     *auth.Auth
	DB               *gorm.DB
	DataBaseType     Type
	AuthFlg          bool
	PermissionFlg    bool
	UserId           int
	DataAccess       int
}

func RoleSetup 

func RoleSetup(config Config) *PermissionConfig

role&permission setup config

func (*PermissionConfig) CheckRoleAlreadyExists 

func (RoleConf *PermissionConfig) CheckRoleAlreadyExists(roleid int, rolename string, tenantid string) (bool, error)

Check Role Already Exists

func (*PermissionConfig) CreatePermission 

func (permission *PermissionConfig) CreatePermission(Perm MultiPermissin) error

create permission

func (*PermissionConfig) CreatePermission1 

func (permission *PermissionConfig) CreatePermission1(permissions CreatePermissions) error

create permission

func (*PermissionConfig) CreateRole 

func (RoleConf *PermissionConfig) CreateRole(rolec RoleCreation, status int) (Tblrole, error)

function used to create a role

func (*PermissionConfig) CreateUpdatePermission 

func (permission *PermissionConfig) CreateUpdatePermission(Perm MultiPermissin) error

update permission

func (*PermissionConfig) DeleteRole 

func (RoleConf *PermissionConfig) DeleteRole(roleids []int, roleid int, tenantid string) (bool, error)

delete seleted role

func (*PermissionConfig) GetPermissionDetailsById 

func (permission *PermissionConfig) GetPermissionDetailsById(roleid int, tenantid string) (rolepermissionid []int, err error)

permission List

func (*PermissionConfig) GetRoleById 

func (RoleConf *PermissionConfig) GetRoleById(roleid int, tenantid string) (tblrol Tblrole, err error)

get role by id

func (*PermissionConfig) GetRoleByName added in v0.0.6 

func (RoleConf *PermissionConfig) GetRoleByName(tenantid string) (tblrole []TblRole, err error)

function used to retrieve a particular role by using role Name

func (*PermissionConfig) GetRoleBySlug added in v0.0.11 

func (RoleConf *PermissionConfig) GetRoleBySlug(slug string, tenantid string) (role TblRole, err error)

get role by slugname

func (*PermissionConfig) GetRoleids added in v0.0.13 

func (RoleConf *PermissionConfig) GetRoleids(loginid int) (user int)

get roleid using user table

func (*PermissionConfig) MultiSelectRoleStatus 

func (RoleConf *PermissionConfig) MultiSelectRoleStatus(roleid []int, status int, userid int, tenantid string) (err error)

update selected role status

func (*PermissionConfig) PermissionList 

func (permission *PermissionConfig) PermissionList(tenantid string) (menu []MenuMod, err error)

func (*PermissionConfig) PermissionListRoleId 

func (permission *PermissionConfig) PermissionListRoleId(limit, offset, roleid int, filter Filter, tenantid string) (Module []Tblmodule, count int64, err error)

permission List

func (*PermissionConfig) RoleList 

func (RoleConf *PermissionConfig) RoleList(rolelist Rolelist, tenantid string, isactive bool) (roles []Tblrole, rolecount int64, err error)

role list

func (*PermissionConfig) RoleStatus 

func (RoleConf *PermissionConfig) RoleStatus(roleid int, status int, userid int, tenantid string) (err error)

change role status 0-inactive, 1-active

func (*PermissionConfig) Rolescheckusers added in v0.0.19 

func (RoleConf *PermissionConfig) Rolescheckusers(roleid int, roleids []int, tenantid string) (bool, error)

func (*PermissionConfig) UpdateRole 

func (RoleConf *PermissionConfig) UpdateRole(rolec RoleCreation, roleid int, tenantid string) (updaterole Tblrole, err error)

function used to update role

type RoleCreation 

type RoleCreation struct {
	Name        string
	Description string
	CreatedBy   int
	TenantId    string
}

type Rolelist 

type Rolelist struct {
	Limit      int
	Offset     int
	Filter     Filter
	GetAllData bool
}

type SubModule 

type SubModule struct {
	Id         int
	ModuleName string
	IconPath   string
	Routes     []URL
	// FullAccessPermission bool
	Action   bool
	TenantId string
}

type TblModule 

type TblModule struct {
	Id               int       `gorm:"column:id"`
	ModuleName       string    `gorm:"column:module_name"`
	IsActive         int       `gorm:"column:is_active"`
	DefaultModule    int       `gorm:"column:default_module"`
	ParentId         int       `gorm:"column:parent_id"`
	IconPath         string    `gorm:"column:icon_path"`
	AssignPermission int       `gorm:"column:assign_permission"`
	Description      string    `gorm:"column:description"`
	OrderIndex       int       `gorm:"column:order_index"`
	CreatedBy        int       `gorm:"column:created_by"`
	CreatedOn        time.Time `gorm:"column:created_on"`
	MenuType         string    `gorm:"column:menu_type"`
	GroupFlg         int       `gorm:"column:group_flg"`
	TenantId         string    `gorm:"column:tenant_id"`
}

type TblModulePermission 

type TblModulePermission struct {
	Id                   int                 `gorm:"column:id"`
	RouteName            string              `gorm:"column:route_name"`
	DisplayName          string              `gorm:"column:display_name"`
	SlugName             string              `gorm:"column:slug_name"`
	Description          string              `gorm:"column:description"`
	ModuleId             int                 `gorm:"column:module_id"`
	CreatedBy            int                 `gorm:"column:created_by"`
	CreatedOn            time.Time           `gorm:"column:created_on;DEFAULT:NULL"`
	CreatedDate          string              `gorm:"-:all"`
	ModifiedBy           int                 `gorm:"DEFAULT:NULL"`
	ModifiedOn           time.Time           `gorm:"column:modified_by;DEFAULT:NULL"`
	ModuleName           string              `gorm:"-:migration;<-:false"`
	FullAccessPermission int                 `gorm:"column:full_access_permission"`
	ParentId             int                 `gorm:"column:parent_id"`
	AssignPermission     int                 `gorm:"column:assign_permission"`
	BreadcrumbName       string              `gorm:"column:breadcrumb_name"`
	TblRolePermission    []TblRolePermission `gorm:"-:migration;<-:false; foreignKey:PermissionId"`
	OrderIndex           int                 `gorm:"column:order_index"`
	TenantId             string              `gorm:"column:tenant_id"`
	ChannelId            int                 `gorm:"column:channel_id"`
}

type TblRole 

type TblRole struct {
	Id          int       `gorm:"column:id"`
	Name        string    `gorm:"column:name"`
	Description string    `gorm:"column:description"`
	Slug        string    `gorm:"column:slug"`
	IsActive    int       `gorm:"column:is_active"`
	IsDeleted   int       `gorm:"column:is_deleted"`
	CreatedOn   time.Time `gorm:"column:created_on"`
	CreatedBy   int       `gorm:"column:created_by"`
	ModifiedOn  time.Time `gorm:"column:modified_on"`
	ModifiedBy  int       `gorm:"column:modified_by"`
	TenantId    string    `gorm:"column:tenant_id;"`
}

type TblRolePermission 

type TblRolePermission struct {
	Id           int       `gorm:"column:id"`
	RoleId       int       `gorm:"column:role_id"`
	PermissionId int       `gorm:"column:permission_id"`
	CreatedBy    int       `gorm:"column:created_by"`
	CreatedOn    time.Time `gorm:"column:created_on;DEFAULT:NULL"`
	CreatedDate  string    `gorm:"-:migration;<-:false"`
	TenantId     string    `gorm:"column:tenant_id;DEFAULT:NULL"`
}

type Tblmodule 

type Tblmodule struct {
	Id                  int                   `gorm:"column:id"`
	ModuleName          string                `gorm:"column:module_name"`
	IsActive            int                   `gorm:"column:is_active"`
	CreatedBy           int                   `gorm:"column:created_by"`
	CreatedOn           time.Time             `gorm:"column:created_on;DEFAULT:NULL"`
	CreatedDate         string                `gorm:"-:migration;<-:false"`
	DefaultModule       int                   `gorm:"column:default_module"`
	ParentId            int                   `gorm:"column:parent_id"`
	IconPath            string                `gorm:"column:icon_path"`
	TblModulePermission []TblModulePermission `gorm:"-:migration;<-:false; foreignKey:ModuleId"`
	Description         string                `gorm:"column:description"`
	OrderIndex          int                   `gorm:"column:order_index"`
	TenantId            string                `gorm:"column:tenant_id"`
}

type Tblrole 

type Tblrole struct {
	Id          int       `gorm:"column:id"`
	Name        string    `gorm:"column:name"`
	Description string    `gorm:"column:description"`
	Slug        string    `gorm:"column:slug"`
	IsActive    int       `gorm:"column:is_active"`
	IsDeleted   int       `gorm:"column:is_deleted"`
	CreatedOn   time.Time `gorm:"column:created_on"`
	CreatedBy   int       `gorm:"column:created_by"`
	ModifiedOn  time.Time `gorm:"column:modified_on;DEFAULT:NULL"`
	ModifiedBy  int       `gorm:"column:modified_by;DEFAULT:NULL"`
	CreatedDate string    `gorm:"-:migration;<-:false"`
	User        []tbluser `gorm:"-"`
	TenantId    string    `gorm:"column:tenant_id;"`
}

type Type 

type Type string
const (
	Postgres Type = "postgres"
	Mysql    Type = "mysql"
)

type URL 

type URL struct {
	Id          int
	DisplayName string
	RouteName   string
}

Source Files

View all Source files

Directories

Path Synopsis
mysql
postgres

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.